Pular para o conteúdo principal

Extrair linhas de Excel em Power Automate

PDF4me Extrair linhas de Excel A ação permite a extração de linhas específicas de Excel documentos como estruturados JSON dados em Power Automate Com opções abrangentes de filtragem e formatação, este poderoso recurso de extração de dados suporta a extração seletiva de intervalos de linhas e colunas, processamento automático de cabeçalhos, exclusão de linhas/colunas ocultas, filtragem de linhas vazias e manipulação flexível de tipos de dados (exportação numérica ou de texto), sendo perfeito para integração de dados. API fluxos de trabalho de alimentação, população de banco de dados e transformação automatizada de dados em toda a empresa. Microsoft 365.

Artigos relacionados no blogue
Ainda não há nenhuma publicação no blogue sobre esta funcionalidade — em breve.
Entretanto, explore o blogue da PDF4me para encontrar tutoriais e fluxos de trabalho para todas as plataformas.
Visite o blogue

Autenticando seu API Solicitar

Para acessar o PDF4me Web API através Power AutomatePara que uma solicitação seja válida, é necessário incluir credenciais de autenticação adequadas. A autenticação garante uma comunicação segura e valida sua identidade como usuário autorizado, permitindo uma integração perfeita entre seus sistemas. Power Automate fluxos e PDF4mepoderoso Excel Serviços de extração de dados.

Extrair linhas do Excel no Power Automate

Principais características

  • JSON Formato de saídaExtrato Excel dados como estruturados JSON para uma integração perfeita
  • Seleção flexível de linhas/colunasEspecifique intervalos exatos ou extraia todos os dados.
  • Suporte da linha de cabeçalhoUse a primeira linha como cabeçalho ou gere automaticamente os nomes das colunas.
  • Filtragem AvançadaExcluir linhas ocultas, colunas ocultas e linhas vazias
  • Controle de tipo de dadosExportar como tipos nativos (números, datas) ou tudo como texto.
  • Manuseio de células vaziasIncluir ou excluir células vazias da saída

Parâmetros

Lista completa de parâmetros para a função Extrair Linhas de Excel Ação. Configure esses parâmetros para controlar a extração de dados.

Importante: Os parâmetros marcados com um asterisco (***) são obrigatórios. Todos os índices de linha/coluna usam Baseado em 0 Numeração (Linha 0 = primeira linha, Coluna 0 = coluna A).

ParâmetroTipoDescriçãoExemplo
Conteúdo do arquivo***Base64Fonte Excel Conteúdo do arquivo
• Mapa Excel arquivo da saída da ação anterior
• Suporta Excel arquivos de SharePoint, OneDriveanexos de e-mail
• Pode ser recuperado dinamicamente a partir de variáveis de fluxo
• Deve ser válido Excel documento (formatos .xlsx, .xls)
[File Content from Get File]
Nome do arquivo***StringExcel Nome do documento
• Especificar Excel Nome do arquivo com extensão (.xlsx, .xls)
• Utilizado para processamento e nomeação de arquivos de saída
• Deve incluir a extensão de arquivo correta
• Suporta nomenclatura dinâmica a partir de variáveis de fluxo
data.xlsx
Nome da folha de exercíciosStringNome da planilha alvo
• Nome da planilha da qual extrair os dados
• Valores nulos ou vazios assumem como padrão a primeira planilha (índice 0)
• O nome da planilha deve corresponder exatamente.
• Nome da planilha que diferencia maiúsculas de minúsculas
Sheet1
Primeira fila***Número (int)Linha inicial (base 0)
• Primeira linha a ser extraída (indexação baseada em 0)
indexação baseada em 0Linha 0 = Linha 1 do Excel, Linha 1 = Linha 2 do Excel, etc.
• Deve ser ≥ 0
• Parâmetro obrigatório
• Observação: as mensagens de erro exibem números de linha baseados em 1.
0
Última filaNúmero (int)Linha final (base 0)
• Última linha a ser extraída (indexação baseada em 0)
• -1 = extrair até a última linha com dados (MaxDataRow)
• Padrão: -1
• Deve ser ≥ PrimeiraLinha
-1
Primeira colunaNúmero (int)Coluna inicial (base 0)
• Primeira coluna a ser extraída (indexação baseada em 0)
indexação baseada em 0Coluna 0 = A, Coluna 1 = B, Coluna 2 = C, etc.
• Padrão: 0
• Deve ser ≥ 0
0
Última colunaNúmero (int)Coluna final (base 0)
• Última coluna a ser extraída (indexação baseada em 0)
• -1 = extrair até a última coluna com dados (MaxDataColumn)
• Padrão: -1
• Deve ser ≥ PrimeiraColuna
-1
Possui linha de cabeçalhoBooleanPrimeira linha como cabeçalhos
Verdadeiro - Usar FirstRow como cabeçalho de coluna (excluído dos dados)
Falso - Gerar cabeçalhos automaticamente ("Coluna1", "Coluna2"...)
• Padrão: falso
• Afeta a linha inicial dos dados
true
Excluir linhas ocultasBooleanIgnorar linhas ocultas
Verdadeiro - Ignorar linhas ocultas no Excel
Falso - Incluir linhas ocultas na extração
• Padrão: falso
• Útil para filtrar dados de relatórios
false
Excluir colunas ocultasBooleanIgnorar colunas ocultas
Verdadeiro - Ignorar colunas ocultas no Excel
Falso - Incluir colunas ocultas na extração
• Padrão: falso
• Útil para filtrar dados de relatórios
false
Excluir linhas vaziasBooleanIgnorar linhas vazias
Verdadeiro - Ignorar linhas onde todas as células estão vazias
Falso - Incluir linhas vazias na saída
• Padrão: falso
• Melhora a qualidade dos dados
false
Exportar células vaziasBooleanIncluir células vazias
Verdadeiro - Incluir células vazias com valores de string vazios
Falso - Omitir células vazias de JSON saída
• Padrão: falso
• Afeta JSON estrutura
false
Exportar valores como textoBooleanModo de exportação de texto
Verdadeiro - Exporte todos os valores como cadeias de texto (por exemplo, "30", "50000.50", "true")
Falso - Preservar tipos de dados: Numérico → número, Data e Hora → string ISO, Booleano → booleano, Texto → string, Vazio → "" (se ExportEmptyCells = verdadeiro)
• Padrão: falso
Tratamento de Tipos de DadosQuando falso, os tipos de dados do Excel são preservados; quando verdadeiro, todos os valores são convertidos em strings.
false

Saída

O PDF4me Extrair linhas de Excel a ação retorna abrangente JSON dados de saída para contínuo Power Automate integração de fluxo:

Visualização em tabela

Dados de resposta em formato de tabela estruturada:

ParâmetroTipoDescrição
documentoBase64JSON dados como matriz de bytes (serializada)
Dados da linhaArrayLinhas extraídas como uma matriz de objetos com chaves de nome de coluna.
SucessoBooleanVerdadeiro se a operação for bem-sucedida, falso se falhar.
Mensagem de erroStringDescrição do erro (nulo se bem-sucedido)
ErrosArrayLista de informações detalhadas sobre o erro (array vazio em caso de sucesso)

Mensagens de erro comuns

Compreender e solucionar erros ajuda a garantir um bom funcionamento. Excel Fluxos de trabalho de extração de dados:

Mensagem de erroCausaSolução
"A solicitação está vazia"O objeto de solicitação é nulo.Forneça um objeto de solicitação válido.
"O documento está vazio"O objeto Documento é nulo.Forneça um documento válido. Excel documento
"O caderno de exercícios não contém folhas de exercícios"Excel O arquivo contém 0 planilhas.Forneça um documento válido. Excel arquivo com planilhas
Planilha '{name}' não encontradaO nome da planilha não existe na pasta de trabalho.Usar o nome da planilha existente
"Seleção de planilha inválida"Erro de acesso à planilhaVerifique o nome da planilha e a integridade do arquivo.
"Planilhas disponíveis na apostila (X total)"Mensagem informativa quando a validação da planilha falhaRevise o nome da planilha e use um valor válido dentre as X planilhas disponíveis.
"Linha inicial inválida {row}. Os números das linhas devem ser positivos."PrimeiraLinha < 0Use FirstRow ≥ 0 (indexação baseada em 0)
"A linha {row} excede o número máximo de linhas de dados ({maxRow})"ÚltimaLinha > LinhaMáximaDeDadosUtilizar intervalo de linhas válido nos dados da planilha
"Intervalo inválido {start}-{end}: A linha final não pode ser menor que a linha inicial"ÚltimaLinha < PrimeiraLinhaGarantir que LastRow ≥ FirstRow

Observação: As mensagens de erro são exibidas. 1-baseado números de linha (por exemplo, Linha 1, Linha 2) enquanto parâmetros usam Baseado em 0 indexação (0, 1).

Exemplos de fluxo de trabalho

O PDF4me Extrair linhas de Excel ação em Power Automate Oferece modelos de fluxo de trabalho abrangentes, projetados para cenários de negócios do mundo real:

Automatizado Excel para o fluxo de trabalho de integração da API REST

Transforme a integração de seus dados com automação. Excel para alimentação de dados via API:

Etapas completas do fluxo de trabalho:

  1. Acionar: Excel arquivo carregado para SharePoint "API Pasta "Dados"
  2. Obter arquivo Excel: Recuperar arquivos enviados Excel de SharePoint
  3. Extrair todas as linhasDefina FirstRow = 0, LastRow = -1, HasHeaderRow = true
  4. Analisar JSONConverter o array RowData em objetos individuais.
  5. Percorrer linhasUse "Aplicar a cada" para itens RowData.
  6. Chamar REST API: HTTP POST cada linha para externo API ponto final
  7. Resultados do registroRegistrar chamadas de API bem-sucedidas/com falha
  8. Enviar resumoEnviar e-mail ao administrador com o resumo do processamento.

Benefícios para as empresas:

  • Integra mais de 100 Excel linhas com APIs externas semanalmente
  • Elimina a entrada manual de dados em sistemas de API.
  • Fornece estrutura JSON formato para API consumo
  • Automatiza a sincronização de dados, economizando 10 horas semanais.

Casos de uso e aplicações industriais

Casos de uso de TI e integração de sistemas

  • Feed de dados da APIExtrair dados do Excel como JSON para consumo via API REST.
  • Migração de banco de dadosExportar dados do Excel para bancos de dados SQL, NoSQL ou na nuvem.
  • Processos ETLExtrair dados do Excel para pipelines de transformação e carregamento.
  • Sincronização do sistemaSincronizar dados do Excel com vários sistemas empresariais.

Obtenha ajuda