Import String Array into Excel Worksheet – Aspose.Cells Cloud

REST API

This REST API imports string‑array data into an Excel worksheet.

POST https://api.aspose.cloud/v3.0/cells/import
POST https://api.aspose.cloud/v3.0/cells/{name}/importdata

Security and Authentication

The Aspose.Cells Cloud APIs are secure and require JWT token-based authentication.

Request Parameters

The request uses multipart HTTP content (see RFC 2046 or RFC 1341).
The first part of the multipart body contains an ImportStringArrayOption payload; the second part contains the source data file.

The important parameters are described in the following table:

ImportStringArrayOption parameters ### **ImportStringArrayOption**

Parameter Name	Type	Description
FirstRow	int	The starting row index (1‑based) where the data will be placed.
FirstColumn	int	The starting column index (1‑based) where the data will be placed.
IsVertical	boolean	`true` to insert data vertically; `false` to insert horizontally.
Data	String[]	The string array to be imported.
DestinationWorksheet	string	The name of the worksheet that will receive the data.
IsInsert	boolean	`true` to insert rows/columns (shifting existing cells); `false` to overwrite existing cells.
ImportDataType	string	Type of data being imported (e.g., `IntArray`, `DoubleArray`, `StringArray`, `TwoDimensionIntArray`, `TwoDimensionDoubleArray`, `TwoDimensionStringArray`, `BatchData`, `csvData`).
Source	FileSource	Describes where the data file resides when BatchData is null (e.g., `CloudFileSystem`, `LocalFile`). Required if `BatchData` is not supplied.

Example

<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>

Response

A successful request returns HTTP 200 with a JSON payload similar to:

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

Possible status codes:

Code	Meaning
200	Import succeeded
400	Bad request – missing or invalid data
401	Unauthorized – invalid or missing token
500	Internal server error

How to Use the PostImportData API with SDKs

PostImportData API Specification

The OpenAPI Specification defines a publicly accessible programming interface and lets you carry out REST interactions directly from a web browser.

Use Aspose.Cells Cloud SDKs

Using an SDK is the best way to speed up development. An SDK handles low‑level details, allowing you to focus on your project tasks. Please check out the GitHub repository for a complete list of Aspose.Cells Cloud SDKs.

The following code examples demonstrate how to call Aspose.Cells web services using various SDKs:

Import Integer Array into Excel Worksheet