Εγκατάσταση

Το πακέτο είναι available στο pypi.org και μπορεί να εγκατασταθεί μέσω pip εκτελώντας την παρακάτω εντολή:

pip install groupdocs-annotation-cloud

Σχολιασμός εγγράφων cloud Python SDK

Το GroupDocs.Annotation Cloud API προσφέρει μια ολοκληρωμένη Python SDK για απρόσκοπτη σχολιασμό εγγράφων. Ενσωματώστε εύκολα λειτουργίες όπως η προσθήκη σχολίων, επισημάνσεων, υδατογραφημάτων και διορθώσεων σε διάφορες μορφές εγγράφων, συμπεριλαμβανομένων των PDF, Word, Excel και PowerPoint, στις εφαρμογές Python σας.

Σχολιασμοί εγγράφων

Σχολιασμοί κειμένου - Προσθέστε σχόλια ή επεξηγήσεις εντός του κειμένου.
Σχολιασμοί περιοχής - Επισημάνετε συγκεκριμένες περιοχές ενός εγγράφου για λεπτομερείς σημειώσεις.
Σχολιασμοί σημείων - Επισημάνετε συγκεκριμένα σημεία ενδιαφέροντος σε ένα έγγραφο.
Σχολιασμοί βέλους - Κατευθύνετε την προσοχή των θεατών σε συγκεκριμένα στοιχεία με δείκτες βέλους.
Διαγραφή/Υπογράμμιση Σχολιασμών - Επισημάνετε το κείμενο σημειώνοντας ή υπογραμμίζοντας για εύκολη αναφορά.

Χαρακτηριστικά σήμανσης

Επισήμανση - Επισημάνετε σημαντικές ενότητες του κειμένου με επισημάνσεις.
Διαμόρφωση - Πλήρης απόκρυψη ή λογοκρισία ευαίσθητου περιεχομένου εντός εγγράφων.
Υδατοσήμανση - Προστατέψτε τα έγγραφα προσθέτοντας υδατογραφήματα για να δηλώσετε την ιδιοκτησία.

Διαχείριση σχολιασμών

Επεξεργασία σχολιασμών - Τροποποίηση ή ενημέρωση υπαρχόντων σχολιασμών σε έγγραφα.
Διαγραφή σχολιασμών - Αφαιρέστε περιττούς ή παλιούς σχολιασμούς.
Εξαγωγή σχολιασμών - Εξαγωγή σχολιασμών για αποθήκευση ξεχωριστά ή κοινή χρήση με άλλους.

Χαρακτηριστικά συνεργασίας

Σχολιασμός - Ενεργοποιήστε τη συνεργασία πολλών χρηστών με λειτουργίες σχολιασμού που βασίζονται σε νήματα.
Έλεγχος έκδοσης - Παρακολουθήστε τις αλλαγές που έγιναν στους σχολιασμούς με τα εργαλεία έκδοσης εκδόσεων.
Ενημερώσεις σε πραγματικό χρόνο - Εφαρμόστε ενημερώσεις όταν πολλοί χρήστες επεξεργάζονται το ίδιο έγγραφο.

Λειτουργίες ασφαλείας

Έλεγχος πρόσβασης - Ασφαλίστε τους σχολιασμούς εγγράφων με έλεγχο πρόσβασης βάσει χρήστη.
Δικαιώματα βάσει ρόλων - Εκχωρήστε διαφορετικά επίπεδα άδειας στους χρήστες για την προστασία των ευαίσθητων σχολιασμών.
Κρυπτογράφηση - Βεβαιωθείτε ότι τα δεδομένα είναι κρυπτογραφημένα κατά τη μεταφορά και αποθήκευση εγγράφων.

Προηγμένες δυνατότητες

Συνδυασμός σχολιασμών - Συγχώνευση πολλαπλών σχολιασμών σε ένα έγγραφο.
Σχολιασμοί σε επίπεδα - Χειριστείτε σχολιασμούς σε επίπεδα για ευέλικτη επεξεργασία και σήμανση.
Προσαρμοσμένα στυλ σχολιασμού - Ορίστε προσαρμοσμένα χρώματα, αδιαφάνεια και μέγεθος για τους σχολιασμούς.
** Ενσωμάτωση API** - Ενσωμάτωση με άλλα συστήματα χρησιμοποιώντας REST API.
Κλιμακόμενη υποδομή - Υποστηρίζει περιβάλλοντα υψηλού φορτίου με κλιμακούμενη αρχιτεκτονική.

Υποστηριζόμενοι τύποι και δυνατότητες σχολιασμού

Σχολιασμός περιοχής

• Σημειώστε μια περιοχή στη σελίδα του εγγράφου με ένα ορθογώνιο.
  • Επιτρέπει στους χρήστες να επισημάνουν μια συγκεκριμένη περιοχή σε ένα έγγραφο.
  • Οι διαστάσεις του κουτιού μπορούν να προσαρμοστούν ώστε να ταιριάζουν στην περιοχή ενδιαφέροντος.
  • Υποστηρίζει απαντήσεις σε σχολιασμούς για συλλογικές κριτικές.
  • Ο σχολιασμός περιοχής μπορεί να περιλαμβάνει πρόσθετα σχόλια.

Σχολιασμός απόστασης

• Μετρά την απόσταση μεταξύ των αντικειμένων σε ένα έγγραφο.
  • Επιτρέπει ακριβείς μετρήσεις εντός του περιεχομένου του εγγράφου.
  • Οι συντεταγμένες και οι διαστάσεις μπορούν να καθοριστούν για ακριβείς μετρήσεις.
  • Χρήσιμο για αρχιτεκτονικά και μηχανολογικά έγγραφα όπου τα μέτρα απόστασης είναι κρίσιμα.

Σχολιασμός Ellipse

• Σχεδιάζει ελλειπτικούς σχολιασμούς σε μια σελίδα εγγράφου.
  • Επιτρέπει στους χρήστες να επισημάνουν κυκλικές ή ελλειπτικές περιοχές.
  • Προσαρμόσιμη ακτίνα, χρώμα και αδιαφάνεια για καθαρή ορατότητα.
  • Υποστηρίζει πολλαπλές απαντήσεις για πρόσθετα σχόλια στην επισημασμένη περιοχή.

Σχολιασμός εικόνας

• Προσθέτει μια εικόνα σε μια συγκεκριμένη περιοχή του εγγράφου.
  • Εισάγει εικόνες σε μια σελίδα εγγράφου για οπτική αναφορά.
  • Υποστηρίζει τοποθέτηση και αλλαγή μεγέθους εικόνων.
  • Χρήσιμο για την προσθήκη λογότυπων, γραμματοσήμων ή οπτικών σημάτων.

Σχολιασμός συνδέσμου

• Προσθέτει μια υπερσύνδεση σε ένα έγγραφο.
  • Συνδέει συγκεκριμένο κείμενο ή περιοχές του εγγράφου με εξωτερικές διευθύνσεις URL.
  • Παρέχει υποστήριξη για πλοήγηση στο διαδίκτυο ή αναφορά σε πρόσθετους πόρους.
  • Μπορεί να διαμορφωθεί με διαφορετικά χρώματα για να διαφοροποιηθεί από το κείμενο.

Πολλαπλοί σχολιασμοί

• Επιτρέπει την ταυτόχρονη προσθήκη πολλών τύπων σχολιασμών.
  • Υποστηρίζει την προσθήκη συνδυασμού σχολιασμών (π.χ. κειμένου, εικόνων, σχημάτων) ταυτόχρονα.
  • Χρήσιμο για την αναθεώρηση εγγράφων όπου χρειάζονται διαφορετικοί τύποι σχολιασμού στην ίδια σελίδα.
  • Πολλοί σχολιασμοί μπορούν να ομαδοποιηθούν ή να αντιμετωπιστούν χωριστά.

Σημείο σχολιασμού

• Κολλάει τα σχόλια σε ένα συγκεκριμένο σημείο του εγγράφου.
  • Τα σχόλια σχετίζονται με ένα συγκεκριμένο σημείο ή τοποθεσία μέσα στο έγγραφο.
  • Ιδανικό για συλλογικές αναθεωρήσεις εγγράφων όπου είναι απαραίτητο να εντοπιστούν σχόλια.
  • Υποστηρίζει ρυθμίσεις χρώματος και μεγέθους για καλύτερη ορατότητα.

Σχολιασμός Polyline

• Σχεδιάζει συνδεδεμένες γραμμές για να σχηματίσει μια πολύγραμμη σε ένα έγγραφο.
  • Χρησιμοποιείται για τη σχεδίαση πολύπλοκων σχημάτων ή τη σήμανση συγκεκριμένων διαδρομών σε ένα έγγραφο.
  • Υποστηρίζει πολλαπλά σημεία που συνδέονται με ευθείες γραμμές.
  • Επιτρέπει την προσαρμογή του πάχους, του χρώματος και της αδιαφάνειας γραμμής.

Σχολιασμός διόρθωσης πόρων

• Γεμίζει ένα μαύρο ορθογώνιο σε σταθερή θέση για απόκρυψη ευαίσθητων πληροφοριών.
  • Διαγράφει αποτελεσματικά εμπιστευτικές πληροφορίες από έγγραφα.
  • Το μαύρο κουτί μπορεί να έχει μέγεθος και να τοποθετηθεί πάνω από οποιαδήποτε ευαίσθητα δεδομένα.
  • Χρησιμοποιείται συνήθως για νομικά έγγραφα, οικονομικές καταστάσεις ή προσωπικούς αριθμούς αναγνώρισης (PIN).

Squiggly Annotation

• Προσθέτει μια κυματιστή υπογράμμιση για τη σήμανση κειμένου.
  • Τονίζει το κείμενο με μια τσιριχτή υπογράμμιση για προσοχή.
  • Ιδανικό για επισήμανση ορθογραφικών ή γραμματικών λαθών.
  • Το χρώμα και το στυλ γραμμής μπορούν να προσαρμοστούν για να διαφοροποιούνται από άλλους σχολιασμούς.

Υποστηριζόμενες μορφές σχολιασμού

| Μορφή αρχείου | Περιγραφή | Σχολιασμός | |——————————————————————————————————| |DOC, DOCX| Word® Έγγραφο | ✔️ | |OTT| Άνοιγμα τυπικής μορφής εγγράφου | ✔️ | |ODT| Ανοίξτε Μορφή αρχείου κειμένου εγγράφου | ✔️ | |DOCM| Microsoft Word® Ανοίξτε το έγγραφο με δυνατότητα μακροεντολής XML | ✔️ | |DOT| Word® Αρχείο προτύπου εγγράφου | ✔️ | |DOTX| Word® Ανοίξτε το πρότυπο εγγράφου XML | ✔️ | |DOTM| Word® Ανοίξτε το αρχείο προτύπου με δυνατότητα XML | ✔️ | |RTF| Μορφή αρχείου εμπλουτισμένου κειμένου | ✔️ | |TXT| Μορφή αρχείου απλού κειμένου | ✔️ | |PDF| Μορφή φορητού εγγράφου | ✔️ | |PPT, PPTX| Μορφή εγγράφου παρουσίασης | ✔️ | |PPSX| PowerPoint Άνοιγμα παρουσίασης XML | ✔️ | |ODP| Μορφή αρχείου παρουσίασης OpenDocument | ✔️ | |OTP| Πρότυπο παρουσίασης OpenDocument | ✔️ | |XLS, XLSX| Μορφή εγγράφου κελιών | ✔️ | |XLSB| Microsoft Excel® Δυαδικό αρχείο υπολογιστικών φύλλων | ✔️ | |XLSX| Microsoft Excel® Άνοιγμα υπολογιστικού φύλλου XML | ✔️ | |DICOM| Ψηφιακή Απεικόνιση και Επικοινωνία στην Ιατρική | ✔️ | |DJVU| Μορφή DjVu | ✔️ | |EMF/WMF| Βελτιωμένο MetaFile / Windows MetaFile | ✔️ | |CAD| Σχεδιασμός με τη βοήθεια υπολογιστή | ✔️ | |EML/EMLX| Γλώσσα σήμανσης email | ✔️ | |HTML| Γλώσσα σήμανσης υπερκειμένου | ✔️ | |MHTML| Αρχείο HTML MIME | ✔️ | |JPEG| Joint Photographic Experts Group | ✔️ | |TIFF| Με ετικέτα Μορφή αρχείου εικόνας | ✔️ | |BMP| Bitmap | ✔️ | |GIF(στατικές εικόνες χωρίς κινούμενα σχέδια) | Μορφή ανταλλαγής γραφικών | ✔️ | |VSD| Microsoft Visio® Σχέδιο | ✔️ | |VDX| Microsoft Visio® Μορφή αρχείου XML | ✔️ | |VSS| Microsoft Visio® Μορφή αρχείου στένσιλ | ✔️ | |VSDM| Microsoft Visio® Αρχείο σχεδίασης με δυνατότητα μακροεντολής | ✔️ | |MSG| Μήνυμα Email | ✔️ |

Ξεκινώντας GroupDocs.Annotation Cloud Python SDK

Απαιτήσεις

Python 2.7 ή 3.4+

Εγκατάσταση

Εγκαθιστώ groupdocs-annotation-cloud με PIP από PyPI by:

pip install groupdocs-annotation-cloud

Ή κλώνος repository και εγκαταστήστε το μέσω Setuptools:

python setup.py install

Ακολουθήστε τη διαδικασία εγκατάστασης και μετά εκτελέστε τα εξής:

# Import module
import groupdocs_annotation_cloud

# Get your app_sid and app_key at https://dashboard.groupdocs.cloud (free registration is required).
app_sid = "XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX"
app_key = "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX"

# Create instance of the API
api = groupdocs_annotation_cloud.InfoApi.from_keys(app_sid, app_key)

try:
    # Retrieve supported file-formats
    response = api.get_supported_file_formats()

    # Print out supported file-formats
    print("Supported file-formats:")
    for format in response.formats:
        print('{0} ({1})'.format(format.file_format, format.extension))
except groupdocs_annotation_cloud.ApiException as e:
    print("Exception when calling get_supported_file_formats: {0}".format(e.message))

GroupDocs.Annotation Μοντέλα δεδομένων API Cloud

FilesUploadResult, Error, ErrorDetails, FilesList, StorageFile, StorageExist, ObjectExist, DiscUsage, FileVersions, FileVersion, AnnotationInfo, Rectangle, Point, AnnotationReplyInfo, FileInfo, AnnotationApiLink, Link, RemoveOptions, AnnotateOptions, FormatsResult, Format, DocumentInfo, PageInfo, ConsumptionResult, PageImages, PageImage, LinkElement, PreviewOptions

Δείγμα κώδικα Python 1: Προσθήκη σχολιασμού κειμένου

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

# For complete examples and data files, please go to https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-python-samples
import groupdocs_annotation_cloud
 
app_sid = "XXXX-XXXX-XXXX-XXXX" # Get AppKey and AppSID from https://dashboard.groupdocs.cloud
app_key = "XXXXXXXXXXXXXXXX" # Get AppKey and AppSID from https://dashboard.groupdocs.cloud
  
api = groupdocs_annotation_cloud.AnnotateApi.from_keys(app_sid, app_key)
 
a1 = groupdocs_annotation_cloud.AnnotationInfo()
a1.annotation_position = groupdocs_annotation_cloud.Point()
a1.annotation_position.x = 1
a1.annotation_position.y = 1
a1.box = groupdocs_annotation_cloud.Rectangle()
a1.box.x = 100
a1.box.y = 100
a1.box.width = 200
a1.box.height = 100
a1.page_number = 0
a1.font_color = 1201033
a1.font_size = 12
a1.opacity = 0.7
a1.type = "TextField"           
a1.text = "Text field text"
a1.creator_name = "Anonym A."
 
file_info = FileInfo()
file_info.file_path = "annotationdocs\\one-page.docx"
options = AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "Output\\output.docx"
 
request = AnnotateRequest(options)
result = api.annotate(request)         
 
print("AddTextFieldAnnotation: Text Field Annotation added: " + result['href'])

Δείγμα κώδικα Python 2: Προσθήκη σχολιασμού περιοχής

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

# For complete examples and data files, please go to https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-python-samples
import groupdocs_annotation_cloud
 
app_sid = "XXXX-XXXX-XXXX-XXXX" # Get AppKey and AppSID from https://dashboard.groupdocs.cloud
app_key = "XXXXXXXXXXXXXXXX" # Get AppKey and AppSID from https://dashboard.groupdocs.cloud
  
api = groupdocs_annotation_cloud.AnnotateApi.from_keys(app_sid, app_key)
 
a1 = groupdocs_annotation_cloud.AnnotationInfo()
a1.annotation_position = groupdocs_annotation_cloud.Point()
a1.annotation_position.x = 1
a1.annotation_position.y = 1
a1.box = groupdocs_annotation_cloud.Rectangle()
a1.box.x = 100
a1.box.y = 100
a1.box.width = 200
a1.box.height = 100
a1.page_number = 0
a1.pen_color = 1201033
a1.pen_style = "Solid"
a1.pen_width = 1
a1.opacity = 0.7
a1.type = "Area"
a1.text = "This is area annotation"
a1.creator_name = "Anonym A."
 
file_info = FileInfo()
file_info.file_path = "annotationdocs\\one-page.docx"
options = AnnotateOptions()
options.file_info = file_info
options.annotations = [a1]
options.output_path = "Output\\output.docx"
 
request = AnnotateRequest(options)
result = api.annotate(request)         
 
print("AddAreaAnnotation: Area Annotation added: " + result['href'])

Δείγμα κώδικα Python 3: Κατάργηση σχολιασμού

Αυτό το δείγμα κώδικα δείχνει πώς να αφαιρέσετε έναν σχολιασμό από ένα έγγραφο.

# For complete examples and data files, please go to https://github.com/groupdocs-annotation-cloud/groupdocs-annotation-cloud-python-samples
import groupdocs_annotation_cloud
 
app_sid = "XXXX-XXXX-XXXX-XXXX" # Get AppKey and AppSID from https://dashboard.groupdocs.cloud
app_key = "XXXXXXXXXXXXXXXX" # Get AppKey and AppSID from https://dashboard.groupdocs.cloud
  
api = groupdocs_annotation_cloud.AnnotateApi.from_keys(app_sid, app_key)
 
file_info = FileInfo()
file_info.file_path = "annotationdocs\\input.docx"
options = RemoveOptions()
options.file_info = file_info
options.annotation_ids = [1, 2, 3]
options.output_path = "Output\\output.docx"
 
request = RemoveAnnotationsRequest(options)
result = api.remove_annotations(request)
 
print("RemoveAnnotations: Annotations removed: " + result['href'])