API d’annotation de documents Java High Code

GroupDocs.Annotation pour Java est une API robuste sur site conçue pour les développeurs Java pour annoter, filigraner et gérer des documents dans divers formats tels que PDF, Word®, Excel®, PowerPoint® et images. Elle offre des fonctionnalités avancées telles que les annotations de texte, de zone et d’image, le support OLE, la gestion des métadonnées et la compatibilité multiplateforme.

Fonctionnalités de l’API d’annotation de documents Java sur site

Support des documents et des formats

• Support pour plusieurs formats de documents : Annoter divers formats de documents, y compris PDF, Word®, Excel®, PowerPoint®, Visio® et images (JPG, PNG, BMP, etc.).
• Annotations spécifiques aux PDF : Support pour les notes autocollantes, les champs de texte et d’autres types d’annotations spécifiques aux PDF.
• Support des formats d’image : Annoter les formats d’image populaires, y compris JPG, PNG, BMP et plus encore.
• Formats d’exportation des annotations : Exporter des annotations dans différents formats pour l’interopérabilité.
• Support OLE : Support des objets OLE dans les documents annotés.
• Compatibilité avec d’autres API GroupDocs : Intégration transparente avec d’autres produits GroupDocs pour des fonctionnalités étendues.

Types et outils d’annotation

• Annotations de texte : Ajouter des annotations de texte telles que les surlignages, les soulignements et les biffures.
• Annotations de zone : Mettre en évidence et commenter des zones spécifiques à l’aide d’annotations rectangulaires, polygonales et ponctuelles.
• Annotations de balisage : Appliquer des annotations de balisage comme la réduction pour masquer les contenus sensibles.
• Mesure de distance : Mesurer les distances dans les documents, utile pour les dessins techniques et les fichiers CAO.
• Filigranage : Ajouter des filigranes de texte et d’image pour le branding ou des raisons de sécurité.
• Annotations d’image : Annoter des fichiers image, avec support pour plusieurs formats d’image.

Gestion des annotations

• Réponses aux annotations : Permettre à plusieurs utilisateurs de répondre aux annotations, facilitant la révision collaborative des documents.
• Apparence personnalisée des annotations : Personnaliser l’apparence des annotations, y compris les paramètres de couleur, de police et d’opacité.
• Exportation/Importation des annotations : Exporter des annotations vers des fichiers externes et les importer pour le partage ou la collaboration.
• Gestion des couches d’annotations : Contrôler la superposition des annotations, permettant aux annotations de se chevaucher ou de rester séparées.
• Gestion des annotations : Capacité à créer, éditer et supprimer des annotations par programmation.
• Métadonnées d’annotations : Annoter des documents tout en préservant l’intégrité des métadonnées.
• Support de l’annulation/répétition : Implémenter la fonctionnalité d’annulation/répétition pour les opérations d’annotation.

Collaboration et révision

• Fonctionnalités de collaboration : Permettre à plusieurs utilisateurs d’annoter, de commenter et de collaborer sur le même document.
• Comparaison de documents : Comparer des documents ou des images côte à côte pour mettre en évidence les différences.
• Réponses aux annotations : Permettre à plusieurs utilisateurs de répondre aux annotations, facilitant la révision collaborative des documents.

Sécurité des documents et intégrité

• **Sé

curité des documents :** Appliquer des annotations qui peuvent masquer les informations sensibles, comme les réductions.

• Gestion des métadonnées : Gérer et préserver les métadonnées dans les documents annotés.

Recherche et navigation

• Capacités de recherche avancée : Rechercher dans les documents annotés, y compris la possibilité de rechercher dans les annotations.

Performance et scalabilité

• Traitement par lots : Gérer les annotations sur plusieurs documents à la fois pour augmenter l’efficacité.
• Scalabilité : Conçu pour gérer efficacement de grands volumes de documents et d’annotations.
• Haute performance : Optimisé pour un traitement rapide des annotations et la gestion des documents.

Compatibilité multiplateforme et intégration

• Compatibilité multiplateforme : Utilisable sur plusieurs systèmes d’exploitation, y compris Windows, macOS et Linux.
• Intégration flexible : Intégration facile dans les applications Java avec un ensemble riche de fonctionnalités API.

Sortie et présentation

• Impression et enregistrement des annotations : Inclure ou exclure des annotations lors de l’impression ou de l’enregistrement des documents.

Formats de documents pris en charge

Pour certains types de fichiers, GroupDocs.Annotation enregistre le résultat dans un format différent. Dans ce cas, le type de fichier de sortie est spécifié après *. Si aucun symbole de ce type n’est spécifié, GroupDocs.Annotation enregistre le résultat dans le type de fichier original.

Types d’annotations pris en charge

Annotations graphiques

• Zone : Marque une zone avec un rectangle et y ajoute des notes.
• Flèche : Trace une flèche dans un document.
• Distance : Mesure la distance entre les objets dans un document.
• Ellipse : Trace une annotation elliptique dans un document.
• Point : Colle des commentaires à n’importe quel point d’un document.
• Polyligne : Trace des formes et des lignes à main levée.
• Réduction : Remplit un rectangle noir avec une position fixe (utilisé pour masquer du texte).
• Champ de texte : Ajoute un rectangle avec du texte à l’intérieur.

Annotations de texte

• Surligner : Surligne et commente le texte sélectionné.
• Remplacement : Remplace le texte original par le texte de l’utilisateur.
• Biffure : Marque le texte avec un style de barré.
• Souligner : Marque le texte avec un style de soulignement.

Annotations de filigrane

• Filigrane horizontal : Ajoute un filigrane de texte horizontal.
• Filigrane diagonal : Ajoute un filigrane de texte diagonal.

Configuration système requise

GroupDocs.Annotation pour Java prend en charge les systèmes d’exploitation, les frameworks et les gestionnaires de packages suivants :

GroupDocs.Annotation pour Java ne nécessite aucun logiciel externe ou outil tiers à installer. Suivez simplement l’une des méthodes décrites dans Installation et Configuration.

Commencer

GroupDocs héberge toutes les API Java sur le dépôt GroupDocs. Vous pouvez facilement utiliser l’API GroupDocs.Annotation pour Java directement dans vos projets Maven avec des configurations simples.

Étape 1 : Spécifier la configuration du dépôt GroupDocs

Pour commencer, vous devez spécifier la configuration du dépôt GroupDocs dans votre fichier pom.xml Maven comme suit :

<repositories>
    <repository>
        <id>GroupDocs Artifact Repository</id>
        <name>GroupDocs Artifact Repository</name>
        <url>https://releases.groupdocs.com/java/repo/</url>
    </repository>
</repositories>

Étape 2 : Définir la dépendance API GroupDocs.Annotation pour Java

Ensuite, définissez la dépendance API GroupDocs.Annotation pour Java dans votre fichier pom.xml comme suit :

<dependencies>
    <dependency>
        <groupId>com.groupdocs</groupId>
        <artifactId>groupdocs-annotation</artifactId>
        <version>23.10</version> 
    </dependency>
</dependencies>

Exemples de code

Exemple de code 1 : Ajouter une annotation de texte à un document PDF

Ce fragment de code montre comment utiliser GroupDocs.Annotation pour Java pour ajouter une annotation de texte à un document PDF. L’annotation de texte inclut un commentaire ou une note qui apparaît sous forme de pop-up lorsque l’utilisateur survole la zone annotée. Cette fonctionnalité est particulièrement utile pour la révision et les commentaires sur les documents PDF.

// Importer les classes nécessaires
import com.groupdocs.annotation.Annotator;
import com.groupdocs.annotation.models.Annotation;
import com.groupdocs.annotation.models.annotationtypes.TextAnnotation;
import com.groupdocs.annotation.options.export.AnnotationOptions;

import java.awt.Color;
import java.nio.file.Paths;

public class AddTextAnnotationToPDF {
    public static void main(String[] args) {
        // Chemin vers le document PDF d'entrée
        String inputFilePath = "input.pdf";
        
        // Chemin vers le document PDF

 de sortie
        String outputFilePath = "output.pdf";
        
        // Initialiser l'objet Annotator pour le document PDF
        Annotator annotator = new Annotator(inputFilePath);
        
        // Créer une nouvelle annotation de texte
        TextAnnotation textAnnotation = new TextAnnotation();
        textAnnotation.setPageNumber(1); // Définir le numéro de page
        textAnnotation.setMessage("Ceci est une annotation de texte"); // Définir le message de l'annotation
        textAnnotation.setBox(new Rectangle(100, 100, 200, 50)); // Définir la position et la taille de l'annotation
        textAnnotation.setBackgroundColor(Color.yellow); // Définir la couleur d'arrière-plan de l'annotation
        textAnnotation.setFontColor(Color.black); // Définir la couleur de police pour le texte de l'annotation
        
        // Ajouter l'annotation de texte au document
        annotator.add(textAnnotation);
        
        // Enregistrer le document PDF annoté
        annotator.save(outputFilePath, new AnnotationOptions());
        
        // Fermer l'annotateur
        annotator.dispose();
        
        System.out.println("Annotation de texte ajoutée avec succès au document PDF.");
    }
}

Exemple de code 2 : Supprimer des annotations d’un document Word

Ce fragment de code illustre comment supprimer toutes les annotations d’un document Microsoft Word (DOCX) en utilisant GroupDocs.Annotation pour Java. Ceci est particulièrement utile lorsque vous devez nettoyer un document en supprimant des commentaires, des notes ou d’autres types d’annotations.

// Importer les classes nécessaires
import com.groupdocs.annotation.Annotator;
import com.groupdocs.annotation.options.remove.RemoveOptions;

public class RemoveAnnotationsFromWordDocument {
    public static void main(String[] args) {
        // Chemin vers le document Word d'entrée
        String inputFilePath = "input.docx";
        
        // Chemin vers le document Word de sortie
        String outputFilePath = "output.docx";
        
        // Initialiser l'objet Annotator pour le document Word
        Annotator annotator = new Annotator(inputFilePath);
        
        // Définir les options de suppression pour supprimer toutes les annotations
        RemoveOptions removeOptions = new RemoveOptions();
        
        // Supprimer toutes les annotations du document
        annotator.remove(removeOptions);
        
        // Enregistrer le document Word nettoyé
        annotator.save(outputFilePath);
        
        // Fermer l'annotateur
        annotator.dispose();
        
        System.out.println("Toutes les annotations ont été supprimées avec succès du document Word.");
    }
}

Exemple de code 3 : Extraire les commentaires d’une feuille de calcul Excel

Ce fragment de code montre comment extraire les commentaires et les annotations d’une feuille de calcul Excel (XLSX) en utilisant GroupDocs.Annotation pour Java. Cette fonctionnalité est utile pour examiner et résumer les retours ou les notes laissés dans un document Excel.

// Importer les classes nécessaires
import com.groupdocs.annotation.Annotator;
import com.groupdocs.annotation.models.AnnotationBase;
import com.groupdocs.annotation.options.export.AnnotationOptions;

import java.util.List;

public class ExtractCommentsFromExcel {
    public static void main(String[] args) {
        // Chemin vers le document Excel d'entrée
        String inputFilePath = "input.xlsx";
        
        // Initialiser l'objet Annotator pour le document Excel
        Annotator annotator = new Annotator(inputFilePath);
        
        // Extraire toutes les annotations du document
        List<AnnotationBase> annotations = annotator.get();
        
        // Parcourir les annotations extraites et imprimer leurs messages
        for (AnnotationBase annotation : annotations) {
            System.out.println("Type d'annotation : " + annotation.getAnnotationType());
            System.out.println("Message de l'annotation : " + annotation.getMessage());
        }
        
        // Fermer l'annotateur
        annotator.dispose();
        
        System.out.println("Les commentaires ont été extraits avec succès de la feuille de calcul Excel.");
    }
}