XLSX Append Incremental

Acrescenta dados incrementalmente e gera cursor

Suporta cursor por tempo ou chave primaria.

Exemplos de resultados

1 Exemplos

Append incremental com cursor

Acrescenta novas linhas e gera proximo cursor

xlsx-append-incremental-example1.zip Ver arquivo
Ver parâmetros de entrada
{ "baseWorkbookFile": "/public/samples/xlsx/workbook-sales.xlsx", "incrementalWorkbookFile": "/public/samples/xlsx/workbook-sales.xlsx", "targetSheetName": "Tools API", "cursorMode": "primary-key", "cursorColumn": "id", "lastCursorValue": "5" }

Click to upload file or drag and drop file here

Maximum file size: 200MB Supported formats: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.ms-excel

Click to upload file or drag and drop file here

Maximum file size: 200MB Supported formats: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet, application/vnd.ms-excel

Fatos principais

Categoria
Conversão e codificação
Tipos de entrada
file, text, number, select
Tipo de saída
file
Cobertura de amostras
4
API disponível
Yes

Visão geral

O XLSX Append Incremental é uma ferramenta eficiente para atualizar planilhas de forma automatizada, permitindo adicionar novos dados a um arquivo base com base em critérios de tempo ou chaves primárias.

Quando usar

  • Sincronizar novos registros de vendas ou logs em um arquivo mestre de Excel.
  • Evitar duplicidade de dados ao consolidar relatórios periódicos.
  • Automatizar fluxos de trabalho de ETL onde apenas os dados mais recentes precisam ser processados.

Como funciona

  • Carregue o arquivo base e o arquivo contendo os novos dados incrementais.
  • Defina a coluna de referência (cursor) que identifica os novos registros, como uma data ou ID único.
  • Escolha o modo de cursor (tempo ou chave primária) para filtrar o que deve ser adicionado.
  • Execute a ferramenta para gerar um arquivo consolidado e o valor do cursor atualizado para a próxima execução.

Casos de uso

Consolidação de relatórios de vendas diários em um único arquivo anual.
Atualização de inventário com novos itens recebidos via planilha externa.
Integração de logs de sistema exportados em Excel para um banco de dados de acompanhamento.

Exemplos

1. Atualização de Vendas Diárias

Analista de Dados
Contexto
O analista recebe diariamente um arquivo com novas vendas e precisa anexá-las ao relatório mestre.
Problema
Adicionar manualmente as linhas todos os dias é propenso a erros e consome tempo.
Como usar
Configurar o modo de cursor como 'primary-key' na coluna 'id' e fornecer o último ID processado.
Configuração de exemplo
cursorMode: primary-key, cursorColumn: id, lastCursorValue: 5
Resultado
O arquivo mestre é atualizado apenas com os registros que possuem ID superior a 5, mantendo a integridade do histórico.

Testar com amostras

xml, xlsx, xls

Hubs relacionados

FAQ

O que é o modo de cursor?

O modo de cursor define como a ferramenta identifica novos dados: por 'Tempo' (data/hora) ou por 'Chave Primária' (ID único).

Posso usar arquivos .xls e .xlsx?

Sim, a ferramenta suporta ambos os formatos de arquivo do Microsoft Excel.

O que acontece se eu não definir um valor de cursor inicial?

A ferramenta processará os dados com base na estrutura da coluna selecionada, mas é recomendável fornecer o último valor processado para garantir a precisão.

A ferramenta altera o arquivo original?

Não, a ferramenta gera um novo arquivo consolidado, mantendo seus arquivos originais intactos.

Como a ferramenta lida com o cabeçalho?

Você pode especificar em qual linha o cabeçalho está localizado para garantir que a mesclagem dos dados seja feita corretamente.

Documentação da API

Ponto final da solicitação

POST /pt/api/tools/xlsx-append-incremental

Parâmetros da solicitação

Nome do parâmetro Tipo Requerido Descrição
baseWorkbookFile file (Upload necessário) Sim -
incrementalWorkbookFile file (Upload necessário) Sim -
targetSheetName text Não -
headerRow number Não -
cursorMode select Não -
cursorColumn text Sim -
lastCursorValue text Não -

Os parâmetros de tipo arquivo precisam ser carregados primeiro via POST /upload/xlsx-append-incremental para obter filePath, depois filePath deve ser passado ao campo de arquivo correspondente.

Formato de resposta

{
  "filePath": "/public/processing/randomid.ext",
  "fileName": "output.ext",
  "contentType": "application/octet-stream",
  "size": 1024,
  "metadata": {
    "key": "value"
  },
  "error": "Error message (optional)",
  "message": "Notification message (optional)"
}
Arquivo: Arquivo

Documentação de MCP

Adicione este ferramenta à sua configuração de servidor MCP:

{
  "mcpServers": {
    "elysiatools-xlsx-append-incremental": {
      "name": "xlsx-append-incremental",
      "description": "Acrescenta dados incrementalmente e gera cursor",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=xlsx-append-incremental",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Você pode encadear várias ferramentas, ex: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, máx 20 ferramentas.

Suporta links de arquivos URL ou codificação Base64 para parâmetros de arquivo.

Se você encontrar algum problema, por favor, entre em contato conosco em [email protected]