Allgemeine Fragen
Frage: Wo kann ich alle Informationen über Webdienste finden?
Antwort:
- Dokumentation zu Webdiensten
- Universal Modules-Dokumentation (Liste der Webservice-Typen und mehr)
- Allgemeine Entwicklerseite (für den Fall, dass der Webdienst auf unsere API zugreifen oder DocuWare-URLs erstellen soll)
- Entwicklerseite für SOAP-Web-Services
Frage: Wie registriert man einen Web Service in DocuWare?
Antwort: Prüfen Sie KBA-36514.
Frage: Was wird benötigt, um einen Web Service mit DocuWare Cloud zu verbinden?
Antwort: Der Web Service benötigt eine IP, die öffentlich verfügbar ist. Außerdem benötigt er einen öffentlichen FQDN und HTTPS (TLS 1.2).
Und die DocuWare Cloud muss in der Web-Service-Firewall freigeschaltet sein.
Weitere Informationen finden Sie in KBA-36612.
Frage: Wie kann ich DocuWare Cloud in der Webservice-Firewall freischalten?
Antwort: Prüfen Sie KBA-36612.
Frage: Wie kann ich eine funktionierende HTTPS-Verbindung aktivieren?
Antwort: Prüfen Sie KBA-36222.
Frage: Wie kann ich den Zugriff auf die API testen, ohne den Webdienst öffentlich zu machen?
Antwort: Bitte verwenden Sie unsere Präsentations-VMs, die für Partner verfügbar sind und ein OnPremise DocuWare System (Demo) ausliefern.
Frage: Wie kann ich eine Datei an den Webservice senden?
Antwort: Ändern Sie den Webservice so, dass er einen Parameter für die Dokumenten-ID hat. Sobald er die DocID erhalten hat, muss er auf die DocuWare API zugreifen und das Dokument herunterladen. Es ist nicht möglich, eine Datei direkt über den Workflow in den Webservice hochzuladen.
Wenn Sie das Dokument nur als Datei benötigen, können Sie es auch über eine E-Mail-Aktivität versenden.
Frage: Welche Arten von Webdiensten werden von Workflow unterstützt?
Antwort: Es werden Webdienste des Typs REST und SOAP unterstützt. Für beide müssen Sie einige Anforderungen erfüllen, damit der Webdienst kompatibel ist.
Weitere Informationen finden Sie in KBA-36669.
REST-bezogene Fragen
Frage: Wie erstellt man einen REST-Webdienst?
Antwort: Zunächst einmal benötigen Sie mindestens DocuWare 7.5. Dafür gibt es verschiedene Frameworks und Templates. Es gibt kein Beispiel von DocuWare, aber stellen Sie sicher, dass DocuWare alle obligatorischen Funktionen des Services unterstützt (siehe unten).
Frage: Welche Funktionen bietet die REST-Web-Service-Aktivität?
Antwort: Sie kann einen HTTP-Request mit JSON oder XML senden, Sie können die HTTP-Methoden GET, PUT, POST und DELETE ändern.
Sie können auch die URL-Route, Abfrageparameter und HTTP-Header festlegen, den HTTP-Request-Body mit Variablen und Indexfeldern füllen und den HTTP-Response-Body Variablen und Indexfeldern zuweisen.
Sie hat die Möglichkeit, die HTTP-Codes (neben 200/OK), die als OK-Response gelten, frei zu wählen und sie ebenfalls Variablen zuzuweisen.
Cookies und andere Antwort-Header können nicht gespeichert werden, so dass ein direkter Aufruf der DocuWare-API über die Aktivität nicht unterstützt wird.
Wenn Sie über REST auf die DocuWare-API zugreifen wollen, müssen Sie einen eigenen Webservice erstellen und die API in dessen Code aufrufen oder die iPaaS Connectors verwenden.
Weitere Informationen finden Sie in KBA-36968.
SOAP-bezogene Fragen
Frage: Welchen Typ oder welches Beispiel sollte ich für SOAP verwenden?
Antwort: Wir empfehlen dringend, denselben Projekttyp wie unsere Beispiele zu verwenden, da nicht alle SOAP-Dienste kompatibel sind.
Wenn Sie einen solchen Dienst in Visual Studio erstellen möchten, erstellen Sie ein neues Projekt vom Typ "ASP.NET Web Application", fügen Sie > neues Element hinzu (wählen Sie Webservice (ASMX)). In der ...asmx.cs-Datei sollte jede Web-Methode das Tag [WebMethod] haben.
Weitere Informationen finden Sie auf der Entwicklerseite für SOAP-Webdienste.
Frage: Was ist der Unterschied in DocuWare zwischen SOAP Web Services und REST Web Services?
Antwort: Anstatt die XML- oder JSON-Payloads des Webservices selbst zu formatieren und zu kodieren, können Sie Variablen über Dropdown-Listen für jeden Parameter zuweisen.
Es ist nicht so flexibel wie REST, aber einfacher in den Workflow zu implementieren, da es weniger Optionen zur Konfiguration gibt. Weitere Informationen finden Sie auf der Entwicklerseite für SOAP-Webdienste.
Frage: Welche Variablentypen sind für SOAP-Webdienstezulässig ?
Antwort: Verwenden Sie als Parameter nur unterstützte Variablentypen: bool, int, string, DateTime und decimal.
Verwenden Sie für die Rückgabe eine Variable mit unterstützten Typen oder eine Klasse mit Eigenschaften von unterstützten Typen. Hier kann es helfen, die Rückgabe der Methode [WebMethod] CurrentDocuWareVersion() aus unserem Beispiel-Webdienst zu überprüfen. Weitere Informationen finden Sie in KBA-36451.
Frage: Wie veröffentlicht man einen SOAP-Webdienst im IIS?
Antwort: Sehen Sie sich KBA-36232 und die Entwicklerseite für SOAP-Webdienste an (suchen Sie nach Anweisungen für die Veröffentlichung von Webdiensten).
Frage: Wie verwende ich die Authentifizierung für meinen SOAP-Webdienst?
Antwort: Prüfen Sie KBA-36262.
KBA ist sowohl für Cloud- als auch für On-Premise-Organisationen anwendbar.
Bitte beachten Sie: Dieser Artikel ist eine Übersetzung aus dem Englischen. Die in diesem Artikel enthaltenen Informationen basieren auf der/den englischsprachigen Originalversion(en) des Produkts. In der übersetzten Version unserer Artikel können kleinere Fehler enthalten sein, z.B. in der Grammatik. Wir können zwar nicht für die vollständige Richtigkeit der Übersetzung garantieren, aber in den meisten Fällen werden Sie sie als ausreichend informativ empfinden. Im Zweifelsfall wechseln Sie bitte zurück zur englischen Version dieses Artikels.