INFOR.GET.ELEMENT

Ta funkcja zwraca wartości reprezentujące co najmniej jeden atrybut elementu. Na przykład podpis (MEMBER_CAPTION) lub ID (MEMBER_UNIQUE_NAME).

Funkcja INFOR.GET.ELEMENT obsługuje następujące właściwości:

  • Wybór wielokrotny

    Można określić wiele nazw unikatowych elementów z tej samej hierarchii.

  • Pobieranie wszystkich atrybutów
  • Wyrażenia MDX

    Można na przykład określić [HierarchyUN].DefaultMember, aby uzyskać atrybuty elementu domyślnego albo elementUN.Children, aby uzyskać wiele elementów podrzędnych.

    Jeśli zagregowany zestaw elementów jest zwracany po użyciu wyrażenia MDX, odpowiednie atrybuty, oddzielone przecinkami, są zwracane w jednej komórce.

Składnia

Funkcja ma następującą składnię:

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

W poniższej tabeli przedstawiono parametry wraz z opisami.

Parametry Opis
data_connection Reprezentuje nazwę unikatową bazy danych. Jest to ciąg lub odwołanie do komórki.
cube Reprezentuje nazwę unikatową kostki. Jest to ciąg lub odwołanie do komórki.
attribute Reprezentuje nazwę unikatową atrybutu. Jest to macierz ciągów lub odwołań do komórek. Jeśli nie określono, wartością domyślną jest MEMBER_CAPTION.
hierarchy Reprezentuje nazwę unikatową hierarchii. Jest to ciąg lub odwołanie do komórki. Jeżeli hierarchia nie jest określona, wartość domyślna jest ciągiem pustym, a hierarchia jest wywodzona z nazwy unikatowej elementu.
element Reprezentuje nazwę unikatową elementu z określonej hierarchii. Jest to dowolna liczba ciągów lub odwołań do komórek.
Uwaga

Jeżeli hierarchia nie została określona, nazwę unikatową elementu należy określić w postaci długiej, na przykład [PERIOD].[ALL YEARS].[2018].

.

Wartości zwracane

Ta funkcja zwraca pojedynczą wartość komórki dowolnego typu.

Dla określonej, prawidłowej hierarchii:

  • Jeśli parametr element określono jako wiele nazw unikatowych rozdzielonych przecinkami, zwracany jest zagregowany element członkowski. Wiele elementów musi należeć do tej samej hierarchii.
  • Jeśli parametr element jest pusty, zwracany jest element domyślny z określonej hierarchii.
  • Jeśli parametr element jest jedyną nazwą elementu, zwracany jest pierwszy dostępny element o takiej nazwie.

Jeżeli parametr atrybutów zawiera wiele nazw unikatowych, np. MEMBER_CAPTION i MEMBER_UNIQUE_NAME, funkcja zwraca tablicę w rozmiarze 1 x N. Kolejność określonych atrybutów określa kolejność zwracanych elementów.

Jeśli nie określono argumentu [attribute], funkcja zwraca atrybut MEMBER_CAPTION.

Błędy

Funkcja zwraca wartość błędu w przypadku braku dowolnego wymaganego parametru. Jeżeli określone parametry są nieprawidłowe, odpowiadający element zostanie pominięty.