Dokumentenannotation Java Cloud REST API

GroupDocs.Annotation Cloud SDK für Java hilft Ihnen, cloudbasierte Dokumentenannotator-Java-Apps zu erstellen, die ohne Installation von Drittanbietersoftware funktionieren. Es handelt sich um eine Wrapper-Bibliothek für GroupDocs.Annotation Cloud REST APIs.

Funktionen zur Dokumentenannotation

• Fügen Sie einzelne oder mehrere Anmerkungen zu Cloud-Dokumenten hinzu.
• Fügen Sie Anmerkungen direkt zu Dokumenten hinzu, die in der Cloud gespeichert sind.
• Unterstützung verschiedener Annotationsarten, einschließlich Text, Bilder und Formen.
• Anpassen von Anmerkungseigenschaften wie Farbe, Größe und Position.
• Annotieren Sie verschiedene Dokumentformate wie PDF, Word, Excel, PowerPoint und Bilder.

Dokumentenverwaltungsfunktionen

• Dokumente rendern: Konvertieren Sie Dokumente in Formate wie PDF, Bilder oder HTML zum Anzeigen oder Drucken.
• Dokumentvorschau: Erstellen Sie Bilddarstellungen von Dokumentseiten zur Vorschau.
• Anmerkungen entfernen: Löschen Sie bestimmte Anmerkungen oder entfernen Sie alle Anmerkungen aus einem Dokument.
• Anmerkungen extrahieren: Rufen Sie alle Anmerkungen aus einem Dokument als Liste von JSON-Objekten ab.

Datei- und Speicherverwaltung

• Arbeiten mit der Datei-API: Laden Sie Dateien in der Cloud hoch, laden Sie sie herunter, kopieren, verschieben und löschen Sie sie.
• Arbeiten mit der Ordner-API: Organisieren und verwalten Sie Ordner in der Cloud (erstellen, verschieben, löschen).
• Arbeiten mit der Speicher-API: Greifen Sie auf Cloud-Speicherressourcen zu und verwalten Sie sie, einschließlich Abrufen von Speicherdetails und Dateiinformationen.
• Unterstützte Dateiformate abrufen: Rufen Sie eine Liste der unterstützten Dateiformate für Anmerkungen ab.
• Dateiinformationen: Abrufen detaillierter Informationen über Dateien in der Cloud, wie Größe, Format und Metadaten.

Dokumenteninformation und -verarbeitung

• Dokumentinformationen abrufen: Abrufen detaillierter Dokumentinformationen, einschließlich Metadaten, Textinhalte und Anmerkungen.
• Seiten abrufen: Zugriff auf die Liste der Seiten in einem Dokument zusammen mit Details wie Größe und Ausrichtung.
• Anmerkungsinformationen: Abrufen detaillierter Informationen über Anmerkungen, einschließlich Typ, Position und Inhalt.
• Anmerkungsoptionen: Konfigurieren Sie verschiedene Anmerkungsoptionen, einschließlich Seitenauswahl, Position und Stil.
• Erweiterte Nutzung: Nutzen Sie erweiterte Funktionen zur Verwaltung von Anmerkungen, wie z.B. Gruppierung und Reihenfolge.

Unterstützte Annotationsarten

• Bereichsanmerkung: Markieren und annotieren Sie einen bestimmten rechteckigen Bereich innerhalb eines Cloud-Dokuments.

• Pfeilanmerkung: Zeichnen Sie einen Pfeil, um spezifische Inhalte auf der Cloud-Dokumentseite hervorzuheben.

• Abstandsanmerkung: Messen und annotieren Sie den Abstand zwischen zwei Objekten oder Punkten in einem Cloud-Dokument.

• Ellipsenanmerkung: Verwenden Sie eine elliptische Form, um spezifische Inhalte in einem Dokument hervorzuheben und zu annotieren.

• Bildanmerkung: Überlagern Sie ein Bild als Anmerkung über dem Dokumentinhalt.

• Linkanmerkung: Fügen Sie eine Hyperlink-Anmerkung hinzu, die auf eine externe Ressource verweist.

• Punktanmerkung: Platzieren Sie eine Notiz an einem bestimmten Punkt im Dokument für eine detaillierte Anmerkung.

• Polylinienanmerkung: Zeichnen Sie Freihandlinien oder -formen, um Inhalte zu annotieren und hervorzuheben.

• Schwärzungsanmerkung: Schwärzen Sie vertraulichen Text, indem Sie ihn mit einem schwarzen Rechteck abdecken.

• Textfeldanmerkung: Fügen Sie einen Textkommentar in einem farbigen Rahmen als Anmerkung hinzu.

• Texthervorhebung: Heben Sie Text hervor und fügen Sie Kommentare hinzu, um auf bestimmte Inhalte aufmerksam zu machen.

• Textschwärzungsanmerkung: Verbergen Sie ausgewählten Text mit einem schwarzen Rechteck zur Schwärzung.

• Textaustauschanmerkung: Ersetzen Sie den ursprünglichen Text durch ein neues Fragment durch Anmerkung.

• Textdurchstreichanmerkung: Markieren Sie Text mit einem Durchstreichungszeichen, um eine Löschung anzuzeigen.

• Textunterstreichanmerkung: Unterstreichen und annotieren Sie Text zur Betonung.

• Wasserzeichenanmerkung: Fügen Sie einen Wasserzeichentext als Anmerkung über dem Dokument hinzu.

• Zickzackanmerkung: Verwenden Sie eine Zickzacklinie, um Text zu unterstreichen und Aufmerksamkeit zu erregen.

API-spezifische Funktionen

• Anmerkungen direkt hinzufügen: Fügen Sie Anmerkungen zu Dokumenten hinzu, ohne sie herunterzuladen.
• Öffentliche API-Beispiele: Greifen Sie auf Beispielcode und Dokumentation zu, um die API-Funktionen zu nutzen.

Unterstützte Cloud-Dokumentenformate für Anmerkungen

• 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
• Bilder: DJVU, JPEG, TIFF, BMP, GIF (statische Bilder ohne Animation)
• Medizinische Bildgebung: DICOM
• Markup: HTML, MHTML
• Fixed Layout: PDF
• Metadateien: EMF, WMF

Anforderungen

• Java-Version: Zum Erstellen der API-Client-Bibliothek ist Java 1.7+ erforderlich.
• Build-Tool: Maven ist erforderlich, um Abhängigkeiten zu verwalten und das Projekt zu erstellen.

Voraussetzungen

• GroupDocs Cloud-Konto: Um das GroupDocs.Annotation Cloud SDK für Java zu verwenden, müssen Sie ein Konto bei GroupDocs Cloud registrieren.
• Client-ID & Client-Geheimnis: Nach der Registrierung müssen Sie Ihre Client-ID und Ihr Client-Geheimnis im Cloud-Dashboard nachschlagen oder erstellen.
• Kostenloses Kontingent: GroupDocs Cloud bietet ein kostenloses Kontingent für neue Benutzer. Weitere Details finden Sie in den GroupDocs Cloud-Preisen.

Installieren von GroupDocs.Annotation-Cloud über Maven

Um das GroupDocs.Annotation Cloud SDK für Java zu installieren, müssen Sie das GroupDocs Cloud-Repository in die pom.xml-Datei Ihrer Anwendung hinzufügen:

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

Installation aus dem Quellcode

Um die API-Client-Bibliothek aus dem Quellcode zu installieren, befolgen Sie diese Schritte:

• Installation im lokalen Maven-Repository: Um die Bibliothek in Ihrem lokalen Maven-Repository zu installieren, führen Sie einfach den folgenden Befehl im Terminal aus:

mvn clean install

• Bereitstellung im Remote-Maven-Repository: Wenn Sie die Bibliothek in einem Remote-Maven-Repository bereitstellen möchten, konfigurieren Sie die Repository-Einstellungen und führen Sie den folgenden Befehl aus:

mvn clean deploy

Weitere Details zur Bereitstellung in einem Remote-Repository finden Sie im OSSRH-Leitfaden.

Maven-Benutzer

Wenn Sie ein Maven-Benutzer sind, können Sie das GroupDocs.Annotation Cloud SDK für Java als Abhängigkeit in die pom.xml-Datei Ihres Projekts hinzufügen:

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

Erste Schritte

Um mit dem GroupDocs.Annotation Cloud SDK für Java zu beginnen, befolgen Sie diese Schritte:

1. SDK installieren: Installieren Sie das SDK, indem Sie die oben beschriebenen Schritte befolgen (Verwendung von Maven oder Installation aus dem Quellcode).
2. Konfiguration: Richten Sie die Konfiguration mit Ihrer Client-ID und Ihrem Client-Geheimnis ein, die Sie im GroupDocs Cloud-Dashboard erhalten haben.
3. Beispielcode: Implementieren Sie Beispielcode in Ihrer Anwendung, um Anmerkungen hinzuzufügen, Dokumentinformationen zu extrahieren oder Dateien und Ordner zu verwalten.
4. Dokumentation: Lesen Sie die Schnellstartanweisungen und die API-Dokumentation für detaillierte Anwendungsbeispiele und zusätzliche Informationen.

Autorisierung & Authentifizierung

GroupDocs.Annotation Cloud SDK für Java verwendet OAuth 2.0 für Autorisierung und Authentifizierung. Die folgenden Details werden bereitgestellt:

• Autorisierungstyp: OAuth 2.0
• Fluss: Anwendungsbasierte Autorisierung
• Autorisierungs-URL: https://api.groupdocs.cloud/connect/token
• Token-Lebensdauer: 1 Tag (standardmäßig)

JWT

GroupDocs.Annotation Cloud SDK verwendet JSON Web Tokens (JWT) für den sicheren API-Zugriff:

• Token-Typ: OAuth 2.0 JWT (JSON Web Token)
• Autorisierungs-URL: Tokens werden unter Verwendung des Endpunkts https://api.groupdocs.cloud/connect/token generiert.
• Token-Ablauf: Die Standardtoken-Lebensdauer beträgt 1 Tag, um einen sicheren, zeitgebundenen Zugriff auf die API zu gewährleisten.

Diese Details bieten eine umfassende Anleitung zur Einrichtung und Nutzung des GroupDocs.Annotation Cloud SDK für Java und decken die wesentlichen Anforderungen, Installationsschritte und Sicherheitskonfigurationen ab.

Hier sind zwei der attraktivsten Code-Snippets aus dem bereitgestellten Inhalt. Diese Snippets zeigen wesentliche Funktionen, die potenzielle Benutzer ansprechen würden, die Annotationsfunktionen in ihre Anwendungen integrieren möchten.

Beispielcode in der Cloud-Java zur Hinzufügung einer Punktanmerkung

Dieses Snippet zeigt, wie Sie eine Punktanmerkung zu einem Dokument mit dem GroupDocs.Annotation Cloud SDK für Java hinzufügen können. Punktanmerkungen sind nützlich, um bestimmte Punkte in einem Dokument mit Kommentaren oder Notizen zu markieren.

// Für vollständige Beispiele und Datendateien gehen Sie bitte zu https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples
String MyAppKey = ""; // Holen Sie sich AppKey und AppSID von https://dashboard.groupdocs.cloud
String MyAppSid = ""; // Holen Sie sich AppKey und AppSID von https://dashboard.groupdocs.cloud

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

 = new AnnotateApi(configuration);

// Erstellen von Anmerkungen.
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("Dies ist eine Punktanmerkung");
annotations[0].setCreatorName("Anonym A.");

// Erstellen Sie das Anforderungsobjekt.
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);

// Ausführen der API-Methode.
AnnotationApiLink result = apiInstance.annotate(request);
System.out.println("AddPointAnnotation: Punktanmerkung hinzugefügt: " + result.getTitle());

Beispielcode in der Cloud-Java zur Hinzufügung einer Texthervorhebungsanmerkung

Dieses Code-Snippet zeigt, wie Sie eine Texthervorhebungsanmerkung zu einem Dokument hinzufügen können. Das Hervorheben von Text ist eine gängige Annotationsaufgabe, insbesondere in Überprüfungsprozessen, und dieses Snippet zeigt, wie es programmgesteuert durchgeführt werden kann.

// Für vollständige Beispiele und Datendateien gehen Sie bitte zu https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples
String MyAppKey = ""; // Holen Sie sich AppKey und AppSID von https://dashboard.groupdocs.cloud
String MyAppSid = ""; // Holen Sie sich AppKey und AppSID von https://dashboard.groupdocs.cloud

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

// Erstellen von Anmerkungen.
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("Dieser Text ist hervorgehoben");
annotations[0].setCreatorName("Anonym A.");

// Erstellen Sie das Anforderungsobjekt.
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);

// Ausführen der API-Methode.
AnnotationApiLink result = apiInstance.annotate(request);
System.out.println("AddTextHighlightAnnotation: Texthervorhebungsanmerkung hinzugefügt: " + result.getTitle());

This translation should cover the content of the markdown file you provided. If you need further assistance or specific sections translated differently, please let me know!