XLSX Append Incremental

Anexa datos nuevos y genera cursor de procesamiento

Soporta cursor por tiempo o clave primaria.

Resultados de ejemplo

1 Ejemplos

Append incremental con cursor

Agrega filas nuevas y genera el siguiente cursor

xlsx-append-incremental-example1.zip Ver archivo
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

Datos clave

Categoría
Conversión y codificación
Tipos de entrada
file, text, number, select
Tipo de salida
file
Cobertura de muestras
4
API disponible
Yes

Resumen

XLSX Append Incremental es una herramienta diseñada para automatizar la integración de nuevos datos en tus hojas de cálculo existentes, permitiendo actualizaciones precisas mediante el uso de cursores basados en tiempo o claves primarias.

Cuándo usarlo

  • Cuando necesitas consolidar reportes diarios o semanales en un archivo maestro sin duplicar registros.
  • Al automatizar flujos de trabajo ETL donde los datos nuevos deben añadirse secuencialmente a una base de datos Excel.
  • Para mantener sincronizados registros de ventas o inventarios basándose en una columna de fecha o un ID único.

Cómo funciona

  • Carga tu archivo base y el archivo que contiene los nuevos datos incrementales.
  • Selecciona el modo de cursor (tiempo o clave primaria) y especifica la columna de referencia.
  • Define el último valor procesado para filtrar y añadir únicamente los registros nuevos.
  • Descarga el archivo resultante con los datos actualizados y el nuevo estado del cursor.

Casos de uso

Actualización automática de reportes de ventas diarios desde archivos exportados de un CRM.
Consolidación de registros de logs de servidores en una única hoja de cálculo maestra.
Gestión de inventarios donde se añaden nuevos movimientos basándose en un ID de transacción único.

Ejemplos

1. Consolidación de ventas diarias

Analista de Datos
Contexto
El analista recibe diariamente un archivo Excel con nuevas transacciones de ventas que deben integrarse en un reporte maestro.
Problema
Evitar la duplicación de registros y asegurar que solo se añadan las ventas nuevas desde el último ID procesado.
Cómo usarlo
Cargar el archivo maestro y el archivo diario, configurar el modo de cursor a 'primary-key' usando la columna 'id' y establecer el último valor en '5'.
Configuración de ejemplo
{"targetSheetName": "Tools API", "cursorMode": "primary-key", "cursorColumn": "id", "lastCursorValue": "5"}
Resultado
El archivo maestro se actualiza con las nuevas filas de ventas y se genera un nuevo cursor para la siguiente ejecución.

Probar con muestras

xml, xlsx, xls

Hubs relacionados

Preguntas frecuentes

¿Qué formatos de archivo soporta?

La herramienta es compatible con archivos en formato .xlsx y .xls.

¿Cómo funciona el modo de cursor por tiempo?

Utiliza una columna de fecha u hora para identificar y anexar solo las filas con valores posteriores al último cursor registrado.

¿Puedo elegir en qué hoja específica se añaden los datos?

Sí, puedes indicar el nombre de la hoja de destino en la configuración para asegurar que los datos se inserten en el lugar correcto.

¿Qué sucede si no especifico un valor de cursor inicial?

La herramienta procesará los datos basándose en la configuración predeterminada, pero se recomienda definir el último valor para evitar duplicados.

¿Es posible usar una clave primaria para el incremento?

Sí, seleccionando el modo 'primary-key', la herramienta comparará los IDs únicos para añadir solo los registros nuevos al archivo base.

Documentación de la API

Punto final de la solicitud

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

Parámetros de la solicitud

Nombre del parámetro Tipo Requerido Descripción
baseWorkbookFile file (Subida requerida) -
incrementalWorkbookFile file (Subida requerida) -
targetSheetName text No -
headerRow number No -
cursorMode select No -
cursorColumn text -
lastCursorValue text No -

Los parámetros de tipo archivo necesitan ser subidos primero vía POST /upload/xlsx-append-incremental para obtener filePath, luego pasar filePath al campo de archivo correspondiente.

Formato de respuesta

{
  "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)"
}
Archivo: Archivo

Documentación de MCP

Agregue este herramienta a su configuración de servidor MCP:

{
  "mcpServers": {
    "elysiatools-xlsx-append-incremental": {
      "name": "xlsx-append-incremental",
      "description": "Anexa datos nuevos y genera cursor de procesamiento",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=xlsx-append-incremental",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Puede encadenar múltiples herramientas, por ejemplo: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, máximo 20 herramientas.

Soporte para enlaces de archivos URL o codificación Base64 para parámetros de archivo.

Si encuentra algún problema, por favor, póngase en contacto con nosotros en [email protected]