INFOR.GET.ELEMENT

Diese Funktion gibt Zeichenfolgenwerte zurück, die ein oder mehrere Elementattribute darstellen. Zum Beispiel Caption (MEMBER_CAPTION) oder ID (MEMBER_UNIQUE_NAME).

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

  • 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.

    Wenn eine aggregierte Menge von Elementen von einem MDX-Ausdruck zurückgegeben wird, werden die entsprechenden Attribute in einer Zelle zurückgegeben, wobei sie durch Kommas abgetrennt werden.

Syntax

Die Funktion hat folgende Syntax:

=INFOR.GET.ELEMENT("data_connection", "cube", [attribute], "hierarchy" {, element, ...})

Die Tabelle zeigt die Parameter mit einer Beschreibungen:

Parameter Beschreibung
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, lautet der Standardwert MEMBER_CAPTION.
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.
element Stellt den eindeutigen Namen des Elements aus der angegebenen Hierarchie dar. Es handelt sich um eine beliebige Anzahl von Zeichenfolgen oder Zellreferenzen.
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 einen einzelnen Zellwert eines beliebigen Typs zurück.

Für eine angegebene und gültige Hierarchie:

  • Wenn der Parameter Element als mehrere eindeutige Namen angegeben wird, die durch Kommas getrennt sind, wird ein aggregiertes Element zurückgegeben. Die verschiedenen Elemente müssen aus derselben Hierarchie stammen.
  • Wenn der Parameter Element leer ist, wird das Standardelement aus der angegebenen Hierarchie zurückgegeben.
  • Wenn der Parameter Element nur der Elementname ist, wird das erste verfügbare Element mit diesem Namen zurückgegeben.

Wenn der Parameter Attribute mehrere eindeutige Namen enthält, zum Beispiel MEMBER_CAPTION und MEMBER_UNIQUE_NAME, gibt die Funktion ein Array mit der Größe 1 × N zurück. Die Reihenfolge der angegebenen Attribute definiert die Reihenfolge der zurückgegebenen Elemente.

Wenn das Argument [attribute] nicht angegeben ist, gibt die Funktion das Attribut MEMBER_CAPTION zurück.

Fehler

Die Funktion gibt einen Fehlerwert zurück, wenn ein erforderlicher Parameter fehlt. Wenn die angegebenen Parameter ungültig sind, wird das entsprechende Element übersprungen.