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. Karta Formulas w okienku zadań może też napisać formułę za Ciebie; zobacz Wstawianie formuły z okienka zadań.
| Grupa | Funkcje | Do czego służą |
|---|---|---|
| Listy | LIST_PROJECTS, TABLE.TBL_LIST, TABLE.GET_COLUMNS, DIMENSION.DIM_LIST |
Sprawdzenie, co jest dostępne do wykorzystania |
| Tabele | TABLE.GET_TABLE |
Wczytanie całej tabeli do zakresu |
| Hierarchie | DIMENSION.GET_DIMENSION, DRILL |
Ułożenie węzłów wymiaru jako wierszy raportu |
| Wartości | CELL, CELLS |
Obliczenie zagregowanej wartości dla dowolnej kombinacji węzłów |
| Metryki | METRIC, METRIC_BREAKDOWN |
Odczyt zarządzanej metryki biznesowej w takiej postaci, w jakiej pokazują ją pulpity |
| 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 pokazuje, jak te funkcje działają razem.
Jak działają funkcje
Dział zatytułowany „Jak działają funkcje”- Najpierw się zaloguj. Funkcje odczytują dane z Twoim logowaniem do PlaidCloud i Twoimi uprawnieniami, więc przed ich użyciem zaloguj się w okienku zadań.
- Odczytują dane z projektu skoroszytu. Każda funkcja odczytuje dane z projektu powiązanego ze skoroszytem w okienku zadań.
GET_TABLE,TBL_LISTiDIM_LISTprzyjmują też opcjonalny identyfikator projektu, aby odczytać inny projekt bez zmiany powiązania. Każdy skoroszyt ma własny projekt, więc dwa otwarte skoroszyty mogą odczytywać dane z różnych projektó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 uwzględnić zmiany. Formuła PlaidXL pobiera dane ponownie, gdy zmieni się jeden z jej argumentów. Aby uwzględnić nowe dane w PlaidCloud lub inny projekt powiązany w okienku zadań, użyj menu Odśwież na wstążce: Recalculate PlaidXL formulas przelicza wszystkie formuły PlaidXL w skoroszycie, a Refresh this sheet i Refresh selection przeliczają formuły, które obejmują. Refresh all tables odświeża pobrane tabele, a nie formuły. Zobacz Odśwież.
- 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.
LIST_PROJECTS
Dział zatytułowany „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ślnieFALSE, czyli w kolumnie.
TBL_LIST
Dział zatytułowany „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 projekt skoroszytu.horizontal—TRUE, aby wyświetlić listę w wierszu. DomyślnieFALSE, czyli w kolumnie.
GET_COLUMNS
Dział zatytułowany „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
Dział zatytułowany „DIM_LIST”=PLAIDXL.DIMENSION.DIM_LIST([project_id], [horizontal])
Wyświetla nazwy wymiarów w projekcie.
project_id— projekt do odczytu. Domyślnie projekt skoroszytu.horizontal—TRUE, aby wyświetlić listę w wierszu. DomyślnieFALSE, czyli w kolumnie.
GET_TABLE
Dział zatytułowany „GET_TABLE”=PLAIDXL.TABLE.GET_TABLE(table_name, [project_id], [limit])
Zwraca wiersze tabeli z wierszem nagłówka, rozlane od komórki z formułą. Puste wartości wracają jako puste komórki.
table_name— nazwa tabeli w PlaidCloud.project_id— projekt do odczytu. Domyślnie projekt skoroszytu.limit— maksymalna liczba zwracanych wierszy. Domyślnie 1 048 575, czyli tyle, ile arkusz mieści pod wierszem nagłówka.
GET_TABLE zwraca wszystkie kolumny. Aby wybrać kolumny lub przefiltrować wiersze, pobierz tabelę z okienka zadań.
Hierarchie
Dział zatytułowany „Hierarchie”GET_DIMENSION
Dział zatytułowany „GET_DIMENSION”=PLAIDXL.DIMENSION.GET_DIMENSION(dimension_name, start_node, [hierarchy], [orientation], [generation_limit])
Układa węzły wymiaru, zaczynając od start_node i schodząc przez jego potomków. Każda generacja jest wcięta o cztery spacje bardziej niż jej węzeł nadrzędny, a grupy konspektu Excela pozwalają 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— hierarchia alternatywna, według której należy iść. 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 generacji, przy czymstart_nodejest pierwszą:2zwraca węzeł początkowy i jego dzieci. Pomiń, aby zwrócić wszystkie generacje.
=PLAIDXL.DRILL(dimension_name, start_node, drill_key, [hierarchy], [exclude], [expand], [orientation])
Zwraca start_node oraz węzły poniżej niego, o które prosi drill_key, wcięte według generacji i zgrupowane w konspekcie Excela.
dimension_name— nazwa wymiaru lub jego ścieżka w projekcie.start_node— węzeł, od którego należy rozwijać. Pozostaw pusty (""), aby zacząć od węzłów najwyższego poziomu wymiaru. Sam wymiar liczy się jako generacja 0 klucza rozwinięcia i nie jest wyświetlany, więc węzły najwyższego poziomu to generacja 1:>[1]wyświetla tylko węzły najwyższego poziomu, a>[0]nie wyświetla nic.drill_key— jak głęboko rozwijać, zDRILL_KEY: wszyscy potomkowie, tylko liście, określona liczba poziomów lub zakres generacji.hierarchy— hierarchia alternatywna, według której należy iść. Domyślnie"main".exclude— węzły do pominięcia wraz ze wszystkim, co się pod nimi znajduje: węzeł, lista lub zakres komórek. Węzeł początkowy nigdy nie jest pomijany.expand— węzły, których dzieci mają być również pokazane, nawet poniżej głębokości, o którą prosidrill_key: węzeł, lista lub zakres komórek. Otwierane są tylko węzły pokazane przez rozwinięcie, więc aby otworzyć wnuka, wymień także jego węzeł nadrzędny.orientation—"vertical"(domyślnie), aby wyświetlić węzły w kolumnie, lub"horizontal", aby wyświetlić je w wierszu, bez wcięć i zgrupowane według kolumn. Każda inna wartość jest błędem.
exclude i expand przyjmują identyfikatory węzłów jako tekst lub liczby; puste komórki i błędy w zakresie są ignorowane. Pozostaw argument pusty (""), aby go pominąć, jak w =PLAIDXL.DRILL("Period", "FY2026", PLAIDXL.REPR.DRILL_KEY("1 level"), "main", "", "", "horizontal").
Na przykład =PLAIDXL.DRILL("Region", "Total", PLAIDXL.REPR.DRILL_KEY("leaves")) wyświetla Total, a po nim każdy region będący liściem pod tym węzłem.
Polecenia rozwijania piszą i edytują formuły DRILL za Ciebie: zaznacz węzeł i rozwiń w dół, zwiń w górę, zachowaj lub usuń węzły.
Wartości
Dział zatytułowany „Wartości”CELL i CELLS obliczają miarę — kolumnę liczbową tabeli — zagregowaną do wybranych węzłów w jednym lub kilku wymiarach. Potraktuj każde wywołanie jako jedno przecięcie w raporcie: Przychody dla EMEA w FY2026.
Przecięcie opisujesz poniższymi funkcjami będącymi 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 jest do niego zagregowane w głównej hierarchii wymiaru lub w hierarchii, którą wskażesz — w kolumnie Region powiązanej z wymiarem geograficznym węzeł EMEA obejmuje każdy kraj pod nim. W kolumnie niepowiązanej z wymiarem filtr dopasowuje wartość dokładnie.
Przykłady na tej stronie używają tabeli, której kolumny Region i Period są powiązane z wymiarami. Użyj nazw kolumn własnej tabeli.
=PLAIDXL.CELL(table, measure, [measure_type], node, [node], ...)
Zwraca jedną liczbę: miarę zagregowaną po wierszach, 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)B1 pokazuje łączne przychody dla EMEA w FY2026.
Wpisz liczbę nad formułą CELL, aby zapisać ją w PlaidCloud. Zobacz Wpisywanie wartości do PlaidCloud.
Arkusz pełen formuł CELL oblicza się szybko: formuły CELL obliczane razem są wysyłane do PlaidCloud w jednym żądaniu, po maksymalnie 10 000 naraz, a PlaidXL używa ponownie szczegółów kolumn tabeli przez 30 sekund zamiast pobierać je dla każdej komórki. Jeśli wartości nie można obliczyć, komórka pokazuje #VALUE!, a po najechaniu kursorem widać przyczynę zgłoszoną przez PlaidCloud, na przykład kolumnę filtra, której nie ma w tabeli, lub węzeł bez członków. CELLS pokazuje pierwszą przyczynę dla całego wyniku.
Gdy żaden wiersz nie pasuje, sum wynosi 0. Każdy inny sposób łączenia (mean, median, min, max, std lub var) nie ma wartości do zwrócenia: CELL pokazuje #VALUE!, a po najechaniu kursorem widać No value for, agregację, członków i miarę, natomiast element CELLS pozostaje pusty. Funkcje Excela, takie jak AVERAGE, pomijają pusty element CELLS, a Wyjaśnij podaje tę samą przyczynę.
=PLAIDXL.CELLS(table, measures, [measure_type], node, [node], ...)
Jak CELL, ale dla kilku miar naraz. Zwraca jedną liczbę na miarę, w dół kolumny, w kolejności, w jakiej je wymieniono.
D1:F1 revenue | cost | unitsD2 =PLAIDXL.REPR.MEASURES(D1:F1)B2 =PLAIDXL.CELLS(A1, D2#, A3, A4, A5)D2# przekazuje cały rozlany wynik MEASURES. B2:B4 pokazują przychody, koszty i jednostki dla EMEA w FY2026.
Metryki
Dział zatytułowany „Metryki”METRIC i METRIC_BREAKDOWN odczytują definicję metryki z projektu skoroszytu: liczbę biznesową, taką jak Net Revenue, której sposób obliczania został uzgodniony i zapisany w PlaidCloud. Wartość jest taka sama jak na pulpitach, obliczona z Twoim dostępem do wierszy. Metric… na wstążce wyświetla metryki projektu wraz z ich bieżącymi wartościami i pisze formułę za Ciebie; zobacz Wstawianie metryki.
Filtry to wartości DIMENSION_REPR, jak w CELL, z tą różnicą, że pierwszy argument wskazuje kolumnę, według której można podzielić metrykę. Węzeł obejmuje wszystko pod nim. Przekaż pojedynczy filtr albo zakres lub listę filtrów; puste filtry są ignorowane. Formuła może używać filtrów z więcej niż jednej hierarchii alternatywnej i łączyć członka hierarchii alternatywnej z członkami innych wymiarów.
=PLAIDXL.METRIC(name, [filter], ...)
Zwraca jedną liczbę: metrykę dla wierszy pod każdym przekazanym filtrem.
name— nazwa metryki, jeden z jej synonimów lub jej identyfikator. Wielkość liter nie ma znaczenia.filter— filtrDIMENSION_REPR. Przekaż tyle, ile potrzebujesz.
=PLAIDXL.METRIC("Net Revenue", PLAIDXL.REPR.DIMENSION_REPR("Region", "EMEA"))Gdy żaden wiersz nie pasuje, METRIC zwraca 0; gdy metryka nie ma wartości, komórka jest pusta.
METRIC_BREAKDOWN
Dział zatytułowany „METRIC_BREAKDOWN”=PLAIDXL.METRIC_BREAKDOWN(name, breakdown, [filter], ...)
Zwraca metrykę podzieloną według jednej kolumny: dwie kolumny, w których każdy członek breakdown stoi obok swojej wartości, od największej wartości, bez wiersza nagłówka.
name— nazwa metryki, jeden z jej synonimów lub jej identyfikator.breakdown— kolumna, według której dzielona jest metryka; taka, według której metrykę można podzielić.filter— filtrDIMENSION_REPR. Przekaż tyle, ile potrzebujesz.
=PLAIDXL.METRIC_BREAKDOWN("Net Revenue", "Region")Członkowie bez wartości są na końcu, z pustą wartością. Gdy żaden wiersz nie pasuje, zwracany jest jeden wiersz: pusty członek i 0.
Błędy metryk
Dział zatytułowany „Błędy metryk”Metryka, której nie można obliczyć, pokazuje #VALUE!; najedź kursorem na komórkę, aby zobaczyć przyczynę:
| Komunikat | Co zrobić |
|---|---|
| Nieznana metryka lub nieznana kolumna | Sprawdź nazwę. Gdy są zbliżone dopasowania, komunikat wymienia je po Did you mean. |
| Nazwa pasuje do więcej niż jednej metryki | Użyj pełnej nazwy metryki lub jej identyfikatora. |
| Your PlaidCloud role doesn’t allow reading metrics in this project. | Poproś właściciela projektu o dostęp. |
| This PlaidCloud workspace doesn’t serve metrics to Excel yet. | Poproś administratora o aktualizację obszaru roboczego. |
| PlaidCloud is busy; try again in liczba sekund | PlaidXL już ponowił próbę. Przelicz po podanym czasie. |
| Choose a project in the PlaidXL pane first. | Powiąż skoroszyt z projektem. |
| This PlaidCloud workspace can’t combine an alternate hierarchy with other members yet. Ask your administrator to update the workspace. | Poproś administratora o aktualizację obszaru roboczego. Pozostałe komórki w tym samym przeliczeniu nadal zwracają odpowiedź. |
Elementy składowe
Dział zatytułowany „Elementy składowe”Te funkcje same nie odczytują danych. Każda zwraca krótki tekst 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
Dział zatytułowany „TABLE_REPR”=PLAIDXL.REPR.TABLE_REPR(table_name)
Tabela, z której odczytują CELL i CELLS, według jej nazwy w wybranym projekcie.
MEASURE
Dział zatytułowany „MEASURE”=PLAIDXL.REPR.MEASURE(column_name)
Kolumna liczbowa, którą agreguje CELL.
MEASURES
Dział zatytułowany „MEASURES”=PLAIDXL.REPR.MEASURES(column_names)
Kilka kolumn miar dla CELLS, z zakresu komórek zawierających nazwy kolumn. Wynik rozlewa się o jedną komórkę na kolumnę; przekaż go do CELLS za pomocą operatora rozlania, takiego jak D2#.
MEASURE_TYPE
Dział zatytułowany „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
Dział zatytułowany „DIMENSION_REPR”=PLAIDXL.REPR.DIMENSION_REPR(dimension_name, start_node, [hierarchy])
Filtr dla CELL, CELLS, METRIC i METRIC_BREAKDOWN. Przekaż po jednym dla każdej kolumny, według której chcesz filtrować.
dimension_name— nazwa kolumny w tabeli, czyli kolumny zawierającej 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 należy agregować, na przykład"EMEA". W kolumnie niepowiązanej z wymiarem to wartość do dopasowania.hierarchy— hierarchia alternatywna, przez którą węzeł jest agregowany. Domyślnie"main".
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ć wcięte nazwy węzłów ułożone przez DRILL.
DRILL_KEY
Dział zatytułowany „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, albo forma słowna, albo wypisany klucz rozwinięcia:
d_key |
Rozwija do |
|---|---|
"all" |
Wszystkich potomków |
"leaves" |
Tylko liści, czyli węzłów, pod którymi nic nie ma |
"1 level", "2 levels", … |
Tylu generacji w dół |
">[...]" |
Wypisanego klucza rozwinięcia, jak w następnej tabeli |
Zapisz liczbę cyframi: "2 levels", a nie "two levels". Początkowe drill jest ignorowane, więc "drill 2 levels" również działa.
Wypisany klucz liczy generacje w dół od węzła początkowego, który jest generacją 0 i jest zawsze uwzględniany. Liczby ujemne liczą w górę od liści każdej gałęzi, więc hierarchia nierówna działa tak, jak można się spodziewać.
| Klucz | Obejmuje |
|---|---|
>[*] lub >[:] |
Każdy węzeł |
>[] lub >[-1] |
Tylko liście |
>[n] |
Węzeł początkowy i n generacji poniżej niego. >[0] to sam węzeł początkowy. |
>[a:] |
Węzeł początkowy, następnie generację a i wszystko poniżej |
>[a:b] |
Węzeł początkowy, następnie generacje od a do b - 1 |
>[0:-k] |
Węzeł początkowy i każdy węzeł, pod którym jest co najmniej k generacji, więc ostatnie k generacji każdej gałęzi jest pominiętych. >[0:-1] to każdy węzeł z wyjątkiem liści. |
>[a:-k] |
To samo, zaczynając od generacji a |
Dla hierarchii A, z dziećmi B, C i D, gdzie B ma B1 i B2, a C ma C1:
| Klucz | Wynik |
|---|---|
>[1] |
A, B, C, D |
>[2] |
A, B, B1, B2, C, C1, D |
>[] |
A, B1, B2, C1, D |
>[0:-1] |
A, B, C |
>[2:] |
A, B1, B2, C1 |
Węzły są wyświetlane w kolejności hierarchii, każdy pod własnym węzłem nadrzędnym, a grupy konspektu Excela mają tę samą kolejność. Spacje wewnątrz klucza są ignorowane. Klucz niepasujący do żadnej z tych form zwraca błąd z listą prawidłowych form.
Wstawianie formuły z okienka zadań
Dział zatytułowany „Wstawianie formuły z okienka zadań”Karta Formulas w okienku zadań pisze formułę za Ciebie. Otwórz ją z okienka zadań, za pomocą Formula… na wstążce lub Insert formula here… w menu prawego przycisku myszy PlaidXL. W obszarze What do you want in the cell? wybierz jedną z opcji:
- A whole table (
GET_TABLE) — wybierz lub wpisz tabelę i opcjonalnie maksymalną liczbę wierszy. - One number (
CELL) — wybierz lub wpisz tabelę, wybierz Column to total i How to combine the values. - A list of dimension nodes (
DRILL) — wybierz lub wpisz wymiar i węzeł początkowy, wybierz głębokość rozwinięcia oraz opcjonalnie Hierarchia alternatywna, węzły do wykluczenia i węzły do otwarcia. Wiersze pokazuje podgląd węzłów wyświetlanych przez rozwinięcie. Zobacz Rozwijanie niestandardowe. - A business metric (
METRIC) — zobacz Wstawianie metryki.
Podgląd Formula pokazuje wynik w miarę wypełniania pól. Kliknij Insert in active cell (lub naciśnij Ctrl+Enter), aby umieścić formułę w zaznaczonej komórce, albo Kopiuj, aby wkleić ją samodzielnie. Wybranie tabeli na karcie Tabele lub wymiaru na karcie Wymiary wypełnia odpowiednie pole.
Wstawianie metryki
Dział zatytułowany „Wstawianie metryki”Kliknij Metric… w grupie Wstaw na wstążce lub wybierz A business metric na karcie Formulas.
- W polu Metric wpisz fragment nazwy metryki lub jej synonimu, na przykład
revenue. Każde dopasowanie pokazuje bieżącą wartość i opis. - Użyj klawiszy strzałek lub kliknij, aby wybrać metrykę.
- Opcjonalnie dodaj filtry: wybierz Dimension, wpisz Node i kliknij Dodaj filtr.
- Opcjonalnie wybierz kolumnę w obszarze Breakdown by (optional), aby zapisać
METRIC_BREAKDOWNzamiast pojedynczej liczby. - Kliknij Insert in active cell lub Kopiuj.
Powiązane
Dział zatytułowany „Powiązane”- Tworzenie raportu — hierarchia z boku, wartości u góry
- Praca z tabelami i wymiarami — wybierz projekt, z którego odczytują funkcje
- Korzystanie z wymiarów — hierarchie główne i alternatywne oraz sposób agregowania węzłów
- Projektowanie hierarchii wymiaru — zbuduj hierarchię, do której agreguje Twój raport