Referenzierter Webdienst
Es ist möglich, Webdienste über REST so zu konfigurieren, dass referenzierte Tabellen in der Therefore™-Datenbank ausgefüllt werden. Bei der Konfiguration richten Sie Regeln ein, um die Daten von einem Webdienst abzurufen. Das Konfigurieren des REST-Aufrufs erfolgt ähnlich wie bei der Workflow-Aktivität "REST-Dienst aufrufen". Wenn Sie mit der rechten Maustaste auf einen referenzierten Webdienst klicken, wird ein Kontextmenü angezeigt.
Jetzt synchronisieren
Ruft Daten aus einem Webdienst ab, die in einer referenzierten Tabelle angezeigt werden. Im Rahmen der Konfiguration kann ein Zeitplan für das Abrufen der Daten eingerichtet werden (z. B. einmal täglich, mehrmals täglich). Verwenden Sie diese Option, um Daten sofort zu synchronisieren, falls Daten außerhalb der geplanten Zeiten aus dem Webdienst abgerufen werden müssen.
Zeilen löschen
Löschungen im Webdienst werden nicht automatisch auch in Therefore™ gelöscht. Verwenden Sie diese Option, um Zeilen in einer referenzierten Tabelle manuell zu löschen, wenn etwas falsch konfiguriert wurde. Sie können diese Option auch verwenden, um zu prüfen, ob die Synchronisierung mit der referenzierten Tabelle ordnungsgemäß funktioniert.
|
Hinweis: |
Das Dialogfeld "Referenzierter Webdienst" enthält drei Registerkarten, die konfiguriert werden können.
Tabellendaten
Auf dieser Registerkarte können Sie die Struktur der referenzierten Tabelle definieren, in der die Daten aus dem Webdienst gespeichert werden.
Name
Geben Sie einen aussagekräftigen Namen für die referenzierte Tabelle ein, die erstellt wird.
Referenzierte Tabellenspalten
Definieren Sie die Namen und die Datentypen für die Spalten der referenzierten Tabelle. Sehen Sie sich das Antwortbeispiel in der Dokumentation Ihres REST-API-Anbieters an, um zu ermitteln, welche Spalten Sie benötigen.
Eindeutige ID
Der Primärschlüssel der Tabelle. Dies ist ein eindeutiges Element, das die referenzierte Tabelle in der Datenbank identifiziert. Es wird verwendet, wenn Sie die Tabelle zu einer Kategorie hinzufügen.
Spaltenname
Benennen Sie die Spalten der referenzierten Tabelle. Die Namen brauchen nicht mit den entsprechenden Namen in der JSON-Antwort übereinzustimmen.
Datentyp
Wählen Sie den passenden Datentyp für die referenzierte Tabellenspalte aus. Die verfügbaren Datentypen sind Text (= Zeichenfolge), Datum, Dezimalzahl und Ganzzahl. Wählen Sie im Zweifelsfall "Text".
Länge
Die Länge des Texts bzw. die numerische Genauigkeit.
Ausmaß
Die Anzahl der Nachkommaziffern für den Datenyp "Dezimalzahl".
Hinzufügen
Fügt eine neue Spalte zur referenzierte Tabelle hinzu.
Löschen
Löscht eine ausgewählte Spalte aus der referenzierten Tabelle.
Synchronisieren
Jetzt synchronisieren
Daten sofort aus dem Webdienst abrufen.
Zurücksetzen
Setzt die Synchronisierung zurück. Die Zeilen der Tabelle werden gelöscht. Verwenden Sie diese Option, um Daten aus der Tabelle zu löschen, wenn etwas falsch konfiguriert wurde. Nachdem die Tabelle in einer Kategorie referenziert und Dokumente gespeichert wurden, ist diese Option eingeschränkt.
Synchronisierung
Auf dieser Registerkarte können Sie REST-Aufrufe an den Webdienst konfigurieren, aus dem Daten abgerufen werden.
| Symbol | Beschreibung |
|---|---|
|
Einen neuen REST-Aufruf hinzufügen. |
|
Einen REST-Aufruf bearbeiten. |
|
Einen REST-Aufruf löschen. |
|
Den REST-Aufruf in der Liste nach oben verschieben. Standardmäßig werden Aufrufe von oben nach unten nacheinander ausgeführt. |
|
Den REST-Aufruf in der Liste nach unten verschieben. |
Wenn Sie auf "Neuen REST-Aufruf hinzufügen" klicken oder auf einen bestehenden REST-Aufruf doppelklicken, wird ein Dialogfeld geöffnet, in dem Sie den REST-Aufruf konfigurieren können. Kehren Sie nach dem Konfigurieren eines REST-Aufrufs zur Registerkarte "Synchronisierung" zurück und klicken Sie auf die Schaltfläche "Test", um Daten aus dem referenzierten Webdienst abzurufen. Nach diesem Schritt sind die Zuweisungen verfügbar.
Detaillierte Informationen zum Konfigurieren einer REST-Anforderung finden Sie auf der folgenden Referenzseite:
Tabellenspaltenzuweisungen
Ordnet die Daten in der Antwort-JSON der entsprechenden Spalte in der referenzierten Tabelle zu.
Testen
Öffnet das Dialogfeld "'REST-Dienst aufrufen' testen", in dem Sie prüfen können, welche Daten mit der aktuellen Konfiguration abgerufen werden.
"REST-Dienst aufrufen" testen
Testen Sie den REST-Aufruf, der mit der aktuellen Konfiguration ausgeführt wird.
Start
Klicken Sie auf diese Schaltfläche, um den Test zu starten.
REST-Anfragen
Der Name des REST-Aufrufs, der getestet wird.
Anfrage
Name, Methode, URI und Kopfzeile des REST-Aufrufs, der getestet wird.
Statuscode
Der Statuscode des REST-Aufrufs. "2XX" entspricht einem Erfolgscode.
Antwort-Textkörper
Die REST-Antwort im JSON-Format.
Zeitplan
Definieren Sie einen Zeitplan für die Synchronisierung von Daten aus dem Webdienst.
Einmal täglich
Die Daten werden einmal täglich zur festgelegten Zeit synchronisiert.
Mehrmals täglich
Die Daten werden innerhalb des angegebenen Zeitrahmens x Mal pro Tag synchronisiert.
Deaktiviert
Daten werden nicht synchronisiert.