Gemeinsame Kriterien im Jitterbit App Builder

Übersicht

Gemeinsame Kriterien ermöglichen die Nutzung von Variablen, die über verknüpfte Seiten übergeben werden. Diese Variablen werden typischerweise bei der Verwendung von Bindungskriterien übergeben, wodurch ein App Builder Seitenlink Schlüssel enthalten kann, die Daten auf der Zielseite filtern (beispielsweise würde ein solcher Link von einer Kategorien-Seite zu einer Produkt-Seite so filtern, dass für die gewählte Kategorie relevante Produkte angezeigt werden). Die gemeinsamen Kriterien erweitern jedoch die Verwendung der Variablen über WHERE-Klauseln hinaus.

URLs für freigegebene Kriterien

Eine mit gemeinsamen Kriterien erstellte URL sieht ähnlich wie dieses Beispiel aus:

https://example.dev.zudy.host/app/App%20Name/Page%20Name?FieldName~Shared=2032

So verwenden Sie gemeinsame Kriterienwerte

Klauseln auswählen

Die Funktion Shared Criteria greift auf die Werte im aktuellen Kontext zu. Sie kann wie jede SQL-Funktion verwendet werden. Wenn Sie eine Spalte in ein Datenobjekt einfügen, wird der Wert dort als Zeichenfolge abgelegt. 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 usw. verwendet werden.

Beispiel: shared('EmployeeID')

WHERE-Klauseln

WHERE-Klauseln können diese Funktion für gemeinsame Kriterien enthalten. Wenn Sie die Regel außerhalb des Kontexts Ihrer Seite ausführen (z. B. durch Anzeigen von Ergebnissen), gibt die Funktion für gemeinsame Kriterien den Standardwert „Nicht gefunden“ für den angegebenen Datentyp zurück.

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

CRUD

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

Hintergrundereignisse

Benutzergeführte Ereignisse, die im Hintergrund ausgeführt werden, können Gemeinsame Kriterien enthalten.

Bedingte Formatierung

Die bedingte Formatierung kann die an das Panel übermittelten gemeinsamen Kriterien nutzen.

Dynamische Substitution

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

Laufen ohne gemeinsame Kriterien

Wenn Sie die Funktion „Gemeinsame Kriterien“ verwenden, wird das Datenobjekt auch dann ausgeführt, wenn die Seite oder URL kein übereinstimmendes Kriterium enthält. Stellen Sie jedoch sicher, dass Ihre WHERE- oder SELECT-Klausel auch dann funktioniert, wenn die Funktion einen leeren String 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 Seite mit gemeinsamen Kriterien verknüpfen und in den Bearbeitungsmodus wechseln, werden die gemeinsamen Kriterien standardmäßig auf alle leeren Spalten mit demselben Namen angewendet.

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 Shared-Wert als Zeichenfolge zurück. Die Funktion verfügt über zwei Parameter:

• Name: der Name des nachzuschlagenden Kriteriums
• Datentyp: Wenn das freigegebene Kriterium nicht gefunden wird, kann der Rückgabetyp als UUID oder numerisch angegeben werden. Wenn diese Option aktiviert ist, gibt App Builder für eine UUID „00000000-0000-0000-0000-00000000000“ oder für eine Zahl „0“ zurück. Andernfalls schlägt das resultierende SQL beim Vergleich einer UUID mit einer leeren Zeichenfolge fehl.

So legen Sie fest, welche Werte über einen Seitenlink freigegeben werden sollen

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 Stamm-Panels (Panels, die nicht an andere Panels gebunden sind) zur Verfügung. Ohne die Funktion „Gemeinsam“ werden die Ziel-Panels nicht automatisch gefiltert.