This chapter covers the setup, authentication and concrete usage of operations that can be executed via the webservice interface provided by Fabasoft Contracts.
Setup
The WSDL can be reached via this URL:
https://<host>/<vdir>/fscdav/wsdl?WEBSVC=IDANGLCONTRACTS_111_100_WebService
In the data location “Germany“, the variable “<host>“ needs to be replaced with “https://de.cloud.fabasoft.com“ and “<vdir>“ with "folio“:
https://de.cloud.fabasoft.com/folio/fscdav/wsdl?WEBSVC=IDANGLCONTRACTS_111_100_WebService
The web service also supports JSON:
https://<host>/<vdir>/wsjson/IDANGLCONTRACTS_111_100_WebService/<operation>
Authentication
In order to authenticate yourself, you must use your e-mail address as your user name and generate a password for applications. Read the instructions in the chapter ”Access for Applications: new window“ in the document ”User Help Fabasoft Cloud“.
WSImportZIP imports a ZIP archive into a contract manager list. The optional parameter name Contains the name of the ZIP archive. If name has no value, a name is automatically generated according to the pattern ”Import <current date>“. The parameter baselist requires the Fabasoft Cloud ID of a contract manager list, otherwise the operation fails. The optional parameter extension Contains the file format. If extension has no value, the operation falls back to the ZIP format.
WSGetExportZIPs fetches a list of all keys of ZIP archives contained by contract manager files within contract manager lists. The parameter baselist requires the Fabasoft Cloud ID of contract manager list, otherwise the operation fails. The parameter selector requires an object with an attribute or an attribute definition that contains contract manager files or assignment targets. The return value keys contains a list of all keys to ZIP archives that are to be exported. If the parameter selector has no value, the Fabasoft Cloud ID of the contract manager list is set. If the value of selector is a contract manager file, the keys in the return value are formatted like “COO.a.b.c.d|COO.e.f.g.h“. If the value of selector is an attribute definition (for example the list of expired contracts), the list in keys contains an individual entry for each contract.
WSImportSuppliers imports a list of suppliers from an XML file in the IDoc format. The optional parameter context contains the Fabasoft Cloud ID of the import context which normally is a contact room. The parameter data requires the XML file, otherwise the operation fails. The optional parameter synchronous determines if the XML is processes (a)synchronously since large amounts of data may cause a timeout.
Note: While the webservice is active, all currently processes data objects are visible in the area “Asynchronous Data Objects” in the Contract Manager Configuration.
WSImportBaseListsAndRoles imports a number of Contract Manger lists from an Excel worksheet. The parameter data requires the worksheet, otherwise the operation fails. The parameter configuration requires the Fabasoft Cloud ID of an App Room (e.g. the Contract Manager Configuration), otherwise the operation fails.
If there are permissions defined in the import Excel worksheet, members and organization units are added to the organization of the current user. After the import, a new Excel worksheet is generated that contains the Fabasoft Cloud IDs of the newly created contract manager lists.
Before executing the operation, do the following steps: