XLSX инкрементальный аппенд

Инкрементально добавляет данные и генерирует курсор

Поддерживает курсор по времени или первичному ключу.

Примеры результатов

1 Примеры

Инкрементальное добавление с курсором

Добавляет новые строки и создает следующий курсор

xlsx-append-incremental-example1.zip Показать файл
Показать параметры ввода
{ "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

Ключевые факты

Категория
Преобразование и кодирование
Типы входных данных
file, text, number, select
Тип результата
file
Покрытие примерами
4
API доступен
Yes

Обзор

Инструмент для инкрементального объединения XLSX-файлов, позволяющий автоматически добавлять новые записи в существующую таблицу на основе временных меток или уникальных идентификаторов.

Когда использовать

  • При необходимости регулярного обновления мастер-файла отчета новыми данными из ежедневных выгрузок.
  • Когда нужно объединить несколько файлов Excel, исключив дубликаты на основе первичного ключа.
  • При автоматизации ETL-процессов, где требуется отслеживать прогресс обработки данных с помощью курсора.

Как это работает

  • Загрузите базовый файл и файл с новыми данными в формате XLSX.
  • Выберите режим курсора (по времени или по первичному ключу) и укажите соответствующий столбец.
  • Укажите последнее известное значение курсора, чтобы инструмент отфильтровал только новые записи.
  • Получите обновленный файл с добавленными данными и актуальное значение курсора для следующей итерации.

Сценарии использования

Обновление сводных таблиц продаж новыми транзакциями за день.
Синхронизация списков клиентов из разных отделов в единую базу данных.
Автоматизированная подготовка отчетов для BI-систем на основе инкрементальных выгрузок.

Примеры

1. Обновление базы продаж

Аналитик данных
Контекст
Ежедневно поступают новые файлы с продажами, которые нужно добавлять в общий мастер-файл.
Проблема
Ручное копирование строк приводит к ошибкам и дублированию данных.
Как использовать
Загрузите основной файл и файл с новыми продажами, выберите режим 'Первичный ключ' по столбцу 'id' и укажите последнее значение '5'.
Пример конфигурации
targetSheetName: 'Tools API', cursorMode: 'primary-key', cursorColumn: 'id', lastCursorValue: '5'
Результат
В мастер-файл добавлены только записи с ID больше 5, исключая уже имеющиеся данные.

Проверить на примерах

xml, xlsx, xls

Связанные хабы

FAQ

Какие форматы файлов поддерживаются?

Инструмент работает с файлами в форматах .xlsx и .xls.

Что такое режим курсора?

Это метод отслеживания новых данных: по времени (например, столбец updated_at) или по уникальному идентификатору (primary key).

Можно ли указать конкретный лист для объединения?

Да, вы можете задать имя целевого листа в параметре 'Целевой Sheet Имя'.

Что произойдет, если я не укажу последнее значение курсора?

Инструмент может обработать все данные или потребовать значение для корректной фильтрации новых записей.

Что я получу на выходе?

Вы получите обновленный XLSX-файл с добавленными строками и JSON-файл с новым значением курсора.

Документация API

Конечная точка запроса

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

Параметры запроса

Имя параметра Тип Обязательно Описание
baseWorkbookFile file (Требуется загрузка) Да -
incrementalWorkbookFile file (Требуется загрузка) Да -
targetSheetName text Нет -
headerRow number Нет -
cursorMode select Нет -
cursorColumn text Да -
lastCursorValue text Нет -

Параметры типа файл должны быть загружены сначала через POST /upload/xlsx-append-incremental для получения filePath, затем filePath должен быть передан в соответствующее поле файла.

Формат ответа

{
  "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)"
}
Файл: Файл

Документация MCP

Добавьте этот инструмент к конфигурации сервера MCP:

{
  "mcpServers": {
    "elysiatools-xlsx-append-incremental": {
      "name": "xlsx-append-incremental",
      "description": "Инкрементально добавляет данные и генерирует курсор",
      "baseUrl": "https://elysiatools.com/mcp/sse?toolId=xlsx-append-incremental",
      "command": "",
      "args": [],
      "env": {},
      "isActive": true,
      "type": "sse"
    }
  }
}

Вы можете объединять несколько инструментов, например: `https://elysiatools.com/mcp/sse?toolId=png-to-webp,jpg-to-webp,gif-to-webp`, максимум 20 инструментов.

Поддерживает ссылки на файлы URL или кодирование Base64 для параметров файла.

Если вы столкнулись с проблемами, пожалуйста, свяжитесь с нами по адресу [email protected]