Pular para o conteúdo principal
API PDF4meIntegraçõesBase de conhecimentoExtensõesTestador de APIBlog

Atualizar linhas no Excel usando n8n Ação

PDF4me Atualizar linhas no Excel modifica linhas existentes da planilha diretamente de n8nAlimente um ou mais JSON objetos (sempre envolvidos em uma matriz) e PDF4me Atribui correspondências às propriedades dos cabeçalhos das colunas, aplica conversão automática de tipos e percorre a planilha sequencialmente, começando na linha escolhida. Perfeito para sincronização. SQL resultados, refrescantes CRM instantâneos ou correção de colunas de status de aprovação sem inserir novas linhas.

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 →

Configurar​

Adicione o PDF4me nó “Atualizar linhas” para o seu n8n fluxo de trabalho e configure os parâmetros necessários. Para obter instruções de configuração inicial, consulte nosso n8n Guia de integração.

Pré-requisitos

  • PDF4me API credenciais
  • n8n acesso ao fluxo de trabalho
Get Your API Key

Configuração

  1. Adicione o PDF4me nó para o fluxo de trabalho
  2. Selecione a ação "Atualizar linhas".
  3. Forneça o arquivo Excel, JSON matriz e atualização de deslocamentos
Atualizar linhas no Excel

Parâmetros​

Importante: Os parâmetros marcados com um asterisco (***) são obrigatórios. Json Data deve sempre ser um JSON matriz (envolver linhas individuais em []).

ParâmetroTipoDescriçãoExemplo
Tipo de dados de entrada***StringSeletor de origem do Excel. Opções: Binary Data, Base64 String, URL.Binary Data
Campo binário de entrada***BinárioNecessário quando Input Data Type = Binary Data. Referência do binário upstream.{{ $binary.data }}
Conteúdo do documento Base64***StringNecessário quando Input Data Type = Base64 StringForneça a planilha em base64.UEsDBBQAAAA...
URL do documento***StringNecessário quando Input Data Type = URLLink público para a apostila.https://files.example.com/report.xlsx
Nome do arquivo***StringNome de processamento/exibição da pasta de trabalho (com extensão).inventory.xlsx
Dados JSON***StringJSON matriz de objetos. Cada objeto atualiza uma linha sequencialmente.[{"SKU":"A-100","Stock":45}]
Nome da folha de exercíciosStringPlanilha de metas. A versão em branco utiliza a primeira planilha.Inventory
Linha inicialNúmeroA primeira linha da planilha a ser atualizada é a linha 1 (os cabeçalhos geralmente são da linha 1).2
Coluna inicialNúmeroDeslocamento de coluna baseado em 1 usado para alinhamento do cabeçalho.1
Converter valores numéricos e datasBooleanConverter automaticamente cadeias de caracteres numéricos/de data em valores do Excel. Padrão. true.true
Formato de dataStringO formato de data do Excel é aplicado quando a conversão está ativada.yyyy-MM-dd
Formato numéricoStringFormatação numérica do Excel quando a conversão está ativada.#,##0.00
Ignorar valores nulosBooleanQuando trueOs valores nulos não alteram os valores existentes nas células.true
Ignorar títulos de atributosBooleanCorrespondência de cabeçalho sem distinção entre maiúsculas e minúsculas. Padrão false.true
Nome da culturaStringCultura para análise sintática de números/datas. Vazio = invariante.en-US
Nome da saída de dados binários***StringNome do slot binário de saída que armazena a planilha corrigida.document

Saída​

Parâmetros de saída​

ParâmetroTipoDescriçãoExemplo
nome_do_arquivoStringNome do arquivo do documento Excel com as linhas atualizadas - O nome do arquivo Excel de saída após as atualizações das linhasexcel_updated.xlsx
tamanho do arquivoNúmeroTamanho do arquivo em bytes - O tamanho do documento Excel em bytes após as atualizações de linha212810
sucessoBooleanPDF4me status da operação - Boolean Sinalizador indicando o sucesso ou a falha do processo de atualização da linha. PDF4me retornos true para operações bem-sucedidas e false para quaisquer errostrue
nome_do_arquivo_originalStringNome do arquivo original do documento Excel - O nome do arquivo de documento Excel de entradamyExcelFile.xlsx
Nome da planilhaStringNome da folha de exercícios - O nome da planilha onde as linhas foram atualizadasSheet1
linhaInicialNúmeroNúmero da linha inicial - O número da linha (base 1) onde as atualizações começaram.1
coluna inicialNúmeroNúmero da coluna inicial - O número da coluna (base 1) onde as atualizações começaram.1
linhasAtualizadasNúmeroNúmero de linhas atualizadas - O número total de linhas que foram atualizadas com sucesso.1
converterNúmeroEDateBooleanStatus da conversão numérica e de data - Indica se a conversão automática de números e datas foi ativada. true se ativado, false se desativadotrue
formato de dataStringFormato de data aplicado - A string de formato de data que foi aplicada durante a conversão.yyyy-MM-dd
formato numéricoStringFormato numérico aplicado - A sequência de formato numérico que foi aplicada durante a conversão.N2
ignorarValoresNulosBooleanTratamento de valores nulos - Indica se os valores nulos foram ignorados. true se os valores nulos fossem ignorados (preservando os valores existentes), false se valores nulos fossem escritosfalse
ignoreAttributeTitlesBooleanCorrespondência de cabeçalho sem distinção entre maiúsculas e minúsculas - Indica se foi utilizada a correspondência de cabeçalho sem distinção entre maiúsculas e minúsculas. true se ativado, false se houver diferenciação entre maiúsculas e minúsculasfalse
nome_da_culturaStringCódigo de cultura/localidade - Código cultural usado para analisar números e datas (por exemplo, "en-US", "de-DE", "fr-FR")en-US
mensagemStringMensagem da operação - Mensagem descritiva indicando o resultado da operação de atualização de linhas, incluindo o número de linhas atualizadas e o nome da planilha.Successfully updated 1 row(s) in worksheet 'Sheet1'

N8N Resposta à ação​

O PDF4me Atualizar linhas API Retorna uma resposta que pode ser visualizada em vários formatos. Escolha a visualização que melhor se adapta às suas necessidades:

JSON Formato de resposta

O bruto JSON resposta do API:

[
  {
    "fileName": "excel_updated.xlsx",
    "fileSize": 212810,
    "success": true,
    "originalFileName": "myExcelFile.xlsx",
    "worksheetName": "Sheet1",
    "startRow": 1,
    "startColumn": 1,
    "rowsUpdated": 1,
    "convertNumericAndDate": true,
    "dateFormat": "yyyy-MM-dd",
    "numericFormat": "N2",
    "ignoreNullValues": false,
    "ignoreAttributeTitles": false,
    "cultureName": "en-US",
    "message": "Successfully updated 1 row(s) in worksheet 'Sheet1'"
  }
]

Casos de uso​

  • Sincronização de inventárioAtualizar contagens de estoque obtidas de ERP consultas, mantendo os preços e os metadados intactos.
  • Status do pedido ou projeto: Status do patch, proprietário ou SLA colunas sempre que os sistemas upstream emitirem atualizações.
  • Ajustes financeirosReescrever as linhas de previsão ou de dados reais diariamente, sem quebrar as fórmulas/estrutura existentes.

Obtenha ajuda​

n8n Integration Guiden8n SampleGetting Started