Regeln im Jitterbit App Builder verwalten

Einführung

Regeln werden auf der Regeln-Seite verwaltet. Um sie zu öffnen, wählen Sie App Workbench > Regeln:

Von hier aus können Sie Folgendes tun:

• Regeln anzeigen
• Regeln erstellen
• Regeln bearbeiten
• Regeln löschen

Regeln anzeigen

Wenn Sie die Regeln-Seite öffnen, ist standardmäßig die Registerkarte Alle Regeln ausgewählt. Diese zeigt alle Regeln für die aktuelle App und die ausgewählte Datenquelle der App an. Die anderen Registerkarten sind wie folgt:

• Nach Tabelle: Regeln basierend auf den Tabellen der ausgewählten Datenquelle anzeigen oder erstellen.
• Mit Reichweite: Regeln basierend auf den Reichweitenregeln für die Tabellen der ausgewählten Datenquelle anzeigen.

Die nächsten beiden Registerkarten betonen die enge Beziehung zwischen Regeln und Ereignissen:

• Alle Ereignisse: Alle Ereignisse für die aktuelle App anzeigen.
• Hintergrundereignisse: Alle Hintergrundereignisse für die aktuelle App anzeigen.

Eine Regel erstellen

Um eine Regel zu erstellen, klicken Sie auf die Schaltfläche + Regel im Abschnitt Regeln. Dies öffnet die Seite Regel-Builder:

Um fortzufahren, folgen Sie diesen Schritten:

1. Geben Sie im Feld Name einen Namen für Ihre Regel ein.
2. (Optional) Geben Sie im Feld Technische Hilfe eine Beschreibung für die Regel ein. Dieser Text ist nur für App-Entwickler sichtbar.

3. Klicken Sie auf das Menü Zweck und wählen Sie eine der Zweckoptionen. Je nach Ihrer Wahl werden zusätzliche Einstellungen angezeigt. Die verfügbaren Optionen sind in der folgenden Tabelle aufgeführt:

   Kategorie	Zweck	Quell-Datenquelle	Ziel-Datenquelle	Ziel	Zielschicht	Aktion	Diagrammtyp	Liefermethode
   Grundlegend	Geschäftsobjekt
   	CRUD
   	Validierung
   	Sichtbarkeit
   Berichterstattung	Kalender
   	Diagramm
   	Gantt
   	Karte
   	Netzwerkdiagramm
   	Bericht
   	Pivot
   Randfall	API-Aufruf
   	Benachrichtigung
   	Standard
   	Liste
   	Migration
   	Reichweite
   	Unterabfrage
   	Webhook
   	XP-Validierung
   	XP CRUD

4. Klicken Sie auf die Erstellen-Schaltfläche.

5. Verwenden Sie den visuellen Regel-Builder, um die Tabellen und Spalten hinzuzufügen, die Ihre Regel benötigt.
6. Wenn Sie fertig sind, klicken Sie auf die Validieren-Schaltfläche, um die Regel zu überprüfen.

Regel bearbeiten

Um eine Regel zu bearbeiten, befolgen Sie diese Schritte:

1. Klicken Sie auf das Bearbeiten-Symbol neben der Regel, die Sie bearbeiten möchten. Die Seite Regel-Builder öffnet sich.
2. Bearbeiten Sie die Regel. Das Layout und die Steuerelemente sind die gleichen wie beim Erstellen einer Regel. Änderungen an der Regel sind sofort wirksam.
3. (Optional) Klicken Sie auf die Validieren-Schaltfläche, um die Regel vor dem Schließen der Seite zu überprüfen.

Visueller Regel-Builder

Wenn Sie eine Regel erstellen oder bearbeiten, wird die Seite Regel-Builder in zwei Bereiche unterteilt: einen, in dem Sie den Namen und den Zweck der Regel festlegen; der andere, bestehend aus einer Reihe von Tabs, in dem Sie die Regel selbst definieren. Der Standard-Tab ist der Tabellen-Tab (auch bekannt als Visueller Regel-Builder).

Der Tabellen-Tab ist eine Leinwand, auf der Sie mit grafischen Darstellungen der Tabellen, Spalten, Joins und anderen Regeln interagieren, die die Regel bilden, an der Sie arbeiten. Je nach Zweck der Regel kann eine Tabelle automatisch zur Leinwand hinzugefügt werden.

Sie können auf der Leinwand auf folgende Weise mit den Bildern interagieren:

• Klicken und halten Sie das Label einer Tabelle, um es auf der Leinwand zu verschieben.
• Verwenden Sie die Steuerungen für die Ansicht und , um die Ansicht der Leinwand hinein- oder herauszuzoomen.
• Ziehen Sie Spalten von einer Tabelle zur anderen, um Joins zu erstellen. Diese erscheinen im Joins-Tab.
• Klicken Sie auf die + Tabellen-Schaltfläche, um Tabellen zur Regel hinzuzufügen.
• Klicken Sie auf die + Spalte-Schaltfläche, um eine Spalte zur Regel hinzuzufügen.
• Klicken Sie auf das Entfernen-Symbol, um eine Tabelle aus der Regel zu entfernen.
• Klicken Sie auf die Titelleiste der Tabelle, um eine Popup-Seite zu öffnen, auf der Sie Folgendes tun können:
  • Die Reihenfolge der Tabelle in der Abfrage festlegen.
  • Eine andere Tabelle auswählen.
  • Das Alias festlegen, das verwendet wird, um die Tabelle in Abfragen zu referenzieren.
  • Alle Spalten auswählen.
  • Die Tabelle auf der Seite Tabellendefinition bearbeiten.
  • Die Ergebnisse der Abfrage auf der Tabelle anzeigen.

Die verbleibenden Registerkarten haben die folgenden Funktionen:

• Spalten-Registerkarte: Eine Liste von Spalten, die von der Regel verwendet werden.
• Wo-Registerkarte: Eine Liste von SQL where-Klauseln, die von der Regel verwendet werden.
• Joins: Eine Liste von Tabellenverknüpfungen, die von der Regel verwendet werden.
• SQL: Die SQL-Anweisung, die die Regel bildet.
• Ergebnisse: Das Ergebnis der Ausführung der SQL-Anweisung. Klicken Sie auf das Speichern als CSV-Symbol, um die Ergebnisse als .csv-Datei herunterzuladen.

Regel löschen

Um eine Regel zu löschen, klicken Sie auf das Löschen-Symbol neben der Regel, die Sie löschen möchten, und klicken Sie dann auf die Schaltfläche Fortfahren, um zu bestätigen.

Zweck der Regel

Was eine Regel tun kann und wie sie konfiguriert ist, hängt von ihrem Zweck ab. Wenn Sie eine Regel erstellen, müssen Sie einen der folgenden Zwecke auswählen. Dieser Abschnitt beschreibt jeden.

API-Aufruf

API-Aufrufregeln definieren, wie Ihre Anwendung mit externen REST-API-Endpunkten interagiert. Sie geben die Parameter und die Struktur für das Senden von Anfragen an eine API und die Verarbeitung der Antworten an.

Ein Hauptanwendungsfall für API-Aufrufregeln ist die Verwaltung komplexer, verschachtelter JSON-Datenstrukturen. Diese treten häufig auf, wenn es um verwandte Entitäten geht (zum Beispiel einen Kunden mit mehreren Adressen). Sie werden über die Drill Down Funktion behandelt:

1. Für Daten mit hierarchischen Beziehungen definieren Sie separate API-Aufrufregeln für jede Ebene der JSON-Struktur. (Zum Beispiel könnte eine "Wurzel"-Regel die primären Kundendaten verwalten, während eine separate Unterregel das verschachtelte Array von Adressen verwaltet.)

2. Die erweiterte Einstellung Drill Downs wird in der Wurzel-API-Aufrufregel konfiguriert. Diese Einstellung verknüpft die relevanten Unterregeln, die die verschachtelten Daten verarbeiten.

3. Binding verbindet Daten zwischen der Wurzel- und den Unterregeln. Dies beinhaltet typischerweise die Verwendung eines gemeinsamen Identifikators (wie CustomerID), um verschachtelte Elemente (Adressen) mit ihrer übergeordneten Entität (dem Kunden) zu verknüpfen.

Dieser modulare Ansatz ermöglicht es dem App Builder, Daten von APIs effektiv zu verarbeiten und darzustellen, die komplexe, mehrstufige JSON-Objekte und -Arrays zurückgeben. Der Prozess ist in zwei separate Schritte entkoppelt:

1. Eine API-Aufrufaktion (die die Konfiguration der API-Aufrufregeln verwendet) wird zu einem Ereignis hinzugefügt. Ihre einzige Verantwortung besteht darin, die API-Anfrage zu erstellen und zu senden, wobei alle notwendigen Parameter definiert werden.

2. Unmittelbar nach der API-Aufrufaktion im selben Ereignis wird eine standardmäßige XP CRUD Aktion ausgeführt. Diese nachfolgende Aktion verarbeitet dann die Daten, die vom vorhergehenden API-Aufruf zurückgegeben werden, und führt Operationen wie CRAM oder UPDATE durch.

Diese Trennung verbessert die Flexibilität und ermöglicht es Ihnen, genau zu steuern, wann der API-Aufruf erfolgt und wie seine Ergebnisse von nachfolgender Geschäftslogik und Datenoperationen innerhalb der App Builder-Ereignisse behandelt werden.

Geschäftobjekt

Eine beliebige Anzahl von Regel-Ereignissen oder Unterabfragen, die hauptsächlich zum Erstellen der UI-Schicht einer App verwendet werden. Quelle und Liste sind zwei gängige Beispiele für Geschäftsobjekte:

• Quelle: Zeigt alle Zeilen und Spalten aus einer Tabelle in der Datenschicht an. Referenziert eine Tabelle und sollte keine Filter enthalten. Quellobjekte werden häufig verwendet, wenn Sie einen Ausdruck oder eine Funktion auf den zugrunde liegenden Daten erstellen müssen, um diese in der UI-Schicht der Anwendung darzustellen.

• Liste: Übersetzt den Wert des Primärschlüssels ID in einen benutzerfreundlichen Titelspaltenwert. Listenobjekte können verwendet werden, wenn Sie Daten anzeigen möchten, die dem Endbenutzer möglicherweise nicht in der Tabelle zur Verfügung stehen. Listenobjekte präsentieren häufig Informationen in Form eines Dropdown-Menüs, aus dem der Benutzer auswählen kann.

Kalender

Geschäftslogik für einen Kalender in der UI-Schicht. Attribute werden auf Regel-Ebene über die folgenden Verwendungstyp-Werte definiert:

• Farbe
• Beschreibung
• Ende
• Sortierung
• Start

Diagramm

Geschäftslogik für ein Diagramm in der UI-Schicht. Attribute werden auf Regel-Ebene über die folgenden Verwendungstyp-Werte definiert:

• Kategorie
• Farbe
• Flagge
• JSON-Optionsobjekt
• Sortierung
• Wert

CRUD

Daten aktualisieren, löschen oder einfügen. Die ausgewählte Aktion definiert, wie die Regel die Zieltabellenaufzeichnungen beeinflusst.

CRUD-Regeln werden in der Geschäftsschicht ausgeführt und bewirken, dass alle Aktionen und Validierungen auf der Tabelle oder dem Objekt, das Sie ändern, ausgeführt werden. (Verwenden Sie eine XP CRUD-Regel, wenn Sie CRUD zwischen zwei verschiedenen Datenquellen verwenden möchten.)

Standard

Verwenden Sie eine Standardregel, um die Benutzererfahrung zu verbessern, indem Sie Standardwerte in Feldern in den Daten-, Geschäfts- oder UI-Schichten festlegen. Ein häufiges Beispiel ist das Voreinstellen eines Datumsfeldes für einen neuen Datensatz auf das heutige Datum.

Gantt

Geschäftslogik für ein Gantt-Diagramm in der UI-Schicht. Attribute werden auf Regel-Ebene über die folgenden Verwendungstyp-Werte definiert:

• Farbe
• Abhängigkeit
• Ende
• JSON-Optionsobjekt
• Übergeordnete Aufgabe
• Sortieren
• Start
• Aufgabe
• Aufgabengruppe

Liste

Füllen Sie ausgewählte Listen in der UI-Schicht. Listenregeln haben keine zugehörigen Aktionen oder Validierungen. Attribute werden auf Regel-Ebene über die folgenden Verwendungstyp-Werte definiert:

• Schlüssel
• Titel
• Untertitel

Karte

Geschäftslogik für eine Karte in der UI-Schicht. Attribute werden auf Regel-Ebene über die folgenden Verwendungstyp-Werte definiert:

• Kategorie
• Farbe
• JSON-Optionsobjekt
• Wert

Migration

Eine Migrationsregel wird ausgeführt, wenn ein Release auf einem neuen Server installiert wird. Ihr Hauptzweck besteht darin, Apps von der Entwicklung in die QA und von der QA in Produktionsumgebungen zu verschieben. Regeln werden zu den Schritten des Änderungsmanagements hinzugefügt, die beim Veröffentlichen eines LP in einer neuen Umgebung ausgeführt werden. Wenn eine Migrationsregel ausgeführt wird, erstellt der App Builder einen Snapshot der Regel und bettet ihn in das Änderungsset ein. Die Migrationsregel wird nach der Ausführung gelöscht.

Netzwerkdiagramm

Geschäftslogik für ein Netzwerkdiagramm in der UI-Schicht.

Benachrichtigung

Senden Sie eine Nachricht an einen Benutzer. Nachrichten können per Email, Push-Benachrichtigungen, SMS (Textnachrichten) oder in-App App Builder-Alerts gesendet werden. Benachrichtigungen unterstützen Dateianhänge beliebigen Dateityps.

Pivot

Zeigen Sie eine Pivot-Tabelle (flachgestellter Datensatz) an. Pivot-Regeln fassen verwandte Daten zusammen, die sich über mehrere Zeilen erstrecken, und präsentieren sie in einer einzigen Zeile. Diese Ausgabe hilft, nützliche Informationen hervorzuheben.

Reichweite

Verwenden Sie eine Reichweitenregel, um den Zugriff eines Benutzers auf Daten auf Seiten einzuschränken, ohne den Zugriff auf die Seiten selbst einzuschränken.

Bericht

Verwenden Sie dies, um Geschäftslogik ohne zugehörige Ereignisse zu konfigurieren. Dieser Regeltyp ist für unterschiedliche Berichtanforderungen in der UI-Schicht gedacht (zum Beispiel für ein Diagramm, ein Rasterpanel oder ein Pivot).

Unterabfrage

Unterabfrage-Regeln sind Regeln, die innerhalb anderer Geschäftsregeln existieren können. Unterabfragen sind für sich genommen nicht in der Anwendung UI-Schicht sichtbar und unterstützen keine Geschäftslogikereignisse. Sie werden typischerweise verwendet, um Daten anzupassen, komplexere Logik auszuführen oder Berechnungen auf Daten durchzuführen.

Validierung

Validierungsregeln schützen die Datenintegrität. Zum Beispiel können Sie sie verwenden, um Geschäftslogik bei manueller Eingabe durchzusetzen. Wenn eine CRUD-Regel definiert ist, werden Validierungen auch ausgeführt, wenn diese CRUD-Regel ausgeführt wird. Die Validierungsnachrichten, die den Benutzern angezeigt werden, sind konfigurierbar und können dynamische Ersetzungen verwenden, um die Benutzererfahrung zu verbessern.

Sichtbarkeit

Bestimmen Sie den Zustand eines Steuerelements in der UI-Schicht: welche Steuerelemente verborgen, obligatorisch oder zur Bearbeitung verfügbar sind. Sichtbarkeitsregeln vereinfachen das Seitendesign und verbessern die Benutzererfahrung. (Diese Regel kann nur für ein Formularpanel konfiguriert werden.)

Webhook

Ermöglicht es einem separaten System, ein benutzerdefiniertes App Builder Callback-Ereignis auszulösen. Ein Webhook ist ein benutzerdefiniertes HTTP-Callback, das typischerweise durch ein Ereignis ausgelöst wird. Wenn ein Webhook in Form einer Email oder Textnachricht verwendet wird, reagiert App Builder entsprechend auf die Benutzerantwort, indem das angegebene Ereignis ausgelöst wird.

XP CRUD

Führen Sie eine CRUD-Regel über Datenquellen aus. XP-Typregeln sind so konzipiert, dass Logik über verschiedene Datenquellen hinweg ausgeführt werden kann.

XP validation

Führen Sie eine Validierungsregel über Datenquellen aus. XP-Typregeln sind so konzipiert, dass Logik über verschiedene Datenquellen hinweg ausgeführt werden kann.

Additional settings

Wenn Sie eine Regel Zweck auswählen, werden eine oder mehrere der folgenden zusätzlichen Einstellungen angezeigt.

Action

Die Aktionsoptionen sind wie folgt:

• Cram: Ähnlich wie Einfügen, schlägt jedoch nicht fehl, wenn ein Primärschlüssel bereits vorhanden ist. Ein neuer Datensatz wird nur erstellt, wenn der PK nicht bereits in der Datenquelle vorhanden ist. Duplikat-Schlüssel-Datensätze werden übersprungen.
• Delete: Löschen Sie einen vorhandenen Datensatz in der Zieltabelle.
• Insert: Erstellen Sie einen neuen Datensatz in der Zieltabelle.
• Update: Ändern Sie einen vorhandenen Datensatz in der Zieltabelle.

Chart Type

Für den Diagramm Regelzweck stehen die folgenden Diagrammtypen zur Verfügung:

• 3D Balken
• 3D Säule
• 3D Donut
• 3D Kreis
• Fläche
• Balken
• Blase
• Säule
• Trichter
• Linie
• Marimekko
• Gemischt
• Prozentuale Fläche
• Kreis
• Pyramide
• Halbkreis-Donut
• Spline
• Gestapelte Fläche
• Gestapelter Balken
• Gestapelte Säule

Delivery Method

Die Zustellmethoden für eine Benachrichtigung Regel sind wie folgt:

• App Builder Warnung
• Email
• Push-Benachrichtigung
• Textnachricht

Source Data Source

Die Datenquelle, die die Regel auslöst.

Ziel-Datenquelle

Die Ziel-Datenquelle ist die Datenquelle, in der sich das Ziel befindet.

Ziel

Das Ziel ist das, was von der Regel betroffen ist.

Ziel-Ebene

Die Optionen für die Ziel-Ebene sind wie folgt:

• Datenebene: Wählen Sie aus, um ein Ziel auf der Datenebene auszuwählen.
• Logikebene: Wählen Sie aus, um ein Ziel auf der Logikebene auszuwählen.