INFOR.GET.ELEMENTS

Ta funkcja jest rozszerzoną wersją funkcji INFOR.GET.ELEMENT. Zwraca co najmniej jedną wartość atrybutu dla jednego lub większej liczby elementów. Można na przykład pobrać elementy podrzędne określonego elementu i zapytać zarówno o podpis – MEMBER_CAPTION, jak i identyfikator – MEMBER_UNIQUE_NAME.

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

  • Tablice dynamiczne

    Pobrane wartości są rozlewane do sąsiadujących komórek.

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

    Uwaga

    Jeśli zestaw elementów jest zwracany po użyciu wyrażenia MDX, to dla każdego elementu osobno są automatycznie wypełniane wartości i zostają zwrócone odpowiednie atrybuty.

  • Wcięcie

    Można określić ciąg, który będzie używany do oznaczania wcięć elementów i wskazywania, które atrybuty mają być wcięte.

    Domyślnie wcięcie ma tylko pierwszy atrybut i ma ono postać dwóch spacji.

  • Stronicowanie

    Istnieją dwa argumenty, których można użyć do stronicowania. Można ograniczyć liczbę wyświetlanych rekordów i zdefiniować używaną stronę.

Formuła rozlana

Jeżeli funkcja zwraca wiele wartości, to są one przelewane do sąsiednich pustych komórek. Domyślny kierunek rozlewania w przypadku elementów to pionowo w dół, natomiast wartości atrybutów są rozlewane poziomo w prawo.

Składnia

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

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

W poniższej tabeli przedstawiono parametry wraz z opisami.

Parametry Opis
spillByColumns Opcjonalna wartość logiczna określająca kierunek rozlania. Prawda oznacza rozlanie na kolumny, a fałsz – na wiersze. Wartość domyślna: fałsz
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, domyślną wartością 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.
number_of_records Wartość liczbowa lub odwołanie do komórki, określające limit liczby wyświetlanych rekordów. Parametr nieobowiązkowy z wartością domyślną: 0 oznacza brak limitu.
strona Wartość liczbowa lub odwołanie do komórki, określające stronę do wyświetlenia. Parametr nieobowiązkowy z wartością domyślną: 1.
indentString Ciąg używany do oznaczania wcięć. Opcjonalny parametr z wartością domyślną: ' ' – dwie spacje.
indentIndices Macierz indeksów lub odwołań do komórek reprezentujących jeden lub więcej atrybutów, które mają zostać wcięte. Parametr nieobowiązkowy z wartością domyślną 1. Domyślnie jest wcięty pierwszy atrybut. Inne możliwe wartości: 0 oznacza wcięcie wszystkich atrybutów, -1 oznacza brak wcięcia.
element Dowolna liczba macierzy nazw unikatowych elementów lub odwołań do komórek z wybranej hierarchii. Maksymalna liczba wynosi 249 ze względu na ograniczenie programu Excel.
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 ciągi reprezentujące jeden lub więcej atrybutów elementu, takie jak podpis, MEMBER_CAPTION, identyfikator, MEMBER_UNIQUE_NAME dla co najmniej jednego elementu. W przypadku podania dwóch unikatowych nazw elementów i dwóch atrybutów zostanie zwrócona macierz o wymiarach dwa na dwa.

Na przykład, jeśli określona zostanie sprzedaż z Ameryki Północnej w latach 2016, 2017 i 2018, funkcja zwróci macierz o wymiarach jeden na trzy z podsumowaniem wartości dla wybranych lat.