OneSpan Sign Developer: Optionale Signaturen und Unterstützung für Extraktionsmethoden

Duo Liang, 20. Dezember 2018
Thumbnail

Mit der Veröffentlichung von OneSpan Sign 11.21 haben wir die Unterstützung für die Integration optionaler Signaturen durch Dokumentextraktion und Text-Tag-Extraktion hinzugefügt. Als Absender können Sie jetzt einfach Signaturen als optional festlegen und müssen keine Signaturen mehr in einem separaten Schritt erstellen und aktualisieren.

In diesem Blog werden wir uns mit der neu hinzugefügten Syntax in den Funktionen zum Extrahieren von Dokumenten und Text-Tags befassen, die sich auf die Einstellung "Optionale Signatur" beziehen, und Schritt für Schritt deren Verwendung demonstrieren.

Dokumentextraktion und optionale Signatur

Die Dokumentextraktionsfunktion erstellt automatisch alle Signaturen und Felder, die in einer hochgeladenen PDF-Datei vorhanden sind. OneSpan Sign behält die Positionen und Größen der Signaturen und Felder in der PDF-Datei aus dem PDF-Formular bei.

Verwenden Sie das folgende Format, um ein Signaturfeld optional zu machen:

[Signer.SigStyle # .Optional]

Der letzte Teil ".Optional" wird erweitert, um die Signatur als optional festzulegen. Hier noch ein paar Beispiele:

[Agent1.Fullname1] ====> [Agent1.Fullname1.Optional]  
[Client1.Capture1] ====> [Client1.Capture1.Optional]
[Client2.Initials1] ====> [Client2.Initials1.Optional]  

Hinweis:

  • Standardmäßig sind Signaturen erforderlich. Fügen Sie daher nur bei Bedarf ".Optional" hinzu.
  • Bei der Syntax des PDF-Formularnamens wird die Groß- und Kleinschreibung nicht berücksichtigt, einschließlich des Rollennamens / der benutzerdefinierten ID des Unterzeichners. [Agent1.Fullname1.Optional] wird genauso behandelt wie [AGENT1.FULLNAME1.OPTIONAL]
  • Diese Syntaxerweiterung ist nur für Signaturen verfügbar und wird beim Erstellen anderer Felder nicht erkannt. (Namen wie [Agent1.Fullname1.Textfield1.Optional] funktionieren nicht)
  • Beziehen Sie sich darauf Dokumentseite Weitere Informationen zur Dokumentextraktion.

Schnelle Demo:

Wir werden in diesem Abschnitt eine kurze Demo haben und Ihnen ein direktes Bild davon geben, wie die Funktion implementiert ist.

Zunächst fügen wir drei Arten von Signaturen in die erforderlichen und optionalen Einstellungen in unser PDF ein:12-20-1

 

Sie können eine Kopie des obigen PDF herunterladen Hier .

Als Nächstes steht hier der Code zum Erstellen des Pakets für Java-Entwickler zur Verfügung Codeshare . Informationen zu .NET-Entwicklern finden Sie hier Codeshare . Wenn andere Benutzer die Dokumentenextraktion für Ihre Kontoebene bereits aktiviert haben, wenden Sie sich an unsere Support-team Sie können sich bei der Web-Benutzeroberfläche anmelden, einen Unterzeichner erstellen und dann das obige Dokument hochladen.

Sobald das Paket erstellt wurde, sollten alle Signaturen wie erwartet angezeigt werden.12-20-2

Text-Tags-Extraktion und optionale Signatur

Die Funktion zum Extrahieren von Text-Tags extrahiert automatisch Signaturen und Felder, indem Text-Tags direkt in einem Dokument platziert werden. Mit anderen Worten, OneSpan Sign analysiert das hochgeladene Dokument und ersetzt jeden Text, der dem Text-Tag-Muster entspricht, durch die entsprechende Signatur oder das entsprechende Feld.

Die folgende Zeile zeigt die Syntax eines Text-Tags:

{{Xesl [_fieldName]: roleName: fieldType [: parameter1, parameter2, ...]}}

Das dritte Zeichen „X“ kann entweder ein Fragezeichen (?) Oder ein Sternchen (*) sein. Ein Stern zeigt an, dass ein Eingabefeld oder eine Signatur erforderlich ist. Ein Fragezeichen zeigt an, dass es optional ist. Nach der Version 11.21 ist diese Syntax auch für alle Signaturtypen verfügbar.

Einige Beispiele unten:

{{? esl_Signature1: Signer1: Signatur}} oder {{* esl_Initials1: Signer1: Initialen}} oder {{esl_Initials1: Signer1: Initialen}}

{{? esl_Signature1: Signer1: Signatur}}
bedeutet eine optionale Vollnamensignatur mit dem Namen "Signatur1", der an Signer1 gebunden ist.

{{* esl_Initials1: Signer1: Initialen}} / {{esl_Initials1: Signer1: Initialen}}
bedeutet eine Initialsignatur mit dem Namen "Initials1", die an Signer1 gebunden ist, und diese Signatur ist erforderlich.

Hinweis:

  • Zum Erstellen von Signaturen, wenn weder "?" Wenn "*" festgelegt ist, erstellt OneSpan Sign standardmäßig eine erforderliche Signatur. Dies ist das entgegengesetzte Verhalten wie in anderen Feldern. Das heißt, es ist nicht zwingend erforderlich, "*" hinzuzufügen, um anzugeben, dass Ihre Signaturen erforderlich sind.
  • Im Gegensatz zur Dokumentextraktion unterscheidet die Syntax von Text-Tags zwischen Groß- und Kleinschreibung, einschließlich Rollenname und Feldtyp.

  • Beziehen Sie sich darauf Dokumentseite Weitere Informationen zur Dokumentextraktion.

Schnelle Demo:

Lassen Sie uns zunächst Text-Tags für alle Signaturtypen auf die erforderliche und optionale Weise in unser PDF einfügen:12-20-3

Sie können das obige Beispieldokument herunterladen Hier .

Der Code zum Erstellen eines Pakets mit einem solchen Dokument wird für das Java SDK bereitgestellt Hier und für .Net SDK Hier . Wenn Sie die Text-Tag-Funktion auf Kontoebene aktiviert haben, können Sie alternativ einfach ein Paket über Ihre Web-Benutzeroberfläche erstellen, zuerst einen Unterzeichner erstellen und das obige Dokument hochladen.

Sobald Sie das Paket erstellt haben, sollten Sie die Signaturen sehen, wie im folgenden Screenshot gezeigt:12-20-4

Damit sind die Aktualisierungen der Syntax der Dokumentextraktion und der Extraktion von Text-Tags abgeschlossen. Jetzt können Sie optionale Signaturen in einer realen Entwicklung aktivieren.

Wenn Sie Fragen zu diesem Blog oder zu anderen Aspekten der Integration von OneSpan Sign in Ihrer Anwendung haben, besuchen Sie die Entwickler-Community-Foren . Ihr Feedback ist uns wichtig!