Excel Online (OneDrive)

O provedor de conexão do Excel Online (OneDrive) permite que você trabalhe com arquivos do Excel armazenados no OneDrive. Este fornecedor de ligação suporta apenas contas pessoais (MSA).

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

Serviço	Class	Regiões
Estúdio Copiloto	Standard	Todas as regiões do Power Automatic , exceto as seguintes:      - China Cloud operado pela 21Vianet
Aplicações Lógicas	Standard	Todas as regiões do Logic Apps
Aplicações Power	-	Não disponível
Automatize o poder	Standard	Todas as regiões do Power Automatic , exceto as seguintes:      - China Cloud operado pela 21Vianet

Metadados do conector
Editora	Microsoft

Problemas conhecidos e limitações

• O tamanho máximo de um ficheiro Excel suportado pelo 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 List rows present in a table é usada na ação.
• A List rows present in a table ação suporta filtragem e classificação básicas:
  • Suporta as seguintes funções de filtro: eq, ne, contém, startswith, endswith.
  • Apenas 1 função de filtro pode ser aplicada em uma coluna.
  • Apenas 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 para uma atualização ou excluir até 12 minutos desde o último uso do conector.
• Não há suporte para modificações simultâneas de arquivos 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 suporta arquivos nos formatos de planilha Microsoft Excel Open XML (*.xlsx) e pasta de trabalho binária do Microsoft Excel (.xlxb).
• O conector recupera linhas para no máximo 500 colunas na List rows present in a table ação. 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 para recuperar no Select Query parâmetro.
• O conector não suporta o uso de parâmetros OData para tabelas que contêm colunas ocultas.
• O tempo limite do conector causado por recálculos pode ocorrer, 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 novas tentativas. Como solução alternativa, verifique se as fórmulas podem ser simplificadas ou reduzidas. Caso contrário, você pode definir o modo de cálculo para esta pasta de trabalho como Manual. Para 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 retornaria 403 Forbidden o erro. Além disso, o conector retornará o 502 BadGateway erro se a planilha estiver em um modo somente leitura. Para desativar o modo somente leitura, saiba mais aqui.
• Filter Query / Order By / Select Query Os parâmetros de operação suportam apenas nomes de colunas alfanuméricas.
• Não há suporte para tabelas dinâmicas devido a limitações da API do Graph.
• Se um usuário fizer muitas solicitações em um curto período de tempo, é possível obter uma resposta 429. O limite de limitação é exclusivo para cada solicitação e varia com base na contagem de solicitações, memória usada e outros fatores importantes.
• Em operações como Delete a row, o key column campo é case-sensitive.
• No caso de múltiplas correspondências em operações como Update a row, Delete a row operações, apenas a primeira linha será atualizada/excluída.
• As alterações confirmadas por operações como Create a row, Update a row, Delete a row nem sempre entram em vigor imediatamente após a resposta bem-sucedida de uma ação correspondente do Power Automate, LogicApps ou Power Apps. São esperados atrasos de até 30 segundos devido a limitações subjacentes do serviço de back-end.
• O conector pode preencher até 64000 linhas automaticamente se Insert auto generated id into Excel table a opção for selecionada durante a importação de uma tabela no PowerApps.
• Os 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 subjacentes do serviço de back-end. 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 ser visível no histórico de versões do arquivo, mesmo quando uma ação "somente leitura" é executada. Esse comportamento é por design devido a mecanismos internos de salvamento do serviço de back-end do conector.
• Criptografado ou marcado como folhas protegidas, lance um erro de arquivo corrompido, mesmo que o arquivo possa ser aberto manualmente.

Tratamento de nomes de colunas

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

Personagem	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 no key column que será usado para identificar uma linha específica.

Tome a tabela a seguir como 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	Valor
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 em fluxos de trabalho para uma tabela específica.	2
Número máximo de linhas que o conector pode preencher automaticamente se a opção 'Inserir id gerado automaticamente na tabela do Excel' for selecionada durante uma importação de tabela no PowerApps.	64000

Limites de Limitação

Name	Chamadas	Período de Renovação
Chamadas de API por conexão	100	60 segundos

Ações

Adicionar uma coluna chave a uma tabela	Adicione uma coluna chave a uma tabela do Excel. A nova coluna será anexada à 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 [DEPRECATED]	Esta ação foi preterida. Em vez disso, use Adicionar uma linha a 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.
Eliminar uma linha	Exclua uma linha usando uma coluna de chave.
Listar linhas presentes em uma tabela	Listar linhas presentes em uma tabela.
Obter mesas	Obtenha uma lista de tabelas na pasta de trabalho do Excel.
Obter planilhas	Obtenha uma lista de planilhas na pasta de trabalho do Excel.
Obter uma linha	Obtenha uma linha usando uma coluna de chave. Esta ação recuperará todos os valores da linha especificada dada uma coluna e coluna chave.

Adicionar uma coluna chave a uma tabela

ID da Operação:

CreateIdColumn

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

Parâmetros

Name	Chave	Necessário	Tipo	Description
Ficheiro	file	True	string	Selecione um arquivo do Excel através de Procurar arquivo.
Table	table	True	string	Selecione uma tabela na lista suspensa.
Coluna 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

Name	Chave	Necessário	Tipo	Description
Ficheiro	file	True	string	Selecione um arquivo do Excel através de Procurar arquivo.
Table	table	True	string	Selecione uma tabela na lista suspensa.
Row	item	True	dynamic	Linha a ser adicionada à tabela do Excel especificada.
Formato DateTime	dateTimeFormat		string	Formato DateTime.

Devoluções

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

Adicionar uma linha a uma tabela [DEPRECATED]

ID da Operação:

AddRow

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

Adicione uma nova linha à tabela do Excel.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Ficheiro	file	True	string	Selecione um arquivo do Excel através de Procurar arquivo.
Table	table	True	string	Selecione uma tabela na lista suspensa.
Row	item	True	dynamic	Linha a inserir na tabela do Excel especificada.

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

Name	Chave	Necessário	Tipo	Description
Ficheiro	file	True	string	Selecione um arquivo do Excel através de Procurar arquivo.
Table	table	True	string	Selecione uma tabela na lista suspensa.
Coluna Chave	idColumn	True	string	Selecione uma coluna na lista suspensa.
Valor-chave	id	True	string	Insira o valor da chave.
Forneça as propriedades do item	item	True	dynamic	Forneça as propriedades do item.
Formato DateTime	dateTimeFormat		string	Formato DateTime.

Devoluções

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

Name	Chave	Necessário	Tipo	Description
Ficheiro	file	True	string	Selecione um arquivo do Excel através de Procurar arquivo.
Nome	name		string	Nome da planilha.

Devoluções

Body

WorksheetMetadata

Criar tabela

ID da Operação:

CreateTable

Crie uma nova tabela na pasta de trabalho do Excel.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Ficheiro	file	True	string	Selecione um arquivo do Excel através de Procurar arquivo.
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 das colunas	ColumnsNames		string	Insira os nomes das colunas separados por ';' ou ','.

Devoluções

Metadados de tabelas

Body

TableMetadata

Eliminar uma linha

ID da Operação:

DeleteItem

Exclua uma linha usando uma coluna de chave.

Parâmetros

Name	Chave	Necessário	Tipo	Description
Ficheiro	file	True	string	Selecione um arquivo do Excel através de Procurar arquivo.
Table	table	True	string	Selecione uma tabela na lista suspensa.
Coluna Chave	idColumn	True	string	Selecione uma coluna na lista suspensa.
Valor-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

Name	Chave	Necessário	Tipo	Description
Ficheiro	file	True	string	Selecione um arquivo do Excel através de Procurar arquivo.
Table	table	True	string	Selecione uma tabela na lista suspensa.
Filtrar consulta	$filter		string	Uma consulta de filtro ODATA para restringir as entradas retornadas.
Encomendar por	$orderby		string	Uma ordem ODATAPor consulta para especificar a ordem das entradas.
Contagem superior	$top		integer	Número total de entradas a recuperar (padrão = todas).
Pular contagem	$skip		integer	O número de entradas a serem ignoradas (padrão = 0).
Selecionar consulta	$select		string	Lista de colunas separadas por vírgulas para recuperar (primeiras 500 por padrão).
Formato DateTime	dateTimeFormat		string	Formato DateTime.

Devoluções

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

Obter mesas

ID da Operação:

GetTables

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

Parâmetros

Name	Chave	Necessário	Tipo	Description
Ficheiro	file	True	string	Selecione um arquivo do Excel através de Procurar arquivo.

Devoluções

Name	Caminho	Tipo	Description
valor	value	array of object
Id	value.id	string	Id da tabela.
Nome	value.name	string	Nome da tabela.
Mostrar colunas com faixas	value.showBandedColumns	boolean	Mostrar colunas com bandas.
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 com bandas	value.showBandedRows	boolean	Mostrar linhas com bandas.
Mostrar botão de filtro	value.showFilterButton	boolean	Mostrar botão de filtro.
Mostrar cabeçalhos	value.showHeaders	boolean	Mostrar cabeçalhos.
Mostrar totais	value.showTotals	boolean	Mostrar totais.
Estilo	value.style	string	Estilo da tabela.

Obter planilhas

ID da Operação:

GetAllWorksheets

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

Parâmetros

Name	Chave	Necessário	Tipo	Description
Ficheiro	file	True	string	Selecione um arquivo do Excel através de Procurar arquivo.

Devoluções

Name	Caminho	Tipo	Description
valor	value	array of WorksheetMetadata

Obter uma linha

ID da Operação:

GetItem

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

Parâmetros

Name	Chave	Necessário	Tipo	Description
Ficheiro	file	True	string	Selecione um arquivo do Excel através de Procurar arquivo.
Table	table	True	string	Selecione uma tabela na lista suspensa.
Coluna Chave	idColumn	True	string	Selecione uma coluna na lista suspensa.
Valor-chave	id	True	string	Insira o valor da chave.
Formato DateTime	dateTimeFormat		string	Formato DateTime.

Devoluções

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

Definições

TableMetadata

Metadados de tabelas

Name	Caminho	Tipo	Description
nome	name	string	Nome da tabela
title	title	string	Título da tabela
x-ms-permissão	x-ms-permission	string	Permissão de tabela
x-ms-capabilities	x-ms-capabilities	TableCapabilitiesMetadata	Metadados para uma tabela (capacidades)
esquema	schema	Object
referencedEntities	referencedEntities	Object
webUrl	webUrl	string	Link url

TableCapabilitiesMetadata

Metadados para uma tabela (capacidades)

Name	Caminho	Tipo	Description
sortRestrições	sortRestrictions	TableSortRestrictionsMetadata	Metadados de uma tabela (restrições de classificação)
filterRestrições	filterRestrictions	TableFilterRestrictionsMetadata	Metadados de uma tabela (restrições de filtro)
selecionarRestrições	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 suportados
serverPagingOptions	serverPagingOptions	array of string	Lista de recursos de paginação controlados por servidor suportados

Objeto

TableSortRestrictionsMetadata

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

Name	Caminho	Tipo	Description
ordenável	sortable	boolean	Indica se esta tabela tem colunas classificáveis
unsortableProperties	unsortableProperties	array of string	Lista de propriedades não classificáveis
ascendingOnlyProperties	ascendingOnlyProperties	array of string	Lista de propriedades que suportam apenas ordem crescente

TableFilterRestrictionsMetadata

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

Name	Caminho	Tipo	Description
filtrável	filterable	boolean	Indica se esta tabela tem colunas filtráveis
nonFilterableProperties	nonFilterableProperties	array of string	Lista de propriedades não filtráveis
requiredPropriedades	requiredProperties	array of string	Lista de propriedades necessárias

TableSelectRestrictionsMetadata

Metadados de uma tabela (selecionar restrições)

Name	Caminho	Tipo	Description
selecionável	selectable	boolean	Indica se esta tabela tem colunas selecionáveis

WorksheetMetadata

Name	Caminho	Tipo	Description
Id	id	string	ID da planilha.
Nome	name	string	Nome da planilha.
Position	position	integer	Posição da planilha.
Visibilidade	visibility	string	Visibilidade da planilha.