Exemplo completo em funcionamento para remover objetos de anotação de PDF com REST em Node.JS

Este exemplo demonstra como fazer upload de um PDF, excluir todas as suas anotações e baixar o arquivo limpo usando o GroupDocs.Annotation SDK.

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 exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar quaisquer caminhos de arquivos e valores de configuração para corresponder ao seu ambiente real, verifique se todas as dependências necessárias estão devidamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter assistência.

Excluir Anotações de PDF via API REST usando cURL

A seguir estão os comandos cURL que executam o mesmo fluxo de remoção de anotações através dos endpoints REST do 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 obter uma lista completa de endpoints e parâmetros, consulte a documentação oficial da API.

Como remover objetos de anotação de PDF com REST em Node.JS funciona

1. Configuração de Autenticação - A classe Configuration é instanciada com seu clientId e clientSecret, criando um contexto autenticado para todas as chamadas subsequentes da API.

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

2. Upload de Arquivo - UploadFileRequest envia os bytes do PDF local para o armazenamento do GroupDocs Cloud. O método storageApi.uploadFile lida com a transferência.

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

3. Recuperar Anotações - GetAnnotationsRequest cria um objeto de requisição com uma referência FileInfo. A chamada annotationsApi.getAnnotations retorna uma coleção de objetos de anotação, dos quais os IDs são extraídos.

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

4. Excluir Anotações - Se houver IDs, DeleteAnnotationsRequest é preenchido e passado para annotationsApi.deleteAnnotations, que remove permanentemente as anotações do PDF armazenado.

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

5. Baixar PDF Limpo - Por fim, DownloadFileRequest obtém o arquivo atualizado, e fs.writeFileSync grava‑o no sistema de arquivos local.

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

Para definições detalhadas de classes e métodos, consulte a referência da API.

Instalando e Configurando GroupDocs.Annotation Cloud SDK for Node.js

O SDK é distribuído como um pacote npm. Instale‑o com o comando abaixo e, em seguida, importe‑o em seu projeto.

npm install groupdocs-annotation-cloud

Você também pode baixar o pacote mais recente diretamente da página de lançamentos do GitHub ou do URL oficial de download.

Após a instalação, importe a biblioteca e crie um objeto de configuração conforme mostrado no exemplo de código:

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

Certifique-se de que seu ambiente de tempo de execução atenda aos requisitos de versão do Node.js e de que você possua uma conta válida do GroupDocs para obter as credenciais do cliente.

Opções e Configurações de Remoção de Anotações

O SDK expõe vários parâmetros que você pode ajustar:

• clientId / clientSecret - Credenciais para autenticação OAuth. Defina‑as no construtor Configuration.
• fileInfo.filePath - O caminho do PDF no armazenamento GroupDocs Cloud. Ajuste isso se você armazenar arquivos em uma pasta diferente.
• annotationIds - Uma matriz de IDs retornados por GetAnnotations. Fornecer um subconjunto permite exclusão seletiva.

Configurações adicionais, como tempos limite de solicitação e configuração de proxy, estão disponíveis na documentação do SDK; veja a documentação oficial para a lista completa.

Melhores práticas para remover anotações de PDF via REST

• Validar IDs de Anotação - Sempre verifique se os IDs que você pretende excluir existem; tentar excluir IDs inexistentes pode causar um erro 404.
• Usar HTTPS - Todas as chamadas de API devem ser feitas via HTTPS para proteger suas credenciais e os dados do documento.
• Lidar com Arquivos Grandes usando Uploads em Blocos - Para PDFs maiores que 100 MB, prefira o endpoint de upload multipart para evitar timeouts.
• Registrar Respostas da API - Armazene IDs de requisição e respostas para trilhas de auditoria e facilitar a solução de problemas.
• Reutilizar Tokens de Acesso - Cache o token OAuth até que expire para reduzir a sobrecarga de autenticação.

Perguntas Frequentes

• Como faço a autenticação com a API do GroupDocs.Annotation Cloud?
  Obtenha um ID de cliente e um segredo da sua conta GroupDocs, então solicite um token de acesso via o endpoint OAuth. Consulte a documentação oficial para mais detalhes.

• Posso excluir anotações específicas em vez de todas?
  Sim, forneça os IDs das anotações que deseja remover no DeleteAnnotationsRequest. O SDK retorna a lista de IDs de anotações após uma chamada GetAnnotations.

• Como posso remover objetos de Anotação de PDF com REST em Node.JS?
  Use o GroupDocs.Annotation Cloud SDK for Node.js para chamar o endpoint DeleteAnnotations após recuperar os IDs das anotações. O fluxo completo é demonstrado no exemplo de código e na seção cURL deste guia.

• Qual licença é necessária para uso em produção?
  É necessária uma licença paga para produção. Você pode adquirir uma licença temporária na página de licença temporária durante a avaliação.

Leitura adicional

• Extrair ou Remover Anotações de PDF usando API REST em Node.js
• Texto Tachado em um PDF com Node.js e API REST
• Remover Anotações de PDF usando API REST em Python

Editar arquivo Excel em Node.js via REST - Guia de 5 etapas

1. Instale o SDK e configure as credenciais: Defina seu CLIENT_ID e CLIENT_SECRET para que a biblioteca possa autenticar com o 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. Carregue a pasta de trabalho do Excel para edição: Use EditDocumentRequest para abrir o arquivo armazenado em seu armazenamento em nuvem.

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

3. Recupere a primeira planilha e localize a célula de destino: O SDK retorna um objeto document que contém planilhas e células.

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

4. Atualizar ou criar o valor da célula: Altere o conteúdo da célula A1 (ou adicione-a se não existir).

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. Salve a pasta de trabalho editada de volta ao armazenamento: forneça um outputPath e chame 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 uma lista completa de classes e métodos, veja a referência da API.

Editar arquivo Excel em Node.js via REST - Exemplo de código completo

O exemplo a seguir demonstra como editar um arquivo Excel em Node.js via REST usando o 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 exemplo de código demonstra a funcionalidade principal. Antes de usá‑lo em seu projeto, certifique‑se de atualizar quaisquer caminhos de arquivo e valores de configuração para corresponder ao seu ambiente real, verifique se todas as dependências necessárias estão devidamente instaladas e teste minuciosamente em seu ambiente de desenvolvimento. Se encontrar algum problema, consulte a documentação oficial ou entre em contato com a equipe de suporte para obter ajuda.

Atualizar planilha XLSX usando API REST em Node.js via cURL

A seguir, um rápido passo a passo da mesma operação usando chamadas HTTP brutas. Substitua os valores de espaço reservado pelos seus credenciais reais e nomes de arquivos.

1. Obtenha um token de acesso

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"

A resposta contém access_token.

2. Carregue o arquivo XLSX de origem

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

3. Edite a planilha (modifique a célula 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. Baixe o arquivo editado

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

Para mais detalhes sobre os payloads de solicitação, veja a documentação oficial da API.

Pré-requisitos e Configuração para GroupDocs.Editor Cloud SDK for Node.js

Para começar a usar o SDK, você precisa do Node.js 14 ou posterior e de uma conta do GroupDocs Cloud.

npm install groupdocs-editor-cloud

Você também pode baixar o pacote mais recente na página de lançamentos. Após a instalação, crie um client_id e client_secret no painel do GroupDocs Cloud e mantenha‑os seguros.

O que torna o GroupDocs.Editor Cloud SDK for Node.js ideal para modificar planilhas do Excel

• Suporte total a XLSX - Carregue, edite e salve pastas de trabalho preservando fórmulas, estilos e validação de dados.
• Edição ao nível de célula - Acesse células, linhas ou colunas individuais programaticamente, o que é perfeito para atualizar relatórios ou painéis.
• Integração com armazenamento em nuvem - Trabalhe diretamente com arquivos armazenados no GroupDocs Cloud sem baixá‑los localmente.
• Comunicação REST segura - Todas as operações ocorrem via HTTPS, e o SDK gerencia os tokens para você.

Para uma exploração mais aprofundada, consulte a documentação.

Ajuste fino das opções de edição do Excel no GroupDocs.Editor Cloud

O SDK expõe várias opções que permitem controlar como a pasta de trabalho editada é salva.

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

• outputPath - Caminho de destino no armazenamento em nuvem.
• compressionLevel - Reduza o tamanho do arquivo para pastas de trabalho grandes (disponível na referência da API).
• password - Proteja o arquivo resultante com uma senha, se necessário.

Ajuste essas configurações para atender às necessidades de segurança e desempenho do seu projeto.

Considerações de desempenho ao editar pastas de trabalho XLSX via REST

1. Reutilizar o objeto de configuração - Criar um novo Configuration para cada solicitação adiciona sobrecarga. Mantenha uma única instância durante a vida útil da sua aplicação.
2. Atualizações em lote de células - Se precisar modificar muitas células, reúna‑as em um array e envie uma única solicitação de edição em vez de várias chamadas.
3. Limitar o tamanho da planilha - Planilhas muito grandes aumentam o consumo de memória. Considere dividir os dados em várias planilhas quando possível.
4. Evitar salvamentos desnecessários - Chame saveDocument somente depois que todas as alterações necessárias forem aplicadas para reduzir as operações de I/O.

Conclusão

Editar um arquivo Excel em Node.js via REST torna‑se simples com o GroupDocs.Editor Cloud SDK for Node.js. Você pode carregar programaticamente uma planilha, modificar células e salvar o resultado usando apenas algumas chamadas de API ou comandos cURL simples. A arquitetura baseada na nuvem do SDK elimina a necessidade de instalações locais do Office e escala com a carga de trabalho da sua aplicação. Para implantações em produção, adquira uma licença que se ajuste ao seu padrão de uso, e você também pode obter uma licença temporária para testes na página de licença temporária. Comece a integrar a edição de Excel hoje e simplifique seus pipelines de processamento de dados.

FAQs

Como editar um arquivo Excel no Node.js via REST sem escrever código HTTP personalizado?
Use o GroupDocs.Editor Cloud SDK for Node.js, que abstrai as chamadas REST e permite editar o arquivo Excel no Node.js via REST com invocações de método simples.

Posso atualizar uma planilha XLSX usando a API REST Node.js para arquivos grandes?
Sim. O SDK transmite dados em streaming e suporta atualizações em lote, tornando‑o adequado para grandes pastas de trabalho. Ajuste compressionLevel e as alterações de células em lote para melhorar o desempenho.

Qual é a melhor maneira de modificar a planilha do Excel programaticamente no Node.js?
Trabalhe com os objetos worksheet e cell retornados por editDocument. Isso lhe dá controle total sobre linhas, colunas e valores de células sem sair do ambiente Node.js.

Onde posso encontrar informações de preços e licenciamento?
Todos os detalhes de licenciamento, incluindo níveis de preço e uma licença temporária para avaliação, estão disponíveis na página de licença temporária.

Read More

• Editar planilha Excel via REST em Java
• Editar planilha Excel usando API REST em Python
• Melhores práticas para desenvolvimento de editor CSV em Java