INFOR.GET.ELEMENTS

Diese Funktion ist eine erweiterte Variante der Funktion INFOR.GET.ELEMENT. Sie gibt einen oder mehrere Attributwerte für ein oder mehrere Elemente zurück. Sie können zum Beispiel Kind-Elemente eines bestimmten Elements abrufen und sowohl Caption MEMBER_CAPTION als auch ID MEMBER_UNIQUE_NAME abfragen.

INFOR.GET.ELEMENTS unterstützt die folgenden Features:

  • Dynamische Arrays

    Die abgerufenen Werte werden mit Überlauf in die benachbarten Zellen eingefügt.

  • Mehrfachauswahl

    Sie können mehrere eindeutige Namen von Elementen aus derselben Hierarchie angeben.

  • Abrufen aller Attribute
  • MDX-Ausdrücke

    Sie können beispielsweise [HierarchyUN].DefaultMember angeben, um die Standardelementattribute zurückzugeben, oder elementUN.Children, um mehrere Kind-Elemente zurückzugeben.

    Hinweis

    Wenn von einem MDX-Ausdruck eine Menge von Elementen zurückgegeben wird, werden die Werte automatisch überlaufend eingefügt, und die entsprechenden Attribute werden separat für jedes Element zurückgegeben.

  • Einrückung

    Sie können eine Zeichenfolge angeben, die für die Einrückung der Elemente auf der Ebene verwendet wird und angibt, welche Attribute eingerückt werden sollen.

    Standardmäßig ist nur das erste Attribut eingerückt, und es werden zwei Leerzeichen verwendet.

  • Seitengröße

    Es gibt zwei Argumente, mit denen das Verhalten der Seitengröße gesteuert werden kann. Sie können die Anzahl der angezeigten Datensätze begrenzen und festlegen, welche Seite verwendet wird.

Formelüberlauf

Wenn die Funktion mehrere Werte zurückgibt, werden die Werte mit Überlauf in die benachbarten leeren Zellen eingefügt. Die standardmäßige Überlaufrichtung ist bei Elemente vertikal nach unten und bei Attributwerten horizontal nach rechts.

Syntax

Die Funktion hat folgende Syntax:

=INFOR.GET.ELEMENTS("spillByColumns", "data_connection", "cube", [attribute], "hierarchy" {, "number_of_records", "page", "indentString", [indentIndices], [element], ...})

Die Tabelle zeigt die Parameter mit einer Beschreibungen:

Parameter Beschreibung
spillByColumns Ein optionaler boolescher Wert für die Überlaufrichtung. Geben Sie "true" für Überlauf nach Spalten und "false" für Überlauf nach Zeilen an. Standardwert: false.
data_connection Stellt den eindeutigen Namen der Datenbank dar. Dies ist eine Zeichenfolge oder eine Zellreferenz.
cube Stellt den eindeutigen Namen des Cubes dar. Dies ist eine Zeichenfolge oder eine Zellreferenz.
attribute Stellt den eindeutigen Namen des Attributs dar. Es handelt sich um eine Matrix aus Zeichenfolgen oder Zellreferenzen. Wenn nicht angegeben, ist MEMBER_CAPTION der Standardwert.
hierarchy Stellt den eindeutigen Namen der Hierarchie dar. Dies ist eine Zeichenfolge oder eine Zellreferenz. Ist die Hierarchie nicht angegeben, ist der Standardwert eine leere Zeichenfolge, und die Hierarchie wird aus dem eindeutigen Namen des Elements analysiert.
number_of_records Ein numerischer Wert oder eine Zellreferenz, die als Grenzwert für die Anzahl der angezeigten Datensätze dient. Optionaler Parameter mit dem Standardwert: 0, es gibt keine Begrenzung.
page Numerischer Wert oder eine Zellreferenz, die die anzuzeigende Seite definiert. Optionaler Parameter mit dem Standardwert: 1.
indentString Zeichenfolge, die für die Einrückung verwendet wird. Optionaler Parameter mit dem Standardwert: ' ', zwei Leerzeichen.
indentIndices Matrix der Indizes oder Zellreferenzen, die ein oder mehrere Attribute darstellt, die eingerückt werden. Optionaler Parameter mit dem Standardwert 1, d. h. standardmäßig wird das erste Attribut eingerückt. Weitere mögliche Werte: 0 für das Einrücken aller Attribute. -1 für keine Einrückung.
element Jede Anzahl von Matrizen eindeutiger Elementnamen oder Zellreferenzen aus der ausgewählten Hierarchie. Die maximale Anzahl beträgt 249 aufgrund der Excel-Begrenzung.
Hinweis

Ist die Hierarchie nicht angegeben, muss der eindeutige Name des Elements in seiner langen Form angegeben werden, zum Beispiel [PERIOD].[ALL YEARS].[2018].

Rückgabewerte

Diese Funktion gibt Zeichenfolgenwerte zurück, die ein oder mehrere Elementattribute darstellen wie Caption, MEMBER_CAPTION, ID, MEMBER_UNIQUE_NAME für mindestens ein Element. Wenn Sie zwei eindeutige Namen von Elementen und zwei Attribute angeben, gibt es eine zwei 2×2-Matrix als Ergebnis zurück.

Wenn Sie beispielsweise Umsatz in Nordamerika für 2016, 2017 und 2018 angeben, gibt die Funktion eine 1×3-Matrix der Zusammenfassungswerte für ausgewählte Jahre zurück.