Przejdź do głównej zawartości

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.

  • 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_LIST i DIM_LIST przyjmują 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.

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

=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ślnie FALSE, czyli w kolumnie.

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

=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ślnie FALSE, czyli w kolumnie.

=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ń.

=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 czym start_node jest pierwszą: 2 zwraca 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ć, z DRILL_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ą prosi drill_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.

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 | units
D2 =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.

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 — filtr DIMENSION_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.

=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 — filtr DIMENSION_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.

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

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.

=PLAIDXL.REPR.TABLE_REPR(table_name)

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

=PLAIDXL.REPR.MEASURE(column_name)

Kolumna liczbowa, którą agreguje CELL.

=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#.

=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ę

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

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

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.

Kliknij Metric… w grupie Wstaw na wstążce lub wybierz A business metric na karcie Formulas.

  1. W polu Metric wpisz fragment nazwy metryki lub jej synonimu, na przykład revenue. Każde dopasowanie pokazuje bieżącą wartość i opis.
  2. Użyj klawiszy strzałek lub kliknij, aby wybrać metrykę.
  3. Opcjonalnie dodaj filtry: wybierz Dimension, wpisz Node i kliknij Dodaj filtr.
  4. Opcjonalnie wybierz kolumnę w obszarze Breakdown by (optional), aby zapisać METRIC_BREAKDOWN zamiast pojedynczej liczby.
  5. Kliknij Insert in active cell lub Kopiuj.