---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# PdfMergeSignRequestor: Bereichsbezogen, global

# PdfMergeSignRequestor: Bereichsbezogen, global {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Die PdfMergeSignRequestor- API bietet Methoden zum Hinzufügen eines Bilds, das eine Signatur darstellt, zu einem PDF-Dokument.

Diese API ist Teil des Plugins ServiceNow PDF Generierung Utilities (com.snc.apppdfgenerator) und wird im Namespace `sn_pdfgeneratorutils` bereitgestellt. Das Plugin ist standardmäßig aktiviert.

Diese API erstellt ein Signaturobjekt, das mithilfe [der PDFGenerationAPI](https://servicenow-prod.fluidtopics.net/MBdtnESrY~nspFYQ4NpxMw#PDFGenerationAPIBothAPI "Die PDFGenerationAPI bietet Unterstützung für die PDF-Konvertierung und die Verarbeitung von PDF-Feldern.")in eine PDF-Datei implementiert werden kann.

## PdfMergeSignRequestor: PdfMergeSignRequestor() {#ariaid-title2}

Instanziiert ein neues PdfMergeSignRequestor- Objekt.
{#PM-PdfMergeSignRequestor__table_twm_hjk_34b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 1. Parameter]

{#PM-PdfMergeSignRequestor__table_twm_hjk_34b}  
Die folgenden Beispiele zeigen, wie ein PdfMergeSignRequestor- Objekt erstellt wird.

    var v = new sn_pdfgeneratorutils.PdfMergeSignRequestor;

## PdfMergeSignRequestor - addSignatureMapping(Number pageNumber, NummerleftMargin, Nummer topMargin, NummernboxWidth, NummernboxHeight, Zeichenfolgen-sysId) {#ariaid-title3}

Weist Anforderungen für Größe und Position der Signatur in der PDF-Datei zu.
{#PM-addSignatureMapping_N_N_N_N_N_S__table_zvh_hkl_j4b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| pageNumber | Nummer | Nummer der Seite, auf der die Signatur eingefügt werden soll. |
| LeftMargin | Nummer | Wert in Punkten, der den linken Randbereich der Seite darstellt, an dem die Signatur eingefügt werden soll. |
| topMargin | Nummer | Wert in Punkten, der den oberen Randbereich der Seite darstellt, an dem das Signaturbild eingefügt werden soll. |
| boxWidth | Nummer | Wert in Punkten, der die Breite des Felds für die Signatur darstellt. |
| Feldhöhe | Nummer | Wert in Punkt, der die Höhe des Felds für das Signaturbild darstellt. |
| sysId | Zeichenfolge | Sys_id des Signaturbilds in der Tabelle „Anhänge" \[sys_attachment\] |
[Tabelle : 2. Parameter]

{#PM-addSignatureMapping_N_N_N_N_N_S__table_zvh_hkl_j4b} {#PM-addSignatureMapping_N_N_N_N_N_S__table_awh_hkl_j4b__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 3. Ergebnisse]

{#PM-addSignatureMapping_N_N_N_N_N_S__table_awh_hkl_j4b}  
Das folgende Beispiel zeigt, wie Sie die Signaturzuordnung hinzufügen. Ein vollständiges Beispiel finden Sie unter processRequest().

    var requestor = new sn_pdfgeneratorutils.PdfMergeSignRequestor;

    // For the purpose of this example, set signature sizes and page number for signature placement
    var page = 2;
    var leftMargin = 48;
    var topMargin = 60;
    var signatureWidth = 96;
    var signatureHeight = 36; 

    requestor.addSignatureMapping(page, leftMargin, topMargin, signatureWidth, signatureHeight, "<signatureSysId>");

## PdfMergeSignRequestor - createRequest(String targetSysId, Zeichenfolge targetTable, Zeichenfolge tableSysId, Zeichenfolge targetFileName) {#ariaid-title4}

Erstellt eine Signaturanforderung mit Quell- und Zieleingaben.
{#PM-createRequest_S_S_S_S__table_ulk_gkl_j4b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| targetSysId | Zeichenfolge | Sys_id einer PDF-Datei in der Tabelle „Anhänge" \[sys_attachment\]. Verwenden Sie diesen Wert als Ziel-PDF, dem eine Signatur hinzugefügt werden soll. |
| targetTable | Zeichenfolge | Name der Tabelle, die den Datensatz enthält, an den die PDF-Datei angehängt ist. Sie finden diesen Wert in der gleichen Zeile wie den Anhang in der Tabelle „Anhänge" \[sys_attachment\]. |
| tableSysId | Zeichenfolge | Sys_id des Datensatzes, an den die PDF-Datei angehängt ist. Sie finden diesen Wert in der gleichen Zeile wie den Anhang in der Tabelle „Anhänge" \[sys_attachment\]. |
| targetFileName | Zeichenfolge | Name der Ziel-PDF ohne Erweiterung. |
[Tabelle : 4. Parameter]

{#PM-createRequest_S_S_S_S__table_ulk_gkl_j4b} {#PM-createRequest_S_S_S_S__table_vlk_gkl_j4b__entry__2}

| Typ | Beschreibung |
|-|-|
| Keine |   |
[Tabelle : 5. Ergebnisse]

{#PM-createRequest_S_S_S_S__table_vlk_gkl_j4b}  
Das folgende Beispiel zeigt, wie Sie eine Signaturanforderung erstellen. Ein vollständiges Beispiel finden Sie unter processRequest().

    var requestor = new sn_pdfgeneratorutils.PdfMergeSignRequestor;

    requestor.createRequest("<sys_id>", "tableName", "<tableSysId>", "pdfFileName");

## PdfMergeSignRequestor -- processRequest() {#ariaid-title5}

Verarbeitet Anforderungen und fügt die Signaturen hinzu.
{#PM-processRequest__table_gyz_3kl_j4b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Keine |   |   |
[Tabelle : 6. Parameter]

{#PM-processRequest__table_gyz_3kl_j4b} {#PM-processRequest__table_erx_h3k_34b__entry__2}{#PM-processRequest__row_pdfgen_ret_attID}

| Typ | Beschreibung |
|-|-|
| Objekt | Objekt, das bei Erfolg die Größe jeder Seite enthält, andernfalls Fehlermeldung. { "attachment_id": "String", "message": "String", "status": "String" } |
| \<Object\>.attachment_id | Wenn die Anforderung erfolgreich ist, sys_id der signierten und angehängten PDF-Datei. Die Datei wird in der Tabelle „Anhänge" \[sys_attachment\] aufgeführt. Datentyp: Zeichenfolge |
| \<Object\>.message | Mögliche Werte: * Die Anforderung kann nicht fortgesetzt werden, da der Anhang mit der Sys_id \[{0}\] die Sicherheitsprüfung nicht bestanden hat -- die PDF-Datei hat die Antivirenprüfung nicht bestanden. {#PM-processRequest__ul_yzw_bhm_l4b} <!-- --> * Keine Signaturzuordnung angegeben. Diese Anforderung kann nicht verarbeitet werden -- Stellen Sie die Signaturzuordnung mit der Methode „addSignatureMapping() " bereit. * Anforderung erfolgreich abgeschlossen. * Anforderungsfehler. Ausnahmen beim Versuch, dem Dokument Signaturen hinzuzufügen. Versuchen Sie es erneut. * Diese Anforderung kann nicht abgeschlossen werden, da die angeforderte Seite nicht vorhanden ist. Seite Nr.:\<page number\> {#PM-processRequest__ul_tmd_twg_m4b} Datentyp: Zeichenfolge |
| \<Object\>.status | Status, der angibt, ob der Vorgang erfolgreich ist. Mögliche Werte: * erfolgreich: Vorgang war erfolgreich. * Fehler: Vorgang war nicht erfolgreich. message enthält Details. {#PM-processRequest__ul_rlv_5cv_j4b} Datentyp: Zeichenfolge |
[Tabelle : 7. Ergebnisse]

{#PM-processRequest__table_erx_h3k_34b}  
Das folgende Beispiel zeigt, wie die Signaturanforderung verarbeitet wird.

    var requestor = new sn_pdfgeneratorutils.PdfMergeSignRequestor;

    requestor.createRequest("<sys_id>", "tableName", "<tableSysId>", pdfFileName);

    // For the purpose of this example, set signature sizes and page number for signature placement
    var page = 6;
    var leftMargin = 40;
    var topMargin = 50;
    var signatureWidth = 188;
    var signatureHeight = 44; 

    requestor.addSignatureMapping(page, leftMargin, topMargin, signatureWidth, signatureHeight, "<signatureSysId>");

    var result = requestor.processRequest();
    gs.info(JSON.stringify(result));