Assembler DDX Editor
操作で DDX エレメントをリテラル値として使用するには、Assembler DDX Editor ダイアログボックスを使用します。さまざまな DDX エレメントを含む XML 形式のテキストを入力します。DDX エレメントには、Assembler からの必要なドキュメントについて記述されています。Assembler DDX Editor ダイアログボックスで入力できる XML ヘッダー、DDX ルートおよび結果ブロックの例を次に示します。
<?xml version="1.0" encoding="UTF-8"?>
<DDX xmlns="http://ns.adobe.com/DDX/1.0/" >
<!-- example of a DDX result block -->
<PDF result="out.pdf">
<PDF source="in1.pdf"/>
</PDF
</DDX>
DDX エレメントおよび DDX コマンドの使用に関する詳細は、『
DDX Reference
』を参照してください。
Rights Management および Assembler
Assembler サービスの機能の 1 つとして、複数の PDF ドキュメントを 1 つの PDF ドキュメントまたは PDF ポートフォリオに結合できます。DDX ファイルを使用して、PDF ドキュメントまたは PDF ポートフォリオの内容について記述します。
Rights Management サービスを使用すると、PDF ドキュメントにポリシーを適用してロックできます。DDX ファイルで 1 つの PDF ドキュメントを変更する場合は、ドキュメントをアセンブルした後で、ドキュメントにポリシーを適用します。DDX で PDF ポートフォリオを作成または変更する際に、ロックされた PDF ドキュメントをパッケージファイルとして追加する場合は、
<PackageFiles source>
エレメントを使用して、ロックされた PDF ドキュメントを含めます。
<PackageFiles source>
エレメントは、ポートフォリオに PDF 以外のドキュメントを含める場合にも使用します。
<PackageFiles source>
エレメントまたは
<File>
子エレメントに .pdf ファイル拡張子が含まれていることを確認してください。ファイル拡張子が含まれていないと、ファイルが PDF 表示アプリケーション(Adobe Reader など)で開きません。
PDF ポートフォリオまたはパッケージの作成に関する詳細は、『
AEM forms サービスリファレンス
』の Assembler サービスのトピック、および『
DDX リファレンス
』を参照してください。
invokeDDX 操作
入力ドキュメントの指定したマップに対して DDX ファイルを実行し、操作された PDF ドキュメントを返します。
General プロパティグループと Route Evaluation プロパティグループについて詳しくは、
共通の操作プロパティ
を参照してください。
Input プロパティ
入力 DDX ファイル、オプションのドキュメントおよび環境値を指定するプロパティです。
Input DDX Document
呼び出す DDX ファイルを表す
文書
値です。
リテラル値を指定する場合は、次のボタンを使用して、DDX ファイルの内容を指定できます。
-
省略記号ボタン
:
-
Select Asset ダイアログボックスを表示します(
Select Asset について
を参照)。
-
編集ボタン
:
-
Assembler DDX Editor ダイアログボックスを表示し、そこで DDX エレメントを直接入力し、「OK」をクリックします(
Assembler DDX Editor
を参照)。XML ヘッダー、DDX ルートおよび結果ブロックの例を次に示します。
<?xml version="1.0" encoding="UTF-8"?>
<DDX xmlns="http://ns.adobe.com/DDX/1.0/" >
<!-- example of a DDX result block -->
<PDF result="out.pdf">
<PDF source="in1.pdf"/>
<PDF source="in2.pdf"/>
</PDF
</DDX>
また、テンプレート値を使用し、DDX エレメントを直接ダイアログボックスに入力することもできます。この方法は、DDX エレメントをプロセス変数として渡す場合にテスト目的で使用するのに便利です。
Input Document Map
(オプション)DDX ファイルに従って操作するドキュメントを表す
map
値です。キーは、DDX ファイルで参照される論理名です。各キーは、
文書
値または
文書
を含む
list
値を参照できます。
マップまたはリストからの値の取得について詳しくは、
データコレクション内のデータへのアクセス
を参照してください
リテラル値を指定する場合は、DDX キーと各キーが参照する document 値を追加できます。DDX キーについては、次のボタンを使用して、キーを追加および削除できます。
-
Add A List Entry:
-
DDX キーをリストに追加します。
-
Delete Selected List Entry:
-
DDX キーをリストから削除します。
選択した各 DDX キーについては、次のボタンを使用して、ドキュメントを表す値を追加、移動および削除できます。
-
Add A List Entry:
-
ドキュメントエントリをリストに追加します。
-
Delete Selected List Entry:
-
ドキュメントエントリをリストから削除します。
-
Move Selected List Entry Up One Row:
-
選択したドキュメントエントリをリスト内で上に移動します。リストの順序によって、使用されるドキュメントエントリの順序が決定されます。
-
Move Selected List Entry Down One Row:
-
選択したドキュメントエントリをリスト内で下に移動します。
Environment
(オプション)DDX の処理中に使用する環境オプションを指定する
AssemblerOptionSpec
値です。
リテラル値を指定する場合は、次の値を指定します。
-
Job Log Level:
-
この操作のログレベルを設定します。デフォルト値は
INFO
です。次の値を使用できます。
-
OFF
:サーバーのメッセージのログ記録を無効にします。
-
SEVERE
:重大なエラーを示すメッセージのみをログに記録します。
-
WARNING
:問題の可能性を示すメッセージおよび重大なエラーを示すメッセージをログに記録します。
-
INFO
:情報提供を目的としたメッセージ、問題の可能性示すメッセージおよび重大なエラーを示すメッセージをログに記録します。
-
CONFIG
:静的設定メッセージのみをログに記録します。
-
FINE
:トレース情報をログに記録します。
-
FINER
:詳細なトレース情報のログです。
-
FINEST
:非常に詳細なトレース情報のログです。
注意:
FINE、FINER および FINEST を使用すると、サーバーのパフォーマンスに悪影響を与えます。これらはデバッグ目的でのみ使用します。
-
Validate Only:
-
DDX ジョブが検証のみのテスト(つまり、Assembler サービスが DDX を実行せずに検証のみを行う)かどうかを設定します。
True
値は、検証のみのテストであることを示します。デフォルト値は
False
です。この値は、Assembler サービスが DDX を検証して実行することを示します。
-
Fail On Error:
-
例外またはエラーが発生した場合に DDX ジョブを即座に終了し、他のすべての結果ブロックの処理を停止するかどうかを指定します。
False
値は、例外またはエラーの発生に関係なく、ジョブの処理を続行することを示します。例外には、
AssemblerResult
値からの
throwables
データ項目の出力としてアクセスできます。例外を表すエラーは、
jobLog
データ項目のログファイルで確認できます。デフォルト値の
True
は、DDX ジョブを即座に終了することを示します。ただし、スローされた例外をプロセスでキャッチする場合は、
AssemblerResult
値の
jobLog
データ項目から例外にアクセスできます。
-
Default Style:
-
設定するデフォルトのフォントスタイルです。フォントスタイルは、DDX リッチテキストエレメントのフォント属性と同じ
"<font-style> <font-weight> <font-size>/<line-height> <font-family-specifier>"
という形式です。デフォルトのスタイルを指定しない場合は、
"normal normal 12pt 'Minion Pro'"
が使用されます。
-
First Bates Number:
-
ベイツナンバリングに使用する最初の数値です。デフォルト値はありません。
Output プロパティ
出力ドキュメントを指定するプロパティです。
抽出された添付ファイル(パッケージファイル)が出力に含まれる場合は、
[filename of source document]
_attach.
[page of attachment]
.
[index of attachment on a page]
という命名スキームを使用して、各添付ファイルの一意の名前が作成されます。
-
[file name of source document]
は、次のルールに基づいています。
-
ソースドキュメントのファイル名です。URL を指定した場合は、URL の最後のスラッシュの後の最後のセグメントが使用されます。たとえば、http://www.adobe.com/go/ABC.pdf という URL を使用した場合、ABC.pdf というファイル名が使用されます。
-
プロセス URI を使用した場合は、最後の # 文字の後の部分が名前に使用されます。たとえば、
process:///process_data/@doc1#doc1.pdf
というプロセス URI を使用した場合、doc1.pdf というファイル名が使用されます。
-
DDX ファイルの
PDF source
属性の最後のパスセグメントからのドキュメント名です。
-
[page of attachment]
は、添付ファイルが表示されるソースドキュメントのページ番号です。たとえば、添付ファイルが 7 ページ目に表示される場合、値は 0007 になります。
-
[index of attachment on page]
は、添付ファイルのインデックスです。この値は、複数の添付ファイルが同じページに表示される場合に重要になります。たとえば、同じページに表示される添付ファイルが 2 つある場合、最初の添付ファイルは 0001 という値になり、2 番目の添付ファイルは 0002 という値になります。
たとえば、PDF123.pdf という名前のソースドキュメントの最初のページに添付ファイルが 2 つあり、3 ページ目に添付ファイルが 1 つある場合、添付ファイルの名前は、それぞれ PDF123.pdf_attach.0001.0001、PDF123.pdf_attach.0001.0002 および PDF123.pdf_attach.0003.0001 になります。
invokeDDXOneDocument 操作
指定した 1 つのドキュメントのみに対して DDX ファイルを実行し、操作された PDF ドキュメントを返します。
General プロパティグループと Route Evaluation プロパティグループについて詳しくは、
共通の操作プロパティ
を参照してください。
Input プロパティ
入力 DDX ファイル、DDX ファイルを使用して操作するドキュメントおよび環境値を指定するプロパティです。
Input DDX Document
呼び出す DDX ファイルを表す
文書
値です。この操作を使用して操作できるドキュメントが 1 つだけの場合、ドキュメントの論理名は
inDoc
になります。DDX ファイルの
PDF source
属性は、値が
inDoc
である必要があります。以下に例を示します。
<PDF source="inDoc"/>
リテラル値を指定する場合は、次のボタンを使用して、DDX ファイルの内容を指定できます。
-
省略記号ボタン
:
-
Select Asset ダイアログボックスを表示します(
Select Asset について
を参照)。
-
編集ボタン
:
-
Assembler DDX Editor ダイアログボックスを表示し、そこで DDX エレメントを直接入力し、「OK」をクリックします(
Assembler DDX Editor
を参照)。XML ヘッダー、DDX ルートおよび結果ブロックの例を次に示します。
<?xml version="1.0" encoding="UTF-8"?>
<DDX xmlns="http://ns.adobe.com/DDX/1.0/" >
<!-- example of a DDX result block -->
<PDF result="out.pdf">
<PDF source="inDoc"/>
</DDX>
また、テンプレート値を使用し、DDX エレメントを直接ダイアログボックスに入力することもできます。この方法は、DDX エレメントをプロセス変数として渡す場合にテスト目的で使用するのに便利です。
Input Document
(オプション)DDX ファイルに従って操作するドキュメントを表す
文書
値です。ドキュメントのデフォルトの論理名は
inDoc
です。
リテラル値を指定する場合は、省略記号ボタン
をクリックして、Select Asset ダイアログボックスを表示します(
Select Asset について
を参照)。
Environment
(オプション)DDX の処理中に使用する環境オプションを指定する
AssemblerOptionSpec
値です。
リテラル値を指定する場合は、次の値を指定します。
-
Job Log Level:
-
この操作のログレベルを設定します。デフォルト値は
INFO
です。次の値を使用できます。
-
OFF
:サーバーのメッセージのログ記録を無効にします。
-
SEVERE
:重大なエラーを示すメッセージのみをログに記録します。
-
WARNING
:問題の可能性を示すメッセージおよび重大なエラーを示すメッセージをログに記録します。
-
INFO
:情報提供を目的としたメッセージ、問題の可能性示すメッセージおよび重大なエラーを示すメッセージをログに記録します。
-
CONFIG
:静的設定メッセージのみをログに記録します。
-
FINE
:トレース情報をログに記録します。
-
FINER
:詳細なトレース情報のログです。
-
FINEST
:非常に詳細なトレース情報のログです。
注意:
FINE、FINER および FINEST を使用すると、サーバーのパフォーマンスに悪影響を与えます。これらはデバッグ目的でのみ使用します。
-
Validate Only:
-
DDX ジョブが検証のみのテスト(つまり、Assembler サービスが DDX を実行せずに検証のみを行う)かどうかを設定します。
True
値は、検証のみのテストであることを示します。デフォルト値は
False
です。この値は、Assembler サービスが DDX を検証して実行することを示します。
-
Fail On Error:
-
例外またはエラーが発生した場合に DDX ジョブを即座に終了し、他のすべての結果ブロックの処理を停止するかどうかを指定します。
False
値は、例外またはエラーの発生に関係なく、ジョブの処理を続行することを示します。デフォルト値の
True
は、DDX ジョブを即座に終了することを示します。
-
Default Style:
-
設定するデフォルトのフォントスタイルです。フォントスタイルは、DDX リッチテキストエレメントのフォント属性と同じ
"<font-style> <font-weight> <font-size>/<line-height> <font-family-specifier>"
という形式です。デフォルトのスタイルを指定しない場合は、
"normal normal 12pt 'Minion Pro'"
が使用されます。
-
First Bates Number:
-
ベイツナンバリングに使用する最初の数値です。
Output プロパティ
出力ドキュメントを指定するプロパティです。
Output Document
返されたドキュメントを保存する場所です。データタイプは
文書
です。
Assembler の例外
Assembler サービスでは、スローされる例外イベントに対して次の例外が発生します。
|
|
|