Open Source Dokumentenmanagement
Dokumentation
Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht
Navigation: Dokumentationen agorum core > Übersicht tags > agorum core SAP-Schnittstelle
agorum core SAP-Schnittstelle konfigurieren
Die SAP-Schnittstelle von agorum core dient zum Übertragen von Dateien aus SAP nach agorum core.
SAP-Schnittstelle aktivieren
Um die SAP-Schnittstelle zu konfigurieren, aktivieren Sie die Schnittstelle im agorum core support tool.
Das Repository in agorum core konfigurieren
Während der Aktivierung erstellt das System in der MetaDB unter folgendem Pfad automatisch ein Repository namens AP:
MAIN_MODULE_MANAGEMENT/sap/control/repositories/AP
Das Repository dient als Grundlage für eine eigene Konfiguration. Sie können es anpassen oder kopieren.
Folgende Konfigurieren können Sie vornehmen:
| Property-Entry | Beschreibung | Standard |
|---|---|---|
| BasePath | Definiert, in welchem Ordner die Dateien von SAP abgelegt werden.
Tipp: Verweisen Sie auf einen Pfad, der den Namen der Software sowie das Repository enthält. Dadurch fällt die Nachverfolgung von Fehlern später leichter. Hinweise:
|
/agorum/roi/Files/SAP/AP/${SDF:yyyy/MM/dd} |
| Description | Beschreibt das Repository für den Administrator. | AP - TestContentRepository |
| FileName | Definiert den Dateinamen des überführten Dokuments. | ${docId}.${extension} |
| RemoteId | Diesen Wert speichert agorum core intern ab, wodurch Sie Dokumente wiederfinden können.
Hinweis: Verändern Sie den hier angegebenen Standard nicht, abgesehen vom AP-Eintrag. |
SAP://AP/${docId} |
| Repository | Definiert den Namen des Repositorys.
Tipp: Um Verwirrungen zu vermeiden, tragen Sie an dieser Stelle den Namen des Property-Bundles ein: MAIN_MODULE_MANAGEMENT/sap/control/repositories/<Property-Bundel> |
AP |
| StatusDescription | Definiert den Status-Wert, der beim URL-Aufruf zurückgegeben wird.
Hinweis: Verändern Sie den hier angegebenen Standard nicht! |
available |
Hinweis: Die Abkürzung AP steht für Archiv- Produktiv. Sie können auch ein Repository namens AT für Archiv- Test anlegen. Der Name Ihres Repositorys kann grundsätzlich beliebig sein, sollte aber keine Leerzeichen und Sonderzeichen enthalten.
Die Lauffähigkeit des Services prüfen
Nach erfolgter Konfiguration überprüfen Sie mit folgendem Link, ob das angepasste Repository aufrufbar ist und der Service läuft:
http://<agorum-core-Server-Url>/sap/archivelink/request?serverInfo&contRep=<repository z. B. AP>
Die Verbindung zu SAP testen
Während der Aktivierung der SAP-Schnittstelle erstellt das System im agorum core support tool eine neue Oberfläche, über die Sie Ihre Verbindung zu SAP testen können:
- Öffnen Sie links in der Seitenleiste Weitere Apps und dann support tool.
- Wählen Sie links im Menü SAP service > Checks > SAP Check oder SAP service >Sub Statistics > SAP Logging.
Beispiel einer fehlgeschlagenen Verbindung
Unter SAP Logging finden Sie Informationen zu den Logging-Events.
Mithilfe der Schaltflächen Show Log links oben in der Ecke erhalten Sie weitere Informationen.
Zertifikat akzeptieren
Nachdem Sie ein Zertifikat von SAP nach agorum core übermittelt haben (siehe Konfigurationen in SAP vornehmen und Zertifikat senden), müssen Sie einen neu angelegten Zertifikatseintrag in der MetaDB anpassen.
Sobald sich SAP verbinden konnte, wird in dem MetaDB-Eintrag des Repositorys ein Property-Entry namens SAPCertificate.toAccept erstellt. In diesem ist der zu akzeptierende Schlüssel enthalten, der notwendig ist, damit agorum core die Dateien des SAP-Systems akzeptiert und übernimmt.
Zur Aktivierung benennen Sie diesen Eintrag in SAPCertificate um. Anschließend kann die Ablage von SAP nach agorum core getestet werden.
//Alt: MAIN_MODULE_MANAGEMENT/sap/control/repositories/<Ihr repository, etwa AP>/SAPCertificate.toAccept //Neu: MAIN_MODULE_MANAGEMENT/sap/control/repositories/<Ihr repository, etwa AP>/SAPCertificate
Hinweis: Sie müssen agorum core neu starten, falls das Zertifikat für das jeweilige Repository schon einmal eingerichtet war und Sie ein neues Zertifikat übermittelt haben.
Konfigurationen in SAP vornehmen
Die Konfiguration muss vom SAP-Dienstleister durchgeführt werden, im Folgenden sind jedoch Hinweise gegeben.
SAP Content Repository anlegen
Füllen Sie den Dialog unter Content Repository folgendermaßen aus:
Verbindung testen
Testen Sie das Protokoll:
agorum core-Status abfragen
Die Status-Informationen öffnen Sie über Klick auf das mittlere Symbol:
Detailansicht in der Content-Server-Administration
Die Detailansicht in der Content-Server-Administration stellt sich folgendermaßen dar:
Zertifikat senden
Senden Sie abschließend das Zertifikat:
Hinweis: Ändern Sie jetzt den oben beschriebenen Zertifikat-Eintrag SAPCertificate.toAccept in der MetaDB in agorum core ab.
Dokumentenart erstellen und zum Content Repository zuordnen
Um mit Dokumenten zu arbeiten, müssen Sie zuerst Dokumentarten erstellen und dann dem Content Repository zuordnen.
Dokumentenart anlegen
Eine Dokumentenart kann etwa folgendermaßen aussehen:
Dokumentenart zum Content Repository zuordnen
Die Verknüpfung sieht etwa folgendermaßen aus:
Ablage im Content Repository testen
Vor dem produktiven Einsatz testen Sie die Schnittstelle.
Belegart zuordnen
Wählen Sie unter Business Objekt die Belegart aus:
Dokumentenart zuordnen
Wählen Sie die korrekte Dokumentenart aus:
Buchungskreis und Belegnummer zuordnen
Wählen Sie den Buchungskreis und die Belegnummer und bestätigen Sie die Ablage.
Ablage erfolgreich
Nach erfolgreicher Ablage erscheint eine Meldung.
Ergebnis
Ein Verknüpfungseintrag inklusive Dokumenten-ID erscheint:
Anzeige des abgelegten Dokuments in SAP
Die folgenden Aufrufe können das Dokument in SAP darstellen.
Aufruf aus agorum core an SAP (Anzeige SAP ELC Viewer)
SAP Viewer (SAPGUI Client Installation)
Weitere Verarbeitung
Verarbeitung innerhalb von agorum core
Normalerweise wollen Sie die Dateien nicht nur archivieren, sondern diese durch einen Automatismus weiterverarbeiten. Das kann das Speichern von Metadaten auf die importierten Dokumente sein oder die Verlinkung / Verschiebung in entsprechende Ablageordner.
Folgende Konfigurationsmöglichkeiten bestehen:
- Haben Sie den BasePath angepasst und die Dateien flach abgelegt, können Sie diese über einen Aktiven Ordner bearbeiten lassen. Welche Funktionen der Aktive Ordner ausführt, ist abhängig von Ihren Anforderungen. Sie können etwa Dokumente zum automatischen Auslesen nach docform senden oder einen per JavaScript aufgerufenen Workflow starten. Dieser Workflow wiederum kann Ihr Dokument auf die verschiedensten Arten weiterverarbeiten. Sie können etwa übergebene Metadaten-Dateien auslesen und diese Metadaten wiederum auf Ihr Dokument setzen, außerdem eine revisionssichere Ablage ermöglichen oder idoc-Dateien einlesen und aus diesen PDFs erstellen.
- Haben Sie sich für eine dynamische Ablage nach Datum entschieden (der Standardwert von BasePath), lassen Sie Ihre Dokumente durch einen Worker oder CronJob weiter verarbeiten. Auch über diese JavaScripte lässt sich etwa ein Workflow aufrufen.
Hinweis: Für Details zu Workern und CronJobs siehe Unterschied zwischen Worker und CronJob.
Daten von agorum core zum SAP-System übertragen
Sie können Dateien und Informationen von agorum core zu SAP übertragen, etwa, um Kunden-/Lieferantenakten automatisiert zu erstellen oder Aktualisierungen zwischen den Systemen auszutauschen. Dazu benötigen Sie eine individuell auf Sie angepasste SAP-Schnittstellenkonfiguration. D. h., dass ein SAP-Dienstleister eine REST-API-Konfiguration für Sie aufsetzen muss. Diese kann agorum core per JavaScript-Biblithek client-json aufrufen.
Hinweis: Wenden Sie sich bei Fragen an Ihren agorum-Ansprechpartner.