Udostępnij przez

Excel Online (business)

Łącznik usługi Excel Online (business) umożliwia pracę z plikami programu Excel w bibliotekach dokumentów obsługiwanych przez program Microsoft Graph (OneDrive dla Firm, witryny programu SharePoint i grupy usługi Office 365).

Ten łącznik jest dostępny w następujących produktach i regionach:

Usługa Class Regions
Copilot Studio Standard Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - China Cloud obsługiwane przez firmę 21Vianet
Logic Apps Standard Wszystkie regiony usługi Logic Apps z wyjątkiem następujących:
     — Regiony platformy Azure (Chiny)
Power Apps Standard Wszystkie regiony usługi Power Apps z wyjątkiem następujących:
     - China Cloud obsługiwane przez firmę 21Vianet
Power Automate Standard Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - China Cloud obsługiwane przez firmę 21Vianet
Kontakt
Name Excel Online (business)
adres URL https://learn.microsoft.com/en-us/connectors/excelonlinebusiness/
Email idcknowledgeeco@microsoft.com
Metadane łącznika
Publisher Microsoft
Witryna internetowa https://products.office.com/excel
Zasady ochrony prywatności https://privacy.microsoft.com/
Kategorie AI; Analiza biznesowa

Znane problemy i ograniczenia dotyczące akcji

Krótki opis Operations Długi opis
Nieaktualne dane Wyświetlanie listy wierszy znajdujących się w tabeli Dane mogą nie być aktualne (może wystąpić pewne opóźnienie) podczas filtrowania lub sortowania jest używana w wierszach listy znajdujących się w akcji tabeli .
Możliwości filtrowania Wyświetlanie listy wierszy znajdujących się w tabeli Wiersze listy w akcji tabeli obsługują podstawowe filtrowanie i sortowanie:
- Obsługuje następujące funkcje filtru: eq, , containsne, startswith, endswith.
— Na kolumnie można zastosować tylko 1 funkcję filtru.
— Tylko 1 kolumna może służyć do sortowania.
Skumulowane filtry Wyświetlanie listy wierszy znajdujących się w tabeli Po zastosowaniu filtru przy użyciu akcji Wiersze listy w tabeli zostaną dodane do istniejących filtrów.
Filtry niestosowane Wyświetlanie listy wierszy znajdujących się w tabeli Jeśli filtr nie jest stosowany przy użyciu wierszy listy znajdujących się w akcji tabeli , wszystkie filtry już ustawione w pliku programu Excel zostaną zignorowane. Akcja pobiera wszystkie wiersze niezależnie od istniejących filtrów w programie Excel.
Paginacja Wyświetlanie listy wierszy znajdujących się w tabeli Domyślnie wiersze listy w akcji tabeli zwracają do 256 wierszy. Aby pobrać wszystkie wiersze, włącz stronicowanie.
Wybieranie wierszy innych niżquentowe Wyświetlanie listy wierszy znajdujących się w tabeli Łącznik pobiera wiersze dla maksymalnie 500 kolumn w wierszach listy znajdujących się w akcji tabeli . Wiersze dla pierwszych 500 kolumn są domyślnie zwracane. Możesz podać rozdzielaną przecinkami listę określonych kolumn do pobrania w parametrze Select Query .
Nazwa pola kolumny klucza Dodawanie kolumny klucza do tabeli
Usuwanie wiersza
Pobieranie wiersza
Aktualizowanie wiersza		 W polu kolumny klucza jest uwzględniana wielkość liter.
Aktualizowanie/usuwanie wielu wierszy Usuwanie wiersza
Aktualizowanie wiersza		 W przypadku wielu dopasowań w operacjach, takich jak Aktualizowanie wiersza i Usuwanie wiersza, tylko pierwszy wiersz zostanie zaktualizowany/usunięty.
Obsługa arkusza kalkulacyjnego Macro-Enabled programu Microsoft Excel Uruchamianie skryptu Akcja Uruchom skrypt dodatkowo obsługuje format arkusza kalkulacyjnego programu Microsoft Excel Macro-Enabled (*.xlsm). Aby dowiedzieć się więcej, zobacz How to use macro files in Power Automate flows (Jak używać plików makr w przepływach usługi Power Automate).
Ograniczenie nagłówków kolumn tabeli Dodawanie wiersza
Aktualizowanie wiersza
Usuwanie wiersza		 Zmiany zatwierdzone przez operacje, takie jak Dodawanie wiersza, Aktualizowanie wiersza, Usuwanie wiersza , nie zawsze mają wpływ natychmiast po pomyślnej odpowiedzi z odpowiednich akcji usługi Power Automate, LogicApps lub Power Apps. Opóźnienia do 30 sekund są oczekiwane z powodu podstawowych ograniczeń usługi zaplecza.
Ograniczenia operacji uruchamiania skryptu Uruchamianie skryptu Operacja uruchamiania skryptu umożliwia wykonywanie maksymalnie 3 wywołań na 10 sekund i maksymalnie 1600 wywołań dziennie.
Obsługa suwerennych chmur operacji skryptu Uruchamianie skryptu Operacja uruchamiania skryptu nie jest dostępna w suwerennych chmurach (w tym Gcc, GccHigh, DoD i innych chmurach wyższych).

Typowe błędy

Error Rozwiązanie
403 Zabronione Upewnij się, że plik ma dostęp do zapisu.
502 BadGateway Te błędy będą wyświetlane, jeśli arkusz kalkulacyjny jest w trybie tylko do odczytu. Aby dowiedzieć się więcej na temat wyłączania trybu tylko do odczytu, przejdź do tematu Zmienianie arkusza kalkulacyjnego programu Excel tylko do odczytu.
429 Zbyt wiele żądań Dzieje się tak, jeśli użytkownik wysyła zbyt wiele żądań w krótkim czasie. Limit ograniczania jest unikatowy dla każdego żądania i różni się w zależności od liczby żądań, używanej pamięci i innych ważnych czynników. Jeśli występuje ograniczanie przepustowości, zaleca się dodanie jawnych opóźnień wokół akcji łącznika.
Ze względu na limity ograniczania przepustowości w interfejsie API programu Graph może się to również zdarzyć z wielu powodów:
1. Jeśli liczba globalnych żądań z przepływu przekroczy limit, niektóre żądania zostaną ograniczone. Które żądania są ograniczane i które nie są losowo wybierane przez rozwiązanie ograniczania przepustowości platformy Azure.
2. Nawet jeśli nie osiągnęła limitu w pliku #1, nadal może być ograniczana z różnych powodów. Poniżej przedstawiono najczęstsze przyczyny ograniczania przepustowości:
a. Naciśnij pozycję Zasady ograniczania przepustowości usługi programu SharePoint.
b. Trafij w zasady usługi Excel Online, na przykład kolejka operacji była pełna z powodu zbyt wielu żądań.
c. Żądanie oczekuje w kolejce przez dłuższy czas niż oczekiwano. Na przykład żądania, które trwają dłużej niż 30, mogą zwrócić wartość 504, a dalsze 504 spowoduje ograniczenie przepustowości.
d. Zbyt wiele kolejnych niepowodzeń w sesji skoroszytu.
e. Po wysłaniu żądania do pakietu OfficeScript w identyfikatorze operacji "RunScriptProd" i jeśli te żądania są większe niż 3 w ciągu 10 sekund, jest ograniczana.

Ogólne znane problemy i ograniczenia

  • Maksymalny rozmiar pliku programu Excel obsługiwany przez łącznik Excel Online (Business) wynosi 25 MB.
  • Plik programu Excel może być zablokowany przez aktualizację lub usunąć maksymalnie 6 minut od ostatniego użycia łącznika.
  • Jednoczesne modyfikacje plików wprowadzone przez inne łączniki lub edycje ręczne nie są obsługiwane. Użytkownicy powinni unikać zapisywania danych w jednym pliku programu Excel z wielu klientów jednocześnie (excel Desktop, Excel Web, Power Automate, LogicApps lub Power Apps). Może to spowodować konflikty scalania i niespójność danych.
  • Łącznik obsługuje pliki w formatach arkusza kalkulacyjnego Open XML programu Microsoft Excel (*.xlsx) i skoroszytu binarnego programu Microsoft Excel (*.xlxb).
  • Właściwość oczekiwana File przez akcje łącznika powinna zostać wypełniona przy użyciu jednej z następujących opcji:
    • Wybierz plik z selektora plików.
    • Użyj danych wyjściowych wyzwalaczy/akcji łącznika usługi OneDrive dla Firm (plików Id lub właściwości, w zależności od tego, która z nich jest obecna dla akcji lub File identifier wyzwalacza usługi OneDrive dla Firm).
    • Użyj danych wyjściowych wyzwalaczy/akcji łącznika programu SharePoint (plików Id lub Identifier właściwości, w zależności od tego, która z nich jest obecna dla akcji lub wyzwalacza określonego programu SharePoint).
    • Wprowadź ścieżkę do pliku rozpoczynającego się od dysku. Przykłady:
      • Jeśli plik znajduje się w usłudze OneDrive , a pełna ścieżka to OneDrive/file.xlsx , a parametr Drive to OneDrive, wprowadź file.xlsx.
      • Jeśli plik znajduje się w obszarze Grupy usługi O365 , a pełna ścieżka to Dokumenty/Dokumenty wewnętrzne/file.xlsx , a parametr dysku to Documents, wprowadź dane wewnętrzne dokumenty/file.xlsx.
  • Łącznik nie obsługuje używania parametrów OData dla tabel zawierających ukryte kolumny.
  • Przekroczenie limitu czasu łącznika spowodowane ponownymi obliczeniami może wystąpić, jeśli istnieją skomplikowane formuły lub istnieje zbyt wiele wierszy w arkuszu. W obu przypadkach dane można wstawić wiele razy z powodu zasad ponawiania. Aby obejść ten problem, sprawdź, czy formuły można uprościć lub zmniejszyć. W przeciwnym razie można ustawić tryb obliczania dla tego skoroszytu na Ręczne. Aby uzyskać więcej informacji, zobacz tutaj.
  • Filter Query / Order By / Select Query parametry operacji obsługują tylko alfanumeryczne nazwy kolumn.
  • Tabele przestawne nie są obsługiwane z powodu ograniczeń interfejsu API programu Graph.
  • Łącznik zawsze zwraca wszystkie biblioteki dokumentów dostępne w kontrolce listy rozwijanej Biblioteka dokumentów. W przypadku większości użytkowników zostanie zwrócona tylko jedna biblioteka dokumentów, ale jeśli istnieje wiele dostępnych, wszystkie z nich zostaną wyświetlone. Aby dowiedzieć się więcej na temat biblioteki dokumentów (na przykład kierowania zasobami) i oczekiwanego zachowania użytkowników, grup i witryn, przejdź do pozycji Dyski listy — uwagi.
  • Łącznik może automatycznie wypełniać maksymalnie 64 000 wierszy, jeśli podczas importowania tabeli w usłudze Power Apps wybrano opcję Wstaw automatycznie wygenerowany identyfikator do tabeli programu Excel .
  • Nagłówki kolumn tabel, które zawierają tylko liczbę, mogą powodować nieoczekiwane zachowanie w operacjach, takich jak Aktualizacja wiersza, Usuwanie wiersza z powodu podstawowych ograniczeń usługi zaplecza. Aby obejść ten problem, zmień nazwy takich kolumn, tak aby zawierały również inne znaki.
  • Plik programu Excel może zostać zmodyfikowany, a nowa wersja może być widoczna w historii wersji pliku nawet wtedy, gdy jest wykonywana akcja "tylko do odczytu". Takie zachowanie jest zaprojektowane z powodu wewnętrznych mechanizmów zapisywania usługi zaplecza łącznika.
  • Użytkownicy-goście nie mogą uzyskać dostępu do dokumentu, jeśli pochodzą z innej dzierżawy niż użytkownicy główni. W takim przypadku użytkownik otrzyma błąd HTTP 404 (nie znaleziono).
  • W usłudze Fairfax Logic Apps ten łącznik obsługuje tylko połączenia przy użyciu konta komercyjnego (.com).
  • Pliki programu SharePoint mogą być niedostępne. Interfejs API programu Graph nie przekazuje adresu IP użytkownika do programu SharePoint. W związku z tym jeśli włączono zasady oparte na lokalizacji, program SharePoint nie może określić, czy użytkownik znajduje się w zaufanej granicy. Z tego powodu podczas uzyskiwania dostępu do biblioteki programu SharePoint może wystąpić błąd "Ze względu na zasady organizacji nie można uzyskać dostępu do tych zasobów z tej lokalizacji sieciowej". Aby uzyskać więcej informacji, zobacz tutaj.
  • Selektor plików będzie wyświetlać maksymalnie 200 elementów na folder. Użytkownicy mogą mieć problemy ze znalezieniem elementów, jeśli mają więcej niż 200 elementów w folderze.
  • Jeśli występują ciągłe błędy 504, klienci mogą napotkać ograniczanie przepustowości z powodu różnych ograniczeń interfejsu API programu Graph. Poniżej przedstawiono kilka sugestii dotyczących zmniejszenia liczby operacji długotrwałych 504:
    • Zaktualizuj tabelę tak, aby było tak prosta, jak to możliwe, przy użyciu mniejszej liczby formuł i zależności.
    • Użyj innego pustego arkusza/skoroszytu w tym samym formacie tabeli, jeśli liczba wierszy jest duża.
  • Dostęp do zapisu do pliku jest wymagany dla wszystkich akcji. W przeciwnym razie interfejs API programu Graph zwróci 403 Forbidden błąd. Ponadto łącznik zwróci 502 BadGateway błąd, jeśli arkusz kalkulacyjny jest w trybie tylko do odczytu. Aby wyłączyć tryb tylko do odczytu, dowiedz się więcej tutaj.
  • Maksymalny obsługiwany rozmiar każdego żądania łącznika to 5 MB.

Obsługa nazw kolumn

Nazwy kolumn w wynikach odpowiedzi akcji można przekształcić w celu zapewnienia zgodności z formatem OData:

Character Wartość zakodowana
. _x002e_
@ _x0040_
: _x003a_
# _x0023_

Na przykład Column [one]#1 —>Column [one]_x0023_1

Ogólne limity

Name Wartość
Maksymalna liczba wariantów kolumn tożsamości, których można użyć do pobierania/wstawiania/aktualizowania/usuwania wiersza z pojedynczej tabeli programu Excel. Bieżąca wartość jest ustawiona na 2, co oznacza, że do dwóch wariantów nazw kolumn powinna być używana w przepływach pracy dla jednej konkretnej tabeli. 2

Pojęcia i przykłady

  • Kolumna klucza: Kolumna w tabeli, która będzie używana do wyszukiwania wartości (wartość klucza).
  • Wartość klucza: Wartość w kolumnie klucza, która będzie używana do identyfikowania określonego wiersza.

Poniższa tabela jest przykładem. Aby wykonać operację wiersza w drugim wierszu tabeli, key column powinna to być Column 1 wartość i key value powinna mieć wartość 200.

Kolumna 1 Kolumna 2 Kolumna 3
100 A-2 A-3
200 B-2 B-3
300 C-2 C-3

Limity ograniczania

Nazwa Wywołania Okres odnowienia
Wywołania interfejsu API na połączenie 100 60 sekund

Akcje

Dodawanie kolumny klucza do tabeli

Dodaj kolumnę klucza do tabeli programu Excel. Nowa kolumna zostanie dołączona po prawej stronie.
Dodawanie wiersza do tabeli

Dodaj nowy wiersz do tabeli programu Excel.
Dodawanie wiersza do tabeli [PRZESTARZAŁE]

Ta akcja została przestarzała. Zamiast tego użyj polecenia Dodaj wiersz do tabeli .

Dodaj nowy wiersz do tabeli programu Excel.
Pobieranie arkuszy

Pobierz listę arkuszy w skoroszycie programu Excel.
Pobieranie tabel

Pobierz listę tabel w skoroszycie programu Excel.
Pobieranie wiersza

Pobierz wiersz przy użyciu kolumny klucza.
Tworzenie arkusza

Utwórz nowy arkusz w skoroszycie programu Excel.
Tworzenie tabeli

Utwórz nową tabelę w skoroszycie programu Excel.
Uruchamianie skryptu

Uruchamia skrypt pakietu Office dla skoroszytu programu Excel. Użyj tej akcji, gdy skrypt zostanie zapisany w lokalizacji domyślnej.
Uruchamianie skryptu z biblioteki programu SharePoint

Uruchamia skrypt pakietu Office dla skoroszytu programu Excel. Użyj tej akcji, gdy skrypt zostanie zapisany poza lokalizacją domyślną.
Usuń wiersz

Usuń wiersz przy użyciu kolumny klucza.
Wyświetlanie listy wierszy znajdujących się w tabeli

Wyświetlanie listy wierszy znajdujących się w tabeli.
Zaktualizuj wiersz

Zaktualizuj wiersz przy użyciu kolumny klucza. Wartość wejściowa zastąpi określone komórki, a kolumny pozostawione puste nie zostaną zaktualizowane. Aby dołączyć (zamiast zastąpić) wartość, użyj akcji "Pobierz wiersz", aby najpierw pobrać zawartość.

Dodawanie kolumny klucza do tabeli

Identyfikator operacji:
CreateIdColumn

Dodaj kolumnę klucza do tabeli programu Excel. Nowa kolumna zostanie dołączona po prawej stronie.

Parametry

Nazwa Klucz Wymagane Typ Opis
Lokalizacja
 source True string

Wybierz z listy rozwijanej lub określ jedną z następujących opcji: - "me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (wymagane są dwukropki).
Biblioteka dokumentów
 drive True string

Wybierz bibliotekę dokumentów z listy rozwijanej.
File
 file True string

Wybierz plik programu Excel za pomocą opcji Przeglądaj plik.
Tabela
 table True string

Wybierz tabelę z listy rozwijanej.
Kolumna klucza
 idColumn string

Podaj nazwę kolumny klucza.

Dodawanie wiersza do tabeli

Identyfikator operacji:
AddRowV2

Dodaj nowy wiersz do tabeli programu Excel.

Parametry

Nazwa Klucz Wymagane Typ Opis
Lokalizacja
 source True string

Wybierz z listy rozwijanej lub określ jedną z następujących wartości: - "me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (wymagane są dwukropki).
Biblioteka dokumentów
 drive True string

Wybierz bibliotekę dokumentów z listy rozwijanej.
File
 file True string

Wybierz plik programu Excel za pomocą opcji Przeglądaj plik.
Tabela
 table True string

Wybierz tabelę z listy rozwijanej.
Wiersz
 item True dynamic

Wiersz do dodania do określonej tabeli programu Excel.
Format daty/godziny
 dateTimeFormat string

Format daty/godziny.

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Dodawanie wiersza do tabeli [PRZESTARZAŁE]

Identyfikator operacji:
AddRow

Ta akcja została przestarzała. Zamiast tego użyj polecenia Dodaj wiersz do tabeli .

Dodaj nowy wiersz do tabeli programu Excel.

Parametry

Nazwa Klucz Wymagane Typ Opis
Lokalizacja
 source True string

Wybierz z listy rozwijanej lub określ jedną z następujących wartości: - "me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (wymagane są dwukropki).
Biblioteka dokumentów
 drive True string

Wybierz bibliotekę dokumentów z listy rozwijanej.
File
 file True string

Wybierz plik programu Excel za pomocą opcji Przeglądaj plik.
Tabela
 table True string

Wybierz tabelę z listy rozwijanej.
Wiersz
 item True dynamic

Wiersz do wstawienia do określonej tabeli programu Excel.

Pobieranie arkuszy

Identyfikator operacji:
GetAllWorksheets

Pobierz listę arkuszy w skoroszycie programu Excel.

Parametry

Nazwa Klucz Wymagane Typ Opis
Lokalizacja
 source True string

Wybierz z listy rozwijanej lub określ jedną z następujących wartości: - "me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (wymagane są dwukropki).
Biblioteka dokumentów
 drive True string

Wybierz bibliotekę dokumentów z listy rozwijanej.
File
 file True string

Wybierz plik programu Excel za pomocą opcji Przeglądaj plik.
Wyodrębnianie etykiety poufności
 extractSensitivityLabel boolean

Wartość logiczna określająca, czy wyodrębnić identyfikator etykiety poufności dla skojarzonego artefaktu.
Metadane etykiety poufności
 fetchSensitivityLabelMetadata boolean

Wartość logiczna określająca, czy pobrać metadane etykiety poufności dla skojarzonego identyfikatora LabelId.

Zwraca

Nazwa Ścieżka Typ Opis
value
 value array of WorksheetMetadata
sensitivityLabelInfo
 sensitivityLabelInfo array of SensitivityLabelMetadata

Pobieranie tabel

Identyfikator operacji:
GetTables

Pobierz listę tabel w skoroszycie programu Excel.

Parametry

Nazwa Klucz Wymagane Typ Opis
Lokalizacja
 source True string

Wybierz z listy rozwijanej lub określ jedną z następujących wartości: - "me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (wymagane są dwukropki).
Biblioteka dokumentów
 drive True string

Wybierz bibliotekę dokumentów z listy rozwijanej.
File
 file True string

Wybierz plik programu Excel za pomocą opcji Przeglądaj plik.
Wyodrębnianie etykiety poufności
 extractSensitivityLabel boolean

Wartość logiczna określająca, czy wyodrębnić identyfikator etykiety poufności dla skojarzonego artefaktu.
Metadane etykiety poufności
 fetchSensitivityLabelMetadata boolean

Wartość logiczna określająca, czy pobrać metadane etykiety poufności dla skojarzonego identyfikatora LabelId.

Zwraca

Nazwa Ścieżka Typ Opis
value
 value array of object
Id
 value.id string

Identyfikator tabeli.
Name
 value.name string

Nazwa tabeli.
Pokaż kolumny pasmowe
 value.showBandedColumns boolean

Pokaż kolumny pasmowe.
Wyróżnianie pierwszej kolumny
 value.highlightFirstColumn boolean

Wyróżnij pierwszą kolumnę.
Wyróżnianie ostatniej kolumny
 value.highlightLastColumn boolean

Wyróżnij ostatnią kolumnę.
Pokaż wiersze naprzemienne
 value.showBandedRows boolean

Pokaż wiersze pasmowe.
Pokaż przycisk filtru
 value.showFilterButton boolean

Pokaż przycisk filtru.
Pokaż nagłówki
 value.showHeaders boolean

Pokaż nagłówki.
Pokaż sumy
 value.showTotals boolean

Pokaż sumy.
Styl
 value.style string

Styl tabeli.
sensitivityLabelInfo
 sensitivityLabelInfo array of SensitivityLabelMetadata

Pobieranie wiersza

Identyfikator operacji:
GetItem

Pobierz wiersz przy użyciu kolumny klucza.

Parametry

Nazwa Klucz Wymagane Typ Opis
Lokalizacja
 source True string

Wybierz z listy rozwijanej lub określ jedną z następujących wartości: - "me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (wymagane są dwukropki)
Biblioteka dokumentów
 drive True string

Wybierz bibliotekę dokumentów z listy rozwijanej.
File
 file True string

Wybierz plik programu Excel za pomocą opcji Przeglądaj plik.
Tabela
 table True string

Wybierz tabelę z listy rozwijanej.
Kolumna klucza
 idColumn True string

Wybierz kolumnę z listy rozwijanej.
Wartość klucza
 id True string

Wprowadź wartość klucza.
Format daty/godziny
 dateTimeFormat string

Format daty/godziny.
Wyodrębnianie etykiety poufności
 extractSensitivityLabel boolean

Wartość logiczna określająca, czy wyodrębnić identyfikator etykiety poufności dla skojarzonego artefaktu.
Metadane etykiety poufności
 fetchSensitivityLabelMetadata boolean

Wartość logiczna określająca, czy pobrać metadane etykiety poufności dla skojarzonego identyfikatora LabelId.

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Tworzenie arkusza

Identyfikator operacji:
CreateWorksheet

Utwórz nowy arkusz w skoroszycie programu Excel.

Parametry

Nazwa Klucz Wymagane Typ Opis
Lokalizacja
 source True string

Wybierz z listy rozwijanej lub określ jedną z następujących wartości: - "me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (wymagane są dwukropki).
Biblioteka dokumentów
 drive True string

Wybierz bibliotekę dokumentów z listy rozwijanej.
File
 file True string

Wybierz plik programu Excel za pomocą opcji Przeglądaj plik.
Name
 name string

Nazwa arkusza.

Zwraca

Body
WorksheetMetadata

Tworzenie tabeli

Identyfikator operacji:
CreateTable

Utwórz nową tabelę w skoroszycie programu Excel.

Parametry

Nazwa Klucz Wymagane Typ Opis
Lokalizacja
 source True string

Wybierz z listy rozwijanej lub określ jedną z następujących opcji: - "me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (wymagane są dwukropki).
Biblioteka dokumentów
 drive True string

Wybierz bibliotekę dokumentów z listy rozwijanej.
File
 file True string

Wybierz plik programu Excel za pomocą opcji Przeglądaj plik.
Nazwa tabeli
 TableName string

Wprowadź nazwę tabeli programu Excel.
Zakres tabel
 Range True string

Wprowadź adres tabeli przy użyciu notacji A1.
Nazwy kolumn
 ColumnsNames string

Wprowadź nazwy kolumn rozdzielone znakami ";" lub ",".

Zwraca

Metadane tabeli

Body
TableMetadata

Uruchamianie skryptu

Identyfikator operacji:
RunScriptProd

Uruchamia skrypt pakietu Office dla skoroszytu programu Excel. Użyj tej akcji, gdy skrypt zostanie zapisany w lokalizacji domyślnej.

Parametry

Nazwa Klucz Wymagane Typ Opis
Lokalizacja
 source True string

Wybierz z listy rozwijanej lub określ jedną z następujących wartości: - "me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (wymagane są dwukropki).
Biblioteka dokumentów
 drive True string

Wybierz bibliotekę dokumentów z listy rozwijanej.
File
 file True string

Wybierz plik programu Excel za pomocą opcji Przeglądaj plik.
Skrypt
 scriptId True string

Wybierz skrypt pakietu Office, który chcesz uruchomić z listy rozwijanej.
ScriptParameters
 ScriptParameters True dynamic

Podaj parametry skryptu pakietu Office.

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Uruchamianie skryptu z biblioteki programu SharePoint

Identyfikator operacji:
RunScriptProdV2

Uruchamia skrypt pakietu Office dla skoroszytu programu Excel. Użyj tej akcji, gdy skrypt zostanie zapisany poza lokalizacją domyślną.

Parametry

Nazwa Klucz Wymagane Typ Opis
Lokalizacja skoroszytu
 source True string

Wybierz z listy rozwijanej lub określ jedną z następujących wartości: - "me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (wymagane są dwukropki).
Biblioteka skoroszytów
 drive True string

Wybierz bibliotekę dokumentów z listy rozwijanej.
Skoroszyt
 file True string

Wybierz skoroszyt programu Excel za pomocą opcji Przeglądaj plik.
Lokalizacja skryptu
 scriptSource True string

Wybierz z listy rozwijanej lub określ jedną z następujących opcji: - "me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (wymagane są dwukropki).
Biblioteka skryptów
 scriptDrive True string

Z listy rozwijanej wybierz bibliotekę programu SharePoint pliku skryptu pakietu Office (osts).
Skrypt
 scriptId True string

Wybierz plik skryptu pakietu Office (osts) w bibliotece programu SharePoint z listy rozwijanej.
ScriptParameters
 ScriptParameters True dynamic

Podaj parametry skryptu pakietu Office.

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Usuń wiersz

Identyfikator operacji:
DeleteItem

Usuń wiersz przy użyciu kolumny klucza.

Parametry

Nazwa Klucz Wymagane Typ Opis
Lokalizacja
 source True string

Wybierz z listy rozwijanej lub określ jedną z następujących wartości: - "me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (wymagane są dwukropki)
Biblioteka dokumentów
 drive True string

Wybierz bibliotekę dokumentów z listy rozwijanej.
File
 file True string

Wybierz plik programu Excel za pomocą opcji Przeglądaj plik.
Tabela
 table True string

Wybierz tabelę z listy rozwijanej.
Kolumna klucza
 idColumn True string

Wybierz kolumnę z listy rozwijanej.
Wartość klucza
 id True string

Wprowadź wartość klucza.

Wyświetlanie listy wierszy znajdujących się w tabeli

Identyfikator operacji:
GetItems

Wyświetlanie listy wierszy znajdujących się w tabeli.

Parametry

Nazwa Klucz Wymagane Typ Opis
Lokalizacja
 source True string

Wybierz z listy rozwijanej lub określ jedną z następujących wartości: - "me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (wymagane są dwukropki)
Biblioteka dokumentów
 drive True string

Wybierz bibliotekę dokumentów z listy rozwijanej.
File
 file True string

Wybierz plik programu Excel za pomocą opcji Przeglądaj plik.
Tabela
 table True string

Wybierz tabelę z listy rozwijanej.
Zapytanie filtru
 $filter string

Zapytanie filtru ODATA w celu ograniczenia zwracanych wpisów.
Zamów według
 $orderby string

Zapytanie orderBy protokołu ODATA służące do określania kolejności wpisów.
Liczba pierwszych
 $top integer

Łączna liczba wpisów do pobrania (wartość domyślna = wszystkie).
Pomiń liczbę
 $skip integer

Liczba wpisów do pominięcia (wartość domyślna = 0).
Wybieranie zapytania
 $select string

Rozdzielona przecinkami lista kolumn do pobrania (domyślnie pierwsze 500).
Format daty/godziny
 dateTimeFormat string

Format daty/godziny.
Wyodrębnianie etykiety poufności
 extractSensitivityLabel boolean

Wartość logiczna określająca, czy wyodrębnić identyfikator etykiety poufności dla skojarzonego artefaktu.
Metadane etykiety poufności
 fetchSensitivityLabelMetadata boolean

Wartość logiczna określająca, czy pobrać metadane etykiety poufności dla skojarzonego identyfikatora LabelId.

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Zaktualizuj wiersz

Identyfikator operacji:
PatchItem

Zaktualizuj wiersz przy użyciu kolumny klucza. Wartość wejściowa zastąpi określone komórki, a kolumny pozostawione puste nie zostaną zaktualizowane. Aby dołączyć (zamiast zastąpić) wartość, użyj akcji "Pobierz wiersz", aby najpierw pobrać zawartość.

Parametry

Nazwa Klucz Wymagane Typ Opis
Lokalizacja
 source True string

Wybierz z listy rozwijanej lub określ jedną z następujących wartości: - "me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (wymagane są dwukropki)
Biblioteka dokumentów
 drive True string

Wybierz bibliotekę dokumentów z listy rozwijanej.
File
 file True string

Wybierz plik programu Excel za pomocą opcji Przeglądaj plik.
Tabela
 table True string

Wybierz tabelę z listy rozwijanej.
Kolumna klucza
 idColumn True string

Wybierz kolumnę z listy rozwijanej.
Wartość klucza
 id True string

Wprowadź wartość klucza.
Podaj właściwości elementu
 item True dynamic

Podaj właściwości elementu.
Format daty/godziny
 dateTimeFormat string

Format daty/godziny.

Zwraca

Dane wyjściowe tej operacji są dynamiczne.

Wyzwalacze

Dla wybranego wiersza

Wyzwala przepływ dla wybranego wiersza w tabeli programu Excel. (Dostępne tylko dla Power Automate.)

Dla wybranego wiersza

Identyfikator operacji:
OnRowSelected

Wyzwala przepływ dla wybranego wiersza w tabeli programu Excel. (Dostępne tylko dla Power Automate.)

Parametry

Nazwa Klucz Wymagane Typ Opis
operationId
 operationId True string
gospodarz
 host object
parameters
 parameters True object
schemat
 schema True object
headersSchema (Schemat nagłówków)
 headersSchema object

Zwraca

Nazwa Ścieżka Typ Opis
wiersze
 body.rows array of object
items
 body.rows object
Identyfikator użytkownika
 headers.x-ms-user-id-encoded guid

Unikatowy identyfikator użytkownika, który wyzwolił przepływ w usłudze AAD.
Adres e-mail użytkownika
 headers.x-ms-user-email-encoded byte

Adres e-mail użytkownika, który wyzwolił przepływ.
Nazwa użytkownika
 headers.x-ms-user-name-encoded byte

Nazwa wyświetlana użytkownika, który wyzwolił przepływ.
Sygnatura czasowa
 headers.x-ms-user-timestamp string

Godzina wyzwolenia przepływu.

Definicje

TableMetadata

Metadane tabeli

Nazwa Ścieżka Typ Opis
nazwa
 name string

Nazwa tabeli
title
 title string

Tytuł tabeli
x-ms-permission
 x-ms-permission string

Uprawnienie do tabeli
x-ms-capabilities
 x-ms-capabilities TableCapabilitiesMetadata

Metadane tabeli (możliwości)
schemat
 schema Object
referencedEntities
 referencedEntities Object
webUrl
 webUrl string

Link adresu URL

TableCapabilitiesMetadata

Metadane tabeli (możliwości)

Nazwa Ścieżka Typ Opis
sortRestrictions
 sortRestrictions TableSortRestrictionsMetadata

Metadane tabeli (ograniczenia sortowania)
filterRestrictions
 filterRestrictions TableFilterRestrictionsMetadata

Metadane tabeli (ograniczenia filtru)
selectRestrictions
 selectRestrictions TableSelectRestrictionsMetadata

Metadane tabeli (wybierz ograniczenia)
isOnlyServerPagable
 isOnlyServerPagable boolean

Ograniczenia stronicowania serwera
filterFunctionSupport
 filterFunctionSupport array of string

Lista obsługiwanych funkcji filtrowania
serverPagingOptions
 serverPagingOptions array of string

Lista obsługiwanych funkcji stronicowania opartych na serwerze

Object

TableSortRestrictionsMetadata

Metadane tabeli (ograniczenia sortowania)

Nazwa Ścieżka Typ Opis
Sortowanie
 sortable boolean

Wskazuje, czy ta tabela ma kolumny sortowalne
unsortableProperties
 unsortableProperties array of string

Lista niesortowalnych właściwości
ascendingOnlyProperties
 ascendingOnlyProperties array of string

Lista właściwości, które obsługują tylko kolejność rosnącą

TableFilterRestrictionsMetadata

Metadane tabeli (ograniczenia filtru)

Nazwa Ścieżka Typ Opis
Filtrowanie
 filterable boolean

Wskazuje, czy ta tabela ma kolumny z możliwością filtrowania
niefiltrowalneWłaściwości
 nonFilterableProperties array of string

Lista właściwości niemożliwych do filtrowania
requiredProperties
 requiredProperties array of string

Lista wymaganych właściwości

TableSelectRestrictionsMetadata

Metadane tabeli (wybierz ograniczenia)

Nazwa Ścieżka Typ Opis
Wybieralny
 selectable boolean

Wskazuje, czy ta tabela ma kolumny z możliwością wyboru

ArkuszMetadata

Nazwa Ścieżka Typ Opis
Id
 id string

Identyfikator arkusza.
Name
 name string

Nazwa arkusza.
Position
 position integer

Położenie arkusza.
Widoczność
 visibility string

Widoczność arkusza.

SensitivityLabelMetadata

Nazwa Ścieżka Typ Opis
sensitivityLabelId
 sensitivityLabelId string

SensitivityLabel Id.
nazwa
 name string

Nazwa etykiety poufności.
nazwa wyświetlana
 displayName string

SensitivityLabel displayName info
etykietka narzędzia
 tooltip string

WażnośćSzczegóły etykietki narzędzia.
priority
 priority integer

WażnośćWłaciwość.
color
 color string

Kolor etykiet poufności.
jestZaszyfrowany
 isEncrypted boolean

is SensitivityLabel Encrypted.
jest włączony
 isEnabled boolean

Określa, czy etykieta SensitivityLabel jest włączona.
isParent
 isParent boolean

Czy wartość SensitivityLabel jest elementem nadrzędnym.
parentSensitivityLabelId
 parentSensitivityLabelId string

Identyfikator elementu SensitivityLabel nadrzędnego.