Импорт массива строк в рабочий лист Excel – Aspose.Cells Cloud

Импорт массива строк в рабочий лист Excel — распространённая задача при заполнении электронных таблиц данными в виде списков. Эта операция полезна, например, при загрузке значений конфигурации, передаче данных из внешних источников или инициализации рабочих листов заранее заданными наборами строк.

Необходимые условия:

  • Действующий JWT-токен, полученный в рамках процедуры аутентификации Aspose.Cells Cloud.
  • Существующая рабочая книга (или возможность её создания) в хранилище Aspose Cloud.
  • Соответствующая версия SDK, поддерживающая модель ImportStringArrayOption.

Этот REST API позволяет импортировать данные в виде массива строк в рабочий лист Excel.

API PostImportData

POST https://api.aspose.cloud/v3.0/cells/import

Безопасность и аутентификация

API Aspose.Cells Cloud защищены и требуют аутентификации по токену JWT.

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

Запрос использует многокомпонентное HTTP-содержимое (см. RFC 2046 или RFC 1341).
Первая часть многокомпонентного тела содержит полезную нагрузку ImportStringArrayOption, а вторая — исходный файл с данными.

Важные параметры описаны в следующей таблице:

Параметры ImportStringArrayOption ### **ImportStringArrayOption**
Имя параметра Тип Описание
FirstRow int Индекс начальной строки (с 1), куда будут помещены данные.
FirstColumn int Индекс начального столбца (с 1), куда будут помещены данные.
IsVertical boolean true, чтобы вставить данные вертикально; false, чтобы вставить горизонтально.
Data String[] Массив строк для импорта.
DestinationWorksheet string Имя рабочего листа, в который будут импортированы данные.
IsInsert boolean true, чтобы вставить строки/столбцы (со смещением существующих ячеек); false, чтобы перезаписать существующие ячейки.
ImportDataType string Тип импортируемых данных (например, IntArray, DoubleArray, StringArray, TwoDimensionIntArray, TwoDimensionDoubleArray, TwoDimensionStringArray, BatchData, csvData).
Source FileSource Указывает местоположение файла с данными, когда BatchData равен null (например, CloudFileSystem, LocalFile). Обязателен, если BatchData не указан.

Пример

<ImportStringArrayOption>
    <DestinationWorksheet>Sheet1</DestinationWorksheet>
    <IsInsert>false</IsInsert>
    <ImportDataType>StringArray</ImportDataType>
    <FirstRow>1</FirstRow>
    <FirstColumn>1</FirstColumn>
    <IsVertical>true</IsVertical>
    <Source>
        <FileSourceType>CloudFileSystem</FileSourceType>
        <FilePath>Array_string_xml.txt</FilePath>
    </Source>
</ImportStringArrayOption>

Ответ

Успешный запрос возвращает HTTP 200 с JSON-полезной нагрузкой следующего вида:

{
  "Code": 200,
  "Status": "OK"
}

Возможные коды состояния:

Код Значение
200 Импорт успешно завершён
400 Неверный запрос — отсутствуют или недопустимы данные
401 Неавторизованный доступ — недействительный или отсутствующий токен
500 Внутренняя ошибка сервера

Как использовать API PostImportData с SDK

Спецификация API PostImportData

Спецификация OpenAPI определяет публично доступное программное интерфейсное описание и позволяет выполнять взаимодействие с REST напрямую из веб-браузера.

Использование SDK Aspose.Cells Cloud

Использование SDK — лучший способ ускорить разработку. SDK обрабатывает низкоуровневые детали, позволяя сосредоточиться на задачах вашего проекта. Полный список SDK Aspose.Cells Cloud доступен в репозитории на GitHub.

Следующие примеры кода демонстрируют вызов веб-сервисов Aspose.Cells с использованием различных SDK:

Импорт целочисленного массива в рабочую тетрадь Excel