Bindungsformeln in On-Demand-Vorlage-Apps

Datenbindungen in einer Vorlagen-App geben an, welche Daten aus einer entsprechenden Auswahl-App zur Formulierung der Abfragen verwendet werden, die beim Laden von Daten in eine On-Demand-App ausgegeben werden.

Die Grundform von Bindungsformeln ($(odag_FIELDNAME)) ist nicht die einzige verfügbare Methode zum Binden von Formeln. Es können auch andere Zusätze verwendet werden, um die Auswahl zu verfeinern und sicherzustellen, dass die Vorlage-App die Daten korrekt lädt.

Verfügbare Bindungszusätze

Die allgemeine Zusatzform lautet odag[s|o][n][cnt], wobei gilt:

• s - nur ausgewählte Werte einschließen
• o - nur optionale Werte einschließen
• n - die numerische Version auswählen, standardmäßig ohne Anführungszeichen
• cnt - die Anzahl der Werte anstelle von tatsächlichen Werten einfügen

Die folgende Tabelle enthält eine Liste aller Versionen der verfügbaren Bindungszusätze. Die Beispiele gehen von einem Feld mit dem Namen MyField mit 1,2,3 als ausgewählten Werten (grüne Werte) und 4 als optional ausgewähltem Wert (weißer Wert) aus.

Optimierung für große Datenbanken

Die Zusätze odags_ und odagsn_ sind für die Abfrageoptimierung vorgesehen. Wenn in den gebundenen Feldern keine Auswahlen vorhanden sind, schließt odag_ alle Werte ein, während odags_ keine Werte einschließt. In einigen Fällen ist es effizienter, die Zusätze odags_ und odagscnt_ zu verwenden. Damit können Sie testen, ob der Wertesatz leer ist. Beispielsweise ist Folgendes effizienter, wenn in MyField keine Auswahlen getroffen wurden, anstatt alle Werte in odag_MyField zu testen:

odags_ kann nicht verwendet werden, wenn in der Auswahl-App ein alternatives Feld vorhanden ist, aus dem ausgewählt werden kann und das kein On-Demand-Feld ist. Wenn der Benutzer zum Beispiel Auswahlen in CountryName trifft, aber die Bindungsformel im zugeordneten Feld CountryCode vorhanden ist, kann odags_ nicht verwendet werden. In diesen Fällen kann stattdessen odago_ verwendet werden. Wenn keine Werte in einer odago_-Bindung vorhanden sind, kann dies entweder bedeuten, dass alle Werte oder dass keine Werte eingeschlossen werden sollen.

Bindung numerischer Werte

Wenn die an die On-Demand-App gebundenen Daten aus Nummern anstatt Strings bestehen, ist es hilfreich, die Anführungszeichensetzung für numerische Werte zu deaktivieren. Beispiel: Wenn die Verkaufsdatensätze eine numerische DAY_OF_WEEK-Spalte enthalten und Sie möchten, dass der Benutzer der Auswahl-App beliebige Kombinationen von DAY_OF_WEEK auswählen kann, erweitern Sie die Aggregierungsabfrage, die für das Laden der Auswahl-App verwendet wird, sodass DAY_OF_WEEK sowohl in der Liste SELECT als auch in der Liste GROUP BY enthalten ist. Wenn DAY_OF_WEEK-Werte bei der Auswahl in Anführungszeichen gesetzt werden, könnte ein Laufzeitfehler auftreten, falls die Datenbank keine automatische Umwandlung von Stringwerten in numerische Werte unterstützt.

Um dieses Problem zu lösen, können Sie eine numerische Version des Suffixes für die Bindungsformel verwenden. Dadurch wird erzwungen, dass die Feldbindung die numerischen Werte aus der Auswahl-App statt der Stringwerte verwendet. Folgende numerische Versionen sind vorhanden:

• odagn_
• odagon_
• odagsn_

Wenn Sie numerische Versionen verwenden, werden die Werte aus dem numerischen Teil der dualen Werte übernommen, in denen ausgewählte Werte gespeichert sind, und die Werte umfassen standardmäßig keine Anführungszeichen.

Anforderung für eine bestimmte Anzahl von Auswahlen

In manchen Situationen kann die Anforderung notwendig sein, dass die On-Demand-App-Abfrage eine bestimmte Anzahl oder einen bestimmten Bereich von Werten für ein bestimmtes Feld enthält. Beispiel: Wenn die Abfrage der On-Demand-App eine BETWEEN-Bedingung enthält, mit der alle Verkäufe zwischen einem Start- und Enddatum abgerufen werden, kann die Bindungsformel für das Feld YEARQUARTER eine Suffix-Syntax von [2] haben, die erfordert, dass genau zwei Werte für YEARQUARTER ausgewählt werden, also:

Der Navigationspunkt für On-Demand-Apps in der Auswahl-App bleibt solange deaktiviert, bis genau zwei Werte von YEARQUARTER ausgewählt sind. Eine Nachricht wird angezeigt, die darauf hinweist, dass genau zwei Werte von YEARQUARTER ausgewählt werden müssen.

Durch die Beschränkungen der Auswahlmenge wird eine vorausgesetzte Bindung zwischen der Auswahl-App und der On-Demand-App erstellt. Das ist anders als bei Bindungsformeln, die keine Mengenbeschränkungen verwenden. Beispiel: Wenn das Skript der Vorlage-App eine Bindungsformel ohne eine Mengenbeschränkung enthält, wie in:

ist es nicht erforderlich, dass die Auswahl-App ein Feld mit dem Namen MYFIELD enthält oder dass ausgewählte Werte aus diesem Feld enthalten sein müssen, wenn das Feld nicht existiert. Wenn die Auswahl-App kein Feld mit dem Namen MYFIELD enthält oder der Benutzer keine Auswahl in diesem Feld vornimmt, kann es dazu kommen, dass der Navigationspunkt für On-Demand-Apps aktiviert wird, wenn andere Optionen ausgewählt werden, um die Bedingung für Werte mit einem Datensatzgrenzwert zu erfüllen.

Wenn die Bindungsformel andererseits wie folgt lautet:

sind jetzt zwei Anforderungen vorhanden, die für die Auswahl-App gelten:

• Die Auswahl-App muss ein Feld mit dem Namen MYFIELD enthalten.
• Der Benutzer muss mindestens einen Wert für MYFIELD auswählen.

Diese Art von Bindungsformel muss mit Vorsicht verwendet werden, weil dadurch eingeschränkt wird, welche Auswahl-Apps mit der Vorlage-App verwendet werden können. Sie sollten diese Mengenbeschränkung nicht für Bindungen einer Vorlage-App verwenden, es sei denn, Sie sind sicher, dass Sie diese Auswahlmengenanforderung bei allen Auswahl-Apps anwenden möchten, die mit dieser Vorlage-App verknüpft sind.

Zur Durchführung des Datenbindungsvorgangs nutzt der On-Demand-App-Dienst ein Verfahren zum Ersetzen von Zeichenfolgen, das Kommentare im Skript nicht berücksichtigt. Das bedeutet, Sie sollten keine Bindungsformeln in Kommentaren verwenden, es sei denn, diese Kommentare sollen die Liste der gebundenen Werte enthalten, die auf die App-Generierung folgen.

Andere Mengenbeschränkungen sind möglich. In der folgenden Tabelle werden die verschiedenen Kombinationen von Beschränkungen der Auswahlmenge zusammengefasst.

Ändern der Anführungszeichen und der Trennzeichen für Werte

Wenn eine Liste mit Werten, die aus einem Feld in einer Auswahl-App ausgewählt wurden, in ein Skript einer Vorlage-App eingefügt wird, sind die Werte von einfachen Anführungszeichen umgeben und durch Kommas getrennt. Dies sind die standardmäßig verwendeten Anführungs- und Trennzeichen. Diese Werte können in der Syntax, die an die Bindungsanweisung für jedes Feld angehängt ist, geändert werden. Hier ein Beispiel:

Diese neuen Werte werden dann verwendet, wenn die Liste der Bindungswerte, die aus der Auswahl-App entnommen werden, zusammengestellt wird. Wenn es sich beispielsweise bei den ausgewählten Werten um die ersten drei Monate des Jahres handelt, wird die Liste wie folgt erstellt:

Die Standardwerte für Anführungs- und Trennzeichen können für die meisten standardmäßigen SQL-Datenbanken verwendet werden. Für einige SQL-Datenbanken können sie aber möglicherweise nicht genutzt werden, und für viele dynamische Datenquellen wie NoSQL und REST sind sie ebenfalls nicht einsetzbar. Bei derartigen Datenquellen müssen Sie diese Bindungsformel anhängen, um die Anführungs- und Trennzeichen zu ändern.

Die folgende Tabelle enthält Formatparameter zum Ändern von Anführungszeichen und Trennzeichen.

Die folgenden Tabellen enthalten die Formatspezifikationen und generierten Werte für odag_ und odagn_. Die generierten eingefügten Werte basieren auf den Standarddatenwerten von VAL1, VAL2.

Verarbeitung einzelner Werte

Wenn die individuelle Verarbeitung von Feldwerten erforderlich ist, können Sie eine Inline-Methode verwenden, um Werte in der Variablen Values zu generieren und zufällige Verarbeitung mit Replace oder einer anderen Funktion durchzuführen. Im Beispiel unten wird Replace mit Platzhalterwerten verwendet.