API REST de Cloud Annotation pour Java

GroupDocs.Annotation Cloud SDK pour Java vous aide à créer des applications annotatrices de documents Java dans le cloud qui fonctionnent sans installer de logiciel tiers. Il s’agit d’un wrapper autour des API REST de GroupDocs.Annotation Cloud.

Fonctionnalités d’Annotation de Document

• Ajouter une ou plusieurs annotations aux documents dans le cloud.
• Ajouter des annotations directement aux documents stockés dans le cloud.
• Prise en charge de différents types d’annotations, y compris texte, images et formes.
• Personnaliser les propriétés des annotations telles que la couleur, la taille et la position.
• Annoter plusieurs formats de documents tels que PDF, Word, Excel, PowerPoint et images.

Fonctionnalités de Gestion de Documents

• Rendu de Documents: Convertir des documents en formats tels que PDF, images ou HTML pour visualisation ou impression.
• Prévisualisation de Document: Générer des représentations d’images des pages de documents à des fins de prévisualisation.
• Suppression d’Annotations: Supprimer des annotations spécifiques ou supprimer toutes les annotations d’un document.
• Extraction d’Annotations: Récupérer toutes les annotations d’un document sous forme de liste d’objets JSON.

Gestion des Fichiers et du Stockage

• Travailler avec l’API de Fichier: Télécharger, copier, déplacer et supprimer des fichiers dans le stockage cloud.
• Travailler avec l’API de Dossier: Organiser et gérer les dossiers dans le stockage cloud (créer, déplacer, supprimer).
• Travailler avec l’API de Stockage: Accéder et gérer les ressources de stockage cloud, y compris récupérer des détails de stockage et des informations sur les fichiers.
• Obtenir les Formats de Fichiers Supportés: Récupérer une liste des formats de fichiers supportés pour les annotations.
• Infos sur le Fichier: Obtenir des informations détaillées sur les fichiers dans le cloud, telles que la taille, le format et les métadonnées.

Informations et Traitement des Documents

• Obtenir des Informations sur le Document: Récupérer des informations détaillées sur le document, y compris les métadonnées, le contenu du texte et les annotations.
• Obtenir les Pages: Accéder à la liste des pages dans un document ainsi que des détails tels que la taille et l’orientation.
• Infos sur les Annotations: Accéder à des informations détaillées sur les annotations, y compris le type, la position et le contenu.
• Options d’Annotation: Configurer diverses options d’annotation, y compris la sélection des pages, la position et le style.
• Utilisation Avancée: Utiliser des fonctionnalités avancées pour gérer les annotations, telles que le regroupement et l’ordre.

Types d’Annotations Supportées

• Annotation de Zone: Mettre en évidence et annoter une zone rectangulaire spécifique dans un document cloud.
• Annotation de Flèche: Dessiner une flèche pour indiquer un contenu spécifique sur la page d’un document cloud.
• Annotation de Distance: Mesurer et annoter la distance entre deux objets ou points dans un document cloud.
• Annotation d’Ellipse: Utiliser une forme elliptique pour mettre en évidence et annoter un contenu spécifique dans un document.
• Annotation d’Image: Superposer une image en tant qu’annotation sur le contenu du document.
• Annotation de Lien: Ajouter une annotation de lien hypertexte qui renvoie à une ressource externe.
• Annotation de Point: Placer une note à un point spécifique dans le document pour une annotation détaillée.
• Annotation de Polyligne: Dessiner des lignes ou des formes libres pour annoter et mettre en évidence du contenu.
• Annotation de Redaction de Ressources: Rédiger du texte sensible en le recouvrant d’un rectangle noir.
• Annotation de Champ de Texte: Ajouter un commentaire textuel dans un cadre coloré en tant qu’annotation.
• Annotation de Surlignage de Texte: Surligner du texte et ajouter des commentaires pour attirer l’attention sur un contenu spécifique.
• Annotation de Redaction de Texte: Masquer le texte sélectionné avec un rectangle noir pour la rédaction.
• Annotation de Remplacement de Texte: Remplacer le texte original par un nouveau fragment via l’annotation.
• Annotation de Barré de Texte: Marquer le texte avec une barre pour indiquer la suppression.
• Annotation de Soulignement de Texte: Souligner et annoter du texte pour insister.
• Annotation de Filigrane: Ajouter une annotation de texte en filigrane sur le document.
• Annotation de Ligne Ondulée: Utiliser une ligne ondulée pour souligner et attirer l’attention sur du texte.

Fonctionnalités Spécifiques de l’API

• Ajouter des Annotations Directement: Ajouter des annotations aux documents sans les télécharger.
• Exemples d’API Publique: Accéder à des exemples de code et à la documentation pour utiliser les fonctionnalités de l’API.

Formats de Documents d’Annotation Cloud Supportés

• 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
• Images: DJVU, JPEG, TIFF, BMP, GIF (images statiques sans animation)
• Imagerie Médicale: DICOM
• Marquage: HTML, MHTML
• Mise en Page Fixe: PDF
• Métafichiers: EMF, WMF

Exigences

• Version de Java: La construction de la bibliothèque client API nécessite Java 1.7+.
• Outil de Construction: Maven est requis pour gérer les dépendances et construire le projet.

Prérequis

• Compte GroupDocs Cloud: Pour utiliser GroupDocs.Annotation Cloud SDK pour Java, vous devez créer un compte avec GroupDocs Cloud.
• ID Client & Secret Client: Après enregistrement, vous devez consulter ou créer votre ID Client et Secret Client sur le Tableau de Bord Cloud.
• Quota Gratuit: GroupDocs Cloud offre un quota gratuit pour les nouveaux utilisateurs. Pour plus de détails, vous devriez consulter la Tarification GroupDocs Cloud.

Installer GroupDocs.Annotation-Cloud depuis Maven

Pour installer GroupDocs.Annotation Cloud SDK pour Java, vous devez ajouter le dépôt GroupDocs Cloud au fichier pom.xml de votre application :

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

Installer depuis la Source

Pour installer la bibliothèque client API à partir du code source, suivez ces étapes :

• Installer dans le Dépôt Maven Local: Pour installer la bibliothèque dans votre dépôt Maven local, exécutez simplement la commande suivante dans le terminal :

mvn clean install

• Déployer dans un Dépôt Maven Distant: Si vous souhaitez le déployer dans un dépôt Maven distant, configurez les paramètres du dépôt et exécutez la commande suivante :

mvn clean deploy

Pour plus de détails sur le déploiement dans un dépôt distant, reportez-vous au Guide OSSRH.

Utilisateurs de Maven

Si vous êtes un utilisateur Maven, vous pouvez ajouter GroupDocs.Annotation Cloud SDK pour Java comme dépendance dans le fichier pom.xml de votre projet :

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

Commencer

Pour commencer avec GroupDocs.Annotation Cloud SDK pour Java, suivez ces étapes :

1. Installer le SDK: Installez le SDK en suivant les étapes décrites ci-dessus (en utilisant Maven ou en installant depuis la source).
2. Configuration: Configurez la configuration en utilisant votre ID Client et Secret Client obtenus depuis le Tableau de Bord Cloud GroupDocs.
3. Exemple de Code: Implémentez un exemple de code dans votre application pour ajouter des annotations, extraire des informations de document ou gérer des fichiers et dossiers.
4. Documentation: Reportez-vous aux instructions de Démarrage Rapide et à la documentation de l’API pour des exemples d’utilisation détaillés et des informations supplémentaires.

Autorisation & Authentification

GroupDocs.Annotation Cloud SDK pour Java utilise OAuth 2.0 pour l’autorisation et l’authentification. Les détails suivants sont fournis :

• Type d’Autorisation: OAuth 2.0
• Flux: Autorisation basée sur l’application
• URL d’Autorisation: https://api.groupdocs.cloud/connect/token
• Durée de Vie du Jeton: 1 jour (par défaut)

JWT

GroupDocs.Annotation Cloud SDK utilise des Jetons Web JSON (JWT) pour un accès sécurisé à l’API :

• Type de Jeton: OAuth 2.0 JWT (Jeton Web JSON)
• URL d’Autorisation: Les jetons sont générés en utilisant le point de terminaison https://api.groupdocs.cloud/connect/token.
• Expiration du Jeton: La durée de vie par défaut du jeton est de 1 jour, garantissant un accès sécurisé et limité dans le temps à l’API.

Ces détails fournissent un guide complet pour configurer et utiliser GroupDocs.Annotation Cloud SDK pour Java, couvrant les exigences essentielles, les étapes d’installation et les configurations de sécurité.

Exemple de Code en Java pour Ajouter une Annotation de Point dans le Cloud

Cet extrait montre comment ajouter une annotation de point à un document en utilisant GroupDocs.Annotation Cloud SDK pour Java. Les annotations de points sont utiles pour marquer des points spécifiques dans un document avec des commentaires ou des notes.

// Pour des exemples complets et des fichiers de données, veuillez consulter https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples
String MyAppKey = ""; // Obtenez AppKey et AppSID depuis https://dashboard.groupdocs.cloud
String MyAppSid = ""; // Obtenez AppKey et AppSID depuis https://dashboard.groupdocs.cloud

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

// Créer des annotations.
AnnotationInfo[] annotations = new AnnotationInfo[1];
annotations[0] = new AnnotationInfo();

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

AnnotationPosition(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("Ceci est une annotation de point");
annotations[0].setCreatorName("Anonym A.");

// Créer un objet de requête.
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);

// Exécuter la méthode de l'API.
AnnotationApiLink result = apiInstance.annotate(request);
System.out.println("AddPointAnnotation: Annotation de point ajoutée: " + result.getTitle());

Exemple de Code en Java pour Ajouter une Annotation de Surlignage de Texte dans le Cloud

Cet extrait de code montre comment ajouter une annotation de surlignage de texte à un document. Le surlignage de texte est une tâche d’annotation courante, notamment dans les processus de révision, et cet extrait illustre comment cela peut être fait de manière programmatique.

// Pour des exemples complets et des fichiers de données, veuillez consulter https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples
String MyAppKey = ""; // Obtenez AppKey et AppSID depuis https://dashboard.groupdocs.cloud
String MyAppSid = ""; // Obtenez AppKey et AppSID depuis https://dashboard.groupdocs.cloud

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

// Créer des annotations.
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("Ce texte est surligné");
annotations[0].setCreatorName("Anonym A.");

// Créer un objet de requête.
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);

// Exécuter la méthode de l'API.
AnnotationApiLink result = apiInstance.annotate(request);
System.out.println("AddTextHighlightAnnotation: Annotation de surlignage de texte ajoutée: " + result.getTitle());