Partilhar via

Excel Online (Negócios)

O conector do Excel Online (Empresas) permite-lhe trabalhar com ficheiros do Excel em bibliotecas de documentos suportadas pelo Microsoft Graph (OneDrive para Empresas, Sites do SharePoint e Grupos do Office 365).

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 , exceto as seguintes:
     - Regiões do Azure China
Aplicações Power Standard Todas as regiões do Power Apps , exceto as seguintes:
     - China Cloud operado pela 21Vianet
Automatize o poder Standard Todas as regiões do Power Automatic , exceto as seguintes:
     - China Cloud operado pela 21Vianet
Contato
Nome Excel Online (Negócios)
URL https://learn.microsoft.com/en-us/connectors/excelonlinebusiness/
Email idcknowledgeeco@microsoft.com
Metadados do conector
Editora Microsoft
Sítio Web https://products.office.com/excel
Política de privacidade https://privacy.microsoft.com/
Categorias IA; Inteligência de Negócios

Problemas conhecidos e limitações com ações

Breve descrição Operations Descrição longa
Dados desatualizados Listar linhas presentes em uma tabela Os dados podem não estar atualizados (pode haver algum atraso) quando a filtragem ou classificação é usada nas linhas de Lista presentes em uma ação de tabela.
Capacidades de filtragem Listar linhas presentes em uma tabela As linhas de lista presentes em uma ação de tabela oferecem suporte à filtragem e classificação básicas:
- Suporta as seguintes funções de filtro: eq, ne, contains, startswith, endswith.
- Apenas 1 função de filtro pode ser aplicada em uma coluna.
- Apenas 1 coluna pode ser usada para classificação.
Filtros empilhados Listar linhas presentes em uma tabela Quando um filtro é aplicado usando a ação Listar linhas presentes em uma tabela, ele será adicionado sobre os filtros existentes.
Filtros não empilhados Listar linhas presentes em uma tabela Se um filtro não for aplicado usando as linhas de lista presentes em uma ação de tabela, todos os filtros já definidos no arquivo do Excel serão ignorados. A ação recupera todas as linhas, independentemente de quaisquer filtros pré-existentes no Excel.
Paginação Listar linhas presentes em uma tabela As linhas de lista presentes em uma ação de tabela retornam até 256 linhas por padrão. Para obter todas as linhas, ative a paginação.
Selecionar linhas não sequenciais Listar linhas presentes em uma tabela O conector recupera linhas para no máximo 500 colunas nas linhas da Lista presentes em uma ação de tabela. 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 em um Select Query parâmetro.
Nome do campo da coluna principal Adicionar uma coluna chave a uma tabela
Excluir uma linha
Obter uma linha
Atualizar uma linha		 O campo da coluna principal diferencia maiúsculas de minúsculas.
Atualizar/excluir várias linhas Excluir uma linha
Atualizar uma linha		 No caso de várias correspondências em operações como Atualizar uma linha e Excluir uma linha, somente a primeira linha será atualizada/excluída.
Suporte a planilhas do Microsoft Excel Macro-Enabled Executar script A ação Executar script suporta adicionalmente o formato de folha de cálculo Macro-Enabled do Microsoft Excel (*.xlsm). Para saber mais, vá para Como usar arquivos de macro em fluxos do Power Automatic.
Limitação de cabeçalhos de colunas de tabela Adicionar uma linha
Atualizar uma linha
Excluir uma linha		 As alterações confirmadas por operações como Adicionar uma linha, Atualizar uma linha, Excluir uma linha 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.
Executar limitações de operação de script Executar script A operação de script Run permite até 3 chamadas por 10 segundos e até 1600 chamadas por dia.
Executar operação de script suporte a nuvens soberanas Executar script A operação de script de execução NÃO está disponível em nuvens soberanas (incluindo Gcc, GccHigh, DoD e outras nuvens superiores).

Erros comuns

Erro Solução
403 Proibido Verifique se o arquivo tem acesso de gravação.
502 BadGateway Esses erros serão exibidos se a planilha estiver no modo somente leitura. Para saber mais sobre como desativar o modo somente leitura, vá para Alterar uma planilha do Excel de somente leitura.
429 Demasiados pedidos Isso acontece se um usuário fizer muitas solicitações em um curto período de tempo. 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. Se a limitação estiver ocorrendo, sugere-se adicionar atrasos explícitos em torno da ação do conector.
Devido aos limites de limitação na API do Graph, isso também pode acontecer devido a vários motivos:
1. Quando a contagem de solicitações globais do Fluxo exceder um limite, algumas solicitações serão limitadas. Quais solicitações são limitadas e quais não são escolhidas aleatoriamente pela solução de limitação do Azure.
2. Mesmo que não tenha atingido o limite em #1, ainda pode ser acelerado devido a diferentes razões. Abaixo estão as razões mais comuns para a limitação:
a. Pressione a política de limitação do serviço do Sharepoint.
b) Pressione a política de serviço do Excel Online, por exemplo, a fila de operações estava cheia devido a muitas solicitações.
c. A solicitação está pendente na fila por mais tempo do que o esperado. Por exemplo, solicitações que estão demorando mais de 30s podem retornar 504 e continuar 504 resultaria em limitação.
d. Muitas falhas consecutivas em uma sessão de pasta de trabalho.
e. Quando uma solicitação é feita para OfficeScripting na ID de operação "RunScriptProd" , e se essas solicitações são mais de 3 dentro de 10 segundos, então ele é limitado.

Problemas e limitações gerais conhecidos

  • O tamanho máximo de um ficheiro Excel suportado pelo conector do Excel Online (Empresas) é de 25 MB.
  • Um arquivo do Excel pode ser bloqueado para uma atualização ou excluir até 6 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 Power Apps). 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).
  • A File propriedade esperada pelas ações do conector deve ser preenchida usando uma das seguintes opções:
    • Escolha um arquivo no seletor de arquivos.
    • Use uma saída dos disparadores/ações do conector do OneDrive for Business (arquivo Id ou File identifier propriedade, dependendo de qual deles está presente para a ação ou gatilho específico do OneDrive for Business).
    • Use uma saída dos gatilhos/ações do conector do SharePoint (arquivo Id ou Identifier propriedade, dependendo de qual deles está presente para a ação ou gatilho específico do Sharepoint).
    • Insira o caminho para o arquivo a partir do Drive. Examples:
      • Se o arquivo estiver no OneDrive e o caminho completo for OneDrive/file.xlsx e o parâmetro Drive for OneDrive, a entrada file.xlsx.
      • Se o arquivo estiver em Grupos do O365 e o caminho completo for Documentos/Documentos internos/file.xlsx e o parâmetro Drive for Documents, insira Documentos internos/file.xlsx.
  • 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 se houver fórmulas complicadas ou se houver 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.
  • Filter Query / Order By / Select Query Os parâmetros de operação suportam apenas nomes de colunas alfanuméricas.
  • As tabelas dinâmicas não são suportadas devido a limitações da API do Graph.
  • O conector sempre retorna todas as bibliotecas de documentos disponíveis sob o controle suspenso Biblioteca de Documentos. Para a maioria dos usuários, apenas uma biblioteca de documentos será retornada, mas se houver várias disponíveis, todas elas serão listadas. Para saber mais sobre a biblioteca de documentos (por exemplo, recursos de unidade) e o comportamento esperado para usuários, Grupos e Sites, vá para Listar unidades - Observações.
  • O conector pode preencher até 64.000 linhas automaticamente se a opção Inserir id gerado automaticamente na tabela do Excel estiver selecionada durante uma importação de tabela no Power Apps.
  • Os cabeçalhos de coluna de tabelas que contêm apenas um número podem causar um comportamento inesperado em operações como Atualizar uma linha, Excluir uma linha 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.
  • Os usuários convidados não poderão obter acesso ao documento se forem de um locatário diferente dos usuários principais. Nesse caso, o usuário receberá um erro HTTP 404 (Não encontrado).
  • No Fairfax Logic Apps, esse conector suporta apenas conexões usando uma conta comercial (.com).
  • Os arquivos do SharePoint podem não estar disponíveis. A API do Graph não passa o endereço IP do usuário para o SharePoint. Portanto, se uma política baseada em local estiver habilitada, o SharePoint não poderá determinar se o usuário está dentro do limite confiável. Por esse motivo, ao acessar a biblioteca do SharePoint, você pode receber um erro "Devido a políticas organizacionais, você não pode acessar esses recursos deste local de rede". Para mais detalhes, consulte aqui.
  • O seletor de arquivos exibirá apenas até 200 itens por pasta. Os usuários podem ter problemas para encontrar itens se tiverem mais de 200 itens em uma pasta.
  • Se houver erros contínuos 504, os clientes podem enfrentar limitação devido a diferentes restrições da API do Graph. Abaixo estão algumas sugestões para reduzir 504 para operações de longa duração:
    • Atualize a tabela para que seja o mais simples possível com menos fórmulas e dependências.
    • Use outra planilha/pasta de trabalho vazia com o mesmo formato de tabela se a contagem de linhas for grande.
  • 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.
  • O tamanho máximo suportado de cada solicitação de conector é de 5 MB.

Tratamento de nomes de colunas

Os nomes das colunas nos resultados de 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

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

Conceitos e exemplos

  • Coluna principal: Coluna em uma tabela que será usada para pesquisar um valor (valor de chave).
  • Valor-chave: Valor na coluna de chave que será usada para identificar uma linha específica.

A tabela a seguir é um exemplo. Para executar uma operação de linha na segunda linha da tabela, o key column deve ser e key value deve ser Column 1200.

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

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

Executa um script do Office em uma pasta de trabalho do Excel. Use esta ação quando o script for salvo no local padrão.
Executar script a partir da biblioteca do SharePoint

Executa um script do Office em uma pasta de trabalho do Excel. Use essa ação quando o script for salvo fora do local padrão.
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.

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.

Parâmetros

Name Chave Necessário Tipo Description
Localização
 source True string

Selecione na lista suspensa ou especifique uma das seguintes opções: - "me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (os dois pontos são obrigatórios).
Biblioteca de documentos
 drive True string

Selecione uma biblioteca de documentos na lista suspensa.
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
Localização
 source True string

Selecione na lista suspensa ou especifique uma das seguintes opções: - "eu" - "URL do site do SharePoint" - "UPN de usuários/alguém" - "grupos/ID do grupo" - "sites/URL do site do SharePoint:/teams/team name:" (dois pontos são necessários).
Biblioteca de documentos
 drive True string

Selecione uma biblioteca de documentos na lista suspensa.
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
Localização
 source True string

Selecione na lista suspensa ou especifique uma das seguintes opções: - "eu" - "URL do site do SharePoint" - "UPN de usuários/alguém" - "grupos/ID do grupo" - "sites/URL do site do SharePoint:/teams/team name:" (dois pontos são necessários).
Biblioteca de documentos
 drive True string

Selecione uma biblioteca de documentos na lista suspensa.
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
Localização
 source True string

Selecione na lista suspensa ou especifique uma das seguintes opções: - "eu" - "URL do site do SharePoint" - "UPN de usuários/alguém" - "grupos/ID do grupo" - "sites/SharePoint URL do site:/teams/team name:" (os dois pontos são obrigatórios)
Biblioteca de documentos
 drive True string

Selecione uma biblioteca de documentos na lista suspensa.
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
Localização
 source True string

Selecione na lista suspensa ou especifique uma das seguintes opções: - "eu" - "URL do site do SharePoint" - "UPN de usuários/alguém" - "grupos/ID do grupo" - "sites/URL do site do SharePoint:/teams/team name:" (dois pontos são necessários).
Biblioteca de documentos
 drive True string

Selecione uma biblioteca de documentos na lista suspensa.
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
Localização
 source True string

Selecione na lista suspensa ou especifique uma das seguintes opções: - "me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (os dois pontos são obrigatórios).
Biblioteca de documentos
 drive True string

Selecione uma biblioteca de documentos na lista suspensa.
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
Localização
 source True string

Selecione na lista suspensa ou especifique uma das seguintes opções: - "eu" - "URL do site do SharePoint" - "UPN de usuários/alguém" - "grupos/ID do grupo" - "sites/SharePoint URL do site:/teams/team name:" (os dois pontos são obrigatórios)
Biblioteca de documentos
 drive True string

Selecione uma biblioteca de documentos na lista suspensa.
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.

Executar script

ID da Operação:
RunScriptProd

Executa um script do Office em uma pasta de trabalho do Excel. Use esta ação quando o script for salvo no local padrão.

Parâmetros

Name Chave Necessário Tipo Description
Localização
 source True string

Selecione na lista suspensa ou especifique uma das seguintes opções: - "eu" - "URL do site do SharePoint" - "UPN de usuários/alguém" - "grupos/ID do grupo" - "sites/URL do site do SharePoint:/teams/team name:" (dois pontos são necessários).
Biblioteca de documentos
 drive True string

Selecione uma biblioteca de documentos na lista suspensa.
Ficheiro
 file True string

Selecione um arquivo do Excel através de Procurar arquivo.
Script
 scriptId True string

Selecione o Script do Office que deseja executar na lista suspensa.
ScriptParameters
 ScriptParameters True dynamic

Forneça os parâmetros do Office Script.

Devoluções

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

Executar script a partir da biblioteca do SharePoint

ID da Operação:
RunScriptProdV2

Executa um script do Office em uma pasta de trabalho do Excel. Use essa ação quando o script for salvo fora do local padrão.

Parâmetros

Name Chave Necessário Tipo Description
Local da pasta de trabalho
 source True string

Selecione na lista suspensa ou especifique uma das seguintes opções: - "eu" - "URL do site do SharePoint" - "UPN de usuários/alguém" - "grupos/ID do grupo" - "sites/URL do site do SharePoint:/teams/team name:" (dois pontos são necessários).
Biblioteca de pastas de trabalho
 drive True string

Selecione uma biblioteca de documentos na lista suspensa.
Pasta de trabalho
 file True string

Selecione uma pasta de trabalho do Excel por meio de Procurar Arquivo.
Localização do script
 scriptSource True string

Selecione na lista suspensa ou especifique uma das seguintes opções: - "me" - "SharePoint Site URL" - "users/someone's UPN" - "groups/group Id" - "sites/SharePoint Site URL:/teams/team name:" (os dois pontos são obrigatórios).
Biblioteca de Scripts
 scriptDrive True string

Selecione a biblioteca do SharePoint do seu arquivo de Script do Office (.osts) na lista suspensa.
Script
 scriptId True string

Selecione um arquivo de Script do Office (.osts) em uma biblioteca do SharePoint na lista suspensa.
ScriptParameters
 ScriptParameters True dynamic

Forneça parâmetros para o Script do Office.

Devoluções

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

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
Localização
 source True string

Selecione na lista suspensa ou especifique uma das seguintes opções: - "eu" - "URL do site do SharePoint" - "UPN de usuários/alguém" - "grupos/ID do grupo" - "sites/SharePoint URL do site:/teams/team name:" (os dois pontos são obrigatórios)
Biblioteca de documentos
 drive True string

Selecione uma biblioteca de documentos na lista suspensa.
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.
Rótulo de sensibilidade do extrato
 extractSensitivityLabel boolean

Um booleano se deve extrair o rótulo de sensibilidade Id para artefato associado.
Metadados do rótulo de sensibilidade
 fetchSensitivityLabelMetadata boolean

Um booleano se deve buscar metadados de rótulo de sensibilidade para LabelId associado.

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
Localização
 source True string

Selecione na lista suspensa ou especifique uma das seguintes opções: - "eu" - "URL do site do SharePoint" - "UPN de usuários/alguém" - "grupos/ID do grupo" - "sites/URL do site do SharePoint:/teams/team name:" (dois pontos são necessários).
Biblioteca de documentos
 drive True string

Selecione uma biblioteca de documentos na lista suspensa.
Ficheiro
 file True string

Selecione um arquivo do Excel através de Procurar arquivo.
Rótulo de sensibilidade do extrato
 extractSensitivityLabel boolean

Um booleano se deve extrair o rótulo de sensibilidade Id para artefato associado.
Metadados do rótulo de sensibilidade
 fetchSensitivityLabelMetadata boolean

Um booleano se deve buscar metadados de rótulo de sensibilidade para LabelId associado.

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.
sensibilidadeLabelInfo
 sensitivityLabelInfo array of SensitivityLabelMetadata

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
Localização
 source True string

Selecione na lista suspensa ou especifique uma das seguintes opções: - "eu" - "URL do site do SharePoint" - "UPN de usuários/alguém" - "grupos/ID do grupo" - "sites/URL do site do SharePoint:/teams/team name:" (dois pontos são necessários).
Biblioteca de documentos
 drive True string

Selecione uma biblioteca de documentos na lista suspensa.
Ficheiro
 file True string

Selecione um arquivo do Excel através de Procurar arquivo.
Rótulo de sensibilidade do extrato
 extractSensitivityLabel boolean

Um booleano se deve extrair o rótulo de sensibilidade Id para artefato associado.
Metadados do rótulo de sensibilidade
 fetchSensitivityLabelMetadata boolean

Um booleano se deve buscar metadados de rótulo de sensibilidade para LabelId associado.

Devoluções

Name Caminho Tipo Description
valor
 value array of WorksheetMetadata
sensibilidadeLabelInfo
 sensitivityLabelInfo array of SensitivityLabelMetadata

Obter uma linha

ID da Operação:
GetItem

Obtenha uma linha usando uma coluna de chave.

Parâmetros

Name Chave Necessário Tipo Description
Localização
 source True string

Selecione na lista suspensa ou especifique uma das seguintes opções: - "eu" - "URL do site do SharePoint" - "UPN de usuários/alguém" - "grupos/ID do grupo" - "sites/SharePoint URL do site:/teams/team name:" (os dois pontos são obrigatórios)
Biblioteca de documentos
 drive True string

Selecione uma biblioteca de documentos na lista suspensa.
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.
Rótulo de sensibilidade do extrato
 extractSensitivityLabel boolean

Um booleano se deve extrair o rótulo de sensibilidade Id para artefato associado.
Metadados do rótulo de sensibilidade
 fetchSensitivityLabelMetadata boolean

Um booleano se deve buscar metadados de rótulo de sensibilidade para LabelId associado.

Devoluções

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

Acionadores

Para uma linha selecionada

Aciona um fluxo para uma linha selecionada em uma tabela do Excel. (Disponível apenas para Power Automate.)

Para uma linha selecionada

ID da Operação:
OnRowSelected

Aciona um fluxo para uma linha selecionada em uma tabela do Excel. (Disponível apenas para Power Automate.)

Parâmetros

Name Chave Necessário Tipo Description
operationId
 operationId True string
alojar
 host object
parameters
 parameters True object
esquema
 schema True object
headersSchema
 headersSchema object

Devoluções

Name Caminho Tipo Description
linhas
 body.rows array of object
items
 body.rows object
ID do utilizador
 headers.x-ms-user-id-encoded guid

O identificador exclusivo do utilizador que acionou o fluxo no AAD.
E-mail de utilizador
 headers.x-ms-user-email-encoded byte

O endereço de e-mail do utilizador que acionou o fluxo.
Nome de utilizador
 headers.x-ms-user-name-encoded byte

O nome a apresentar do utilizador que acionou o fluxo.
Data e Hora
 headers.x-ms-user-timestamp string

A hora a que o fluxo foi acionado.

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.

SensitivityLabelMetadata

Name Caminho Tipo Description
sensibilidadeLabelId
 sensitivityLabelId string

ID SensitivityLabel.
nome
 name string

Nome SensitivityLabel.
nome de exibição
 displayName string

SensitivityLabel displayName info
descrição
 tooltip string

Detalhes do SensitivityLabel na dica de ferramenta.
priority
 priority integer

Prioridade SensitivityLabel.
color
 color string

Cor SensitivityLabel.
éEncriptado
 isEncrypted boolean

é SensitivityLabel Encrypted.
isEnabled
 isEnabled boolean

Se SensitivityLabel está habilitado.
isParent
 isParent boolean

Se SensitivityLabel é pai.
parentSensitivityLabelId
 parentSensitivityLabelId string

ID do SensitivityLabel pai.