Sdílet prostřednictvím

Excel Online (OneDrive)

Poskytovatel připojení Excelu Online (OneDrive) umožňuje pracovat se soubory Excelu uloženými na OneDrivu. Tento poskytovatel připojení podporuje pouze osobní účty (MSA).

Tento konektor je dostupný v následujících produktech a oblastech:

Service Class Regions
Copilot Studio Standard Všechny oblasti Power Automate s výjimkou následujících:
     - China Cloud provozovaný společností 21Vianet
Logic Apps Standard Všechny oblasti Logic Apps
Power Apps - Není k dispozici
Power Automate Standard Všechny oblasti Power Automate s výjimkou následujících:
     - China Cloud provozovaný společností 21Vianet
Metadata konektoru
Vydavatel Microsoft

Známé problémy a omezení

  • Maximální velikost excelového souboru podporovaného konektorem Excelu Online (OneDrive) je 5 MB.
  • Data nemusí být aktuální (může dojít ke zpoždění) při filtrování nebo řazení v List rows present in a table akci.
  • Akce List rows present in a table podporuje základní filtrování a řazení:
    • Podporuje následující funkce filtru: eq, ne, contains, startswith, endswith.
    • U sloupce lze použít pouze 1 funkci filtru.
    • K řazení lze použít pouze 1 sloupec.
  • Akce List rows present in a table ve výchozím nastavení vrátí až 256 řádků. Pokud chcete získat všechny řádky, zapněte stránkování.
  • Excelový soubor může být na OneDrivu zamčený kvůli aktualizaci nebo odstranění až 12 minut od posledního použití konektoru.
  • Současné úpravy souborů provedené jinými konektory nebo ručními úpravami nejsou podporovány. Uživatelé by se měli vyhnout zápisu dat do jednoho excelového souboru z více klientů současně (DesktopOvá aplikace Excel, Excel Web, Power Automate, LogicApps nebo PowerApps). To může způsobit možné konflikty při slučování a nekonzistence dat.
  • Konektor podporuje soubory ve formátech Microsoft Excel Open XML Spreadsheet (*.xlsx) a Microsoft Excel Binary Workbook (.xlxb).
  • Konektor načte řádky pro maximálně 500 sloupců v List rows present in a table akci. Ve výchozím nastavení se vrátí řádky pro prvních 500 sloupců. Můžete zadat čárkami oddělený seznam konkrétních sloupců, které se mají načíst v parametru Select Query .
  • Konektor nepodporuje použití parametrů OData pro tabulky, které obsahují skryté sloupce.
  • K vypršení časového limitu spojnice způsobeného opakovanými výpočty může docházet buď ke složitým vzorcům, nebo je na listu příliš mnoho řádků. V obou případech je možné data vložit vícekrát kvůli zásadám opakování. Jako alternativní řešení se podívejte, jestli se dají vzorce zjednodušit nebo zmenšit. V opačném případě můžete pro tento sešit nastavit režim výpočtu na Ruční. Další podrobnosti najdete tady.
  • Pro všechny akce se vyžaduje přístup k zápisu k souboru, jinak by rozhraní Graph API vrátilo 403 Forbidden chybu. Konektor také vrátí 502 BadGateway chybu, pokud je tabulka v režimu jen pro čtení. Pokud chcete režim jen pro čtení zakázat, přečtěte si další informace tady.
  • Filter Query / Order By / Select Query parametry operace podporují pouze názvy alfanumerických sloupců.
  • Kontingenční tabulky nejsou podporované kvůli omezením rozhraní Graph API.
  • Pokud uživatel během krátkého časového období provede příliš mnoho požadavků, je možné získat odpověď 429. Omezení omezení je pro každý požadavek jedinečné a liší se v závislosti na počtu požadavků, využité paměti a dalších důležitých faktorech.
  • V operacích, jako Delete a rowje , pole key column je case-sensitive.
  • Vpřípaděch Update a rowDelete a row
  • Změny potvrzené operacemi, jako Create a rowje , Update a rowDelete a row ne vždy projeví okamžitě po úspěšné odpovědi z odpovídajících akcí Power Automate, LogicApps nebo Power Apps. Vzhledem k omezením základní back-endové služby se očekává zpoždění až 30 sekund.
  • Konektor může automaticky naplnit až 64 000 řádků, pokud Insert auto generated id into Excel table je během importu tabulky v PowerApps vybraná možnost.
  • Záhlaví sloupců tabulek, která obsahují pouze číslo, můžou způsobit neočekávané chování v operacích, jako Update a rowje například kvůli Delete a row omezením základní back-endové služby. Jako alternativní řešení přejmenujte tyto sloupce tak, aby obsahovaly i jiné znaky.
  • Soubor aplikace Excel může být změněn a nová verze může být viditelná v historii verzí souboru i v případě, že se spustí akce jen pro čtení. Toto chování je záměrně způsobené interními mechanismy ukládání back-endové služby konektoru.
  • Zašifrované nebo označené jako chráněné listy můžou vyvolat chybu poškozeného souboru, i když je možné soubor otevřít ručně.

Zpracování názvů sloupců

Upozorňujeme, že názvy sloupců ve výsledcích odpovědi akce se můžou transformovat, aby byly kompatibilní s formátem OData:

Znak Zakódovaná hodnota
. _x002e_
@ _x0040_
: _x003a_
# _x0023_

Např. Column [one]#1>Column [one]_x0023_1

Koncepty a příklady

  • Key column: sloupec v tabulce, který se použije k hledání hodnoty (key value)
  • Key value: hodnota v té key column , která se použije k identifikaci konkrétního řádku.

Jako příklad si vezměte následující tabulku. Chcete-li provést operaci řádku ve druhém řádku tabulky, key column měla by být Column 1 a key value měla by být 200.

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

Obecné limity

Název Hodnota
Maximální počet variant sloupců identity, které lze použít k získání, vložení, aktualizaci nebo odstranění řádku z jedné excelové tabulky. Aktuální hodnota je nastavená na hodnotu 2, což znamená, že pro jednu konkrétní tabulku by se měly používat až dvě varianty názvů sloupců. 2
Maximální počet řádků, které může spojnice naplnit automaticky, pokud je při importu tabulky v PowerApps vybrána možnost Vložit automaticky vygenerované ID do excelové tabulky. 64000

Limity omezování

Name Volání Období obnovení
Volání rozhraní API na připojení 100 60 sekund

Akce

Aktualizace řádky

Aktualizujte řádek pomocí klíčového sloupce. Vstupní hodnota přepíše zadané buňky a sloupce, které zůstanou prázdné, nebudou aktualizovány. Pokud chcete připojit (místo přepsání) hodnotu, použijte akci Získat řádek k načtení obsahu jako první.
Odstranit řádku

Odstraňte řádek pomocí klíčového sloupce.
Přidání klíčového sloupce do tabulky

Přidejte do excelové tabulky klíčový sloupec. Nový sloupec se připojí vpravo. Nový klíčový sloupec musí být v tabulce jedinečný.
Přidání řádku do tabulky

Přidejte do excelové tabulky nový řádek.
Přidání řádku do tabulky [ZASTARALÉ]

Tato akce je zastaralá. Místo toho přidejte řádek do tabulky .

Přidejte do excelové tabulky nový řádek.
Vytvoření listu

Vytvořte nový list v excelovém sešitu.
Vytvořit tabulku

Vytvořte novou tabulku v excelovém sešitu.
Výpis řádků, které jsou přítomné v tabulce

Vypsat řádky, které jsou přítomné v tabulce
Získání listů

Umožňuje získat seznam listů v excelovém sešitu.
Získání tabulek

Získejte seznam tabulek v excelovém sešitu.
Získání řádku

Získání řádku pomocí klíčového sloupce Tato akce načte všechny hodnoty zadaného řádku zadaného sloupce a klíčového sloupce.

Aktualizace řádky

ID operace:
PatchItem

Aktualizujte řádek pomocí klíčového sloupce. Vstupní hodnota přepíše zadané buňky a sloupce, které zůstanou prázdné, nebudou aktualizovány. Pokud chcete připojit (místo přepsání) hodnotu, použijte akci Získat řádek k načtení obsahu jako první.

Parametry

Name Klíč Vyžadováno Typ Description
File
 file True string

Vyberte excelový soubor prostřednictvím procházení souborů.
Table
 table True string

V rozevíracím seznamu vyberte tabulku.
Klíčový sloupec
 idColumn True string

V rozevíracím seznamu vyberte sloupec.
Hodnota klíče
 id True string

Zadejte hodnotu klíče.
Zadejte vlastnosti položky.
 item True dynamic

Zadejte vlastnosti položky.
Formát data a času
 dateTimeFormat string

Formát DateTime

Návraty

Výstupy této operace jsou dynamické.

Odstranit řádku

ID operace:
DeleteItem

Odstraňte řádek pomocí klíčového sloupce.

Parametry

Name Klíč Vyžadováno Typ Description
File
 file True string

Vyberte excelový soubor prostřednictvím procházení souborů.
Table
 table True string

V rozevíracím seznamu vyberte tabulku.
Klíčový sloupec
 idColumn True string

V rozevíracím seznamu vyberte sloupec.
Hodnota klíče
 id True string

Zadejte hodnotu klíče.

Přidání klíčového sloupce do tabulky

ID operace:
CreateIdColumn

Přidejte do excelové tabulky klíčový sloupec. Nový sloupec se připojí vpravo. Nový klíčový sloupec musí být v tabulce jedinečný.

Parametry

Name Klíč Vyžadováno Typ Description
File
 file True string

Vyberte excelový soubor prostřednictvím procházení souborů.
Table
 table True string

V rozevíracím seznamu vyberte tabulku.
Klíčový sloupec
 idColumn string

Zadejte název klíčového sloupce.

Přidání řádku do tabulky

ID operace:
AddRowV2

Přidejte do excelové tabulky nový řádek.

Parametry

Name Klíč Vyžadováno Typ Description
File
 file True string

Vyberte excelový soubor prostřednictvím procházení souborů.
Table
 table True string

V rozevíracím seznamu vyberte tabulku.
Row
 item True dynamic

Řádek, který chcete přidat do zadané excelové tabulky.
Formát data a času
 dateTimeFormat string

Formát DateTime

Návraty

Výstupy této operace jsou dynamické.

Přidání řádku do tabulky [ZASTARALÉ]

ID operace:
AddRow

Tato akce je zastaralá. Místo toho přidejte řádek do tabulky .

Přidejte do excelové tabulky nový řádek.

Parametry

Name Klíč Vyžadováno Typ Description
File
 file True string

Vyberte excelový soubor prostřednictvím procházení souborů.
Table
 table True string

V rozevíracím seznamu vyberte tabulku.
Row
 item True dynamic

Řádek, který chcete vložit do zadané excelové tabulky.

Vytvoření listu

ID operace:
CreateWorksheet

Vytvořte nový list v excelovém sešitu.

Parametry

Name Klíč Vyžadováno Typ Description
File
 file True string

Vyberte excelový soubor prostřednictvím procházení souborů.
Název
 name string

Název listu

Návraty

Body
WorksheetMetadata

Vytvořit tabulku

ID operace:
CreateTable

Vytvořte novou tabulku v excelovém sešitu.

Parametry

Name Klíč Vyžadováno Typ Description
File
 file True string

Vyberte excelový soubor prostřednictvím procházení souborů.
Název tabulky
 TableName string

Zadejte název excelové tabulky.
Oblast tabulky
 Range True string

Zadejte adresu tabulky pomocí zápisu A1.
Názvy sloupců
 ColumnsNames string

Zadejte názvy sloupců oddělených písmenem ;nebo ,.

Návraty

Metadata tabulky

Body
TableMetadata

Výpis řádků, které jsou přítomné v tabulce

ID operace:
GetItems

Vypsat řádky, které jsou přítomné v tabulce

Parametry

Name Klíč Vyžadováno Typ Description
File
 file True string

Vyberte excelový soubor prostřednictvím procházení souborů.
Table
 table True string

V rozevíracím seznamu vyberte tabulku.
Dotaz filtru
 $filter string

Dotaz filtru ODATA pro omezení vrácených položek.
Seřadit podle
 $orderby string

Dotaz ODATA orderBy pro zadání pořadí položek.
Nejvyšší počet
 $top integer

Celkový počet položek, které se mají načíst (výchozí = vše).
Přeskočit počet
 $skip integer

Počet položek, které se mají přeskočit (výchozí hodnota = 0).
Výběr dotazu
 $select string

Čárkami oddělený seznam sloupců, které se mají načíst (ve výchozím nastavení prvních 500).
Formát data a času
 dateTimeFormat string

Formát DateTime

Návraty

Výstupy této operace jsou dynamické.

Získání listů

ID operace:
GetAllWorksheets

Umožňuje získat seznam listů v excelovém sešitu.

Parametry

Name Klíč Vyžadováno Typ Description
File
 file True string

Vyberte excelový soubor prostřednictvím procházení souborů.

Návraty

Name Cesta Typ Description
value
 value array of WorksheetMetadata

Získání tabulek

ID operace:
GetTables

Získejte seznam tabulek v excelovém sešitu.

Parametry

Name Klíč Vyžadováno Typ Description
File
 file True string

Vyberte excelový soubor prostřednictvím procházení souborů.

Návraty

Name Cesta Typ Description
value
 value array of object
identifikační číslo
 value.id string

ID tabulky.
Název
 value.name string

Název tabulky
Zobrazit pruhované sloupce
 value.showBandedColumns boolean

Umožňuje zobrazit pruhované sloupce.
Zvýraznění prvního sloupce
 value.highlightFirstColumn boolean

Zvýrazněte první sloupec.
Zvýraznění posledního sloupce
 value.highlightLastColumn boolean

Zvýraznit poslední sloupec
Zobrazit pruhované řádky
 value.showBandedRows boolean

Zobrazit pruhované řádky
Tlačítko Zobrazit filtr
 value.showFilterButton boolean

Zobrazit tlačítko filtru
Zobrazit záhlaví
 value.showHeaders boolean

Zobrazit záhlaví
Zobrazit součty
 value.showTotals boolean

Zobrazit součty
Styl
 value.style string

Styl tabulky

Získání řádku

ID operace:
GetItem

Získání řádku pomocí klíčového sloupce Tato akce načte všechny hodnoty zadaného řádku zadaného sloupce a klíčového sloupce.

Parametry

Name Klíč Vyžadováno Typ Description
File
 file True string

Vyberte excelový soubor prostřednictvím procházení souborů.
Table
 table True string

V rozevíracím seznamu vyberte tabulku.
Klíčový sloupec
 idColumn True string

V rozevíracím seznamu vyberte sloupec.
Hodnota klíče
 id True string

Zadejte hodnotu klíče.
Formát data a času
 dateTimeFormat string

Formát DateTime

Návraty

Výstupy této operace jsou dynamické.

Definice

TableMetadata

Metadata tabulky

Name Cesta Typ Description
název
 name string

Název tabulky
title
 title string

Název tabulky
x-ms-permission
 x-ms-permission string

Oprávnění tabulky
x-ms-capabilities
 x-ms-capabilities TableCapabilitiesMetadata

Metadata pro tabulku (možnosti)
schéma
 schema Object
referencedEntities
 referencedEntities Object
webUrl
 webUrl string

Odkaz na adresu URL

TableCapabilitiesMetadata

Metadata pro tabulku (možnosti)

Name Cesta Typ Description
sortRestrictions
 sortRestrictions TableSortRestrictionsMetadata

Metadata pro tabulku (omezení řazení)
filterRestrictions
 filterRestrictions TableFilterRestrictionsMetadata

Metadata pro tabulku (omezení filtru)
selectRestrictions
 selectRestrictions TableSelectRestrictionsMetadata

Metadata pro tabulku (výběr omezení)
isOnlyServerPagable
 isOnlyServerPagable boolean

Omezení stránkování serveru
filterFunctionSupport
 filterFunctionSupport array of string

Seznam podporovaných možností filtru
serverPagingOptions
 serverPagingOptions array of string

Seznam podporovaných stránkování řízených serverem

Object

TableSortRestrictionsMetadata

Metadata pro tabulku (omezení řazení)

Name Cesta Typ Description
setříditelný
 sortable boolean

Určuje, jestli má tato tabulka seřazené sloupce.
unsortableProperties
 unsortableProperties array of string

Seznam neseřazených vlastností
ascendingOnlyProperties
 ascendingOnlyProperties array of string

Seznam vlastností, které podporují pouze vzestupné pořadí

TableFilterRestrictionsMetadata

Metadata pro tabulku (omezení filtru)

Name Cesta Typ Description
filtrovatelný
 filterable boolean

Určuje, jestli má tato tabulka filtrovatelné sloupce.
nonFilterableProperties
 nonFilterableProperties array of string

Seznam nefiltrovatelných vlastností
requiredProperties
 requiredProperties array of string

Seznam požadovaných vlastností

TableSelectRestrictionsMetadata

Metadata pro tabulku (výběr omezení)

Name Cesta Typ Description
volitelný
 selectable boolean

Určuje, jestli má tato tabulka sloupce s možností výběru.

WorksheetMetadata

Name Cesta Typ Description
identifikační číslo
 id string

ID listu.
Název
 name string

Název listu
Position
 position integer

Pozice listu
Viditelnost
 visibility string

Viditelnost listu