Java Cloud REST API Σχόλια Εγγράφων

Το GroupDocs.Annotation Cloud SDK για Java σας βοηθά να αναπτύξετε εφαρμογές σχολιασμού εγγράφων Java στο cloud που λειτουργούν χωρίς να εγκαταστήσετε λογισμικό τρίτων. Είναι ένα περιτύλιγμα γύρω από τα REST APIs GroupDocs.Annotation Cloud.

Χαρακτηριστικά Σχολιασμού Εγγράφων

• Προσθήκη μονών ή πολλαπλών σχολίων σε έγγραφα στο cloud.
• Προσθήκη σχολίων απευθείας σε έγγραφα αποθηκευμένα στο cloud.
• Υποστήριξη για διάφορους τύπους σχολίων, συμπεριλαμβανομένων κειμένου, εικόνων και σχημάτων.
• Προσαρμογή ιδιοτήτων σχολίων όπως το χρώμα, το μέγεθος και η θέση.
• Σχολιασμός πολλαπλών μορφών εγγράφων όπως PDF, Word, Excel, PowerPoint και εικόνες.

Χαρακτηριστικά Διαχείρισης Εγγράφων

• Απόδοση Εγγράφων: Μετατροπή εγγράφων σε μορφές όπως PDF, εικόνες ή HTML για προβολή ή εκτύπωση.
• Προεπισκόπηση Εγγράφων: Δημιουργία αναπαραστάσεων εικόνων των σελίδων εγγράφων για προεπισκόπηση.
• Αφαίρεση Σχολίων: Διαγραφή συγκεκριμένων σχολίων ή αφαίρεση όλων των σχολίων από ένα έγγραφο.
• Εξαγωγή Σχολίων: Ανάκτηση όλων των σχολίων από ένα έγγραφο ως λίστα αντικειμένων JSON.

Διαχείριση Αρχείων & Αποθήκευσης

• Εργασία με το API Αρχείων: Ανέβασμα, κατέβασμα, αντιγραφή, μετακίνηση και διαγραφή αρχείων σε αποθήκευση στο cloud.
• Εργασία με το API Φακέλων: Οργάνωση και διαχείριση φακέλων σε αποθήκευση στο cloud (δημιουργία, μετακίνηση, διαγραφή).
• Εργασία με το API Αποθήκευσης: Πρόσβαση και διαχείριση πόρων αποθήκευσης στο cloud, συμπεριλαμβανομένης της ανάκτησης λεπτομερειών αποθήκευσης και πληροφοριών αρχείων.
• Λήψη Υποστηριζόμενων Μορφών Αρχείων: Ανάκτηση λίστας υποστηριζόμενων μορφών αρχείων για σχόλια.
• Πληροφορίες Αρχείων: Απόκτηση λεπτομερών πληροφοριών για αρχεία στο cloud, όπως το μέγεθος, η μορφή και τα μεταδεδομένα.

Πληροφορίες & Επεξεργασία Εγγράφων

• Λήψη Πληροφοριών Εγγράφου: Ανάκτηση λεπτομερών πληροφοριών εγγράφου, συμπεριλαμβανομένων των μεταδεδομένων, του περιεχομένου κειμένου και των σχολίων.
• Λήψη Σελίδων: Πρόσβαση στη λίστα των σελίδων ενός εγγράφου μαζί με λεπτομέρειες όπως το μέγεθος και ο προσανατολισμός.
• Πληροφορίες Σχολίων: Πρόσβαση σε λεπτομερείς πληροφορίες για τα σχόλια, συμπεριλαμβανομένου του τύπου, της θέσης και του περιεχομένου.
• Επιλογές Σχολίων: Διαμόρφωση διάφορων επιλογών σχολίων, συμπεριλαμβανομένης της επιλογής σελίδων, της θέσης και της μορφοποίησης.
• Προχωρημένη Χρήση: Χρήση προχωρημένων χαρακτηριστικών για τη διαχείριση σχολίων, όπως ομαδοποίηση και διάταξη.

Υποστηριζόμενοι Τύποι Σχολίων

• Σχόλια Περιοχής: Επισημάνετε και σχολιάστε μια συγκεκριμένη ορθογώνια περιοχή μέσα σε ένα έγγραφο στο cloud.
• Σχόλια Βέλους: Σχεδιάστε ένα βέλος για να επισημάνετε συγκεκριμένο περιεχόμενο στη σελίδα του εγγράφου στο cloud.
• Σχόλια Απόστασης: Μετρήστε και σχολιάστε την απόσταση μεταξύ δύο αντικειμένων ή σημείων σε ένα έγγραφο στο cloud.
• Σχόλια Ελλειψοειδούς: Χρησιμοποιήστε ένα ελλειψοειδές σχήμα για να επισημάνετε και να σχολιάσετε συγκεκριμένο περιεχόμενο σε ένα έγγραφο.
• Σχόλια Εικόνας: Επικάλυψη μιας εικόνας ως σχόλιο πάνω από το περιεχόμενο του εγγράφου.
• Σχόλια Συνδέσμου: Προσθήκη ενός σχολίου υπερσύνδεσης που συνδέεται με έναν εξωτερικό πόρο.
• Σχόλια Σημείου: Τοποθετήστε μια σημείωση σε ένα συγκεκριμένο σημείο μέσα στο έγγραφο για λεπτομερή σχολιασμό.
• Σχόλια Πολυγραμμής: Σχεδιάστε ελεύθερες γραμμές ή σχήματα για να σχολιάσετε και να επισημάνετε περιεχόμενο.
• Σχόλια Αποκοπής Πόρων: Αποκρύψτε ευαίσθητο κείμενο καλύπτοντάς το με ένα μαύρο ορθογώνιο.
• Σχόλια Πεδίου Κειμένου: Προσθήκη ενός σχολίου κειμένου μέσα σε ένα χρωματιστό πλαίσιο ως σχόλιο.
• Σχόλια Επισημάνσεως Κειμένου: Επισημάνετε κείμενο και προσθέστε σχόλια για να τραβήξετε την προσοχή σε συγκεκριμένο περιεχόμενο.
• Σχόλια Αποκοπής Κειμένου: Κρύψτε επιλεγμένο κείμενο με ένα μαύρο ορθογώνιο για αποκοπή.
• Σχόλια Αντικατάστασης Κειμένου: Αντικαταστήστε το αρχικό κείμενο με ένα νέο κομμάτι μέσω σχολίων.
• Σχόλια Διαγραφής Κειμένου: Επισημάνετε το κείμενο με μια διαγράμμιση για να υποδείξετε διαγραφή.
• Σχόλια Υπογράμμισης Κειμένου: Υπογραμμίστε και σχολιάστε κείμενο για έμφαση.
• Σχόλια Υδατογραφήματος: Προσθήκη ενός σχολίου υδατογραφήματος πάνω από το έγγραφο.
• Σχόλια Κυματιστής Γραμμής: Χρησιμοποιήστε μια κυματιστή γραμμή για να υπογραμμίσετε και να τραβήξετε την προσοχή στο κείμενο.

Ειδικά Χαρακτηριστικά API

• Προσθήκη Σχολίων Απευθείας: Προσθήκη σχολίων σε έγγραφα χωρίς να τα κατεβάσετε.
• Δημόσια Παραδείγματα API: Πρόσβαση σε δείγματα κώδικα και τεκμηρίωση για τη χρήση των χαρακτηριστικών του API.

Υποστηριζόμενες Μορφές Εγγράφων για Σχολιασμό στο Cloud

• 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
• Εικόνες: DJVU, JPEG, TIFF, BMP, GIF (στατικές εικόνες χωρίς κινούμενα σχέδια)
• Ιατρική Απεικόνιση: DICOM
• Σήμανση: HTML, MHTML
• Σταθερή Διάταξη: PDF
• Μεταδεδομένα: EMF, WMF

Απαιτήσεις

• Έκδοση Java: Η κατασκευή της βιβλιοθήκης του πελάτη API απαιτεί Java 1.7+.
• Εργαλείο Κατασκευής: Το Maven είναι απαραίτητο για τη διαχείριση των εξαρτήσεων και την κατασκευή του έργου.

Προαπαιτούμενα

• Λογαριασμός GroupDocs Cloud: Για να χρησιμοποιήσετε το GroupDocs.Annotation Cloud SDK για Java, πρέπει να εγγραφείτε για έναν λογαριασμό στο GroupDocs Cloud.
• Client ID & Client Secret: Μετά την εγγραφή, πρέπει να αναζητήσετε ή να δημιουργήσετε το Client ID και το Client Secret στον Πίνακα Ελέγχου Cloud.
• **Δωρεάν Κου

ότα:** Το GroupDocs Cloud προσφέρει δωρεάν κουότα για νέους χρήστες. Για περισσότερες λεπτομέρειες, θα πρέπει να ελέγξετε την Τιμολόγηση του GroupDocs Cloud.

Εγκατάσταση του GroupDocs.Annotation-Cloud από το Maven

Για να εγκαταστήσετε το GroupDocs.Annotation Cloud SDK για Java, πρέπει να προσθέσετε το αποθετήριο GroupDocs Cloud στο αρχείο pom.xml της εφαρμογής σας:

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

Εγκατάσταση από τον Πηγαίο Κώδικα

Για να εγκαταστήσετε τη βιβλιοθήκη πελάτη API από τον πηγαίο κώδικα, ακολουθήστε αυτά τα βήματα:

• Εγκατάσταση στο Τοπικό Αποθετήριο Maven: Για να εγκαταστήσετε τη βιβλιοθήκη στο τοπικό σας αποθετήριο Maven, απλώς εκτελέστε την παρακάτω εντολή στο τερματικό:

mvn clean install

• Ανάπτυξη στο Απομακρυσμένο Αποθετήριο Maven: Εάν θέλετε να αναπτύξετε τη βιβλιοθήκη σε ένα απομακρυσμένο αποθετήριο Maven, διαμορφώστε τις ρυθμίσεις αποθετηρίου και εκτελέστε την παρακάτω εντολή:

mvn clean deploy

Για περισσότερες λεπτομέρειες σχετικά με την ανάπτυξη σε ένα απομακρυσμένο αποθετήριο, ανατρέξτε στον Οδηγό OSSRH.

Χρήστες Maven

Εάν είστε χρήστης του Maven, μπορείτε να προσθέσετε το GroupDocs.Annotation Cloud SDK για Java ως εξάρτηση στο αρχείο pom.xml του έργου σας:

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

Ξεκινήστε

Για να ξεκινήσετε με το GroupDocs.Annotation Cloud SDK για Java, ακολουθήστε αυτά τα βήματα:

1. Εγκατάσταση SDK: Εγκαταστήστε το SDK ακολουθώντας τα βήματα που περιγράφονται παραπάνω (χρησιμοποιώντας το Maven ή εγκατάσταση από τον πηγαίο κώδικα).
2. Διαμόρφωση: Ρυθμίστε τη διαμόρφωση χρησιμοποιώντας το Client ID και το Client Secret που αποκτήσατε από τον Πίνακα Ελέγχου GroupDocs Cloud.
3. Δείγματα Κώδικα: Εφαρμόστε δείγματα κώδικα στην εφαρμογή σας για την προσθήκη σχολίων, την εξαγωγή πληροφοριών εγγράφων ή τη διαχείριση αρχείων και φακέλων.
4. Τεκμηρίωση: Ανατρέξτε στις οδηγίες Γρήγορης Εκκίνησης και την τεκμηρίωση API για λεπτομερή παραδείγματα χρήσης και πρόσθετες πληροφορίες.

Εξουσιοδότηση & Αυθεντικοποίηση

Το GroupDocs.Annotation Cloud SDK για Java χρησιμοποιεί το OAuth 2.0 για την εξουσιοδότηση και την αυθεντικοποίηση. Οι παρακάτω λεπτομέρειες παρέχονται:

• Τύπος Εξουσιοδότησης: OAuth 2.0
• Ροή: Εξουσιοδότηση βάσει εφαρμογής
• Διεύθυνση URL Εξουσιοδότησης: https://api.groupdocs.cloud/connect/token
• Διάρκεια Ζωής Διακριτικού: 1 ημέρα (από προεπιλογή)

JWT

Το GroupDocs.Annotation Cloud SDK χρησιμοποιεί JSON Web Tokens (JWT) για ασφαλή πρόσβαση στο API:

• Τύπος Διακριτικού: OAuth 2.0 JWT (JSON Web Token)
• Διεύθυνση URL Εξουσιοδότησης: Τα διακριτικά παράγονται χρησιμοποιώντας το endpoint https://api.groupdocs.cloud/connect/token.
• Διάρκεια Λήξης Διακριτικού: Η προεπιλεγμένη διάρκεια ζωής του διακριτικού είναι 1 ημέρα, εξασφαλίζοντας ασφαλή, χρονικά περιορισμένη πρόσβαση στο API.

Αυτές οι λεπτομέρειες παρέχουν έναν ολοκληρωμένο οδηγό για την εγκατάσταση και τη χρήση του GroupDocs.Annotation Cloud SDK για Java, καλύπτοντας τις βασικές απαιτήσεις, τα βήματα εγκατάστασης και τις ρυθμίσεις ασφαλείας.

Δείγματα Κώδικα

Δείγμα Κώδικα Cloud Java για Προσθήκη Σχολίου Σημείου

Αυτό το δείγμα δείχνει πώς να προσθέσετε ένα σχόλιο σημείου σε ένα έγγραφο χρησιμοποιώντας το GroupDocs.Annotation Cloud SDK για Java. Τα σχόλια σημείου είναι χρήσιμα για την επισήμανση συγκεκριμένων σημείων σε ένα έγγραφο με σχόλια ή σημειώσεις.

// Για πλήρη παραδείγματα και αρχεία δεδομένων, επισκεφθείτε το https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples
String MyAppKey = ""; // Αποκτήστε το AppKey και το AppSID από το https://dashboard.groupdocs.cloud
String MyAppSid = ""; // Αποκτήστε το AppKey και το AppSID από το https://dashboard.groupdocs.cloud

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

// Δημιουργία σχολίου/σχολίων.
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("Αυτό είναι ένα σχόλιο σημείου");
annotations[0].setCreatorName("Anonym A.");

// Δημιουργία αντικειμένου αιτήματος.
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);

// Εκτέλεση της μεθόδου api.
AnnotationApiLink result = apiInstance.annotate(request);
System.out.println("AddPointAnnotation: Σχόλιο σημείου προστέθηκε: " + result.getTitle());

Δείγμα Κώδικα Cloud Java για Προσθήκη Σχολίου Επισημάνσεως Κειμένου

Αυτό το δείγμα δείχνει πώς να προσθέσετε ένα σχόλιο επισημάνσεως κειμένου σε ένα έγγραφο. Η επισήμανση κειμένου είναι μια κοινή εργασία σχολιασμού, ειδικά στις διαδικασίες αναθεώρησης, και αυτό το δείγμα δείχνει πώς μπορεί να γίνει προγραμματιστικά.

// Για πλήρη παραδείγματα και αρχεία δεδομένων, επισκεφθείτε το https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-java-samples
String MyAppKey = ""; // Αποκτήστε το AppKey και το AppSID από το https://dashboard.groupdocs.cloud
String MyAppSid = ""; // Αποκτήστε το AppKey και το AppSID από το https://dashboard.groupdocs.cloud

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

// Δημιουργία σχολίου/σχολίων.
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("Αυτό το κείμενο είναι επισημασμένο");
annotations[0].setCreatorName("Anonym A.");

// Δημιουργία αντικειμένου αιτήματος.
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);

// Εκτέλεση της μεθόδου api.
AnnotationApiLink result = apiInstance.annotate(request);
System.out.println("AddTextHighlightAnnotation: Σχόλιο επισημάνσεως κειμένου προστέθηκε: " + result.getTitle());