The signing of a document
This article is written for users who want to use a feature that has been available since yuuvis® RAD version 9.6. It is about how to request other persons to sign a specific PDF document file with the support of an external signing platform like DocuSign.
Prerequisite: To use this feature it is necessary to use your own accounts of the DocuSign eSignature or Adobe Sign platform.
The signing capability has to be enabled by an administrator. How to do this is described here:
https://yuuvisdevelop.atlassian.net/wiki/spaces/onpremise/pages/447184897
Content
User documentation (English)
The following describes how to request signatures, how to check the signing progress, and how to audit the signing process.
About the use case
To reduce the effort to sign documents via paperware more and more companies are using the technique of digital signatures. This makes the process much easier. The documents have not to be printed and sent via white mail and sent back the same way, and scanned and saved to the dossier (folder, file, etc.).
Responsible users want to be able to request signatures for the finalized PDF document in the form that after determining the signers the document is sent to a service that controls the signing process and if completed saves it as a new version.
The complete process should be protocolled for audit purposes but also to see the progress.
Request signatures
A user is offered the action ‘Request signatures’ in the menu when
the document file is of type PDF
the document type was intended for signing
the document is editable (e.g. the user has edit permission, the object is not finalized, and the signing status is no signatures were requested yet)
When activating this action, the user is prompted to enter the following data:
An email subject is to be used in the email to signers to briefly state the reason for signing. At least 5 characters must be entered. Up to 100 characters are possible.
If no subject is entered, a standard text stored in the system is used.An email message that appears in the body of the e-mail detailing the reason for the signature. At least 5 characters must be entered. Up to 100 characters are possible.
If no message is entered, a standard text stored in the system is used.The list of signers with their names and email address. To make typing easier and avoid typing errors, both fields offer suggestions after typing two characters.
The order number that controls the signing. If the signers should get the emails in parallel ‘1' for each can be entered. If the signers should get the emails if the processor has signed the the number ‘1’, ’2’, and '3' should be set.
After completing by pushing ‘Request’, the document file is transferred to the configured signing platform.
History/Audit
The request for signatures and the creation of a new version with the signed file can be seen in the history with a corresponding note in English on the change to the object.
Cancel signing
Users with edit permission are offered the action ‘Cancel signing’ if the signing status is ‘in process’. If the user pushes this action he asked for a reason. After pushing again ‘Cancel signing’ the signing status is set to ‘canceled’, and the action ‘Request signatures’ is offered again. All other signature properties keep unchanged.
Signing information
You can get an idea of the signature process in the additional object aspect 'Signatures'. This is then available as soon as signatures for the document file have been requested.
It is checked regularly whether anything has changed in the signature process on the signing platform. In the event of a change, the new status information is visible on the object.
The following statuses are possible:
Value | Description | Color of the signing symbol in the object header |
|---|---|---|
signed | A signer has signed the document file. If all signers have signed the document files is completely signed and the file is fetched from the signing service and added as new version to the document. | Green |
revised | A signer has revised the signing and gave a reason. | Red |
expired | The current signer did not sign within the time that is configured on the signing platform. | Red |
cancelled | A user had cancelled the signing process | Red |
Error | In the case of an error during the signing process, the reason is documented here. | Red |
in process | The document file was handed over to the signing platform and the specified signers have to sign. | Gray |
Search for documents to be signed and signed documents
Depending on the configuration of the system, signed PDF documents can be in one or more document types. The search can be carried out cross-context-wise. To do this, click on the object type 'Signature' in the 'Cross-context' area of the search dialog. A search form opens. If you want to find documents that are still in the signing process, select the status 'in process' and run the search. You can find signed documents with ‘signed’.
Benutzerdokumentation (Deutsch)
Im Folgenden wird beschrieben, wie Sie Signaturen anfordern, den Signierfortschritt überprüfen und den Signiervorgang überwachen.
Über den Anwendungsfall
Um den Aufwand für das Unterschreiben von Dokumenten per Papier zu reduzieren, nutzen immer mehr Unternehmen die Technik der digitalen Signatur. Dies erleichtert den Vorgang erheblich. Die Dokumente müssen nicht ausgedruckt und per Post verschickt und auf dem gleichen Weg zurückgesendet, gescannt und in der Akte (Ordner, Dossier usw.) gespeichert werden.
Verantwortliche Benutzer möchten elektronische Signaturen für das finalisierte PDF-Dokument in der Form anfordern können, dass das Dokument nach der Festlegung der Unterzeichner an einen Dienst gesendet wird, der den Signiervorgang steuert und es nach Abschluss als neue Version speichert.
Der gesamte Prozess wird zu Prüfzwecken, aber auch zur Fortschrittskontrolle protokolliert.
Signaturen anfordern
Einem Benutzer wird die Aktion „Signaturen anfordern“ im Menü angeboten, wenn
die Dokumentdatei vom Typ PDF ist
der Dokumenttyp zum Signieren vorgesehen wurde
das Dokument bearbeitbar ist (der Benutzer hat das Bearbeitenrecht, das Objekt ist nicht finalisiert, und es wurden noch keine Signaturen angefordert)
Beim Aktivieren dieser Aktion wird der Benutzer aufgefordert, folgende Daten einzugeben:
Einen E-Mail-Betreff, der in der Email an die Signierer verwendet wird, um in Kürze auf den Grund für die Unterzeichnung hinzuweise. Es müssen mindestens 5 Zeichen eingegeben werden. Es sind bis zu 100 Zeichen möglich.
Wird kein Betreff eingegeben, so wird ein im System hinterlegter Standardtext verwendet.Eine E-mail-Nachricht, der im Nachrichtenteil der Email angezeigt wird, in dem ausführlicher auf den Grund für die Signierung eingegangen wird. Es müssen mindestens 5 Zeichen eingegeben werden. Es sind bis zu 100 Zeichen möglich.
Wird keine Nachricht eingegeben, so wird ein im System hinterlegter Standardtext verwendet.Die Liste der Signierer mit ihrem Namen und ihrer E-Mail-Adresse.
Zur Eingabeerleichterung und zur Vermeidung von Eingabefehlern bieten beide Felder Vorschläge nach dem Tippen von zwei Zeichen.Die Signierfolge, die die Signatur steuert. Wenn die Signierer die E-Mails parallel erhalten sollen, kann für jeden „1“ eingegeben werden. Wenn die Signierer die E-Mails erhalten sollen, wenn der vorherige sie signiert hat, sollten die Nummern „1“, „2“ und „3“ vergeben werden.
Nach Abschluss der Signaturanfrage wird die Dokumentdatei an die konfigurierte Signier-Plattform übergeben.
Ab yuuvis® RAD Version 9.6 werden im Dialog die vorhandenen Daten der vorherigen Anfrage angeboten.
Informationen über die Signaturen
Sie können sich ein Bild über den Signaturprozess im zusätzlichen Objektaspekt ‘Signaturen’ machen. Dieser steht dann zur Verfügung, sobald Signaturen zur Dokumentdatei angefordert wurden.
Es wird regelmäßig geprüft, ob sich im Signaturprozess auf der Signier-Plattform etwas geändert hat. Im Änderungsfall wird die neue Statusinformationen am Objekt sichtbar.
Die folgenden Status sind möglich:
Wert | Beschreibung | Farbe des Signiersymbols im Objekttitel |
|---|---|---|
signiert | Ein Signierer hat die Dokumentdatei signiert. Wenn alle Signierer unterzeichnet haben, ist die Dokumentdatei vollständig signiert, wurde vom Signaturdienst abgerufen und als neue Version dem Dokument hinzugefügt. | Green |
abgewiesen | Ein Signierer hat die Signatur überarbeitet und einen Grund angegeben. | Red |
abgelaufen | Der aktuelle Signierer hat nicht innerhalb der auf der Signaturplattform konfigurierten Zeit signiert. | Red |
abgebrochen | Ein Benutzer hatte den Signiervorgang abgebrochen, | Red |
Fehler | Sollte beim Signieren ein Fehler auftreten, wird der Grund hier dokumentiert. | Red |
in Bearbeitung | Die Dokumentendatei wurde an die Signierplattform übergeben und die angegebenen Signierer müssen signieren. | Grau |
Historie/Audit
In der Historie ist das Anfordern der Signaturen sowie das Anlegen einer neuen Version mit der fertig signierten Datei mit einem entsprechenden Hinweis zur Änderung des Objekts zu erkennen.
Signieren abbrechen
Ab yuuvis® RAD Version 9.6 wird Benutzern mit Bearbeitungsrecht die Aktion „Signieren abbrechen“ angeboten, wenn der Signierstatus ‘in Bearbeitung’ ist. Wenn der Benutzer diese Aktion auslöst, wird er nach einem Grund gefragt. Nach erneutem Drücken von „Signieren abbrechen“ wird der Signaturstatus auf „abgebrochen“ gesetzt. In einer der nächsten Versionen wird die Aktion „Signaturen anfordern“ erneut angeboten. Der Status für die Signieren, die schon eine E-Mail erhalten haben aber noch nicht signiert haben, wird von ‘In Bearbeitung’ in ‘abgebrochen’ geändert inklusive Angabe des Datums und Grund.
Suchen nach zu signierenden und signierten Dokumenten
Je nach Konfiguration des Systems können sich signierte PDF-Dokumente in einem oder mehreren Dokumenttypen befinden. Die Suche kann über Objekttyp-übergreiden durchgeführt werden. Dazu klicken Sie im Suchdialog im Bereich ‘Übergreifend’ den Objekttyp ‘Signierung’ and. Es öffnet sich ein Suchformular. Wenn sie Dokumente finden wollen, die sich noch im Signierprozess befinden, so wählen sie für den Status ‘in Bearbeitung’ aus und führen die Suche aus. Signierte Doklumente finden Sie mit ‘signiert’.