INFOR.GET.ELEMENTS

Deze functie retourneert waarden die een of meer elementkenmerken vertegenwoordigen. Bijvoorbeeld: Bijschrift (MEMBER_CAPTION) of ID (MEMBER_UNIQUE_NAME).

INFOR.GET.ELEMENT ondersteunt de volgende functies:

  • Meervoudige selectie

    U kunt meerdere unieke namen van elementen uit dezelfde hiërarchie opgeven.

  • Alle kenmerken ophalen
  • MDX-expressies

    U kunt bijvoorbeeld [HierarchyUN].DefaultMember opgeven om de standaardelementkenmerken te retourneren of elementUN.Children om meerdere kindelementen te retourneren.

    Als een geaggregeerde verzameling elementen wordt geretourneerd uit een MDX-expressie, worden de bijbehorende kenmerken in één cel geretourneerd, gescheiden door komma's.

Syntaxis

De functie heeft de volgende syntaxis:

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

Deze tabel toont de parameters en de bijbehorende omschrijvingen:

Parameters Omschrijving
data_connection Geeft de unieke naam van de database weer. Dit is een tekenreeks of een celverwijzing.
cube Geeft de unieke naam van de kubus weer. Dit is een tekenreeks of een celverwijzing.
attribute Geeft de unieke naam van het kenmerk weer. Het is een matrix met tekenreeksen of celverwijzingen. Als de waarde niet wordt opgegeven, is de standaardwaarde een MEMBER_CAPTION.
hierarchy Geeft de unieke naam van de hiërarchie weer. Dit is een tekenreeks of een celverwijzing. Als de hiërarchie niet is opgegeven, is de standaardwaarde een lege tekenreeks en wordt de hiërarchie geparseerd uit de unieke naam van het element.
element Geeft de unieke naam van het element uit de opgegeven hiërarchie weer. Dit zijn een willekeurig aantal tekenreeksen of celverwijzingen.
NB

Als de hiërarchie niet wordt opgegeven, moet de unieke naam van het element worden opgegeven in de lange vorm, bijvoorbeeld [PERIOD].[ALL YEARS].[2018].

.

Retourwaarden

Deze functie retourneert een enkele celwaarde van een willekeurig type.

Voor een opgegeven en geldige hiërarchie:

  • Als de elementparameter is opgegeven als meerdere unieke namen, gescheiden door een komma, wordt een geaggregeerd element geretourneerd. De meerdere elementen moeten uit dezelfde hiërarchie komen.
  • Als de elementparameter leeg is, wordt het standaardelement uit de opgegeven hiërarchie geretourneerd.
  • Als de elementparameter alleen de elementnaam is, wordt het eerst beschikbare element met deze naam geretourneerd.

Als de kenmerkparameter meerdere unieke namen bevat, bijvoorbeeld MEMBER_CAPTION en MEMBER_UNIQUE_NAME, retourneert de functie een matrix van 1 x N grootte. De volgorde van de opgegeven kenmerken definieert de volgorde van geretourneerde artikelen.

Als het argument [attribute] niet is opgegeven, retourneert de functie het veld MEMBER_CAPTION.

Fouten

De functie retourneert een foutwaarde als een vereiste parameter ontbreekt. Als de opgegeven parameters ongeldig zijn, wordt het bijbehorende element overgeslagen.