Udostępnij przez

Excel Online (OneDrive)

Dostawca połączenia usługi Excel Online (OneDrive) umożliwia pracę z plikami programu Excel przechowywanymi w usłudze OneDrive. Ten dostawca połączeń obsługuje tylko osobiste konta (MSA).

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
Power Apps - Niedostępne
Power Automate Standard Wszystkie regiony usługi Power Automate z wyjątkiem następujących:
     - China Cloud obsługiwane przez firmę 21Vianet
Metadane łącznika
Publisher Microsoft

Znane problemy i ograniczenia

  • Maksymalny rozmiar pliku programu Excel obsługiwany przez łącznik usługi Excel Online (OneDrive) wynosi 5 MB.
  • Dane mogą nie być aktualne (może wystąpić pewne opóźnienie) podczas filtrowania lub sortowania List rows present in a table jest używana w akcji.
  • Akcja List rows present in a table obsługuje podstawowe filtrowanie i sortowanie:
    • Obsługuje następujące funkcje filtru: eq, ne, contains, startswith, endswith.
    • W kolumnie można zastosować tylko 1 funkcję filtru.
    • Tylko 1 kolumna może służyć do sortowania.
  • Akcja List rows present in a table domyślnie zwraca maksymalnie 256 wierszy. Aby uzyskać wszystkie wiersze, włącz stronicowanie.
  • Plik programu Excel może być zablokowany w usłudze OneDrive w celu zaktualizowania lub usunięcia do 12 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 PowerApps). 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).
  • Łącznik pobiera wiersze dla maksymalnie 500 kolumn w List rows present in a table akcji. Wiersze dla pierwszych 500 kolumn są domyślnie zwracane. Możesz podać rozdzielaną przecinkami listę określonych kolumn do pobrania w Select Query parametrze.
  • Łącznik nie obsługuje używania parametrów OData dla tabel zawierających ukryte kolumny.
  • Może wystąpić przekroczenie limitu czasu łącznika spowodowane ponownymi obliczeniami— istnieją skomplikowane formuły lub 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
  • 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.
  • 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.
  • Jeśli użytkownik wysyła zbyt wiele żądań w krótkim czasie, można uzyskać odpowiedź 429. 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.
  • W operacjach, takich jak Delete a row, key column pole to case-sensitive.
  • W przypadku wielu dopasowań operacji, takich jak Update a rowoperacje , Delete a row tylko pierwszy wiersz zostanie zaktualizowany/usunięty.
  • Zmiany zatwierdzone przez operacje, takie jak Create a row, Update a rowDelete a row , 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.
  • Łącznik może automatycznie wypełniać maksymalnie 64000 wierszy, jeśli Insert auto generated id into Excel table opcja jest zaznaczona podczas importowania tabeli w usłudze PowerApps.
  • Nagłówki kolumn tabel, które zawierają tylko liczbę, mogą powodować nieoczekiwane zachowanie w operacjach, takich jak Update a row, Delete a row 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.
  • Excrypted lub oznaczony jako chronione arkusze, zgłasza błąd uszkodzonego pliku, mimo że plik można otworzyć ręcznie.

Obsługa nazw kolumn

Należy pamiętać, że nazwy kolumn w wynikach odpowiedzi akcji mogą zostać przekształcone w celu zapewnienia zgodności z formatem OData:

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

Np. Column [one]#1 ->Column [one]_x0023_1

Pojęcia i przykłady

  • Key column: kolumna w tabeli, która będzie używana do wyszukiwania wartości (key value)
  • Key value: wartość w obiekcie key column , która będzie używana do identyfikowania określonego wiersza.

Weźmy poniższą tabelę jako przykład. Aby wykonać operację wiersza w drugim wierszu tabeli, key column element powinien mieć Column 1 wartość i key value powinien mieć wartość 200.

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

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
Maksymalna liczba wierszy, które łącznik może wypełniać automatycznie, jeśli podczas importowania tabeli w usłudze PowerApps wybrano opcję "Wstaw automatycznie wygenerowany identyfikator do tabeli". 64000

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. Nowa kolumna klucza musi być unikatowa w tabeli.
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. Ta akcja spowoduje pobranie wszystkich wartości określonego wiersza przy użyciu kolumny i kolumny klucza.
Tworzenie arkusza

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

Utwórz nową tabelę w skoroszycie programu Excel.
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. Nowa kolumna klucza musi być unikatowa w tabeli.

Parametry

Nazwa Klucz Wymagane Typ Opis
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
File
 file True string

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

Wybierz tabelę z listy rozwijanej.
Row
 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
File
 file True string

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

Wybierz tabelę z listy rozwijanej.
Row
 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
File
 file True string

Wybierz plik programu Excel za pomocą opcji Przeglądaj plik.

Zwraca

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

Pobieranie tabel

Identyfikator operacji:
GetTables

Pobierz listę tabel w skoroszycie programu Excel.

Parametry

Nazwa Klucz Wymagane Typ Opis
File
 file True string

Wybierz plik programu Excel za pomocą opcji Przeglądaj plik.

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.

Pobieranie wiersza

Identyfikator operacji:
GetItem

Pobierz wiersz przy użyciu kolumny klucza. Ta akcja spowoduje pobranie wszystkich wartości określonego wiersza przy użyciu kolumny i kolumny klucza.

Parametry

Nazwa Klucz Wymagane Typ Opis
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.

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

Usuń wiersz

Identyfikator operacji:
DeleteItem

Usuń wiersz przy użyciu kolumny klucza.

Parametry

Nazwa Klucz Wymagane Typ Opis
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
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.
Uporządkuj wg
 $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.

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

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.