Standardregeln in Jitterbit App Builder

Standardregeln sind eine Regel mit dem Zweck, um automatisch ein oder mehrere Felder mit einem Wert zu füllen. Eine Standardregel kann beispielsweise ein Datums-Feld auf das heutige Datum setzen oder ein Preis-Feld basierend auf einem Wert aus einer verknüpften Tabelle festlegen.

Ein vollständiges Beispiel mit Demowerten zum Erstellen einer Standardregel und deren Registrierung auf einem Panel finden Sie im Abschnitt Standardregeln unter Einführung in App Builder - Lektion 7: Mehr über Regeln.

Standardregel erstellen

1. Klicken Sie in App Workbench > Regeln auf + Regel. Der Rule Builder wird geöffnet.

2. Geben Sie nach den Namenskonventionen von App Builder einen Namen für die Regel ein und verwenden Sie das Muster TableName (Default ColumnName).

3. Scrollen Sie im Feld Zweck nach unten, um die Option Standard unter Edge Case zu finden, und wählen Sie diese aus.

   

4. Wählen Sie im Feld Ziel die Tabelle oder das Geschäftsobjekt aus, auf das die Standardwerte angewendet werden sollen. Siehe Tabelle oder Geschäftsobjekt als Ziel festlegen unten, um zu entscheiden, welches verwendet werden soll.

5. Klicken Sie auf Erstellen. App Builder benötigt einen Moment, um die Regel zu erstellen.

6. Fügen Sie auf der Registerkarte Spalten die Logik hinzu, die den Standardwert für jede Spalte bestimmt, die standardisiert werden soll. Sie können beispielsweise auf + Spalte klicken und den Ausdruck Now() eingeben, um ein Datumsfeld auf das aktuelle Datum und die aktuelle Uhrzeit zu setzen, indem Sie die Now()-Datenbankfunktion verwenden, oder eine verknüpfte Tabelle auf der Registerkarte Tabellen hinzufügen und eine ihrer Spalten auswählen, um einen Wert daraus nachzuschlagen.

7. Klicken Sie im Regel-Panel auf Ergebnisse, um zu bestätigen, dass die Regel den erwarteten Wert zurückgibt.

Tabelle oder Geschäftsobjekt als Ziel festlegen

Eine Standardregel muss entweder ihre Basistabelle oder ein auf dieser Tabelle aufgebautes Geschäftsobjekt als Ziel haben. Diese Wahl bestimmt ihr Verhalten:

• Wenn das Ziel eine Tabelle ist: Eine Standardregel, die eine Tabelle als Ziel hat, kann nur physische Spalten standardisieren, keine berechneten Spalten, aber sie gilt für jedes auf dieser Tabelle aufgebaute Geschäftsobjekt. Eine Standardregel, die die Tabelle Order als Ziel hat, könnte beispielsweise Quantity auf 1 und Price auf 5 standardisieren. Wenn ein auf Order aufgebautes Geschäftsobjekt eine berechnete Spalte wie LineTotal (Quantity*Price) hat, zeigt diese Spalte NULL an, bis der Datensatz gespeichert wird, da die Datenbank sie erst berechnet, nachdem die standardisierten Werte geschrieben wurden.

• Wenn das Ziel ein Geschäftsobjekt ist: Eine Standardregel, die ein Geschäftsobjekt wie Order (Source) als Ziel hat, kann sowohl physische Spalten als auch im Speicher berechnete Spalten standardisieren, und ihre berechneten Werte werden live in der Benutzeroberfläche neu berechnet, wenn der Benutzer verknüpfte Felder ändert, sogar bevor der Datensatz gespeichert wird. Wenn beispielsweise Quantity auf 1 standardisiert wird, Price auf 5 standardisiert wird und eine berechnete Spalte LineTotal (Quantity*Price) zusammen mit ihnen standardisiert wird, zeigt LineTotal anfangs 5 an. Wenn Quantity vor dem Speichern auf 2 geändert wird, wird LineTotal sofort auf 10 neu berechnet. Nach dem Speichern wird LineTotal bei erneuter Änderung von Quantity auf 3 auf 15 neu berechnet.

Eine Standardregel registrieren

Eine Standardregel hat keine Auswirkung, bis man sie registriert – entweder in der Tabelle, auf die sie abzielt, oder in einem Panel, das auf dem Geschäftsobjekt basiert, auf das sie abzielt.

In einer Tabelle

Das Registrieren einer Standardregel in ihrer Tabelle wendet sie auf jedes Geschäftsobjekt an, das auf dieser Tabelle basiert:

1. Navigieren Sie zu App Workbench > Tabellen, suchen Sie die Tabelle und wählen Sie sie aus.

2. Klicken Sie auf Mehr > Standards. Das Dialogfeld Standards wird geöffnet.

3. Klicken Sie auf Registrieren. Das Dialogfeld Standard wird geöffnet.

4. Wählen Sie im Feld Typ die Option Regel aus.

5. Wählen Sie im Feld Regel die Standardregel aus, die Sie erstellt haben.

6. Wählen Sie im Feld Bindung einen Bindungstyp aus. Weitere Informationen finden Sie unter Bindung weiter unten.

7. Klicken Sie auf Speichern.

In einem Panel

Das Registrieren einer Standardregel in einem Panel wendet sie nur innerhalb dieses Panels an:

1. Navigieren Sie auf eine der folgenden Weisen zum Panel, in dem Sie die Regel registrieren möchten:

   • Navigieren Sie in der App-Vorschau zur Seite mit dem Panel und öffnen Sie den Live Designer, indem Sie auf das Symbol Hamburger-Menü oben rechts klicken und Live Designer auswählen.

   • Öffnen Sie in der App Workbench die Registerkarte „Seiten" und wählen Sie die Seite mit dem Panel aus.

2. Wenn Sie sich im Live Designer befinden, wählen Sie das Panel in der Vorschau aus, um den Designer mit seinen Optionen zu füllen, und klicken Sie dann auf Mehr > Standards. Wenn Sie sich in der App Workbench befinden, wählen Sie das Panel in Seiten-Panel-Layout aus und klicken Sie dann auf Mehr > Standards. Das Dialogfeld Standards wird geöffnet:

   

3. Klicken Sie auf Registrieren. Das Dialogfeld Standard wird geöffnet:

   

4. Wählen Sie im Feld Typ die Option Regel aus.

5. Wählen Sie im Feld Regel die Standardregel aus, die Sie erstellt haben.

6. Wählen Sie im Feld Bindung einen Bindungstyp aus. Weitere Informationen finden Sie unter Bindung weiter unten.

7. (Optional) Geben Sie im Feld Reihenfolge eine Zahl ein, um festzulegen, in welcher Reihenfolge die Regel ausgeführt wird, wenn das Panel mehr als eine Regel registriert hat. Wenn das Panel nur eine Regel hat, ist der Standardwert 10.

8. Lassen Sie das Kontrollkästchen Aktiv aktiviert, um die Regel durchzusetzen. Wenn Sie die Regel deaktivieren möchten, ohne sie zu löschen, deaktivieren Sie dieses Kontrollkästchen.

9. Klicken Sie auf Speichern.

Aktualisieren Sie die Seite. Um zu testen, ob die Standardregel funktioniert, erstellen Sie einen neuen Datensatz in dieser Tabelle oder diesem Panel. Das Feld sollte sich automatisch ausfüllen.

Bindung

Die Bindung einer Standardregel bestimmt, welche Daten eines vorhandenen Datensatzes zur Berechnung des Standardwerts verwendet werden:

• Implizite Bindung verwendet den Primärschlüssel des In-Memory-Datensatzes, sodass sie immer genau einen Datensatz abgleicht.

• Explizite Bindung gleicht eine Spalte ab, die nicht der Primärschlüssel ist, z. B. ein Fremdschlüssel. Sie könnten beispielsweise einen Freight-Standard explizit an die ausgewählte ShipperID in einem Order-Panel binden, sodass Freight basierend auf dem vom Benutzer ausgewählten Versender standardmäßig festgelegt wird.

Weitere Informationen finden Sie unter Implizite und explizite Bindung.

Zeitpunkt der Ausführung von Standardregeln

• Bei einem New-Ereignis (wenn ein Datensatz erstmals erstellt wird) führt App Builder die vollständige Standardlogik aus, bevor der Datensatz in die Datenbank eingefügt wird, und initialisiert physische Spalten für jede Standardregel und berechnete Spalten für Regeln, die auf ein Geschäftsobjekt abzielen.

• Bei einem Update-Ereignis (wenn ein vorhandener Datensatz bearbeitet wird), wendet App Builder die anfänglichen Spaltenwerte einer Default-Regel nicht erneut an, sodass ein Wert, den der Benutzer bereits geändert hat, nicht überschrieben wird. Berechnete Spalten aus Defaults, die auf ein Geschäftsobjekt abzielen, werden jedoch neu berechnet, wenn sich ein Feld, von dem sie abhängen, ändert – sowohl vor als auch nach dem ersten Speichern des Datensatzes. Explizit gebundene Defaults verhalten sich gleich: Sie werden erneut ausgeführt, wenn sich ihr gebundenes Feld ändert, unabhängig davon, ob der Datensatz bereits gespeichert wurde.