If so you can download any of the below versions for testing. The product will function as normal except for an evaluation limitation. At the time of purchase we provide a license file via email that will allow the product to work in its full capacity. If you would also like an evaluation license to test without any restrictions for 30 days, please follow the directions provided here.
If you experience errors, when you try to download a file, make sure your network policies (enforced by your company or ISP) allow downloading ZIP and/or MSI files.
インストール
パッケージは、availablepypi.org にあり、経由でインストールできます。pip次のコマンドを実行します。
pip install groupdocs-annotation-cloud
クラウド ドキュメント アノテーション Python SDK
GroupDocs.Annotation Cloud API は包括的なサービスを提供しますPython SDKシームレスなドキュメント注釈用。 PDF、Word、Excel、PowerPoint などのさまざまなドキュメント形式にコメント、ハイライト、透かし、墨消しを追加するなどの機能を Python アプリケーション内で簡単に統合できます。
ドキュメントの注釈
テキストの注釈 - テキスト内にコメントまたは説明を追加します。
領域の注釈 - 詳細な注記を表示するには、文書の特定の領域を強調表示します。
ポイント注釈 - 文書内の特定の注目ポイントをマークします。
矢印注釈 - 矢印マーカーを使用して、視聴者の注意を特定の要素に向けます。
注釈の取り消し線/下線 - 簡単に参照できるように、取り消し線または下線を引いてテキストを強調表示します。
マークアップ機能
ハイライト - テキストの重要なセクションをハイライトでマークします。
編集 - ドキュメント内の機密コンテンツを完全に非表示または検閲します。
透かし - 所有権を示す透かしを追加してドキュメントを保護します。
注釈管理
注釈の編集 - ドキュメント内の既存の注釈を変更または更新します。
注釈の削除 - 不要な注釈または古い注釈を削除します。
注釈のエクスポート - 注釈を抽出して個別に保存したり、他のユーザーと共有したりできます。
コラボレーション機能
コメント - スレッドベースのコメント機能を使用してマルチユーザーのコラボレーションを可能にします。
バージョン管理 - バージョン管理ツールを使用して、注釈に加えられた変更を追跡します。
リアルタイム更新 - 複数のユーザーが同じドキュメントを編集するときに更新を実装します。
セキュリティ機能
アクセス制御 - ユーザーベースのアクセス制御により、ドキュメントの注釈を保護します。
ロールベースの権限 - 機密性の高い注釈を保護するために、ユーザーにさまざまな権限レベルを割り当てます。
暗号化 - ドキュメントの転送および保存中にデータが確実に暗号化されるようにします。
高度な機能
注釈の結合 - 複数の注釈を 1 つのドキュメントに結合します。
階層化された注釈 - 柔軟な編集とマーキングのために階層化された注釈を操作します。
カスタム注釈スタイル - 注釈のカスタム色、不透明度、サイズを設定します。
API 統合 - REST API を使用して他のシステムと統合します。
スケーラブルなインフラストラクチャ - スケーラブルなアーキテクチャで高負荷環境をサポートします。
サポートされているアノテーションのタイプと機能
エリアの注釈
- ドキュメント ページ内の領域を長方形でマークアップします。
- ユーザーがドキュメント上の特定の領域を強調表示できるようにします。
- ボックスの寸法は、関心のある領域に合わせてカスタマイズできます。
- 共同レビューの注釈への返信をサポートします。
- 領域の注釈には追加のコメントを含めることができます。
距離の注釈
- ドキュメント内のオブジェクト間の距離を測定します。
- ドキュメントのコンテンツ内で正確な測定を可能にします。
- 正確な測定のために座標と寸法を定義できます。
- 距離の測定が重要な建築および工学文書に役立ちます。
楕円の注釈
- 文書ページに楕円形の注釈を描画します。
- ユーザーが円形または楕円形の領域を強調表示できるようにします。
- 半径、色、不透明度をカスタマイズして鮮明な視認性を実現。
- マークされた領域に追加されたコメントに対する複数の返信をサポートします。
画像の注釈
- ドキュメントの特定の領域に画像を追加します。
- 視覚的な参照のためにドキュメント ページ内に画像を挿入します。
- 画像の位置決めとサイズ変更をサポートします。
- ロゴ、スタンプ、または視覚的なマークを追加するのに便利です。
リンクの注釈
- ドキュメントにハイパーリンクを追加します。
- ドキュメントの特定のテキストまたは領域を外部 URL にリンクします。
- Web ナビゲーションまたは追加リソースの参照のサポートを提供します。
- テキストと区別するために、異なる色でスタイルを設定できます。
複数のアノテーション
- 複数の種類の注釈を同時に追加できます。
- 注釈 (テキスト、画像、図形など) の組み合わせを一度に追加することをサポートします。
- 同じページ上で異なる注釈タイプが必要なドキュメントをレビューする場合に便利です。
- 複数の注釈をグループ化することも、個別に処理することもできます。
ポイントの注釈
- 文書内の特定の位置にコメントを貼り付けます。
- コメントはドキュメント内の特定の点または場所に関連付けられます。
- 正確なフィードバックが必要な共同文書レビューに最適です。
- 視認性を高めるための色とサイズの調整をサポートします。
ポリラインの注釈
- 接続された線を描画して、ドキュメント内にポリラインを形成します。
- 複雑な形状を描画したり、ドキュメント内の特定のパスをマークしたりするために使用されます。
- 直線で結ばれた複数の点をサポートします。
- 線の太さ、色、不透明度をカスタマイズできます。
リソースリダクションのアノテーション
- 機密情報を隠すために、固定位置の黒い四角形を塗りつぶします。
- 文書から機密情報を効果的に編集します。
- ブラック ボックスのサイズを変更して、機密データの上に配置することができます。
- 法的文書、財務諸表、または個人識別番号 (PIN) によく使用されます。
波線の注釈
- テキストをマークするために波線の下線を追加します。
- 注意を促すためにテキストを波線の下線で強調表示します。
- スペルや文法の間違いをマークするのに最適です。
- 色と線のスタイルを調整して、他の注釈と区別できます。
サポートされている注釈形式
| ファイル形式 | 説明 | 注釈を付ける |
|---|
DOC, DOCX | 単語®ドキュメント | ✔️ |
OTT | オープンドキュメント標準フォーマット | ✔️ |
ODT | オープンドキュメントのテキストファイル形式 | ✔️ |
DOCM | Microsoft Word® XML マクロが有効なドキュメントを開く | ✔️ |
DOT | 単語®ドキュメント テンプレート ファイル | ✔️ |
DOTX | 単語® XML ドキュメント テンプレートを開く | ✔️ |
DOTM | 単語® 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 | 拡張メタファイル / Windows メタファイル | ✔️ |
CAD | コンピュータ支援設計 | ✔️ |
EML/EMLX | 電子メールのマークアップ言語 | ✔️ |
HTML | ハイパーテキスト マークアップ言語 | ✔️ |
MHTML | MIME HTML ファイル | ✔️ |
JPEG | 共同写真専門家グループ | ✔️ |
TIFF | タグ付き画像ファイル形式 | ✔️ |
BMP | ビットマップ | ✔️ |
GIF(アニメーションなしの静止画像) | グラフィックス交換フォーマット | ✔️ |
VSD | Microsoft Visio®図面 | ✔️ |
VDX | Microsoft Visio® XML ファイル形式 | ✔️ |
VSS | Microsoft Visio®ステンシル ファイル形式 | ✔️ |
VSDM | Microsoft Visio®マクロ有効図面ファイル | ✔️ |
MSG | 電子メールメッセージ | ✔️ |
入門 GroupDocs.Annotation Cloud Python SDK
要件
Python 2.7 または 3.4 以降
インストール
インストールgroupdocs-annotation-cloudとPIPからPyPI by:
pip install groupdocs-annotation-cloud
またはクローンを作成しますrepositoryそしてそれを経由してインストールしますSetuptools:
インストール手順に従って、次を実行してください。
# 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 データ モデル
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 for 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'])