LISTOFFIELDS EB-Funktion

Die Funktion LISTOFFIELDS gibt den Wert Datensatzliste zurück, der basierend auf der Struktur des angegebenen Arguments des Typs Enumeration oder Container (Datensatz) erstellt wird.

Syntax 1

LISTOFFIELDS (path)

Syntax 2

LISTOFFIELDS (path, language)

Argumente

path: Referenz der Datenquelle

Der gültige Referenzpfad einer Datenquelle einer der folgenden Datentypen:

• Modellenumeration
• Formatenumeration
• Anwendungsaufzählung
• Container (Datensatz)

language: Zeichenfolge

Text, der einen Sprachcode darstellt.

Rückgabewerte

Datensatzliste

Die resultierende Liste der Datensätze.

Anwendungshinweise

Die Liste, die erstellt wird, besteht aus Datensätzen, die die folgenden Felder haben:

• Name (Datentyp String)
• Bezeichnung (Datentyp String)
• Beschreibung (Datentyp String)
• IsTranslated (Datentyp Boolesch)

Wenn das Argument path sich auf eine Datenquelle des Typs Container (Datensatz) bezieht, geben Sie für jedes Feld des referenzierten Datensatzes, auf den verwiesen wird, einen neuen Datensatz in die Liste ein, die erstellt wird. Für jeden erstellten Datensatz gibt das Feld Name den Namen des Felds des referenzierten Containerdatensatzes zurück, für den der aktuelle Datensatz erstellt wurde.

Wenn das Argument path sich auf eine Datenquelle einer der Typen Enumeration bezieht, geben Sie für jeden Enumerationswert der referenzierten Enumeration, auf die verwiesen wird, einen neuen Datensatz in die Liste ein, die erstellt wird. Für jeden erstellten Datensatz gibt das Feld Name den Wert der referenzierten Enumeration zurück, für die der aktuelle Datensatz erstellt wurde, das Feld Beschreibung gibt die Beschreibung dieser Enumeration zurück, und das Feld Bezeichnung gibt die Bezeichnung dieser Enumeration zurück.

Wenn zur Laufzeit die Syntax 1 verwendet wird, müssen die Felder Bezeichnung und Beschreibung Werte zurückgeben, die auf den Spracheinstellungen des elektronischen Berichterstellungsformats (EB) basieren, das ausgeführt wird:

• Wenn die Bezeichnungen und Beschreibungen für die angeforderte Sprache verfügbar sind, geben die Felder Bezeichnung und Beschreibung Werte zurück, die auf dieser Sprache basieren, und das Feld IsTranslated gibt True zurück.
• Wenn die Bezeichnungen und Beschreibungen für die angeforderte Sprache nicht verfügbar sind, geben die Felder Bezeichnung und Beschreibung Werte zurück, die auf der Standardsprache EN-US basieren, und das Feld IsTranslated gibt False zurück.

Wenn zur Laufzeit die Syntax 2 verwendet wird, müssen die Felder Bezeichnung und Beschreibung Werte zurückgeben, die auf den Spracheinstellungen basieren, die als zweites Argument der aufgerufenen Funktion definiert sind:

• Wenn die Bezeichnungen und Beschreibungen für die angeforderte Sprache verfügbar sind, geben die Felder Bezeichnung und Beschreibung Werte zurück, die auf dieser Sprache basieren, und das Feld IsTranslated gibt True zurück.
• Wenn die Bezeichnungen und Beschreibungen für die angeforderte Sprache nicht verfügbar sind, geben die Felder Bezeichnung und Beschreibung Werte zurück, die auf der Standardsprache EN-US basieren, und das Feld IsTranslated gibt False zurück.

Beispiel 1

In der folgenden Abbildung wird eine Aufzählung in einem EB-Datenmodell vorgestellt.

Die folgende Abbildung zeigt diese Details an:

• Die Modellaufzählung ist eingefügt in einen Bericht als Datenquelle.
• Ein EB-Ausdruck verwendet die Modellaufzählung als Parameter der Funktion LISTOFFIELDS.
• Eine Datenquelle des Typs Datensatzliste wird in einen Bericht mithilfe des EB-Ausdrucks eingefügt, der erstellt wird.

Das folgende Beispiel zeigt die EB-Formatelemente, die an die Datenquelle des Typs Datensatzliste gebunden sind, der mithilfe der Funktion LISTOFFIELDS erstellt wurde.

Die folgende Abbildung zeigt das Ergebnis, wenn das entworfene Format ausgeführt wird.

Notiz

Basierend auf den Spracheinstellungen des Formats von übergeordneten DATEI- und ORDNER-Elementen, wird übersetzter Text für Beschriftungen und Beschreibungen in der Ausgabe des EB-Formats eingegeben.

Beispiel 2

Sie verwenden den Datenquellentyp Berechnetes Feld, um die Datenquellen enumType_de und enumType_deCH für die Datenmodellenumeration enumType zu konfigurieren:

• enumType_de = LISTOFFIELDS (enumType, "de")
• enumType_deCH = LISTOFFIELDS (enumType, "de-CH")

In diesem Fall können Sie den folgenden Ausdruck verwenden, um die Beschriftung des Aufzählungswerts in Schweizer Deutsch abzurufen, wenn diese Übersetzung verfügbar ist. Wenn die schweizerdeutsche Übersetzung nicht verfügbar ist, ist das Etikett auf Deutsch.

IF (NOT (enumType_deCH.IsTranslated), enumType_de.Label, enumType_deCH.Label)

Zusätzliche Ressourcen

Listenfunktionen