Web-Services¶
Die Funktionalität muss im Modul Web Services im Administrator-Interface konfiguriert werden. Das Paket enthält Beispielkonfigurationen sowohl für SOAP- als auch für REST-Methoden.
So importieren Sie die Konfiguration des Web-Service:
- Gehen Sie im Administrator-Interface auf die Ansicht Webservice Verwaltung.
- Klicken Sie in der linken Seitenleiste auf die Schaltfläche Web-Service hinzufügen.
- Klicken Sie in der linken Seitenleiste auf die Schaltfläche Web-Service importieren.
- Wählen Sie die Datei
scripts/GenericLinkConnectorSOAP.yml
oderscripts/GenericLinkConnectorREST.yml
innerhalb des OTRS-Home-Ordners. - Klicken Sie auf die Schaltfläche Importieren.
Diese Dateien enthalten die vollständigen Informationen zur Einrichtung des Web-Service. Der Web-Service kann nach dem Importprozess bei Bedarf angepasst werden. Das Ergebnis dieses Prozesses ist das gleiche wie das unten beschriebene manuelle Verfahren, aber mit einigen nützlichen Kommentaren, die zu den Vorgängen hinzugefügt werden. Die importierten Web-Services sind bereit und in der Lage, alle neuen Operationen, die in diesem Paket bereitgestellt werden, zu verarbeiten.
Es ist möglich, die Konfiguration manuell einzurichten, wenn Sie nicht die eingebauten Konfigurationsbeispiele verwenden möchten.
Bemerkung
Die folgenden Schritte sind nur erforderlich, wenn die Web-Services nicht wie oben erläutert importiert wurden.
Die folgenden Schritte sind erforderlich, um eine voll funktionsfähige Konfiguration bereitzustellen:
Gehen Sie im Administrator-Interface auf die Ansicht Webservice Verwaltung.
Klicken Sie in der linken Seitenleiste auf die Schaltfläche Web-Service hinzufügen.
Füllen Sie das Formular mit den folgenden Daten aus:
- Name: LinkObjectConnector
- Debug-Schwelle: Debug
- Netzwerk-Transport: HTTP::SOAP
Klicken Sie auf die Schaltfläche Speichern, um die Auswahl Operation hinzufügen und die Schaltfläche Konfigurieren für den Netzwerktransport zu aktivieren.
Klicken Sie auf die Schaltfläche Konfigurieren, um die Transportoptionen anzuzeigen.
Verwenden Sie die folgenden Parameter:
- Namensraum: https://otrs.org/LinkObjectConnector/
- Maximale Nachrichtenlänge: 100000
Klicken Sie auf die Schaltfläche Speichern. Warten Sie, bis die Seite aktualisiert wird, und klicken Sie dann auf die Schaltfläche Zurück zum Web-Service, um fortzufahren.
Die Auswahl Operation hinzufügen bietet sieben neue Operationen zur Verknüpfung an:
Link::LinkAdd Link::LinkDelete Link::LinkDeleteAll Link::LinkList Link::PossibleLinkList Link::PossibleObjectsLst Link::PossibleTypesList
Fügen Sie die Operation
Link::LinkAdd
hinzu und setzen Sie den NamenLinkAdd
in der nächsten Ansicht. Es ist keine weitere Konfiguration erforderlich.Klicken Sie auf die Schaltfläche Speichern. Warten Sie, bis die Seite aktualisiert wird, und klicken Sie dann auf die Schaltfläche Zurück zum Web-Service, um fortzufahren.
Wiederholen Sie Schritt 9 und Schritt 10 für die anderen sechs
Link::
- Operationen.Klicken Sie in der Ansicht Web Service bearbeiten auf die Schaltfläche Speichern und Fertigstellen wenn sie alle Operationen hinzugefügt haben.
Jetzt befinden Sie sich auf der Ansicht Web-Service-Verwaltung und der neue Web-Service ist bereit und in der Lage, alle neuen Operationen, die in diesem Paket angeboten werden, zu handhaben.
Bemerkung
Wenn der neue Web-Service vollständig getestet ist, könnte der Debug-Schwellenwert in Bemerkung geändert werden. Dadurch wird die Datenmenge, die in der Datenbank gehalten wird, reduziert und es werden nur Benachrichtigungen und Fehlermeldungen protokolliert.