Verwenden des Aufrufdienstes im visuellen Regeleditor für Formulare, die auf Kernkomponenten basieren

Dies ist eine Vorabveröffentlichungsfunktion, auf die über unseren Vorabveröffentlichungskanalzugegriffen werden kann.

Der visuelle Regeleditor in einem adaptiven Formular unterstützt die Funktion Dienst aufrufen mit der Sie einen Dienst aus der Liste der für Ihre Instanz konfigurierten Formulardatenmodelle (FDM) auswählen können. Sie können Formularfelder direkt den Eingabeparametern des Dienstes zuordnen. Um Formularfelder den Ausgabeparametern zuzuordnen, verwenden Sie die Payload-Option für das Ereignis für den angegebenen Formulardatenmodell-Service. Darüber hinaus können Sie mit dem visuellen Regeleditor basierend auf den Ausgabeantworten Regeln für Erfolgs- und für Vorgänge Dienst aufrufen“ erstellen. Erfolgs-Handler verwalten die erfolgreiche Ausführung des Vorgangs Service aufrufen während Fehler-Handler alle Fehler beheben, die auftreten.

Vorteile der Verwendung des Service „Invoke“ im Regeleditor des Formulars

Die Verwendung des Vorgangs „Service aufrufen“ im Regeleditor eines adaptiven Formulars bietet folgende Vorteile:

Aufrufen von Service-Handlern für Erfolgs- und Fehlerantworten

Mit dem visuellen Regeleditor können Sie basierend auf den Ausgabeantworten Regeln für Erfolgs und Fehlerhandler für Vorgänge Dienst aufrufen“ erstellen. Die folgende Abbildung zeigt den Service aufrufen im visuellen Regeleditor für ein adaptives Formular:

Um einen Erfolgs- oder Fehlerhandler hinzuzufügen, klicken Sie Erfolgs-Handler hinzufügen bzw auf Fehler-Handler hinzufügen.

Wenn Sie auf Add Success Handler klicken, wird der Regeleditor Invoke Service Success Handler angezeigt, in dem Sie Regeln oder Logiken angeben können, um die Antwort Invoke Service zu verwalten, wenn der Vorgang erfolgreich war. Sie können Regeln auch ohne Definition von Bedingungen angeben. Sie können jedoch Bedingungen für den Erfolgshandler hinzufügen, indem Sie auf die Option Bedingung hinzufügen klicken.

Sie können mehrere Regeln hinzufügen, um erfolgreiche Antworten für den Vorgang Service aufrufen zu verarbeiten:

{width="50%,"}

Auf ähnliche Weise können Sie Regeln hinzufügen, um die Service aufrufen-Ausgabeantwort zu verarbeiten, wenn der Vorgang nicht erfolgreich ist. In der folgenden Abbildung wird der Regeleditor Invoke Service Failure Handler angezeigt:

Sie können auch mehrere Regeln hinzufügen, um nicht erfolgreiche Antworten aus dem Vorgang Service aufrufen zu verarbeiten.

Die Funktion Fehlervalidierung auf dem Server aktivieren ermöglicht Validierungen, die vom Autor beim Entwerfen eines adaptiven Formulars hinzugefügt wurden, um auch auf dem Server ausgeführt zu werden.

Voraussetzungen für die Verwendung des Aufrufdienstes im Regeleditor

Im Folgenden finden Sie die Voraussetzungen, die Sie erfüllen müssen, bevor Sie Service aufrufen im Regeleditor verwenden:

Erkunden von Invoke Service durch verschiedene Anwendungsfälle

Mit dem Service „Invoke des visuellen Regeleditors Sie mehrere nützliche Vorgänge ausführen. Sie können damit Dropdown-Optionen ausfüllen, wiederholbare oder einfache Bereiche festlegen und Formularfelder validieren, und zwar alles basierend auf der Ausgabeantwort des Service aufrufen. Dadurch wird die Flexibilität und Interaktivität Ihrer Formulare verbessert.

In der folgenden Tabelle werden einige Szenarien beschrieben, in denen der Service aufrufen verwendet werden kann:

Erstellen Sie ein Get Information Formular, das Werte basierend auf der Eingabe abruft, die in das Textfeld Pet ID eingegeben wurde. Der folgende Screenshot zeigt das Formular, das in diesen Anwendungsfällen verwendet wird:

Formularfelder

Fügen Sie die folgenden Felder zum Formular hinzu:

NOTE

Wählen Sie im Feld Bindungsverweis im Dialogfeld Eigenschaften der Formularfelder aus und navigieren Sie zur binären Eigenschaft, die Sie im Formulardatenmodell (FDM) hinzugefügt haben.

Konfigurieren von Bedienfeldern

Legen Sie die Bereiche mit den folgenden Einschränkungen als repetitiv fest:

Sie können die Werte der sich wiederholenden Bereiche an Ihre Anforderungen anpassen.

Datenquelle

In diesem Beispiel wird die Swagger Petstore-API zum Konfigurieren einer Datenquelle verwendet. Das Formulardatenmodell ist für den Service getPetById konfiguriert, der je nach eingegebener ID Heimtierdetails abruft.

Posten wir die folgende JSON mit dem Service addPet in der API Swagger Petstore:

{
        "id": 101,
        "category": {
            "id": 1,
            "name": "Labrador"
        },
        "name": "Lisa",
        "photoUrls": [
            "https://example.com/photos/lisa1.jpg",
            "https://example.com/photos/lisa2.jpg"
        ],
        "tags": [
            {
                "id": 1,
                "name": "vaccinated"
            },
            {
                "id": 2,
                "name": "friendly"
            },
            {
                "id": 3,
                "name": "house-trained"
            }
        ],
        "status": "available"
    }

Regeln und Logik werden mithilfe der Aktion Service aufrufen im Regeleditor im Pet ID-Textfeld implementiert, um die erwähnten Anwendungsfälle zu demonstrieren.

Im Folgenden wird nun die Implementierung der einzelnen Anwendungsfälle im Detail untersucht.

Anwendungsfall 1: Auffüllen von Dropdown-Werten mithilfe der Ausgabe von „Service aufrufen“

Dieses Anwendungsbeispiel zeigt, wie Dropdown-Optionen basierend auf der Ausgabe eines Invoke Service dynamisch aufgefüllt werden.

Implementierung

Erstellen Sie dazu eine Regel im Pet ID Textfeld, um den getPetById-Service aufzurufen. Legen Sie in der Regel die enum-Eigenschaft des photo-url-Dropdown-Menüs unter "hinzufügen“ auf photoUrls fest.

Ausgabe

Geben Sie 101 in das Textfeld Pet ID ein, um die Dropdown-Optionen basierend auf dem eingegebenen Wert dynamisch zu füllen.

Anwendungsfall 2: Festlegen eines wiederholbaren Bereichs mithilfe der Ausgabe von „Service aufrufen“

Dieses Anwendungsbeispiel zeigt, wie wiederholbare Bereiche basierend auf der Ausgabe eines „Service " dynamisch werden.

Überlegungen

Implementierung

Erstellen Sie eine Regel für das Pet ID Textfeld, um den getPetById-Service aufzurufen. Fügen in " hinzufügen“ eine weitere Erfolgshandler-Antwort hinzu. Legen Sie in der Regel den Wert des tags Bedienfelds auf tags fest.

Ausgabe

Geben Sie 101 in das Textfeld Pet ID ein, um den wiederholbaren Bereich basierend auf dem Eingabewert dynamisch zu füllen.

Anwendungsfall 3: Festlegen des Bedienfelds mit der Ausgabe von „Service aufrufen“

Dieser Anwendungsfall zeigt, wie Sie den Wert eines Bedienfelds basierend auf der Ausgabe eines „Service " dynamisch.

Überlegungen

Implementierung

Erstellen Sie eine Regel für das Pet ID Textfeld, um den getPetById-Service aufzurufen. Fügen in " hinzufügen“ eine weitere Erfolgshandler-Antwort hinzu. Legen Sie in der Regel den Wert des categoryname Textfelds auf category.name fest.

Ausgabe

Geben Sie 101 in das Textfeld Pet ID ein, um den Bereich basierend auf dem Eingabewert dynamisch zu füllen.

Anwendungsfall 4: Verwenden des Ausgabeparameters „Service aufrufen“, um andere Felder zu validieren

Dieser Anwendungsfall zeigt, wie Sie die Ausgabe eines Service aufrufen zur dynamischen Validierung anderer Formularfelder verwenden.

Implementierung

Erstellen Sie eine Regel für das Pet ID Textfeld, um den getPetById-Service aufzurufen. Fügen in „Fehler-Handler" eine Fehler-Handler-Antwort hinzu. Blenden Sie die Senden aus, wenn eine falsche Pet ID eingegeben wurde.

Ausgabe

Geben Sie 102 in das Pet ID Textfeld ein, und die Schaltfläche Senden ist ausgeblendet.

Häufig gestellte Fragen

F: Was passiert, wenn ich eine Regel mit dem Service „Invoke“ erstellt und dann auf die neueste Version der Kernkomponenten aktualisiert habe?

A: Wenn Sie ein Upgrade auf die neueste Version der Kernkomponenten durchführen, wird die Regel Service aufrufen automatisch auf die neueste Benutzeroberfläche aktualisiert, da sie abwärtskompatibel ist.

F: Kann ich mehrere Regeln hinzufügen, um erfolgreiche oder fehlgeschlagene Antworten für den Vorgang „Service aufrufen“ zu verarbeiten?

A: Ja, Sie können mehrere Regeln hinzufügen, um erfolgreiche oder fehlgeschlagene Antworten für den Vorgang Service aufrufen zu verarbeiten.

Verwandte Artikel

Zusätzliche Ressourcen