Compartilhar via

Excel Online (Negócios)

O conector do Excel Online (Business) permite que você trabalhe com arquivos do Excel em bibliotecas de documentos compatíveis com o Microsoft Graph (OneDrive for Business, Sites do SharePoint e Grupos do Office 365).

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 dos Aplicativos Lógicos , exceto as seguintes:
     - Regiões do Azure China
Power Apps Standard Todas as regiões do Power Apps , exceto as seguintes:
     - China Cloud operado pela 21Vianet
Power Automate Standard Todas as regiões do Power Automate , exceto as seguintes:
     - China Cloud operado pela 21Vianet
Contato
Nome Excel Online (Negócios)
URL https://v4.hkg1.meaqua.org/en-us/connectors/excelonlinebusiness/
Email idcknowledgeeco@microsoft.com
Metadados do conector
Publicador Microsoft
Site https://products.office.com/excel
Política de privacidade https://privacy.microsoft.com/
Categorias IA; Business Intelligence

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

Descrição curta 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 lista presentes em uma ação de tabela.
Recursos de filtragem Listar linhas presentes em uma tabela As linhas de lista presentes em uma ação de tabela dão 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.
Filtros empilhados Listar linhas presentes em uma tabela Quando um filtro é aplicado usando as linhas de lista de ações 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 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 o máximo de 500 colunas nas linhas De 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 a serem recuperadas em um Select Query parâmetro.
Nome do campo de coluna de chave Adicionar uma coluna de chave a uma tabela
Excluir uma linha
Obter uma linha
Atualizar uma linha		 O campo de coluna de chave 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 à Planilha de Macro-Enabled do Microsoft Excel Executar script Além disso, a ação Executar script dá suporte ao formato planilha de Macro-Enabled do Microsoft Excel (*.xlsm). Para saber mais, acesse Como usar arquivos de macro nos fluxos do Power Automate.
Limitação de cabeçalhos de coluna 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 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.
Executar limitações de operação de script Executar script A operação executar script permite até 3 chamadas por 10 segundos e até 1600 chamadas por dia.
Executar suporte a nuvens soberanas da operação de script 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 mais altas).

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 desabilitar o modo somente leitura, vá para Alterar uma planilha do Excel somente leitura.
429 Número excessivo de solicitações 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 de acordo com a contagem de solicitações, a memória usada e outros fatores importantes. Se a limitação estiver ocorrendo, é sugerido 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 se ele não atingiu o limite em #1, ele ainda pode ser limitado por motivos diferentes. Veja abaixo os motivos mais comuns para a limitação:
a. Clique na política de limitação do serviço do Sharepoint.
b. Clique na 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 30 anos podem retornar 504 e 504 contínuas resultariam em limitação.
d. Muitas falhas consecutivas em uma sessão de pasta de trabalho.
e. Quando uma solicitação é feita ao OfficeScripting na ID da Operação "RunScriptProd" e, se essas solicitações tiverem mais de 3 em 10 segundos, ela será limitada.

Problemas e limitações gerais conhecidos

  • O tamanho máximo de um arquivo do Excel compatível com o conector do Excel Online (Business) é de 25 MB.
  • Um arquivo do Excel pode ser bloqueado por uma atualização ou exclusão de até 6 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 Power Apps). 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).
  • A File propriedade esperada pelas ações do conector deve ser preenchida usando uma das seguintes opções:
    • Escolha um arquivo do seletor de arquivos.
    • Use uma saída dos gatilhos/ações do conector do OneDrive for Business (propriedade ou File identifier arquivoId, dependendo de qual deles esteja 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 (propriedade ou Identifier arquivoId, dependendo de qual está presente para a ação ou gatilho específico do Sharepoint).
    • Insira o caminho para o arquivo a partir da Unidade. Exemplos:
      • Se o arquivo estiver no OneDrive e o caminho completo for OneDrive/file.xlsx e o parâmetro Drive estiver OneDrive, file.xlsxde entrada.
      • Se o arquivo estiver em Grupos O365 e o caminho completo for Documentos/Documentos Internos/file.xlsx e o parâmetro De unidade estiver Documents, insira Documentos Internos/file.xlsx.
  • 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 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 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.
  • 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.
  • O conector sempre retorna todas as bibliotecas de documentos disponíveis no 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, acesse Unidades de lista – Comentários.
  • O conector poderá preencher até 64.000 linhas automaticamente se a opção Inserir id gerada automaticamente na tabela do Excel for selecionada durante uma importação de tabela no Power Apps.
  • 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 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.
  • 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).
  • Nos Aplicativos Lógicos fairfax, esse conector dá suporte apenas a 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 às políticas organizacionais, você não pode acessar esses recursos desse local de rede". Para obter 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 de 504, os clientes poderão enfrentar limitação devido a diferentes restrições de API do Graph. Abaixo estão algumas sugestões para reduzir 504 para operações de execução longa:
    • Atualize a tabela para ser 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 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.
  • O tamanho máximo com suporte de cada solicitação de conector é de 5 MB.

Tratamento de nomes de coluna

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

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

Conceitos e exemplos

  • Coluna de chave: Coluna em uma tabela que será usada para pesquisar um valor (valor da chave).
  • Valor da 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 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

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

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

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.

Parâmetros

Nome Chave Obrigatório Tipo Description
Localização
 source True string

Selecione na lista suspensa ou especifique um dos seguintes: - "me" - "URL do Site do SharePoint" - "UPN de usuários/alguém" - "ID de grupo/grupo" - "sites/URL do Site do SharePoint:/teams/nome da equipe:" (os dois-pontos são necessários).
Biblioteca de documentos
 drive True string

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

Selecione na lista suspensa ou especifique um dos seguintes: - "eu" - "URL do Site do SharePoint" - "UPN de usuários/alguém" - "ID de grupo/grupo" - "sites/URL do Site do SharePoint:/teams/nome da equipe:" (dois-pontos são necessários).
Biblioteca de documentos
 drive True string

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

Selecione na lista suspensa ou especifique um dos seguintes: - "eu" - "URL do Site do SharePoint" - "UPN de usuários/alguém" - "ID de grupo/grupo" - "sites/URL do Site do SharePoint:/teams/nome da equipe:" (dois-pontos são necessários).
Biblioteca de documentos
 drive True string

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

Selecione na lista suspensa ou especifique um dos seguintes: - "me" - "URL do Site do SharePoint" - "UPN de usuários/alguém" - "ID de grupo/grupo" - "sites/URL do Site do SharePoint:/teams/nome da equipe:" (os dois-pontos são necessários)
Biblioteca de documentos
 drive True string

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

Selecione na lista suspensa ou especifique um dos seguintes: - "eu" - "URL do Site do SharePoint" - "UPN de usuários/alguém" - "ID de grupo/grupo" - "sites/URL do Site do SharePoint:/teams/nome da equipe:" (dois-pontos são necessários).
Biblioteca de documentos
 drive True string

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

Selecione na lista suspensa ou especifique um dos seguintes: - "me" - "URL do Site do SharePoint" - "UPN de usuários/alguém" - "ID de grupo/grupo" - "sites/URL do Site do SharePoint:/teams/nome da equipe:" (os dois-pontos são necessários).
Biblioteca de documentos
 drive True string

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

Selecione na lista suspensa ou especifique um dos seguintes: - "me" - "URL do Site do SharePoint" - "UPN de usuários/alguém" - "ID de grupo/grupo" - "sites/URL do Site do SharePoint:/teams/nome da equipe:" (os dois-pontos são necessários)
Biblioteca de documentos
 drive True string

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

Executar script

ID da operação:
RunScriptProd

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

Parâmetros

Nome Chave Obrigatório Tipo Description
Localização
 source True string

Selecione na lista suspensa ou especifique um dos seguintes: - "eu" - "URL do Site do SharePoint" - "UPN de usuários/alguém" - "ID de grupo/grupo" - "sites/URL do Site do SharePoint:/teams/nome da equipe:" (dois-pontos são necessários).
Biblioteca de documentos
 drive True string

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

Selecione um arquivo do Excel por meio da Procura de Arquivos.
Script
 scriptId True string

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

Forneça os parâmetros do Script do Office.

Retornos

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

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

Nome Chave Obrigatório Tipo Description
Local da pasta de trabalho
 source True string

Selecione na lista suspensa ou especifique um dos seguintes: - "eu" - "URL do Site do SharePoint" - "UPN de usuários/alguém" - "ID de grupo/grupo" - "sites/URL do Site do SharePoint:/teams/nome da equipe:" (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 da Procura de Arquivos.
Local do script
 scriptSource True string

Selecione na lista suspensa ou especifique um dos seguintes: - "me" - "URL do Site do SharePoint" - "UPN de usuários/alguém" - "ID de grupo/grupo" - "sites/URL do Site do SharePoint:/teams/nome da equipe:" (os dois-pontos são necessários).
Biblioteca de Scripts
 scriptDrive True string

Selecione a biblioteca do SharePoint do 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.

Retornos

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

Nome Chave Obrigatório Tipo Description
Localização
 source True string

Selecione na lista suspensa ou especifique um dos seguintes: - "me" - "URL do Site do SharePoint" - "UPN de usuários/alguém" - "ID de grupo/grupo" - "sites/URL do Site do SharePoint:/teams/nome da equipe:" (os dois-pontos são necessários)
Biblioteca de documentos
 drive True string

Selecione uma biblioteca de documentos na lista suspensa.
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.
Extrair rótulo de confidencialidade
 extractSensitivityLabel boolean

Um booliano se deve extrair a ID do rótulo de confidencialidade para artefato associado.
Metadados do rótulo de confidencialidade
 fetchSensitivityLabelMetadata boolean

Um booliano se deseja buscar metadados de rótulo de confidencialidade para LabelId associado.

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

Selecione na lista suspensa ou especifique um dos seguintes: - "eu" - "URL do Site do SharePoint" - "UPN de usuários/alguém" - "ID de grupo/grupo" - "sites/URL do Site do SharePoint:/teams/nome da equipe:" (dois-pontos são necessários).
Biblioteca de documentos
 drive True string

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

Selecione um arquivo do Excel por meio da Procura de Arquivos.
Extrair rótulo de confidencialidade
 extractSensitivityLabel boolean

Um booliano se deve extrair a ID do rótulo de confidencialidade para artefato associado.
Metadados do rótulo de confidencialidade
 fetchSensitivityLabelMetadata boolean

Um booliano se deseja buscar metadados de rótulo de confidencialidade para LabelId associado.

Retornos

Nome Caminho Tipo Description
value
 value array of WorksheetMetadata
sensitivityLabelInfo
 sensitivityLabelInfo array of SensitivityLabelMetadata

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

Selecione na lista suspensa ou especifique um dos seguintes: - "eu" - "URL do Site do SharePoint" - "UPN de usuários/alguém" - "ID de grupo/grupo" - "sites/URL do Site do SharePoint:/teams/nome da equipe:" (dois-pontos são necessários).
Biblioteca de documentos
 drive True string

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

Selecione um arquivo do Excel por meio da Procura de Arquivos.
Extrair rótulo de confidencialidade
 extractSensitivityLabel boolean

Um booliano se deve extrair a ID do rótulo de confidencialidade para artefato associado.
Metadados do rótulo de confidencialidade
 fetchSensitivityLabelMetadata boolean

Um booliano se deseja buscar metadados de rótulo de confidencialidade para LabelId associado.

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

Obter uma linha

ID da operação:
GetItem

Obtenha uma linha usando uma coluna de chave.

Parâmetros

Nome Chave Obrigatório Tipo Description
Localização
 source True string

Selecione na lista suspensa ou especifique um dos seguintes: - "me" - "URL do Site do SharePoint" - "UPN de usuários/alguém" - "ID de grupo/grupo" - "sites/URL do Site do SharePoint:/teams/nome da equipe:" (os dois-pontos são necessários)
Biblioteca de documentos
 drive True string

Selecione uma biblioteca de documentos na lista suspensa.
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.
Extrair rótulo de confidencialidade
 extractSensitivityLabel boolean

Um booliano se deve extrair a ID do rótulo de confidencialidade para artefato associado.
Metadados do rótulo de confidencialidade
 fetchSensitivityLabelMetadata boolean

Um booliano se deseja buscar metadados de rótulo de confidencialidade para LabelId associado.

Retornos

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

Gatilhos

Para uma linha selecionada

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

Para uma linha selecionada

ID da operação:
OnRowSelected

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

Parâmetros

Nome Chave Obrigatório Tipo Description
operationId
 operationId True string
hospedar
 host object
parameters
 parameters True object
esquema
 schema True object
headersSchema
 headersSchema object

Retornos

Nome Caminho Tipo Description
Linhas
 body.rows array of object
items
 body.rows object
ID do usuário
 headers.x-ms-user-id-encoded guid

O identificador exclusivo do usuário que disparou o fluxo no AAD.
Email do usuário
 headers.x-ms-user-email-encoded byte

O endereço de email do usuário que disparou o fluxo.
Nome de usuário
 headers.x-ms-user-name-encoded byte

O nome de exibição do usuário que disparou o fluxo.
Timestamp
 headers.x-ms-user-timestamp string

A hora em que o fluxo foi disparado.

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.

SensitivityLabelMetadata

Nome Caminho Tipo Description
sensitivityLabelId
 sensitivityLabelId string

ID de SensitivityLabel.
nome
 name string

Nome sensitivityLabel.
nome de exibição
 displayName string

Informações de displayName de SensitivityLabel
dica de ferramenta
 tooltip string

Detalhes de SensitivityLabel na dica de ferramenta.
priority
 priority integer

Prioridade de SensitivityLabel.
color
 color string

Cor sensitivityLabel.
isEncrypted
 isEncrypted boolean

é SensitivityLabel Encrypted.
está ativado
 isEnabled boolean

Se SensitivityLabel está habilitado.
isParent
 isParent boolean

Se SensitivityLabel é pai.
parentSensitivityLabelId
 parentSensitivityLabelId string

ID de SensitivityLabel pai.