Frage:
Wie richte ich einen Workflow ein, um den DocuSign Signature Service zu nutzen, um Mehrfachsignaturen zu erhalten?
Antwort:
Bitte folgen Sie den folgenden Anweisungen, um Ihr DocuWare-System so einzurichten, dass es den DocuSign Signature Service nutzt, um Mehrfachsignaturen zu erhalten.
Schritt 1: Organisation beim DocuWare Signature Service registrieren.
Registrierung für ein Produktionssystem.
Um sich für ein Produktions-Token zu registrieren, muss ein Benutzer dieseWebseite nutzen. Er wird aufgefordert, sich bei DocuSign anzumelden. Sie sollten die Anmeldedaten für das DocuSign-Konto verwenden, das sie unserem Signaturservice ermöglichen möchten, sich in ihrem Namen mit DocuSign zu verbinden.
Sobald sich der Benutzer erfolgreich bei DocuSign angemeldet hat, wird er zu unserer Registrierungsseite weitergeleitet, die Sie unten sehen. Dort muss er seine Organisation und die DocuWare-URL eingeben und einen DocuWare-Benutzernamen und ein Passwort angeben. Sie müssen auch eine gültige E-Mail-Adresse angeben, an die sie den resultierenden Token per E-Mail erhalten werden. Sie werden einige Informationen über ihr DocuSign-Konto sehen, einschließlich des Subskriptionstyps und der ID des Benutzers, als der sie sich im vorherigen Schritt angemeldet haben.
Wenn alle Informationen korrekt sind, wird die Registrierung abgeschlossen und sie werden in Kürze eine E-Mail mit dem für ihre Organisation ausgestellten Token erhalten.
Schritt 2: DocuWare Signature Service als Web Service hinzufügen
Bevor Sie Ihren Workflow konfigurieren, müssen Sie den Service zu den verfügbaren Web Services in der DocuWare-Konfiguration hinzufügen:https://signature.docuware.cloud/DocuSignSignatureService.svc
Schritt 3: Signatur-Workflow konfigurieren
Die folgende Prozedur beschreibt, wie das Dokument im Workflow zum Signieren an DocuSign gesendet und wieder zurückgeholt wird:
- Trigger-Bedingung tritt bei einem Dokument ein.
- Der DocuWare Signature Service unterstützt nur PDFs - das Dokument wird bei Bedarf konvertiert.
- Das Dokument wird an die DocuSign-Webanwendung gesendet.
- Der Benutzer öffnet eine E-Mail und drückt eine Schaltfläche, die ihn zu DocuSign schickt, wo er das Dokument überprüfen kann.
- Der Benutzer muss möglicherweise bestimmte Authentifizierungsanforderungen erfüllen (Zugangscode, Telefon, SMS oder wissensbasierte Authentifizierung), dann kann er das Dokument signieren.
- Die DocuSign-Anwendung ruft unseren Service auf und benachrichtigt DocuWare, dass das Dokument signiert wurde.
- DocuWare ruft das Dokument ab, das mit einer Signatur aktualisiert wurde, sowohl in den Metadaten als auch durch Platzierung eines Bildes der Signatur an einer bestimmten Stelle des Dokuments.
- Die signierte Version des Dokuments kann entweder das Originaldokument ersetzen oder an das Originaldokument angehängt werden. Darüber hinaus wird ein Indexfeld mit einem bestimmten Wert aktualisiert. Dieser Wert kann z. B. eine Auslösebedingung für einen anderen Workflow sein.
Die Besonderheiten Ihres Workflows hängen von den Anforderungen des Anwendungsfalls ab, den Sie erfüllen. Die Anwendung einer Signatur auf ein Workflow-Dokument erfordert zwei Workflow-Aktivitäten - "Daten zuweisen" und "Webdienst".
Daten zuweisen
Der erste Schritt ist die Anwendung einer Workflow-Aktivität vom Typ "Daten zuweisen". Der Zweck dieses Schrittes ist es, globale Variablen für alle Parameter zu erstellen und ihnen dann Daten zuzuweisen, die beim Aufruf des Webdienstes verwendet werden. Es empfiehlt sich, die globalen Variablen genauso zu benennen wie den Parameter, den sie repräsentieren sollen.
Details und Parameter finden Sie im Folgenden:
Dies basiert auf der Methode AddNewDocumentMultiSigners:
- Zugriffscode - ein Passwort oder ein Code wird zum Zeitpunkt des Versands des Dokuments zur Signatur festgelegt. Der Absender muss den Code dem Unterzeichner über einen anderen Kanal (persönlich, über eine separate E-Mail usw.) mitteilen. Der Unterzeichner muss den Zugangscode vor dem Unterschreiben eingeben.
- DateSignedFieldName (string) - Dies ist ein optionaler Parameter, der verwendet werden kann, um den Namen eines Archivfeldes anzugeben, das das Datum der Unterzeichnung des Dokuments enthält. Nach dem Signieren wird dieses Feld mit dem Datum aktualisiert, an dem es vom Benutzer in DocuSign signiert wurde.
- DocId (string) - ID des zu signierenden Dokuments
- EmailMessage (string) - Text, der im Inhalt der E-Mail angezeigt wird
- EmailSubject (string) - Betreff der E-Mail
- FailureStatusValue (string) - Dieser Wert wird im obigen Feld gesetzt, wenn ein Dokument vom Benutzer in DocuSign abgelehnt wird
- FileCabinetId (string) - GUID des Aktenschrankes mit dem Dokument
- IncludeReport (boolean) - Wählen Sie, ob ein Bericht an das signierte Dokument in DocuWare angehängt werden soll.
- MultiAnchorText (string) - Dieser Parameter enthält die Ankertexte für die mehrfachen Signierorte.
- MultiAnchorTextOccurrence - Welche Vorkommen der Ankertexte sollen als Startorte für die Platzierung der Signatur verwendet werden
-1 ist das letzte Vorkommen.
0 oder 1 ist das erste.
Jede andere Zahl ist ein bestimmtes Vorkommen. - MultiPageNumber (string) - Dies ist eine abgegrenzte Liste von Seitennummern, auf denen sich die Unterschriften befinden.
- MultiPositionX (string) - Enthält eine Liste von X-Positionen für die Platzierung von Unterschriften.
- MultiPositionY (string) - Enthält eine Liste von Y-Positionen für die Platzierung von Unterschriften.
- MultiSignerCount (int) - dies ist die Anzahl der angeforderten Unterschriften
- MultiSignerEmail (string) - dieser Parameter enthält die E-Mail-Adressen für die Unterzeichner. Beispiel:peter.sanders@peters-engineering.net,bria.florent@peters-engineering.net
- MultiSignerName (string) - dieser Parameter enthält die Namen der Unterzeichner des Dokuments. Beispiel: "Peter Sanders,Bria Florent".
- MultiSignerPhoneNumber (string) - enthält eine begrenzte Liste von Telefonnummern, die für die SMS-Überprüfung verwendet werden können.
- MultiValueSeparator (string) - Dieser Parameter ist erforderlich und teilt dem Dienst mit, wie die Liste der Unterzeichner und ihre Informationen getrennt werden sollen. Eine übliche Wahl ist ein Komma, ein Caret ^ oder eine Pipe |
- OrderedSignature (bool) - Bei true werden die Signaturen in der Reihenfolge angefordert, in der sie in den obigen Feldern angegeben sind. Der erste Unterzeichner erhält eine E-Mail und kann unterschreiben, dann erhält der zweite Unterzeichner eine E-Mail und kann unterschreiben, und so weiter. Bei false werden alle Unterzeichner parallel benachrichtigt und können in beliebiger Reihenfolge unterschreiben. In beiden Fällen wird das Archiv erst dann mit dem signierten Dokument aktualisiert, wenn alle Unterschriften geleistet wurden.
- PostSigningAction (string) - dies gibt an, was mit dem signierten Dokument geschehen soll, nachdem der Benutzer es in DocuSign signiert hat. Die Auswahlmöglichkeiten sind "ClipBefore", "ClipAfter" und "Replace".
- RecipientAuthenticationType (string) - Hier kann der Workflow angeben, welche Art der DocuSign-Authentifizierung erforderlich ist, damit ein Unterzeichner ein Dokument signieren kann. Siehe Abschnitt 2.1 für weitere Informationen über diese Authentifizierungstypen. Gültige Werte sind "Keine", "AccessCode", "Telefon", "SMS", "KBA".
- RecipientMayProvideNumber (Boolean) - Nur für die Telefonauthentifizierung. Bei true wird jeder Wert, den der Benutzer bei der Telefonnummer angibt, ignoriert. Dann kann der Unterzeichner zum Zeitpunkt der Unterzeichnung die Nummer angeben, die er anrufen muss, um den Code zu erhalten, indem er sie in die DocuSign-Anwendung eingibt.
- SectionNumber (int) - Index des Abschnitts innerhalb des zu signierenden Dokuments
-1 gibt den letzten gefundenen Abschnitt an.
0 oder 1 ist der erste Abschnitt.
Ein Fehler tritt auf, wenn ein Abschnitt angegeben wird, der nicht existiert. - StatusFieldName (string) - Dies identifiziert ein Archivfeld auf dem Dokument, das aktualisiert wird, wenn ein Dokument vom Benutzer in DocuSign signiert oder abgelehnt wird.
- SuccessStatusValue (string) - Dies gibt den Wert an, der im obigen Feld gesetzt wird, wenn ein Dokument signiert wird.
- Token (string) - Token, das im Registrierungsschritt erhalten wurde und das die Kundenorganisation identifiziert und die Benutzeranmeldeinformationen liefert.
Wählen Sie in einer Webdienst-Aktivität den Webdienst aus, den Sie verwenden möchten. Wenn Sie den Signaturdienst nicht sehen, konfigurieren Sie ihn und kehren Sie zu diesem Schritt zurück. Wählen Sie die richtige Dienstmethode aus, in diesem Fall "AddNewDocumentMultiSigners".
Wählen Sie nun in den Parametern die globalen Variablen aus, die Sie für jeden Parameter erstellt haben.
Sie haben auch die Möglichkeit, die Ergebnisparameter zu verwenden. Diese können auf globale Variablen gesetzt und zur Entscheidung über den nächsten Schritt in Ihrem Arbeitsablauf verwendet werden.Wenn zum Beispiel das Ergebnis "Erfolg" des Webdienstes (zu finden im Boolean "Erfolg") falsch ist, möchten Sie vielleicht einen anderen Weg einschlagen, als wenn das Ergebnis wahr ist.
Sobald Sie diese Änderungen vorgenommen haben, speichern und veröffentlichen Sie den Workflow, damit Sie den DocuSign Signature Service nutzen können.
KBA gilt sowohl für Cloud- als auch für On-Premise-Organisationen.
Bitte beachten Sie: Dieser Artikel ist eine Übersetzung aus dem Englischen. Die in diesem Artikel enthaltenen Informationen basieren auf der/den englischsprachigen Originalversion(en) des Produkts. In der übersetzten Version unserer Artikel können kleinere Fehler enthalten sein, z.B. in der Grammatik. Wir können zwar nicht für die vollständige Richtigkeit der Übersetzung garantieren, aber in den meisten Fällen werden Sie sie als ausreichend informativ empfinden. Im Zweifelsfall wechseln Sie bitte zurück zur englischen Version dieses Artikels.
