API REST Java Cloud para Anotação de Documentos

O GroupDocs.Annotation Cloud SDK para Java ajuda você a criar aplicativos Java para anotar documentos na nuvem que funcionam sem a necessidade de instalar qualquer software de terceiros. Ele é um wrapper em torno das APIs REST do GroupDocs.Annotation Cloud.

Funcionalidades de Anotação de Documentos

• Adicione uma ou várias anotações a documentos na nuvem.
• Adicione anotações diretamente a documentos armazenados na nuvem.
• Suporte a vários tipos de anotações, incluindo texto, imagens e formas.
• Personalize as propriedades das anotações, como cor, tamanho e posição.
• Anote vários formatos de documentos como PDF, Word, Excel, PowerPoint e imagens.

Funcionalidades de Gerenciamento de Documentos

• Renderização de Documentos: Converta documentos em formatos como PDF, imagens ou HTML para visualização ou impressão.
• Pré-visualização de Documentos: Gere representações em imagem das páginas do documento para fins de pré-visualização.
• Remover Anotações: Exclua anotações específicas ou remova todas as anotações de um documento.
• Extrair Anotações: Recupere todas as anotações de um documento como uma lista de objetos JSON.

Gerenciamento de Arquivos e Armazenamento

• Trabalhando com API de Arquivos: Faça upload, download, copie, mova e exclua arquivos no armazenamento na nuvem.
• Trabalhando com API de Pastas: Organize e gerencie pastas no armazenamento na nuvem (crie, mova, exclua).
• Trabalhando com API de Armazenamento: Acesse e gerencie recursos de armazenamento na nuvem, incluindo recuperação de detalhes de armazenamento e informações de arquivos.
• Obter Formatos de Arquivos Suportados: Recupere uma lista de formatos de arquivos suportados para anotações.
• Informações de Arquivo: Obtenha informações detalhadas sobre arquivos na nuvem, como tamanho, formato e metadados.

Informações e Processamento de Documentos

• Obter Informações de Documentos: Recupere informações detalhadas do documento, incluindo metadados, conteúdo de texto e anotações.
• Obter Páginas: Acesse a lista de páginas em um documento juntamente com detalhes como tamanho e orientação.
• Informações de Anotação: Acesse informações detalhadas sobre as anotações, incluindo tipo, posição e conteúdo.
• Opções de Anotação: Configure várias opções de anotação, incluindo seleção de página, posição e estilo.
• Uso Avançado: Utilize recursos avançados para gerenciar anotações, como agrupamento e ordenação.

Tipos de Anotações Suportadas

• **[Anotação de Área](https://docs.groupdocs.cloud/annotation

/area-annotation/):** Destaque e anote uma área retangular específica em um documento na nuvem.

• Anotação de Seta: Desenhe uma seta para indicar um conteúdo específico na página do documento na nuvem.
• Anotação de Distância: Meça e anote a distância entre dois objetos ou pontos em um documento na nuvem.
• Anotação de Elipse: Use uma forma elíptica para destacar e anotar conteúdo específico em um documento.
• Anotação de Imagem: Sobreponha uma imagem como anotação sobre o conteúdo do documento.
• Anotação de Link: Adicione uma anotação de hyperlink que liga a um recurso externo.
• Anotação de Ponto: Coloque uma nota em um ponto específico dentro do documento para anotação detalhada.
• Anotação de Polilinha: Desenhe linhas ou formas à mão livre para anotar e destacar conteúdo.
• Anotação de Redação de Recursos: Redija texto sensível cobrindo-o com um retângulo preto.
• Anotação de Campo de Texto: Adicione um comentário de texto dentro de uma moldura colorida como anotação.
• Anotação de Destaque de Texto: Destaque o texto e adicione comentários para chamar a atenção para um conteúdo específico.
• Anotação de Redação de Texto: Oculte o texto selecionado com um retângulo preto para redação.
• Anotação de Substituição de Texto: Substitua o texto original por um novo fragmento por meio de anotação.
• Anotação de Riscar Texto: Risque o texto para indicar exclusão.
• Anotação de Sublinhado de Texto: Sublinhado e anote o texto para dar ênfase.
• Anotação de Marca d’Água: Adicione uma anotação de texto em marca d’água sobre o documento.
• Anotação de Zigue-Zague: Use uma linha ziguezague para sublinhar e chamar a atenção para o texto.

Funcionalidades Específicas da API

• Adicionar Anotações Diretamente: Adicione anotações a documentos sem baixá-los.
• Exemplos de API Pública: Acesse código de exemplo e documentação para utilizar os recursos da API.

Formatos de Documentos Suportados para Anotação na Nuvem

• Microsoft Word®: DOC, DOCX, DOCM, DOT, DOTX, DOTM, RTF, TXT
• OpenOffice Writer®: ODT, OTT
• Microsoft Excel®: XLS, XLSX, XLSB
• Microsoft PowerPoint®: PPT, PPTX, PPSX
• OpenOffice Impress®: ODP, OTP
• Microsoft Visio®: VSD, VDX, VSS, VSDM
• Microsoft Outlook®: MSG, EML, EMLX
• AutoCAD®: CAD
• Imagens: DJVU, JPEG, TIFF, BMP, GIF (imagens estáticas sem animação)
• Imagens Médicas: DICOM
• Marcação: HTML, MHTML
• Layout Fixo: PDF
• MetaFiles: EMF, WMF

Requisitos

• Versão do Java: Para construir a biblioteca cliente da API, é necessário Java 1.7+.
• Ferramenta de Construção: Maven é necessário para gerenciar dependências e construir o projeto.

Pré-requisitos

• Conta GroupDocs Cloud: Para usar o GroupDocs.Annotation Cloud SDK para Java, você precisa registrar uma conta no GroupDocs Cloud.
• ID do Cliente e Segredo do Cliente: Após registrar-se, você precisará consultar ou criar seu ID do Cliente e Segredo do Cliente no Painel da Nuvem.
• Cota Gratuita: O GroupDocs Cloud oferece uma cota gratuita para novos usuários. Para mais detalhes, você deve verificar o Preços do GroupDocs Cloud.

Instalar o GroupDocs.Annotation-Cloud pelo Maven

Para instalar o GroupDocs.Annotation Cloud SDK para Java, você precisa adicionar o repositório GroupDocs Cloud ao arquivo pom.xml do seu aplicativo:

<repository>
    <id>repository.groupdocs.cloud</id>
    <name>repository.groupdocs.cloud</name>
    <url>https://releases.groupdocs.cloud/java/repo/</url>
</repository>

Instalar a partir do Código Fonte

Para instalar a biblioteca cliente da API a partir do código fonte, siga estas etapas:

• Instalar no Repositório Maven Local: Para instalar a biblioteca no seu repositório Maven local, basta executar o seguinte comando no terminal:

mvn clean install

• Implantar no Repositório Maven Remoto: Se você desejar implantar em um repositório Maven remoto, configure as configurações do repositório e execute o seguinte comando:

mvn clean deploy

Para mais detalhes sobre a implantação em um repositório remoto, consulte o Guia OSSRH.

Usuários do Maven

Se você é um usuário do Maven, pode adicionar o GroupDocs.Annotation Cloud SDK para Java como uma dependência no arquivo pom.xml do seu projeto:

<dependency>
    <groupId>com.groupdocs</groupId>
    <artifactId>groupdocs-annotation-cloud</artifactId>
    <version>22.2</version>
    <type>pom</type>
</dependency>

Primeiros Passos

Para começar a usar o GroupDocs.Annotation Cloud SDK para Java, siga estas etapas:

1. Instalar o SDK: Instale o SDK seguindo as etapas descritas acima (usando Maven ou instalando a partir do código fonte).
2. Configuração: Configure o SDK utilizando seu ID do Cliente e Segredo do Cliente obtidos no Painel do GroupDocs Cloud.
3. Código de Exemplo: Implemente o código de exemplo em sua aplicação para adicionar anotações, extrair informações de documentos ou gerenciar arquivos e pastas.
4. Documentação: Consulte as instruções de Início Rápido e a documentação da API para exemplos detalhados de uso e informações adicionais.

Autorização & Autenticação

O GroupDocs.Annotation Cloud SDK para Java usa OAuth 2.0 para autorização e autenticação. Os seguintes detalhes são fornecidos:

• Tipo de Autorização: OAuth 2.0
• Fluxo: Autorização baseada em aplicação
• URL de Autorização: https://api.groupdocs.cloud/connect/token
• Duração do Token: 1 dia (por padrão)

JWT

O GroupDocs.Annotation Cloud SDK utiliza JSON Web Tokens (JWT) para acesso seguro à API:

• Tipo de Token: OAuth 2.0 JWT (JSON Web Token)
• URL de Autorização: Os tokens são gerados usando o endpoint https://api.groupdocs.cloud/connect/token.
• Expiração do Token: A duração padrão do token é de 1 dia, garantindo acesso seguro e temporário à API.

Esses detalhes fornecem um guia abrangente para configurar e usar o GroupDocs.Annotation Cloud SDK para Java, cobrindo os requisitos essenciais, etapas de instalação e configurações de segurança.

Aqui estão dois dos trechos de código mais vendáveis extraídos do conteúdo fornecido. Esses trechos mostram funcionalidades essenciais que atrairiam usuários potenciais interessados em integrar capacidades de anotação em suas aplicações.

Código de Exemplo em Java para Adicionar uma Anotação de Ponto

Este trecho demonstra como adicionar uma anotação de ponto a um documento usando o GroupDocs.Annotation Cloud SDK para Java. As anotações de ponto são úteis para marcar pontos específicos em um documento com comentários ou notas.

// Para exemplos completos e arquivos de dados, acesse https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples
String MyAppKey = ""; // Obtenha o AppKey e o AppSID em https://dashboard.groupdocs.cloud
String MyAppSid

 = ""; // Obtenha o AppKey e o AppSID em https://dashboard.groupdocs.cloud

Configuration configuration = new Configuration(MyAppSid, MyAppKey);
AnnotateApi apiInstance = new AnnotateApi(configuration);

// Criar anotação(s).
AnnotationInfo[] annotations = new AnnotationInfo[1];
annotations[0] = new AnnotationInfo();

Point pt = new Point();
pt.setX(1.0);
pt.setY(1.0);
annotations[0].setAnnotationPosition(pt);

Rectangle r = new Rectangle();
r.setX(100.0);
r.setY(100.0);
r.setWidth(200.0);
r.setHeight(100.0);

annotations[0].setBox(r);
annotations[0].setPageNumber(0);
annotations[0].setType(TypeEnum.POINT);
annotations[0].setText("Esta é uma anotação de ponto");
annotations[0].setCreatorName("Anonym A.");

// Criar objeto de solicitação.
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("Annotationdocs\\one-page.docx");

AnnotateOptions options = new AnnotateOptions();
options.setFileInfo(fileInfo);
options.setAnnotations(Arrays.asList(annotations));
options.setOutputPath("Output/one-page-annotated.docx");

AnnotateRequest request = new AnnotateRequest(options);

// Executar método da API.
AnnotationApiLink result = apiInstance.annotate(request);
System.out.println("AddPointAnnotation: Anotação de Ponto adicionada: " + result.getTitle());

Código de Exemplo em Java para Adicionar uma Anotação de Destaque de Texto

Este trecho de código mostra como adicionar uma anotação de destaque de texto a um documento. Destacar texto é uma tarefa comum de anotação, especialmente em processos de revisão, e este trecho ilustra como isso pode ser feito programaticamente.

// Para exemplos completos e arquivos de dados, acesse https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples
String MyAppKey = ""; // Obtenha o AppKey e o AppSID em https://dashboard.groupdocs.cloud
String MyAppSid = ""; // Obtenha o AppKey e o AppSID em https://dashboard.groupdocs.cloud

Configuration configuration = new Configuration(MyAppSid, MyAppKey);
AnnotateApi apiInstance = new AnnotateApi(configuration);

// Criar anotação(s).
AnnotationInfo[] annotations = new AnnotationInfo[1];
annotations[0] = new AnnotationInfo();

Rectangle r = new Rectangle();
r.setX(100.0);
r.setY(100.0);
r.setWidth(300.0);
r.setHeight(50.0);

annotations[0].setBox(r);
annotations[0].setPageNumber(0);
annotations[0].setType(TypeEnum.TEXT_HIGHLIGHT);
annotations[0].setText("Este texto está destacado");
annotations[0].setCreatorName("Anonym A.");

// Criar objeto de solicitação.
FileInfo fileInfo = new FileInfo();
fileInfo.setFilePath("Annotationdocs\\sample.docx");

AnnotateOptions options = new AnnotateOptions();
options.setFileInfo(fileInfo);
options.setAnnotations(Arrays.asList(annotations));
options.setOutputPath("Output/sample-annotated.docx");

AnnotateRequest request = new AnnotateRequest(options);

// Executar método da API.
AnnotationApiLink result = apiInstance.annotate(request);
System.out.println("AddTextHighlightAnnotation: Anotação de Destaque de Texto adicionada: " + result.getTitle());