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

<dependencies>
   <dependency>
      <groupId>com.groupdocs</groupId>
      <artifactId>groupdocs-annotation</artifactId>
      <version>24.6</version>
   </dependency>
</dependencies>
copied!  
repositories {
    maven {
        url 'https://releases.groupdocs.com/java/repo/'
    }
}

compile(group: 'com.groupdocs', name: 'groupdocs-annotation', version: '24.6')
copied!  
<ivysettings>
    <settings defaultResolver="chain"/>
    <resolvers>
        <chain name="chain">
            <ibiblio name="GroupDocs Repository" m2compatible="true" root="https://releases.groupdocs.com/java/repo/"/>
        </chain>
    </resolvers>
</ivysettings>

<dependency org="com.groupdocs" name="groupdocs-annotation" rev="24.6">
   <artifact name="groupdocs-annotation" ext="jar"/>
</dependency>
copied!  
resolvers += Resolver.url("GroupDocs Repository", url("https://releases.groupdocs.com/java/repo/"))

libraryDependencies += "com.groupdocs" % "groupdocs-annotation" % "24.6"
copied!  

API d’annotation de documents Java High Code

Produit Documentation Démos Référence API Exemples Blog Support Licence

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.

FormatDescriptionAnnoter
DOCDocument Microsoft Word® 97-2003
DOCXDocument Microsoft Word®
DOCMDocument Microsoft Word® avec macros activées
DOTModèle Microsoft Word® 97-2003
DOTXModèle Microsoft Word®
DOTMModèle Microsoft Word® avec macros activées
RTFDocument de texte enrichi
ODTDocument OpenDocument
XLSFeuille de calcul Microsoft Excel® 97-2003
XLSXFeuille de calcul Microsoft Excel®
XLSM (*xlsx)Feuille de calcul Microsoft Excel® avec macros
XLSB (*xlsx)Feuille de calcul binaire Microsoft Excel®
ODS (*xlsx)Feuille de calcul OpenDocument
PPTPrésentation Microsoft PowerPoint® 97-2003
PPTXPrésentation Microsoft PowerPoint®
PPSDiaporama Microsoft PowerPoint® 97-2003
PPSX (*pptx)Diaporama Microsoft PowerPoint®
ODPPrésentation OpenDocument
TIF, TIFFFormat de fichier image balisé (TIFF)
JPG, JPEGGroupe d’experts photographiques (JPEG)
PNGGraphiques de réseau portables (PNG)
BMPImage bitmap (BMP)
DWG (*png)Formats de données de conception Autodesk®
DXF (*png)Format d’échange de dessins
PDF (PDF/A-1a,PDF/A-1b,PDF/A-2a)Format de document portable Adobe (PDF)
HTM (*html)Langage de balisage HyperText (HTM)
HTMLLangage de balisage HyperText (HTML)
EMLMessage électronique (EML)
EMLX (*eml)Message électronique (EMLX)
VSD (*vsdx)Dessin Microsoft Visio® 2003-2010
VSDXDessin Microsoft Visio®
VSDM (*vsdx)Format de fichier de dessin Microsoft Visio®
VSS (*vsdx)Pochoir Microsoft Visio® 2003-2010
VSSX (*vsdx)Format de fichier pochoir Visio®
VST (*vsdx)Pochoir Microsoft Visio® 2013
VSTM (*vsdx)Format de fichier modèle Microsoft Visio®

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 :

Options prises en charge
Systèmes d’exploitationMicrosoft Windows® Desktop
Microsoft Windows® Server
Linux
macOS
Frameworks pris en chargeJava 7 (1.7) et supérieur
Environnements de développementNetBeans
IntelliJ IDEA
Eclipse
Outil d’automatisation de buildMaven

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.");
    }
}

Produit Documentation Démos Référence API Exemples Blog Support Licence

VersionRelease Date
24.630 juin 2024
23.109 octobre 2023
23.828 août 2023
23.623 juin 2023
23.417 avril 2023
23.216 avril 2023
21.7.225 janvier 2022
21.7.125 janvier 2022
2.0.025 janvier 2022
19.225 janvier 2022
17.1025 janvier 2022
17.10.325 janvier 2022
1.5.025 janvier 2022
21.721 juillet 2021
19.719 février 2020
20.213 février 2020
19.530 mai 2019
19.415 avril 2019
18.116 octobre 2018
18.1016 octobre 2018
1.4.018 avril 2018
1.6.018 avril 2018
1.7.018 avril 2018
1.7.118 avril 2018
1.8.018 avril 2018
1.8.118 avril 2018
1.8.218 avril 2018
1.9.018 avril 2018
17.1.018 avril 2018
17.10.118 avril 2018
17.10.218 avril 2018
17.5.018 avril 2018
17.6.018 avril 2018
18.418 avril 2018
3.1.018 avril 2018