Agregar objeto OLE a una hoja de cálculo de Excel con la API de Aspose.Cells Cloud
La API de Aspose.Cells Cloud permite manipular programáticamente libros de Excel, incluida la capacidad de incrustar objetos OLE (por ejemplo, documentos de Word, PDF u otros archivos binarios) directamente en una hoja de cálculo.
Esta API REST agrega un objeto OLE a una hoja de cálculo de Excel.
Prerrequisitos – Debe tener un token de autenticación JWT válido, y cualquier archivo de origen referenciado por oleFile o imageFile debe cargarse previamente en la ubicación de almacenamiento especificada antes de invocar el punto de conexión.
API PutWorksheetOleObject
PUT https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/oleobjects
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 del parámetro | Tipo | Ubicación | Descripción |
|---|---|---|---|
| name | string | path | Nombre del archivo del libro. |
| sheetName | string | path | Nombre de la hoja de cálculo. |
| oleObject | object | body | Definición del objeto OLE. |
| upperLeftRow | integer | query | Índice de fila de la esquina superior izquierda (predeterminado: 0). |
| upperLeftColumn | integer | query | Índice de columna de la esquina superior izquierda (predeterminado: 0). |
| height | integer | query | Altura del objeto OLE (predeterminado: 0). |
| width | integer | query | Ancho del objeto OLE (predeterminado: 0). |
| oleFile | string | query | Nombre del archivo fuente OLE. |
| imageFile | string | query | Nombre del archivo de imagen de vista previa. |
| folder | string | query | Carpeta que contiene el libro. |
| storageName | string | query | Nombre del almacenamiento a utilizar. |
Notas – upperLeftRow y upperLeftColumn usan indexación basada en cero. El archivo oleFile (y opcionalmente imageFile) debe existir previamente en el almacenamiento de destino; de lo contrario, la solicitud devolverá un error.
La Especificación OpenAPI define una interfaz de programación públicamente accesible y permite realizar interacciones REST directamente desde un navegador web.
Puede usar la herramienta de línea de comandos cURL para llamar a los servicios web de Aspose.Cells. El ejemplo siguiente muestra cómo agregar un objeto OLE con cURL. Se requiere HTTPS para todas las llamadas en producción.
Códigos de estado HTTP posibles
| Código | Descripción |
|---|---|
| 200 | Objeto OLE agregado correctamente. |
| 400 | Solicitud incorrecta: parámetros faltantes o no válidos. |
| 401 | No autorizado: token JWT inválido o faltante. |
| 404 | No encontrado: el libro, la hoja de cálculo o el archivo de origen no existe. |
| 500 | Error interno del servidor: fallo inesperado. |
Una respuesta correcta típica devuelve la siguiente carga JSON:
{
"Code": 200,
"Status": "OK",
"Data": {
"OleObjectId": "12345",
"UpperLeftRow": 15,
"UpperLeftColumn": 5,
"Width": 400,
"Height": 400,
"SourceFullName": "Sample_Book2.xls",
"ImageSourceFullName": "aspose-logo.png"
}
}
Familia de SDK en la nube
Usar un SDK acelera el desarrollo. Un SDK abstracta los detalles de bajo nivel, permitiéndole centrarse en su lógica de negocio. Consulte el repositorio de GitHub para obtener una lista completa de los SDK de Aspose.Cells Cloud.
Los siguientes ejemplos de código muestran cómo invocar los servicios web de Aspose.Cells mediante diversos SDK: