Pular para o conteúdo principal

Extrair planilhas de Excel em Power Automate

PDF4me Extrair Planilhas é um Power Automate ação que converte uma, várias ou todas as planilhas de um Excel transformar caderno de exercícios em estruturado JSON, usando a primeira linha de cada planilha como cabeçalhos de coluna. Use-a para inserir dados da planilha em um API, uma importação de banco de dados, ou uma JSON arquivar sem escrever nenhum código de análise sintática.

O que esta ação faz

PDF4me Extrair Planilhas leva um Excel arquivo mais uma seleção opcional de planilha e retorna um JSON Objeto com uma chave para cada nome de planilha extraído. Cada chave contém uma matriz de objetos de linha construída a partir da linha de cabeçalho e das linhas de dados daquela planilha, com números, datas, valores booleanos e texto preservados em seu formato original. JSON tipos.

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 Automate, cada solicitação deve incluir um válido API A autenticação valida sua identidade e permite que o conector acesse o sistema. PDF4me's Excel Serviço de extração de planilhas do seu fluxo de trabalho.

Fatos importantes que você não deve perder

A opção "em branco" significa todas as planilhas.
Deixe os campos Nomes das Planilhas e Índices das Planilhas vazios para extrair todas as planilhas da pasta de trabalho em uma única chamada.
As seleções de nome e índice combinam-se como uma união.
Se ambos os campos estiverem preenchidos, cada planilha que corresponder a qualquer uma das listas será extraída uma única vez, e não apenas as que corresponderem a ambas.
Os índices das planilhas são baseados em 0.
O índice 0 corresponde à primeira planilha, o índice 1 à segunda e assim por diante. A comparação dos nomes das planilhas diferencia maiúsculas de minúsculas.
A ação "Extrair Planilhas do Excel" do Power Automate PDF4me exibe os campos Conteúdo do Arquivo, Nome do Arquivo, Nomes das Planilhas e Índices das Planilhas.

Mapeie o conteúdo e o nome do arquivo de uma ação anterior e, em seguida, defina os nomes das planilhas e/ou os índices das planilhas, ou deixe ambos em branco para extrair todas as planilhas.

Parâmetros

Obrigatório: O conteúdo e o nome do arquivo devem sempre ser fornecidos. Os nomes e índices das planilhas são opcionais; deixá-los em branco extrairá todas as planilhas.

ParâmetroObrigatórioO que fazExemplo
File ContentRequiredBase64 or buffer content of the source Excel file, typically mapped from a prior action like SharePoint or OneDrive Get File Content.[File Content from Get File]
File NameConditionalName of the Excel file including its extension. Shown as a plain field in the connector UI and used for processing and output naming; supply it even though the connector does not mark it with an asterisk.data.xlsx
Worksheet NamesOptionalComma-separated list of worksheet names to extract. Case-sensitive, and combines with Worksheet Indexes as a union when both are set.Employees,Sales
Worksheet IndexesOptionalComma-separated list of 0-based worksheet indexes to extract, for example "0,2,4" for the first, third, and fifth sheets.0,2,4

O que a função Extrair Planilhas retorna?

CampoTipoO que contém
documentBase64The extracted JSON data as a byte array, saved as a .txt file, keyed by worksheet name.
FileNameStringOutput file name with a .txt extension.
SuccessBooleantrue when extraction completed, false if the request failed validation or processing.
Error MessageStringDescription of what went wrong, null when Success is true.
ErrorsArrayDetailed error entries, empty when Success is true.
{
"document": "[Base64 JSON Data]",
"FileName": "report.txt",
"Success": true,
"ErrorMessage": null,
"Errors": []
}

Exemplo de conteúdo de documento decodificado:

{
"Employees": [
{"Name": "John Doe", "Age": 30, "Department": "IT"},
{"Name": "Jane Smith", "Age": 28, "Department": "HR"}
],
"Sales": [
{"Product": "Widget", "Units": 100, "Revenue": 2500.00},
{"Product": "Gadget", "Units": 75, "Revenue": 1875.00}
]
}

Mensagens de erro comuns

Mensagem de erroCausaSolução
Request is emptyRequest object is null.Provide a valid request object.
Document is emptyDocument object is null or DocData is null.Provide a valid Excel document.
Workbook contains no worksheetsExcel file has 0 worksheets.Provide a valid Excel file with at least one worksheet.
Invalid worksheet selectionWorksheet name does not exist or index is out of range.Use valid worksheet names or 0-based indexes.
Available worksheets in workbook (X total)Informational message appended when worksheet selection validation fails.Review worksheet names or indexes and use valid values from the X available worksheets listed.

Como faço para configurar planilhas de extração em Power Automate?

  1. Adicionar PDF4meExtrair Planilhas para o seu Power Automate fluxo.
  2. Mapa Conteúdo do arquivo e Nome do arquivo de uma ação anterior, como por exemplo SharePoint ou OneDrive Obter conteúdo do arquivo.
  3. Definir Nomes das folhas de exercícios, Índices de planilhasSelecione ambas ou deixe ambas em branco para extrair todas as planilhas.
  4. Execute o fluxo. A primeira linha de cada planilha selecionada se torna a JSON chaves, e o resultado retorna como document, um codificado em Base64 JSON Objeto indexado pelo nome da planilha.

Quando devo usar nomes de planilhas em vez de índices de planilhas?

Usar Nomes das folhas de exercícios Quando as planilhas de destino têm nomes estáveis e conhecidos, como "Resumo" ou "Dados do Cliente", a seleção permanece correta mesmo que a ordem das planilhas seja alterada. Índices de planilhas Quando um fluxo gera pastas de trabalho com ordem de planilhas previsível, mas com nomes de variáveis, definir ambas as opções extrai a união das duas seleções, de modo que a sobreposição entre elas não duplique uma planilha na saída.

Configurações típicas

Exemplos de fluxo de trabalhoCommon Power Automate flow patterns using Extract Worksheets from Excel.
Caderno de exercícios com várias folhas para API alimentar
  1. Um fluxo é acionado quando várias folhas são inseridas. Excel A planilha foi carregada em um SharePoint Pasta "Exportação de Dados".
  2. A função Obter Conteúdo do Arquivo recupera a planilha.
  3. A função Extrair Planilhas é executada com os campos Nomes das Planilhas e Índices das Planilhas em branco para converter todas as planilhas.
  4. Analisar JSON processa o resultado e um loop "Aplicar a cada" publica os dados de cada planilha em sua própria planilha. API ponto final.
Agendado JSON arquivo
  1. Um gatilho de recorrência executa um fluxo de arquivamento mensal.
  2. A opção "Obter conteúdo do arquivo" recupera o projeto concluído. Excel arquivos de SharePoint.
  3. O Extract Worksheets converte cada planilha em JSON Com todas as folhas incluídas.
  4. O JSON A saída é armazenada no Armazenamento de Blobs do Azure ou SharePoint ao lado do arquivo original arquivado.
Exportação seletiva de clientes
  1. Um formulário do Microsoft Forms solicita a exportação de dados específicos do cliente.
  2. A função Obter Conteúdo do Arquivo recupera a planilha principal de um local seguro. SharePoint biblioteca.
  3. A opção "Extrair Planilhas" é executada com os nomes das planilhas definidos para exibir apenas as planilhas que o cliente está autorizado a visualizar, por exemplo, "Resumo,DadosDoCliente".
  4. O resultado JSON é enviado por e-mail ao solicitante, deixando planilhas internas não relacionadas completamente de fora da exportação.

Dicas práticas

Leave both selection fields blank for a full export
Extracting every worksheet in one call is simpler than chaining several Extract Worksheets actions when a flow needs the whole workbook as JSON.
Match Worksheet Names exactly, including case
Worksheet name comparison is case-sensitive. A mismatch returns an invalid worksheet selection error even if the name looks correct at a glance.
Remember Worksheet Indexes start at 0
Index 0 is the first sheet, not the second. Off-by-one index values are a common source of the wrong worksheet being extracted.
Combining names and indexes extracts a union, not an intersection
If a worksheet matches either list, it is included once. Use only one selection method if you need precise, predictable output.
Parse JSON before looping through worksheets
The output document decodes to an object keyed by worksheet name, so a Parse JSON action followed by Apply to each on the object's keys is the standard pattern for per-sheet processing.

Folha de dicas

CampoValor
ActionExtract Worksheets
File ContentMapped from a prior file-retrieval action
File Namee.g. data.xlsx
Worksheet NamesComma-separated, case-sensitive, or blank
Worksheet Indexes0-based, comma-separated, or blank
Blank + blankExtracts all worksheets
Both filledUnion of name matches and index matches
Outputdocument (Base64 JSON, .txt), FileName, Success, Error Message, Errors

Perguntas frequentes

How do I convert an Excel worksheet to JSON in Power Automate?+
Add the PDF4me Extract Worksheets action, map File Content and File Name from a prior action, then set Worksheet Names or Worksheet Indexes to choose which sheets to convert. Leaving both blank extracts every worksheet, returning a JSON document keyed by worksheet name. See the connector reference below for the full action list.
What happens if I leave Worksheet Names and Worksheet Indexes both blank?+
The action extracts every worksheet in the workbook and returns them all as JSON, one array per worksheet name in the output document. This is the simplest setup for a full workbook-to-JSON export.
Can I select worksheets by name and by index in the same request?+
Yes. If both Worksheet Names and Worksheet Indexes are provided, the action extracts the union of the two selections, so any worksheet matching either the name list or the index list is included once in the result.
Are Worksheet Indexes 0-based or 1-based?+
Worksheet Indexes are 0-based, so index 0 refers to the first worksheet, index 1 to the second, and so on. See <a href="https://learn.microsoft.com/en-us/office/dev/scripts/resources/samples/get-table-data" target="_blank" rel="noopener noreferrer">Microsoft's guide to reading Excel table data</a> for how worksheet and range indexing works natively in Excel.
What does the output JSON look like?+
The output document is a JSON object with one key per extracted worksheet name, and each key holds an array of row objects built from that sheet's header row and data rows, with numbers, dates, booleans, and text preserved in their native JSON types. See <a href="https://learn.microsoft.com/en-us/connectors/pdf4meconnect/" target="_blank" rel="noopener noreferrer">the PDF4me Power Automate connector reference</a> for the full action list.

Casos de uso e aplicações industriais

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

  • Migração de sistemasExportar planilhas inteiras do Excel como JSON para migrações de sistema
  • Integração de múltiplas APIsEnviar planilhas diferentes para endpoints de API diferentes
  • Backup de dadosCriar backups JSON de arquivos Excel com várias planilhas
  • Migração para a nuvemConverter planilhas do Excel para JSON para armazenamento em nuvem

Ações relacionadas

Mesma tarefa em outras plataformas

Obtenha ajuda