INFOR.GET.ELEMENTS

Deze functie is een verbeterde variant van de functie INFOR.GET.ELEMENT. De functie retourneert een of meer kenmerkwaarden voor een of meer elementen. U kunt bijvoorbeeld kinderen van een bepaald element ophalen en vragen om zowel het bijschrift, MEMBER_CAPTION als de ID, MEMBER_UNIQUE_NAME.

INFOR.GET.ELEMENTS ondersteunt de volgende functies:

  • Dynamische matrices

    De opgehaalde waarden lopen over naar de aangrenzende cellen.

  • 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 of elementUN.Children om meerdere kindelementen te retourneren.

    NB

    Als een verzameling elementen wordt geretourneerd uit een MDX-expressie, lopen de waarden automatisch over en worden de bijbehorende kenmerken voor elk element afzonderlijk geretourneerd.

  • Inspringing

    U kunt een string opgeven die wordt gebruikt voor niveau-inspringing van elementen en opgeven welke kenmerken moeten worden ingesprongen.

    Standaard wordt alleen het eerste kenmerk ingesprongen en worden twee spaties gebruikt.

  • Paginering

    Er zijn twee argumenten die kunnen worden gebruikt voor paginering. U kunt het aantal weergegeven records beperken en opgeven welke pagina wordt gebruikt.

Formule-overloop

Als de functie meerdere waarden retourneert, lopen de waarden over in aangrenzende lege cellen. De standaardrichting voor het overlopen van elementen is verticaal omlaag en kenmerkwaarden lopen horizontaal over naar rechts.

Syntaxis

De functie heeft de volgende syntaxis:

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

Deze tabel toont de parameters en de bijbehorende omschrijvingen:

Parameters Omschrijving
spillByColumns Een optionele Booleaanse waarde voor overlooprichting. Kies Waar voor overlopen in kolommen of Onwaar voor overlopen in rijen. Standaardwaarde: onwaar.
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 dit niet is opgegeven, is MEMBER_CAPTION de standaardwaarde.
hiërarchie 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 string en wordt de hiërarchie geparseerd uit de unieke naam van het element.
aantal_records Een numerieke waarde of celverwijzing die fungeert als een limiet voor het aantal records dat wordt weergegeven. Optionele parameter met de standaardwaarde 0 die staat voor geen limiet.
pagina Numerieke waarde of de celverwijzing die definieert welke pagina moet worden weergegeven. Optionele parameter met de standaardwaarde 1.
indentString String die wordt gebruikt voor inspringing. Optionele parameter met de standaardwaarde: ' ', twee spaties.
indentIndices Matrix van indexen of celverwijzingen die staan voor een of meer kenmerken die moeten worden ingesprongen. Optionele parameter met standaardwaarde 1. Het eerste kenmerk wordt standaard ingesprongen. Overige mogelijke waarden: 0 om alle kenmerken te laten inspringen. -1 om geen inspringing te gebruiken.
element Een willekeurig aantal matrices met unieke namen van elementen of celverwijzingen uit de geselecteerde hiërarchie. Het maximale getal is 249 vanwege een Excel-limiet.
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 stringwaarden die een of meer elementkenmerken vertegenwoordigen, zoals een bijschrift, MEMBER_CAPTION, ID, MEMBER_UNIQUE_NAME voor een of meer elementen. Als u twee unieke namen van elementen en twee kenmerken opgeeft, wordt een twee bij twee matrix geretourneerd.

Als u bijvoorbeeld Verkoop van Noord-Amerika opgeeft voor 2016, 2017 en 2018, retourneert de functie een één bij drie matrix met overzichtswaarden voor de geselecteerde jaren.