Importar datos en archivos de Excel y exportar datos desde archivos de Excel

La API de Aspose.Cells Cloud admite la importación de datos desde diversas fuentes y permite exportar libros de trabajo, gráficos y otros objetos de Excel a distintos formatos, incluidos XLSX, CSV, PDF, HTML, PNG, entre otros. Esto simplifica y agiliza la gestión y el intercambio de datos.

Versión de la API: v3.0 – Última actualización: 2024‑03‑15

Guía de inicio rápido

Preparar la carga útil (payload) – Construya un cuerpo JSON que describa las opciones de importación o exportación (por ejemplo, ImportCSVDataOption, ExportOptions).
Enviar la solicitud – Utilice curl, Postman o un SDK para llamar al punto de acceso adecuado (POST /cells/import o POST /cells/export).
Procesar la respuesta – En caso de éxito, recibirá el archivo procesado (binario o en Base64). En caso de error, revise el código de estado HTTP y el mensaje de error devuelto en el cuerpo JSON.

Requisitos previos

Una cuenta activa de Aspose Cloud y un token JWT válido.
El libro de trabajo de destino debe existir en la ubicación especificada del almacenamiento (para las API basadas en almacenamiento).
Cabeceras Content‑Type correctas (multipart/form-data para cargas de archivos, application/json para cuerpos JSON).

Cómo importar datos desde diversas fuentes

La importación de datos en un archivo de Excel implica varias consideraciones que deben abordarse durante el proceso. La capacidad de importar múltiples formatos y tipos de datos con calidad profesional es una característica principal de Aspose.Cells Cloud.

Información sobre las API de importación de datos

A continuación se presentan las API disponibles para importar datos en uno o varios archivos de Excel:

API	Descripción
POST /cells/import	Importar datos en archivos de Excel sin utilizar almacenamiento.
POST /cells/{name}/importdata	Importar datos en un archivo de Excel almacenado en la nube.

Parámetros de solicitud

Sin utilizar almacenamiento

Nombre del parámetro	Tipo	Ubicación	Descripción
file	file	formData	Archivo para cargar
ImportOption	ImportOptions	body	Especifica el formato de importación (IntArray, DoubleArray, StringArray, TwoDimensionIntArray, TwoDimensionDoubleArray, TwoDimensionStringArray, BatchData, csvData, Picture)

Utilizando almacenamiento

Nombre del parámetro	Tipo	Ubicación	Descripción
name	string	path	Nombre del archivo de Excel
folder	string	query	Ruta de la carpeta en almacenamiento
storageName	string	query	Nombre del almacenamiento
importData	ImportOptions	body	Carga útil con datos a importar

Parámetros de la opción de importación de datos

Los parámetros más importantes se describen en las tablas siguientes:

ImportBatchDataOption

Parámetro	Tipo	Descripción
BatchData	List<CellValue>	Datos por lotes para importar
DestinationWorksheet	string	Nombre de la hoja de destino
IsInsert	boolean	Indica si se deben insertar los datos (true/false)
ImportDataType	string	TwoDimensionStringBatchDataArray
Source	FileSource	Ubicación del archivo de datos cuando BatchData es null

ImportCSVDataOption

Parámetro	Tipo	Descripción
ConvertNumericData	boolean	Indica si se deben convertir los datos numéricos (true/false)
FirstRow	int	Índice de la primera fila
FirstColumn	int	Índice de la primera columna
SeparatorString	string	Separador de columnas
DestinationWorksheet	string	Nombre de la hoja de destino
CustomParsers	List<CustomParserConfig>	Configuraciones de analizadores personalizados
ImportDataType	string	CSVData
Source	FileSource	Ubicación del archivo de datos cuando BatchData es null

ImportPictureOption

Parámetro	Tipo	Descripción
FirstRow	int	Índice de la primera fila
FirstColumn	int	Índice de la primera columna
IsVertical	boolean	Indica si la imagen se coloca verticalmente (true/false)
Data	string[]	Datos de la imagen (cadenas en Base64)
DestinationWorksheet	string	Nombre de la hoja de destino
IsInsert	boolean	Indica si se deben insertar los datos (true/false)
ImportDataType	string	Picture
Source	FileSource	Ubicación del archivo de datos cuando BatchData es null

Import2DimensionIntArrayOption

Parámetro	Tipo	Descripción
FirstRow	int	Índice de la primera fila
FirstColumn	int	Índice de la primera columna
Data	int[,]	Matriz entera bidimensional
DestinationWorksheet	string	Nombre de la hoja de destino
IsInsert	boolean	Indica si se deben insertar los datos (true/false)
ImportDataType	string	TwoDimensionIntArray
Source	FileSource	Ubicación del archivo de datos cuando BatchData es null

Import2DimensionDoubleArrayOption

Parámetro	Tipo	Descripción
FirstRow	int	Índice de la primera fila
FirstColumn	int	Índice de la primera columna
Data	double[,]	Matriz de doble precisión bidimensional
DestinationWorksheet	string	Nombre de la hoja de destino
IsInsert	boolean	Indica si se deben insertar los datos (true/false)
ImportDataType	string	TwoDimensionDoubleArray
Source	FileSource	Ubicación del archivo de datos cuando BatchData es null

Import2DimensionStringArrayOption

Parámetro	Tipo	Descripción
FirstRow	int	Índice de la primera fila
FirstColumn	int	Índice de la primera columna
Data	string[,]	Matriz de cadenas bidimensional
DestinationWorksheet	string	Nombre de la hoja de destino
IsInsert	boolean	Indica si se deben insertar los datos (true/false)
ImportDataType	string	TwoDimensionStringArray
Source	FileSource	Ubicación del archivo de datos cuando BatchData es null

ImportIntegerArrayOption

Parámetro	Tipo	Descripción
FirstRow	int	Índice de la primera fila
FirstColumn	int	Índice de la primera columna
IsVertical	boolean	Indica si la matriz es vertical (true/false)
Data	int[]	Matriz entera unidimensional
DestinationWorksheet	string	Nombre de la hoja de destino
IsInsert	boolean	Indica si se deben insertar los datos (true/false)
ImportDataType	string	IntegerArray
Source	FileSource	Ubicación del archivo de datos cuando BatchData es null

ImportDoubleArrayOption

Parámetro	Tipo	Descripción
FirstRow	int	Índice de la primera fila
FirstColumn	int	Índice de la primera columna
IsVertical	boolean	Indica si la matriz es vertical (true/false)
Data	double[]	Matriz de doble precisión unidimensional
DestinationWorksheet	string	Nombre de la hoja de destino
IsInsert	boolean	Indica si se deben insertar los datos (true/false)
ImportDataType	string	DoubleArray
Source	FileSource	Ubicación del archivo de datos cuando BatchData es null

ImportStringArrayOption

Parámetro	Tipo	Descripción
UpperLeftRow	int	Índice de fila superior izquierdo
UpperLeftColumn	int	Índice de columna superior izquierdo
LowerRightRow	int	Índice de fila inferior derecho
LowerRightColumn	int	Índice de columna inferior derecho
Filename	string	Nombre del archivo de origen
Data	string	Datos de cadena a importar
DestinationWorksheet	string	Nombre de la hoja de destino
IsInsert	boolean	Indica si se deben insertar los datos (true/false)
ImportDataType	string	StringArray
Source	FileSource	Ubicación del archivo de datos cuando BatchData es null

CellValue

Parámetro	Tipo	Descripción
rowIndex	int	Índice de fila de la celda
columnIndex	int	Índice de columna de la celda
type	string	Tipo de dato del valor de la celda
value	string	Valor de la celda
style	Style (object)	Definición del estilo de celda

FileSource

Parámetro	Tipo	Descripción
FileSourceType	string	InMemoryFiles, CloudFileSystem o RequestFiles
FilePath	string	Ruta al archivo de origen

Cómo exportar objetos de Excel a distintos formatos de archivo

Si originalmente creó un archivo de Excel en un formato como XLS, XLSX, XLSB o CSV, es posible que desee convertirlo a otro formato para aprovechar características específicas. Por ejemplo, exportar a PDF protege el contenido frente a modificaciones no autorizadas y facilita su lectura y compartición.

La exportación de objetos de Excel implica varias consideraciones. Aspose.Cells Cloud proporciona una exportación de alta calidad de libros de trabajo, gráficos, formas e imágenes a una amplia gama de formatos:

Formatos solo para exportación: PDF, OTS, XPS, DIF, PNG, JPEG, BMP, SVG, TIFF, EMF, NUMBERS, FODS.
Formatos con importación y exportación: XLS, XLSX, XLSB, CSV, TSV, XLSM, ODS, TXT.

La solicitud utiliza contenido multiparto según lo definido en [RFC 2046] y [RFC 1341]. La primera parte contiene el archivo de datos; la segunda parte contiene las opciones de guardado.

Información sobre la API de exportación

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

Parámetros de solicitud

Nombre del parámetro	Tipo	Ubicación	Descripción
file	file	formData	Archivo para cargar
objectType	string	query	Tipo de objeto (`workbook`, `worksheet`, `chart`, `shape`, `picture`, `listobject`, `oleobject`)
format	string	query	Formato de archivo de salida deseado (ver Formatos de archivo admitidos)

La Especificación OpenAPI define una interfaz de programación públicamente accesible que permite realizar interacciones REST directamente desde un navegador web.

Puede utilizar la herramienta de línea de comandos cURL para llamar a la API. El ejemplo siguiente muestra una solicitud y su respuesta JSON.

Solicitud

curl -v "https://api.aspose.cloud/v3.0/cells/export" \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -F 'file1=@example1.xlsx' \
  -F 'file2=@example2.xlsx'

Respuesta

{
  "Files": [
    {
      "Filename": "example1.pdf",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    },
    {
      "Filename": "example2.pdf",
      "FileSize": 274022,
      "FileContent": "-----Base64String--------"
    }
  ]
}

Códigos de estado HTTP comunes

Estado	Significado	Acción recomendada
200	Correcto – el archivo se ha exportado	Procesar el/los archivo(s) devuelto(s)
400	Solicitud incorrecta – parámetros faltantes o inválidos	Verifique la carga útil y las cadenas de consulta
401	No autorizado – token JWT inválido o caducado	Actualice el token y vuelva a intentarlo
404	No encontrado – el libro de trabajo o la hoja especificados no existen	Compruebe el nombre del archivo y la ruta del almacenamiento
500	Error interno del servidor – condición inesperada en el servidor	Póngase en contacto con el soporte técnico de Aspose con el ID de solicitud

Cómo llamar a las API de importación y exportación

Los siguientes artículos explican cada API en detalle y contienen ejemplos de cURL y SDK:

Fusionar y dividir archivos de Excel Convertir un archivo de Excel a otro formato o guardarlo de forma diferente.