Knoten „Dokument signieren“ verwenden

Geben Sie optional diejenigen an, die das Dokument elektronisch signieren sollen. Die hier angegebenen E-Mail-Empfänger werden mit dem Dokument an inSign übermittelt. inSign verschickt E-Mails mit der Aufforderung zur elektronischen Signatur an die angegebenen E-Mail-Adressen.

Sie können über die Datenfelder die POST-Anfrage zusammenstellen, die an inSign geschickt wird. Für die Anfrage benötigen Sie mindestens das Objekt externUsers mit den E-Mail-Adressen der Empfänger als Schlüssel-Wert-Paare. Daneben stehen Ihnen weitere Angaben zur Verfügung, über die Sie den Inhalt der E-Mail und die Reihenfolge der Unterschriften steuern können. Die Dokumentation aller möglichen Felder finden Sie hier.

Wenn Sie die Empfänger als Expression angeben, muss das Ergebnis der Expression den Namen des Signiervorgangs beinhalten.

{
    "externUsers": [
      {
        "recipient": "test.user1@agorum.com",
        "sendEmails": true,
        "roles": [
          "Role1"
        ]
      },
      {
        "recipient": "test.user2@agorum.de",
        "sendEmails": true,
        "roles": [
          "Role2"
        ]
      }
    ],
    "inOrder": true
 }Copy

Sie können optional weitere Parameter zu den zu unterschreibenden Dokumenten und weitere Angaben für die inSign-Session mitgeben. Mit diesen Parametern können Sie die POST-Anfrage erweitern.

Mit den zusätzlichen Parametern können Sie etwa über das Objekt documents angeben, an welcher Stelle im Dokument die Empfänger unterschreiben sollen. Dazu haben Sie verschiedene Möglichkeiten: 

• Sie können die geeignete Position über eine Textsuche (textsearch) angeben. Wenn Sie diese Möglichkeit verwenden, empfiehlt es sich, diesen Text nur einmal im Dokument zu verwenden und ggf. als weißen Text zu positionieren. Sonst werden die Unterschriften eventuell nicht richtig positioniert.
• Sie können die Position für die Unterschrift durch Angabe der Koordinaten (x0, y0) auf der PDF-Seite (page, Wert 0-basierend) und der Breite (w) und Höhe (h) des Unterschriftenfelds genau angeben.

Die Dokumentation aller möglichen Parameter finden Sie hier.

Wenn Sie den Parameter als Expression angeben, muss das Ergebnis der Expression den Namen des Signiervorgangs beinhalten.

{
    "documents": [
      {
        "scanSigTags": false,
        "signatures": [
          {
            "role": "Role1",
            "id": "1",
            "textsearch": "Unterschrift Partei A",
            "required": true
          },
          {
            "role": "Role2",
            "id": "2",
            "textsearch": "Unterschrift Partei B",
            "required": true
          }
        ]
      }
    ]
 }Copy

Mit der Eingangsvariablen geben Sie das PDF-Dokument an, das in inSign signiert werden soll.

Der Parameter Eingangsvariable enthält ein Array von Elementen, die mit diesem Knoten verarbeitet werden sollen. Wird die Variable leer gelassen, werden automatisch die Attachments des Workflows genommen. Diese Attachments sind in der internen Variable sys_acw_attachments vorhanden.

Für die generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.

Die Datenvariable beinhaltet die Session-Informationen, die von inSign zurückgegeben werden. Das sind die Session-ID und der Session-Link.

Im Editor geben Sie den Namen der Workfllow-Variablen an, in der der Link und die Session-ID abgespeichert werden.

Wenn Sie den Parameter als Expression angeben, muss das Ergebnis der Expression den Namen der Variable beinhalten.

Für die generelle Schreibweise von Variablen im Editor oder als Expression siehe Schreibweise von Variablen.

sessionInfo

Beispiel für den Wert:

  "sessionInfo": {
    "inSignLink": "https://connect.test.getinsign.show/index?sessionid=094ffeeaffe1936a921e19d",
    "inSignSessionId": "094ffeeaffe1936a921e19d"
  },Copy