Ejemplo completo de trabajo para eliminar objetos de anotación de PDF con REST en Node.JS

Este ejemplo muestra cómo subir un PDF, eliminar todas sus anotaciones y descargar el archivo limpio usando el SDK de GroupDocs.Annotation.

const fs = require('fs');
const path = require('path');
const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");

// ==== Authentication =========================================================
const clientId = "YOUR_CLIENT_ID";
const clientSecret = "YOUR_CLIENT_SECRET";

const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);
const annotationsApi = new GroupDocsAnnotationCloud.AnnotationsApi(config);
const storageApi = new GroupDocsAnnotationCloud.StorageApi(config);

// ==== Local & Remote file definitions =======================================
const localInputPath = path.resolve(__dirname, "input.pdf");
const localOutputPath = path.resolve(__dirname, "output.pdf");
const remoteFilePath = "input.pdf";

// ==== Main workflow ==========================================================
(async () => {
    // 1. Upload PDF to GroupDocs Cloud storage
    const fileBytes = fs.readFileSync(localInputPath);
    const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
        path: remoteFilePath,
        file: fileBytes
    });
    await storageApi.uploadFile(uploadRequest);

// 2. Build FileInfo object for the uploaded PDF
    const fileInfo = new GroupDocsAnnotationCloud.FileInfo({
        filePath: remoteFilePath
    });

// 3. Retrieve all existing annotations
    const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
        fileInfo: fileInfo
    });
    const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);
    const annotationIds = (annotationsResult.annotations || []).map(a => a.id);

// 4. Delete all annotations (if any)
    if (annotationIds.length > 0) {
        const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
            fileInfo: fileInfo,
            annotationIds: annotationIds
        });
        await annotationsApi.deleteAnnotations(deleteRequest);
    }

// 5. Download the cleaned PDF back to local storage
    const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
        path: remoteFilePath
    });
    const fileStream = await storageApi.downloadFile(downloadRequest);
    fs.writeFileSync(localOutputPath, fileStream);
    console.log(`All annotations removed. Clean file saved to ${localOutputPath}`);
})();

Nota: Este ejemplo de código muestra la funcionalidad principal. Antes de usarlo en su proyecto, asegúrese de actualizar cualquier ruta de archivo y valores de configuración para que coincidan con su entorno real, verifique que todas las dependencias requeridas estén instaladas correctamente y pruebe exhaustivamente en su entorno de desarrollo. Si encuentra algún problema, consulte la documentación oficial o póngase en contacto con el equipo de soporte para obtener ayuda.

Eliminar anotaciones PDF mediante API REST usando cURL

A continuación se presentan los comandos cURL que ejecutan el mismo flujo de eliminación de anotaciones a través de los endpoints REST de GroupDocs.Annotation Cloud.

# 1. Obtain an access token
curl -X POST "https://api.groupdocs.cloud/v2.0/auth/token" \
     -H "Content-Type: application/json" \
     -d "{\"client_id\":\"YOUR_CLIENT_ID\",\"client_secret\":\"YOUR_CLIENT_SECRET\"}"

# 2. Upload the source PDF
curl -X PUT "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/pdf" \
     --data-binary "@input.pdf"

# 3. Retrieve annotation IDs
curl -X GET "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

# 4. Delete all retrieved annotations
curl -X DELETE "https://api.groupdocs.cloud/v2.0/annotation/annotations?filePath=input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d "{\"annotationIds\":[\"id1\",\"id2\"]}"

# 5. Download the cleaned PDF
curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/input.pdf" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -o output.pdf

Para obtener una lista completa de los puntos finales y parámetros, consulte la documentación oficial de la API.

Cómo eliminar objetos de anotación de PDF con REST en Node.JS funciona

1. Configuración de autenticación - La clase Configuration se instancia con su clientId y clientSecret, creando un contexto autenticado para todas las llamadas API posteriores.

const config = new GroupDocsAnnotationCloud.Configuration(clientId, clientSecret);

2. Carga de archivo - UploadFileRequest envía los bytes del PDF local al almacenamiento de GroupDocs Cloud. El método storageApi.uploadFile maneja la transferencia.

const uploadRequest = new GroupDocsAnnotationCloud.UploadFileRequest({
    path: remoteFilePath,
    file: fileBytes
});
await storageApi.uploadFile(uploadRequest);

3. Recuperar anotaciones - GetAnnotationsRequest crea un objeto de solicitud con una referencia FileInfo. La llamada annotationsApi.getAnnotations devuelve una colección de objetos de anotación, de los cuales se extraen los IDs.

const getAnnotationsRequest = new GroupDocsAnnotationCloud.GetAnnotationsRequest({
    fileInfo: fileInfo
});
const annotationsResult = await annotationsApi.getAnnotations(getAnnotationsRequest);

4. Eliminar anotaciones - Si existen IDs, se rellena DeleteAnnotationsRequest y se pasa a annotationsApi.deleteAnnotations, que elimina permanentemente las anotaciones del PDF almacenado.

const deleteRequest = new GroupDocsAnnotationCloud.DeleteAnnotationsRequest({
    fileInfo: fileInfo,
    annotationIds: annotationIds
});
await annotationsApi.deleteAnnotations(deleteRequest);

5. Descargar PDF limpio - Finalmente, DownloadFileRequest recupera el archivo actualizado, y fs.writeFileSync lo escribe en el sistema de archivos local.

const downloadRequest = new GroupDocsAnnotationCloud.DownloadFileRequest({
    path: remoteFilePath
});
const fileStream = await storageApi.downloadFile(downloadRequest);
fs.writeFileSync(localOutputPath, fileStream);

Para obtener definiciones detalladas de clases y métodos, consulte la referencia de API.

Instalación y Configuración GroupDocs.Annotation Cloud SDK for Node.js

El SDK se distribuye como un paquete npm. Instálalo con el comando a continuación y luego requiérelo en tu proyecto.

npm install groupdocs-annotation-cloud

También puedes descargar el paquete más reciente directamente desde la página de lanzamientos de GitHub o la URL de descarga oficial.

Después de la instalación, importe la biblioteca y cree un objeto de configuración como se muestra en el ejemplo de código:

const GroupDocsAnnotationCloud = require("@groupdocs/annotation-cloud");
const config = new GroupDocsAnnotationCloud.Configuration("YOUR_CLIENT_ID", "YOUR_CLIENT_SECRET");

Asegúrese de que su entorno de ejecución cumpla con los requisitos de versión de Node.js y de que tenga una cuenta válida de GroupDocs para obtener las credenciales del cliente.

Opciones y Configuraciones para la Eliminación de Anotaciones

El SDK expone varios parámetros que puedes ajustar:

• clientId / clientSecret - Credenciales para la autenticación OAuth. Establécelas en el constructor Configuration.
• fileInfo.filePath - La ruta del PDF en el almacenamiento de GroupDocs Cloud. Ajusta esto si almacenas los archivos en una carpeta diferente.
• annotationIds - Una matriz de IDs devuelta por GetAnnotations. Proporcionar un subconjunto permite la eliminación selectiva.

Configuraciones adicionales, como los tiempos de espera de solicitud y la configuración del proxy, están disponibles en la documentación del SDK; consulte la documentación oficial para obtener la lista completa.

Mejores prácticas para eliminar anotaciones PDF mediante REST

• Validar IDs de anotaciones - Siempre verifique que los IDs que pretende eliminar existan; intentar eliminar IDs que no existen puede provocar un error 404.
• Usar HTTPS - Todas las llamadas a la API deben realizarse mediante HTTPS para proteger sus credenciales y los datos del documento.
• Manejar archivos grandes con cargas fragmentadas - Para PDFs de más de 100 MB, prefiera el endpoint de carga multipart para evitar tiempos de espera.
• Registrar respuestas de la API - Guarde los IDs de solicitud y las respuestas para auditorías y una solución de problemas más sencilla.
• Reutilizar tokens de acceso - Almacene en caché el token OAuth hasta que expire para reducir la sobrecarga de autenticación.

Preguntas comunes

• ¿Cómo me autentico con la API de GroupDocs.Annotation Cloud?
  Obtenga un ID de cliente y un secreto de su cuenta de GroupDocs, luego solicite un token de acceso a través del endpoint OAuth. Consulte la documentación oficial para más detalles.

• ¿Puedo eliminar anotaciones específicas en lugar de todas?
  Sí, proporcione los IDs de las anotaciones que desea eliminar en el DeleteAnnotationsRequest. El SDK devuelve la lista de IDs de anotaciones después de una llamada a GetAnnotations.

• ¿Cómo puedo eliminar objetos de anotación de PDF con REST en Node.JS?
  Utilice el GroupDocs.Annotation Cloud SDK for Node.js para llamar al endpoint DeleteAnnotations después de obtener los IDs de anotación. El flujo completo se muestra en el ejemplo de código y la sección cURL de esta guía.

• ¿Qué licencia se requiere para uso en producción?
  Se necesita una licencia paga para producción. Puede obtener una licencia temporal en la página de licencia temporal mientras evalúa.

Further Reading

• Extraer o eliminar anotaciones de PDF usando la API REST en Node.js
• Texto tachado en un PDF con Node.js y API REST
• Eliminar anotaciones de PDF usando la API REST en Python

Editar archivo Excel en Node.js vía REST - Guía de 5 pasos

1. Instalar el SDK y configurar credenciales: Establezca su CLIENT_ID y CLIENT_SECRET para que la biblioteca pueda autenticarse con GroupDocs Cloud.

const CLIENT_ID = "YOUR_CLIENT_ID";
const CLIENT_SECRET = "YOUR_CLIENT_SECRET";

const config = new GroupDocsEditorCloud.Configuration(CLIENT_ID, CLIENT_SECRET);
const editApi = new GroupDocsEditorCloud.EditApi(config);

2. Cargar el libro de Excel para editar: Utilice EditDocumentRequest para abrir el archivo almacenado en su almacenamiento en la nube.

const editRequest = new GroupDocsEditorCloud.EditDocumentRequest({
    fileInfo: new GroupDocsEditorCloud.FileInfo({ filePath: "input.xlsx" })
});
const editResult = await editApi.editDocument(editRequest);

3. Recuperar la primera hoja de cálculo y localizar la celda objetivo: El SDK devuelve un objeto document que contiene hojas de cálculo y celdas.

const worksheet = editResult.document.worksheets[0];
let targetCell = worksheet.cells.find(c => c.rowIndex === 0 && c.columnIndex === 0);

4. Actualizar o crear el valor de la celda: Cambiar el contenido de la celda A1 (o agregarla si no existe).

if (!targetCell) {
    targetCell = new GroupDocsEditorCloud.Cell({
        rowIndex: 0,
        columnIndex: 0,
        value: "Edited via GroupDocs Editor Cloud"
    });
    worksheet.cells.push(targetCell);
} else {
    targetCell.value = "Edited via GroupDocs Editor Cloud";
}

5. Guardar el libro de trabajo editado de nuevo en el almacenamiento: Proporcione un outputPath y llame a saveDocument.

const saveOptions = new GroupDocsEditorCloud.SaveOptions({ outputPath: "output.xlsx" });
const saveRequest = new GroupDocsEditorCloud.SaveDocumentRequest({
    documentId: editResult.documentId,
    document: editResult.document,
    saveOptions: saveOptions
});
await editApi.saveDocument(saveRequest);

Para obtener una lista completa de clases y métodos, consulte la referencia de API.

Editar archivo Excel en Node.js mediante REST - Ejemplo de código completo

El siguiente ejemplo demuestra cómo editar un archivo Excel en Node.js mediante REST usando GroupDocs.Editor Cloud SDK.

const GroupDocsEditorCloud = require("@groupdocs/editor-cloud");

// Replace with your actual GroupDocs Cloud credentials
const CLIENT_ID = "YOUR_CLIENT_ID";
const CLIENT_SECRET = "YOUR_CLIENT_SECRET";

// Paths for the source Excel file and the edited result
const INPUT_FILE_PATH = "input.xlsx";
const OUTPUT_FILE_PATH = "output.xlsx";

async function editExcel() {
    // Configure the SDK
    const config = new GroupDocsEditorCloud.Configuration(CLIENT_ID, CLIENT_SECRET);
    const editApi = new GroupDocsEditorCloud.EditApi(config);

// 1. Load the Excel workbook for editing
    const editRequest = new GroupDocsEditorCloud.EditDocumentRequest({
        fileInfo: new GroupDocsEditorCloud.FileInfo({
            filePath: INPUT_FILE_PATH
        })
    });

const editResult = await editApi.editDocument(editRequest);
    const documentId = editResult.documentId;
    const document = editResult.document;

// 2. Retrieve the first worksheet
    const worksheet = document.worksheets[0];

// 3. Update cell A1 (rowIndex = 0, columnIndex = 0) with a new value
    let targetCell = worksheet.cells.find(c => c.rowIndex === 0 && c.columnIndex === 0);
    if (!targetCell) {
        targetCell = new GroupDocsEditorCloud.Cell({
            rowIndex: 0,
            columnIndex: 0,
            value: "Edited via GroupDocs Editor Cloud"
        });
        worksheet.cells.push(targetCell);
    } else {
        targetCell.value = "Edited via GroupDocs Editor Cloud";
    }

// 4. Save the edited workbook back to storage
    const saveOptions = new GroupDocsEditorCloud.SaveOptions({
        outputPath: OUTPUT_FILE_PATH
    });

const saveRequest = new GroupDocsEditorCloud.SaveDocumentRequest({
        documentId: documentId,
        document: document,
        saveOptions: saveOptions
    });

const saveResult = await editApi.saveDocument(saveRequest);
    console.log(`Edited file saved to: ${saveResult.path}`);
}

// Execute the edit operation
editExcel().catch(error => {
    console.error("Error during Excel editing:", error);
});

Nota: Este ejemplo de código muestra la funcionalidad principal. Antes de usarlo en su proyecto, asegúrese de actualizar cualquier ruta de archivo y valores de configuración para que coincidan con su entorno real, verifique que todas las dependencias requeridas estén correctamente instaladas y pruebe exhaustivamente en su entorno de desarrollo. Si encuentra algún problema, consulte la documentación oficial o comuníquese con el equipo de soporte para obtener ayuda.

Actualizar hoja XLSX usando la API REST en Node.js via cURL

A continuación se muestra una breve guía paso a paso de la misma operación usando llamadas HTTP sin procesar. Reemplace los valores de marcador de posición con sus credenciales reales y nombres de archivo.

1. Obtener un token de acceso

curl -X POST "https://api.groupdocs.cloud/v2.0/connect/token" \
        -H "Content-Type: application/x-www-form-urlencoded" \
        -d "client_id=YOUR_CLIENT_ID&client_secret=YOUR_CLIENT_SECRET&grant_type=client_credentials"

La respuesta contiene access_token.

2. Cargar el archivo XLSX de origen

curl -X POST "https://api.groupdocs.cloud/v2.0/storage/file/input.xlsx" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -F "file=@input.xlsx"

3. Editar el libro de trabajo (modificar la celda A1)

curl -X POST "https://api.groupdocs.cloud/v2.0/editor/edit" \
     -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
     -H "Content-Type: application/json" \
     -d '{
           "fileInfo": { "filePath": "input.xlsx" },
           "options": {
               "cells": [
                   { "rowIndex": 0, "columnIndex": 0, "value": "Edited via GroupDocs Editor Cloud" }
               ]
           }
         }'

4. Descargar el archivo editado

curl -X GET "https://api.groupdocs.cloud/v2.0/storage/file/output.xlsx" \
        -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
        -o output.xlsx

Para obtener más detalles sobre los payloads de solicitud, consulte la documentación oficial de la API.

Requisitos previos y configuración para GroupDocs.Editor Cloud SDK for Node.js

Para comenzar a usar el SDK, necesita Node.js 14 o posterior y una cuenta de GroupDocs Cloud.

npm install groupdocs-editor-cloud

También puedes descargar el paquete más reciente desde la página de lanzamientos. Después de la instalación, crea un client_id y client_secret en tu panel de GroupDocs Cloud y guárdalos de forma segura.

Qué hace que GroupDocs.Editor Cloud SDK for Node.js sea ideal para modificar hojas de cálculo de Excel

• Compatibilidad total con XLSX - Carga, edita y guarda libros de trabajo conservando fórmulas, estilos y validación de datos.
• Edición a nivel de celda - Accede a celdas, filas o columnas individuales mediante código, lo que es perfecto para actualizar informes o paneles.
• Integración con almacenamiento en la nube - Trabaja directamente con archivos almacenados en GroupDocs Cloud sin descargarlos localmente.
• Comunicación REST segura - Todas las operaciones se realizan a través de HTTPS y el SDK gestiona los tokens por ti.

Para obtener más información, consulte la documentación.

Ajuste fino de las opciones de edición de Excel en GroupDocs.Editor Cloud

El SDK expone varias opciones que le permiten controlar cómo se guarda el libro de trabajo editado.

const saveOptions = new GroupDocsEditorCloud.SaveOptions({
    outputPath: "output.xlsx",
    // You can also set compression level, password protection, etc.
});

• outputPath - Ruta de destino en el almacenamiento en la nube.
• compressionLevel - Reduce el tamaño del archivo para libros de trabajo grandes (disponible en la referencia de la API).
• password - Protege el archivo resultante con una contraseña si es necesario.

Ajuste estas configuraciones para que coincidan con los requisitos de seguridad y rendimiento de su proyecto.

Consideraciones de rendimiento para editar libros de trabajo XLSX a través de REST

1. Reutilizar el objeto de configuración - Crear una nueva Configuration para cada solicitud añade sobrecarga. Mantenga una única instancia durante la vida útil de su aplicación.
2. Actualizaciones de celdas por lotes - Si necesita modificar muchas celdas, recójalas en una matriz y envíe una única solicitud de edición en lugar de múltiples llamadas.
3. Limitar el tamaño de la hoja de cálculo - Las hojas de cálculo muy grandes aumentan el consumo de memoria. Considere dividir los datos en varias hojas cuando sea posible.
4. Evitar guardados innecesarios - Llame a saveDocument solo después de que se apliquen todos los cambios requeridos para reducir las operaciones de E/S.

Conclusión

Editar un archivo Excel en Node.js a través de REST se vuelve sencillo con el GroupDocs.Editor Cloud SDK for Node.js. Puedes cargar programáticamente un libro de trabajo, modificar celdas y guardar el resultado usando solo unas pocas llamadas API o simples comandos cURL. La arquitectura basada en la nube del SDK elimina la necesidad de instalaciones locales de Office y se adapta a la carga de trabajo de tu aplicación. Para implementaciones en producción, adquiere una licencia que se ajuste a tu patrón de uso, y también puedes obtener una licencia temporal para pruebas desde la página de licencia temporal. Comienza a integrar la edición de Excel hoy y optimiza tus flujos de procesamiento de datos.

Preguntas frecuentes

¿Cómo editar un archivo Excel en Node.js a través de REST sin escribir código HTTP personalizado?
Utilice el GroupDocs.Editor Cloud SDK for Node.js, que abstrae las llamadas REST y le permite editar archivos Excel en Node.js a través de REST con invocaciones de método simples.

¿Puedo actualizar una hoja XLSX usando la API REST Node.js para archivos grandes?
Sí. El SDK transmite datos y admite actualizaciones por lotes, lo que lo hace adecuado para libros de trabajo grandes. Ajuste compressionLevel y los cambios de celdas por lotes para mejorar el rendimiento.

¿Cuál es la mejor manera de modificar una hoja de cálculo de Excel programáticamente con Node.js?
Trabaje con los objetos worksheet y cell devueltos por editDocument. Esto le brinda control total sobre filas, columnas y valores de celdas sin salir del entorno Node.js.

¿Dónde puedo encontrar información sobre precios y licencias?
Todos los detalles de licencias, incluidos los niveles de precios y una licencia temporal para evaluación, están disponibles en la página de licencia temporal.

Leer más

• Editar hoja de Excel vía REST en Java
• Editar hoja de Excel usando la API REST en Python
• Mejores prácticas para el desarrollo del editor CSV en Java