Funkcje niestandardowe PlaidXL

PlaidXL dodaje do Excela funkcje, które wczytują dane PlaidCloud bezpośrednio do komórek. Wpisz =PLAIDXL. w komórce, a autouzupełnianie Excela wyświetli je wraz z krótkim opisem każdego argumentu.

Grupa	Funkcje	Zastosowanie
Listy	`LIST_PROJECTS`, `TABLE.TBL_LIST`, `TABLE.GET_COLUMNS`, `DIMENSION.DIM_LIST`	Sprawdzenie, co jest dostępne do wykorzystania
Tabele	`TABLE.GET_TABLE`	Odczyt całej tabeli do zakresu
Hierarchie	`DIMENSION.GET_DIMENSION`, `DRILL`	Rozmieszczenie węzłów wymiaru jako wierszy raportu
Wartości	`CELL`, `CELLS`	Obliczenie zagregowanej wartości dla dowolnej kombinacji węzłów
Elementy składowe	`REPR.TABLE_REPR`, `REPR.MEASURE`, `REPR.MEASURES`, `REPR.MEASURE_TYPE`, `REPR.DIMENSION_REPR`, `REPR.DRILL_KEY`	Opisanie tabeli, miary, agregacji, węzłów i głębokości rozwinięcia używanych przez `CELL`, `CELLS` i `DRILL`

Tworzenie raportu za pomocą funkcji niestandardowych pokazuje, jak te funkcje współpracują.

Jak działają funkcje

Najpierw się zaloguj. Funkcje odczytują dane z użyciem Twojego logowania do PlaidCloud, więc przed ich użyciem zaloguj się w okienku zadań.
Odczytują dane z wybranego projektu. Każda funkcja odczytuje dane z projektu wybranego w okienku zadań. GET_TABLE, TBL_LIST i DIM_LIST przyjmują także opcjonalny identyfikator projektu, aby odczytać inny projekt bez zmiany wyboru. Wybór jest wspólny dla wszystkich otwartych skoroszytów.
Wyniki się rozlewają. Funkcja zwracająca listę lub tabelę wypełnia komórki poniżej (lub po prawej stronie). Zostaw miejsce na wyniki; jeśli coś stoi na przeszkodzie, Excel wyświetla błąd #SPILL!.
Przelicz, aby pobrać zmiany. Formuła PlaidXL pobiera dane ponownie, gdy zmieni się jeden z jej argumentów. Aby pobrać nowe dane z PlaidCloud lub uwzględnić inny projekt wybrany w okienku zadań, wymuś pełne przeliczenie — w systemie Windows naciśnij Ctrl+Alt+F9. Refresh All Tables odświeża pobrane tabele, a nie formuły.
Używaj dokładnych nazw. Wpisuj nazwy tabel, kolumn, wymiarów i węzłów dokładnie tak, jak występują w PlaidCloud.

Argumenty w nawiasach kwadratowych są opcjonalne.

Listy

LIST_PROJECTS

=PLAIDXL.LIST_PROJECTS([horizontal])

Wyświetla nazwy projektów, które możesz otworzyć, posortowane według nazwy.

horizontal — TRUE, aby wyświetlić listę w wierszu. Domyślnie FALSE, czyli w kolumnie.

TBL_LIST

=PLAIDXL.TABLE.TBL_LIST([project_id], [horizontal])

Wyświetla nazwy tabel w projekcie, posortowane według nazwy.

project_id — projekt do odczytu. Domyślnie jest to projekt wybrany w okienku zadań.
horizontal — TRUE, aby wyświetlić listę w wierszu. Domyślnie FALSE, czyli w kolumnie.

GET_COLUMNS

=PLAIDXL.TABLE.GET_COLUMNS(table_name, [column_filter], [orientation])

Wyświetla nazwy kolumn tabeli w wybranym projekcie.

table_name — nazwa tabeli w PlaidCloud.
column_filter — typ danych, na przykład "text", aby wyświetlić tylko kolumny tego typu. Pomiń, aby wyświetlić wszystkie kolumny.
orientation — "vertical" (domyślnie) dla kolumny lub "horizontal" dla wiersza.

DIM_LIST

=PLAIDXL.DIMENSION.DIM_LIST([project_id], [horizontal])

Wyświetla nazwy wymiarów w projekcie.

project_id — projekt do odczytu. Domyślnie jest to projekt wybrany w okienku zadań.
horizontal — TRUE, aby wyświetlić listę w wierszu. Domyślnie FALSE, czyli w kolumnie.

Tabele

GET_TABLE

=PLAIDXL.TABLE.GET_TABLE(table_name, [project_id], [limit])

Zwraca wiersze tabeli z wierszem nagłówka, rozlane od komórki formuły. Puste wartości są zwracane jako puste komórki.

table_name — nazwa tabeli w PlaidCloud.
project_id — projekt do odczytu. Domyślnie jest to projekt wybrany w okienku zadań.
limit — maksymalna liczba zwracanych wierszy. Domyślnie 1 048 575, czyli maksimum, jakie arkusz mieści pod wierszem nagłówka.

GET_TABLE zwraca wszystkie kolumny. Aby wybrać kolumny lub przefiltrować wiersze, pobierz tabelę z okienka zadań.

Hierarchie

GET_DIMENSION

=PLAIDXL.DIMENSION.GET_DIMENSION(dimension_name, start_node, [hierarchy], [orientation], [generation_limit])

Rozmieszcza węzły wymiaru, zaczynając od start_node i schodząc przez jego potomków. Każde pokolenie ma wcięcie o cztery spacje większe niż jego element nadrzędny, a konspekt grup Excela pozwala zwijać i rozwijać każdy poziom.

dimension_name — nazwa wymiaru lub jego ścieżka w projekcie.
start_node — węzeł początkowy, na przykład korzeń wymiaru.
hierarchy — alternatywna hierarchia, według której przebiega rozmieszczanie. Domyślnie "main".
orientation — "vertical" (domyślnie), aby wyświetlić węzły w kolumnie, lub "horizontal", aby wyświetlić je w wierszu.
generation_limit — liczba zwracanych pokoleń, przy czym start_node liczy się jako pierwsze: 2 zwraca węzeł początkowy i jego elementy podrzędne. Pomiń, aby zwrócić wszystkie pokolenia.

DRILL

=PLAIDXL.DRILL(dimension_name, start_node, drill_key, [hierarchy])

Zwraca start_node oraz poniższe węzły, o które prosi drill_key, w kolumnie, z wcięciem według pokolenia i zgrupowane w konspekcie Excela.

dimension_name — nazwa wymiaru lub jego ścieżka w projekcie.
start_node — węzeł, od którego następuje rozwijanie.
drill_key — jak głęboko rozwijać, z DRILL_KEY: wszyscy potomkowie, tylko liście lub określona liczba poziomów.
hierarchy — alternatywna hierarchia, według której przebiega rozwijanie. Domyślnie "main".

Na przykład =PLAIDXL.DRILL("Region", "Total", PLAIDXL.REPR.DRILL_KEY("leaves")) wyświetla węzeł Razem, a po nim wszystkie liście regionów pod nim.

Polecenia rozwijania na wstążce robią to samo dla wymiaru i węzła wpisanych w dwóch komórkach, bez pisania formuły.

Wartości

CELL i CELLS obliczają miarę — kolumnę liczbową tabeli — zagregowaną do węzłów wybranych w jednym lub kilku wymiarach. Każde wywołanie traktuj jako jedno przecięcie w raporcie: Przychody dla EMEA w FY2026.

Przecięcie opisujesz za pomocą poniższych funkcji będących elementami składowymi, zwykle w osobnych komórkach, a następnie przekazujesz te komórki do CELL lub CELLS w dowolnej kolejności:

Argument	Tworzony za pomocą	Wymagany
Tabela do odczytu	`TABLE_REPR`	Dokładnie jeden
Kolumna do agregacji	`MEASURE` dla `CELL`, `MEASURES` lub kilka komórek `MEASURE` dla `CELLS`	Tak
Sposób agregacji	`MEASURE_TYPE`	Nie — domyślnie `sum`
Filtr na kolumnie	`DIMENSION_REPR`	Co najmniej jeden, po jednym na kolumnę

Każdy filtr wskazuje kolumnę tabeli i wartość. Gdy ta kolumna jest powiązana z wymiarem w PlaidCloud, wartością jest węzeł, a filtr obejmuje wszystko, co agreguje się do tego węzła w głównej hierarchii wymiaru — w kolumnie Region powiązanej z wymiarem geograficznym węzeł EMEA obejmuje wszystkie kraje poniżej niego. W kolumnie niepowiązanej z wymiarem filtr dopasowuje wartość dokładnie.

Przykłady na tej stronie używają tabeli, w której kolumny Region i Period są powiązane z wymiarami. Użyj nazw kolumn własnej tabeli.

CELL

=PLAIDXL.CELL(table, measure, [measure_type], node, [node], ...)

Zwraca jedną liczbę: miarę zagregowaną dla wierszy, które mieszczą się pod każdym przekazanym węzłem.

A1  =PLAIDXL.REPR.TABLE_REPR("Sales")
A2  =PLAIDXL.REPR.MEASURE("revenue")
A3  =PLAIDXL.REPR.MEASURE_TYPE("sum")
A4  =PLAIDXL.REPR.DIMENSION_REPR("Region", "EMEA")
A5  =PLAIDXL.REPR.DIMENSION_REPR("Period", "FY2026")
B1  =PLAIDXL.CELL(A1, A2, A3, A4, A5)

Komórka B1 pokazuje łączne przychody dla EMEA w FY2026.

CELLS

=PLAIDXL.CELLS(table, measures, [measure_type], node, [node], ...)

Podobna do CELL, ale dla kilku miar naraz. Zwraca po jednej liczbie na miarę, w kolumnie, w kolejności, w jakiej je wymieniono.

D1:F1  revenue | cost | units
D2     =PLAIDXL.REPR.MEASURES(D1:F1)
B2     =PLAIDXL.CELLS(A1, D2#, A3, A4, A5)

D2# przekazuje cały rozlany wynik MEASURES. Zakres B2:B4 pokazuje przychody, koszty i liczbę sztuk dla EMEA w FY2026.

Elementy składowe

Te funkcje same nie odczytują danych. Każda zwraca krótki fragment tekstu opisujący jedną część obliczenia, gotowy do przekazania do CELL, CELLS lub DRILL. Umieszczaj je w komórkach, do których się odwołujesz, aby jedna zmiana — na przykład innego okresu — aktualizowała każdą formułę, która z nich korzysta.

TABLE_REPR

=PLAIDXL.REPR.TABLE_REPR(table_name)

Tabela, z której odczytują dane CELL i CELLS, według jej nazwy w wybranym projekcie.

MEASURE

=PLAIDXL.REPR.MEASURE(column_name)

Kolumna liczbowa agregowana przez CELL.

MEASURES

=PLAIDXL.REPR.MEASURES(column_names)

Kilka kolumn miar dla CELLS, z zakresu komórek zawierających nazwy kolumn. Wynik rozlewa się na jedną komórkę na kolumnę; przekaż go do CELLS za pomocą operatora rozlewania, na przykład D2#.

MEASURE_TYPE

=PLAIDXL.REPR.MEASURE_TYPE(agg_function)

Sposób agregacji miary. agg_function to jedna z poniższych wartości, małymi literami:

Wartość	Zwraca
`sum`	Sumę (domyślnie, gdy nie przekażesz typu miary)
`mean`	Średnią
`median`	Wartość środkową
`min`	Najmniejszą wartość
`max`	Największą wartość
`std`	Odchylenie standardowe
`var`	Wariancję

DIMENSION_REPR

=PLAIDXL.REPR.DIMENSION_REPR(dimension_name, start_node)

Filtr dla CELL i CELLS. Przekaż po jednym dla każdej kolumny, według której chcesz filtrować.

dimension_name — nazwa kolumny w tabeli — kolumny, która zawiera wartości wymiaru, na przykład "Region". Musi dokładnie odpowiadać nazwie kolumny; kolumna, której nie ma w tabeli, zwraca błąd.
start_node — węzeł, do którego następuje agregacja, na przykład "EMEA". W kolumnie niepowiązanej z wymiarem jest to wartość do dopasowania.

Odwołaj się do komórki z węzłem, aby zbudować siatkę: =PLAIDXL.REPR.DIMENSION_REPR("Region", $A7). Spacje na początku i na końcu są ignorowane, więc możesz wskazać nazwy węzłów z wcięciami rozmieszczone przez DRILL.

DRILL_KEY

=PLAIDXL.REPR.DRILL_KEY(d_key)

Jak głęboko DRILL schodzi poniżej węzła początkowego. d_key to zwykły tekst:

`d_key`	Rozwija do
`"all"`	Wszystkich potomków
`"leaves"`	Tylko liści — węzłów, pod którymi nic nie ma
`"1 level"`, `"2 levels"`, …	Tylu pokoleń w dół

Zapisz liczbę cyframi: "2 levels", a nie "two levels". Początkowe drill jest ignorowane, więc "drill 2 levels" również działa.

Przy dwóch lub więcej poziomach DRILL wyświetla jedno pokolenie naraz — wszystkie elementy podrzędne, potem wszystkie wnuki — zamiast każdego węzła bezpośrednio pod jego elementem nadrzędnym. Aby uzyskać układ zagnieżdżony, użyj "all" lub GET_DIMENSION z generation_limit.

Powiązane

Tworzenie raportu za pomocą funkcji niestandardowych — hierarchia z boku, wartości u góry
Praca z tabelami i wymiarami — wybierz projekt, z którego odczytują dane funkcje
Korzystanie z wymiarów — hierarchie główne i alternatywne oraz sposób agregowania węzłów
Projektowanie hierarchii wymiaru — zbuduj hierarchię, przez którą agreguje się raport