QS_Sign Projekt

Dieses Projekt verwendet die SignoSign Universal API, um das digitale Signieren von PDF-Dokumenten zu ermöglichen. QS_Sign kann mit allen Business Central-Projekten verwendet werden, um Endbenutzern einen Signaturdienst bereitzustellen.

Die PDF-Signatur wird derzeit auf den folgenden Seiten hinzugefügt:

• Debitorenkarte: Datenschutz unterschreiben
• Kreditorenkarte: Datenschutz unterschreiben
• Kontaktkarte: Datenschutz unterschreiben
• Einkaufsbestellung: Bareinkaufsbericht - Wenn eine Einkaufsrechnung gebucht wird, wird der Bareinkaufsbericht automatisch geöffnet und man kann die Dokumente unterschreiben
• Verkaufsaufträge: Barverkaufsbericht - Wenn eine Verkaufsrechnung gebucht wird, wird der Barverkaufsbericht automatisch geöffnet und man kann die Dokumente unterschreiben

QS_Sign-Konfiguration

Suchen Sie nach SignoSign-Einstellungen und öffnen Sie die Seite. Sie sollten die folgenden Daten angeben:

• Name: {SIGNOTECH UNIVERSAL} - Der Name sollte immer "SIGNOTECH UNIVERSAL" sein
• Nutzername: Der Benutzername, den Sie von der SignoSign Universal API erhalten haben
• Kennwort: Das Passwort zur Anmeldung bei SignoSign Universal

Nach Eingabe der oben genannten Daten können Sie QS_Sign nutzen.

Beispielszenario

Dieses einfache Szenario zeigt, wie QS_Sign bei der Otto Müller Recycling GmbH verwendet wird, um den Kreditoren die digitale Signatur der Datenschutzerklärung zu ermöglichen.

1. Klicken Sie auf Kreditoren, um die Kreditorenliste zu öffnen
2. Klicken Sie auf einen Kreditor, um die Kreditor-Karte zu öffnen
3. Klicken Sie auf den Button "Datenschutz unterschreiben"

Anschließend werden Sie auf die SignoSign-Seite weitergeleitet und das Dokument wird geöffnet. Sie können das Dokument lesen und dann auf das blaue Feld zum Unterschreiben klicken.

4. Wenn sich das Signaturfeld auf der Seite nicht befindet, können Sie über die Symbolleiste ein Signaturfeld hinzufügen
5. Sie können das Feld ziehen, an der gewünschten Stelle ablegen und auf "Bestätigen" klicken. Das Signaturfeld wird als blaues Feld angezeigt
6. Klicken Sie auf das blaue Feld, um das Signaturfenster zu öffnen
7. Klicken Sie auf die Schaltfläche "Bestätigen", um Ihre Unterschrift zu bestätigen. Ihre Unterschrift wird in das Dokument eingefügt
8. Ihre Unterschrift wird automatisch gespeichert und das unterschriebene Dokument als Anhang gespeichert

Fehlerprotokoll (Log)

QS_Sign zeichnet die Fehler auf, um sie für späteres Debuggen oder Informationen zu verwenden.

Um das Log zu öffnen, suchen Sie nach "QSSignLog" oder "Log" und klicken Sie auf "QSSignLog".

Wichtig: Die Protokolltabelle verwendet "Nummernserien" als Primärschlüssel. Daher sollten Sie "QSSIGNLOG" in den Nummernserien festlegen, da das Protokoll sonst nicht eingefügt werden kann.

E-Mail Einstellungen

Wenn beim Speichern des "signierten Dokuments" ein Fehler auftritt, generiert QS_Sign ein Protokoll und sendet außerdem eine E-Mail, um über den Fehler zu informieren.

Damit QS_Sign die Fehler-E-Mail senden kann, sollten Sie in den QS_Sign Batch-E-Mail-Einstellungen eine E-Mail-Adresse und eine Betreffzeile für die E-Mail festlegen.

• Suchen Sie nach "Signotech Batch Einstellungen" und öffnen Sie die Seite
• Aktivieren Sie "Batchmonitoring aktiv?"
• Geben Sie im Feld "E-Mail" eine gültige E-Mail-Adresse ein. Diese E-Mail-Adresse erhält die Fehler-E-Mail, wenn beim Speichern der signierten Dokumente ein Fehler auftritt
• Geben Sie im Feld "Betreff" eine Betreffzeile für die E-Mail ein

QS_Sign mit SignoTech Universal Persistence Mode-Implementierung

Aufgrund eines Fehlers beim Speichern des signierten Dokuments in BC wurde QS_Sign im "Persistenzmodus" implementiert. Im Persistenzmodus wird ein Dokument mit einer bestimmten ID in der "Signotech-Datenbank" gespeichert und kann jederzeit abgerufen werden. Im Persistenzmodus verwenden wir auch ein Token für 12 Stunden und nach 12 Stunden oder wenn das Token nicht mehr gültig ist, fordert der Code ein neues Token an.

Schaltfläche "Zahlungsbestätigung unterschreiben"

Es gibt einen "Event-Abonnenten", der die Datei "Zahlungsbestätigung" automatisch zum Unterschreiben öffnet, wenn der Benutzer eine "Einkaufsrechnung" bucht. Sollte das Dokument in manchen Fällen jedoch nicht automatisch zum Unterschreiben geöffnet werden, können Sie die Datei mit der Schaltfläche "Zahlungsbestätigung unterschreiben" im Signaturmodus öffnen und unterschreiben. Die Schaltfläche befindet sich auf der Seite "Gebuchte Einkaufsrechnung".

Schaltfläche "Dokument speichern"

Es gibt eine Codeaufgabe, die "Zahlungsbestätigung"-Dateien automatisch aus der SignoTech-Datenbank in BC speichert. Wenn das automatische Speichern eines Dokuments jedoch in einem bestimmten Fall fehlschlägt, erstellt QS_Sign ein Protokoll und sendet außerdem eine E-Mail, dass das Dokument nicht in BC gespeichert wurde. Mit der Schaltfläche "Dokument speichern" können Sie die Datei dann aus der SignoTech-Datenbank in BC speichern. Die Schaltfläche befindet sich auf der Seite "Gebuchte Einkaufsrechnung" und ist aktiviert, wenn eine gültige Dokument-ID zum Suchen des Dokuments vorhanden ist.

Schaltfläche "Datenschutz speichern"

Es gibt auch Aufgaben, die Datenschutzdaten aus der SignoTech-Datenbank automatisch in BC für Kreditoren, Debitoren und Kontakte speichern. Falls jedoch ein Problem auftritt und ein Dokument nicht automatisch gespeichert werden kann, können Sie die Schaltfläche "Datenschutz speichern" verwenden, um das signierte Dokument für einen Kreditor, Debitor oder Kontakt zu speichern.

Jobs (Codeaufgaben) zum automatischen Speichern signierter Dokumente in BC

Codeunitname	ID	Projekt	Verantwortlich für	Vorherige Jobs
QSAutoSavePersistence	91815	QS_Schrott_Document	Zahlungsbestätigung zur gebuchten Einkaufsrechnung speichern	QSAutoSave
QSSaveDocPersistence	91826	QS_Sign	Kreditorendatenschutz speichern	QSSaveSignDoc
QS_SaveCustomerSign	91824	QS_Sign	Debitorendatenschutz speichern	-
QS_SaveContactSign	91823	QS_Sign	Kontaktedatenschutz speichern	-

Zahlungsformen

QS_Sign erweitert Zahlungsformen zum Aktivieren und Deaktivieren der Unterschreiben basierend auf "Zahlungsformen".

1. Öffnen Sie die Seite "Zahlungsformen"
2. Klicken Sie auf einen Zahlungs-Datensatz und aktivieren oder deaktivieren Sie das Kontrollkästchen "Unterschreiben benutzen?"

Verkaufslieferung

QS_Sign wurde erweitert, um das Unterschreiben von Geb. Verkaufslieferscheinen zu unterstützen.

Unterzeichnen eines Lieferscheins

1. Öffnen Sie die Seite "Geb. Verkaufslieferung"
2. Klicken Sie auf die Schaltfläche "Dokument unterschreiben". Dadurch wird der Standard-Verkaufslieferbericht gefunden oder generiert und in einem neuen Tab mit einem Unterschriftsfeld geöffnet. (Stellen Sie sicher, dass Ihr Webbrowser Popups zulässt, ansonsten kann der Bericht nicht in einem neuen Tab zum Unterschreiben geöffnet werden)
3. Unterschreiben Sie das Dokument und speichern Sie es
4. Klicken Sie nun auf die Schaltfläche "Dokument unterschreiben". Dadurch wird das unterschriebene Dokument in der aktuell gebuchten Verkaufslieferung gespeichert. (Stellen Sie sicher, dass Sie das unterschriebene Dokument speichern, bevor Sie die Seite schließen.)

QS_SignLog

QS_Sign verfügt über ein Protokoll, das Fehler und Details zum Signieren von Dokumenten aufzeichnet. Das Protokoll zeichnete zunächst nur Fehler und Störungen auf, wurde später jedoch erweitert, um bessere Informationen für das Signieren von Dokumenten zu liefern und so Fehler nachzuverfolgen.

Das Protokoll zeichnet die Signierung von Dokumenten wie folgt auf

1. Prozessstart: Wenn ein Benutzer einen Prozess zum Signieren eines Dokuments startet, z. B. "Zahlungsbestätigung" oder "Datenklärung", wird ein neuer Datensatz mit dem Status "Hochladen ausstehend" in die Protokolltabelle eingefügt. Der Datensatz enthält die folgenden Daten:

   • generatedAt = Zeitpunkt, wann das Dokument erstellt wurde
   • uploadedAt = Zeitpunkt, wann das Dokument bei SignoSign hochgeladen wurde
   • hitSignAt = Zeitpunkt, wann auf unterschreiben gedrückt wurde
   • signedAt = Zeitpunkt, wann das unterschriebene Dokument heruntergeladen wurde
   • status = Hochladen ausstehend | Unterschrift ausstehend | Download ausstehend | erfolgreich | fehler
   • message = Meldung
   • userId = Benutzer

2. Upload: Wenn das Dokument in Signo Tech hochgeladen werden kann, wird das Feld "uploadedAt" auf die aktuelle Uhrzeit gesetzt und der Status auf "Unterschrift ausstehend" geändert

3. Anzeige: Wenn das Dokument in der Signo Tech-Ansicht angezeigt werden kann und zur Unterschrift bereit ist, wird der Protokolleintrag "hitSignAt" auf die aktuelle Uhrzeit gesetzt und der Status auf "Download ausstehend" geändert

4. Erfolgreiche Speicherung: Nachdem das Dokument in der Signo Tech-Datenbank gespeichert wurde, versucht ein Job in Business Central, das Dokument wieder in Business Central zu speichern. Wenn der Job das Dokument erfolgreich speichert, wird das Feld "signedAt" auf die aktuelle Uhrzeit gesetzt und der Status auf "erfolgreich" geändert

5. Fehler: Wenn das signierte Dokument nicht von Signo Tech in Business Central gespeichert werden kann, wird der Status des Protokolleintrags auf "Fehler" geändert