Pemasangan

Paketnya adalah tersedia di pypi.org dan dapat diinstal melalui pip dengan menjalankan perintah berikut:

pip install groupdocs-annotation-cloud

SDK Python Anotasi Dokumen Cloud

GroupDocs.Annotation Cloud API menawarkan yang komprehensif Python SDK untuk anotasi dokumen yang lancar. Integrasikan fungsi dengan mudah seperti menambahkan komentar, sorotan, tanda air, dan redaksi ke berbagai format dokumen, termasuk PDF, Word, Excel, dan PowerPoint, dalam aplikasi Python Anda.

Anotasi Dokumen

Anotasi Teks - Tambahkan komentar atau penjelasan di dalam teks.
Anotasi Area - Menyorot area tertentu pada dokumen untuk catatan mendetail.
Anotasi Titik - Menandai tempat menarik tertentu dalam dokumen.
Anotasi Panah - Mengarahkan perhatian pemirsa ke elemen tertentu dengan penanda panah.
Anotasi Coret/Garis Bawah - Sorot teks dengan mencoret atau menggarisbawahi untuk memudahkan referensi.

Fitur Markup

Menyorot - Menandai bagian penting teks dengan sorotan.
Redaksi - Menyembunyikan atau menyensor sepenuhnya konten sensitif dalam dokumen.
Tanda Air - Melindungi dokumen dengan menambahkan tanda air untuk menunjukkan kepemilikan.

Manajemen Anotasi

Edit Anotasi - Memodifikasi atau memperbarui anotasi yang ada di dokumen.
Hapus Anotasi - Hapus anotasi yang tidak diperlukan atau sudah ketinggalan zaman.
Ekspor Anotasi - Ekstrak anotasi untuk disimpan secara terpisah atau dibagikan dengan orang lain.

Fitur Kolaborasi

Berkomentar - Aktifkan kolaborasi multi-pengguna dengan fitur komentar berbasis rangkaian pesan.
Kontrol Versi - Melacak perubahan yang dilakukan pada anotasi dengan alat pembuatan versi.
Pembaruan Waktu Nyata - Menerapkan pembaruan ketika beberapa pengguna mengedit dokumen yang sama.

Fitur Keamanan

Kontrol Akses - Mengamankan anotasi dokumen dengan kontrol akses berbasis pengguna.
Izin Berbasis Peran - Tetapkan tingkat izin yang berbeda kepada pengguna untuk melindungi anotasi sensitif.
Enkripsi - Pastikan data dienkripsi selama transfer dan penyimpanan dokumen.

Fitur Lanjutan

Gabungkan Anotasi - Menggabungkan beberapa anotasi menjadi satu dokumen.
Anotasi Berlapis - Memanipulasi anotasi berlapis untuk penyuntingan dan penandaan yang fleksibel.
Gaya Anotasi Khusus - Mengatur warna, opasitas, dan ukuran khusus untuk anotasi.
Integrasi API - Integrasikan dengan sistem lain menggunakan REST API.
Infrastruktur yang Dapat Diskalakan - Mendukung lingkungan dengan beban tinggi dengan arsitektur yang dapat diskalakan.

Jenis dan Fitur Anotasi yang Didukung

Anotasi Area

• Tandai area dalam halaman dokumen dengan persegi panjang.
  • Memungkinkan pengguna untuk menyorot wilayah tertentu pada dokumen.
  • Dimensi kotak dapat disesuaikan dengan bidang yang diminati.
  • Mendukung balasan anotasi untuk ulasan kolaboratif.
  • Anotasi area dapat menyertakan komentar tambahan.

Anotasi Jarak

• Mengukur jarak antar objek dalam dokumen.
  • Memungkinkan pengukuran yang tepat dalam konten dokumen.
  • Koordinat dan dimensi dapat ditentukan untuk pengukuran yang tepat.
  • Berguna untuk dokumen arsitektur dan teknik di mana pengukuran jarak sangat penting.

Anotasi Elips

• Menggambar anotasi elips pada halaman dokumen.
  • Memungkinkan pengguna untuk menyorot area melingkar atau elips.
  • Radius, warna, dan opacity yang dapat disesuaikan untuk visibilitas yang jelas.
  • Mendukung banyak balasan untuk komentar tambahan di area yang ditandai.

Anotasi Gambar

• Menambahkan gambar ke area tertentu pada dokumen.
  • Menyisipkan gambar dalam halaman dokumen untuk referensi visual.
  • Mendukung pemosisian dan pengubahan ukuran gambar.
  • Berguna untuk menambahkan logo, stempel, atau tanda visual.

Anotasi Tautan

• Menambahkan hyperlink ke dokumen.
  • Menautkan teks atau area tertentu pada dokumen ke URL eksternal.
  • Memberikan dukungan untuk navigasi web atau referensi sumber daya tambahan.
  • Dapat ditata dengan warna berbeda untuk membedakannya dari teks.

Beberapa Anotasi

• Memungkinkan penambahan beberapa jenis anotasi secara bersamaan.
  • Mendukung penambahan kombinasi anotasi (misalnya teks, gambar, bentuk) sekaligus.
  • Berguna untuk meninjau dokumen yang memerlukan jenis anotasi berbeda pada halaman yang sama.
  • Beberapa anotasi dapat dikelompokkan atau diperlakukan secara terpisah.

Anotasi Poin

• Menempelkan komentar pada titik tertentu dalam dokumen.
  • Komentar dikaitkan dengan titik atau lokasi tertentu dalam dokumen.
  • Ideal untuk tinjauan dokumen kolaboratif yang memerlukan umpan balik yang tepat.
  • Mendukung penyesuaian warna dan ukuran untuk visibilitas yang lebih baik.

Anotasi Polyline

• Menggambar garis-garis yang terhubung untuk membentuk polyline dalam dokumen.
  • Digunakan untuk menggambar bentuk kompleks atau menandai jalur tertentu dalam dokumen.
  • Mendukung banyak titik yang dihubungkan oleh garis lurus.
  • Memungkinkan penyesuaian ketebalan garis, warna, dan opacity.

Anotasi Redaksi Sumber Daya

• Mengisi persegi panjang hitam pada posisi tetap untuk menyembunyikan informasi sensitif.
  • Secara efektif menyunting informasi rahasia dari dokumen.
  • Kotak hitam dapat diukur dan diposisikan di atas data sensitif apa pun.
  • Biasa digunakan untuk dokumen hukum, laporan keuangan, atau nomor identifikasi pribadi (PIN).

Anotasi Berlekuk-lekuk

• Menambahkan garis bawah bergelombang untuk menandai teks.
  • Menyorot teks dengan garis bawah berlekuk-lekuk untuk menarik perhatian.
  • Ideal untuk menandai kesalahan ejaan atau tata bahasa.
  • Warna dan gaya garis dapat disesuaikan untuk membedakannya dari anotasi lainnya.

Format Anotasi yang Didukung

Memulai GroupDocs.Anotasi Cloud Python SDK

Persyaratan

Python 2.7 atau 3.4+

Instalasi

Memasang groupdocs-annotation-cloud dengan PIP dari PyPI by:

pip install groupdocs-annotation-cloud

Atau klon repository dan menginstalnya melalui Setuptools:

python setup.py install

Silakan ikuti prosedur instalasi lalu jalankan berikut ini:

# 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.Model Data Cloud API Anotasi

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

Contoh Kode Python 1: Tambahkan Anotasi Teks

Contoh kode ini menunjukkan cara menambahkan anotasi teks ke dokumen menggunakan GroupDocs.Annotation Cloud SDK untuk Python. Anotasi teks dapat disesuaikan dalam hal posisi, font, dan warna.

# 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'])

Contoh Kode Python 2: Tambahkan Anotasi Area

Contoh kode ini menunjukkan cara menambahkan anotasi area (menyoroti bagian dokumen).

# 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'])

Contoh Kode Python 3: Hapus Anotasi

Contoh kode ini menunjukkan cara menghapus anotasi dari dokumen.

# 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'])