Zum Inhalt springen

Gemeinsame Kriterien im Jitterbit App Builder

Übersicht

Verbindliche Kriterien werden verwendet, um an App Builder Seitenlink, der Schlüssel enthält, die die Daten auf der Zielseite filtern. Beispielsweise würde ein Link von einer Kategorienseite zu einer Produktseite dem Benutzer Produkte anzeigen, bei denen ProductCategoryId= ProductId. Shared Criteria bietet die Möglichkeit, diese übergebenen Variablen über die WHERE-Klausel hinaus auf weitere Weise zu nutzen.

So verwenden Sie gemeinsame Kriterienwerte

Klauseln auswählen

Die Funktion Shared Criteria greift auf die Werte im aktuellen Kontext zu. Sie können wie jede SQL-Funktion verwendet werden. Wenn Sie eine Spalte in ein beliebiges Datenobjekt aufnehmen, wird der Wert dort als Zeichenfolge platziert. Durch Auswahl eines Shared Criteria-Werts kann dieser auch in nachfolgenden Panels verwendet werden. Er wird zu echten Daten in Ihrem Datenobjekt und kann verknüpft, von Steuerelementen verwendet usw. werden.

Beispiel: shared('EmployeeID')

WHERE-Klauseln

WHERE-Klauseln können diese Shared Criteria-Funktion enthalten. Wenn Sie die Regel außerhalb des Kontexts Ihrer Seite ausführen (beispielsweise durch Anzeigen von Ergebnissen), erwarten Sie, dass die Shared-Funktion den Standardwert „nicht gefunden“ für den angegebenen Datentyp zurückgibt.

Beispiel: Where E.EmployeeID = shared('EmployeeID')

CRUD

CRUD-Regeln können mit Shared Criteria ausgeführt werden. Einfügen oder Aktualisieren mit diesem Wert in den WHERE- oder SELECT-Klauseln.

Hintergrundereignisse

Von Benutzern ausgeführte Ereignisse, die im Hintergrund laufen, können Shared Criteria enthalten.

Bedingte Formatierung

Bei der bedingten Formatierung können gemeinsame Kriterien genutzt werden, die an das Panel weitergegeben werden.

Dynamische Substitution

Zellendaten und Kontrollbeschriftungen können auf Shared Criteria zugreifen. Fügen Sie beispielsweise „Willkommen bei {{Firmenname}}" in einer Datenobjektzelle oder dasselbe in einer Steuerelementbeschriftung.

Hinweis

Wenn Sie Mobilfunkdaten verwenden, aktivieren Sie unbedingt Substitution unterstützen auf der App Builder Kontrolle.

Laufen ohne gemeinsame Kriterien

Wenn Sie die Funktion Shared Criteria verwenden, wird das Datenobjekt trotzdem ausgeführt, wenn die Seite oder URL kein passendes Kriterium enthält. Sie müssen jedoch sicherstellen, dass Ihre WHERE-Klausel oder SELECT-Klausel auch dann noch funktioniert, wenn die Funktion eine leere Zeichenfolge zurückgibt.

Standardwert beim Einfügen

Wenn Sie auf eine Seite mit gemeinsamen Kriterien verlinken, wird der gemeinsame Wert für alle eingefügten Zeilen automatisch in Spalten mit demselben Namen übernommen.

Standardwert beim Bearbeiten

Wenn Sie eine Verknüpfung zu einer Seite mit gemeinsamen Kriterien herstellen und in den Bearbeitungsstatus wechseln, werden die gemeinsamen Kriterien standardmäßig auf alle Nullspalten mit demselben Namen gesetzt.

SQL- Laufzeit : Shared

In SQL greifen Sie über die Funktion Shared auf gemeinsame Kriterien zu. Beispiel:

SELECT CustomerId, shared('ActiveEmployeeId') as ActiveEmployeeId FROM Customer WHERE CustomerRegionId <> shared('LastRegion', 'UUID')

Die Funktion gibt den gemeinsamen Wert als Zeichenfolge zurück. Die Funktion hat zwei Parameter:

  • Name: der Name des nachzuschlagenden Kriteriums
  • Datentyp: Wenn das gemeinsame Kriterium nicht gefunden wird, kann der Rückgabetyp als UUID oder numerisch angegeben werden. Wenn festgelegt, App Builder gibt '00000000-0000-0000-0000-0000-00000000000' für eine UUID oder '0' für eine Zahl zurück. Andernfalls schlägt das resultierende SQL fehl, wenn eine UUID mit einer leeren Zeichenfolge verglichen wird.

Gemeinsame Kriterien können auf Panel- oder Feldebene angegeben werden.

Gemeinsame Kriterien sind nur für Seitenlinks verfügbar. Dies sind Links, die die URL ändern und eine neue Seite öffnen. Die Zielseite stellt diese gemeinsamen Werte allen „Root“-Panels (Panels, die nicht an andere Panels gebunden sind) zur Verfügung. Sofern Sie die Funktion „Gemeinsam“ nicht verwenden, werden die Zielpanels nicht automatisch gefiltert.