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, oderelementUN.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.