Integration von Comarch DMS mit dem e-Delivery (e-Doręczenia)-System – Nachrichten abrufen

In der Version 2024.1.0 wurde die Integration von Comarch DMS mit dem e-Delivery (e-Doręczenia)-Service eingeführt.

Achtung

Die Integration von Comarch DMS mit dem e-Delivery (e-Doręczenia)-Service ist nur im Rahmen der Comarch DMS Premium-Lizenz verfügbar – sofern im Web.config-File im Ordner mit den Dateien der Comarch DMS-Serveranwendung der Wert des Schlüssels PremiumFunctionality auf „True“ gesetzt ist.

Im ersten Schritt der Integration von Comarch DMS mit dem e-Delivery (e-Doręczenia)–System wurde ein Autorisierungsmechanismus sowie ein Mechanismus zum Abrufen von Nachrichten aus dem e-Delivery (e-Doręczenia) System mittels eines dedizierten ACD-Punktes eingeführt.

Änderungen im Web.config-File im Verzeichnis der Server-Anwendung

In der Version 2024.1.0 wurde im Web.config-File im Verzeichnis der Server-Anwendung von Comarch DMS der Abschnitt E-doręczenia hinzugefügt, der vier Schlüssel enthält:

<add key=”EDorAuthApiUrl” value=”https://ow.edoreczenia.gov.pl/auth/realms/EDOR” /> – enthält die URL für das Abrufen des Zugangstokens für die APIs von Search Engine und User Agent;
<add key=”EDorUserAgentApiUrl” value=”https://uaapi-ow.poczta-polska.pl/api/v2″ /> – der Endpunkt für die API der Search Engine;
<add key=”EDorSearchApiUrl” value=”https://ow.edoreczenia.gov.pl/api/se/v2″ /> – der Endpunkt für die API des User Agent;
<add key=”EDorMaxMessageSize” value=”15″ /> – gibt die maximale zulässige Größe von Anhängen an, die über den E-Delivery (E-Doręczenia)-Service gesendet werden. Der aktuelle Wert beträgt 15 MB. Dieser Schlüssel ist in der ersten Version der Funktionalität inaktiv.

Das Web.config-File mit dem Abschnitt „E-doręczenia“

Hinzufügen eines neuen ACD-Punkt-Typs „Importieren von Dokumenten aus der e-Delivery-Box“

In der Version 2024.1.0 wurde im Rahmen der Registerkarte [Automatische Generierung von Dokumenten] ein neuer ACD-Punkt-Typ „Importieren von Dokumenten aus der e-Delivery-Box” hinzugefügt, um das Abrufen von Nachrichten aus dem e-Delivery (e-Doręczenia)-Service zu ermöglichen.

Registerkarte „Kooperationsmodus“

Um einen Konfigurationspunkt des Typs „Importieren von Dokumenten aus der e-Delivery-Box“ zu erstellen, sollte im Fenster „Automatische Generierung von Dokumenten“ ein neuer Konfigurationspunkt mit dem Icon hinzugefügt werden, und anschließend im Modusauswahl-Menü die Option „Importieren von Dokumenten aus der e-Delivery-Box“ ausgewählt werden.

Achtung

Für die korrekte Zusammenarbeit des Comarch DMS-Systems mit dem e-Doręczenia-Service ist die Synchronisierung der IIS-Serverzeit mit der Uhrzeit des Hauptamts für Maß und Gewicht (Główny Urząd Miar) tempus1.gum.gov.pl.

Informationen zur Uhr finden Sie auf der Website: https://www.gum.gov.pl/pl/dla-biznesu/uslugi/zegar/524,Zegar.html.

Auswahl des ACD-Punkt-Typs „Importieren von Dokumenten aus der e-Delivery-Box“ in der Registerkarte „Kooperationsmodus“

Registerkarte „Allgemein“

Die Registerkarte „Allgemein“ enthält die folgenden Felder:

Punktname – der Name, unter dem der Konfigurationspunkt in der Liste der Punkte angezeigt wird;
Organisation – das Unternehmen, dem ein bestimmter ACD-Punkt zugeordnet werden soll; Feld im Mehrfirmenmodus verfügbar
Workflow-Typ – der Workflow-Typ, in dem Dokumente erstellt werden, die Daten aus diesem ACD-Punkt enthalten;
Postfach-Adresse – die e-Delivery (e-Doręczenia)-Postfachadresse, direkt aus dem Postfach entnommen;

Beispiel für eine e-Delivery (e-Doręczenia)-Adresse, die in das Feld „Postfach-Adresse“ eingetragen werden sollte

Der Name des Systems, der in der Konfiguration der e-Delivery-Box eingegeben wurde – der Name des Comarch DMS-Systems, das mit dem e-Delivery (e-Doręczenia)-Service integriert ist, der bei der Konfiguration des e-Doręczenia-Postfachs im Rahmen des Feldes „Systemy“ hinzugefügt wurde.

Anweisungen zum Hinzufügen eines externen Systems zum E-Delivery (E-Doręczenia) -Dienst (auf Polnisch) finden Sie unter:

https://www.gov.pl/attachment/07a8c8c5-b329-44cf-9e08-ed7c497f6d1c

Beispiel für einen Systemnamen, der im Feld „Systemy“ während der Konfiguration des e-Doręczenia-Postfachs hinzugefügt wurde und im Feld „Der Name des Systems, der in der Konfiguration der e-Delivery-Box eingegeben wurde“ eingetragen werden sollte

Privater Schlüssel – das Feld, in dem der private Schlüssel hinzugefügt wird, der im Zertifikatserstellungsprozess erzeugt wurde – geliefert zusammen mit dem Zertifikat. Um den privaten Schlüssel hinzuzufügen, klicken Się auf das Icon im Feld, und wählen Się dann im geöffneten Systemfenster den entsprechenden PEM-Schlüssel aus und klicken auf [Öffnen]. Der private Schlüssel, der in die Definition des ACD-Punktes hinzugefügt wurde, kann mit dem Icon gelöscht oder mit dem Icon auf der Festplatte gespeichert werden.

Auswahl des PEM-Schlüssels im Feld „Privater Schlüssel“

Die Ansicht der Registerkarte „Allgemein“ mit dem hinzugefügten privaten Schlüssel im Feld „Privater Schlüssel“ – mit den Symbolen zum Löschen und Speichern des Schlüssels

Lassen Się zu die Nachrichten aus der Liste und aus der e-Delivery-Box entfernen – ein Parameter, der festlegt, wie Nachrichten gelöscht werden. Wenn der Parameter:
- Nicht markiert ist – werden die Nachrichten nur aus Comarch DMS gelöscht;
- Markiert ist – werden die Nachrichten sowohl aus Comarch DMS als auch aus dem e-Doręczenia-Postfach gelöscht

Registerkarte „Steuerelemente“

Auf der Registerkarte „Steuerelemente“ müssen Się mit SQL-Anfragen die Werte festlegen, die in den verschiedenen Steuerelementen des Workflow-Typs nach der Verarbeitung des Dokuments angezeigt werden.

Anhänge, die mit der Nachricht gesendet werden, werden dem angegebenen Steuerelement vom Typ Anhang hinzugefügt.

Auswahl des Steuerelements vom Typ Anhang, in das der Anhang eingefügt werden soll, der mit der Nachricht gesendet wurde

Registerkarte „Berechtigungen“

Auf der Registerkarte werden die Berechtigungen für die Arbeit mit dem Konfigurationspunkt festgelegt. Berechtigungen können durch Angabe von Mitarbeitern hinzugefügt werden; es gibt jedoch keine Möglichkeit, Berechtigungen für Mitarbeiter einer bestimmten Abteilung oder Mitarbeiter mit bestimmten Positionen hinzuzufügen.

Auf jeder Registerkarte befindet sich ein [Export]-Icon, mit dem der ACD-Punkt zur Speicherung auf der Festplatte exportiert werden kann.

Registerkarte „Berechtigungen“ innerhalb des ACD-Punkttyps „Importieren von Dokumenten aus der e-Delivery-Box“ – Einzelfirmenmodus

Registerkarte „Berechtigungen“ innerhalb des ACD-Punkttyps „Importieren von Dokumenten aus der e-Delivery-Box“ – Mehrfirmenmodus

Arbeit mit dem ACD-Punkt vom Typ „Importieren von Dokumenten aus der e-Delivery-Box“

Um die Arbeit mit dem ACD-Punkt vom Typ „Importieren von Dokumenten aus der e-Delivery-Box“ zu beginnen, klicken Się auf das Icon [Nachrichten herunterladen]. Ein Fenster „Importieren von Nachrichten aus dem e-Delivery-Dienst“ wird geöffnet, in dem Się die Schaltfläche [Importieren] drücken müssen.

Das Fenster „Importieren von Nachrichten aus dem e-Delivery-Dienst“ vor dem Klicken auf „Importieren“

Das Fenster „Importieren von Nachrichten aus dem e-Delivery-Dienst“ nach dem Klicken auf „Importieren“

In der Nachrichtenliste im Rahmen des Fensters „Importieren von Nachrichten aus dem e-Delivery-Dienst“ stehen folgende Spalten zur Verfügung:

Absender– in dieser Spalte wird der Absender der Nachricht angezeigt;
Thema – in dieser Spalte ist der Betreff der Nachricht sichtbar;
Liefertermin – in dieser Spalte wird der Tag angezeigt, nd em die Nachricht zugestellt wurde.

Im oberen Teil des Fensters befindet sich der Parameter [Zeige Nachrichten, die in Comarch DMS gespeichert sind] – wenn dieser Parameter aktiviert ist, werden auch Nachrichten angezeigt, die bereits in Comarch DMS registriert wurden – solche Dokumente werden in der Nachrichtenliste im Fenster ausgegraut.

Das Fenster „Importieren von Nachrichten aus dem e-Delivery-Dienst“ mit aktiviertem Parameter „Zeige Nachrichten, die in Comarch DMS gespeichert sind“

Nach dem Laden der Nachrichtenliste sollten Się die gewünschten Elemente markieren und die Schaltfläche [Speichern] klicken, um das Fenster „Importieren von Nachrichten aus dem e-Delivery-Dienst“ zu schließen, und die Nachrichtenliste wird in Comarch DMS angezeigt.

Das Fenster „Importieren von Nachrichten aus dem e-Delivery-Dienst“ nach Auswahl eines Dokuments zum Registrieren in Comarch DMS

Wenn der Benutzer auf [Abbrechen] klickt, wird das Fenster „Importieren von Nachrichten aus dem e-Delivery-Dienst“ geschlossen und die Nachrichten werden nicht in Comarch DMS registriert.

Achtung

Wenn der Benutzer auf

[Importieren] klickt und die Dokumente aus dem e-Doręczenia-Service (e-Delivery) ins Fenster „Importieren von Nachrichten aus dem e-Delivery-Dienst“ abruft und dann auf

[Abbrechen] klickt, werden die Dokumente nicht im laufenden ACD-Punkt angezeigt, aber der e-Doręczenia (e-Delivery)-Service generiert Bestätigungen, dass die Nachricht an den Empfänger zugestellt wurde.

Nach dem Klicken auf [Speichern] wird auf der rechten Seite des ACD-Fensters die Liste der Nachrichten angezeigt, die aus dem e-Doręczenia (e-Delivery)-Postfach abgerufen wurden. Die Liste besteht aus drei Spalten:

Absender
Thema
Liefertermin

Neben Nachrichten mit Anhängen wird ein Symbol angezeigt.

Wenn Się mit der rechten Maustaste auf eine bestimmte Nachricht klicken, wird ein Kontextmenü mit den folgenden Optionen angezeigt:

Aus der Liste löschen – nach der Auswahl dieser Option wird die Nachricht aus der Nachrichtenliste entfernt

Achtung

Wenn der Benutzer eine Nachricht mit der Option „Aus der Liste löschen “ aus der Liste entfernt, wird das Dokument nicht mehr im laufenden ACD-Punkt angezeigt, die Nachricht wird jedoch als in Comarch DMS gespeichert markiert und kann nicht erneut abgerufen werden.

Technische Nachweise herunterladen – Wenn der Bediener diese Option wählt, wird ein Systemfenster geöffnet, in dem die gewünschte Speicherungslocation für technische Beweise im ZIP-Format ausgewählt werden kann

Das Kontextmenü einer Nachricht, die im Rahmen des ACD-Punkts in Zusammenarbeit mit dem e-Doręczenia (e-Delivery)-Service gespeichert ist

Auswahl der Location, an der die technischen Beweise gespeichert werden

Ansicht der Datei mit den technischen Beweisen nach dem Entpacken

Speichern Sie Anhänge als – wenn der Bediener diese Option wählt, wird ein Systemfenster geöffnet, in dem die gewünschte Speicherlocation für Anhänge aus der jeweiligen Nachricht ausgewählt werden kann

Auswahl der Location, an der die Anhänge aus der Nachricht gespeichert werden

Die Nachrichten, die im ACD-Punkt abgerufen wurden, sind mit einer ACD-Punkt-ID und einer Benutzer-ID gekennzeichnet. Die standardmäßig angezeigte Nachrichtenliste im ACD-Punkt enthält alle Nachrichten, die vom angemeldeten Benutzer aus e-Doręczenia abgerufen wurden und aus denen keine Comarch DMS-Dokumente erstellt wurden.

Über der Nachrichtenliste befindet sich die Information „Anzahl der Nachrichten“, neben der die Anzahl der für den jeweiligen Bediener angezeigten Nachrichten sichtbar ist.

Darunter befindet sich ein Filter [Nachrichten anzeigen, die in den letzten X Tagen zugestellt wurden] – mit diesem Filter können Sie die Nachrichtenliste auf diejenigen Nachrichten beschränken, deren Zustellungsdatum im ausgewählten Datumsbereich liegt.

Unterhalb des Filters [Nachrichten anzeigen, die in den letzten X Tagen zugestellt wurden] befindet sich der Parameter [Alle abgerufenen Nachrichten in einem Punkt anzeigen], dessen Aktivierung ermöglicht, alle Nachrichten anzuzeigen, die in diesem ACD-Punkt von allen berechtigten Benutzern abgerufen wurden. Der Standardparameter ist nicht markiert – in diesem Fall zeigt die Liste des angemeldeten Bedieners nur Nachrichten, die er aus dem e-Doręczenia (e-Delivery)-Service abgerufen hat.

Darunter befindet sich der Filter [Alles auswählen] – wenn der Bediener diesen Parameter auswählt, werden alle Nachrichten in der Liste markiert.

Wenn der Bediener Nachrichten aus der Liste auswählt, werden auf der linken Seite des ACD-Punktes die Daten zu dieser Nachricht angezeigt. Im oberen Teil des Fensters ist eine Vorschau des grafischen Anhangs sichtbar – des ersten aus der Liste der Anhänge, die neben der Vorschau angezeigt wird.

Im unteren Teil des Fensters befinden sich die Steuerelemente, die in der Registerkarte „Steuerelemente“ während der Konfiguration des ACD-Punktes ausgewählt wurden, zusammen mit den Werten, die mit SQL-Abfragen definiert wurden.