Fabasoft Contracts stellt eine Webservice-Schnittstelle zur Verfügung. In diesem Kapitel wird die Einrichtung, die Authentisierung sowie die konkrete Verwendung der einzelnen Operationen erläutert.
Einrichtung
Die WSDL ist unter folgender URL erreichbar:
https://<host>/<vdir>/fscdav/wsdl?WEBSVC=IDANGLCONTRACTS_111_100_WebService
„<host>“ ist in der Lokation Deutschland durch „https://de.cloud.fabasoft.com“ zu ersetzen und „<vdir>“ durch „folio“:
https://de.cloud.fabasoft.com/folio/fscdav/wsdl?WEBSVC=IDANGLCONTRACTS_111_100_WebService
Das Webservice unterstützt auch das JSON-Format:
https://<host>/<vdir>/wsjson/IDANGLCONTRACTS_111_100_WebService/<operation>
Authentisierung
Zur Authentisierung müssen Sie als Benutzernamen Ihre E-Mail-Adresse verwenden und ein Passwort für Anwendungen für „Vertragsmanager“ generieren. Um ein Passwort für Anwendungen zu generieren, gehen Sie folgendermaßen vor:
https://help.cloud.fabasoft.com/index.php?topic=doc/Benutzerhilfe-Fabasoft-Cloud-ger/kontoeinstellungen.htm#zugriff-fuer-anwendungen: neues Fenster
WSImportZIP importiert ein ZIP-Archiv in eine Vertragsmanagerliste. Der optionale Parameter name erhält den Namen des ZIP-Archivs; wenn der Paramater leer ist, wird automatisch ein Name für die Datei nach dem Muster „Import <aktuelles Datum>“ generiert. Der Parameter baselist verlangt als Wert die Fabasoft Cloud ID einer Vertragsmanagerliste, ansonsten schlägt die Operation fehl. Der optionale Parameter extension erhält als Wert das Dateiformat; wird kein Wert vergeben, setzt die Operation standardmäßig das ZIP-Format. Der Parameter data verlangt als Wert die zu übertragende Datei, andernfalls schlägt die Operation fehl.
WSGetExportZIPs ruft eine Liste aller Schlüssel von ZIP-Archiven ab, die Vertragsmanagerakten in einer Vertragsmanagerliste enthalten. Der Parameter baselist verlangt als Wert die Fabasoft Cloud ID einer Vertragsmanagerliste, ansonsten schlägt die Operation fehl. Der Parameter selector verlangt als Wert ein Objekt mit einem Attribut bzw. eine Attributsdefinition, in dem Vertragsmanagerakten bzw. Zuordnungsziele enthalten sind. Der Rückgabewert keys enthält eine Liste aller Schlüssel zu ZIP- Archiven, die exportiert werden sollen.
Wenn der Parameter selector keinen Wert enthält, wird standardmäßig die Fabasoft Cloud ID der Vertragsmanagerliste gesetzt.
Wenn als selector eine Vertragsmanagerakte definiert wird, werden die Schlüssel im Rückgabewert nach dem Muster „COO.a.b.c.d|COO.e.f.g.h“ ausgegeben.
Wenn als selector eine Attributsdefinition (z. B. die Liste der abgelaufenen Verträge) definiert wird, enthält die Liste in keys für jeden Vertrag einen eigenen Eintrag.
WSImportSuppliers importiert eine Liste von Lieferanten aus einer XML-Datei im IDoc-Format. Der optionale Parameter context enthält die Fabasoft Cloud ID für den Kontext des Imports; standardmäßig ist dieser ein Kontaktraum. Der Parameter data verlangt die XML-Datei, ansonsten schlägt die Operation fehl. Der optionale Parameter synchronous legt fest, ob die Verarbeitung der XML-Datei synchron oder asynchron durchzuführen ist, da große Datenmengen gegebenenfalls ein Timeout bewirken können.
Hinweis: Wenn das Webservice asynchron aufgerufen wird, sind die aktuell in Verarbeitung befindlichen Datenobjekte in der Vertragsmanager-Konfiguration im Bereich „Asynchrone Datenobjekte“ sichtbar.
WSImportBaseListsAndRoles importiert eine Reihe von Vertragsmanagerlisten aus einer Excel-Arbeitsmappe. Der Parameter data verlangt als Wert ein Excel-Arbeitsblatt, ansonsten schlägt die Operation fehl. Der Parameter configuration verlangt als Wert die Fabasoft Cloud ID eines App-Rooms (z. B. die ID der Vertragsmanager-Konfiguration), ansonsten schlägt die Operation fehl.
Wenn in der importierten Excel-Arbeitsmappe Berechtigungen definiert sind, werden die Benutzer und Organisationseinheiten der Organisation des aktuellen Benutzers hinzugefügt.
Nach dem Import wird eine neue Excel-Arbeitsmappe erzeugt, die die Fabasoft Cloud IDs der erzeugten Vertragsmanagerlisten enthält.
Führen Sie vor dem Aufruf der Operation die folgenden Schritte aus: