Pular para o conteúdo principal

Atualizar linhas em Excel em Power Automate

PDF4me Excel - Atualizar linhas é um Power Automate ação que modifica células existentes em uma planilha, fazendo a correspondência. JSON Atribua nomes de propriedades a cabeçalhos de coluna. Use isso para sincronizar alterações no banco de dados e atualizar. CRM registros ou atualizar colunas de status em um Excel Relatório sem inserir ou excluir nenhuma linha.

O que esta ação faz

PDF4me Excel - Atualizar linhas escreve um JSON A função converte uma matriz de objetos em linhas existentes, começando na Linha Inicial, associando cada nome de propriedade a um cabeçalho de coluna. As opções Converter Numérico e Data, Formato de Data, Formato Numérico e Nome da Cultura controlam como os valores são digitados e formatados. Ela nunca insere ou exclui linhas; apenas as células correspondentes são alteradas.

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? Power Automate Fluxo?

Todo PDF4me ação em Power Automate Requer uma conexão válida. Crie ou selecione uma que mantenha sua conexão ativa. PDF4me API chave para que o fluxo possa autenticar Excel As solicitações de atualização de linha são processadas com segurança.

Fatos importantes que você não deve perder

Esta função atualiza as linhas, não as insere.
Os objetos em JSON Update Data são aplicados sequencialmente às linhas existentes, começando pela Linha Inicial. Não há pesquisa baseada em chave; use Adicionar Linhas primeiro se a linha ainda não existir.
O campo de dados está rotulado. JSON Atualizar dados
Deve ser sempre um JSON array, mesmo para uma única linha. Um objeto vazio, sem colchetes de array, retorna um erro "JsonData deve ser um array".
A conversão de tipo requer que a opção esteja ativada.
Os formatos de data, numérico e nome da cultura só entram em vigor quando a opção "Converter em Numérico e Data" está ativada. Caso contrário, todos os valores são gravados em texto simples.
A ação "Atualizar Linhas" do Power Automate PDF4me Excel foi configurada com os seguintes parâmetros: Conteúdo do Arquivo, Nome do Arquivo, Nome da Planilha (Sheet1), Atualização de Dados JSON, Linha Inicial 20, Coluna Inicial 1 e parâmetros avançados, incluindo "Converter Numérico e Data: Sim", Formato de Data: aaaa-MM-dd e Formato Numérico: N2.

Conteúdo do arquivo de mapa e nome do arquivo, definir JSON Atualize os dados e a linha inicial e, em seguida, expanda os parâmetros avançados para conversão de tipo e formatação.

Parâmetros

Obrigatório: Conteúdo do arquivo, nome do arquivo e JSON Os dados de atualização devem sempre ser fornecidos. JSON Os dados de atualização devem ser um JSON array, um objeto vazio é rejeitado.

ParâmetroObrigatórioO que fazExemplo
File ContentRequiredBase64 content of the source Excel workbook, mapped from SharePoint, OneDrive, or another prior action.[File Content from Get File]
File NameRequiredExcel filename including extension (.xlsx or .xls), used for processing and output identification.data.xlsx
JSON Update DataRequiredJSON array of objects to update. Each object updates one row sequentially starting at Start Row. Must be an array, a bare single object is rejected.[{"Name":"John","Age":31}]
Worksheet NameOptionalName of the worksheet to update. Defaults to the first worksheet if left blank.Sheet1
Start RowOptional1-based row number to start updating. Default 1, typically set to 2 or higher to skip a header row.2
Start ColumnOptional1-based column offset for header matching. Default 1 (column A).1
Convert Numeric And DateOptionalEnables automatic conversion of JSON numbers to Excel numeric values and date-like strings to Excel dates. Default true.true
Date FormatOptionalExcel date format applied when Convert Numeric And Date is enabled. Default yyyy-MM-dd.MM/dd/yyyy
Numeric FormatOptionalExcel numeric format applied when Convert Numeric And Date is enabled. Default N2.#,##0.00
Ignore Null ValuesOptionalSkips updating a cell for any JSON property that is null when enabled. Default false, which writes nulls as empty cells.false
Ignore Attribute TitlesOptionalMakes JSON property name matching case-insensitive against column headers when enabled. Default false.true
Culture NameOptionalCulture code used to parse incoming date and number strings before conversion. Default empty (system default).en-US

Campos de saída

CampoTipoO que contém
documentBase64The Excel workbook with the matched rows updated.
SuccessBooleantrue if the update completed, false if the action failed.
ErrorMessageStringError description, null when Success is true.
ErrorsArrayDetailed error objects with Code and Message, empty when Success is true.

O que significam as mensagens de erro comuns?

Mensagem de erroCausaSolução
Request is emptyThe request object is null.Provide a valid request object.
Document is emptyFile Content is null or empty.Map a valid Excel document into File Content.
Invalid worksheet selectionThe named worksheet does not exist.Use an existing worksheet name or leave it blank for the first sheet.
No headers found in worksheetThe target row (or Start Row minus one) has no headers.Ensure the header row exists directly above the rows you are updating.
JsonData must be an arrayA bare single object was provided instead of an array.Wrap the object in array brackets, for example [{"Name":"John"}].

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

  1. Adicionar PDF4meExcel - Atualizar linhas para o seu Power Automate fluxo.
  2. Mapa Conteúdo do arquivo e Nome do arquivo de uma ação anterior (SharePoint, OneDriveou um conector de banco de dados).
  3. Definir Dados de atualização JSON para um JSON matriz de objetos, um por linha para atualizar.
  4. Definir Linha inicial para a primeira linha a ser atualizada (ignorar linhas de cabeçalho) e Coluna inicial para o deslocamento do cabeçalho.
  5. Expand Parâmetros avançados para habilitar Converter valores numéricos e datas e defina a formatação. Execute o fluxo; a planilha atualizada retorna como documento.

Configurações típicas

Exemplos de fluxo de trabalhoCommon Power Automate flow patterns using Update Rows.
Sincronização diária de estoque
  1. Um gatilho programado consulta o banco de dados para obter níveis de estoque atualizados.
  2. Os resultados são convertidos em um JSON matriz correspondente aos cabeçalhos das colunas da planilha de inventário.
  3. A função Obter conteúdo do arquivo recupera a planilha principal de inventário de SharePoint.
  4. A opção Atualizar Linhas aplica a matriz a partir da Linha Inicial 2, com a opção Converter Numérico e Data ativada para contagens de estoque em números inteiros.
  5. A planilha de inventário atualizada é salva novamente em SharePoint.
Atualização do status do pedido
  1. Um fluxo é acionado quando o status de um pedido muda no sistema de gerenciamento de pedidos.
  2. O cenário constrói um JSON matriz com o campo de status atualizado para as linhas afetadas.
  3. A função "Obter conteúdo do arquivo" recupera o registro de rastreamento do pedido.
  4. A opção "Atualizar linhas" aplica a alteração com a opção "Ignorar valores nulos" ativada, portanto, as outras colunas de pedido permanecem inalteradas.
  5. O registro atualizado é salvo novamente em SharePoint.
Atualização de contatos do CRM
  1. Consultas de gatilho semanais Dynamics 365 para contatos modificados nos últimos 7 dias.
  2. Os registros são convertidos em um JSON matriz com campos de contato e última modificação.
  3. A opção Atualizar Linhas aplica as alterações com a opção Ignorar Títulos de Atributos ativada para correspondência de cabeçalho sem distinção entre maiúsculas e minúsculas.
  4. A lista de contatos atualizada é arquivada com um registro de data e hora.

Dicas práticas

This is not a lookup-and-match update
Rows are updated sequentially from Start Row, there is no key column matching. Sort or filter your JSON array to match the row order in the workbook before calling this action.
JSON Update Data must be an array, always
Even a single-row update needs array brackets: [{"Name":"John"}], not {"Name":"John"}. Omitting the brackets returns a JsonData must be an array error.
Start Row usually skips the header
Row 1 typically holds column headers, so most flows set Start Row to 2 or higher to begin updating actual data rows.
Culture Name affects parsing, not just display
Set Culture Name to match how your source data formats dates and decimals (for example de-DE for comma decimals), otherwise conversion can misread values.
Ignore Attribute Titles solves case-mismatch headaches
If your JSON property names differ in case from the Excel column headers, enable Ignore Attribute Titles instead of renaming every header or every JSON key.

Folha de dicas

CampoValor
ActionExcel - Update Rows
Required fieldsFile Content, File Name, JSON Update Data (array)
Default start row1 (set to 2+ to skip headers)
Default start column1 (column A)
Type conversion toggleConvert Numeric And Date = true (default)
Default date/numeric formatyyyy-MM-dd / N2
Outputdocument (Base64 workbook) + Success + ErrorMessage + Errors

Perguntas frequentes

How do I update existing Excel rows in Power Automate?+
Add the PDF4me Excel - Update Rows action, map File Content and File Name from a prior action, set JSON Update Data to a JSON array of objects (one per row), and set Start Row to the first data row to update.
Does Update Rows insert new rows if a match is not found?+
No. Update Rows only modifies existing cells starting at Start Row, it does not insert or delete rows. Objects are applied sequentially to consecutive rows beginning at Start Row, there is no lookup-and-match against a key column.
Why must JSON Update Data be an array even for one row?+
The action always expects a JSON array of objects. A bare single object such as {"Name":"John"} returns a JsonData must be an array error, wrap it as [{"Name":"John"}] even when updating only one row.
How does automatic type conversion work?+
With Convert Numeric And Date enabled, JSON numbers become Excel numeric values formatted with Numeric Format, and date-like strings become Excel DateTime values formatted with Date Format. Culture Name controls how the incoming values 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> for the supported format codes.
What happens to a JSON property that has no matching column header?+
It is ignored for that row. Only JSON properties whose names match an existing column header (case-sensitive unless Ignore Attribute Titles is enabled) are written to a cell. See the <a href="https://learn.microsoft.com/en-us/connectors/pdf4meconnect/" target="_blank" rel="noopener noreferrer">PDF4me Power Automate connector reference</a> for the full action schema.

Casos de uso e aplicações industriais

  • Atualizações sobre o status dos leadsAtualizar o status de qualificação de leads em planilhas de controle do Excel.
  • Métricas de campanhaAtualizar métricas de desempenho da campanha a partir de plataformas de análise.
  • Registros de clientesSincronizar informações de contato do cliente do CRM para o Excel
  • Cotas de VendasAtualizar as metas de vendas mensais e os resultados reais em painéis do Excel.

Ações relacionadas

Mesma tarefa em outras plataformas

Obtenha ajuda