Compartilhar via

Excel Online (OneDrive)

O provedor de conexão do Excel Online (OneDrive) permite que você trabalhe com arquivos do Excel armazenados no OneDrive. Esse provedor de conexão só dá suporte a contas pessoais (MSA).

Esse conector está disponível nos seguintes produtos e regiões:

Service Class Regions
Copilot Studio Standard Todas as regiões do Power Automate , exceto as seguintes:
     - China Cloud operado pela 21Vianet
Aplicativos Lógicos Standard Todas as regiões de Aplicativos Lógicos
Power Apps - Não disponível
Power Automate Standard Todas as regiões do Power Automate , exceto as seguintes:
     - China Cloud operado pela 21Vianet
Metadados do conector
Publicador Microsoft

Problemas e limitações conhecidos

  • O tamanho máximo de um arquivo do Excel compatível com o conector do Excel Online (OneDrive) é de 5 MB.
  • Os dados podem não estar atualizados (pode haver algum atraso) quando a filtragem ou classificação é usada na ação List rows present in a table .
  • A List rows present in a table ação dá suporte à filtragem e à classificação básicas:
    • Dá suporte às seguintes funções de filtro: eq, ne, contains, startswith, endswith.
    • Somente uma função de filtro pode ser aplicada em uma coluna.
    • Somente 1 coluna pode ser usada para classificação.
  • A List rows present in a table ação retorna até 256 linhas por padrão. Para obter todas as linhas, ative a paginação.
  • Um arquivo do Excel pode ser bloqueado no OneDrive por uma atualização ou exclusão de até 12 minutos desde o último uso do conector.
  • Não há suporte para modificações simultâneas de arquivo feitas por outros conectores ou edições manuais. Os usuários devem evitar gravar dados em um único arquivo do Excel de vários clientes simultaneamente (Excel Desktop, Excel Web, Power Automate, LogicApps ou PowerApps). Isso pode causar possíveis conflitos de mesclagem e inconsistência de dados.
  • O conector dá suporte a arquivos nos formatos planilha Open XML do Microsoft Excel (*.xlsx) e pasta de trabalho binária do Microsoft Excel (.xlxb).
  • O conector recupera linhas no máximo 500 colunas na ação List rows present in a table . As linhas das primeiras 500 colunas são retornadas por padrão. Você pode fornecer uma lista separada por vírgulas de colunas específicas a serem recuperadas no Select Query parâmetro.
  • O conector não dá suporte ao uso de parâmetros OData para tabelas que contêm colunas ocultas.
  • O tempo limite do conector causado por re-cálculos pode ocorrer, ou há fórmulas complicadas ou há muitas linhas na planilha. Em ambos os casos, os dados podem ser inseridos várias vezes devido à política de repetição. Como solução alternativa, veja se as fórmulas podem ser simplificadas ou reduzidas. Caso contrário, você poderá definir o modo de cálculo dessa pasta de trabalho como Manual. Para obter mais detalhes, consulte aqui
  • O acesso de gravação a um arquivo é necessário para todas as ações, caso contrário, a API do Graph retornará 403 Forbidden o erro. Além disso, o conector retornará o 502 BadGateway erro se a planilha estiver em um modo somente leitura. Para desabilitar o modo somente leitura, saiba mais aqui.
  • Filter Query / Order By / Select Query os parâmetros de operação dão suporte apenas a nomes de coluna alfanumérica.
  • Não há suporte para tabelas dinâmicas devido às limitações da API do Graph.
  • Se um usuário fizer muitas solicitações em um curto período de tempo, será possível obter uma resposta 429. O limite de limitação é exclusivo para cada solicitação e varia de acordo com a contagem de solicitações, a memória usada e outros fatores importantes.
  • Em operações como Delete a row, o key column campo é case-sensitive.
  • No caso de várias correspondências em operações como Update a rowoperações Delete a row , somente a primeira linha será atualizada/excluída.
  • As alterações confirmadas por operações comoCreate a row, por exemplo, Update a rowDelete a row nem sempre afetam imediatamente após a resposta bem-sucedida de um Power Automate, LogicApps ou ações do Power Apps correspondentes. Atrasos de até 30 segundos são esperados devido a limitações de serviço de back-end subjacentes.
  • O conector poderá preencher até 6.4000 linhas automaticamente se Insert auto generated id into Excel table a opção for selecionada durante uma importação de tabela no PowerApps.
  • Cabeçalhos de coluna de tabelas que contêm apenas um número podem causar um comportamento inesperado em operações como Update a row, Delete a row devido a limitações de serviço de back-end subjacentes. Como solução alternativa, renomeie essas colunas para que elas também contenham outros caracteres.
  • Um arquivo do Excel pode ser modificado e uma nova versão pode estar visível no histórico de versão do arquivo mesmo quando uma ação "somente leitura" é executada. Esse comportamento é por design devido a mecanismos de salvamento internos do serviço de back-end do conector.
  • Exscriptografado ou marcado como planilhas protegidas, gere um erro de arquivo corrompido, mesmo que o arquivo possa ser aberto manualmente.

Tratamento de nomes de coluna

Observe que os nomes de coluna nos resultados de resposta da ação podem ser transformados para serem compatíveis com o formato OData:

Character Valor codificado
. _x002e_
@ _x0040_
: _x003a_
# _x0023_

Por exemplo, Column [one]#1 ->Column [one]_x0023_1

Conceitos e exemplos

  • Key column: coluna em uma tabela que será usada para pesquisar um valor (key value)
  • Key value: valor key column no que será usado para identificar uma linha específica.

Veja a tabela a seguir como um exemplo. Para executar uma operação de linha na segunda linha da tabela, o key column deve ser Column 1 e key value deve ser 200.

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

Limites Gerais

Nome Value
Número máximo de variantes de coluna de identidade que podem ser usadas para Obter/Inserir/Atualizar/Excluir uma linha de uma única tabela do Excel. O valor atual é definido como 2, o que significa que até duas variantes de nome de coluna devem estar em uso entre fluxos de trabalho para uma tabela específica. 2
Número máximo de linhas que o conector pode preencher automaticamente se 'Inserir id gerada automaticamente na opção de tabela do Excel' for selecionado durante uma importação de tabela no PowerApps. 64000

Limitações

Nome Chamadas Período de renovação
Chamadas à API por conexão 100 60 segundos

Ações

Adicionar uma coluna de chave a uma tabela

Adicione uma coluna de chave a uma tabela do Excel. A nova coluna será acrescentada à direita. A nova coluna de chave deve ser exclusiva na tabela.
Adicionar uma linha a uma tabela

Adicione uma nova linha à tabela do Excel.
Adicionar uma linha a uma tabela [PRETERIDA]

Esta ação foi preterida. Em vez disso, use Adicionar uma linha em uma tabela .

Adicione uma nova linha à tabela do Excel.
Atualizar uma linha

Atualize uma linha usando uma coluna de chave. O valor de entrada substituirá as células especificadas e as colunas deixadas em branco não serão atualizadas. Para acrescentar (em vez de substituir) um valor, use a ação "Obter uma linha" para recuperar o conteúdo primeiro.
Criar planilha

Crie uma nova planilha na pasta de trabalho do Excel.
Criar tabela

Crie uma nova tabela na pasta de trabalho do Excel.
Excluir uma linha

Exclua uma linha usando uma coluna de chave.
Listar linhas presentes em uma tabela

Listar linhas presentes em uma tabela.
Obter planilhas

Obtenha uma lista de planilhas na pasta de trabalho do Excel.
Obter tabelas

Obtenha uma lista de tabelas na pasta de trabalho do Excel.
Obter uma linha

Obtenha uma linha usando uma coluna de chave. Essa ação recuperará todos os valores da linha especificada, considerando uma coluna e uma coluna de chave.

Adicionar uma coluna de chave a uma tabela

ID da operação:
CreateIdColumn

Adicione uma coluna de chave a uma tabela do Excel. A nova coluna será acrescentada à direita. A nova coluna de chave deve ser exclusiva na tabela.

Parâmetros

Nome Chave Obrigatório Tipo Description
File
 file True string

Selecione um arquivo do Excel por meio da Procura de Arquivos.
Table
 table True string

Selecione uma tabela na lista suspensa.
Coluna de chave
 idColumn string

Forneça o nome da coluna de chave.

Adicionar uma linha a uma tabela

ID da operação:
AddRowV2

Adicione uma nova linha à tabela do Excel.

Parâmetros

Nome Chave Obrigatório Tipo Description
File
 file True string

Selecione um arquivo do Excel por meio da Procura de Arquivos.
Table
 table True string

Selecione uma tabela na lista suspensa.
Linha
 item True dynamic

Linha a ser adicionada à tabela especificada do Excel.
Formato DateTime
 dateTimeFormat string

Formato DateTime.

Retornos

As saídas desta operação são dinâmicas.

Adicionar uma linha a uma tabela [PRETERIDA]

ID da operação:
AddRow

Esta ação foi preterida. Em vez disso, use Adicionar uma linha em uma tabela .

Adicione uma nova linha à tabela do Excel.

Parâmetros

Nome Chave Obrigatório Tipo Description
File
 file True string

Selecione um arquivo do Excel por meio da Procura de Arquivos.
Table
 table True string

Selecione uma tabela na lista suspensa.
Linha
 item True dynamic

Linha a ser inserida na tabela especificada do Excel.

Atualizar uma linha

ID da operação:
PatchItem

Atualize uma linha usando uma coluna de chave. O valor de entrada substituirá as células especificadas e as colunas deixadas em branco não serão atualizadas. Para acrescentar (em vez de substituir) um valor, use a ação "Obter uma linha" para recuperar o conteúdo primeiro.

Parâmetros

Nome Chave Obrigatório Tipo Description
File
 file True string

Selecione um arquivo do Excel por meio da Procura de Arquivos.
Table
 table True string

Selecione uma tabela na lista suspensa.
Coluna de chave
 idColumn True string

Selecione uma coluna na lista suspensa.
Valor da chave
 id True string

Insira o valor da chave.
Fornecer as propriedades do item
 item True dynamic

Forneça as propriedades do item.
Formato DateTime
 dateTimeFormat string

Formato DateTime.

Retornos

As saídas desta operação são dinâmicas.

Criar planilha

ID da operação:
CreateWorksheet

Crie uma nova planilha na pasta de trabalho do Excel.

Parâmetros

Nome Chave Obrigatório Tipo Description
File
 file True string

Selecione um arquivo do Excel por meio da Procura de Arquivos.
Nome
 name string

Nome da planilha.

Retornos

Corpo
WorksheetMetadata

Criar tabela

ID da operação:
CreateTable

Crie uma nova tabela na pasta de trabalho do Excel.

Parâmetros

Nome Chave Obrigatório Tipo Description
File
 file True string

Selecione um arquivo do Excel por meio da Procura de Arquivos.
Nome da tabela
 TableName string

Insira o nome da tabela do Excel.
Intervalo de tabelas
 Range True string

Insira o endereço da tabela usando a notação A1.
Nomes de colunas
 ColumnsNames string

Insira os nomes de colunas separados por ';' ou ','.

Retornos

Metadados da tabela

Corpo
TableMetadata

Excluir uma linha

ID da operação:
DeleteItem

Exclua uma linha usando uma coluna de chave.

Parâmetros

Nome Chave Obrigatório Tipo Description
File
 file True string

Selecione um arquivo do Excel por meio da Procura de Arquivos.
Table
 table True string

Selecione uma tabela na lista suspensa.
Coluna de chave
 idColumn True string

Selecione uma coluna na lista suspensa.
Valor da chave
 id True string

Insira o valor da chave.

Listar linhas presentes em uma tabela

ID da operação:
GetItems

Listar linhas presentes em uma tabela.

Parâmetros

Nome Chave Obrigatório Tipo Description
File
 file True string

Selecione um arquivo do Excel por meio da Procura de Arquivos.
Table
 table True string

Selecione uma tabela na lista suspensa.
Filtrar Consulta
 $filter string

Uma consulta de filtro ODATA para restringir as entradas retornadas.
Ordenar por
 $orderby string

Uma consulta orderBy do ODATA para especificar a ordem das entradas.
Contagem superior
 $top integer

Número total de entradas a serem recuperadas (padrão = todas).
Ignorar Contagem
 $skip integer

O número de entradas a serem ignoradas (padrão = 0).
Selecionar Consulta
 $select string

Lista separada por vírgulas de colunas a serem recuperadas (primeiras 500 por padrão).
Formato DateTime
 dateTimeFormat string

Formato DateTime.

Retornos

As saídas desta operação são dinâmicas.

Obter planilhas

ID da operação:
GetAllWorksheets

Obtenha uma lista de planilhas na pasta de trabalho do Excel.

Parâmetros

Nome Chave Obrigatório Tipo Description
File
 file True string

Selecione um arquivo do Excel por meio da Procura de Arquivos.

Retornos

Nome Caminho Tipo Description
value
 value array of WorksheetMetadata

Obter tabelas

ID da operação:
GetTables

Obtenha uma lista de tabelas na pasta de trabalho do Excel.

Parâmetros

Nome Chave Obrigatório Tipo Description
File
 file True string

Selecione um arquivo do Excel por meio da Procura de Arquivos.

Retornos

Nome Caminho Tipo Description
value
 value array of object
ID
 value.id string

ID da tabela.
Nome
 value.name string

Nome da tabela.
Mostrar colunas em banda
 value.showBandedColumns boolean

Mostrar colunas em banda.
Realçar a primeira coluna
 value.highlightFirstColumn boolean

Realce a primeira coluna.
Realçar a última coluna
 value.highlightLastColumn boolean

Realce a última coluna.
Mostrar linhas em banda
 value.showBandedRows boolean

Mostrar linhas em banda.
Botão Mostrar filtro
 value.showFilterButton boolean

Botão Mostrar filtro.
Mostrar cabeçalhos
 value.showHeaders boolean

Mostrar cabeçalhos.
Mostrar totais
 value.showTotals boolean

Mostrar totais.
Estilo
 value.style string

Estilo de tabela.

Obter uma linha

ID da operação:
GetItem

Obtenha uma linha usando uma coluna de chave. Essa ação recuperará todos os valores da linha especificada, considerando uma coluna e uma coluna de chave.

Parâmetros

Nome Chave Obrigatório Tipo Description
File
 file True string

Selecione um arquivo do Excel por meio da Procura de Arquivos.
Table
 table True string

Selecione uma tabela na lista suspensa.
Coluna de chave
 idColumn True string

Selecione uma coluna na lista suspensa.
Valor da chave
 id True string

Insira o valor da chave.
Formato DateTime
 dateTimeFormat string

Formato DateTime.

Retornos

As saídas desta operação são dinâmicas.

Definições

TableMetadata

Metadados da tabela

Nome Caminho Tipo Description
nome
 name string

Nome da tabela
title
 title string

Título da tabela
permissão x-ms
 x-ms-permission string

Permissão de tabela
x-ms-capabilities
 x-ms-capabilities TableCapabilitiesMetadata

Metadados de uma tabela (funcionalidades)
esquema
 schema Object
referencedEntities
 referencedEntities Object
webUrl
 webUrl string

Link da URL

TableCapabilitiesMetadata

Metadados de uma tabela (funcionalidades)

Nome Caminho Tipo Description
sortRestrictions
 sortRestrictions TableSortRestrictionsMetadata

Metadados de uma tabela (restrições de classificação)
filterRestrictions
 filterRestrictions TableFilterRestrictionsMetadata

Metadados de uma tabela (restrições de filtro)
selectRestrictions
 selectRestrictions TableSelectRestrictionsMetadata

Metadados de uma tabela (selecionar restrições)
isOnlyServerPagable
 isOnlyServerPagable boolean

Restrições de paginação do servidor
filterFunctionSupport
 filterFunctionSupport array of string

Lista de recursos de filtro com suporte
serverPagingOptions
 serverPagingOptions array of string

Lista de recursos de paginação controlados pelo servidor com suporte

Object

TableSortRestrictionsMetadata

Metadados de uma tabela (restrições de classificação)

Nome Caminho Tipo Description
classificável
 sortable boolean

Indica se essa tabela tem colunas classificáveis
unsortableProperties
 unsortableProperties array of string

Lista de propriedades não variadas
ascendingOnlyProperties
 ascendingOnlyProperties array of string

Lista de propriedades que dão suporte apenas à ordem crescente

TableFilterRestrictionsMetadata

Metadados de uma tabela (restrições de filtro)

Nome Caminho Tipo Description
filterable
 filterable boolean

Indica se essa tabela tem colunas filtrantes
nonFilterableProperties
 nonFilterableProperties array of string

Lista de propriedades não filtradas
requiredProperties
 requiredProperties array of string

Lista de propriedades necessárias

TableSelectRestrictionsMetadata

Metadados de uma tabela (selecionar restrições)

Nome Caminho Tipo Description
selecionável
 selectable boolean

Indica se esta tabela tem colunas selecionáveis

WorksheetMetadata

Nome Caminho Tipo Description
ID
 id string

ID da planilha.
Nome
 name string

Nome da planilha.
Cargo
 position integer

Posição da planilha.
Visibilidade
 visibility string

Visibilidade da planilha.