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

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# PdfMergeSignRequestor: Bereichsbezogen, global

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

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

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

Diese API ist Teil von ServiceNowPDF-Generierungsdienstprogramme-Plugin (com.snc.apppdfgenerator) und wird in bereitgestellt `sn_pdfgeneratorutils `Namespace. Das Plugin ist standardmäßig aktiviert.

Diese API erstellt ein Signaturobjekt, das mit in einer PDF-Datei implementiert werden kann [PDFGenerationAPI](https://servicenow-prod.fluidtopics.net/53XZmikB3x~3TyIWd0R6UA#PDFGenerationAPIBothAPI "Die PDFGenerationAPI Bietet Unterstützung für die PDF-Konvertierung und die Verarbeitung von PDF-Feldern.").

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

Instanziiert eine neue 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 erstellt wird PdfMergeSignRequestor Objekt.

    var v = new sn_pdfgeneratorutils.PdfMergeSignRequestor;

## PdfMergeSignRequestor -- addSignatureMapping(Number pageNumber, Number leftMargin, Number topMargin, Number boxWidth, Number boxHeight, SYS-ID der Zeichenfolge) {#ariaid-title3}

Weist Signaturgröße und Positionsanforderungen in der PDF zu.
{#PM-addSignatureMapping_N_N_N_N_N_S__table_zvh_hkl_j4b__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| pageNumber | Nummer | Nummer der Seite, auf die die Signatur eingefügt werden soll. |
| Linker Rand | Nummer | Wert in Punkten, der den linken Randbereich der Seite darstellt, an dem die Signatur eingefügt werden soll. |
| Oberer Rand | Nummer | Wert in Punkten, der den oberen Randbereich der Seite darstellt, an der das Signaturbild eingefügt werden soll. |
| Boxbreite | Nummer | Wert in Punkten, der die Breite des Felds darstellt, das die Signatur enthalten soll. |
| BoxHeight | Nummer | Wert in Punkten, der die Höhe des Felds darstellt, das das Signaturbild enthalten soll. |
| Sys-ID | 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. Rückgaben]

{#PM-addSignatureMapping_N_N_N_N_N_S__table_awh_hkl_j4b}  
Das folgende Beispiel zeigt, wie die Signaturzuordnung hinzugefügt wird. 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(Zeichenfolge 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 in der Tabelle „Anhänge" \[sys_attachment\]. Verwenden Sie diesen Wert als Ziel-PDF, der eine Signatur hinzugefügt werden soll. |
| targetTable | Zeichenfolge | Name der Tabelle, die den Datensatz enthält, an den die PDF angehängt ist. Sie finden diesen Wert in derselben Zeile wie der Anhang, der in der Tabelle „Anhänge" \[sys_attachment\] aufgeführt ist. |
| tableSysId | Zeichenfolge | SYS_ID des Datensatzes, an den die PDF angehängt ist. Sie finden diesen Wert in derselben Zeile wie der Anhang, der in der Tabelle „Anhänge" \[sys_attachment\] aufgeführt ist. |
| Zieldateiname | 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. Rückgaben]

{#PM-createRequest_S_S_S_S__table_vlk_gkl_j4b}  
Das folgende Beispiel zeigt, wie eine Signaturanforderung erstellt wird. 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 die Größe jeder Seite enthält, falls erfolgreich, 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. Die Datei wird in der Tabelle „Anhänge" \[sys_attachment\] aufgeführt. Datentyp: Zeichenfolge |
| \<Object\>.Nachricht | 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 den Virenschutz-Scan nicht bestanden. {#PM-processRequest__ul_yzw_bhm_l4b} <!-- --> * Keine Signaturzuordnung angegeben. Diese Anforderung kann nicht verarbeitet werden. Geben Sie die Signaturzuordnung mit an AddSignatureMapping() Methode. * Anforderung erfolgreich abgeschlossen. * Anforderungsfehler. Ausnahmen beim Versuch, Signaturen zum Dokument hinzuzufügen. Überprüfen Sie es erneut. * Diese Anforderung kann nicht abgeschlossen werden, da die angeforderte Seite nicht vorhanden ist. Seitennummer: \<page number\> {#PM-processRequest__ul_tmd_twg_m4b} Datentyp: Zeichenfolge |
| \<Object\>.Status | Status, der angibt, ob der Vorgang erfolgreich ist. Mögliche Werte: * Erfolg: Vorgang war erfolgreich. * Fehler: Vorgang war nicht erfolgreich. Die messageStellt Details bereit. {#PM-processRequest__ul_rlv_5cv_j4b} Datentyp: Zeichenfolge |
[Tabelle : 7. Rückgaben]

{#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));


