Documentation –

Developer-Guide: Obtener objeto OLE de una hoja de cálculo de Excel – Aspose.Cells Cloud API

Mon, 01 Jan 0001 00:00:00 +0000

Esta API REST recupera un objeto OLE de una hoja de cálculo de Excel.

Seguridad y autenticación

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

API REST

GET https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/oleobjects/{objectNumber}?format={format}

Parámetros de solicitud

Nombre del parámetro	Tipo	Ubicación	Descripción
name	string	path	Nombre del documento.
sheetName	string	path	Nombre de la hoja de cálculo.
objectNumber	integer	path	Número del objeto dentro de la hoja de cálculo.
format	string	query	Formato de exportación deseado para el objeto (p. ej., `png`, `jpeg`).
folder	string	query	Carpeta que contiene el documento.
storageName	string	query	Nombre del almacenamiento a utilizar.

Opciones de almacenamiento

folder – especifica la subcarpeta en el almacenamiento predeterminado donde se encuentra el libro.
storageName – anula el nombre predeterminado del almacenamiento si el libro se encuentra en otra ubicación.

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

Puede utilizar la herramienta de línea de comandos cURL para llamar al servicio web de Aspose.Cells. El ejemplo siguiente muestra cómo solicitar un objeto OLE como imagen PNG.

Solicitud

curl -v "https://api.aspose.cloud/v3.0/cells/Embedded_OleObject_Sample_Book1.xlsx/worksheets/Sheet1/oleobjects/0?format=png" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Respuesta

Respuesta con imagen binaria

Cuando format se establece en un tipo de imagen (p. ej., png), la API devuelve los datos binarios de la imagen con el encabezado:

Content-Type: image/png

(El archivo de imagen se transmite directamente al cliente.)

Respuesta con metadatos en JSON

Si se omite format o se establece en json, la API devuelve una carga útil en JSON que describe el objeto OLE:

{
  "Code": 200,
  "Status": "OK",
  "OLEObject": {
    "Name": "Object1",
    "Width": 200,
    "Height": 150,
    "Left": 10,
    "Top": 20,
    "IsLocked": false,
    "FileFormat": "png"
  }
}

Respuestas de error

Estado HTTP	Código de error	Descripción
400	BadRequest	Parámetros ausentes o no válidos.
401	Unauthorized	Token JWT no válido o ausente.
404	NotFound	Libro, hoja de cálculo u objeto OLE no encontrado.
500	ServerError	Error inesperado del servidor.

Ejemplo de respuesta 404

{
  "Code": 404,
  "Status": "NotFound",
  "Message": "No se encontró el objeto OLE solicitado con número 0 en la hoja 'Sheet1'."
}

Familia de SDK en la nube

Utilizar un SDK es la forma más rápida de integrar la API. Los SDK gestionan los detalles de bajo nivel para que usted pueda 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 llamar a los servicios web de Aspose.Cells con distintos SDK:

Developer-Guide: Agregar un objeto OLE en una hoja de cálculo de Excel

Mon, 01 Jan 0001 00:00:00 +0000

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.

Solicitud

curl -v "https://api.aspose.cloud/v3.0/cells/Book1.xlsx/worksheets/Sheet1/oleobjects" \
  -X PUT \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>" \
  -d '{"ImageSourceFullName":"aspose-logo.png", "IsAutoSize":true, "SourceFullName":"Sample_Book2.xls", "UpperLeftRow":15, "Top":10, "UpperLeftColumn":5, "Left":10, "Width":400, "Height":400}'

Respuesta

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

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:

Developer-Guide: Actualizar un objeto OLE en una hoja de cálculo de Excel

Fri, 01 Mar 2024 00:00:00 +0000

Esta API REST actualiza un objeto OLE en una hoja de cálculo de Excel.

Seguridad y autenticación

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

API PostUpdateWorksheetOleObject

POST https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/oleobjects/{oleObjectIndex}

Los parámetros de la solicitud son:

Nombre del parámetro	Tipo	Ubicación del parámetro	Descripción
name	string	path	Nombre del libro de trabajo.
sheetName	string	path	Nombre de la hoja de cálculo.
oleObjectIndex	integer	path	Índice del objeto OLE dentro de la hoja de cálculo.
ole	object	body	Representación JSON del objeto OLE que se va a actualizar.
folder	string	query	Carpeta que contiene el libro de trabajo.
storageName	string	query	Nombre del servicio de almacenamiento.

Campos del cuerpo de la solicitud

Campo	Tipo	Obligatorio	Descripción
ImageSourceFullName	string	opcional	Ruta al archivo de imagen utilizado para el objeto OLE.
IsAutoSize	boolean	opcional	Indica si el objeto OLE debe redimensionarse automáticamente.
SourceFullName	string	obligatorio	Archivo fuente (por ejemplo, una imagen o gráfico) del objeto OLE.
UpperLeftRow	integer	obligatorio	Índice de fila (base cero) de la esquina superior izquierda.
UpperLeftColumn	integer	obligatorio	Índice de columna (base cero) de la esquina superior izquierda.
Left	integer	opcional	Desplazamiento horizontal, en puntos, desde la esquina superior izquierda.
Top	integer	opcional	Desplazamiento vertical, en puntos, desde la esquina superior izquierda.
Width	integer	obligatorio	Ancho del objeto OLE, en puntos.
Height	integer	obligatorio	Alto del objeto OLE, en puntos.

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

Puede 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 llamar a la API en la nube mediante cURL.

Solicitud

curl -v "https://api.aspose.cloud/v3.0/cells/" \
  -X POST \
  -d '{"ImageSourceFullName":"aspose-logo.png","IsAutoSize":true,"SourceFullName":"Sample_Book2.xls","UpperLeftRow":15,"Top":10,"UpperLeftColumn":5,"Left":10,"Width":400,"Height":400}' \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Respuesta

{
  "Code": 200,
  "Status": "OK",
  "OLEObject": {
    "Index": 0,
    "ImageSourceFullName": "aspose-logo.png",
    "IsAutoSize": true,
    "SourceFullName": "Sample_Book2.xls",
    "UpperLeftRow": 15,
    "UpperLeftColumn": 5,
    "Left": 10,
    "Top": 10,
    "Width": 400,
    "Height": 400
  }
}

Respuestas de error

Estado HTTP	Código	Mensaje
400	4000	Solicitud incorrecta: parámetros faltantes o no válidos.
401	4010	No autorizado: token JWT no válido o faltante.
404	4040	No encontrado: el libro de trabajo, la hoja de cálculo o el objeto OLE no existen.
500	5000	Error interno del servidor: fallo inesperado del lado del servidor.

La API también devuelve un campo personalizado Code en el cuerpo de la respuesta que se corresponde con el estado HTTP (por ejemplo, 200 → 2000, 400 → 4000, etc.).

¿Cuándo utilizar esta API?

Utilice este endpoint cuando necesite modificar un objeto OLE existente —como una imagen, gráfico o documento incrustado— sin volver a cargar toda la hoja de cálculo. Los escenarios típicos incluyen actualizar la fuente de la imagen, cambiar el tamaño del objeto o modificar su posición tras haber generado el libro de trabajo. Para operaciones relacionadas, consulte Agregar un objeto OLE y Eliminar un objeto OLE.

Familia de SDK en la nube

Utilizar un SDK es la forma más rápida de desarrollar. Un SDK abstracte los detalles de bajo nivel para que usted pueda centrarse en su proyecto. Consulte el repositorio de GitHub para ver una lista completa de los SDK de Aspose.Cells Cloud.

A continuación se muestra un ejemplo breve en C# que actualiza un objeto OLE utilizando el SDK de Aspose.Cells Cloud:

using Aspose.Cells.Cloud.SDK.Api;
using Aspose.Cells.Cloud.SDK.Model;

var config = new Configuration
{
    AppSid = "<your-app-sid>",
    AppKey = "<your-app-key>"
};
var oleApi = new OleObjectsApi(config);
var request = new OleObjectUpdateRequest
{
    ImageSourceFullName = "aspose-logo.png",
    IsAutoSize = true,
    SourceFullName = "Sample_Book2.xls",
    UpperLeftRow = 15,
    UpperLeftColumn = 5,
    Left = 10,
    Top = 10,
    Width = 400,
    Height = 400
};

var response = oleApi.UpdateWorksheetOleObject("SampleBook.xlsx", "Sheet1", 0, request, folder: "myFolder");
Console.WriteLine($"Status: {response.Status}");

Los siguientes ejemplos de código muestran cómo llamar a los servicios web de Aspose.Cells mediante diversos SDK:

Developer-Guide: Convertir objeto OLE a imagen – Aspose.Cells Cloud REST API

Mon, 01 Jan 0001 00:00:00 +0000

Convertir objeto OLE a imagen

Recuperar un objeto OLE incrustado en una hoja de cálculo y devolverlo en el formato de imagen solicitado.

Requisitos previos

Antes de llamar a este endpoint, asegúrese de cumplir con lo siguiente:

Cuenta de Aspose.Cells Cloud: regístrese en el portal de Aspose Cloud.
Libro de cálculo cargado en el almacenamiento en la nube: utilice la API Cargar archivo o la interfaz de usuario de Aspose Cloud.
Token de acceso JWT: obtenga un token siguiendo la guía de autenticación.

Seguridad y autenticación

Todas las API de Aspose.Cells Cloud requieren autenticación basada en token JWT. Incluya el token en el encabezado Authorization:

Authorization: Bearer <jwt-token>

Solo se admiten endpoints HTTPS; nunca utilice http://.

Solicitud

Método HTTP

GET

Endpoint

https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/oleobjects/{objectNumber}?format={format}

Parámetros de ruta

Nombre	Tipo	Obligatorio	Descripción
`name`	string	✅	Nombre del archivo del libro de cálculo (por ejemplo, `Book1.xlsx`).
`sheetName`	string	✅	Hoja de cálculo que contiene el objeto OLE.
`objectNumber`	integer	✅	Índice basado en cero del objeto OLE.

Parámetros de consulta

Nombre	Tipo	Obligatorio	Descripción
`format`	string	❌	Formato de imagen deseado (`png`, `jpeg`, `tiff`, `gif`, `emf`, `bmp`). Si se omite, el valor predeterminado es `png`.
`folder`	string	❌	Ruta a la carpeta donde reside el libro de cálculo.
`storageName`	string	❌	Nombre del servicio de almacenamiento (por ejemplo, `MyCloud`).

Ejemplo de solicitud (cURL)

curl -v "https://api.aspose.cloud/v3.0/cells/Embedded_OleObject_Sample_Book1.xlsx/worksheets/Sheet1/oleobjects/0?format=png" \
  -X GET \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt-token>"

Reemplace <jwt-token> con un token JWT válido.

Respuesta

Estado	Tipo de contenido	Descripción
`200`	`image/png` (o el formato solicitado)	Datos binarios de la imagen que representa el objeto OLE.
`400`	`application/json`	Parámetros de solicitud inválidos.
`401`	`application/json`	Fallo de autenticación (JWT ausente o inválido).
`404`	`application/json`	No se encontró el libro de cálculo, la hoja de cálculo o el objeto OLE especificados.
`500`	`application/json`	Error del lado del servidor.

Manejo de la carga binaria

La API devuelve bytes de imagen en bruto. Puede:

Guardar directamente en un archivo (ejemplo en Linux/macOS):

curl -o oleobject.png "https://api.aspose.cloud/v3.0/cells/Embedded_OleObject_Sample_Book1.xlsx/worksheets/Sheet1/oleobjects/0?format=png" \
     -H "Authorization: Bearer <jwt-token>"

Codificar en Base64 para depuración o incrustación en JSON:

curl -s "https://api.aspose.cloud/v3.0/cells/Embedded_OleObject_Sample_Book1.xlsx/worksheets/Sheet1/oleobjects/0?format=png" \
     -H "Authorization: Bearer <jwt-token>" | base64

Ejemplo (truncado) de salida en Base64:

iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAYAAAAf8/9hAAABG0lEQVR42mNkY…

Respuestas de error

Estado HTTP	Código	Mensaje
`400`	`InvalidParameter`	Uno o más parámetros de solicitud no son válidos.
`401`	`AuthenticationFailed`	Token JWT ausente o inválido.
`404`	`PropertyNotFound`	El libro de cálculo, la hoja de cálculo o el objeto OLE solicitados no existen.
`500`	`InternalError`	Se produjo un error inesperado en el servidor.

Ejemplos de SDK

Los fragmentos siguientes muestran cómo invocar la operación con los SDK oficiales. Reemplace YOUR_JWT_TOKEN y otros marcadores de posición con sus valores reales.

Lenguaje	Ejemplo
C#	Mostrar código `csharp\nusing Aspose.Cells.Cloud.SDK.Api;\nusing Aspose.Cells.Cloud.SDK.Model.Requests;\n\nvar config = new Configuration { AccessToken = "YOUR_JWT_TOKEN" };\nvar api = new OleObjectsApi(config);\nvar request = new GetWorksheetOleObjectRequest(\n name: "Embedded_OleObject_Sample_Book1.xlsx",\n sheetName: "Sheet1",\n objectNumber: 0,\n format: "png"\n);\nvar stream = api.GetWorksheetOleObject(request);\nusing var file = File.Create("oleobject.png");\nstream.CopyTo(file);\n`
Java	Mostrar código java\nimport com.aspose.cells.cloud.ApiException;\nimport com.aspose.cells.cloud.api.OleObjectsApi;\nimport com.aspose.cells.cloud.model.;\nimport com.aspose.cells.cloud.model.requests.;\nimport java.io.FileOutputStream;\nimport java.io.InputStream;\n\nOleObjectsApi api = new OleObjectsApi();\napi.getApiClient().setAccessToken("YOUR_JWT_TOKEN");\nGetWorksheetOleObjectRequest req = new GetWorksheetOleObjectRequest(\n "Embedded_OleObject_Sample_Book1.xlsx",\n "Sheet1",\n 0,\n "png",\n null,\n null\n);\nInputStream stream = api.getWorksheetOleObject(req);\ntry (FileOutputStream out = new FileOutputStream("oleobject.png")) {\n stream.transferTo(out);\n}\n
Python	Mostrar código `python\nfrom asposecellscloud import CellsApi, GetWorksheetOleObjectRequest\n\napi = CellsApi()\napi.api_client.configuration.access_token = "YOUR_JWT_TOKEN"\nrequest = GetWorksheetOleObjectRequest(\n name="Embedded_OleObject_Sample_Book1.xlsx",\n sheet_name="Sheet1",\n object_number=0,\n format="png"\n)\nstream = api.get_worksheet_ole_object(request)\nwith open('oleobject.png', 'wb') as f:\n f.write(stream.read())\n`
Node.js	Mostrar código javascript\nconst { CellsApi, GetWorksheetOleObjectRequest } = require('asposecellscloud');\n\nconst api = new CellsApi();\napi.apiClient.configuration.accessToken = 'YOUR_JWT_TOKEN';\n\nconst request = new GetWorksheetOleObjectRequest({\n name: 'Embedded_OleObject_Sample_Book1.xlsx',\n sheetName: 'Sheet1',\n objectNumber: 0,\n format: 'png'\n});\napi.getWorksheetOleObject(request).then(stream => {\n const fs = require('fs');\n const writeStream = fs.createWriteStream('oleobject.png');\n stream.pipe(writeStream);\n});\n
Go	Mostrar código go\npackage main\nimport (\n "io"\n "os"\n cells "github.com/aspose-cells-cloud/aspose-cells-cloud-go/v3"\n)\nfunc main() {\n cfg := cells.NewConfiguration()\n cfg.AccessToken = "YOUR_JWT_TOKEN"\n api := cells.NewOleObjectsApi(cfg)\n req := cells.GetWorksheetOleObjectRequest{\n Name: "Embedded_OleObject_Sample_Book1.xlsx",\n SheetName: "Sheet1",\n ObjectNumber: 0,\n Format: "png",\n }\n stream, _, err := api.GetWorksheetOleObject(req)\n if err != nil { panic(err) }\n out, _ := os.Create("oleobject.png")\n defer out.Close()\n io.Copy(out, stream)\n}\n
PHP	Mostrar código php\n<?php\nrequire_once 'vendor/autoload.php';\nuse Aspose\\Cells\\Cloud\\Api\\OleObjectsApi;\nuse Aspose\\Cells\\Cloud\\Model\\Requests\\GetWorksheetOleObjectRequest;\n\n$config = new \\Aspose\\Cells\\Cloud\\Configuration();\n$config->setAccessToken('YOUR_JWT_TOKEN');\n$apiInstance = new OleObjectsApi($config);\n$request = new GetWorksheetOleObjectRequest(\n 'Embedded_OleObject_Sample_Book1.xlsx',\n 'Sheet1',\n 0,\n 'png'\n);\n$stream = $apiInstance->getWorksheetOleObject($request);\nfile_put_contents('oleobject.png', $stream);\n?>\n
Ruby	Mostrar código `ruby\nrequire 'aspose_cells_cloud'\napi = AsposeCellsCloud::OleObjectsApi.new\napi.api_client.config.access_token = 'YOUR_JWT_TOKEN'\nrequest = AsposeCellsCloud::GetWorksheetOleObjectRequest.new(\n name: 'Embedded_OleObject_Sample_Book1.xlsx',\n sheet_name: 'Sheet1',\n object_number: 0,\n format: 'png'\n)\nstream = api.get_worksheet_ole_object(request)\nFile.open('oleobject.png', 'wb') { \|f\| f.write(stream) }\n`\n
Perl	Mostrar código perl\nuse AsposeCellsCloud::Api::OleObjectsApi;\nuse AsposeCellsCloud::Object::GetWorksheetOleObjectRequest;\n\nmy $api = AsposeCellsCloud::Api::OleObjectsApi->new();\n$api->{api_client}->{config}->{access_token} = 'YOUR_JWT_TOKEN';\nmy $req = AsposeCellsCloud::Object::GetWorksheetOleObjectRequest->new(\n name => 'Embedded_OleObject_Sample_Book1.xlsx',\n sheet_name => 'Sheet1',\n object_number => 0,\n format => 'png'\n);\nmy $stream = $api->get_worksheet_ole_object(request => $req);\nopen my $fh, '>', 'oleobject.png' or die $!;\nbinmode $fh;\nprint $fh $stream;\nclose $fh;\n

(La lista completa de SDK está disponible en el repositorio de GitHub.)

Operaciones relacionadas

Agregar objeto OLE – POST /cells/{name}/worksheets/{sheetName}/oleobjects
Actualizar objeto OLE – PUT /cells/{name}/worksheets/{sheetName}/oleobjects/{objectNumber}
Eliminar objeto OLE – DELETE /cells/{name}/worksheets/{sheetName}/oleobjects/{objectNumber}
Obtener lista de objetos OLE – GET /cells/{name}/worksheets/{sheetName}/oleobjects

Para más detalles, consulte las páginas de referencia correspondientes de la API.

Recursos adicionales

Especificación OpenAPI – https://apireference.aspose.cloud/cells/#/OleObjects/GetWorksheetOleObject
Guía de autenticación – https://docs.aspose.cloud/total/getting-started/rest-api-overview/authenticating-api-requests/
Repositorios de SDK – https://github.com/aspose-cells-cloud
Rendimiento y accesibilidad: ejecute auditorías con Lighthouse y axe‑core para garantizar tiempos de carga óptimos y cumplimiento con WCAG 2.1 AA.

Developer-Guide: Eliminar un objeto OLE en una hoja de cálculo de Excel

Mon, 01 Jan 0001 00:00:00 +0000

Esta página explica cómo eliminar un objeto OLE específico de una hoja de cálculo en un libro de Excel utilizando Aspose.Cells Cloud. Un objeto OLE puede ser una imagen vinculada, un gráfico o cualquier objeto incrustado que Excel almacene como una entidad independiente.

Seguridad y autenticación

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

API REST

DELETE https://api.aspose.cloud/v4.0/cells/{name}/worksheets/{sheetName}/oleobjects/{oleObjectIndex}

Parámetros de la solicitud

Nombre del parámetro	Tipo	Ubicación	Descripción
name	string	path	Nombre del libro.
sheetName	string	path	Nombre de la hoja de cálculo.
oleObjectIndex	integer	path	Índice del objeto OLE que se va a eliminar.
folder	string	query	Carpeta que contiene el libro. (opcional)
storageName	string	query	Nombre del servicio de almacenamiento. (opcional)

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

Puede 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 la llamada con cURL.

Solicitud

curl -v "https://api.aspose.cloud/v4.0/cells/Embedded_OleObject_Sample_Book1.xlsx/worksheets/Sheet1/oleobjects/0" \
  -X DELETE \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer <jwt token>"

Respuesta

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

Detalles de la respuesta

Estado HTTP	Descripción	JSON de ejemplo
200 OK	El objeto OLE se eliminó correctamente.	`{ "Code": 200, "Status": "OK" }`
401 Unauthorized	Token JWT ausente o no válido.	`{ "Code": 401, "Message": "El token de acceso está ausente o no es válido." }`
404 Not Found	El libro, la hoja de cálculo o el índice del objeto OLE especificados no existen.	`{ "Code": 404, "Message": "Índice del objeto OLE fuera de rango." }`
400 Bad Request	Faltan parámetros obligatorios o tienen un formato incorrecto.	`{ "Code": 400, "Message": "Parámetros de la solicitud no válidos." }`

maneje estas respuestas en su aplicación verificando el código de estado y mostrando el mensaje adjunto.

Familia de SDK en la nube

Utilizar un SDK es la mejor forma de acelerar el desarrollo. Un SDK gestiona los detalles de bajo nivel para que usted pueda centrarse en las tareas de su proyecto. 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 utilizando diversos SDK:

Developer-Guide:

Mon, 01 Jan 0001 00:00:00 +0000

title: Eliminar todos los objetos OLE en una hoja de cálculo de Excel description: Aprenda cómo eliminar todos los objetos OLE de una hoja de cálculo de Excel utilizando la API REST de Aspose.Cells Cloud (v3.0). Incluye el punto de conexión, parámetros, ejemplos de solicitud/respuesta, fragmentos de SDK, autenticación, manejo de errores y preguntas frecuentes. keywords: Aspose.Cells Cloud, eliminar objetos OLE, API de Excel, API REST, limpiar OLE en hoja de cálculo, SDK en la nube api_version: v3.0 last_updated: 2024-11-01 weight: 60

Eliminar todos los objetos OLE en una hoja de cálculo de Excel

OleObjects – Clear elimina todos los objetos OLE (Object Linking and Embedding, o Enlace e inserción de objetos) de una hoja de cálculo especificada, dejando los datos de las celdas intactos. Esta operación es útil para limpiar hojas de cálculo heredadas o preparar un libro para su redistribución.

Requisitos previos

Un token de acceso JWT válido de Aspose Cloud (OAuth 2.0).
El libro de trabajo objetivo debe estar almacenado en el almacenamiento de Aspose Cloud (o debe especificar la folder/storageName donde se encuentra).
Versión de la API v3.0 o superior.

Nota: La operación es idempotente; llamarla cuando no existen objetos OLE aún devuelve un resultado correcto 200 OK.

Solicitud HTTP

DELETE https://api.aspose.cloud/v3.0/cells/{name}/worksheets/{sheetName}/oleobjects

Parámetros de ruta

Nombre	Tipo	Obligatorio	Descripción
`name`	string	✔️	Nombre del archivo del libro de trabajo.
`sheetName`	string	✔️	Nombre de la hoja de cálculo.

Parámetros de consulta

Nombre	Tipo	Obligatorio	Descripción
`folder`	string	opcional	Carpeta que contiene el libro de trabajo.
`storageName`	string	opcional	Nombre del almacenamiento donde se encuentra el libro de trabajo.

Cabeceras

Cabecera	Valor
`Authorization`	`Bearer <jwt token>`
`Accept`	`application/json`
`Content-Type`	`application/json`

Ejemplo de solicitud (cURL)

curl -v "https://api.aspose.cloud/v3.0/cells/Embedded_OleObject_Sample_Book1.xlsx/worksheets/Sheet1/oleobjects?folder=Samples&storageName=MyStorage" \
     -X DELETE \
     -H "Authorization: Bearer <jwt token>" \
     -H "Accept: application/json" \
     -H "Content-Type: application/json"

Reemplace <jwt token> por un token de acceso válido y ajuste folder/storageName según sea necesario.

Respuesta correcta

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

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 faltantes o no válidos (por ejemplo, tipo de archivo no admitido).
401	No autorizado	Token JWT no válido o faltante.
413	Carga útil demasiado grande	El archivo cargado supera el límite de tamaño.
500	Error interno del servidor	Error inesperado en el servidor.

Ejemplos de SDK

Los siguientes fragmentos de código muestran cómo invocar DeleteWorksheetOleObjects con los SDK oficiales de Aspose.Cells Cloud. Reemplace los valores de marcador de posición (<YOUR_TOKEN>, <FILE_NAME>, etc.) con sus propios datos.

Idioma	Ejemplo
C#	Mostrar ejemplo en C# `csharp\nusing Aspose.Cells.Cloud.SDK.Api;\nusing Aspose.Cells.Cloud.SDK.Model;\n\nvar config = new Configuration { AccessToken = "<YOUR_TOKEN>", BasePath = "https://api.aspose.cloud" };\nvar api = new OleObjectsApi(config);\napi.DeleteWorksheetOleObjects(name: "Sample.xlsx", sheetName: "Sheet1", folder: "Samples", storageName: null);\n`
Java	Mostrar ejemplo en Java `java\nimport com.aspose.cells.cloud.api.OleObjectsApi;\nimport com.aspose.cells.cloud.client.ApiClient;\nimport com.aspose.cells.cloud.client.Configuration;\n\nConfiguration config = new Configuration();\nconfig.setAccessToken("<YOUR_TOKEN>");\nconfig.setBasePath("https://api.aspose.cloud");\nOleObjectsApi api = new OleObjectsApi(new ApiClient(config));\napi.deleteWorksheetOleObjects("Sample.xlsx", "Sheet1", "Samples", null);\n`
Python	Mostrar ejemplo en Python `python\nfrom asposecellscloud import ApiClient, Configuration, OleObjectsApi\n\nconfig = Configuration()\nconfig.access_token = '<YOUR_TOKEN>'\nconfig.host = 'https://api.aspose.cloud'\nclient = ApiClient(configuration=config)\napi = OleObjectsApi(client)\napi.delete_worksheet_ole_objects(name='Sample.xlsx', sheet_name='Sheet1', folder='Samples')\n`
Node.js	Mostrar ejemplo en Node.js `javascript\nconst { OleObjectsApi, Configuration } = require('asposecellscloud');\n\nlet config = new Configuration({ accessToken: '<YOUR_TOKEN>', basePath: 'https://api.aspose.cloud' });\nlet api = new OleObjectsApi(config);\napi.deleteWorksheetOleObjects('Sample.xlsx', 'Sheet1', { folder: 'Samples' })\n .then(() => console.log('Todos los objetos OLE eliminados'))\n .catch(err => console.error(err));\n`
Go	Mostrar ejemplo en Go go\npackage main\nimport (\n "context"\n "github.com/aspose-cells-cloud/aspose-cells-cloud-go/v3"\n)\n\nfunc main() {\n cfg := asposecellscloud.NewConfiguration()\n cfg.AccessToken = "<YOUR_TOKEN>"\n cfg.Host = "https://api.aspose.cloud"\n api := asposecellscloud.NewOleObjectsApi(cfg)\n _, err := api.DeleteWorksheetOleObjects(context.Background(), "Sample.xlsx", "Sheet1", map[string]interface{}{ "folder": "Samples" })\n if err != nil { panic(err) }\n println("Todos los objetos OLE eliminados")\n}\n

Los archivos fuente completos para todos los idiomas admitidos están disponibles en el repositorio de GitHub de Aspose.Cells Cloud.

Errores y manejo

Idempotencia – Eliminar objetos OLE en una hoja de cálculo que ya no tiene ninguno sigue devolviendo 200 OK.
Expiración del token – Si recibe 401 No autorizado, obtenga un nuevo token JWT e inténtelo de nuevo.
Nombre de hoja de cálculo no válido – Asegúrese de que el nombre de la hoja coincida exactamente con la capitalización usada en el libro de trabajo; de lo contrario, se devolverá un 400 Solicitud incorrecta.

Implemente lógica de reintento con retroceso exponencial para errores 500 transitorios.

Preguntas frecuentes

P1: ¿Debo especificar los parámetros folder y storageName?
R: No. Si se omiten, Aspose Cloud asume el almacenamiento predeterminado y la carpeta raíz.

P2: ¿Puedo eliminar objetos OLE solo de una celda específica?
R: Este punto de conexión elimina todos los objetos OLE en la hoja de cálculo. Para eliminar un solo objeto, utilice la operación Eliminar un objeto OLE específico.

P3: ¿Qué ocurre si el libro de trabajo está bloqueado para edición?
R: La API devolverá un 400 Solicitud incorrecta con un mensaje que indica que el archivo está bloqueado. Asegúrese de que el archivo no esté abierto en otro lugar antes de llamar al punto de conexión.

P4: ¿Existe un límite de tamaño para el libro de trabajo?
R: El servicio sigue los límites generales de tamaño de archivo de Aspose Cloud (actualmente hasta 2 GB por archivo). Los archivos más grandes podrían necesitar dividirse o procesarse en fragmentos.

Prácticas recomendadas

Rendimiento – Use los atributos async o defer al cargar scripts de terceros en su sitio de documentación para reducir el tiempo de carga inicial de la página.
Seguridad – Agregue rel="noopener noreferrer" a cualquier enlace externo que se abra en una nueva pestaña.
Accesibilidad – Los iconos decorativos (por ejemplo, flechas hacia abajo en barras laterales) deben tener alt="" y role="presentation" para cumplir con los estándares WCAG AA.
Consistencia – Mantenga los formatos de fecha en ISO‑8601 (YYYY‑MM‑DD) para evitar artefactos de codificación.

Operaciones relacionadas

Agregar objeto OLE – POST /cells/{name}/worksheets/{sheetName}/oleobjects
Eliminar un objeto OLE específico – DELETE /cells/{name}/worksheets/{sheetName}/oleobjects/{oleObjectIndex}

Utilice los enlaces de navegación al final de la página para moverse entre las acciones relacionadas de la API.