Fusionar hojas de cálculo coincidentes en una carpeta remota

Combina múltiples archivos de hojas de cálculo que residen en una carpeta remota del almacenamiento en la nube de Aspose Cloud en un único archivo de salida. La operación se ejecuta completamente en la nube, eliminando la necesidad de descargar los archivos fuente localmente. Se admiten más de 30 formatos de salida (PDF, CSV, JSON, XLSX, ODS, XPS, …).

API MergeSpreadsheetsInRemoteFolder

PUT https://api.aspose.cloud/v4.0/cells/merge/remote-spreadsheets

Seguridad y autenticación

Las API de Aspose.Cells Cloud son seguras y requieren autenticación basada en token JWT.

Parámetros de solicitud

Nombre Tipo Ubicación Obligatorio Descripción
folder string query Sí Carpeta del almacenamiento en la nube que contiene las hojas de cálculo fuente.
fileMatchExpression string query Sí Patrón para seleccionar archivos (por ejemplo, *report*.xlsx). Admite comodines * y ?.
outFormat string query Sí Formato de salida deseado (PDF, CSV, JSON, XLSX, ODS, XPS, …).
mergeInOneSheet boolean query Sí true – todos los datos se fusionan en una única hoja de cálculo. false – cada archivo fuente obtiene su propia hoja de cálculo.
storageName string query No Nombre personalizado del almacenamiento; por defecto se usa el almacenamiento principal si se omite.
outPath string query No Carpeta de destino para el archivo fusionado. Si se omite, el archivo se guarda en la carpeta fuente.
outStorageName string query No Nombre del almacenamiento donde se escribirá el archivo fusionado.
fontsLocation string query No Ruta a una carpeta que contiene fuentes personalizadas (necesaria para exportación a PDF/imágenes).
region string query No Configuración regional para el formato de números, fechas y monedas (por ejemplo, es-ES, en-US).
password string query No Contraseña para abrir cualquier hoja de cálculo fuente protegida.

Ejemplo de solicitud (cURL) 

curl -X PUT "https://api.aspose.cloud/v4.0/cells/merge/remote-spreadsheets?folder=MyFolder&fileMatchExpression=*.xlsx&outFormat=PDF&mergeInOneSheet=true" \
     -H "Authorization: Bearer <access_token>" \
     -H "Accept: application/json"

Respuesta

{
  "Name": "ResponseFile",
  "DataType": {
    "Identifier": "File",
    "Reference": "Stream"
  }
}

El archivo se puede descargar directamente desde FileUrl o guardarse en la ubicación especificada por outPath.

Detalles de la respuesta correcta

Código de estado Tipo de contenido Descripción
200 OK application/octet-stream Flujo binario del archivo del libro fusionado.
202 Accepted application/json JSON que contiene FileUrl, FileName, etc.

Códigos de estado HTTP

Código Significado Descripción
200 OK Filtro aplicado correctamente; la respuesta contiene detalles de la operación.
400 Solicitud incorrecta Parámetros ausentes o no válidos (por ejemplo, tipo de archivo no admitido).
401 No autorizado Token JWT no válido o ausente.
413 Carga demasiado grande El archivo cargado supera el límite de tamaño.
500 Error interno del servidor Error inesperado en el servidor.

Cómo usar la API de fusión de hojas de cálculo con SDK

Especificación OpenAPI

La Especificación OpenAPI proporciona una descripción legible por máquina de la API, lo que permite interacciones REST directas.

Puedes utilizar la herramienta de línea de comandos cURL para acceder fácilmente a los servicios web de Aspose.Cells. El siguiente ejemplo muestra cómo realizar llamadas a la API en la nube mediante cURL.

Utilizar los SDK de Aspose.Cells Cloud

Utilizar los SDK es la forma más rápida de desarrollar, ya que abstractan los detalles de bajo nivel, permitiéndote importar datos en una hoja de cálculo con un código breve. Consulta el repositorio de GitHub para ver la lista completa de SDK de Aspose.Cells Cloud.

Importar datos JSON en hoja de cálculo Importar datos XML a una hoja de cálculo