Kurulum

Paket pypi.org’da mevcut‘dir ve aşağıdaki komut çalıştırılarak pip aracılığıyla kurulabilir:

pip install groupdocs-annotation-cloud

Bulut Belgesi Ek Açıklama Python SDK’sı

GroupDocs.Annotation Cloud API, kusursuz belge açıklaması için kapsamlı bir Python SDK sunar. Python uygulamalarınızdaki PDF, Word, Excel ve PowerPoint dahil olmak üzere çeşitli belge formatlarına yorum, vurgulama, filigran ve redaksiyon ekleme gibi işlevleri kolayca entegre edin.

Belge Ek Açıklamaları

Metin Açıklamaları - Metnin içine yorum veya açıklamalar ekleyin.
Alan Açıklamaları - Ayrıntılı notlar için belgenin belirli alanlarını vurgulayın.
Nokta Ek Açıklamaları - Bir belgedeki belirli ilgi çekici noktaları işaretleyin.
Ok Ek Açıklamaları - İzleyicilerin dikkatini ok işaretleriyle belirli öğelere yönlendirin.
Çizgili/Alt Çizgili Ek Açıklamalar - Kolay referans için metnin üzerini çizerek veya altını çizerek vurgulayın.

İşaretleme Özellikleri

Vurgulama - Metnin önemli bölümlerini vurgularla işaretleyin.
Redaksiyon - Belgelerdeki hassas içeriği tamamen gizleyin veya sansürleyin.
Filigranlama - Sahipliği belirtmek için filigranlar ekleyerek belgeleri koruyun.

Ek Açıklama Yönetimi

Ek Açıklamaları Düzenle - Belgelerdeki mevcut ek açıklamaları değiştirin veya güncelleyin.
Ek Açıklamaları Sil - Gereksiz veya güncelliğini kaybetmiş ek açıklamaları kaldırın.
Ek Açıklamaları Dışa Aktar - Ayrı olarak saklamak veya başkalarıyla paylaşmak için ek açıklamaları çıkarın.

İşbirliği Özellikleri

Yorum yapma - Konu tabanlı yorum oluşturma özellikleriyle çok kullanıcılı işbirliğini etkinleştirin.
Sürüm Kontrolü - Sürüm oluşturma araçlarıyla ek açıklamalarda yapılan değişiklikleri takip edin.
Gerçek Zamanlı Güncellemeler - Birden fazla kullanıcı aynı belgeyi düzenlediğinde güncellemeleri uygulayın.

Güvenlik Özellikleri

Erişim Kontrolü - Kullanıcı tabanlı erişim kontrolüyle belge ek açıklamalarını güvenli hale getirin.
Rol Tabanlı İzinler - Hassas ek açıklamaları korumak için kullanıcılara farklı izin düzeyleri atayın.
Şifreleme - Belge aktarımı ve depolama sırasında verilerin şifrelendiğinden emin olun.

Gelişmiş Özellikler

Ek Açıklamaları Birleştir - Birden fazla ek açıklamayı tek bir belgede birleştirin.
Katmanlı Ek Açıklamalar - Esnek düzenleme ve işaretleme için katmanlı ek açıklamaları değiştirin.
Özel Açıklama Stilleri - Ek açıklamalar için özel renkler, opaklık ve boyut ayarlayın.
API Entegrasyonu - REST API’lerini kullanarak diğer sistemlerle entegrasyon sağlayın.
Ölçeklenebilir Altyapı - Ölçeklenebilir mimariyle yüksek yüklü ortamları destekler.

Desteklenen Ek Açıklama Türleri ve Özellikleri

Alan Açıklaması

• Belge sayfasındaki bir alanı dikdörtgenle işaretleyin.
  • Kullanıcıların bir belgede belirli bir bölgeyi vurgulamasına olanak tanır.
  • Kutu boyutları ilgi alanına göre özelleştirilebilir.
  • İşbirliğine dayalı incelemeler için ek açıklamalara verilen yanıtları destekler.
  • Alan açıklaması ek açıklamalar içerebilir.

Mesafe Açıklaması

• Bir belgedeki nesneler arasındaki mesafeyi ölçer.
  • Belge içeriğinde hassas ölçümlere olanak sağlar.
  • Kesin ölçümler için koordinatlar ve boyutlar tanımlanabilir.
  • Mesafe ölçümlerinin kritik olduğu mimari ve mühendislik belgeleri için kullanışlıdır.

Elips Açıklaması

• Bir belge sayfasına eliptik açıklamalar çizer.
  • Kullanıcıların dairesel veya eliptik alanları vurgulamasına olanak tanır.
  • Net görünürlük için özelleştirilebilir yarıçap, renk ve opaklık.
  • İşaretli alana eklenen yorumlar için birden fazla yanıtı destekler.

Resim Açıklaması

• Belgenin belirli bir alanına resim ekler.
  • Görsel referans için bir belge sayfasına resimler ekler.
  • Görüntülerin konumlandırılmasını ve yeniden boyutlandırılmasını destekler.
  • Logo, damga veya görsel işaret eklemek için kullanışlıdır.

Bağlantı Açıklaması

• Bir belgeye köprü ekler.
  • Belgenin belirli metin veya alanlarını harici URL’lere bağlar.
  • Web’de gezinme veya ek kaynaklara başvurma desteği sağlar.
  • Metinden farklılaşmak için farklı renklerle şekillendirilebilir.

Çoklu Açıklama

• Aynı anda birden fazla türde ek açıklama eklenmesine olanak tanır.
  • Aynı anda ek açıklamaların (örneğin, metin, resimler, şekiller) bir kombinasyonunun eklenmesini destekler.
  • Aynı sayfada farklı açıklama türlerinin gerekli olduğu belgeleri incelemek için kullanışlıdır.
  • Çoklu açıklamalar gruplandırılabilir veya ayrı ayrı ele alınabilir.

Nokta Açıklaması

• Yorumları belgedeki belirli bir noktaya yapıştırır.
  • Yorumlar belgedeki belirli bir nokta veya konumla ilişkilendirilir.
  • Geri bildirimin belirlenmesinin gerekli olduğu ortak belge incelemeleri için idealdir.
  • Daha iyi görünürlük için renk ve boyut ayarlamalarını destekler.

Çoklu Çizgi Açıklaması

• Bir belgede sürekli çizgi oluşturmak için bağlantılı çizgiler çizer.
  • Bir belgede karmaşık şekiller çizmek veya belirli yolları işaretlemek için kullanılır.
  • Düz çizgilerle birbirine bağlanan birden fazla noktayı destekler.
  • Çizgi kalınlığının, renginin ve opaklığının özelleştirilmesini sağlar.

Kaynak Düzenleme Ek Açıklaması

• Hassas bilgileri gizlemek için siyah bir dikdörtgeni sabit bir konumda doldurur.
  • Gizli bilgileri belgelerden etkili bir şekilde çıkarır.
  • Kara kutu herhangi bir hassas verinin üzerine boyutlandırılabilir ve konumlandırılabilir.
  • Genellikle yasal belgeler, mali tablolar veya kişisel kimlik numaraları (PIN’ler) için kullanılır.

Dalgalı Ek Açıklama

• Metni işaretlemek için dalgalı bir alt çizgi ekler.
  • Dikkat çekmek için metni dalgalı bir alt çizgiyle vurgular.
  • Yazım veya dilbilgisi hatalarını işaretlemek için idealdir.
  • Renk ve çizgi stili diğer açıklamalardan farklı olacak şekilde ayarlanabilir.

Desteklenen Ek Açıklama Formatları

Başlarken GroupDocs.Annotation Bulut Python SDK’sı

Gereksinimler

Python 2.7 veya 3.4+

Kurulum

groupdocs-annotation-cloud‘ı PIP ile PyPI‘den şu şekilde yükleyin:

pip install groupdocs-annotation-cloud

Veya depo‘i kopyalayın ve Setuptools aracılığıyla yükleyin:

python setup.py install

Lütfen kurulum prosedürünü takip edin ve ardından aşağıdakileri çalıştırın:

# 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 Bulut API Veri Modelleri

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 Kodu Örneği 1: Metin Açıklaması Ekleme

Bu kod örneği, Python için GroupDocs.Annotation Cloud SDK’yı kullanarak bir belgeye metin ek açıklamasının nasıl ekleneceğini gösterir. Metin açıklaması konum, yazı tipi ve renk açısından özelleştirilebilir.

# 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 Kodu Örneği 2: Alan Açıklaması Ekleme

Bu kod örneği, alan ek açıklamasının nasıl ekleneceğini gösterir (belgenin bir bölümünü vurgulayarak).

# 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 Kodu Örneği 3: Ek Açıklamayı Kaldır

Bu kod örneği, bir belgeden ek açıklamanın nasıl kaldırılacağını gösterir.

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