Pular para o conteúdo principal

Atualizar linhas em Excel - Modificador de dados para Make

PDF4me Atualizar linhas em Excel é um Make Módulo que modifica linhas existentes em uma planilha .xlsx ou .xls usando um JSON Matriz que relaciona automaticamente os nomes das propriedades aos cabeçalhos das colunas. Use-a para sincronizar alterações no banco de dados, atualizar painéis ou fazer atualizações. CRM registros em Excel sem inserir ou excluir linhas.

O que este módulo faz

PDF4me Atualizar linhas em Excel modifica células em linhas existentes usando um JSON matriz, sem inserir ou excluir linhas. Nomes das propriedades em cada JSON Os objetos são automaticamente associados aos cabeçalhos das colunas, com conversão automática opcional de strings em números ou datas, análise específica de cada cultura, formatação personalizada de datas/números e controle sobre como os valores nulos são tratados.

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

Como faço para autenticar minha conta? Make Cenário?

Todo PDF4me módulo em Make requer um válido ConexãoCrie ou selecione um que contenha o seu PDF4me API chave para que o cenário possa ser autenticado Excel Atualizações de linhas seguras.

Fatos importantes que você não deve perder

Somente atualizações no local
O módulo nunca insere nem exclui linhas. Ele apenas sobrescreve células em linhas já existentes, começando na Linha Inicial e correspondendo às colunas pelo nome do cabeçalho.
A entrada JSON deve ser uma matriz.
Até mesmo uma atualização de uma única linha deve ser envolvida por colchetes de matriz: [{"Name":"John"}]Um objeto sem colchetes causa um erro.
A conversão de tipo é opcional, não automática.
A opção Converter Numérico e Data deve estar definida como Sim para que o Formato de Data, o Formato Numérico e o Nome da Cultura entrem em vigor. Caso esteja definida como Não, os valores serão gravados como estão.
Crie um módulo de atualização de linhas do PDF4me Excel em uma planilha configurada com Conexão, Arquivo definido como Mapear com Nome do Arquivo e Documento mapeados, Nome da Planilha Sheet1, Entrada JSON, Linha Inicial 2, Converter Numérico e Data definido como Sim, Formato de Data aaaa-MM-dd, Formato Numérico N2, Ignorar Títulos de Atributos Não, Ignorar Valores Nulos Não e Nome da Cultura en-US

Defina o arquivo para o mapa, conecte o nome do arquivo e o documento do módulo anterior e, em seguida, forneça a entrada JSON e as opções de conversão de linha/tipo.

Parâmetros

Obrigatório: É necessário fornecer a conexão, o nome do arquivo, o documento e a entrada JSON. Json Input deve ser um JSON Matriz de objetos; objetos individuais não são suportados. Todos os outros parâmetros são opcionais e utilizam os valores padrão do módulo se forem deixados em branco.

ParâmetroObrigatórioO que fazExemplo
ConnectionRequiredPDF4me API connection. Click Add and paste your API key if connecting for the first time.My PDF4me Excel connection
File NameRequiredFilename of the Excel workbook including extension, used for output file identification.sales_data.xlsx
DocumentRequiredExcel file buffer mapped from a preceding module such as Dropbox Download a File or Google Drive.[Buffer from Get File]
Worksheet NameOptionalName of the worksheet to update. Defaults to Sheet1 if left blank. Worksheet matching is case-sensitive.Sheet1
Json InputRequiredJSON array of objects, one object per row to update. Property names are matched to column headers automatically.[{"Product":"Widget","Price":55.99}]
Start RowOptional1-based row number where updates begin. Row 1 is usually the header row, so data updates typically start at row 2.2
Start ColumnOptional1-based column offset used for header matching, allows skipping initial columns.1
Convert Numeric And DateOptionalYes converts JSON strings to Excel numbers and dates using Date Format and Numeric Format. No writes values as-is.Yes
Date FormatOptionalExcel date format pattern applied when Convert Numeric And Date is Yes.yyyy-MM-dd
Numeric FormatOptionalExcel numeric format pattern applied when Convert Numeric And Date is Yes.N2
Ignore Attribute TitlesOptionalYes makes JSON property name matching case-insensitive against column headers.No
Ignore Null ValuesOptionalYes skips updating any cell whose JSON value is null, preserving the existing cell content. No overwrites it as empty.No
Culture NameOptionalCulture code used to parse incoming date and number strings before conversion, important for international data.en-US

Campos de saída

CampoTipoO que contém
NameStringOutput Excel filename, matches the File Name input.
Doc DataBufferThe Excel document with the modified rows, in buffer format, ready to upload or attach.

Como faço para configurar a atualização de linhas em Make?

  1. Adicionar PDF4meAtualizar linhas em uma planilha para o seu Make cenário.
  2. Selecione Conexão (ou clique) Adicionar para criar um com o seu PDF4me API chave).
  3. Sob Arquivo, escolher Mapa e fio Nome do arquivo e Documento de um módulo anterior (Dropbox, Google Drive ou HTTP).
  4. Definir Nome da folha de exercícios se não for a Planilha1.
  5. Construa o Entrada JSON array para que os nomes das propriedades de cada objeto correspondam aos cabeçalhos das colunas, um objeto por linha para atualizar.
  6. Definir Linha inicial para a primeira linha de dados (geralmente 2 se a linha 1 contiver cabeçalhos).
  7. Habilitar Converter valores numéricos e datas e definir Formato de data / Formato numérico se o seu JSON Os valores são strings que devem se tornar Excel Números ou datas. Execute o cenário; a planilha atualizada retorna como um buffer.

Configurações típicas

Exemplos de fluxo de trabalhoCommon Make scenario patterns using Update Rows in Excel.
banco de dados agendado paraExcel sincronizar
  1. Um gatilho agendado é executado em um intervalo fixo para buscar os registros alterados desde a última sincronização.
  2. A SQL consulta ou API A chamada formata os registros alterados em um JSON matriz correspondente aos cabeçalhos das colunas da planilha.
  3. O comando "Obter Arquivo" recupera o arquivo mestre. Excel Relatório do Dropbox ou do Google Drive.
  4. A opção Atualizar Linhas grava os novos valores a partir da Linha Inicial 2, com a opção Converter Numérico e Data ativada.
  5. A planilha atualizada é carregada de volta para o mesmo local, substituindo a versão anterior.
CRM renovação de oportunidade
  1. Um webhook é acionado quando um CRM O registro da oportunidade foi atualizado.
  2. O cenário constrói um JSON Objeto com o estágio, valor e data de fechamento atualizados para essa oportunidade.
  3. A opção "Obter Arquivo" recupera a planilha de acompanhamento de oportunidades.
  4. A opção Atualizar Linhas modifica a linha correspondente, com a opção Ignorar Títulos de Atributos definida como Sim para uma correspondência de cabeçalho flexível.
  5. A planilha atualizada é salva novamente no armazenamento compartilhado da equipe de vendas.
Atualização do nível de estoque
  1. Um evento do sistema de inventário é acionado quando a contagem de estoque muda para um ou mais SKUs.
  2. O cenário formata os SKUs e quantidades alterados em um JSON variedade.
  3. A função Obter Arquivo recupera a planilha principal de inventário de SharePoint.
  4. A opção "Atualizar linhas" grava os níveis de estoque atuais, com a opção "Ignorar valores nulos" definida como "Sim" para preservar colunas não relacionadas.
  5. A planilha de inventário atualizada é salva novamente em SharePoint para visibilidade do armazém.

Dicas práticas

Json Input must be an array, always
Even a single-row update needs array brackets. A bare object like {"Name":"John"} errors, wrap it as [{"Name":"John"}].
Start Row usually means row 2
Row 1 typically holds column headers. Set Start Row to 2 to update the first data row without overwriting headers.
Type conversion needs the toggle on
Date Format, Numeric Format, and Culture Name only apply when Convert Numeric And Date is Yes. Left at No, JSON values are written verbatim as text.
Header matching is case-sensitive by default
If your JSON property names differ in case from the column headers, set Ignore Attribute Titles to Yes rather than renaming every header.
Null values overwrite by default
Without Ignore Null Values set to Yes, a null in your JSON blanks the existing cell. Enable it when you only want to update the fields you actually send.
Culture Name affects parsing, not just display
Set Culture Name to match how your source data formats dates and decimals (e.g. de-DE for comma decimals), otherwise conversion can misread values.

Folha de dicas

CampoValor
ModuleUpdate Rows in a worksheet
ConnectionPDF4me API key
Default worksheetSheet1
Json Input shape[{"Column":"Value"}, ...] (array, always)
Typical Start Row2 (skips header row)
Type conversion toggleConvert Numeric And Date = Yes
Default date/numeric formatyyyy-MM-dd / N2
Default cultureen-US

Perguntas frequentes

Does Update Rows insert or delete rows?+
No. The module only modifies cells in rows that already exist in the worksheet. It never inserts new rows or deletes existing ones. Use a different PDF4me Excel module if you need to add or remove rows.
What format must Json Input be in?+
Json Input must be a JSON array of objects, even when updating a single row. A bare object such as {"Name":"John","Age":31} without array brackets causes an error, it must be wrapped as [{"Name":"John","Age":31}].
How does header matching work?+
Each object in the Json Input array has its property names matched against the column headers in the target worksheet. Rows are updated sequentially starting from Start Row, with Start Column controlling any header offset.
What happens to null values in the JSON?+
By default, a null value in the JSON overwrites the corresponding cell as empty. Set Ignore Null Values to Yes to skip updating any cell whose JSON value is null, which preserves the existing content in that cell.
Can I control how dates and numbers are formatted?+
Yes. When Convert Numeric And Date is set to Yes, Date Format and Numeric Format apply Excel formatting patterns such as yyyy-MM-dd or N2, and Culture Name (for example en-US or de-DE) controls how the incoming strings are parsed before conversion. See <a href="https://learn.microsoft.com/en-us/dotnet/standard/base-types/standard-numeric-format-strings" target="_blank" rel="noopener noreferrer">Microsoft's numeric format string reference</a> and <a href="https://learn.microsoft.com/en-us/dotnet/standard/base-types/custom-date-and-time-format-strings" target="_blank" rel="noopener noreferrer">custom date format reference</a> for the full pattern syntax.

Casos de uso e aplicações industriais

  • CRM Atualizações de OportunidadesModificar linhas de oportunidade em Excel com o status mais recente, valores e datas de encerramento
  • Atualização do desempenho da campanhaAtualizar as linhas de métricas da campanha com as impressões, cliques e conversões atuais.
  • Atualizações de pontuação de leadsAtualizar dados de pontuação de leads em Excel Planilhas de rastreamento de automação de marketing
  • Sincronização do banco de dados de clientesAtualizar os registros de clientes com as informações de contato mais recentes e o histórico de compras.
  • Atualizações de previsão de vendasModificar as linhas de previsão com dados atualizados do pipeline e probabilidades de vitória.

Ações relacionadas

Mesma tarefa em outras plataformas

Obtenha ajuda