Adobe PDF Services
Adobe Workfront Fusion Adobe PDF Services を使用すると、PDF ファイルからデータを抽出したり、指定したデータから新しい PDF ファイルを生成したりできます。さらに、様々なファイルタイプを PDF に変換したり、PDF を他のファイルタイプに変換したりできます。PDF サービスでは、PDF ファイルの組み合わせ、圧縮、メタデータの読み取りを行うことや、ファイルのパスワード保護を制御することもできます。
シナリオの作成手順が必要な場合は、 Adobe Workfront Fusion でのシナリオの作成を参照してください。
モジュールについて詳しくは、 Adobe Workfront Fusion のモジュールを参照してください。
PDF サービスに使用される API については、Adobe Document Generation API を参照してください。
Adobe PDF Services を使用する際のセキュリティに関する考慮事項
Adobe PDF Services はファイルの読み取り、変換、変更はできますが、Adobe も Workfront Fusion もファイルやデータを保存しません。つまり、次のようになります。
- ユーザーは、ファイルのセキュリティを含め、ファイルの制御を維持する
- PDF サービスを使用するのにアドビストレージやクラウドストレージアカウントは必要ありません。
アクセス要件
この記事で説明している機能を使用するには、次のアクセス権が必要です。
ご利用のプラン、ライセンスタイプまたはアクセス権を確認するには、Workfront 管理者にお問い合わせください。
Adobe Workfront Fusion ライセンスについて詳しくは、Adobe Workfront Fusion ライセンスを参照してください。
前提条件
OAuth サーバー間 API を作成するには、Adobe Developers Console に Adobe PDF Services API を追加する必要があります。API を追加する場合は、OAuth サーバー間オプションを選択します。
手順については、アドビデベロッパー向けドキュメントで OAuth を使用したプロジェクトへの API の追加を参照してください。
Adobe PDF サービス API に関する情報
Adobe PDF サービスコネクタは、以下を使用します。
Adobe PDF Services への接続の作成
Adobe PDF Services モジュールへの接続を作成するには、以下を実行します。
-
任意の Adobe PDF Services モジュールで、「接続」ボックスの横にある「追加」をクリックします。
-
次のフィールドに入力します。
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 layout-auto html-authored no-header Connection type サーバー間接続と JWT 接続のどちらを作成するかを選択します。 Connection name この接続の名前を入力します。 Client ID Adobe Client ID を入力します。これは、Adobe Developer Console の Credentials details セクションで確認できます。
資格情報の検索手順については、アドビデベロッパー向けドキュメントで資格情報を参照してください。
Client Secret Adobe Client Secret を入力します。これは、Adobe Developer Console の Credentials details セクションで確認できます。
資格情報の検索手順については、アドビデベロッパー向けドキュメントで資格情報を参照してください。
Technical account ID（JWT のみ） Adobe Technical account ID を入力します。これは、Adobe Developer Console の Credentials details セクションで確認できます。
資格情報の検索手順については、アドビデベロッパー向けドキュメントで資格情報を参照してください。
Organization ID（JWT のみ） Adobe Organization ID を入力します。これは、Adobe Developer Console の Credentials details セクションで確認できます。
資格情報の検索手順については、アドビデベロッパー向けドキュメントで資格情報を参照してください。
Meta scopes（JWT のみ） 接続に必要なメタスコープを入力します。 -
「続行」をクリックして接続を保存し、モジュールに戻ります。
Adobe PDF Services モジュールとそのフィールド
PDF Services を設定すると、Workfront Fusion には以下のフィールドが表示されます。これらと共に、アプリやサービスのアクセスレベルなどの要因に応じて、追加のフィールドが表示される場合があります。モジュール内の太字のタイトルは、必須フィールドを示します。
フィールドまたは関数の上にマップボタンが表示されている場合は、このボタンを使用すると、そのフィールドの変数や関数を設定できます。詳しくは、 Adobe Workfront Fusion でモジュールから別のモジュールに情報をマッピングを参照してください。
PDF ファイルの結合
このアクションモジュールは、複数の PDF ファイルを取得し、それらを 1 つの PDF ファイルに結合します。例えばこのモジュールは、Workfront プロジェクトのすべてのドキュメントを、プロジェクトの完了時に 1 つの PDF に結合します。
このモジュールに使用する接続を選択します。
Adobe PDF Services への接続を作成する方法については、この記事内の Adobe PDF Services への接続の作成を参照してください。
集約モジュールを使用して、ドキュメントを収集して PDF に組み合わせることも、手動でドキュメントを追加することもできます。
Array Aggregator モジュールを使用して、以前のモジュールの出力を集計することをお勧めします。集約を使用すると、結合するファイルの名前、場所、数を把握する必要がなくなります。したがって、集約を使用すると、結合するドキュメントを手動で入力するよりも、高い柔軟性と拡張性が得られます。
Combine PDF モジュールを集約と共に使用するには、Documents フィールドでマッピングを有効にする必要があります。
この例では、Read Related Records モジュールはプロジェクトに関連付けられたドキュメントを識別し、Download Documents モジュールは各ドキュメントをダウンロードします。すべての PDF は配列に集計され、Combine PDF ファイルモジュールに渡されます。
手動でドキュメントを入力することもできます。
結合 PDF に含めるドキュメントごとに、次の手順を実行します。
-
「Add a Document」をクリックします。
-
「Source file」フィールドで、含めるドキュメントを出力するモジュールを選択するか、ソースファイルの名前とデータをマッピングします。
-
（オプション）ソースファイルの特定のページのみを含める場合は、追加するページ範囲ごとに、「Pages」フィールドの「Add item」をクリックし、含めるページ範囲の最初と最後のページを入力し、「Add」をクリックします。1 つのドキュメントから複数のページ範囲を含めることができます。
-
「Add」をクリックします。
PDF ファイルを圧縮
このアクションモジュールは PDF ファイルを取得し、圧縮します。これは、帯域幅やメモリの節約に役立ちます。
ドキュメントを PDF ファイルに変換
このツールは、ドキュメントを PDF ファイルに変換します。ソースファイルは、次のいずれかのドキュメント形式である必要があります。
- DOC
- XLS
- PPT
- TXT
- RTF
HTML を PDF ファイルに変換
このツールは、HTML ファイルを PDF ファイルに変換します。
画像を PDF ファイルに変換
このツールは、画像を PDF ファイルに変換します。
PDF を文書に変換
このツールは、PDF ファイルをドキュメントに変換します。出力ファイルには、次のいずれかの形式を選択できます。
- DOC
- DOCX
- PPTX
- XLSX
- RTF
PDF を画像に変換
このツールは、PDF を PNG または JPEG 形式の画像に変換し、ZIP として出力します。PDF は 1 ページにつき 1 つの画像に変換され、各画像の末尾がページ番号が付けられます。その後、画像ファイルは ZIP ファイルに結合されます。
例えば、8 ページの「TestFile」という名前のファイルでは、「TestFile_1」から「TestFile_8」までの 8 つの画像が生成されます。このモジュールの出力は、8 つの画像を含む ZIP ファイルです。
テキスト／テーブルの抽出
このアクションモジュールを使用すると、データを PDF ファイルから抽出できます。このモジュールは、段落やテーブルの単一セル内のテキストなど、個々のテキスト要素を出力します。
ドキュメントの生成
ドキュメントの生成モジュールは、選択したデータを含む PDF を作成する強力な方法です。Microsoft Word テンプレートを使用するか、JSON 形式でデータを指定することで、形式設定できます。
Adobe PDF Servicesドキュメントの生成機能について詳しくは、Adobe Document Services ドキュメントのドキュメント生成の概要を参照してください。
Microsoft Word テンプレートでドキュメントの生成モジュールの使用
Microsoft Word テンプレートでドキュメントの生成モジュールを使用するには、まずテンプレートを作成する必要があります。手順については、Microsoft Office ドキュメントで「テンプレートの作成」を検索してください。
ドキュメントの生成モジュールのフィールドに次のように入力します。
このモジュールに使用する接続を選択します。
Adobe PDF Services への接続を作成する手順については、この記事のAdobe PDF Services への接続の作成を参照してください。
以前のモジュールで使用したソースファイルを選択するか、ソースファイルの名前とデータをマッピングします。
このソースファイルは、モジュールが新しい PDF の生成に使用する Microsoft Word テンプレートです。
Workfront Fusion で使用する Microsoft Word テンプレート用に Workfront にプロジェクトを作成することをお勧めします。その後、Workfront／Download document モジュールを使用して、適切なテンプレートをシナリオに取り込みます。
生成するドキュメントの形式を選択します。
-
PDF
-
DOCX
テキストに置き換えるテンプレートの値タグごとに、次のように入力します。
-
Key
キーを入力します。テンプレートでは、キーは値タグに表示されるテキストです。例えば、値タグ
{{name}}にテキストを配置する場合は、キーフィールドにnameと入力します。 -
値のタイプ
値フィールド内のデータを、値、オブジェクトまたはオブジェクトの配列のどれにするかを選択します。
-
Value
生成されたドキュメントに、値タグの代わりに表示するテキストを入力またはマッピングします。
JSON でドキュメントの生成モジュールの使用
JSON でドキュメントの生成モジュールを使用するには、次のようにフィールドに入力します。
PDF ファイルのリニアライズ
このツールは、PDF ドキュメントをリニアライズして、web 用に最適化された PDF ドキュメントを作成します。リニアライズド PDF ドキュメントは、ドキュメント全体をダウンロードする必要なく、ページごとに表示できます。
PDF ファイルの OCR
このツールは、ファイルに対して光学式文字認識（OCR）を実行し、PDF を生成します。
ページ操作
このモジュールを使用すると、PDF ドキュメント内のページを選択的に回転または削除できます。例えば、縦表示を横表示に変更したり、PDF ドキュメントから特定のページを削除したりできます。
PDF アクセシビリティの自動タグ付け
このアクションモジュールは、アクセシビリティのユースケースにタグ付けされた PDF を作成します。また、問題をリストアップし修正を提案する、オプションの Microsoft Excel レポートも作成します。
PDF ファイルのプロパティ
このツールは、次のようなドキュメントに関する基本情報を抽出します。
- ページ数
- PDF のバージョン
- ファイルが暗号化されているかどうか
- ファイルが線形化されているかどうか
- ファイルに埋め込みファイルが含まれているかどうか
PDF ファイルを保護
このツールは、ユーザーまたは所有者のパスワードを使用して PDF ドキュメントを保護します。また、PDF ドキュメントにおける印刷、編集、コピーなど、特定の機能に対する制限も設定します。暗号化するコンテンツのタイプと暗号化アルゴリズムを選択します。
PDF ファイルの保護を解除
このツールは、PDF ドキュメントからセキュリティ（パスワード保護）を削除します。
PDF ファイルの分割
このアクションモジュールは、PDF ドキュメントを複数の小さなドキュメントに分割します。ファイル数、ファイルあたりのページ数、ページ範囲のどちらで分割するかを指定します。
カスタム API 呼び出しの実行
これは、PDFサービス API へのカスタム HTTP リクエストをモジュール化します。
このモジュールに使用する接続を選択します。
Adobe PDF Services への接続を作成する手順については、この記事のAdobe PDF Services への接続の作成を参照してください。
リクエストのヘッダーを標準 JSON オブジェクトの形式で追加します。
例： {"Content-type":"application/json"}
Workfront Fusion は認証ヘッダーを自動的に追加します。
API 呼び出しのクエリを標準 JSON オブジェクトの形式で追加します。
例： {"name":"something-urgent"}
API 呼び出しに追加する各フィールドについて、「 項目を追加 をクリックし、フィールドのキーとオプション値を入力します。
メモ：
if などの条件文を JSON で使用する場合は、条件文を引用符で囲みます。
