LiveCycle ES2 Services

bc
LiveCycle® ES2.5 サービス
Adobe® LiveCycle® ES2.5
2010 年 9 月 24 日
バージョン 9.5
© 2010 Adobe Systems Incorporated and its licensors. All rights reserved.
Adobe® LiveCycle® ES2.5 サービス
2010 年 9 月 24 日
This reference document is licensed for use under the terms of the Creative Commons Attribution NonCommercial 3.0 License. This License allows users to copy, distribute, and transmit the document for
noncommercial purposes only so long as (1) proper attribution to Adobe is given as the owner of the document;
and (2) any reuse or distribution of the document contains a notice that use of the document is governed by these
terms. The best way to provide notice is to include the following link. To view a copy of this license, visit
http://creativecommons.org/licenses/by-nc-sa/3.0/.
Adobe, the Adobe logo, Adobe Reader, Acrobat, Distiller, Flash, Flex Builder, FrameMaker, LiveCycle, PageMaker,
Photoshop, and PostScript are either registered trademarks or trademarks of Adobe Systems Incorporated in the
United States and/or other countries. EMC and Documentum are registered trademarks of EMC Corporation in
the United States and around the world. Copyright 1994-2007 EMC Corporation, all rights reserved. IBM and AIX
are trademarks of International Business Machines Corporation in the United States, other countries, or both. Red
Hat is a trademark or registered trademark of Red Hat, Inc. in the United States and other countries. Linux is the
registered trademark of Linus Torvalds in the U.S. and other countries. Mac OS is a trademark of Apple Inc.,
registered in the United States and other countries. Microsoft, OpenType, SharePoint, Windows, and Windows
Server are either registered trademarks or trademarks of Microsoft Corporation in the United States and/or other
countries. Oracle, Sun, Solaris, and Java are trademarks or registered trademarks of Oracle and/or its affiliates.
UNIX is a registered trademark of The Open Group in the US and other countries. All other trademarks are the
property of their respective owners.
Adobe Systems Incorporated, 345 Park Avenue, San Jose, California 95110, USA.
3
目次
このドキュメントの内容
このドキュメントの内容
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
このドキュメントの対象読者
関連情報
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .7
1. LiveCycle ES2.5 のサービスの概要
モジュールに属するサービスの確認 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
開発者によるサービスの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
管理者によるサービスの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .8
2. Assembler サービス
DDX について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .9
Assembler サービスの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Assembler サービスに関する考慮事項
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 18
3. Barcoded Forms サービス
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
サービスの使用
サービスに関する考慮事項
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
4. ECM 用のコネクタサービス
ECM コネクタサービスの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
5. Central Migration Bridge サービス
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
サービスの使用
このサービスに関する考慮事項
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
6. Convert PDF サービス
Convert PDF サービスの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
7. Decision Point サービス
Decision Point サービスの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30
8. Distiller サービス
Distiller サービスの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
PDFG ネットワークプリンタを使用した Distiller の呼び出し
9. DocConverter サービス
DocConverter サービスの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 32
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
4
10. Document Management サービス
Document Management サービスの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35
LiveCycle Contentspace ES2.5 の考慮事項
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
11. Email サービス
Email サービスの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
12. Encryption サービス
Encryption サービスの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
Encryption サービスに関する考慮事項
13. Execute Script サービス
Execute Script サービスの使用
14. FTP サービス
FTP サービスの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
FTP サービスに関する考慮事項
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
15. File Utilities サービス
File Utilities サービスの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
File Utilities サービスに関する考慮事項
16. Form Augmenter サービス
Form Augmenter サービスの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
17. Form Data Integration サービス
Form Data Integration サービスの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
18. Forms サービス
フォームの種類について
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
Forms サービスの要求処理
Forms サービスの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 48
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 53
Forms サービスのオプション . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 55
Forms サービスに関する考慮事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
19. Generate PDF サービス
Generate PDF サービスの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 69
変換ジョブの Generate PDF サービスへの送信
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 72
Generate PDF サービスのシステム準備設定の検証 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 73
20. Generate 3D PDF サービス
Generate 3D PDF サービスの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 75
Generate 3D PDF サービスの呼び出し
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 77
5
21. JDBC サービス
JDBC サービスの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
JDBC サービスに関する考慮事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
22. JMS サービス
JMS サービスの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
JMS サービスに関する考慮事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
23. LCCPLM サービス
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 80
サービスの使用
サービスに関する考慮事項
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
24. LDAP サービス
LDAP サービスの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
LDAP サービスに関する考慮事項
25. Output サービス
Output サービスの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 85
Output サービスに関する考慮事項
26. PDF Utilities サービス
PDF Utilities サービスの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 94
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 103
27. Reader Extensions サービス
Reader Extensions サービスの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
Reader Extensions サービスに関する考慮事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 107
28. Repository サービス
Repository サービスの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 109
29. Rights Management サービス
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
ポリシーについて
ポリシーセットについて
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
セキュリティ方法およびテクノロジ
Rights Management サービスの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 116
Rights Management サービスに関する考慮事項 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 119
30. Set Value サービス
Set Value サービスの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 120
6
31. Signature サービス
電子署名について . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 121
署名フィールドについて
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
Signature サービスとフォームの種類について
電子署名テクノロジについて
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 123
セキュリティインフラストラクチャとの統合
サポートされるテクノロジおよび標準
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
Signature サービスの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 125
ベストプラクティス
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
32. Stall サービス
Stall サービスの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
33. User サービス
User サービスの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
タスクの操作
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 132
34. Variable Logger サービス
Variable Logger サービスの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
35. Wait Point サービス
Wait Point サービスの使用
36. Web Service サービス
Web Service サービスの使用
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 135
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
37. XMP Utilities サービス
XMP メタデータについて . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
PDF ドキュメントのメタデータについて
. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
XMP Utilities サービスの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
38. \XSLT Transformation サービス
XSLT Transformation サービスの使用 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
7
このドキュメントの内容
このドキュメントでは、開発者が Adobe® LiveCycle® ES2.5 アプリケーションを作成するために使用できるサービスについて説明します。
このドキュメントの内容
このドキュメントでは、LiveCycle ES2.5 のサービスの入門情報について説明します。また、これらのサービスを使用して、ビジネスプロセスの一環と
して様々なタスクを遂行するための方法についても説明します。また、サービスとアプリケーションの管理に関する情報も含まれています。
このドキュメントの対象読者
このドキュメントは、主に Adobe LiveCycle Workbench のプロセスをデザインする担当者を対象に書かれています。対象読者は、サービスをプログラ
ムで対話的に操作するクライアントアプリケーションを構築する開発者です。さらに、LiveCycle ES2.5 サーバーとアプリケーションを管理する管理者
にとって興味深い情報も含まれています。
関連情報
サービスの詳細情報については、このドキュメントのほか、以下の表の資料を参考にしてください。
情報
参照先
LiveCycle ES2.5 モジュール
LiveCycle ES2.5 の概要
各 LiveCycle ES2.5 モジュールでの使用がライセンスされて
いるプログラミングインターフェイス
『LiveCycle ES2.5 モジュールのプログラミングインターフェイス』
プロセスマップでのサービスの使用
LiveCycle Workbench 9.5 ヘルプ
サービスの API の使用
Programming with LiveCycle ES2.5
サービスの管理
LiveCycle ES2.5 管理ヘルプ
8
1. LiveCycle ES2.5 のサービスの概要
LiveCycle ES2.5 の各モジュールは、様々なサービスを使用して、ビジネスプロセスの一部として様々なタスクを実現します。このガイドでは、開発者
およびプログラマが LiveCycle ES2.5 アプリケーションを作成するために使用できるサービスについて説明します。
モジュールに属するサービスの確認
各サービスは、実稼働環境において 1 つ以上の LiveCycle ES2.5 モジュールでの使用のためにライセンスされています。LiveCycle Foundation サービ
スは、すべての LiveCycle ES2.5 モジュールで使用できます。（『LiveCycle ES2.5 の概要』を参照）。
開発者によるサービスの使用
サービスまたはアプリケーションを LiveCycle ES2.5 内でデプロイすると、クライアントアプリケーションで様々なメカニズムを使用して呼び出すこと
ができます。LiveCycle 管理コンソールで、サービスが 1 つ以上のこれらのメカニズムを使用して公開されるように設定できます。
サービスは次のいずれかの方法で使用できます。
•
•
•
サービスを使用するプロセスを LiveCycle Workbench で開発します。
Java™ または公開済みの WSDL を使用できる環境（Microsoft® Visual Studio .NET など）で、サービスの API を使用するクライアントアプリケー
ションを開発します。ほとんどのサービスでは、公開 API が提供されます。
Adobe Flex® Builder™ で、LiveCycle Remoting を使用してサービスをインタラクティブに操作するクライアントアプリケーションを開発します。
ほとんどのサービスは、LiveCycle Remoting を使用して呼び出すことができます。
電子メールおよび監視フォルダを使用してサービスを呼び出すこともできます。また、一部のサービスでは、他のサービスを自動的に呼び出すことがで
きます。Assembler サービスは、処理対象の DDX ファイル内に他のサービスが指定されている場合、そのサービスを呼び出すことができます。
Generate PDF サービスは、PDFG ネットワークプリンタ機能で指定されている他のサービスを呼び出すことができます。
サービスをプログラムで呼び出す様々な方法について詳しくは、『Programming with LiveCycle ES2.5』の「Invoking LiveCycle ES2.5」を参照してく
ださい。
管理者によるサービスの使用
LiveCycle 管理コンソールでは、次のタスクを実行できます。
•
•
•
•
User Management を使用した、ユーザー、グループおよびサーバー認証の設定と管理
呼び出しエンドポイントの作成と管理、および LiveCycle ES2.5 アーカイブ（LCA）ファイルのデプロイ
プログラムを使用しないプロセスの呼び出しのための監視フォルダおよび電子メールプロバイダの設定
モジュールのプロパティおよびサーバー設定（ポート番号やログファイルなど）の管理
9
2. Assembler サービス
Assembler サービスを使用すると、PDF ドキュメントや XDP ドキュメントの結合、並べ替えおよび拡張を行ったり、PDF ドキュメントに関する情報
を取得できます。Assembler サービスに送信される各ジョブには、Document Description XML（DDX）ドキュメント、ソースドキュメントおよび外
部リソース（文字列とグラフィック）が含まれます。DDX ドキュメントには、ソースドキュメントを使用して 1 組の結果ドキュメントを生成する方法に
ついての指示が記述されています。
DDX について
Assembler サービスを使用する場合、Document Description XML（DDX）と呼ばれる XML ベースの言語を使用して必要な出力について記述しま
す。DDX は、その要素がドキュメントの構築ブロックを表す宣言型のマークアップ言語です。この構築ブロックには、PDF ドキュメント、XDP ドキュ
メント、XDP フォームのフラグメントおよびその他の要素（注釈、しおり、スタイルを設定したテキストなど）が含まれます。
DDX ドキュメントは、次のような特性を持つ結果ドキュメントを指定できます。
•
•
•
•
•
•
•
複数の PDF ドキュメントを結合した PDF ドキュメント
1 つの PDF ドキュメントから分割された複数の PDF ドキュメント
独立したユーザーインターフェイス、複数の PDF および非 PDF ドキュメントを含む PDF ポートフォリオ
複数の XDP ドキュメントを結合した XDP ドキュメント
XDP ドキュメントに動的に挿入される XML フラグメントを含む XDP ドキュメント
XDP ドキュメントをパッケージ化する PDF ドキュメント
PDF ドキュメントの特性を報告する XML ファイル。報告される特性は、テキスト、注釈、フォームデータ、添付ファイル、PDF ポートフォリオに
使用されるファイル、しおり、PDF プロパティなどです。PDF プロパティとは、フォームプロパティ、ページの回転、ドキュメントの作成者などを
指します。
DDX を使用すると、ドキュメントのアセンブリまたはディスアセンブリの一部として PDF ドキュメントを拡張できます。次の操作を任意に組み合わせ
ることができます。
•
•
•
•
•
•
•
•
•
•
•
選択したページへの透かしまたは背景の追加または削除。
選択したページへのヘッダとフッタの追加または削除。
PDF パッケージまたは PDF ポートフォリオの構造およびナビゲーション機能の削除。この操作により単一の PDF ファイルが生成されます。
ページラベルの再ナンバリング。ページラベルは通常ページナンバリングに使用されます。
別のソースドキュメントからのメタデータのインポート。
添付ファイル、しおり、リンク、コメントおよび JavaScript の追加または削除。
初期ビューの特性の設定と、Web 上で表示する際の最適化。
暗号化された PDF に対する権限の設定。
ページの回転またはページ上のコンテンツの回転およびシフト。
選択したページのサイズの変更。
XFA ベースの PDF とのデータの統合。
単純な入力マップを使用して、ソースドキュメントと結果ドキュメントの場所を指定できます。次の外部データ URL タイプも使用できます。
•
•
•
•
•
アプリケーション
Contentspace
ファイル
FTP
HTTP/HTTPS
ADOBE LIVECYCLE ES2.5
Assembler サービス
•
•
•
10
LiveCycle ES2.5 サービス
Inputmap
プロセス
リポジトリ（Assembler サービスでの使用は推奨しません）
DDX について詳しくは、Assembler Service and DDX Reference を参照してください。
Assembler サービスの使用
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 を参照してください。プログラムによってこのサービスとやり取
りできるクライアントアプリケーションの作成について詳しくは、『Programming with LiveCycle ES2.5』を参照してください。
PDF ドキュメントのアセンブリ
Assembler サービスを使用すると、複数の PDF ドキュメントを 1 つの PDF ドキュメントまたは PDF ポートフォリオにアセンブリできます。また、ナ
ビゲーションを支援したりセキュリティを強化する機能を PDF ドキュメントに適用することもできます。PDF ドキュメントをアセンブリする方法には、
次のようなものがあります。
•
•
•
•
•
「単一 PDF ドキュメントのアセンブリ」(10 ページ )
「PDF ポートフォリオの作成」(11 ページ )
「暗号化ドキュメントのアセンブリ」(11 ページ )
「ベイツナンバリングを使用したドキュメントのアセンブリ」(11 ページ )
「ドキュメントの統合およびアセンブリ」(12 ページ )
単一 PDF ドキュメントのアセンブリ
次の図は、3 つのソースドキュメントが 1 つの結果ドキュメントに統合されることを示しています。
ADOBE LIVECYCLE ES2.5
Assembler サービス
11
LiveCycle ES2.5 サービス
以下に、このドキュメントのアセンブリに使用される簡単な DDX ドキュメントの例を示します。この例では、結果ドキュメントの名前と共に、結果ド
キュメントの生成に使用するソースドキュメントの名前も指定しています。
<PDF result="Doc4">
<PDF source="Doc1"/>
<PDF source="Doc2"/>
<PDF source="Doc3"/>
</PDF>
ドキュメントのアセンブリは、以下のコンテンツと特性を備えた結果ドキュメントを生成します。
•
•
•
•
各ソースドキュメントのすべてまたは一部。
アセンブリによる結果ドキュメントに対して正規化される、各ソースドキュメントのしおりのすべてまたは一部。
メタデータ、ページラベル、ページサイズなどのベースドキュメント（Doc1）から採用したその他の特性。
オプションで、結果ドキュメントに結果内のしおりから構築される目次を含めることができます。
PDF ポートフォリオの作成
Assembler サービスでは、複数のドキュメントおよび独立したユーザーインターフェイスを含む PDF ポートフォリオを作成できます。このインターフェ
イスは、PDF ポートフォリオレイアウトまたは PDF ポートフォリオナビゲータ（ナビゲータ）と呼ばれています。PDF ポートフォリオは、ナビゲー
タ、フォルダ、およびようこそページを追加することによって、PDF パッケージの機能を拡張します。このインターフェイスは、ローカライズされたテ
キスト文字列、カスタムカラースキーマ、およびグラフィックリソースを利用して、ユーザーエクスペリエンスを拡張できます。PDF ポートフォリオに
は、ポートフォリオ内のファイルを整理するためのフォルダも含まれています。
Assembler サービスでは、以下の DDX ドキュメントを解釈した結果、PDF ポートフォリオナビゲータとパッケージ（2 つのファイルを含む）で構成さ
れる PDF ポートフォリオをアセンブリします。ナビゲータは、 myNavigator ソースで指定された場所から取得されます。ナビゲータのデフォルトカ
ラースキームは、 pinkScheme カラースキームに変更されます。
<DDX xmlns="http://ns.adobe.com/DDX/1.0/">
<PDF result="Untitled 1">
<Portfolio>
<Navigator source="myNavigator"/>
<ColorScheme scheme="pinkScheme"/>
</Portfolio>
<PackageFiles>
<PDF source="sourcePDF1"/>
<PDF source="sourcePDF2"/>
</PackageFiles>
</PDF>
</DDX>
暗号化ドキュメントのアセンブリ
ドキュメントをアセンブリする場合、PDF ドキュメントをパスワードで暗号化することもできます。PDF ドキュメントがパスワードで暗号化された場
合、ユーザーが Adobe Reader または Acrobat で PDF ドキュメントを表示するには、パスワードを指定する必要があります。PDF ドキュメントをパス
ワードで暗号化するには、PDF ドキュメントの暗号化に必要な暗号化エレメントの値を DDX ドキュメントに含める必要があります。
PDF ドキュメントをパスワードで暗号化するために LiveCycle ES2 のインストールに Encryption サービスを含める必要はありません。
1 つ以上の入力ドキュメントが暗号化されている場合、ドキュメントを開くためのパスワードを DDX の一部として指定する必要があります。
ベイツナンバリングを使用したドキュメントのアセンブリ
ドキュメントをアセンブリする場合、ベイツナンバリングを使用して各ページに一意のページ識別子を適用することができます。ベイツナンバリングを
使用すると、ドキュメント（またはドキュメントセット）内の各ページに、ページを一意に識別する数字が割り当てられます。例えば、原材料情報を含
む、1 つの組立部品の製造に関する生産ドキュメントに、1 つの識別子が割り当てられます。ベイツナンバリングの数値は連続した増分値で、オプション
でプレフィックスやサフィックスが付きます。「プレフィックス + 数値 + サフィックス」の形式は、ベイツパターンと呼ばれます。
ADOBE LIVECYCLE ES2.5
Assembler サービス
12
LiveCycle ES2.5 サービス
次の例は、ドキュメントのヘッダに一意の識別子を含む PDF ドキュメントを示しています。
ドキュメントの統合およびアセンブリ
Assembler サービスを使用して、インタラクティブ PDF ドキュメント（フォームなど）を非インタラクティブ PDF（PDF ドキュメント）に変換でき
ます。インタラクティブ PDF ドキュメントでは、ユーザーは PDF ドキュメントフィールド内のデータを入力または変更できます。インタラクティブ
PDF ドキュメントを非インタラクティブ PDF ドキュメントに変換するプロセスは「統合」と呼ばれます。PDF ドキュメントを統合すると、フォーム
フィールドのグラフィック表示は残されますが、インタラクティブではなくなります。PDF ドキュメントを統合する理由の 1 つは、データを変更できな
いようにするためです。また、フィールドに関連付けられたスクリプトも動作しなくなります。
インタラクティブ PDF ドキュメントからアセンブリして PDF を作成する場合に、Assembler サービスはこれらのフォームを統合してから結果ドキュメ
ントにアセンブリします。
注意 : Assembler サービスは、Output サービスを使用して動的 XFA フォームを統合します。XFA 動的フォームの統合を要求する DDX を Assembler
サービスが処理する場合に Output サービスを使用できないと、例外が発生します。Assembler サービスは、Output サービスを使用せずに Acrobat
フォームまたは静的 XFA フォームを統合できます。
XDP ドキュメントのアセンブリ
Assembler サービスを使用すると、複数の XDP ドキュメントを 1 つの XDP または PDF ドキュメントにアセンブリできます。ソース XDP ファイルに
挿入ポイントがある場合は、フラグメントを挿入する位置を指定できます。XDP ドキュメントをアセンブリする方法には、次のようなものがあります。
•
•
•
「単一の XDP ドキュメントのアセンブリ」(13 ページ )
「フォームフラグメントの XFA フォームへの動的な挿入」(13 ページ )
「XDP ドキュメントの PDF へのパッケージ化」(14 ページ )
ADOBE LIVECYCLE ES2.5
Assembler サービス
13
LiveCycle ES2.5 サービス
単一の XDP ドキュメントのアセンブリ
次の図は、3 つの XDP ソースドキュメントが 1 つの結果 XDP ドキュメントにアセンブリされることを示しています。結果 XDP ドキュメントには、3
つのソース XDP ドキュメントと関連データが含まれます。結果ドキュメントには、ベースドキュメント（最初のソース XDP ドキュメント）から基本属
性が受け継がれます。
以下は、前記の結果が生成される DDX ドキュメントです。
<DDX xmlns="http://ns.adobe.com/DDX/1.0/">
<XDP result="MyXDPResult">
<XDP source="sourceXDP1"/>
<XDP source="sourceXDP2"/>
<XDP source="sourceXDP3"/>
</XDP>
</DDX>
フォームフラグメントの XFA フォームへの動的な挿入
Assembler サービスを使用して、フラグメントが挿入される別の XFA フォームから XFA フォームを作成できます。この機能を使うと、フラグメントを
使用して複数のフォームを作成できます。
フォームフラグメントの動的挿入機能は、ソース管理の一元化をサポートします。共通して使用されるコンポーネントのソースを 1 つに維持できます。例
えば、自社のシンボルマークを表すフラグメントを作成したとします。マークを変更した場合、変更が必要なのはこのフラグメントだけです。フラグメン
トを含むフォームは変更不要です。
開発者は、Designer ES2.5 を使用してフォームフラグメントを作成します。このようなフラグメントは、XFA フォーム内では一意の名前を持つサブ
フォームとなります。また、一意の名前を持つ挿入ポイントを含む XFA フォームを作成する場合も、Designer ES2.5 を使用します。プログラマは、フ
ラグメントを XFA フォームに挿入する方法を指定する DDX ドキュメントを作成します。
ADOBE LIVECYCLE ES2.5
Assembler サービス
14
LiveCycle ES2.5 サービス
次の図に、2 つの XML フォーム（XFA テンプレート）を示します。左側のフォームには、 myInsertionPoint という挿入ポイントがあります。右側
のフォームには、 myFragment というフラグメントがあります。
Assembler サービスは、以下の DDX ドキュメントを解釈して、別の XML フォームを含む XML フォームを作成します。myFragmentSource ドキュ
メントの myFragment サブフォームは、 myFormSource ドキュメントの myInsertionPoint に挿入します。
<DDX xmlns="http://ns.adobe.com/DDX/1.0/">
<XDP result="myFormResult">
<XDP source="myFormSource">
<XDPContent fragment="myFragment" insertionPoint="myInsertionPoint" source="myFragmentSource"/>
</XDP>
</XDP>
</DDX>
XDP ドキュメントの PDF へのパッケージ化
以下の DDX ドキュメントのように、Assembler サービスを使用して、XDP ドキュメントを PDF ドキュメントとしてパッケージ化できます。
<DDX xmlns="http://ns.adobe.com/DDX/1.0/">
<PDF result="Untitled 1" encryption="passEncProfile1">
<XDP>
<XDP source="sourceXDP3"/>
<XDP source="sourceXDP4"/>
</XDP>
</PDF>
</DDX>
PDF ドキュメントのディスアセンブリ
Assembler サービスを使用して PDF ドキュメントをディスアセンブリできます。ソースドキュメントからページを抽出したり、しおりの位置を境にソー
スドキュメントを分割できます。このタスクは、一般的に、PDF ドキュメントが最初に多数の個別ドキュメント（明細書一式など）から作成された場合
に役立ちます。
ADOBE LIVECYCLE ES2.5
Assembler サービス
LiveCycle ES2.5 サービス
ソースドキュメントからのページの抽出
次の図で、ページ 1 ∼ 3 は、ソースドキュメントから抽出されて、新しい結果ドキュメントに配置されています。
ソース ドキュメント
Doc2
ページ 1-100
結果 ドキュメント
Doc4
ページ 1-3
次に、このドキュメントのディスアセンブリに使用される DDX ドキュメントの例を示します。
<PDF result="Doc4">
<PDF source="Doc2" pages="1-3"/>
</PDF>
しおりに基づいたソースドキュメントの分割
次の図は、DocA を複数の結果ドキュメントに分割する例です。ページで最初に表示されるレベル 1 のしおりが、新しい結果ドキュメントの開始位置を
示します。
ソース ドキュメント
DocA
結果 ドキュメント
A.000001.Bkmk1.pdf
A.000002.Bkmk2.pdf
A.000003.Bkmk3.pdf
15
ADOBE LIVECYCLE ES2.5
Assembler サービス
16
LiveCycle ES2.5 サービス
次に、しおりを使用してソースドキュメントをディスアセンブリする DDX ドキュメントの例を示します。
<PDFsFromBookmarks prefix="A">
<PDF source="DocA"/>
</PDFsFromBookmarks>
ドキュメントが PDF/A に準拠しているかどうかの検証
Assembler サービスを使用すると、PDF ドキュメントが PDF/A に準拠しているかどうかを検証することができます。PDF/A は、ドキュメントのコン
テンツを長期間保存するためのアーカイブ形式です。フォントがドキュメント内に埋め込まれ、ファイルは圧縮されません。その結果、PDF/A ドキュメ
ントは通常標準の PDF ドキュメントよりも大きくなります。また、PDF/A ドキュメントには、オーディオおよびビデオコンテンツは含まれません。
PDF/A-1 仕様には、A および B の 2 つの準拠レベルがあります。両者の大きな違いは、論理構造（アクセシビリティ）のサポートに関するもので、準
拠レベル A ではこのサポートが必須となりますが、準拠レベル B ではこのサポートは不要です。現在、PDF/A-1b でのみ検証（および変換）がサポート
されています。
PDF ドキュメントに関する情報の取得
Assembler サービスを使用して、次の PDF 情報を取得できます。
•
テキスト情報
•
•
•
ドキュメントの各ページの単語
ドキュメントの各ページの単語の位置
ドキュメントの各ページの段落の文節
•
しおりに関する情報（ページ番号、タイトル、設定先、外観など）。このデータを元の PDF ドキュメントから書き出し、別の PDF ドキュメントに読
•
添付ファイル情報（ファイル情報を含む）。ページレベルの添付ファイルの場合は、添付ファイル注釈の場所もこの情報に含まれます。このデータを
•
パッケージファイル情報（ファイル情報、フォルダ、パッケージ、スキーマ、フィールドデータを含む）。このデータを元の PDF ドキュメントから
み込むことができます。
元の PDF ドキュメントから書き出し、別の PDF ドキュメントに読み込むことができます。
書き出し、別の PDF ドキュメントに読み込むことができます。
DDX ドキュメントの検証
Assembler サービスを使用すると、DDX ドキュメントが有効かどうかを検証できます。例えば、LiveCycle を以前のバージョンからアップグレードし
た後、検証によって DDX ドキュメントが有効であることが確認されます。
その他の LiveCycle ES2.5 サービスの呼び出し
DDX ドキュメントを使用して、Assembler サービスで次の LiveCycle ES2.5 サービスを呼び出すことができます。Assembler サービスが呼び出せるの
は、LiveCycle と一緒にインストールされる次のサービスだけです。
Reader Extensions サービス： Adobe Reader ユーザーは、結果 PDF ドキュメントに電子署名を行うことができます。
Forms サービス： XDP ファイルと XML データファイルを統合して、データを埋め込んだインタラクティブフォームを含む PDF ドキュメントを作成
することができます。
Output サービス： 動的な XML フォームを、非インタラクティブフォームを含む PDF ドキュメントに変換（フォームを統合）します （Assembler
サービスは、Output サービスを呼び出さずに、静的な XML フォームと Acrobat フォームを統合します）。
DocConverter サービス： PDF ドキュメントを PDF/A ドキュメントに変換します。
Generate PDF サービス： ネイティブファイル形式から PDF への変換 ネイティブファイル形式の例として、Word、Excel および HTML があります。
Generate 3D PDF サービス： CAD ファイル形式から PDF への変換
Distiller サービス： PostScript ドキュメントを PDF ドキュメントに変換します。
ADOBE LIVECYCLE ES2.5
Assembler サービス
17
LiveCycle ES2.5 サービス
DDX ファイルを使用して、結果 PDF ドキュメントの特性を指定できます。DDX ファイルは、LiveCycle ES2.5 サービスの明示的な呼び出しを行いま
せん。Assembler サービスは、特定の DDX エレメントを解釈して、DDX ドキュメントに指定された結果を達成するために、他の LiveCycle ES2.5
サービスを呼び出すかどうかを判断します。例えば、Assembler サービスが、PDF ではないファイルを指定する PDF ソースファイルを解釈する場合、
Generate PDF サービスを呼び出して、そのファイルを PDF に変換します。Assembler サービスが、XML フォーム（XFA フォーム）を含む PDF ソー
スファイルおよび別個に存在する XML フォームデータを解釈する場合は、Forms サービスを呼び出して、データを XML フォームに統合します。
次の DDX の例では、2 つの PDF ドキュメントを統合し、Adobe Reader ユーザーが統合後の PDF ドキュメントに電子署名できるようにします。PDF
result エレメント内の ReaderRights エレメントで、Adobe Reader の使用権限を有効にします。
<?xml version="1.0" encoding="UTF-8"?>
<DDX xmlns="http://ns.adobe.com/DDX/1.0/">
<PDF result=”outDoc”>
<PDF source=”doc1”/>
<PDF source=”doc2”/>
<ReaderRights
credentialAlias="LCESCred"
digitalSignatures=”true”/>
</PDF>
</DDX>
DDX と Assembler サービスを使用して他の LiveCycle ES2.5 サービスを呼び出すことで、プロセスダイアグラムを単純なものにできます。これにより、
ワークフローをカスタマイズする手間を省くこともできます （『Assembler Service and DDX Reference』も参照）。
Assembler IVS を使用した DDX ドキュメントの検証
Assembler IVS（Assembler Installation and Verification Sample）は、LiveCycle Workbench プロセスを変更せずに、DDX ドキュメントを検証
するためのサンプルアプリケーションです。Assembler IVS に備えられたエディタを使用して、DDX ドキュメントを（XML 形式で）作成および編集
し、DDX ドキュメントに記述された結果のプレビューを作成することができます。また、Assembler IVS には、様々な DDX コンセプトを示す次の例
が含まれています。
•
•
•
•
•
ドキュメントのアセンブリ
ブックマークおよびページでのドキュメントのディスアセンブリ
PDF ドキュメントの PDF/A への変換
PDF パッケージの作成
PDF ドキュメントからのメタデータまたはコンテンツの取得
Assembler IVS は、Assembler サービスの Invoke DDX サービスを使用します。
注意 : Workbench の Workbench Document Builder パースペクティブは、DDX ドキュメントを作成およびテストするのに最適です。Workbench
Document Builder の直感的なユーザーインターフェイスで、DDX ドキュメントを作成します。Workbench Document Builder では、XML で直接作
業せずに、DDX ドキュメントを作成および検証することができます。
Assembler IVS を使用するには、それをデプロイする必要があります。管理者は LiveCycle Configuration Manager を使用して Assembler IVS をデプ
ロイすることができます。また、Assembler IVS は、手動でデプロイすることもできます。詳しくは、『LiveCycle ES2 のインストールおよびデプロイ
（JBoss 版）』など、LiveCycle のインストールドキュメントを参照してください。
Assembler IVS アプリケーションを開始するには、http://[server_name:port_number]/Assembler に移動します。
ADOBE LIVECYCLE ES2.5
Assembler サービス
18
LiveCycle ES2.5 サービス
Assembler IVS は、次のようなユーザーインターフェイスを備えています。
DDX ドキュメントの一般的な検証手順は次のとおりです。
1
検証する DDX ドキュメントをコピーして、大きなウィンドウに貼り付けます。または、ウィンドウの上部にある「DDX」または「Demo」をク
リックして、検証に使用可能な DDX ドキュメントの 1 つを選択します。
2
Collateral パネルの上部にあるプラス記号（+）ボタンをクリックして、入力ファイルを指定します。インターフェイスに、ファイルの検索フィール
ドが表示されます。コラテラルとして使用するファイルを追加するたびに、このボタンをクリックします。
3
Input Map パネルの上部にあるプラス記号（+）ボタンをクリックして、入力マップを指定します。必要に応じて、DDX ドキュメントのソース名と
一致するように、マップエントリの名前を編集します。ドキュメントマップにエントリを追加するたびに、このボタンをクリックします。
4
入力ファイルをマップエントリの 1 つにドラッグして、ファイルを入力マップエントリと関連付けます。1 つのサンプル入力ファイルを複数の入力
マップエントリに割り当てることができます。また、複数の入力ファイルを 1 つの入力マップエントリに割り当てることもできます。
5 「Invoke」をクリックして、Assembler IVS を呼び出します。
Assembler IVS による PDF ドキュメントの作成が成功すると、新しいブラウザウィンドウが開き、作成された PDF ドキュメントが表示されます。失敗
した場合は、エラーメッセージが表示されます。
Assembler サービスに関する考慮事項
大きな PDF ドキュメントのアセンブルとコンテンツ適用には大量のメモリが消費されるため、Assembler サービスがメモリ不足（OOM）例外により
終了することがあります。操作チェックポイントを使用して、この例外の発生を回避できます。『Assembler Service and DDX Reference』を参照してく
ださい。
19
3. Barcoded Forms サービス
Barcoded Forms サービスは、バーコードの電子画像からデータを抽出するサービスです。このサービスでは、少なくとも 1 つのバーコードを含んだ
TIFF ファイルおよび PDF ファイルを入力として受け取り、バーコードデータを抽出します。バーコードデータは、XML、区切られた文字列、
JavaScript で作成されたカスタム形式など様々な形式でフォーマットされます。
Barcoded Forms サービスは、スキャンされた TIFF または PDF ドキュメントとして提供される以下の二次元コードをサポートします。
•
•
•
PDF417
Data Matrix
QR コード
また、スキャンされた TIFF または PDF ドキュメントとして提供される以下の一次元コードをサポートします。
•
•
•
•
•
Codabar
Code128
Code 3 of 9
EAN13
EAN8
注意 : Barcoded Forms サービスの使用時には、 次の制限について考慮する必要があります。
•
このサービスは、Adobe Reader または Acrobat を使用して保存された、AcroForms および 2D バーコードを含む静的フォームを完全にサ
ポートします。ただし、1D バーコードの場合は、フォームを統合するか、フォームを変換してスキャンされた PDF または TIFF ドキュメント
として提供する必要があります。
•
動的 XFA フォームは完全にサポートされているわけではありません。サービスで 1D および 2D バーコードを動的フォームに正しくデコードす
るには、フォームを統合するか、フォームを変換してスキャンされた PDF または TIFF ドキュメントとして提供する必要があります。
また、バーコードは、必ずしもフォームから生成されている必要はありません。サービスは、前記の制限事項に触れない限り、サポートされているコー
ドが使用されていれば、どのようなバーコードでもデコードできます。
インタラクティブなバーコードフォームを作成する方法については、LiveCycle Designer ES2.5 のヘルプを参照してください。
サービスの使用
Barcoded Forms サービスを使用して次のタスクを実行できます。
•
•
バーコード画像（TIFF または PDF）からバーコードデータを抽出します。このデータは、区切り文字付きテキストとして保存されます。
区切り文字付きテキストデータを XML（XDP または XFDF）に変換します。XML データには、区切り文字付きテキストと比べ、解析がしやすい
という特徴があります。また、XDP 形式または XFDF 形式のデータは、他の LiveCycle ES2.5 サービスの入力として使用できます。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 のヘルプを参照してください。プログラムによってこのサービス
とやり取りできるクライアントアプリケーションの作成について詳しくは、『Programming with LiveCycle ES2.5』を参照してください。
LiveCycle 管理コンソールのアプリケーションおよびサービスのページを使用して、このサービスのデフォルトプロパティを設定できます （LiveCycle
ES2.5 の管理ヘルプの「Barcoded Forms サービスの設定」を参照）。
ADOBE LIVECYCLE ES2.5
Barcoded Forms サービス
20
LiveCycle ES2.5 サービス
Barcoded Forms サービスは、画像内のバーコードを特定し、それぞれのバーコードをデコードして、データを抽出します。バーコードデータは、（必
要に応じてエンティティエンコードを使用して）XML ドキュメントの content エレメントとして返されます。例えば、次の図は、2 つのバーコードを
含んだフォームをスキャンした TIFF 画像です。
ADOBE LIVECYCLE ES2.5
Barcoded Forms サービス
LiveCycle ES2.5 サービス
Barcoded Forms サービスは、バーコードのデコード後、次の XML ドキュメントを返します。
<?xml version="1.0" encoding="UTF-8"?>
<xb:scanned_image xmlns:xb="http://decoder.barcodedforms.adobe.com/xmlbeans" path="tiff" version="1.0">
<xb:decode>
<xb:date>2007-05-11T15:07:49.965-04:00</xb:date>
<xb:host_name>myhost.adobe.com</xb:host_name>
<xb:status type="success">
<xb:message />
</xb:status>
</xb:decode>
<xb:barcode id="1">
<xb:header symbology="pdf417">
<xb:location page_no="1">
<xb:coordinates>
<xb:point x="0.119526625" y="0.60945123" />
<xb:point x="0.44457594" y="0.60945123" />
<xb:point x="0.44457594" y="0.78445125" />
<xb:point x="0.119526625" y="0.78445125" />
</xb:coordinates>
</xb:location>
</xb:header>
<xb:body>
<xb:content encoding="utf-8">t_SID t_FirstName t_MiddleName t_LastName t_nFirstName t_nMiddleName
t_nLastName 90210 Patti Y Penne Patti P Prosciutto</xb:content>
</xb:body>
</xb:barcode>
<xb:barcode id="2">
<xb:header symbology="pdf417">
<xb:location page_no="1">
<xb:coordinates>
<xb:point x="0.119526625" y="0.825" />
<xb:point x="0.44457594" y="0.825" />
<xb:point x="0.44457594" y="0.9167683" />
<xb:point x="0.119526625" y="0.9167683" />
</xb:coordinates>
</xb:location>
</xb:header>
<xb:body>
<xb:content encoding="utf-8">t_FormType t_FormVersion ChangeName 20061128</xb:content>
</xb:body>
</xb:barcode>
</xb:scanned_image>
21
ADOBE LIVECYCLE ES2.5
Barcoded Forms サービス
22
LiveCycle ES2.5 サービス
サービスに関する考慮事項
バーコードフォームを使用するワークフロー
フォーム作成者は、LiveCycle Designer ES2.5 を使用してインタラクティブなバーコードフォームを作成できます。
（LiveCycleDesigner ES2.5 のヘルプ
を参照）。ユーザーが Adobe Reader または Acrobat でバーコードフォームに入力すると、バーコードは自動的に更新され、フォームデータがエンコー
ドされます。
Barcoded Forms サービスは、紙面上のデータを電子的なフォーマットに移行させる場合に役立ちます。例えば、バーコードフォームに記入し、印刷し
た後、その印刷済みのコピーをスキャンすることで、Barcoded Forms サービスへの入力として使用できます。
通常、監視フォルダのエンドポイントは、Barcoded Forms サービスを使用したアプリケーションを呼び出すときに使用されます。例えば、バーコード
フォームの TIFF 画像または PDF 画像が、ドキュメントスキャナによって監視フォルダに保存されたとします。この画像が監視フォルダのエンドポイン
トからサービスに渡されてデコードされます。
推奨されるエンコードおよびデコードの形式
バーコードフォームを作成する場合、バーコードのデータをエンコードするときに単純な区切り形式（タブ区切りなど）を使用し、フィールド区切り文
字として改行を使用しないことをお勧めします。Designer ES2.5 では、区切られたデータのエンコード方法を選択できますが、選択した方法によって
は、バーコードをエンコードする JavaScript スクリプトが自動的に生成されます。この場合、デコードされたデータの 1 行目にはフィールド名が、2 行
目にはその値が設定されます。また、フィールドとフィールドの間にはタブが挿入されます。
バーコードのデコード時には、フィールドの区切りに使用する文字を指定します。デコード用に指定する文字は、バーコードのエンコーディングで使用
された文字と同じであることが必要です。例えば、フォームの作成時に、推奨されるタブ区切り形式が使用された場合、プロセス内の XML 抽出操作で
も、フィールド区切り文字にデフォルト値の Tab を使用する必要があります。
ユーザー指定の文字セット
フォームの作成者は、Designer ES2.5 を使用してバーコードオブジェクトをそのフォームに追加するときに、文字エンコードを指定できます。認識可能
なエンコードは、UTF-8、ISO-8859-1、ISO-8859-2、ISO-8859-7、Shift-JIS、KSC-5601、Big-Five、GB-2312、UTF-16 です。デフォルトでは、
バーコード内のすべてのデータが UTF-8 としてエンコードされます。
バーコードのデコード時には、使用する文字セットエンコーディングを指定できます。すべてのデータが正常にデコードされるようにするには、フォー
ムのデザイン時にフォームの作成者が指定した文字セットと同じ文字セットを指定してください。
23
4. ECM 用のコネクタサービス
Adobe LiveCycle ES2 Connector for EMC Documentum、Adobe LiveCycle ES2 Connector for IBM Content Manager、Adobe LiveCycle ES2
Connector for IBM FileNet、Adobe LiveCycle ES2.5 Connector for Microsoft SharePoint には、次のサービスがあります。
コンテンツリポジトリコネクタサービス： 以下のサービスは独立しており、LiveCycle ES2.5 プロセスで作成されるプロセス内の操作として使用できます。
•
•
•
•
Content Repository Connector for EMC Documentum
Content Repository Connector for IBM Content Manager
Content Repository Connector for IBM FileNet
Content Repository Connector for Microsoft SharePoint
LiveCycle Workbench の開発者は、プロセスでこれらのサービスを使用してコンテンツを保存し、ECM コンテンツリポジトリのカスタムコンテンツ
モデルからコンテンツを取得することができます。各コネクタサービスを使用して、コンテンツオブジェクトと、ECM コンテンツリポジトリに保存され
ているメタデータにアクセスできます。
Adobe LiveCycle ES2.5 Connector for Microsoft SharePoint をインストールした場合、SharePoint サイトユーザーによる LiveCycle プロセスの呼び
出しを有効にすることができます。例えば、SharePoint リポジトリのドキュメントを Adobe PDF 形式に変換する、Adobe PDF ドキュメントに追加の
使用権限を適用する、Adobe ポリシーでドキュメントを保護するなどのプロセスです。さらに、SharePoint ユーザーは、接続された LiveCycle サー
バーで利用可能なサービスを使用するワークフローを作成および開始することができます。
例えば、ある金融機関で、口座を開設するプロセスを自動化するとします。このプロセスでは、申込者がデジタル処理で申し込みフォームに署名でき、
入力済みのフォームが ECM リポジトリにアーカイブされ、申告書とその他の関連ドキュメントが取得され、これらのドキュメントが 1 つの PDF ファイ
ルにまとめられ、その PDF ファイルが申込者に電子メールで送付される必要があります。このプロセスのために金融機関が開発する LiveCycle ES2.5
アプリケーションには、コンテンツリポジトリコネクタサービス操作が含まれます。これらの操作は以下の用途に使用されます。
•
•
入力済みのフォームを、顧客が定義したコンテンツオブジェクトタイプで ECM リポジトリに保存します。
コンテンツを取得します。他の ECM アプリケーションから作成されたコンテンツも ECM リポジトリから集められたコンテンツも取得できます。
Process Engine Connector for IBM FileNet for IBM FileNet サービス： Workbench の開発者は、以下の用途に Process Engine Connector for IBM
FileNet サービスを使用できます。
•
•
IBM FileNet ワークフロー手順のパラメータの取得や設定を行うプロセスを作成します。
IBM FileNet のワークフロー手順を送出します。
実行時には、ビジネスプロセスの完了の一環として、ECM コンテンツリポジトリからアセットを取得できます。例えば、エンドユーザーは
Adobe LiveCycle Workspace ES2.5、EMC Documentum Webtop、IBM Content Manager クライアントまたは IBM FileNet P8 Workplace から
フォームにアクセスしたりフォームデータを送信したりできます。また、クライアントアプリケーションは自動化されたビジネスプロセスの一環として、
コンテンツの取得と保管を行うことができます。
コンテンツリポジトリコネクタサービスと Process Engine Connector for IBM FileNet について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照し
てください。
注意 : LiveCycle の以前のリリースでは、ECM リポジトリにアセットを格納できました。LiveCycle ES2.5 では、アセットが LiveCycle ES2.5 ネイティ
ブリポジトリに格納され、リポジトリプロバイダサービスは推奨されなくなりました。ECM リポジトリから LiveCycle ES2.5 リポジトリへのアセットの
移行は、LiveCycle ES2.5 への更新を実行するときに行われます。詳しくは、使用しているアプリケーションサーバー版の LiveCycle ES2.5 アップグ
レードドキュメントを参照してください。
ADOBE LIVECYCLE ES2.5
ECM 用のコネクタサービス
24
LiveCycle ES2.5 サービス
ECM コネクタサービスの使用
Workbench で（またはプログラムから Repository Service API を使用して）リソースビューから ECM にアクセスするには、管理者が適切な ECM リ
ポジトリサービスプロバイダを選択する必要があります。管理者は、LiveCycle ES2.5 のデフォルトを変更し、LiveCycle 管理コンソールでリポジトリ
サービスプロバイダを選択する必要があります。ECM コネクタサービスの設定について詳しくは、『LiveCycle ES2 のインストールおよびデプロイ
（JBoss 版）』など、LiveCycle ES2 関連のインストールドキュメントを参照してください。
Workbench の フォームデザイン パースペクティブを使用して、ECM コンテンツリポジトリにアクセスできます。デフォルトの Documentum のリポ
ジトリまたは FileNet のオブジェクトストアにログインします。また、Workbench にログインするときに Documentum または FileNet のリポジトリ
を指定できます。コンテンツリポジトリにアクセスするには、適切な秘密鍵証明書が付与されている必要があります。Workbench を使用するたびに、リ
ポジトリへの接続が作成されます。コンテンツリポジトリは、階層型のディレクトリ構造として Workbench のリソースビューに公開されます。
Workbench のリポジトリは別の開発者と共有できます。
注意 : Connector for EMC Documentum を使用して、Docbase ルートにドキュメントを作成することはできません。その代わりに、Docbase キャビ
ネットにドキュメントを作成します。これは、Documentum の制限によるものです。
リポジトリプロバイダサービスを使用したプロセスを開発するときには、ECM コンテンツリポジトリへのリソース URL を指定できます。この URL は、
Forms サービスなどのサービスに関連付けられたプロパティで指定します。Forms Service API を使用してリソース URL を指定することもできます。
注意 : Connector for IBM Content Manager では、現在リポジトリプロバイダサービスはサポートされていません。
Repository Service API を使用して ECM コンテンツリポジトリにアクセスし、プログラムを使用して情報の保存と取得を行うこともできます。例えば、
アプリケーションの処理の一環としてファイルが必要な場合、ECM コンテンツリポジトリに格納されているファイルのリストまたは特定のファイルを
取得できます。
プロセスでコンテンツリポジトリコネクタサービスを使用して、ECM コンテンツリポジトリのコンテンツオブジェクトとやり取りすることができます。
プロセスでこのサービスを使用するときには、以下のようなタスクを実行できます。
•
•
•
•
ユーザーが定義したコンテンツリポジトリ（リポジトリプロバイダで使用されるものとは別のリポジトリ）にアクセスします。
プロセスの後続の手順で別のサービスによって使用される可能性のあるコンテンツリポジトリからコンテンツとその属性を取得します。
プロセスの後続の手順で別のサービスによって作成されるコンテンツリポジトリのコンテンツとその属性を保存します。
使用可能なカスタムデータモデルのリストをコンテンツリポジトリから取得し、プロセス変数をコンテンツリポジトリのコンテンツ属性にマップし
ます。
•
（Adobe LiveCycle ES2 Connector for Microsoft SharePoint のみ）LiveCycle ES2.5 でサービスを使用する SharePoint ワークフローを作成およ
•
（LiveCycle ES2 Connector for Microsoft SharePoint のみ）ドキュメントを Adobe PDF 形式に変換し、使用権限を適用し、Adobe Reader の追
び開始します
加機能を有効にします。
LiveCycle ES2 Connector for Microsoft SharePoint には、以下の機能が用意されています。
•
•
•
•
•
•
•
SharePoint 内からの承認プロセスなど、LiveCycle ES2.5 プロセスを呼び出すことができます
ドキュメントを Adobe PDF に変換する機能と、PDF 形式またはネイティブ形式でファイルの権限を管理する機能
LiveCycle ES2.5 のサービスを使用する SharePoint ワークフローを作成し、開始する機能があります
ユーザーは PDF ファイルに使用権限を適用し、Adobe Reader の追加機能を可能にすることができます
SharePoint ワークフロー内から LiveCycle ES2.5 プロセスを自動実行することができます
SharePoint 2010 の内部から割り当て済み LiveCycle タスクを管理し、新しいタスクを要求できる機能
LiveCycle フォームを SharePoint Server 2010 と統合し、SharePoint をフォームデータのリポジトリとして効率的に使用できるようにする機能
これらのサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。プログラムによってこれらの
サービスとやり取りできるクライアントアプリケーションの作成について詳しくは、『Programming with LiveCycle ES2.5』を参照してください。
LiveCycle ES2.5 プロセスを呼び出し、LiveCycle ES2.5 アクションを実行するように SharePoint サイトを設定する方法について詳しくは、
『LiveCycle
ES2 のインストールおよびデプロイ（JBoss 版）』などの LiveCycle ES2 関連のインストールドキュメントを参照してください。
LiveCycle 管理コンソールを使用して、ECM コンテンツリポジトリへのデフォルトの接続を設定し、リポジトリサービスプロバイダを変更して、別の
ECM 固有のデフォルト設定を指定します （LiveCycle ES2.5 の管理ヘルプの「コンテンツ管理システムへの接続」を参照）。
25
5. Central Migration Bridge サービス
Central Migration Bridge サービスは、既存の Adobe Output Server クライアントから Adobe LiveCycle Output ES2.5 への移行に役立ちます。
Adobe Output Server ファミリ（Central）は、次の製品で構成されています。
•
•
•
•
Adobe Output Designer
Adobe Central Output Server
Adobe Central Pro Output Server
Adobe Web Output Pak
これらの製品は、LiveCycle
Output ES2.5 と同様の機能を備えていますが、円熟した Adobe テクノロジに基づいています。
Central Migration Bridge サービスを使用すると、Central Server の主要な機能を LiveCycle ES2.5 環境で使用できるようになります。これにより、
既存のアセット（MDF 出力テンプレートや TDF ファイルなど）を引き続き LiveCycle ES2.5 で使用することができます。
Central Migration Bridge サービスは、Output ES2.5 のすべてのユーザーのためのものではありません。このサービスは、Central Output Server を
導入済みで、LiveCycle ES2.5 へ移行するユーザーのためのサービスです。Central Migration Bridge サービスを使用するには、Central Pro Output
Server 5.7 の有効なライセンスを所有しているか、または Central Pro Output Server 5.7 移行契約を締結している必要があります。移行契約について
は、アドビの営業担当者にお問い合わせください。
サービスの使用
Central Migration Bridge サービスは、Adobe Central Pro Output Server の機能のサブセットを使用します。このサブセットは、Central Print
Agent、Central Transformation Agent および Central XML Import Agent と同等の機能を備えています。このサブセットにより、移行後も次の
Central アセットを使用できます。
•
•
•
•
•
テンプレートデザイン（*.ifd）
出力テンプレート（*.mdf）
Central の Field Nominated 形式を含む、データファイル（*.dat ファイル）
プリアンブルファイル（*.pre）
データ変換定義ファイル（*.tdf）
Central Migration Bridge サービスを使用するには、Central インストールディレクトリに対する適切なアクセス権が必要です。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。プログラムによってこのサービスと
やり取りできるクライアントアプリケーションの作成について詳しくは、『Programming with LiveCycle ES2.5』を参照してください。
Central Merge 操作
Central Merge 操作は、データを出力テンプレートに統合します。Central でサポートされる形式（IPL、ZPL、PDF、PS、または PCL）で統合結果を
返します。この操作では、外部プリアンブルファイルを使用できます。
例えば、名前、住所、請求書番号などの顧客情報を含む Field Nominated データファイルがあるとします。アプリケーションでは、Central Merge 操作
を使用してデータファイルと請求書出力テンプレートデザインを結合できます。その後で、以下の LiveCycle ES2.5 サービスを使用して、出力ファイル
の電子メール送信、ディスクへの保存または印刷を行うことができます。
•
•
•
Email サービス
File Utilities サービス
出力 サービスの sendToPriner 操作
ADOBE LIVECYCLE ES2.5
Central Migration Bridge サービス
26
LiveCycle ES2.5 サービス
主要な入力パラメータ（データファイルとテンプレート）に加え、この操作では、Central JFMERGE コマンドに渡されるコマンドラインオプションを
表す文字列を受け取ります。これらのオプションを使用して、現在の Central Job Management Database（JMD）で使用するすべての標準オプション
を指定できます。
Central Merge 操作では、トレースファイルを生成できます。この機能を有効にする場合は、トレースファイルオプションを指定します。このトレース
ファイルを使用して、生成されたドキュメントに全 n ページのページ 1 ナンバリング方式を実現するには、次のタスクを行います。
1
Central Merge を一度実行してトレースファイルを取得します。
2
このトレースファイルを Central Merge の二度目の実行時に渡して、ページナンバリングのフォーマットを作成します。
Central Merge 操作は、Central JFMERGE コマンド（Central Print Agent）を実行します。この操作では、Central Pro と同じ方法で jfmerge.ini
ファイルが使用されます。
Central Transformation 操作
Central Transformation 操作は、構造化されたテキストおよびオーバーレイテキストを使用可能なデータ形式に変換します。変換後のデータは、
Central Merge 操作で使用できます。Central Transformation 操作では、ASCII 形式（固定長、文字区切り、オーバーレイ、XML および Central 独
自の Field Nominated 形式など）で作成されたデータを変換します。変換後のデータは、XML または Field Nominated 形式になります。
また、スクリプト機能も用意されており、この機能を使用して既存のデータファイルに変更を加えることができます。スクリプト機能には、次のような
用途があります。
•
•
データを編集して、フォームデザインと統合できる形式に変更します。
既存のデータを変換します。例えば、MM-DD-YYYY 形式の日付データを DD-MM-YYYY 形式に変換します。
主要な入力パラメータ（データファイルと TDF ファイル）に加え、この操作では、Central JFTRANS コマンドに渡されるコマンドラインオプションを
表す文字列を受け取ります。
Central Transformation 操作は、Central JFTRANS コマンド（Central Transformation Agent）を実行します。この操作では、Central Pro と同じ
方法で jfmerge.ini ファイルが使用されます。
Central XML Import 操作
Central XML Import 操作では、整形式の XML データを Field Nominated 形式に変換します。
主要な入力パラメータ（XML ファイル）に加え、この操作では、Central XMLIMPORT コマンドに渡されるコマンドラインオプションを表す文字列
を受け取ります。
Central XML Import 操作は、Central XMLIMPORT コマンドを実行します。この操作では、Central Pro と同じ方法で xmlimport.ini ファイルが使
用されます。
Central Data Access 操作
Central Data Access 操作は、LiveCycle ES2.5 プロセス内の Field Nominated データファイル（DAT ファイル）に含まれる特定の要素にアクセスし
ます。この操作により、^field、^global、^form および ^job の各コマンドがデータファイルから抽出され、中間 XML ドキュメントに変換されます。
プロセスでは、XPath 式を使用して、この XML ファイル内の特定のエントリから値を取得できます。取得した値を処理の判断基準としたり、中間
XML ファイルを他の LiveCycle ES2.5 サービスに渡すことができます。
LiveCycle Workbench には、XPath 式を簡単に作成できる XPath Builder ダイアログボックスが用意されています。
注意 : Central Data Access 操作は、Field Nominated データファイルを同等の
間 XML 表現に変換します。
XML 表現に完全に変換できるわけではありません。特定の要素のみを中
ADOBE LIVECYCLE ES2.5
Central Migration Bridge サービス
27
LiveCycle ES2.5 サービス
Central Data Access 操作によって、既存の Central Pro アプリケーションを LiveCycle ES2.5 に統合する作業が簡単になります。この操作を使用して、
データファイルに含まれる特定の Field Nominated コマンドの値を確認する方法の例を以下に示します。
1
Central Data Access 操作を呼び出して、データファイルのコマンドを中間 XML 表現に変換します。
2
XPath 式を使用して、Field Nominated の ^job コマンドの値（ジョブ値）を取得します。
3
データに使用するテンプレートをジョブ値に基づいて決定します。
4
Central Merge 操作を呼び出して、選択したテンプレートを元のデータファイルと結合し、PDF ドキュメントを生成します。
5
XPath 式を使用して、^field EMAILADDRESS の値を中間 XML 表現から取得します。
6
Email サービスを呼び出して、PDF ファイルを電子メールでジョブの要求元に送信します。
Central Data Access 操作は、Central コマンドを実行しません。
このサービスに関する考慮事項
Central Migration Bridge サービスを使用すると、Adobe Output Server の既存のアセットおよび実装の各要素を段階的に移行できます。LiveCycle
ES2.5 と Central Migration Bridge とでは、Adobe Central Pro Output Server から返されるログ結果の扱い方が異なります。
移行
移行作業の大部分は、テンプレートのライブラリの移行と関連データソースの変更で占められます。Central Migration Bridge サービスを使用すること
で、アプリケーションを Central から
Output ES2.5 へ段階的に移行できます。
最初の段階： 呼び出しおよびランタイムに関する部分を Central 環境から
LiveCycle ES2.5 環境へ移行します。移行後も、既存の Central テンプレート
とデータアセットを使用できます。Central の Job Management Database（JMD）を使用している場合は、それを LiveCycle ES2.5 プロセスで置き換
えます。Output ES2.5 は JMD をサポートしないため、JMD を変換するツールは提供されません。
既存の Central テンプレートが Output Designer 5.7 以前のバージョンで保存されている場合は、そのまま使用できます。ただし、場合によっては（特
にバージョン 5.4 以前のテンプレートの場合）、Output Designer 5.7 を使用して、既存の Central テンプレートを移行する必要があります。テンプレー
トを Output Designer 5.7 で開いて保存すれば、テンプレートは自動的に移行されます。Output Designer 5.7 を使用して、移行後のテンプレートが正
常に動作するかどうかをテストすることができます。
以降の段階： さらに、テンプレートおよび非
XML データアセットを変換して、Output ES2.5 で使用できるようにします。同じ LiveCycle ES2.5 サー
バー上で、新しいプロセスと変換後のプロセスを同時に使用できます。さらに、すべてのアセットを変換すると、Central Migration Bridge サービスを
使用する必要はなくなります。
LiveCycle Designer ES2.5 を使用して、Output Designer テンプレートをインポートできます。この機能を有効にするには、Designer ES2.5 と共に
Output Designer をインストールします。この機能を使用するには、Adobe Output Designer テンプレート（*.ifd）形式のファイルを開きます。
Designer ES2.5 が基本的な変換を行います。変換後にフォームがどの程度再現できるかは、インポートするフォームの複雑さによって異なります。
Designer ES2.5 を使用して、変換プロセスを実行します（LiveCycle Designer ES2.5 のヘルプおよび Designing Forms for LiveCycle Output ES2 を参照）。
ログ結果
Central で生成されたログを取得する方法は、Central Migration Bridge サービスで生成されたログファイルを取得する方法とは異なります。Central
では、ログファイルは 1 か所に 1 つだけ作成されますが、Central Migration Bridge サービスでは、操作を開始したアプリケーションまたはプロセスに
ログを返します。
Central Migration Bridge サービスによって返されたログを保存するには、返されたログファイルをファイルシステムに書き込みます。ログの保存は、
特にデバッグに役立ちます。
ログファイルに記録される情報の量を調整するには、標準の .ini ファイルに値を設定します。
ADOBE LIVECYCLE ES2.5
Central Migration Bridge サービス
28
LiveCycle ES2.5 サービス
要件
Central Migration Bridge サービスを使用するには、LiveCycle ES2.5 をホストするコンピュータに Adobe Central Pro Output Server 5.7 をインス
トールする必要があります。Central Migration Bridge サービスは、Adobe Central Pro Output Server の初期のバーションをサポートしていません。
詳しくは、『LiveCycle ES2 のインストールおよびデプロイ（JBoss 版）』など、LiveCycle のインストールドキュメントを参照してください。
Central Migration Bridge は、LiveCycle ES2.5 がサポートするプラットフォームをサポートします。
サンプルファイル
LiveCycle ES2.5 には、Central Migration Bridge サービスの使い方を説明するサンプルファイルが用意されています （「LiveCycle ES2 Samples」を参照）。
29
6. Convert PDF サービス
Convert PDF サービスは、PDF ドキュメントを PostScript または画像ファイル（JPEG、JPEG 2000、PNG および TIFF）に変換します。PDF ドキュ
メントを PostScript に変換すると、PostScript プリンタでの無人サーバーベースの印刷に便利です。PDF ドキュメントをサポートしていないコンテンツ
管理システムでドキュメントをアーカイブする場合、PDF ドキュメントをマルチページ TIFF ファイルに変換するのが現実的です。
Convert PDF サービスの使用
Convert PDF サービスを使用して次のタスクを実行できます。
•
•
PDF ドキュメントを PostScript に変換します。PostScript に変換する際は、変換操作を使用して、ソースドキュメントおよび PostScript レベル 2
または 3 のどちらに変換するかを指定できます。PostScript ファイルに変換できるのは、非インタラクティブ PDF ドキュメントに限られます。
PDF ドキュメントを JPEG、JPEG 2000、PNG および TIFF 画像形式に変換します。いずれかの画像形式に変換する場合は、変換操作を使用して、
ソースドキュメントおよび画像オプションを指定できます。画像オプションには、画像変換形式、画像の解像度、色の変換などの様々な設定がありま
す。
•
(（非推奨）アーカイブファイルからファイルを抽出してディレクトリに格納します。
注意 : アーカイブからファイルを抽出する操作は LiveCycle ES 8.2 で非推奨となりましたが、LiveCycle ES2.5 でも引き続き使用できます。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。プログラムによってこのサービスと
やり取りできるクライアントアプリケーションの作成について詳しくは、『Programming with LiveCycle ES2.5』を参照してください。
LiveCycle 管理コンソールのアプリケーションおよびサービスのページを使用して、このサービスのデフォルトプロパティを設定します （LiveCycle
ES2.5 の管理ヘルプの「Convert PDF サービスの設定」を参照）。
30
7. Decision Point サービス
Decision Point サービスは、分岐を決定するために Workbench プロセスで使用されます。
次のような状況では、Decision Point サービスの使用が必要になります。
•
いくつかのルートを評価して、プロセスで実行される最初の操作を決定する必要があります。
この状況は、フォームが送信されてプロセスが開始され、Workbench プロセスで最初に実行される操作をフォームデータから判断する場合に発生
します。例えば、顧客が会社の Web サイトから請求書についての問い合わせフォームに入力できるとします。請求書の金額によって、フォームを承
認申請のために第 1 レベルのマネージャに送信するか、処理のためにクレジット担当者に送信するかが決まります。
•
プロセスにある複数の異なるルートが収束するポイントで、ルールを評価します。
この状況は、1 組のルールが再評価される手順でプロセスがループする場合に発生します。例えば、品質保証プロセスにおいて、不具合があると、不
具合が修正されプロセスが続行できるようになるまでテストを繰り返す必要があります。
この状況は、いくつかの分岐が並行して実行された後に収束する場合にも発生します。例えば、新社員を雇用するプロセスにおいて、応募者が雇用さ
れた場合は、雇用プロセスの一部としていくつかのサブプロセスが開始されます。各サブプロセスが完了すると、各サブプロセスのデータに基づいた
複数のルールが評価され、次に実行する手順が決定されます。
Decision Point サービスの使用
1 つの操作に複数のルートを作成する必要があり、分岐を含む別の操作がプロセスに存在しない場合には、プロセスでこのサービスを使用できます。
Decision Point サービスはプロセス内のノードとして動作し、多数のルートの起点となりますが、実行可能な機能自体はありません。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。
31
8. Distiller サービス
Distiller® サービスでは、PostScript、Encapsulated PostScript（EPS）および PRN ファイルを PDF ファイルに変換できます。Distiller サービスは、
請求書や明細書など、容量の大きい印刷ドキュメントを電子ドキュメントに変換する際によく使用されます。ドキュメントを PDF に変換して、顧客にド
キュメントの印刷バージョンと電子バージョンを送付できます。
注意 : PostScript ファイルを PDF ドキュメントに変換するには、Acrobat 9 または Microsoft Visual C++ 2005 再配布可能パッケージが
ホストするサーバーにインストールされている必要があります。
LiveCycle を
Distiller サービスの使用
PostScript、Encapsulated PostScript または PRN ファイルを PDF ファイルに変換するときには、変換操作を使用して結果 PDF ドキュメントに適用
するオプションを指定できます。以下は、これらのオプションを指定するために使用できるパラメータです。
•
PDF 設定：このパラメータは、変換に使用する Adobe PDF 設定の名前を指定します。この名前で指定される設定は、LiveCycle 管理コンソールで
定義されます。コンソールには、複数の Adobe PDF 設定が事前設定されています。これらの設定の名前は、ロケールによって異なります。英語版の
インストールには、これらの名前に High Quality Print、 PDFA1b 2005 CMYK および Press Quality が含まれます。
Input Settings Document パラメータに値を指定した場合は、このパラメータは無視されます。このパラメータと Input Settings Document パラ
メータの両方がヌルの場合は、LiveCycle ES2.5 サーバーで定義されているデフォルトのファイルタイプ設定インスタンスがこの操作に使用されます。
•
セキュリティ設定： このパラメータは、変換に使用するセキュリティ設定の名前を指定します。この名前で指定される設定は、LiveCycle 管理コン
ソールで定義されます。英語版の環境では、コンソールに事前設定されているセキュリティ設定は No Security のみです。
Input Settings Document パラメータに値を指定した場合は、このパラメータは無視されます。このパラメータと Input Settings Document パラ
メータの両方がヌルの場合は、LiveCycle ES2.5 サーバーで定義されているデフォルトのファイルタイプ設定インスタンスがこの操作に使用されます。
•
Input Settings Document：Adobe PDF 設定とセキュリティ設定などの変換設定が含まれる XML ファイルです。Input Settings Document には、
複数の設定セットを含めることができます。この操作には、デフォルトのセットのみが使用されます （『LiveCycle ES2.5 Generate PDF Conversion
Settings Reference』を参照）。
•
生成された PDF ドキュメントに適用されるメタデータ情報。UTF-8 でエンコードされた Adobe Extensible Metadata Platform（XMP）のメタ
データのみがサポートされます。形式と仕様について詳しくは、アドビの Web サイトの XMP メインページにアクセスしてください。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 のヘルプを参照してください。プログラムによってこのサービス
とやり取りできるクライアントアプリケーションの作成について詳しくは、『Programming with LiveCycle ES2.5』を参照してください。
LiveCycle 管理コンソールでは、アプリケーションおよびサービスのページを使用して、Distiller サービスのデフォルトプロパティを設定できます
（LiveCycle ES2.5 の管理ヘルプの「Distiller サービスの設定」を参照）。LiveCycle PDF Generator ES2.5 のページを使用して、PDF に変換する場合
に適用される、デフォルトの PDF 設定およびセキュリティ設定を指定できます （LiveCycle ES2.5 の管理ヘルプの「PDF Generator ES2.5 および PDF
Generator 3D ES2.5 の設定」を参照）。
ADOBE LIVECYCLE ES2.5
Distiller サービス
32
LiveCycle ES2.5 サービス
PDFG ネットワークプリンタを使用した Distiller の呼び出し
Distiller サービスの CreatePFD2 操作を呼び出すには、「開発者によるサービスの使用」(8 ページ ) で説明した方法のいずれかを使用できますが、
PDFG ネットワークプリンタ（IPP プリンタ）を使用して、この操作に変換ジョブを送信することもできます。
PDFG ネットワークプリンタドライバは、デスクトップ上の他のプリンタドライバと同じようにインストールされます。ユーザーはデスクトップのあら
ゆるアプリケーションから、PDF Generator ES2.5 モジュールが提供する PDF 生成の集中管理機能を利用できます。
PDFG ネットワークプリンタは、通常、次の手順で使用します。
1
ユーザーが、印刷するドキュメントファイルを PDFG ネットワークプリンタに送信します。
2
PDFG ネットワークプリンタは、送信されたファイルを PostScript ストリームに変換し、Internet Printing Protocol（IPP）を使用して、スト
リームを Distiller サービスに送信します。
3
Distiller サービスによって、ストリームが PDF に変換されます。この変換では、PDFG ネットワークプリンタの設定で指定されている Adobe PDF
の設定が使用されます。
4
Distiller サービスは、電子メールでユーザーに変換結果を送信します。変換結果を他の LiveCycle ES2.5 サービスまたはプロセスに送信することも
できます。この機能によって、PDFG ネットワークプリンタは LiveCycle ES2.5 エンドポイントの 1 つになります。
ユーザーが PDFG ネットワークプリンタで印刷できるようにするために、管理者は、PDFG ネットワークプリンタのクライアントインターフェイスを
使用してユーザーのシステムを設定する必要があります。プリントドライバのインストールについて詳しくは、『LiveCycle ES2 の自動インストールおよ
びデプロイ』ドキュメントを参照してください。この機能の設定について詳しくは、LiveCycle ES2.5 管理ヘルプの「PDFG ネットワークプリンタの設
定」を参照してください。
33
9. DocConverter サービス
DocConverter サービスは、署名済みまたは未署名の PDF ドキュメント、XML フォーム（通常は LiveCycle Designer ES2.5 で作成したもの）および
Acrobat フォームを、PDF/A 準拠のドキュメントに変換します。PDF/A は、主にアーカイブに使用される形式です。このサービスを使用して、PDF ド
キュメントが PDF/A 形式に準拠しているかどうかを検証することもできます。
DocConverter サービスは、次の LiveCycle ES2.5 モジュールに付属しています。
•
•
•
Adobe LiveCycle PDF Generator ES2.5
Adobe LiveCycle PDF Generator 3D ES2.5
Adobe LiveCycle Output ES2.5
XML フォームで DocConverter サービスを使用するには、Output ES2.5 が必要です。署名済みまたは未署名の署名フィールドを含んだドキュメント
で DocConverter サービスを使用するには、LiveCycle Digital Signatures ES2.5 が必要です。
DocConverter サービスの使用
DocConverter サービスを使用して次のタスクを実行できます。
•
•
「PDF ドキュメントが PDF/A に準拠しているかどうかの検証」(33 ページ )
「PDF ドキュメントの PDF/A への変換」(33 ページ )
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。プログラムによってこのサービスと
やり取りできるクライアントアプリケーションの作成について詳しくは、『Programming with LiveCycle ES2.5』を参照してください。
PDF ドキュメントが PDF/A に準拠しているかどうかの検証
DocConverter サービスを使用して、PDF ドキュメントが PDF/A-1b 標準（ISO 19005-1b）に準拠しているかどうかを検証できます。
PDF ドキュメントの PDF/A への変換
DocConverter サービスを使用すると、次の形式のファイルを PDF/A-1b に準拠した PDF ドキュメントに変換できます。
•
•
•
署名済みまたは未署名の PDF ドキュメント
XML フォーム（通常は Designer ES2.5 で作成されたもの）
Acrobat フォーム
PDF/A-1b は、PDF ベースのドキュメントを長期間アーカイブするための ISO 標準です。長期間の保存を目的とするので、ドキュメントには、内容の
把握とその正確な再現に必要な以下のような情報のみが含まれます。
•
•
•
内容の把握に役立つ関連メタデータ。
カスタムメタデータのスキーマ。
フォント。すべてのフォントが埋め込まれます。その結果、PDF/A ドキュメントは通常標準の PDF ドキュメントよりも大きくなります。
PDF/A ドキュメントでは、以下のものを含めたり使用したりできません。
•
•
•
オーディオとビデオのコンテンツとスクリプト
暗号化
スクリプト
PDF/A-1 標準に含まれる制限には、署名とフォームの変換に影響するものがあります。DocConverter サービスがファイルを PDF/A-1b に変換する場
合は、PDF/A-1b 標準に準拠するようにファイルを変更します（「署名」(34 ページ ) 、「Adobe XML フォーム」(34 ページ ) および「Acrobat フォー
ム」(34 ページ ) を参照）。
ADOBE LIVECYCLE ES2.5
DocConverter サービス
34
LiveCycle ES2.5 サービス
ファイルを完全には PDF/A に変換できない場合があります。そのような場合、DocConverter サービスは、ファイルの変換を部分的に行います。
DocConverter サービスからは、変換済みのファイルに加え、変換レポートが作成されます。このレポートでは、ファイルに適用された修復措置や、修
復できなかった違反などが報告されます。
PDF/A は、PDF ドキュメントをアーカイブするための標準ですが、必ずしも PDF/A を使用してアーカイブする必要はありません。標準の PDF ドキュ
メントが会社のニーズに合っていることもあります。PDF/A 標準の目的は、長期間のアーカイブとドキュメントの保存というニーズを満たした PDF
ファイルの確立です（『PDF as a Standard for Archiving』と『Processing PDF/A Documents』も参照）。
署名
デフォルトで、DocConverter サービスは、最後の署名を除き、すべての署名を PDF ファイルから削除します。サービスは、削除されたメタデータ内の
署名に関する情報を取得します。また、削除された署名の画像を PDF ファイルに追加することで、署名の外観を記録します。削除された署名は検証でき
ません。
ユーザーは PDF/A ドキュメントに署名できます。
Adobe XML フォーム
PDF/A ファイルには、XML フォームテンプレート（XFA フォーム）を含めることはできません。
DocConverter サービスは、XML 署名など、PDF ファイルに表示される XML フォームテンプレートを統合します。サービスは、削除されたメタデー
タ内の署名に関する情報を取得します。また、削除された署名の画像を PDF ファイルに追加することで、署名の外観を記録します。削除された署名は検
証できません。
インタラクティブ PDF ドキュメントを非インタラクティブ PDF ドキュメントに変換するプロセスは「統合」と呼ばれます。PDF ドキュメントを統合す
ると、フォームフィールドのグラフィック表示は残されますが、インタラクティブではなくなります。また、データは PDF/A 内に存在していますが、
フォーム内のデータは標準のツールでは抽出できません。
Acrobat フォーム
PDF/A ファイルには、フィールドの表示が可能であれば、あらゆるタイプのインタラクティブ Acrobat フォームフィールドを含めることができます。そ
のようなフィールドには、データを含めることはできますが、スクリプトを含めることはできません。
35
10. Document Management サービス
Document Management サービスを使用すると、プロセスで Adobe LiveCycle Content Services ES2.5 のコンテンツ管理機能を使用できます。
LiveCycle Content Services ES2.5 について詳しくは、『LiveCycle ES2.5 の概要』を参照してください。
Document Management サービスの使用
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 のヘルプを参照してください。プログラムによってこのサービス
とやり取りできるクライアントアプリケーションの作成について詳しくは、『Programming with LiveCycle ES2.5』を参照してください。
LiveCycle 管理コンソールのアプリケーションおよびサービスのページを使用して、このサービスのデフォルトプロパティを設定できます （LiveCycle
ES2.5 の管理ヘルプを参照）。
コンテンツとスペースの使用
「コンテンツ」は、コンテンツそのものと、コンテンツに関する情報（メタデータ）という、2 つの主要な要素から構成されるファイルまたはドキュメン
トです。例えば、ファイルには、ドキュメント、ビデオ、オーディオ、画像、XML、HTML などがあります。コンテンツは、Content Services ES2.5
リポジトリ内のスペースに追加または作成でき、カテゴリに分類、編成することができます。
「スペース」は、コンテンツアイテムや他のスペースを保存したり編成したりする目的で使用されます。スペースには、あらゆる種類のコンテンツを含め
ることができます。
Document Management サービス操作を使用すると、次のタスクを実行できます。
スペースの作成： Content Services ES2.5 でスペースを作成します。
既存のスペースまたはテンプレートからのスペースの作成： Content
Services ES2.5 で、既存のスペースまたはテンプレートに基づいてスペースを作成し
ます。すべての規則、コンテンツおよびユーザーが、既存のスペースまたはテンプレートから新しいスペースへとコピーされます。
特定のスペースのコンテンツの表示： 特定のスペースに存在するファイルおよびスペースのリストを取得します。
コンテンツまたはスペースの削除： 特定のコンテンツまたはスペースを、関連するメタデータと共に削除します。スペースを削除すると、そのコンテンツ
もすべて削除されます。コンテンツを削除すると、そのコンテンツのすべてのバージョンが削除されます。
コンテンツアイテムまたはスペースのコピー： 特定のコンテンツアイテムまたはスペースを、関連するメタデータと共に、あるスペースから別のスペース
へとコピーします。スペースをコピーすると、そのコンテンツもすべてコピーされます。
コピー先に既に同じ名前のスペースが存在した場合、新しいスペースには、特定のスペース名のコピーであることを表す名前が付きます。
コンテンツの保存： コンテンツとそのメタデータを
Content Services ES2.5 リポジトリに保存するか、リポジトリ内のコンテンツとそのメタデータを更
新します。
コンテンツアイテムまたはスペースの移動： 特定のコンテンツまたはスペースを、関連するメタデータと共に、ある場所（スペース）から別の場所へと移
動します。スペースを移動すると、そのコンテンツもすべて移動されます。
コンテンツの取得： 特定のコンテンツとそれに関連するメタデータを取得します。
コンテンツの読み込み： ZIP ファイルまたは
ACP ファイルに格納されているコンテンツをリポジトリに追加します。「ACP ファイル」は、
Adobe LiveCycle Contentspace ES2.5 からコンテンツを書き出すときに作成されます。コンテンツの元の階層構造は新しい場所で保持されます。
ADOBE LIVECYCLE ES2.5
Document Management サービス
36
LiveCycle ES2.5 サービス
関連付けの使用
「関連付け」は、リポジトリに存在する複数のコンテンツアイテムを互いに結び付ける方法です。LiveCycle Workbench で利用できる関連付けの種類に
は、次のようなものがあります。
•
•
•
XML データファイルと添付ファイルの関連付け
XML データファイルと PDF フォームをリンクする関連付け
2 つの PDF ドキュメントをリンクする関連付け
独自の関連付けを作成することもできます。Document Management サービス操作を使用すると、次のタスクを実行できます。
コンテンツアイテム間の関連付けの作成： リポジトリ内の
2 つのコンテンツアイテム（またはフォルダ）間の関連付けを作成します。
関連付けの取得： 特定の種類の関連付けを使用して、特定のコンテンツに関連付けられているコンテンツアイテムの ID のリストを取得します。
コンテンツ属性の使用
「コンテンツ属性」は、コンテンツアイテムのメタデータです。メタデータは、その適用先のコンテンツアイテムとは切り離されて、データベースに保存
されます。この構造がメタデータの高速な検索を可能にしています。
Document Management サービス操作を使用すると、次のタスクを実行できます。
コンテンツ属性の取得： 特定のコンテンツに関連付けられている属性を取得します。
コンテンツ属性の設定： コンテンツそのものは変更せずに、特定のコンテンツのメタデータ属性を設定します。この操作によってコンテンツのバージョン
が繰り上げられることはありません。
コンテンツからのアスペクトの削除： コンテンツから特定のアスペクトを削除します。「アスペクト」は、コンテンツに適用する属性のコレクションです。
コンテンツへのアクセス権限の管理： コンテンツにアクセスできるユーザーとグループのリストを管理します。
コンテンツへのアクセス権限の確認： 特定のコンテンツへのアクセス権限のリストを取得します。このリストには、ユーザーごとおよびグループごとに、
アクセス権限の種類とアクセスステータスが示されます。
LiveCycle Contentspace ES2.5 の考慮事項
ユーザーは、以下の手順で、LiveCycle Contentspace ES2.5 からフォームを開いてデータを入力できます。
1
フォームのあるスペースに移動します。
2
ファイルの詳細を表示します。
3 「フォームに入力」をクリックします。
ユーザーがフォームを送信すると、そのデータが抽出されて、XML ファイルとして保存されます。このような方法でアクセスされる XDP フォームを
LiveCycle Designer ES2.5 で設計する場合は、フォーム上に送信 URL を含めないようにしてください。送信 URL を含めるとその URL は上書きされ
ないので、送信されたフォームデータを Contentspace ES2.5 内で利用できなくなります。
37
11. Email サービス
電子メールは通常、自動化されたプロセスの一部として、コンテンツの配布やステータス情報の提供に使用されます。Email サービスによって、プロセ
スでは電子メールメッセージを POP3 または IMAP サーバーから受信したり、SMTP サーバーに送信したりすることができます。
例えば、Email サービスを使用して、PDF フォームが添付された電子メールメッセージが送信されます。Email サービスは SMTP サーバーに接続され、
添付ファイル付きの電子メールメッセージが送信されます。PDF フォームは、受信者がフォームの入力を完了すると「送信」をクリックできるように設
計されています。「送信」をクリックすると、フォームは指定された電子メールサーバーに添付ファイルとして返されます。Email サービスは返された電
子メールメッセージを取得して、完成したフォームをプロセスデータフォーム変数に格納します。
Email サービスが POP3 または IMAP サーバーに接続して電子メールメッセージを取得する場合、インボックス内の他の電子メールメッセージから一
意のメッセージを識別する方法が必要となります。通常、この識別は件名行にプロセス ID などの固有な識別子を埋め込むか、特定の送信者を検索する
ことによって実行されます。Email サービスには、電子メールメッセージの送信者、宛先、件名および本文のテキストをカスタマイズする機能が用意さ
れています。開発者は、電子メールメッセージに一致する検索条件（電子メールメッセージの送信者や件名など）を指定できます。
Email サービスの使用
Email サービスを使用するプロセスを LiveCycle ES2.5 で開発することによって、このサービスを対話的に操作できます。Email サービスを使用して次
のタスクを実行できます。
•
デフォルトプロパティを使用して電子メールサービスを設定し、SMTP サーバーに接続して電子メールメッセージを送信します。また、POP3 また
•
は IMAP サーバーへの接続を設定してメッセージを受信します。
POP3 または IMAP のいずれかの電子メールサーバーから電子メールメッセージおよび添付ファイルを受信します。電子メールに関するメタデータ
およびメッセージコンテンツを保存することができます。また、電子メールメッセージにフィルタを設定したり、使用する電子メールサーバーおよ
びユーザーアカウントに関するプロパティを設定したりすることもできます。
•
1 つ以上の添付ファイルがある電子メールメッセージを SMTP サーバーに送信します。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 のヘルプを参照してください。
LiveCycle 管理コンソールのアプリケーションおよびサービスのページを使用して、このサービスのデフォルトプロパティを設定することもできます
（LiveCycle ES2.5 の管理ヘルプの「Email サービスの設定」を参照）。
38
12. Encryption サービス
Encryption サービスは、ドキュメントの暗号化および復号化を有効にします。ドキュメントを暗号化すると、その内容は判読できなくなります。PDF ド
キュメント全体（コンテンツ、メタデータおよび添付ファイル）を暗号化するか、そのメタデータ以外のすべてのデータを暗号化するか、または添付
ファイルだけを暗号化することができます。許可されたユーザーはドキュメントを解読して、コンテンツにアクセスできます。PDF ドキュメントがパス
ワードで暗号化されている場合、ユーザーは開くためのパスワードを指定しないと、Adobe Reader または Acrobat でドキュメントを表示できません。
PDF ドキュメントが証明書で暗号化されている場合、ユーザーは PDF ドキュメントを所有する秘密鍵（証明書）で復号化する必要があります。そのよ
うな PDF ドキュメントの復号化には、そのドキュメントの暗号化に使用された公開鍵に対応する秘密鍵が必要です。
Encryption サービスの使用
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。プログラムによってこのサービスと
やり取りできるクライアントアプリケーションの作成について詳しくは、『Programming with LiveCycle ES2.5』を参照してください。
LiveCycle 管理コンソールのアプリケーションおよびサービスのページを使用して、このサービスのデフォルトプロパティを設定できます（LiveCycle
ES2.5 管理ヘルプの「Encryption サービスの設定」を参照）。
パスワードによる PDF ドキュメントの暗号化
Encryption サービスを使用すると、PDF ドキュメントをパスワードで暗号化できます。PDF ドキュメントをパスワードで暗号化する場合、ユーザーは
Adobe Reader または Acrobat で PDF ドキュメントを開くためのパスワードを指定する必要があります。PDF ドキュメント全体（コンテンツ、メタ
データおよび添付ファイル）を暗号化するか、そのメタデータ以外のすべてのデータを暗号化するか、または添付ファイルだけを暗号化するかを選択で
きます。ドキュメントの添付ファイルだけを暗号化した場合は、ユーザーは添付ファイルにアクセスしようとしたときだけパスワードの入力が求められ
ます。
PDF ドキュメントをパスワードで暗号化する場合、2 つの異なるパスワードを指定する必要があります。1 つのパスワードは PDF ドキュメントの暗号化
と復号化に使用されます。もう 1 つのパスワードは、PDF ドキュメントからの暗号化の削除または権限の変更のために使用されます。
パスワードを使用して PDF ドキュメントを暗号化する場合、権限を追加して、ドキュメントを受信するユーザーが実行可能な操作を指定できます。例え
ば、ユーザーが PDF ドキュメントに対して、署名、入力、編集または印刷を行うことができるかどうかを指定することができます。
パスワードで暗号化された PDF ドキュメントに対して電子署名など LiveCycle ES2.5 の別の操作を行うには、そのドキュメントのロックを事前に解除
しておく必要があります （「暗号化された PDF ドキュメントのロック解除」(39 ページ ) を参照）。
注意 : ドキュメントはリポジトリにアップロードする前に暗号化しないことをお勧めします。暗号化された PDF ドキュメントをリポジトリにアップロー
ドすると、その PDF ドキュメントは復号化できず、XDP の内容を抽出できなくなります。
パスワード暗号化の削除
Encryption サービスを使用すると、パスワードベースの暗号化を PDF ドキュメントから削除できます。これにより、ユーザーはパスワードを指定する
ことなく、Adobe Reader または Acrobat で PDF ドキュメントを開くことができます。パスワードベースの暗号化を PDF ドキュメントから削除する
と、そのドキュメントは保護されなくなります。
ADOBE LIVECYCLE ES2.5
Encryption サービス
39
LiveCycle ES2.5 サービス
証明書による PDF ドキュメントの暗号化
Encryption サービスを使用すると、PDF ドキュメントを証明書で暗号化できます。証明書ベースの暗号化では、公開鍵による暗号化を使用して、特定
の受信者用にドキュメントを暗号化できます。公開鍵による暗号化には 2 種類の鍵が使用されます。
•
•
公開鍵。他のユーザーと共有できる証明書内に格納されます。公開鍵証明書は、X.509 形式で、ユーザーの公開鍵と識別情報が含まれます。
秘密鍵。この鍵は他のユーザーとは共有されません。
ドキュメントは、ドキュメントを受信するユーザーの公開鍵（証明書）を使用して暗号化されます。暗号化されたドキュメントは、ユーザーが受信した
ときに自分の秘密鍵を使用して復号化します。
通常、証明書は認証局（CA）で発行および電子署名されます。「CA」は、証明書の有効性における信頼度を提供する、承認されたエンティティです。
証明書には有効期限があり、この期限を過ぎると無効になります。また、証明書の失効リスト（CRL）には、有効期限よりも前に失効した証明書に関す
る情報が示されます。CRL は認証局によって定期的に発行されます。証明書の失効ステータスは、ネットワークを通じてオンライン証明書ステータスプ
ロトコル（OCSP）から取得することもできます。
証明書を使用して PDF ドキュメントを暗号化する場合、権限を追加して、個別のユーザーがドキュメントに対して実行可能な操作を指定できます。例え
ば、ユーザーが PDF ドキュメントに対して、署名、入力、編集または印刷を行うことができるかどうかを指定することができます。
PDF ドキュメントを証明書で暗号化できるようにするには、事前に、LiveCycle 管理コンソールを使用して LiveCycle ES2.5 にその証明書を追加する必
要があります。
注意 : ドキュメントはリポジトリにアップロードする前に暗号化しないことをお勧めします。暗号化された PDF ドキュメントをリポジトリにアップロー
ドすると、その PDF ドキュメントは復号化できず、XDP の内容を抽出できなくなります。
パスワードで暗号化された PDF ドキュメントに対して電子署名など LiveCycle ES2.5 の別の操作を行うには、そのドキュメントのロックを事前に解除
しておく必要があります （「暗号化された PDF ドキュメントのロック解除」(39 ページ ) を参照）。
証明書ベースの暗号化の削除
Encryption サービスを使用すると、証明書ベースの暗号化を PDF ドキュメントから削除できます。これにより、ユーザーは Adobe Reader または
Acrobat で PDF ドキュメントを開くことができます。証明書で暗号化されている PDF ドキュメントから暗号化を削除するには、公開鍵を参照する必要
があります。暗号化を PDF ドキュメントから削除すると、そのドキュメントは保護されなくなります。
暗号化された PDF ドキュメントのロック解除
Encryption サービスを使用すると、パスワードまたは証明書で暗号化された PDF ドキュメントのロックを解除できます。暗号化された PDF ドキュメ
ントに LiveCycle ES2.5 の操作を実行しようとすると、例外が発生します。暗号化された PDF ドキュメントのロックを解除すれば、Signature サービス
を使用して電子署名をするなど、1 つ以上の操作を実行できます。
暗号化の種類の確認
Encryption サービスを使用すると、PDF ドキュメントを保護している暗号化の種類を確認できます。PDF ドキュメントが暗号化されているかどうか、
またその暗号化の種類を動的に判断することが必要な場合があります。例えば、PDF ドキュメントがパスワードベースの暗号化で保護されているか、
Rights Management のポリシーで保護されているかどうかを確認できます （「Rights Management サービス」(110 ページ ) を参照）。
PDF ドキュメントは、次の種類の暗号化によって保護することができます。
•
•
•
•
パスワードベースの暗号化
証明書ベースの暗号化
Rights Management サービスで作成されたポリシー
その他の暗号化メカニズム
ADOBE LIVECYCLE ES2.5
Encryption サービス
40
LiveCycle ES2.5 サービス
Encryption サービスに関する考慮事項
1 つのドキュメントに対して暗号化、認証方法、および使用権限の適用を組み合わせて使用する場合は、次に示す順序で行う必要があります。これらの
サービスは、短時間のみ有効なプロセス内で呼び出す必要があります。
1
ドキュメントに電子署名する（Signature サービス）前に、ドキュメントに暗号化を適用するか（Encryption サービス）、ポリシーを適用します
（Rights Management サービス）。電子署名は、署名時のファイルの状態を記録します。署名を適用した後にドキュメントを暗号化またはポリシーを
適用すると、ファイルのバイト数が変わり、署名は無効になります。
2
使用権限（Reader Extensions サービス）を設定する前に PDF ドキュメントを認証します（Signature サービス）。使用権限を適用した後にドキュ
メントを認証すると、使用権限の署名が無効となり、ドキュメントから使用権限が削除される場合があります。
3
使用権限を設定した後に PDF ドキュメントに電子署名します（Signature サービス）。使用権限を適用した後に PDF ドキュメントに署名すると、使
用権限の署名は無効になりません。
また、PDF ドキュメントを暗号化して、ポリシーを同じ PDF ドキュメントに適用することはできません。同様に、暗号化された PDF ドキュメントにポ
リシーを適用することはできません。
41
13. Execute Script サービス
Execute Script サービスを使用すると、プロセスでスクリプトを実行することができます。
Execute Script サービスの使用
Execute Script サービスを使用するプロセスを LiveCycle Workbench で開発することによって、このサービスを対話的に操作できます。
Execute Script サービスは、BeanShell 1.3.0 をサポートしています。これは、Java プラットフォーム用の Java 構文に互換性のあるスクリプト言語です。
スクリプトでは暗黙オブジェクトが利用可能です。暗黙オブジェクトにより、以下のタスクが実行されます。
•
オブジェクトマネージャ、プロセスマネージャ、デプロイメントプロパティ、JNDI 初期コンテキストおよび JNDI アプリケーションコンテキスト
•
•
スクリプトの実行結果として収集された情報を格納して、データを LiveCycle ES2.5 サーバーに転送します。
にアクセスできます。
スクリプトの実行中に使用するためにすべてのコンテキストデータを提供します。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。
LiveCycle 管理コンソールのアプリケーションおよびサービスのページを使用して、このサービスのデフォルトプロパティを設定できます （LiveCycle
ES2.5 の管理ヘルプを参照）。
42
14. FTP サービス
FTP サービスを使用すると、プロセスで FTP サーバーを対話的に操作できます。FTP サービスの操作によって、FTP サーバーからのファイルの取得、
FTP サーバーへのファイルの配置、および FTP サーバーからのファイルの削除を行うことができます。例えば、プロセスから生成されたレポートなどの
ドキュメントを、配布のために FTP サーバーに保存することができます。また、プロセスにおける前の手順に基づいて、外部システムでファイルを生成
することができます。プロセスの後続の手順では、ファイルを離れた場所に転送することができます。
FTP サービスの使用
FTP サービスを使用するプロセスを LiveCycle Workbench で開発することによって、このサービスを対話的に操作できます。FTP サービスを使用して
次のタスクを実行できます。
•
•
•
•
•
•
•
•
•
FTP サーバーに接続するためのデフォルトのホスト、ポートおよびユーザーの秘密鍵証明書を指定します。
FTP サーバー上のディレクトリ内にあるファイルのリストを取得します。
ファイル名パターンに基づいて FTP サーバーから複数のファイルを取得します。
FTP サーバーからファイルを取得し、LiveCycle ES2.5 サーバーのファイルシステムにそのファイルを保存します。
FTP サーバーからファイルの内容を取得し、その内容をプロセスデータとして保存します。
FTP サーバー上のディレクトリにプロセスデータをアップロードし、そのデータをファイルとして保存します。
1 つ以上のドキュメントの値を FTP サーバーにアップロードします。
FTP サーバー上のディレクトリに LiveCycle ES2.5 サーバーのファイルシステムからファイルをアップロードします。
FTP サーバーからファイルを削除します。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。
LiveCycle 管理コンソールのアプリケーションおよびサービスのページを使用して、このサービスのデフォルトプロパティを設定できます（LiveCycle
ES2.5 の管理ヘルプの「FTP サービスの設定」を参照）。
FTP サービスに関する考慮事項
このサービスを使用するプロセスを開発する際には、次の事項を考慮します。
•
操作プロパティにファイルまたはディレクトリへのローカルパスを指定した場合、そのパスは LiveCycle ES2.5 サーバーのファイルシステム上にあ
るものと解釈されます。
•
LiveCycle ES2.5 サーバーを実行するために使用されるユーザーアカウントは、サービスの操作の対象となるファイルとファイルの場所を対話的に
操作するために必要な権限を持つ必要があります。
43
15. File Utilities サービス
File Utilities サービスを使用すると、プロセスにおいて、LiveCycle ES2.5 サーバーのファイルシステム、またはサーバーがアクセスできるその他の
ファイルシステムを対話的に操作できます。
ファイルは通常、様々なシステムと統合するために使用されます。プロセスで File Utilities サービスを使用すると、XML、カンマ区切りテキスト、
PDF などの様々な形式のファイルの読み取りと書き込みを行うことができます。プロセスでこのサービスを使用して、指定したディレクトリ内にファイ
ルを作成し、そのファイルに対する権限を設定することもできます。
File Utilities サービスは、動的にドキュメントを生成するプロセスの一部として使用することもできます。例えば、毎晩実行されるようにスケジュール
されているプロセスがあると想定します。このプロセスは、動的に PDF で販売レポートを生成し、ディレクトリに配置します。このディレクトリは、月
と年に基づいて定義されます。
File Utilities サービスの使用
File Utilities サービスを使用するプロセスを LiveCycle Workbench で開発することによって、このサービスを対話的に操作できます。File Utilities
サービスを使用して次のタスクを実行できます。
•
•
•
•
•
•
•
•
•
ファイルを削除します。
ファイルの有無を確認します。
ファイルシステム上のファイルとディレクトリを検索します。
パスが絶対パスかどうかを確認します。
パスがディレクトリとファイルのどちらを示すかを確認します。
パスが隠しファイルを示すかどうかを確認します。
ディレクトリまたはディレクトリツリーを作成します。
ファイルシステム上にファイルとしてデータを保存します。
ファイルから情報を取得し、以下のいずれかのプロセスデータ形式で保存します。
•
•
•
•
文字列
XML ドキュメント
以下のプロセスデータ形式の情報をファイルに書き込みます。
•
•
•
•
ドキュメント
ドキュメント
文字列
XML ドキュメント
ファイルシステム上のディレクトリとファイルを処理します。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。
File Utilities サービスに関する考慮事項
このサービスを使用するプロセスを開発する際には、次の事項を考慮します。
•
操作プロパティにファイルまたはディレクトリへのローカルパスを指定した場合、そのパスは LiveCycle ES2.5 サーバーのファイルシステム上にあ
るものと解釈されます。
•
LiveCycle ES2.5 サーバーを実行するために使用されるユーザーアカウントは、サービスの操作の対象となるファイルとファイルの場所を対話的に
操作するために必要な権限を持つ必要があります。
44
16. Form Augmenter サービス
Form Augmenter サービスにより、PDF フォームまたは Acrobat フォームは LiveCycle Workspace ES2.5 内で機能するようになります。例えば、
フォーム、ドキュメントフォームまたは xfaForm 変数に対するカスタムレンダリングサービスや送信サービスにおいて、Form Augmenter サービスの
操作が役立ちます。
Workspace ES2.5 に対して有効になっているフォームには、次の特性があります。
•
Workspace ES2.5 で表示されている間は、ボタンが非表示になります。プロセスフィールドフォームオブジェクトの一部としてフォームデザインに
•
•
送信要求は、LiveCycle ES2.5 サーバーとフォームの間で媒介として動作する Workspace ES2.5 によって処理されます。
追加された非表示の送信ボタンで送信が呼び出されます。
フォームはオフラインとオンラインの両方で使用できます。
Form Augmenter サービスの使用
フォーム、ドキュメントフォームまたは xfaForm 変数に対するカスタムレンダリングサービスや送信サービスを作成する場合に、Form Augmenter
サービスの操作を使用できます。
Form Augmenter サービスの操作を使用して、次のようなタスクを実行できます。
•
Workspace ES2.5 で PDF フォームをオンラインで使用できるようにします。PDF フォームは LiveCycle Designer ES2.5 または Acrobat 7.0.5 以
•
Workspace ES2.5 で PDF フォームをオフラインで使用できるようにします。PDF フォームは Designer ES2.5 で作成されている必要があります。
Acrobat フォームは指定できません。
Designer ES2.5 で作成された PDF フォームが Workspace ES2.5 でオフラインで使用できるように、フォームデータにデータフィールドを追加し
ます。Acrobat フォームは指定できません。
フォーム上のフィールドから値を取得します。PDF フォームは Designer ES2.5 または Acrobat 7.0.5 以降で作成されている必要があります。
降で作成されている必要があります。
•
•
•
データフィールドのセットをフォームデータから削除します。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。
45
17. Form Data Integration サービス
Form Data Integration サービスでは、PDF フォームにフォームデータを読み込んだり、PDF フォームからフォームデータを書き出したりすることが
できます。読み込みおよび書き出しの操作では、2 種類の PDF フォームがサポートされています。
•
•
Acrobat フォーム（Acrobat で作成）。フォームフィールドを含む PDF ドキュメントです。
（LiveCycle Designer ES2.5 で作成された）XML フォーム。Adobe XML Forms Architecture（XFA）に準拠している PDF ドキュメントです。
フォームデータは、PDF フォームの種類に応じて次のいずれかの形式で作成します。
•
•
XFDF ファイル。Acrobat フォームデータ形式の XML バージョンです。
XDP ファイル。フォームフィールド定義を含む XML ファイルです。フォームフィールドデータと埋め込まれた PDF ファイルが含まれる場合もあ
ります。Designer ES2.5 で生成された XDP ファイルは、埋め込まれた base-64 エンコード PDF ドキュメントを使用する場合にのみ利用できます。
Form Data Integration サービスの使用
XFDF（Acrobat フォームのみ）または XDP（XML フォームのみ）を使用して、データの読み込みおよび書き出しを行うことができます。例えば、
Designer ES2.5 で作成されたフォームにデータを読み込むには、有効な XDP XML データソースを作成します。ここでは、ローン申し込みフォームの
例を取り上げます。
ADOBE LIVECYCLE ES2.5
Form Data Integration サービス
46
LiveCycle ES2.5 サービス
データ値をこのフォームにインポートするには、フォームに対応する XDP XML データソースを作成する必要があります。任意の XML データソースで
は、Form Data Integration サービスを使用してデータをフォームに読み込むことができません。任意の XML データソースと XDP データソースの違い
は、XDP データソースが XML Forms Architecture（XFA）に準拠しているという点です。次の XML は、ローン申し込みフォームの例に対応する
XDP データソースを表しています。
<?xml version="1.0" encoding="UTF-8"?>
<xfa:datasets xmlns:xfa="http://www.xfa.org/schema/xfa-data/1.0/">
<xfa:data>
<data>
<Layer>
<closeDate>1/26/2007</closeDate>
<lastName>Johnson</lastName>
<firstName>Jerry</firstName>
<mailingAddress>[email protected]</mailingAddress>
<city>New York</city>
<zipCode>00501</zipCode>
<state>NY</state>
<dateBirth>26/08/1973</dateBirth>
<middleInitials>D</middleInitials>
<socialSecurityNumber>(555) 555-5555</socialSecurityNumber>
<phoneNumber>5555550000</phoneNumber>
</Layer>
<Mortgage>
<mortgageAmount>295000.00</mortgageAmount>
<monthlyMortgagePayment>1724.54</monthlyMortgagePayment>
<purchasePrice>300000</purchasePrice>
<downPayment>5000</downPayment>
<term>25</term>
<interestRate>5.00</interestRate>
</Mortgage>
</data>
</xfa:data>
</xfa:datasets>
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。プログラムによってこのサービスと
やり取りできるクライアントアプリケーションの作成について詳しくは、『Programming with LiveCycle ES2.5』を参照してください。
LiveCycle 管理コンソールのアプリケーションおよびサービスのページを使用して、このサービスのデフォルトプロパティを設定できます （LiveCycle
ES2.5 の管理ヘルプを参照）。
47
18. Forms サービス
Forms サービスを使用すると、通常は LiveCycle Designer ES2.5 で作成されるフォームを検証、処理、変換および配信する、インタラクティブなデー
タキャプチャクライアントアプリケーションを作成できます。フォーム作成者は、PDF として、HTML として、または Adobe Flash Player をサポート
する様々なブラウザ環境でのガイドとして、Forms サービスによってレンダリングされる、単一のフォームデザインを作成します。
Forms サービスは、インタラクティブな PDF フォームをレンダリングします。インタラクティブフォームには、ユーザーからインタラクティブに情報を
収集するためのフィールドが少なくとも 1 つ存在します。インタラクティブフォームのデザインによって、オンラインまたは（PDF フォームの場合は）
オフラインで入力可能なフォームを作成できます。ユーザーは、フォームを Acrobat、Adobe Reader または HTML ブラウザで開き、フォームの
フィールドに情報を入力することができます。インタラクティブフォームには、一般的なタスク（ファイルへのデータの保存またはデータの印刷など）
を実行するためのボタンやコマンドを含めることができます。また、ドロップダウンリスト、計算、検証などの機能を含めることもできます。
エンドユーザーがフォームを要求すると、Java サーブレットなどのクライアントアプリケーションは、Forms サービスに要求を送信します。Forms サー
ビスは、適切な形式でエンドユーザーにフォームを返します。Forms サービスは、フォームの要求を受け取ると、一連の変換を使用してデータをフォー
ムデザインにマージします。次に、対象のブラウザの表示機能とフォーム入力機能に最適な形式でフォームを返します。例えば、エンドユーザーから
PDF フォームを要求された場合、Forms サービスは、インタラクティブな PDF フォームをレンダリングします。
Forms サービスは、次の機能を実行します。
•
フォームデザイン内のインテリジェンスをサーバー側で実現します。Forms サービスは、フォームデザインに含まれている検証と計算を実行し、結
•
フォームデザインスクリプトをクライアントとサーバーのどちらで実行するかを検出します。Internet Explorer 5.0 以降などのクライアント側スクリプ
果のデータをブラウザに返します。
トをサポートしているクライアントの場合、適切なスクリプトモデルがデバイスに読み込まれ、クライアントコンピュータで直接そのスクリプトを実行
することができます。各変換でサポートされるプロパティとメソッドについて詳しくは、『Transformation Reference』を参照してください。
•
データの有無に関わらず、特定のフォームデザインに対するユーザーの環境設定に基づいて、動的に PDF、SWF または HTML のコンテンツを生
成します。HTML フォームでは、マルチページのフォームをページごとに配信できます。一方、PDF フォームでは、すべてのページを一度に配信し
ます。Designer ES2.5 では、フォーム作成者はそのフォームデザインで現在のページ番号をスクリプト記述することができます。Forms サービス
は、送信されたデータを一度に 1 ページずつマージするか、1 つのページのみをフォームデザインにマージできます。
•
Designer ES2.5 で作成されたサブフォームをサポートします。Forms サービスは、フォームデザインとデータのマージ、またはスクリプトの結果、
フィールドとボイラープレートを追加します。HTML の場合、追加されたサブフォームは、ページ長の制限なく大きくすることができます。PDF の
•
フラグメントに基づいてフォームをレンダリングします。フラグメントにより、フォームデザインの外部にあるフォームおよびスクリプトオブジェク
場合、追加されたサブフォームは、フォームデザインで指定されたページ長に割り付けられます。
トを共有することができます。一度フォームの一部をデザインすると、関連するフォームのコレクションをデザインする際にこれらを再利用すること
ができます。コレクション用に新しいフォームを作成する際は、フラグメントへの参照を挿入するだけで済みます。フォーム作成者がフラグメントを
更新すると、そのフラグメントへの参照を含むすべてのフォームに変更が反映されます（フォームの再レンダリング時に反映されます）。
•
•
•
計算の実行、データベースへのアクセス、またはフィールドレベルデータでのビジネスルールの適用により、データエントリを検証します。
•
アプリケーションより渡されたパススルーデータの状態を管理します。パススルーデータは、処理されているフォームデザインに、該当するフィー
添付ファイルのあるフォームをレンダリングします。また、Forms サービスは添付ファイルを含むフォーム送信も処理できます。
検証エラーを様々な方法（スプリットフレーム（左、上、右、下）、フレーム（左、上、右、下）なし、または UI なし）で表示します。これはすべ
て、サーバー上での状態の管理を必要とせずに行われます。検証エラーは、XML ベースの検証エラードキュメントでも利用できます。
ルドがないデータです。パススルーデータは、対象デバイスがそのデータを送信した後、呼び出し元アプリケーションに戻されます。
•
非テクニカルユーザーが現行のビジネス要件を満たすために Designer ES2.5 を使用してフォームデザインを修正することを可能にします。これに対
し HTML ページを表示する Web アプリケーションでは、Web ページを変更するためには、ユーザーが HTML または XML のソースコードを修
正することが必要になる場合があります。
このサービスの初期設定について詳しくは、LiveCycle ES2.5 の管理ヘルプの「LiveCycle Forms ES2.5 の設定」を参照してください。
ADOBE LIVECYCLE ES2.5
Forms サービス
48
LiveCycle ES2.5 サービス
フォームの種類について
Forms サービスを初めて使用する場合は、あらかじめ、Forms サービスで使用されるフォームの種類について理解しておくことをお勧めします。ここで
は、これらのフォームの種類について説明します。
流動レイアウトのフォーム
流動レイアウトのフォームは、データの事前入力またはユーザーの操作によって変化するレイアウトを備えています。データに応じて調整されるフォー
ムデザインでは、レイアウト、表示およびデータキャプチャに関するルールのセットが指定されます。このようなフォームデザインには、ユーザー入力
に基づく値の計算機能が含まれます。これらのルールは、ユーザーがフォームにデータを入力する際、またはサーバーがデータをフォームにマージする
際に適用されます。
流動レイアウトのフォームは、不確定な量のデータをユーザーに表示する際に便利です。フォームの固定レイアウトやページ数を事前に決定する必要はあ
りません。流動レイアウトのフォームやフォームデザインが PDF フォームとしてレンダリングされる場合、インテリジェントな改ページが生成されます。
固定レイアウトのフォーム
固定レイアウトのフォームは、フィールドに入力されるデータの量に応じて変化することはありません。未入力のフィールドは、そのまま空の状態で
フォームに表示されます。逆に、データがフォームに収まりきらない場合でも、はみ出したデータを表示できるようにフォームを拡大することはできま
せん。
サーバー側のフォーム
サーバー側のフォームは、データ主導のフォームです。つまり、フォームのデータはレンダリング時に入力されます。フォームのレイアウトはデータの
量によって決まります。特定のフィールドにデータ値の複数のインスタンスを指定できます。これによって、そのフィールドが動的に複製され、個々の
データ値がフォーム内に表示されます。
フォームに対して動的に追加されるフィールドは、フォームデザイン内の「サブフォーム」と呼ばれる構造に格納されます。例えば、データベースに対
してクエリーを実行し、不特定件数のレコードを取得するカスタムアプリケーションで、サーバー側のフォームを使用できます。アプリケーションは
データベースからレコードを取得した後、データをフォームにマージします。データがフォームにマージされた時点で、ユーザーに対してフォームがレ
ンダリングされます。
クライアント側のフォーム
通常、クライアント側のフォームは、データ入力用の新しいフィールドを生成するボタン（またはその他のコントロール）をエンドユーザーにクリック
させることで、そのユーザーからデータを収集するような場合に使用されます。新しいフィールドは直ちにフォームに表示され、サーバーへのラウンド
トリップは必要ありません。つまり、フォームは LiveCycle ES2.5 に送信されません。クライアント側のフォームの例としては、購入する商品をユー
ザーが入力できるフィールドと、新しいフィールドを追加するためのボタンを含んだフォームが挙げられます。ユーザーがボタンをクリックするたびに、
フォームに新しいサブフォームが追加されます（サブフォームには、関連する一連のフィールドを表示できます）。
Forms サービスの要求処理
ここでは、Forms サービスで各種の要求（フォーム要求など）がどのように処理されるかについて説明します。イベントの発生順序や、スクリプトの実
行順序についても取り上げます。
ADOBE LIVECYCLE ES2.5
Forms サービス
49
LiveCycle ES2.5 サービス
フォームの要求
ユーザーが（HTML ページに配置されたボタンをクリックするなどして）Forms サービスからフォームを要求すると、Forms サービスの操作が開始さ
れます。次の表は、ユーザーがフォームを要求した場合に、クライアントデバイス（Web ブラウザなど）、クライアントアプリケーションおよび Forms
サービス間で行われるやり取りをまとめたものです。
ユーザーのアクション
クライアントアプリケーションのアクション
Forms サービスのアクション
ユーザーが Web ページからフォームを要求します。
アクションなし
アクションなし
アクションなし
renderPDFForm などの処理を呼び出し
アクションなし
ます。
アクションなし
アクションなし
指定されたフォームデザインを取得します。
アクションなし
アクションなし
データが Forms サービスに渡される場合、
フォームにデータが事前挿入されます。
アクションなし
アクションなし
フォームレベルのすべてのフィールド初期化イベ
ントを実行します。
アクションなし
アクションなし
フォームレベルのすべてのページ初期化イベント
を実行します。
アクションなし
アクションなし
フォームレベルのすべてのフィールド計算イベン
トを実行します。
アクションなし
アクションなし
フォームレベルのすべてのページ計算イベントを
実行します。
アクションなし
アクションなし
page enter イベントを実行します。
アクションなし
アクションなし
form ready イベントを実行します。
アクションなし
アクションなし
page enter または page exit イベントを実行しま
す。
アクションなし
アクションなし
フォームデザインを指定の形式に変換します。
アクションなし
アクションなし
フォームをクライアントアプリケーションに返し
ます。
アクションなし
エラーが返されなかったことを確認します。
アクションなし
バイナリストリームを作成して、クライアント
アクションなし
アクションなし
Web ブラウザに送信します。
Internet Explorer、Mozilla、Netscape Navigator、 アクションなし
Opera の各ブラウザでは、次のアクションが実行され
アクションなし
ます。
•
クライアント側でスクリプトを実行するように指
定された各フィールドの初期化を実行する。
•
クライアント側でスクリプトを実行するように指
定されたページ初期化を実行する。
•
クライアント側でスクリプトを実行するように指
定された各フィールドの計算を実行する。
•
クライアント側でスクリプトを実行するように指
定されたページの計算を実行する。
注意：これらのアクションは、フォームが HTML とし
てレンダリングされる場合にのみ実行されます。
フォームを PDF または HTML として閲覧します。
アクションなし
アクションなし
ADOBE LIVECYCLE ES2.5
Forms サービス
50
LiveCycle ES2.5 サービス
フォームデザインボタンの使用
Forms サービスがフォームデータを取得、計算を実行、またはフィールドデータを検証するためには、要求を開始するメカニズムをフォームが備えてい
る必要があります。この開始メカニズムは通常、フォームにあるボタンを使用して行います。コマンドボタンラベルに表示されるキャプションは、そのボ
タンの機能をエンドユーザーに示します。ユーザーがボタンをクリックすると、そのボタンに関連付けられたスクリプトにより、フォーム関連処理が実
行されます。通常は、ボタンにより、送信または計算のいずれかの処理が開始されます。
ボタンは、フォームデザインスクリプトに含まれるロジックを開始する最も一般的な方法です。Designer ES2.5 でフォームデザインにボタンを配置し、
送信オプションを設定すると、送信処理が設定されます。送信ボタンの目的は、フォームの入力を完了し、データを Forms サービスに送信することで
す。ただし、このプロセスは、検証処理により中断される場合があります。例えば、ユーザーが無効な値をフィールドに入力した場合、データを送信する
前に、ユーザーが値を訂正することが必要になる場合があります。フォームに計算ボタンを含めることもできます。計算ボタンでは、データの計算を実
行してフォームを更新できます。
送信ボタン
ボタンを使用すると、XML、PDF、または（HTML 送信用に）URL エンコードされたデータとして、フォームデータを Forms サービスに送信できま
す。例えば、ユーザーがインタラクティブフォームにデータを入力し、送信ボタンをクリックする状況を考えてみます。このアクションを実行すると、
フォームデータが Forms サービスに送信されます。このデータは、Forms Service API を使用して作成された Java サーブレットなどのクライアントア
プリケーションから取得できます。
PDF フォームからは、4 種類のデータ（XDP、XML、PDF、URL エンコードされたデータ）を送信できます。HTML フォームからは、URL エン
コードされた、名前と値のペアのみ送信できます。送信形式が PDF の場合、デフォルトでは Forms サービスが PDF データを取得し、計算を実行せずに
そのデータを返します。送信の種類は Designer ES2.5 で設定します。
送信 PDF データのコンテンツタイプは application/pdf です。一方、送信 XML データのコンテンツタイプは text/xml になります。
XDP 送信の場合は、application/vnd.adobe.xdp+xml になります。
次の表は、ユーザーがボタンのクリックによって送信処理を開始した場合に、クライアントデバイス（Web ブラウザなど）、クライアントアプリケー
ションおよび Forms サービス間で行われるやり取りをまとめたものです。
ユーザーのアクション
クライアントアプリケーションのアクション
Forms サービスのアクション
ユーザーがフォームフィールドにデータを入力
し、送信ボタンをクリックします。このアクショ
ンによって、送信処理が開始されます。
アクションなし
アクションなし
ブラウザがターゲット URL に対して HTTP POST アクションなし
を実行します。ターゲット URL の値は、
Designer ES2.5 で定義されるか、Forms サービ
スに対するレンダリング呼び出し中に使用される
targetURL パラメータによって定義されま
す。
アクションなし
アクションなし
FormServiceClient オブジェクトを作成し、
processFormSubmission メソッドを呼び出して、
HTTP 要求および HTTP ヘッダを渡します。
アクションなし
アクションなし
アクションなし
Forms サービスが、ポストされたデータを
クライアント側で実行するように指定されたク
ライアント検証を実行します。
フォームにマージします（該当する場合）。
アクションなし
アクションなし
フィールドの click イベントを実行します。
アクションなし
アクションなし
フォームレベルのフィールド計算イベントを実
行します。
アクションなし
アクションなし
フォームレベルのページ計算イベントを実行し
ます。
ADOBE LIVECYCLE ES2.5
Forms サービス
51
LiveCycle ES2.5 サービス
ユーザーのアクション
クライアントアプリケーションのアクション
Forms サービスのアクション
アクションなし
アクションなし
フォームレベルのフィールド検証イベントを実
行します。
アクションなし
アクションなし
ページ検証イベント（validate、
formatTest、nullTest など）を実
行します。
アクションなし
アクションなし
フォームの Close イベントを実行します。
アクションなし
アクションなし
この検証プロセスが失敗した場合は、少なくと
も 1 つのエラーが存在することを示します。返
される処理状態の値は Validate です。
アクションなし
Forms サービスから処理状態の値 Validate が返
アクションなし
されたことを確認します。この場合、ユーザーが誤り
を修正できるよう、結果がクライアントブラウザに返
されます。
HTML として表示されるフォームの場合、同じ
アクションなし
アクションなし
アクションなし
アクションなし
検証プロセスが成功した場合、処理状態の値が
Submit に設定されます。
アクションなし
Forms サービスから処理状態の値 Submit が返され アクションなし
データ、計算、および（再度送信する前に修正
する必要のある）エラーのリストを含むフォー
ムがエンドユーザーに表示されます。
ガイドの場合、同じデータ、計算、および（再
度送信する前に修正する必要のある）エラーの
リストを含むフォームがエンドユーザーに表示
されます。
PDF として表示されるフォームの場合、ユー
ザーインターフェイスは定義されません。検証エ
ラーは、 FormsResult オブジェクトの
getValidationErrorsList メソッ
ドを使用して取得できます。
たことを確認します。
すべてのフォーム処理が完了したことを確認します。
それ以外の処理は、アプリケーションによって異なり
ます。例えば、ウィザード形式のアプリケーションで
は、次のフォームパネルの要求、詳細なデータ調査、
データベースの更新、新しいワークフロープロセスの
開始などを実行できます。
ここでの表示内容は、アプリケーションによっ
て異なります。例えば、新しいフォームを表示す
ることもできます。
アクションなし
アクションなし
ADOBE LIVECYCLE ES2.5
Forms サービス
LiveCycle ES2.5 サービス
計算ボタン
ボタンは、計算処理の実行に使用できます。ユーザーがボタンをクリックすると、Forms サービスはフォームデザインにある計算スクリプトを実行しま
す。その結果が表示されたフォームを Web ブラウザに返してレンダリングします （「フォームデータの計算」(62 ページ ) を参照）。
次の表は、ユーザーが計算処理を開始した場合に、クライアントアプリケーションと Forms サービスの間で行われるやり取りをまとめたものです。
ユーザーのアクション
クライアントアプリケーションのアクション
Forms サービスのアクション
ユーザーがフォーム上のボタンをクリックします。
アクションなし
アクションなし
FormsServiceClient オブジェクト
アクションなし
ボタンの Click イベントがクライアント側で実行す
るように指定されていた場合、フォームは Forms サー
ビスに送信されません。対応するスクリプトが Web
ブラウザ、Acrobat または Adobe Reader で実行され
ます。
ガイドでは、XFASubset が ActionScript として実装
されます。ActionScript は Adobe Flash® Player で実
行されます。
ボタンの Click イベントがサーバー側で実行するよ
うに指定されていた場合、フォームは Forms サービス
に送信されません。
アクションなし
を作成し、
processFormSubmission メソッド
を呼び出します。
アクションなし
アクションなし
Forms サービスが、新しいデータをフォームデ
ザインにマージします（該当する場合）。
アクションなし
アクションなし
フィールドの click イベントを実行します。
アクションなし
アクションなし
フォームレベルのフィールド計算イベントを実
行します。
アクションなし
アクションなし
フォームレベルのページ計算イベントを実行し
ます。
アクションなし
アクションなし
page enter または page exit イベントを実行し
ます。
アクションなし
アクションなし
フォームレベルのフィールド検証イベントを実
行します。
アクションなし
アクションなし
ページ検証イベントを実行します。
アクションなし
アクションなし
page exit イベントを実行します。
アクションなし
アクションなし
Forms サービスを呼び出したクライアントアプ
リケーションにフォームを返します。フォーム
の形式は変更されません。フォームが PDF で送
信された場合、クライアントブラウザには PDF
で返されます。
アクションなし
アクションなし
Forms サービスからエラーが返されなかったこ
とを確認します。
アクションなし
バイナリストリームを作成して、クライアント
アクションなし
Web ブラウザに送信します。
フォームに表示された計算結果を確認します。
アクションなし
アクションなし
52
ADOBE LIVECYCLE ES2.5
Forms サービス
53
LiveCycle ES2.5 サービス
Forms サービスの使用
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 のヘルプを参照してください。プログラムによってこのサービス
とやり取りできるクライアントアプリケーションの作成について詳しくは、『Programming with LiveCycle ES2.5』を参照してください。
インタラクティブな PDF フォームのレンダリング
Forms サービスは、Web ブラウザなどのクライアントデバイスで、インタラクティブな PDF フォームまたは XDP ファイルをレンダリングします。イ
ンタラクティブフォームがレンダリングされたら、ユーザーはフォームフィールドにデータを入力し、「送信」ボタンをクリックして、情報を Forms
サービスに送り返すことができます。インタラクティブな PDF フォームを表示するためには、クライアント Web ブラウザをホストするコンピュータに
Adobe Reader® または Acrobat がインストールされている必要があります。
1
Forms サービスを使用してフォームをレンダリングするには、まずフォームデザインを作成する必要があります。通常、フォームデザインは Designer
ES2.5 で作成し、XDP ファイルとして保存します。
注意 : LiveCycle 7.x リリースの Forms サービスでは、タグなし
は、タグ付き PDF ファイルがデフォルトで作成されます。
PDF ファイルがデフォルトで作成されました。LiveCycle ES2.5 の Forms サービスで
クライアントでのフォームのレンダリング
Acrobat または Adobe Reader のクライアント側のレンダリング機能を使用すると、PDF コンテンツの配信を最適化し、Forms サービスの機能を向上さ
せてネットワークの負荷に対応することができます。このプロセスを、クライアントでのフォームのレンダリングと呼びます。クライアントでフォームを
レンダリングするには、クライアントデバイス（通常は Web ブラウザ）で、Acrobat 7.0 または Adobe Reader 7.0 以降を使用する必要があります。
Acrobat または Adobe Reader のクライアント側のレンダリング機能を使用すると、PDF コンテンツの配信を最適化し、Forms サービスの機能を向上
させてネットワークの負荷に対応することができます。
ADOBE LIVECYCLE ES2.5
Forms サービス
54
LiveCycle ES2.5 サービス
ガイドのレンダリング
ガイドは Adobe Flash® テクノロジに基づいており、ユーザーからデータを取得するための見栄えの良い、簡素化された方法を備えています。ガイドは、
ある時点でユーザーに表示される情報を論理的にグループ化または簡素化し、使いやすさを向上させることで、データ入力エラーを減らします。
LiveCycle ES2.5 では、Forms サービスは、LiveCycle Designer ES（バージョン 8.x）で作成された従来のフォームデザインのみをフォームガイドにレ
ンダリングすることができます。Forms サービスを使用して、Workbench で Guide Builder を使用して作成した LiveCycle ES2.5 ガイドをレンダリン
グすることはできません。LiveCycle ES2.5 ガイドの作成およびレンダリング方法については、「Getting Started with Guides」を参照してください。
HTML としてのフォームのレンダリング
Forms サービスは、指定されたフォームを取得し、そのフォームを HTML フォームに変換して、HTML としてレンダリングします。HTML 変換の種
類を選択できます。フォームを HTML としてレンダリングすることには利点があります。クライアント Web ブラウザのあるコンピュータに、Adobe
Reader、Acrobat または Flash Player（ガイド用）が必要ないという点です。
フォームを HTML としてレンダリングするためには、フォームデザインを XDP ファイルとして保存しておく必要があります。PDF ファイルとして保
存されたフォームデザインを、HTML としてレンダリングすることはできません。
フォームデザインについては、HTML フォームのレイアウトの考慮事項に関するガイドラインに従うことをお勧めします。これは、レンダリングされる
HTML フォームで文字がずれる問題に対応するためです （LiveCycle Designer ES2.5 のヘルプで、「LiveCycle Designer ES2.5 の使用」／「LiveCycle
Forms ES2.5 用フォームの作成」／「HTML フォームの作成」／「HTML フォームのレイアウトの考慮点」を参照）。
Forms IVS を使用したテスト用データセットによるフォームのテスト
Forms IVS（Forms Installation and Verification Sample）は、テスト用データセットでフォームをテストできるサンプルアプリケーションです。
Forms IVS は、Forms サービスが提供する renderPDFForm、renderHTMLForm、processFormSubmission などの各操作を使
用します。
Forms IVS を使用するには、それをデプロイする必要があります。管理者は LiveCycle Configuration Manager を使用して Forms IVS をデプロイする
ことができます。また、Forms IVS は、手動でデプロイすることもできます 詳しくは、『LiveCycle ES2 のインストールおよびデプロイ（JBoss 版）』な
ど、LiveCycle のインストールガイドを参照してください。
Forms IVS アプリケーションを開くには、http://[server_name:port_number]/FormsIVS に移動します。
ADOBE LIVECYCLE ES2.5
Forms サービス
55
LiveCycle ES2.5 サービス
ジョブの特性を指定し、ジョブを送信するには、Adobe LiveCycle Forms ES2.5 バナーの Test Forms リンクをクリックします。Test Forms ウィンド
ウでは、次のような設定を指定できます。
•
•
•
•
テスト対象のフォーム
フォームと統合するデータファイル
出力形式
パフォーマンステストの選択
Forms IVS が使用する設定を変更するには、Adobe LiveCycle Forms ES2.5 バナーの環境設定リンクをクリックします。環境設定ウィンドウでは、次
のような設定を指定できます。
•
•
Forms ES2.5 サービスに渡すオプション
Forms IVS が取得するフォーム、データ、XDC、関連ファイルが存在する場所。場所は、URL、リポジトリの場所、または LiveCycle ES2.5 をホ
ストするコンピュータ上のフォルダからの絶対参照のいずれかです。リポジトリの場所は、repository:/ または repository:/// として指定できます。
•
•
•
アプリケーションのルートおよびエンドポイント
管理者の秘密鍵証明書
フォームのレンダリングオプション
ルートディレクトリのファイルを表示または削除するには、Adobe LiveCycle Forms ES2.5 バナーの Maintenance リンクをクリックします。削除でき
るファイルは、Forms IVS に追加したファイルのみです。Forms IVS と共にインストールされているファイルは削除できません。
Forms IVS のヘルプを参照するには、Adobe LiveCycle Forms ES2.5 バナーの Help リンクをクリックしてください。
Forms サービスのオプション
フラグメントに基づいたフォームのレンダリング
Forms サービスでは、Designer ES2.5 を使用して作成するフラグメントに基づいてフォームをレンダリングすることができます。「フラグメント」は、
フォームの再使用可能な部分であり、複数のフォームデザインに挿入できる独立した XDP ファイルとして保存されます。例えば、フラグメントに住所ブ
ロックや法的文書を含めることができます。
フラグメントを使用すると、大量のフォームを簡単かつ高速に作成し、管理できます。フォームを作成するときに必要なフラグメントへの参照を挿入す
ると、そのフラグメントがフォームに表示されます。フラグメントの参照には、物理的な XDP ファイルを指定するサブフォームが含まれています。フラ
グメントの作成について詳しくは、LiveCycle Designer ES2.5 のヘルプを参照してください。
フラグメントには、選択したサブフォームセットでラップされた複数のサブフォームを含めることができます。「選択したサブフォームセット」は、
データ接続からのデータのフローに基づき、サブフォームの表示を制御します。セットから、配信されるフォームで表示するサブフォームを決定するに
は、条件ステートメントを使用します。例えば、セットの各サブフォームに特定の地理的な場所に関する情報を含めることができます。また、ユーザーの
場所に応じて、表示されるサブフォームを決定することもできます。
「スクリプトフラグメント」には、日付解析や Web サービスの起動など、特定のオブジェクトとは別に保存される、再利用可能な JavaScript 関数や値が含
まれます。これらのフラグメントには、Designer ES2.5 の階層パレットで変数の子として表示される 1 つのスクリプトオブジェクトが含まれます。フラグ
メントは、検証、計算、初期化などのイベントスクリプトのように、他のオブジェクトのプロパティであるスクリプトから作成することはできません。
フラグメントを使用すると、次のような利点があります。
コンテンツの再使用： フラグメントを使用すると、複数のフォームデザインでコンテンツを再利用できます。同じコンテンツの一部を複数のフォームで使
用するには、コンテンツをコピーまたは再作成するよりも、フラグメントを使用する方が迅速で簡単です。また、フラグメントを使用すると、フォーム
デザインで頻繁に使用される部分に対して、それを参照するすべてのフォームに一貫性のあるコンテンツと外観を与えることができます。
ADOBE LIVECYCLE ES2.5
Forms サービス
56
LiveCycle ES2.5 サービス
グローバルな更新： フラグメントを使用すると、1 つのファイルで 1 回行うだけで、複数のフォームにグローバルに変更を適用できます。フラグメントで
は、コンテンツ、スクリプトオブジェクト、データバインディング、レイアウトまたはスタイルを変更できます。この変更は、そのフラグメントを参照
するすべての XDP フォームに反映されます。
例えば、多くのフォームで使用されている共通の要素の例として、特定の国のドロップダウンリストオブジェクトを含む宛先ブロックがあります。この
ドロップダウンリストオブジェクトの値を更新するには、多くのフォームを開いて変更を行う必要があります。この場合に、フラグメントに宛先ブロッ
クを挿入すると、1 つのフラグメントファイルを開いて変更するだけで済みます。
PDF フォームのフラグメントを更新するためには、フォームを Designer ES2.5 に再保存します。
共有フォームの作成： フラグメントを使用して、複数のリソース間でフォームの作成を共有できます。スクリプトまたは Designer ES2.5 のその他の高度
な機能に精通しているフォーム開発者は、スクリプトまたは動的プロパティを活用するフラグメントを作成、共有することができます。フォーム作成者
がこれらのフラグメントを使用してフォームデザインをレイアウトすることによって、複数の作成者によってデザインされる複数のフォーム間で、
フォームのすべての部分が一貫した外観と機能を持つようにすることができます。
使用権限を付与されたフォームのレンダリング
Forms サービスは、使用権限を与えられたフォームをレンダリングできます。使用権限は、Acrobat ではデフォルトで利用できるが Adobe Reader で
は利用できない、フォームにコメントを追加する機能や、フォームフィールドにデータを入力してフォームを保存する機能などに適用されます。使用権
限を与えられたフォームを、使用権限を付与されたフォームと呼びます。使用権限を付与されたフォームを Adobe Reader で開いたユーザーは、その
フォームで有効になっている操作を実行できます。
フォームに使用権限を付与するには、LiveCycle のインストール時に Reader Extensions サービスを選択する必要があります。また、使用権限を PDF ド
キュメントに付与できるようするための有効な秘密鍵証明書も必要です。つまり、使用権限を付与されたフォームをレンダリングするためには、あらか
じめ Reader Extensions サービスを正しく設定しておく必要があります （「Reader Extensions サービス」(105 ページ ) を参照）。
注意 : 使用権限を含むフォームをレンダリングするには、PDF ファイルではなく、XDP ファイルを入力として使用します。PDF ファイルを入力として
使用する場合でもフォームはレンダリングされますが、使用権限を付与されたフォームにはなりません。
注意 : コメントの有効化、オンラインコメントの有効化、埋め込み添付ファイルの有効化、電子署名の有効化の各使用権限を指定する場合は、XML デー
タを使用してフォームに事前入力することはできません。
ADOBE LIVECYCLE ES2.5
Forms サービス
57
LiveCycle ES2.5 サービス
送信済みフォームの処理
ユーザーがインタラクティブフォームにデータを入力できるようにする Web ベースのアプリケーションでは、データをサーバーに送り返す必要がありま
す。Forms サービスを使用すると、ユーザーがインタラクティブフォームに入力したデータを取得することができます。取得したデータは、ビジネスの
要件に応じて処理できます。例えば、次のタスクを実行できます。
•
•
•
•
•
データをデータベースに保存します。
データを別のアプリケーションに送信します。
データを別のサービスに送信します。
データをフォームデザインにマージします。
データを Web ブラウザで表示します。
フォームデータは、XML データまたは PDF データとして Forms サービスに送信されます。このオプションは、Designer ES2.5 で設定します。XML
としてフォームデータを送信すると、個別のフィールドデータ値を抽出できます。つまり、ユーザーがフォームに入力した値を、各フォームフィールド
から抽出できます。PDF データとして送信されるフォームデータは、XML データではなくバイナリデータです。このため、フィールド値を抽出すること
はできません。ただし、フォームを PDF ファイルとして保存するか、別のサービスに送信することができます。
送信済み XML データの処理
フォームデータが XML として送信された場合、その送信データを表す XML データを取得できます。すべてのフォームフィールドは、XML スキーマの
ノードとして表現されます。ノードの値は、ユーザーによって入力された値に対応します。例えば、フォーム内の各フィールドが XML データ内のノード
として表現されるローンフォームを考えてみてください。それぞれのノードの値は、ユーザーが入力した値に対応します。データ入力に使用するローン
フォームが、次のような形式になっているとします。
ADOBE LIVECYCLE ES2.5
Forms サービス
58
LiveCycle ES2.5 サービス
次の図は、Forms サービスを使用して取得された、対応する XML データを表しています。
データを XML データとして送信するためには、Designer ES2.5 で、フォームデザインが正しく設定されている必要があります。フォームデザインを適
切に設定して、XML データを送信できるようにするには、フォームデザイン上に配置された「送信」ボタンに対し、XML データを送信するために必要
な設定を行う必要があります （LiveCycle Designer ES2.5 のヘルプを参照）。
また、XML データを処理するには、正しいコンテンツタイプを指定する必要があります。例えば、application/vnd.adobe.xdp+xml と
指定します。コンテンツタイプは、送信されるフォームデータと一致していることが必要です。さらに、次のように、コンテンツタイプの値を複数指定す
ることで、様々なフォーム送信に対応できます。
CONTENT_TYPE=application/pdf&CONTENT_TYPE=application/vnd.adobe.xdp+xml
送信済み PDF データの処理
Forms サービスを呼び出す Web アプリケーションがあるとします。Forms サービスがインタラクティブな PDF フォームをクライアントブラウザにレン
ダリングした後、ユーザーは、インタラクティブフォームにデータを入力し、そのフォームを PDF データとして送り返します。Forms サービスは、
PDF データを受信したときに、そのデータを他のサービスに送信したり、PDF ファイルとして保存したりすることができます。送信済み PDF フォーム
を処理するには、コンテンツタイプとして CONTENT_TYPE=application/pdf を指定する必要があります。
フォームへの事前入力
フォームに事前入力すると、レンダリングされるフォーム内で、データがユーザーに表示されます。例えば、ユーザー名とパスワードを使用してユー
ザーが Web サイトにログインするとします。認証に成功すると、カスタムアプリケーションがユーザー情報についてデータベースに対してクエリーを実
行します。次に、データがフォームにマージされ、フォームがユーザーに表示されます。その結果、フォーム内に個人設定されたデータが表示されます。
フォームへの事前入力には、次のような利点があります。
•
•
•
フォームでカスタムデータをユーザーに表示できます。
ユーザーがフォームで行う入力の量が減ります。
データを入力する場所が制御され、データの整合性が確実になります。
ADOBE LIVECYCLE ES2.5
Forms サービス
59
LiveCycle ES2.5 サービス
フォームに事前入力できるのは、次の 2 つの XML データソースです。
•
•
XDP データソース。これは、XFA 構文に従う XML（または Acrobat を使用して作成されたフォームに事前入力するための XFDF データ）です。
フォームのフィールド名に一致する名前と値のペアを含む、任意の XML データソース。
XML 要素は、事前入力するフォームフィールドごとに存在している必要があります。XML 要素名は、フィールド名と一致している必要があります。
XML 要素がフォームフィールドに対応していない場合、または XML 要素名がフィールド名に一致していない場合、XML 要素は無視されます。すべて
の XML 要素を指定していれば、XML 要素を表示する順序どおりとする必要はありません。
既にデータを含んでいるフォームに事前入力する際は、XML データソース内で既に表示されているデータを指定します。10 個のフィールドを含む
フォームで、そのうち 4 つのフィールドにデータがあるとします。次に、残りの 6 つのフィールドに事前入力するとします。この状況では、フォームへの
事前入力に使用される XML データソースで、10 個の XML 要素を指定する必要があります。6 つの要素のみを指定する場合、元の 4 つのフィールドは
空になります。
例えば、ある確認フォームに事前入力するには、3 つのフォームフィールドに一致する 3 つの XML 要素を含む XML データソースを作成する必要があ
ります。このフォームに含まれるフィールドは、 FirstName、 LastName および Amount の 3 つのフィールドが含まれます。最初の手順は、
フォームデザインにあるフィールドに一致する XML 要素を含む XML データソースを作成することです。これは次の XML コードのようになります。
<Untitled>
<FirstName>
<LastName>
<Amount>
</Untitled>
次の手順では、次の XML コードに示すように、XML 要素にデータ値を割り当てます。
<Untitled>
<FirstName>Jerry</FirstName>
<LastName>Johnson</LastName>
<Amount>250000</Amount>
</Untitled>
この XML データソースを確認フォームに事前入力し、フォームをレンダリングすると、XML 要素に割り当てたデータ値が表示されます。次の図のよう
にデータ値が表示されます。
ADOBE LIVECYCLE ES2.5
Forms サービス
60
LiveCycle ES2.5 サービス
流動レイアウトのフォームへの事前入力
流動レイアウトのフォームは、不確定な量のデータをユーザーに表示する際に便利です。このようなフォームのレイアウトは、マージされるデータの量
に応じて自動的に調整されます。したがって、固定レイアウトのフォームとは異なり、ページ数を事前に決める必要がありません。
通常、流動レイアウトのフォームには、実行中に取得されるデータが入力されます。その結果、メモリ内 XML データソースを作成し、そこにデータを直
接配置して、フォームに事前入力することができます。
次の図は、流動レイアウトの発注書フォームの例を示しています。
A. フォームのヘッダデータを表します B. フォームの動的な部分を表します
注意 : フォームには、エンタープライズデータベースや外部アプリケーションなど、他のソースからのデータを事前入力することもできます。
ADOBE LIVECYCLE ES2.5
Forms サービス
61
LiveCycle ES2.5 サービス
データサブグループについて
フォームへの事前入力には XML データソースが使用されます。流動レイアウトのフォームへの事前入力に使用される XML データソースには、繰り返し
データサブグループが含まれます。次の XML コードは、発注書フォームへの事前入力に使用される XML データソースを示しています。
<header>
<!-- 住所、 都道府県な ど 、 反復 し な い フ ィ ー ル ド へ の事前入力 に 使用 さ れ る XML
<! 要素
<txtPONum>8745236985</txtPONum>
<dtmDate>2004-02-08</dtmDate>
<txtOrderedByCompanyName>Any Company Name</txtOrderedByCompanyName>
<txtOrderedByAddress>555, Any Blvd.</txtOrderedByAddress>
<txtOrderedByCity>Any City</txtOrderedByCity>
<txtOrderedByStateProv>ST</txtOrderedByStateProv>
<txtOrderedByZipCode>12345</txtOrderedByZipCode>
<txtOrderedByCountry>Any Country</txtOrderedByCountry>
<txtOrderedByPhone>(123) 456-7890</txtOrderedByPhone>
<txtOrderedByFax>(123) 456-7899</txtOrderedByFax>
<txtOrderedByContactName>Contact Name</txtOrderedByContactName>
<txtDeliverToCompanyName>Any Company Name</txtDeliverToCompanyName>
<txtDeliverToAddress>7895, Any Street</txtDeliverToAddress>
<txtDeliverToCity>Any City</txtDeliverToCity>
<txtDeliverToStateProv>ST</txtDeliverToStateProv>
<txtDeliverToZipCode>12346</txtDeliverToZipCode>
<txtDeliverToCountry>Any Country</txtDeliverToCountry>
<txtDeliverToPhone>(123) 456-7891</txtDeliverToPhone>
<txtDeliverToFax>(123) 456-7899</txtDeliverToFax>
<txtDeliverToContactName>Contact Name</txtDeliverToContactName>
</header>
<detail>
<!-- モ ニ タ に 関す る 情報 を 含む デ ー タ サ ブ グ ル ー プ >
<txtPartNum>00010-100</txtPartNum>
<txtDescription>Monitor</txtDescription>
<numQty>1</numQty>
<numUnitPrice>350.00</numUnitPrice>
</detail>
<detail>
<!-- 電気 ス タ ン ド に 関す る 情報 を 含む デ ー タ サ ブ グ ル ー プ >
<txtPartNum>00010-200</txtPartNum>
<txtDescription>Desk lamps</txtDescription>
<numQty>3</numQty>
<numUnitPrice>55.00</numUnitPrice>
</detail>
<detail>
<!-- 電話機 に 関す る 情報 を 含む デ ー タ サ ブ グ ル ー プ >
<txtPartNum>00025-275</txtPartNum>
<txtDescription>Phone</txtDescription>
<numQty>5</numQty>
<numUnitPrice>85.00</numUnitPrice>
</detail>
<detail>
<!-- ア ド レ ス 帳 に 関す る 情報 を 含む デ ー タ サ ブ グ ル ー プ >
<txtPartNum>00300-896</txtPartNum>
<txtDescription>Address book</txtDescription>
<numQty>2</numQty>
<numUnitPrice>15.00</numUnitPrice>
</detail>
ADOBE LIVECYCLE ES2.5
Forms サービス
62
LiveCycle ES2.5 サービス
各データサブグループには、次の情報に対応する 4 つの XML 要素が含まれます。
•
•
•
•
アイテムの品番
アイテムの説明
アイテムの数量
単価
データサブグループの親 XML 要素の名前は、フォームデザイン内のサブフォームの名前に一致する必要があります。例えば、前の図では、データサブ
グループの親 XML 要素の名前は detail です。これは、発注書フォームの基になっているフォームデザインにあるサブフォームの名前に対応します。
データサブグループの親 XML 要素の名前とサブフォームが一致しない場合は、サーバー側のフォームは事前入力されません。
各データサブグループには、サブフォームのフィールド名に一致する XML 要素が含まれている必要があります。フォームデザインの detail サブ
フォームには、次のフィールドが含まれています。
•
•
•
•
txtPartNum
txtDescription
numQty
numUnitPrice
フォームデータの計算
Forms サービスは、ユーザーがフォームに入力した値を計算し、結果を表示することができます。フォームデータを計算するには、フォームデータを計
算するフォームデザインスクリプトを作成します。フォームデザインは、3 種類のスクリプトをサポートしています。スクリプトの種類には、クライアン
トで実行されるもの、サーバーで実行されるもの、およびサーバーとクライアントの両方で実行されるものがあります。このトピックで説明するスクリ
プトの種類は、サーバーで実行されます。サーバー側の計算は、HTML、PDF およびガイドの変換に対してサポートされます。
フォームデザインプロセスの一環として、計算とスクリプトを使用することで、より高度なユーザーエクスペリエンスを提供できます。計算とスクリプ
トは、ほとんどのフィールドとオブジェクトに追加できます。
ユーザーはフォームに値を入力し、「計算」ボタンをクリックして結果を表示します。次のプロセスは、ユーザーがデータを計算できるようにするアプリ
ケーションの例を示しています。
•
ユーザーは、StartLoan という、Web アプリケーションのスタートページとして機能する HTML ページにアクセスします。このページは、
•
GetLoanForm という名前の Java サーブレットを起動します。
GetLoanForm サーブレットは、ローンフォームをレンダリングします。このフォームには、スクリプト、インタラクティブフィールド、「計算」
ボタンおよび「送信」ボタンが含まれています。
•
ユーザーはフォームフィールドに値を入力し、「計算」ボタンをクリックします。このフォームは CalculateData Java サーブレットに送ら
•
ユーザーは、期待どおりの結果が表示されるまで、値の入力と計算を継続します。期待どおりの結果が得られたら、ユーザーは「送信」ボタンをク
れ、ここでスクリプトが実行されます。フォームがユーザーに送り返され、計算結果がフォームに表示されます。
リックしてフォームを処理します。送信されたデータを取得する、 ProcessForm という別の Java サーブレットにフォームが送信されます。
（「送信済みフォームの処理」(57 ページ ) を参照）。
ADOBE LIVECYCLE ES2.5
Forms サービス
63
LiveCycle ES2.5 サービス
次の図は、アプリケーションの論理フローを示しています。
この図の各手順は次のとおりです。
1
GetLoanForm Java™ サーブレットが HTML スタートページから起動されます。
2
GetLoanForm Java サーブレットは、Forms サービス クライアント API を使用して、クライアント Web ブラウザでローンフォームをレンダリ
ングします。サーバーで実行するように設定されたスクリプトを含むフォームのレンダリングは、スクリプトを含まないフォームのレンダリングとは
異なります。その違いは、スクリプトの実行に使用するターゲットの場所を指定する必要があることです。ターゲットの場所を指定しないと、サー
バーで実行するように設定されたスクリプトは実行されません。例えば、ここで示したアプリケーションでは、 CalculateData Java サーブ
レットが、スクリプトを実行するターゲットの場所です。
3
ユーザーは、インタラクティブフィールドにデータを入力し、「計算」ボタンをクリックします。このフォームは CalculateData Java サーブ
レットに送られ、ここでスクリプトが実行されます。
4
フォームが Web ブラウザでレンダリングされ、計算結果がフォームに表示されます。
5
ユーザーは、値が期待どおりの場合は「送信」ボタンをクリックします。 ProcessForm という別の Java サーブレットにフォームが送信されま
す。
通常、PDF コンテンツとして送信されるフォームには、クライアントで実行されるスクリプトが含まれます。ただし、サーバー側の計算も実行できます。
「送信」ボタンは、スクリプトの計算には使用できません。この状況では、Forms サービスで操作が完了したと見なされるので、計算は実行されません。
ADOBE LIVECYCLE ES2.5
Forms サービス
64
LiveCycle ES2.5 サービス
フォームデザインスクリプトの使用方法を示すため、この節では、サーバーで実行されるように設定されたスクリプトを含む、単純なインタラクティブ
フォームについて説明します。次の図は、スクリプトを含むフォームデザインを示しています。このスクリプトは、ユーザーが最初の 2 つのフィールドに
入力する値を合計し、結果を 3 番目のフィールドに表示します。
A. NumericField1 という名前のフィールド B.NumericField2 という名前のフィールド C. NumericField3 という名前のフィールド
このフォームデザインに含まれるスクリプトの構文は次のとおりです。
NumericField3 = NumericField2 + NumericField1
このフォームデザインで、
「計算」ボタンはコマンドボタンであり、スクリプトはこのボタンの Click イベントに設定されます。ユーザーが最初の 2 つ
のフィールドに値を入力して「計算」ボタンをクリックすると、スクリプトが実行されます。Forms サービスは、クライアントデバイスで再びフォーム
をレンダリングし、計算結果を NumericField3 フィールドに表示します。
フォームデザインスクリプトについて詳しくは、LiveCycle Designer ES2.5 のヘルプを参照してください。
Forms サービスに関する考慮事項
Forms サービスを使用する場合、次の点に関する考慮事項があります。
•
•
•
•
•
•
フォームデザインの計画
Forms サービスのフォームデザインの作成
画像を含んだフォームのレンダリング
保護された画像を含んだフォームのレンダリング
画像フィールドに対する変更（スクリプトを使用した変更は保持されない）
LiveCycle ES2.5 で使用可能なフォントの確認
フォームデザインの計画
Forms サービスを使用したアプリケーションロジックの作成は、クライアントアプリケーションを作成する 1 つの側面にすぎません。Forms サービスで
は、通常は Designer ES2.5 で作成されたフォームデザインが必要です（フォームは Acrobat でも作成できます）。フォームデザインは、XDP ファイル
または PDF ファイルとして保存されている XML テンプレートです。Forms サービスは、入力の種類に応じて、PDF または HTML として表示される
フォームを出力します。次の図は、Forms サービスの有効な入力と出力を示しています。
ADOBE LIVECYCLE ES2.5
Forms サービス
65
LiveCycle ES2.5 サービス
.xdp ファイルとして保存されたフォームデザインの使用
出力
HTML として表示されるフォーム
PDF
入力
出力
.xdp ファイルとして保存されたフォームデザイン
PDF として表示されるフォーム
出力
Forms サービス
フォームガイド（SWF）として表示されるフォーム
.pdf ファイルとして保存されたフォームデザインの使用
PDF
PDF
出力
入力
.pdf ファイルとして保存されたフォームデザイン
PDF コンテンツとして表示されるフォーム
Forms サービス
アプリケーションの計画において最初の手順は、フォームの出力形式を決定することです。フォームデザインを次のいずれかの方法で保存します。
•
•
XDP ファイル。Forms サービスは、PDF また HTML として表示されるフォームを出力します。
PDF または XDP。Forms サービスは、PDF のみを出力します。
Forms サービスのフォームデザインの作成
PDF および HTML をレンダリングするために使用されるフォームデザインの間には、動作の相違があります。PDF としてレンダリングされるフォーム
デザインは、Acrobat または Adobe Reader を使用して表示されます。
HTML としてフォームをレンダリングする場合、クライアントデバイス（古いブラウザなど）によっては、個々のオブジェクトプロパティに対して、同
じレベルのサポートが提供されない場合もあります。これらの制限を低減する単一のフォームデザインを作成するには、次のプロセスに従います。
1
特定のクライアントデバイスでのオブジェクトの動作については、『Transformation Reference』を参照してください。
2
固定レイアウトのフォームをデザインして HTML として出力する場合、変換キャッシュを有効にします（LiveCycle Designer ES2.5 のヘルプを参照）。
3
フォームデザインを作成する際は、サポートされていないオブジェクトプロパティに依存せずにフォームを実装する方法を探し、制限に対処します。
4
必要に応じて、PDF と HTML の両方に有効なレイアウトを含めます。
5
LiveCycle Designer ES2.5 のヘルプの「アクセシブルなフォームの作成」を参照し、ガイドラインに従ってアクセシビリティをフォームデザインに組
み込みます。
ADOBE LIVECYCLE ES2.5
Forms サービス
6
66
LiveCycle ES2.5 サービス
フォーム開発者に、スクリプトを実行する場所を確認します。デフォルトでは、スクリプトはクライアントで実行されます。フォームデザインに含め
るスクリプトがサーバーまたは、クライアントとサーバーの両方で実行される場合は、デフォルトの設定を変更する必要があります。例えば、フォー
ムデザインに、サーバーでのみ使用可能なエンタープライズデータベースからデータを抽出するスクリプトが含まれている場合があります。このよう
な場合、スクリプトをサーバーで実行するよう、デフォルトの設定を修正する必要があります。
7
Designer ES2.5 またはクライアントデバイス（Web ブラウザなど）を使用して定期的にフォームをプレビューし、デザインプロセスの早い段階で
問題のトラブルシューティングを行います。
8
Forms サービスがフォームに事前入力する場合は、テストデータを使用してフォームデザインを完全にテストします。
Forms サービスがフォームデータを取得、計算を実行、またはフィールドデータを検証するためには、要求を開始するメカニズムをフォームが備えてい
る必要があります。これは通常、フォームデザインにあるボタンを使用して行います。コマンドボタンラベルに表示されるキャプションは、そのボタンの
機能をエンドユーザーに示します。ユーザーがボタンをクリックすると、そのボタンに関連付けられたスクリプトにより、フォーム関連処理が実行され
ます。通常は、ボタンにより、送信または計算のいずれかの処理が開始されます。
ボタンは、フォームデザインスクリプトに含まれるロジックを開始する最も一般的な方法です。Designer ES2.5 でフォームデザインにボタンを配置し、
送信オプションを設定すると、送信処理が設定されます。送信ボタンの目的は、フォームの入力を完了し、データを Forms サービスに送信することで
す。ただし、このプロセスは、検証処理により中断される場合があります。例えば、ユーザーが間違った値を入力した場合、フォームデータを送信する前
に、ユーザーが値を訂正することが必要になる場合があります。フォームにその他のボタンタイプを配置すると、計算処理が設定されます。計算処理は、
送信処理の前に、計算を実行してフォームを更新することを目的としています。
画像を含んだフォームのレンダリング
レンダリングするフォームに画像を参照するデータが含まれていると、レンダリングされたフォームに、その画像が適切に表示されません。クライアン
ト側でのフォームのレンダリング時に、画像を正常にレンダリングできるようにするには、次の実行時オプションを設定します。
•
•
•
PDFVersion=1.6（以上）
CacheEnabled=0
renderAtClient=Auto
サーバー側のデータでフォームをレンダリングするには、CacheEnabled=0 という実行時オプションを設定します。
保護された画像を含んだ PDF フォームのレンダリング
レンダリングしている HTML フォームに証明書で保護された画像が含まれていると、例外が発生する場合があります。例えば、Forms IVS アプリケー
ションを使用して、保護された画像を含んだフォームをレンダリングした場合、例外が発生します。
この問題を解決するには、J2EE アプリケーションサーバーの起動時に使用したオペレーティングシステムのユーザー名およびパスワード値が、クライア
ント側証明書を追加するときに使用したものと一致していることを確認します。これにより、Forms サービスが、画像を取得するために必要な秘密鍵証
明書にアクセスできるようになります。
画像フィールドに対する変更（スクリプトを使用した変更は保持されない）
フォームデザイン上に配置された画像フィールドに対し、JavaScript などのクライアント側スクリプトを使用して変更を加えた場合、その変更は送信さ
れず、クライアントアプリケーションで取得することはできません。例えば、スクリプトを使用して画像フィールドに変更を加えた後、次のページや前
のページに移動するアクションが実行された場合、スクリプトによる変更内容が維持されません。このことは、HTML としてレンダリングされるフォー
ムにも該当します。
デバッグオプションの有効化
PDF フォーム、使用権限を付与された PDF フォーム、またはガイドをレンダリングする場合は、デバッグオプションを有効にできます。デバッグオプ
ションを有効にすることにより、実行時の値など、特別な情報を取得できます。Workbench で作成されたプロセス内で、 renderPDFForm または
renderPDFFormWithUsageRights 操作に対するデバッグオプションを設定するには、PDFFormRenderSpec 型の変数を作成しま
す。次に setValue 操作を使用して、/process_data/pdfFormRenderSpecVar/object/@debugEnabled を true に設
定します。同様に、 renderHTMLForm 操作の場合は、HTMLRenderSpec 型の変数を使用します。
ADOBE LIVECYCLE ES2.5
Forms サービス
67
LiveCycle ES2.5 サービス
LiveCycle ES2.5 で使用可能なフォントの確認
フォーム内で使用可能なフォントが、LiveCycle ES2.5 をホストするサーバーでも使用可能であることを確認してください。例えば、次のようなシナリオ
が考えられます。Designer ES2.5 で使用されるフォントディレクトリにフォーム作成者がフォントを追加し、別のコンピュータでフォームを作成したと
します。Forms サービスでそのフォントを使用するには、LiveCycle がインストールされている J2EE アプリケーションサーバーにそのフォントがデプ
ロイされていることが必要です。デプロイされていない場合は、そのフォントは使用できません。フォントは、LiveCycle 管理コンソールを使用してデプ
ロイできます。
注意 : 出力 サービスのフォントの設定について詳しくは、LiveCycle ES2.5 の管理ヘルプの「埋め込むフォントの指定」を参照してください。
68
19. Generate PDF サービス
Generate PDF サービスでは、ネイティブファイル形式を PDF に変換します。また、PDF を別のファイル形式に変換したり、PDF ドキュメントのサイ
ズを最適化したりすることもできます。
Generate PDF サービスでは、ネイティブアプリケーションを使用して、以下のファイル形式を PDF に変換します。特に説明がない限り、これらのアプ
リケーションはドイツ語版、フランス語版、英語版および日本語版のみサポートされています。（Windows のみ）は、Windows Server® 2003 および
Windows Server 2008 のみでサポートされる項目を示します。
•
DOC、DOCX、RTF、TXT、XLS、XLSX、PPT、PPTX、VSD、MPP、MPPX、XPS および PUB を変換するための Microsoft Office 2003
および 2007（Windows のみ）
Note: Microsoft XPS 形式を PDF に変換するには、Acrobat® 9.2 以降が必要です。
•
•
•
DWF、DWG および DXW を変換するための Autodesk AutoCAD 2005、2006、2007、2008 および 2009（英語のみ）
WPD、QPW、SHW を変換するための Corel WordPerfect 12 および X4（英語のみ）
ODT、ODS、ODP、ODG、ODF、SXW、SXI、SXC、SXD、DOC、DOCX、RTF、TXT、XLS、XLSX、PPT、PPTX、VSD、MPP、
MPPX および PUB を変換するための OpenOffice 2.0、2.4、3.0.1 および 3.1
Note: Generate PDF サービスは、64 ビットバージョンの OpenOffice をサポートしていません。
•
PSD を変換するための Adobe Photoshop® CS2（Windows のみ）
Note: Photoshop CS3 および CS4 は、Windows Server 2003 または Windows Server 2008 に対応していないので、サポートされていません。
•
•
•
FM を変換するための Adobe FrameMaker® 7.2 および 8（Windows のみ）
PMD、PM6、P65、および PM を変換するための Adobe PageMaker® 7.0（Windows のみ）
サードパーティのアプリケーションによってサポートされているネイティブ形式（アプリケーションに固有のセットアップファイルの開発が必要）
（Windows のみ）
Generate PDF サービスでは、次の標準ベースのファイル形式を PDF に変換します。
•
•
•
ビデオ形式：SWF、FLV（Windows のみ）
画像形式：JPEG、JPG、JP2、J2Kì、JPC、J2C、GIF、BMP、TIFF、TIF、PNG、JPF
HTML（Windows、Sun™ Solaris™、および Linux®）
Generate PDF サービスでは、PDF を次のファイル形式に変換します（Windows のみ）：
•
•
•
•
•
•
•
•
•
•
Encapsulated PostScript（EPS）
HTML 3.2
CSS 1.0 を使用した HTML 4.01
DOC（Microsoft Word format）
RTF
テキスト（アクセス可能およびプレーンの両方）
XML
DeviceRGB カラースペースのみを使用する PDF/A-1a
DeviceRGB カラースペースのみを使用する PDF/A-1b
DeviceRGB カラースペースのみを使用する PDF/E-1
Generate PDF サービスでは、以下の管理タスクを実行する必要があります。
•
•
•
LiveCycle ES2.5 をホストするコンピュータに必要なネイティブアプリケーションをインストールする
LiveCycle ES2.5 をホストするコンピュータに Adobe Acrobat Professional または Acrobat Pro Extended 9.2 をインストールする
インストール後のセットアップタスクを実行する
ADOBE LIVECYCLE ES2.5
Generate PDF サービス
69
LiveCycle ES2.5 サービス
これらのタスクについては、「LiveCycle ES2 のの自動インストールおよびデプロイ（JBoss 版）」で説明されています。
Generate PDF サービスの使用
PDF や他のファイル形式に変換する場合、変換後のドキュメントに適用する設定を指定できます。以下は、これらのオプションを指定するために使用で
きるパラメータです。
•
PDF 設定：このパラメータは、変換に使用する Adobe PDF 設定の名前を指定します。この名前で指定される設定は、LiveCycle 管理コンソールで
定義されます。コンソールには、複数の Adobe PDF 設定が事前設定されています。これらの設定の名前は、ロケールによって異なります。英語版の
インストールには、これらの名前に High Quality Print、 PDFA1b 2005 CMYK および Press Quality が含まれます。
Input Settings Document パラメータに値を指定した場合は、このパラメータは無視されます。このパラメータと Input Settings Document パラ
メータの両方がヌルの場合は、LiveCycle ES2.5 サーバーで定義されているデフォルトのファイルタイプ設定インスタンスがこの操作に使用されま
す。
•
セキュリティ設定： このパラメータは、変換に使用するセキュリティ設定の名前を指定します。この名前で指定される設定は、LiveCycle 管理コン
ソールで定義されます。英語版の環境では、コンソールに事前設定されているセキュリティ設定は No Security のみです。
Input Settings Document パラメータに値を指定した場合は、このパラメータは無視されます。このパラメータと Input Settings Document パラ
メータの両方がヌルの場合は、LiveCycle ES2.5 サーバーで定義されているデフォルトのセキュリティ設定インスタンスがこの操作に使用されます。
•
ファイルタイプ設定： このパラメータは、特定のファイル形式の変換方法を指定する、ファイルタイプ設定インスタンスの名前を指定します。これら
の設定は、LiveCycle 管理コンソールを使用してカスタマイズできます。
Input Settings Document パラメータに値を指定した場合は、このパラメータは無視されます。このパラメータと Input Settings Document パラ
メータの両方がヌルの場合は、LiveCycle ES2.5 サーバーで定義されているデフォルトのファイルタイプ設定インスタンスがこの操作に使用されま
す。
•
Input Settings Document：Adobe PDF 設定とセキュリティ設定などの変換設定が含まれる XML ファイルです。Input Settings Document には、
複数の設定セットを含めることができます。この操作には、デフォルトのセットのみが使用されます （『LiveCycle ES2.5 Generate PDF Conversion
Settings Reference』を参照）。
•
生成された PDF ドキュメントに埋め込むメタデータ情報。メタデータには、ドキュメントの作成者、件名、ドキュメントに関連付けるキーワードな
どの情報が含まれています。UTF-8 でエンコードされた Adobe Extensible Metadata Platform（XMP）のメタデータのみがサポートされます。形
式および仕様について詳しくは、アドビの Web サイトの Extensible Metadata Platform（XMP）ページを参照してください。
LiveCycle 管理コンソールの LiveCycle PDF Generator ES2.5 Web ページで、タイプごとの設定の 1 つのインスタンスをデフォルトとして指定できま
す （LiveCycle ES2.5 の管理ヘルプを参照）。
Generate PDF サービスは、Microsoft Office または OpenOffice を使用するマルチスレッドファイル変換をサポートします。この機能を使用するよう
にシステムを構成するには、これらのアプリケーションにユーザー秘密鍵証明書を提供するユーザーアカウントリンクをクリックします （LiveCycle
ES2.5 の管理ヘルプの「OpenOffice、Word および PowerPoint ドキュメントでのマルチスレッドファイル変換の有効化」を参照）。
Generate PDF サービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 のヘルプを参照してください。プログラムによってこ
のサービスとやり取りできるクライアントアプリケーションの作成について詳しくは、『Programming with LiveCycle ES2.5』を参照してください。
注意 : PDFG ネットワークプリンタ（IPP プリンタ）は、Distiller サービスの機能です。PDFG ネットワークプリンタを使用して、PostScript、EPS、
PRN の各変換ジョブを Distiller サービスに送信できます（「Distiller サービス」(31 ページ ) を参照）。PDFG ネットワークプリンタを使用して、
Generate PDF サービスに変換ジョブを送信することはできません。
ネイティブファイル形式から PDF への変換
Generate PDF サービスの CreatePDF2 操作では、次の各アプリケーションを使用してネイティブファイル形式を PDF に変換します。
•
•
•
•
「Microsoft Office を使用したファイル形式の PDF 変換」(70 ページ )
「OpenOffice を使用したファイル形式の PDF 変換」(70 ページ )
「その他のアプリケーションを使用したファイル形式の PDF 変換」(71 ページ )
「その他のアプリケーションのネイティブファイル形式を PDF に変換するサポートの追加」(71 ページ )
ADOBE LIVECYCLE ES2.5
Generate PDF サービス
70
LiveCycle ES2.5 サービス
Microsoft Office を使用したファイル形式の PDF 変換
Generate PDF サービスの CreatePDF2 操作では、次の Microsoft Office アプリケーションを使用して、Microsoft Office の各ファイル形式を PDF
に変換します。
•
•
•
•
•
•
•
Office Word（DOC、DOCX、RTF、TXT）
Office Excel（XLS、XLSX）
Office PowerPoint（PPT、PPTX）
Office Visio（VSD）
Project（MPP、MPPX）
Office Publisher（PUB）
Office ドキュメントライター（XPS）
ファイルタイプごとの設定では、各 Microsoft Office ファイル形式の PDF への変換方法を指定します。いくつかの例を次に示します。
•
•
•
Excel 設定には、ワークシートを単一ページに合わせる設定や、マクロを自動的に実行する設定などがあります。
PowerPoint 設定には、脚注と文末脚注のリンクを変換する設定や、表示されたコメントを PDF のノート注釈に変換する設定などがあります。
AutoCAD 設定には、PDF のレイヤーを統合する設定や、PDF/E-1 準拠ファイルを作成する設定などがあります。
Microsoft Office アプリケーションに適用する設定の例を次に示します。
•
OpenOffice をフォールバックコンバータとして使用するオプション。適切な Microsoft Office アプリケーションを使用したファイルの変換に
Generate PDF サービスが失敗した場合、このオプションは OpenOffice を使用してファイルを変換します。
• PDF/A-1a 規格に準拠した変換。
Generate PDF サービスは、Microsoft Office ファイルを変換する際に Microsoft Office の複数のインスタンスを使用することができます。この機能
は、マルチスレッド変換と呼ばれます。Microsoft Office アプリケーションの 1 つのインスタンスを使った変換と比較した場合、マルチスレッド変換で
は、Generate PDF サービスによる Microsoft ファイルの変換率がかなり向上します。Microsoft Office を使ったマルチスレッド変換をサポートするに
は、『LiveCycle ES2 の自動インストールおよびデプロイ』の説明に従って、インストール後のセットアップタスクを実行する必要があります。
注意 : Generate PDF サービスは、Microsoft Excel、Microsoft Publisher、Microsoft Visio、Microsoft Project の各アプリケーションを使用したマ
ルチスレッド変換をサポートしません。この制約は、Microsoft Office と Microsoft Project の制限に起因するものです。
フォールバック変換サポートは、マルチスレッド変換が有効になっている場合でも利用できます。フォールバック変換が有効になっている場合、
Generate PDF サービスは、OpenOffice を使用して Microsoft Office ファイルを変換します。OpenOffice が失敗すると、Generate PDF サービス
は、PDFMaker を使用してこれらのファイルを変換します。
注意 : Generate PDF サービスが、64 ビット版のオペレーティングシステムにインストールされた Microsoft Office 2003 を使用してネイティブファイ
ルを変換する場合、PDFMaker を使ったフォールバック変換は正常に実行されません。
OpenOffice を使用したファイル形式の PDF 変換
Generate PDF サービスの CreatePDF2 操作では、OpenOffice を使用して、OpenOffice の各種ネイティブファイル形式を PDF に変換できます。サ
ポートされる OpenOffice ファイル形式は、ODT、ODS、ODP、ODG、ODF、SXW、SXI、SXC、SXD です。Microsoft Office ファイル形式を使
用するフォールバック変換をサポートするために、このサービスは BMP、GIF、JPEG、JPG、TIF、TIFF、PNG、JPF、JPX、JP2、J2K、J2C、
JPC、HTML、HTM、XLS、XLSX、PPT、PPTX、DOC、DOCX、RTF、TXT、WPD、PSD の各タイプのファイルも変換します。
ファイルタイプごとの設定では、各ファイル形式の PDF への変換方法を指定します。OpenOffice で使用される変換設定は、Microsoft Office で使用さ
れる変換設定とは異なり、OpenOffice 固有のものではありません。OpenOffice 設定の例を次に示します。
•
•
•
ロスレス圧縮
タグ付き PDF
トランジション効果を使用
ADOBE LIVECYCLE ES2.5
Generate PDF サービス
71
LiveCycle ES2.5 サービス
ファイルタイプごとの設定では、フォールバックコンバータとして Microsoft Word 用の PDFMaker を使用するように指定することもできます。
OpenOffice を使用してファイル変換を正常に完了できなかった場合、Generate PDF サービスは、Microsoft Word 用の PDFMaker を使用してファ
イルを変換します。
Generate PDF サービスは、OpenOffice の複数インスタンスを使用してファイルを変換することができます。この機能は、「マルチスレッド変換」と呼
ばれます。OpenOffice の 1 つのインスタンスを使った変換と比較した場合、マルチスレッド変換では、Generate PDF サービスによる OpenOffice
ファイルの変換率がかなり向上します。OpenOffice を使ったマルチスレッド変換をサポートするには、
『LiveCycle ES2 の自動インストールおよびデプロ
イ』の説明に従って、インストール後のセットアップタスクを実行する必要があります。
フォールバック変換サポートは、マルチスレッド変換が有効になっている場合でも利用できます。
その他のアプリケーションを使用したファイル形式の PDF 変換
Generate PDF サービスの CreatePDF2 操作では、次のアプリケーションを使用して、サポートされる各ネイティブファイル形式を PDF に変換します。
•
•
•
•
•
Autodesk AutoCAD（DWF、DWG、DXW）
Corel WordPerfect（WPD、QPW、SHW）
Adobe Photoshop（PSD）
Adobe FrameMaker（FM）
Adobe PageMaker（PMD、PM6、P65、PM）
その他のアプリケーションのネイティブファイル形式を PDF に変換するサポートの追加
現在サポートされていないその他のネイティブファイル形式のためのサポートを追加できます。そのようなサポートを追加するには、通常は次の手順を
実行する必要があります。
•
•
•
ネイティブファイル形式をサポートするアプリケーションの特定
LiveCycle をホスティングするアプリケーションのインストール
Generate PDF サービスとネイティブファイル形式を出力するアプリケーションとの間のやり取りの方法を指定するセットアップファイルと環境変
数の作成
その他のネイティブファイル形式に対するサポートの追加について詳しくは、『Programming with LiveCycle ES2.5』を参照してください。
ビデオ、画像、HTML の各ファイル形式から PDF への変換
Generate PDF サービスの CreatePDF2 操作では、ビデオ、画像、HTML の各ファイル形式を PDF に変換します。
ビデオファイル形式から PDF への変換
Generate PDF サービスの CreatePDF2 操作では、SWF ファイルおよび FLV ファイルを PDF ファイルに変換します。これらのファイルタイプは、
Adobe Flash テクノロジを使用して作成されたか、Flex Builder で開発したアプリケーションを使用して作成されたビデオです。この操作を行うと、ビ
デオが含まれているメディア注釈を含む PDF ドキュメントが生成されます。生成されたファイルを Acrobat 8 以降で開くと、ビデオを再生できます。
この機能は、PDF ポートフォリオレイアウトの作成には使用できません。このようなレイアウトには、PDF ポートフォリオ（PDF パッケージ）内の
ファイル間を移動するためのカスタマイズ可能な ActionScript® ユーザーインターフェイスが含まれています。PDF ポートフォリオについて詳しくは、
アドビの Web サイトの「The PDF Developer Junkie Blog」を参照してください。
画像ファイル形式の PDF 変換
Generate PDF サービスの CreatePDF2 操作では、各種画像ファイル形式を PDF に変換できます。サポートされる画像形式について詳しくは、
「Generate PDF サービス」(68 ページ ) を参照してください。
ADOBE LIVECYCLE ES2.5
Generate PDF サービス
72
LiveCycle ES2.5 サービス
HTML から PDF への変換
Generate PDF サービスには、HTML ファイルを PDF ドキュメントに変換するための 2 つの操作が用意されています。
•
•
HtmlToPDF2 操作。指定された URL に保存されている HTML ファイルを変換します。
HtmlFileToPDF 操作。HTML ファイルまたは HTML ファイルと画像が含まれている ZIP ファイルを変換します。
次の属性の指定を含め、HTML ファイルを PDF に変換する方法を指定することができます。
•
•
•
スパイダリング設定。元の HTML ファイルが参照する他の HTML コンテンツを含めるように指定します。
ページ変換設定。ページサイズと余白、ページの向き、ヘッダーとフッターの内容、初期表示を指定します。
ドキュメント表示オプション。Acrobat などの表示アプリケーションで PDF ドキュメントを開いたときの表示属性を指定します。
注意 : HTML から PDF への変換機能を使用するには、デプロイメント完了後にシステムフォントフォルダを指定する必要があります。特に、プライマリ
システムフォントフォルダには、この変換で使用されるすべてのフォントが含まれている必要があります。または、システム管理者は、LiveCycle
Configuration Manager を使用してフォントフォルダの場所を指定することもできます （『LiveCycle ES2 の自動インストールおよびデプロイ』を参照）。
PDF から他のファイル形式への変換（Windows のみ）
Generate PDF サービスの ExportPDF2 操作では、PDF を各種ファイル形式に変換します。サポートされるファイル形式について詳しくは、
「Generate PDF サービス」(68 ページ ) を参照してください。
ドキュメントタイプのアーカイブについて詳しくは、「ISO 19005-1:2005, Document management -- Electronic document file format for long-term
preservation」仕様、「Acrobat Developer Center」、Adobe Acrobat の「Dusting Off Archives」のチュートリアルを参照してください。
注意 : Generate PDF サービスと DocConverter サービスは、両方とも PDF を PDF/A-1B に変換します。DocConverter サービスについて詳しくは、
「DocConverter サービス」(33 ページ ) を参照してください。
PDF ファイルの最適化
Generate PDF サービスの OptimizePDF 操作では、PDF ファイルのサイズを縮小することによって PDF ファイルを最適化します。この変換を実行す
ると、生成された PDF ファイルが、元のファイルサイズよりも小さくなる場合があります。また、この操作では、PDF ドキュメントを、最適化パラ
メータで指定された PDF に変換します。
最適化設定は、ファイルの最適化方法を指定します。設定の例を次に示します。
•
•
•
•
•
対象 PDF バージョン
JavaScript アクションや埋め込みページサムネールなどのオブジェクトの破棄
コメントやファイル添付などのユーザーデータの破棄
無効な設定または使用されていない設定の破棄
圧縮されていないデータの圧縮、またはより効率的な圧縮アルゴリズムの使用
最適化は、Adobe PDF 設定を使用しません。
変換ジョブの Generate PDF サービスへの送信
「開発者によるサービスの使用」(8 ページ ) で説明されている任意のテクニックを使用して、変換ジョブを Generate PDF サービスに送信することがで
きます。変換ジョブは、LiveCycle 管理コンソールの LiveCycle PDF Generator ES2.5 Web ページにある、次のリンクのいずれかをクリックして送信
することもできます。
•
•
•
PDF の作成
HTML から PDF
PDF の最適化
LiveCycle ES2.5 に対して管理者の権限を持っていない場合でも、Web ページを使用して変換ジョブを送信することができます。管理者以外のユーザー
は、PDF Generator ES2.5 Web ページに、http://server:port/pdfgui で接続できます。これらの Web ページは、変換ジョブの送信のみを行うことが
できます （LiveCycle ES2.5 の管理ヘルプを参照）。
ADOBE LIVECYCLE ES2.5
Generate PDF サービス
73
LiveCycle ES2.5 サービス
Generate PDF サービスのシステム準備設定の検証
Generate PDF サービスに用意されているスタンドアロンシステム準備設定ツールを使用して、このサービスの正確な構成を確認することができます。
このサービスの初期構成を行った後は、このツールはいつでも使用できます。
Generate PDF サービスは、その他のアプリケーションを使用します。そのうちの一部は、ユーザー名とパスワードを必要とします。結果として、
Generate PDF サービスの構成は、他の LiveCycle ES2.5 サービスの構成よりも複雑になります （『LiveCycle ES2 の自動インストールおよびデプロイ』
を参照）。
74
20. Generate 3D PDF サービス
Generate 3D PDF サービスでは、様々な 3D ファイル形式を 3D PDF に変換します。それらの 3D ファイル形式をその他の 3D および 2D ファイル形
式に変換することもできます。さらに、このサービスでは製品ライフサイクル管理（PLM）システムのサポートと、キャッシュされた変換結果の使用に
より、前回の変換結果を再利用できます。
注意 : Generate 3D PDF サービスは Microsoft Windows® オペレーティングシステム専用です。Acrobat Pro Extended 9.1 を、LiveCycle ES2.5 をホ
ストしているサーバー上にインストールする必要があります。CAD アプリケーションがなくても、ファイルは変換できます。
Generate 3D PDF サービスは、以下の CAD アプリケーションで作成された 3D ファイルをサポートしています。このサービスでは、サポートされている
ファイルタイプを 3D PDF またはエクスポートファイル形式に変換できます。サポートされるファイルタイプのファイル拡張子は括弧内に表示されます。
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
•
3DXML（3DXML）
ACIS（SAT、SAB）
Acrobat 3D PDF（PDF）
Autodesk 3D Studio（3DS）
Autodesk Inventor 12.x 以前、2009（IPT、IAM）
CADDS（PD、_PD、CADDS）
CGR（CGR）
COLLADA（DAE）
Hewlett-Packard Graphics Library（HP、HGL、HPL、HPGL、PLT）
Industry Foundation Classes（IFC）
Initial Graphics Exchange Specification（IGES、IGES）
JTOpen JT 9.1 以前（JT）
KMZ（KMZ）
Lattice XVL（XV3、XV0）
OneSpace Designer V3 ∼ V2008（PKG、SDP、SDPC、SDW、SDWC、SDA、SDAC、SDS、SDSC、SES、BDL）
Parasolid 19 以前（X_T、X_B）
Pro/ENGINEER（PRT、XPR、ASM、XAS、NEU）
Siemens I-deas（MF1、ARC、UNV、PKG）
Siemens NX（NX 6 以前）、2D（PRT）
Solid Edge V19、V20、ST（ASM、PAR、PWD、PSM）
SolidWorks 2009 以前（SLDASM、SLDPRT）
STEP Exchange AP 203、AP 214（STP、STEP）
Stereo Lithography（STL）
TTF PRC（PRC、PRD）
UG NX
UG NX 図面
汎用 3D ECMA 1、ECMA 3（U3）
Virtual Reality Modeling Language（VRML）Worlds V1.0、V2.0（WRL、VRML）
Wavefront Object（OBJ）
ADOBE LIVECYCLE ES2.5
Generate 3D PDF サービス
75
LiveCycle ES2.5 サービス
Generate 3D PDF サービスでは、3D PDF およびサポートされている 3D CAD ファイルを次の 3D 形式に変換することもできます。例えば、
Wavefront Object ファイルを VRML に変換できます。
•
•
•
•
•
•
•
•
3D PDF
PDF/E-1
IGES
Parasolid
STEP
STL
Universal 3D
VRML
Generate 3D PDF サービスでは、3D PDF ファイルと 3D CAD ファイルを次の 2D 形式に変換できます。
•
•
DXF
EMF
Generate 3D PDF サービスでは、2D CAD ファイルを次の形式に変換することもできます。
•
•
PostScript
EMF
Generate 3D PDF サービスの使用
このサービスの操作を使用して、CAD ファイルを次のいずれかの形式に変換するように指定できます。
•
•
単一 CAD ファイル。
•
アセンブリを表し、3D オブジェクトで使用されるパーツファイルを参照する XML ファイル。参照されるパーツファイルは、ネイティブ形式にする
3D オブジェクトで使用されるサブアセンブリとパーツが含まれる別のファイルを参照する CAD アセンブリファイル。このような別のファイル（い
ずれもネイティブ形式）は、補助ファイルの配列として指定します。
ことも PDF にすることもできます。PDF は、便利なキャッシュされたフォームです。XML アセンブリ構造ファイルをサポートする Generate 3D
PDF サービスの操作では、以下の場所から参照パーツを取得できます。
•
•
引数として指定された補助ファイルの配列
ファイルの場所
3D PDF や他のファイル形式に変換する場合、変換後のドキュメントに適用する設定を指定することができます。変換に使用する設定を指定する方法は、
次のとおりです。
•
•
LiveCycle 管理コンソールの LiveCycle PDF Generator 3D ES2.5 Web ページに、定義済みの設定の名前を入力する。
設定を表す XML ファイルを指定する。このファイルは、LiveCycle 管理コンソールの PDF Generator 3D ES2.5 Web ページに指定できるすべて
の設定を表すことができます。
これらの設定のプロパティの 1 つに、3D 注釈が含まれているテンプレート PDF ドキュメントの保存場所があります。Generate 3D PDF サービスでは、
3D ファイルを 3D PDF に変換するときに、変換結果の書き込み先としてテンプレート PDF ファイルのコピーを使用します。3D オブジェクトは PRC
形式に変換され、変換された PRC オブジェクトが書き込み先 PDF ファイルの 3D 注釈のいずれかに配置されます。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 のヘルプを参照してください。プログラムによってこのサービスと
やり取りできるクライアントアプリケーションの作成について詳しくは、『Programming with LiveCycle ES2.5』を参照してください。
ADOBE LIVECYCLE ES2.5
Generate 3D PDF サービス
76
LiveCycle ES2.5 サービス
サーバーの 3D 変換設定を使用した 3D PDF の作成
Generate 3D PDF サービスの Create3dPDF 操作では、LiveCycle ES2.5 サーバーで指定した 3D 変換設定に基づいて、CAD ファイルを 3D PDF ド
キュメントに変換します。3D 変換設定の指定について詳しくは、LiveCycle ES2.5 の管理ヘルプの「Adobe 3D PDF 設定の指定」を参照してください。
XML ファイルの 3D 変換設定を使用した 3D PDF の作成
Generate 3D PDF サービスの Create3dPDFCustom 操作では、XML ファイル内に指定されたカスタム 3D 変換設定を使用して、CAD ファイルを
3D PDF ドキュメントに変換します。この XML ファイルは、3D 変換設定の pdfg3d_per_jobsettings.xsd スキーマに準拠している必要があります
（『LiveCycle ES2.5 Generate 3D PDF Conversion Settings Reference』を参照）。XML ファイルを指定しなかった場合は、LiveCycle ES2.5 サーバーで
指定されたデフォルトの変換設定が使用されます。
3D PDF ファイルの PDF/E-1 への変換
Generate 3D PDF サービスを使用して、3D PDF ドキュメントを PDF/E-1 形式に変換したり、3D PDF ドキュメントが PDF/E-1 形式に準拠してい
るかどうかを確認したりできます。
CAD ファイルの 3D PDF またはその他の 3D および 2D ファイル形式への変換
Generate 3D PDF サービスの Convert3d 操作では、CAD ファイルまたは 3D PDF ドキュメントを、他の形式を使用する 3D ファイルまたは 2D ファ
イルに変換します。サーバーで定義されている 3D 変換設定を指定することも、3D 変換設定が定義されている XML ファイルを指定することもできます。
キャッシュされた 3D コンテンツを使用した CAD ファイルへの変換
キャッシュされた変換結果を使用して、3D ファイルから PDF 形式または別のファイル形式への変換処理をスピードアップすることができます。この
キャッシュは、3D アセンブリを構成しているパーツ用に作成された 3D PDF ファイルです。この変換は、「CAD ファイルの 3D PDF またはその他の
3D および 2D ファイル形式への変換」(76 ページ ) とほぼ同じですが、変換時に 3D PDF ファイルからのキャッシュされた 3D コンテンツを使用する点
で異なります。
キャッシュされた 3D コンテンツを使用して CAD ファイルを変換するには、使用しているアプリケーションで次の一般的な手順を実行する必要があり
ます。
1
Generate 3D PDF サービスの Explore3D 操作を使用して、特定の 3D オブジェクトを調査します。この操作を実行すると、CAD アセンブリの構
造が記述されている XML ファイルが生成されます。この XML ファイルは、Adobe LiveCycle Generate 3D PDF Assembly Structure Reference に
準拠します。この調査によって、変換結果は生成されません。
2
XML ファイルにリストアップされたファイルについて、既に 3D PDF に変換されたファイルがあるかどうかを判断します。変換済みのファイルが
存在する場合、それらの 3D PDF ファイルのパスを XML ファイルに追加します。
3
Generate 3D PDF サービスの Convert3dWithCache 操作を使用して、3D オブジェクトを 3D PDF または別のファイル形式に変換します。この
操作に対するプライマリ入力は、XML ファイルです。
XML アセンブリ構造を使用した CAD ファイルへの変換
Generate 3D PDF サービスの Convert3dFromXML 操作は「CAD ファイルの 3D PDF またはその他の 3D および 2D ファイル形式への変換」(76
ページ ) とほぼ同じです。ただし、変換するファイルを特定するために、アセンブリ構造が含まれている XML ファイルを使用する点が異なります。この
ような XML ファイルの作成には、通常、製品ライフサイクル管理（PLM）システムが使用されます。PLM は、既に 3D 出力ファイル形式に変換済みの
パーツを参照するように XML ファイルを更新します。この XML ファイルは、
『Adobe LiveCycle Generate 3D PDF Assembly Structure Reference』に
準拠します。
キャッシュされた 3D コンテンツと XML アセンブリ構造を使用した CAD ファイルの変換
Generate 3D PDF サービスの Convert3dWithPlm 操作では、アセンブリ構造を含む XML ファイルとキャッシュされた 3D コンテンツによって表さ
「キャッシュされた 3D コンテンツを使用した CAD ファイルへの変換」(76 ページ ) と「XML アセンブ
れる CAD ファイルを変換します。この機能は、
リ構造を使用した CAD ファイルへの変換」(76 ページ ) の組み合わせです。
ADOBE LIVECYCLE ES2.5
Generate 3D PDF サービス
77
LiveCycle ES2.5 サービス
3D 変換でのカスタム機能の使用
Generate 3D PDF サービスを使用して CAD ファイルを変換するときに、XML ファイルを指定することができます。この XML ファイルは、3D 変換
エンジンによるカスタムプラグイン（アドイン）とのやり取りに使用されます。XML ファイルは、プラグインを特定し、プラグインで使用されるカスタ
ムパラメータを提供します。
次に、このようなプラグインが追加できる機能の例をいくつか示します。
•
•
追加の 3D ファイル形式のサポート
3D ファイルを構成するオブジェクトに対する特別な情報
3D 変換エンジンプラグインについて詳しくは、アドビの営業担当者にお問い合わせください。
Generate 3D PDF サービスの呼び出し
「開発者によるサービスの使用」(8 ページ ) で説明されているいずれかの方法を使用して、このサービス内の操作を呼び出すことができます。監視フォル
ダを使用して、ファイル階層（アセンブリ構造）を構成する 3D ドキュメントのためにこのサービスを呼び出す場合は、それらのファイルをフォルダと
して送信します。このフォルダには、アセンブリ構造を表すサブフォルダを含めることもできます。
このサービスの一部の操作は、LiveCycle 管理コンソールの LiveCycle PDF Generator ES2.5 の Web ページを使用して呼び出すこともできます。Web
ページのこのような使い方はデモンストレーションとテストを目的としています。PDF Generator ES2.5 の Web ページを使用して 3D 変換タスクを実
行するには、管理者権限が必要です （LiveCycle ES2.5 の管理ヘルプを参照）。
78
21. JDBC サービス
JDBC サービスは、データベースとやり取りするためのプロセスを有効にします。例えば、プロセスでは、フォームから送信されたデータを内部データ
ベースに入力したり、データベースのデータをフォームに事前に入力したりすることが必要な場合があります。このプロセスには、フォームフィールド
からのデータを基になるデータベースにバインドするアプリケーションロジックを含めることができます。フィールドは、データベースの列にマップす
ることができます。入力されたフォームの個別の行項目ごとに、データベース内に複数の行を作成することもできます。データベースにデータを移植する
ストアドプロシージャが既にある場合、プロセスではこのストアドプロシージャを使用してデータを更新できます。
プロセスは、データベースに保存されたデータに依存するビジネスルールを実行することもできます。例えば、支払いが遅れている顧客がいる場合、そ
の注文は出荷されず、その顧客に対して電子メールのリマインダが送信されます。プロセスによって、データベースに対するクエリーを実行し、顧客 ID
に基づいてステータスを検索し、その値に基づいてルールを作成することもできます。
JDBC サービスの使用
JDBC サービスを使用するプロセスを LiveCycle Workbench で開発することによって、このサービスを対話的に操作できます。このサービスを使用し
て次のタスクを実行できます。
•
•
•
•
•
データベースサーバーに接続するために使用するデータソースを指定します。
データベースでストアドプロシージャを実行します。
データベースサーバーで SQL ステートメントを実行し、影響を受けた行数を返します。
SQL ステートメントを使用してデータベースに対するクエリーを実行し、結果セットを XML データとして返します。
SQL ステートメントを使用してデータベースに対するクエリーを実行し、結果セットの最初の行を保存します。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。
LiveCycle 管理コンソールのアプリケーションおよびサービスのページを使用して、このサービスのデフォルトプロパティを設定できます（LiveCycle
ES2.5 の管理ヘルプの「JDBC サービスの設定」を参照）。
JDBC サービスに関する考慮事項
データサーバーに接続するために使用されるデータソースは、LiveCycle ES2.5 サーバーをホストするアプリケーションサーバーで定義されている必要
があります。デフォルト値は、LiveCycle ES2.5 データベースに対するデータソースの JNDI 名です。
ストアドプロシージャを呼び出したり SQL ステートメントを実行したりするには、データベースにアクセスするために使用されるデータベースのユー
ザーアカウントが必要なデータベースの権限を持っている必要があります。
79
22. JMS サービス
JMS サービスを使用すると、ポイントツーポイントメッセージングとパブリッシュ / サブスクライブメッセージングの両方を実装する Java Message
Service（JMS）プロバイダをインタラクティブに操作できます。
JMS サービスでは、指定したメッセージキューからのメッセージを取得できます。例えば、注文が作成された時点でキュー内に配置されているメッセー
ジに基づいてプロセスを開始することができます。この例では、JMS サービスは、メッセージをリスンしプロセスを開始する、プロセス内の最初の手順
として使用されます。
JMS サービスは、指定したメッセージキューにメッセージを送信したり、トピックにメッセージを発行したりすることもできます。例えば、「新しい顧客
プロファイルの作成」を行い顧客情報を渡すように他のシステムに通知する、キュー内のメッセージを送信する要件があるとします。プロセスでは、
JMS サービスを利用してメッセージを送信し、プロセス変数から XML ドキュメントとして顧客の詳細を渡すことができます。
JMS サービスの使用
JMS サービスを使用するプロセスを LiveCycle Workbench で開発することによって、このサービスを対話的に操作できます。このサービスを使用して
次のタスクを実行できます。
•
•
•
JMS プロバイダのトピックに対してメッセージを発行します。
JMS プロバイダのキュー内に保存されているメッセージを取得します。
JMS プロバイダのキューにメッセージを送信します。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。
LiveCycle 管理コンソールのアプリケーションおよびサービスのページを使用して、このサービスのデフォルトプロパティを設定できます（LiveCycle
ES2.5 の管理ヘルプの「JMS サービスの設定」を参照）。
JMS サービスに関する考慮事項
このサービスを使用するプロセスを開発する際には、次の事項を考慮します。
•
キューとトピックは、使用する前に JMS プロバイダで（管理者が）設定しておく必要があります。通常、JMS アプリケーションは、設定されたト
ピックおよびキューの名前の検索に Java Naming and Directory Interface（JNDI）サービスを使用します。名前が見つかると、JMS クライアント
は JMS サービスに接続し、キューとトピックをインタラクティブに操作します。
•
JMS サービスの操作が JMS プロバイダおよび関連付けられている JNDI サービスと接続してこれらをインタラクティブに操作できるようにするに
は、このサービスをデフォルトのプロパティを使用して設定する必要があります。サービスプロパティの値は、JBoss アプリケーションサーバーに基
づいてデフォルト値に設定されています。別のアプリケーションサーバーを使用して LiveCycle ES2.5 をホストしている場合は、これらの値を変更
してください。
80
23. LCCPLM サービス
LiveCycle Connector for PLM（LCCPLM）サービスを使用すると、プロセスおよびアプリケーションで製品ライフサイクル管理（PLM）システムを
インタラクティブに操作できます。PLM システムは、ライフサイクル全体を通して製品を管理し、ユーザー、データ、プロセスおよびビジネスシステム
を統合するように設計されています。PLM オブジェクトには、Microsoft Word 文書、画像、2D 図面、3D デザインなど、エンジニアリングプロジェク
トで使用するすべてのデータが含まれます。
LCCPLM サービスは、サービスコンテナとしてパッケージングされている PLM コンポーネントに含まれている、対応するメソッドを呼び出します。
PLM システムとやり取りする次の PLM コンポーネントをインストールしてください。
LiveCycle ES2.5 と共にインストールされた PLM コンポーネント： デフォルトでは、LCCPLM サービスは、スタブ PLM コンポーネントとやり取りします。
サンプルの PLM コンポーネント： アドビでは、ファイルシステムを
PLM として使用する PLM コンポーネントのサンプル実装を提供しています。この
サンプルは、LiveCycle ES2.5 のサンプルと一緒にはインストールされません。詳しくは、アドビの営業担当者にお問い合わせください。
サードパーティの PLM コンポーネント： 詳しくは、アドビの営業担当者にお問い合わせください。
サービスの使用
データ記述子とメタデータ記述子の取得
この操作では、識別子を使用して、指定した PLM オブジェクトのデータとメタデータを取得します。メタデータには、PLM システムから抽出可能な
PLM オブジェクトのための任意のフィールドを含めることができます。このメタデータは、他のソースからのメタデータに関係ありません。つまり、
PDF メタデータも Word メタデータも含まれていません。
ドキュメントのコメントの保存
この操作では、PLM オブジェクトに関連付けられているデータとコメントを保存します。データとコメントは XDP ドキュメントとして使用されます。
PLM クライアント実装は、データとコメントを PLM オブジェクトと共に PLM システムに格納できます。
XDP は、周囲の XML コンテナ内の XFA コンポーネントをパッケージ化するメカニズムを提供する XML 文法です。これらの XFA コンポーネントに
は、PDF ドキュメント、コメントおよび XFA フォームデータを含めることができます。
フォーム開発者は、ユーザーがフォームの「送信」ボタンをクリックしたときに XDP ドキュメントを自動的に生成する XML フォームを作成できます
（「XDP ドキュメントまたは XFA ベースの PDF ドキュメントからの送信」(81 ページ ) を参照）。
文字列のコメントの保存
この操作では、PLM オブジェクトに関連付けられているコメントを保存します。データとコメントは XFDF 文字列として使用されます。PLM クライア
ント実装は、データとコメントを PLM オブジェクトと共に PLM システムに格納できます。
XFDF（XML Forms Data Format）は、PDF ドキュメントから抽出されたフォームデータとコメントを表すための XML 文法です。
フォーム開発者は、XFDF ストリームを自動的に生成する「送信」ボタンを PDF ドキュメントに適用できます （「PDF ドキュメントからの送信」(82
ページ ) を参照）。
PDF の保存
この操作では、PLM システムをチェックし、PLM オブジェクトを使用して生成された PDF を確認します。
ADOBE LIVECYCLE ES2.5
LCCPLM サービス
81
LiveCycle ES2.5 サービス
サービスに関する考慮事項
シナリオ
PLM システムと LiveCycle ES2.5 プロセスを使用して作成できる LiveCycle ES2.5 ワークフローの例を次に示します。
1
PLM オブジェクトのためのファイルを取得します。
2
PLM オブジェクト全体のための PDF ドキュメントを作成します。
3
PDF ドキュメントの配布を制限するために、ポリシーによって PDF ドキュメントを保護します。
4
PDF ドキュメントを PLM オブジェクトと共に保存します。
5
PLM オブジェクトから PDF を取得します。
6
PLM から取得したメタデータを PDF に取り込みます。
7
PDF ドキュメントを特定のユーザーに送信します。ドキュメントを受け取ったレビュー担当者は PDF ファイルにコメントを適用できます。
レビュー担当者は、Acrobat Pro Extended などのデスクトップツールを使用して、ドキュメントを比較することや、データセクションを分析する
ことができます。Acrobat Pro Extended では、3D PDF ドキュメントの測定、断面図の作成および物理プロパティの計算を行うことができます。
8
コメントを PLM オブジェクトと共に保存します。
データとコメントの送信
データとコメントを送信する方法は、レビュードキュメントの形式によって異なります。レビューに使用できる形式は次のとおりです。
•
•
•
XML フォーム（XFA テンプレート）を含む XDP。この形式では XFA フォームフィールドがサポートされます。
XFA ベースの PDF。この形式では XFA フォームフィールドがサポートされます。
PDF。この形式では Acrobat フォームフィールドのみがサポートされます。
XDP ドキュメントまたは XFA ベースの PDF ドキュメントからの送信
フォーム開発者は LiveCycle Designer ES2 を使用して、この方法で使用できる XDP ドキュメントを自動的に生成する XFA フォームを作成できます。
これらのフォームには次のような特性があります。
•
アクティブ化されると、指定された宛先に XDP ストリームを送信する「送信」ボタン。デフォルトでは、ストリームにデータセットパケットが含ま
れます。送信されるストリームに XFDF パケットも含めるには、フォーム開発者が XDP ストリームにコメントを含めるように指定します。
•
別のソースから取得したデータを入力できるフィールド。例えば、アプリケーションで getDataAndMetaData 操作によって取得したデータを
フィールドに入力することができます。
次に、XDP ドキュメントを送信する「送信」ボタンをユーザーがクリックしたときに作成される XDP データの例を示します。
<?xml version="1.0" encoding="UTF-8"?>
<xdp:xdp xmlns:xdp="http://ns.adobe.com/xdp/" timeStamp="2009-01-22T16:39:34Z"
uuid="361e12df-196c-4ec2-b57a-08156b2f6393">
<xfa:datasets xmlns:xfa="http://www.xfa.org/schema/xfa-data/1.0/">
<xfa:data>
<lccplmsubmitform>
<lccplmsubmitpage>
<livecycleService>http://mylcserver:8080/SubmitPdfServlet</livecycleService>
<objectId>1898.21382.38578.43955</objectId>
<myplmhost>http://myserver:7001/myplm</myplmhost>
<myplmpassword/>
<lclogin>administrator</lclogin>
<lcpassword>password</lcpassword>
<fileName>myFile.pdf</fileName>
</lccplmsubmitpage>
</lccplmsubmitform>
</xfa:data>
ADOBE LIVECYCLE ES2.5
LCCPLM サービス
82
LiveCycle ES2.5 サービス
</xfa:datasets>
<pdf xmlns="http://ns.adobe.com/xdp/pdf/"
href="http://myreposserver:7001/LCCPLMViewer/ViewPfServlet"/>
<xfdf xmlns="http://ns.adobe.com/xfdf/" xml:space="preserve">
<annots>
<text color="#FFFF00" creationdate="D:20090427183422+02'00'" date="D:20090427185514+02'00'"
flags="print,nozoom,norotate" icon="Comment"
name="017b34e3-d1a3-4a32-8907-b4cdd1a4879b" page="1"
rect="49.698502,32.301498,69.698502,50.301498" subject="Sticky Note" title="myUserName">
<contents-richtext>
<body xmlns="http://www.w3.org/1999/xhtml"
xmlns:xfa="http://www.xfa.org/schema/xfa-data/1.0/"
xfa:APIVersion="Acrobat:9.1.0" xfa:spec="2.0.2">
<p dir="ltr">
<span dir="ltr" style="font-size:10.0pt;text-align:left;color:#000000;fontweight:normal;font-style:normal">modified again</span>
</p>
</body>
</contents-richtext>
<popup flags="print,nozoom,norotate" open="yes" page="1"
rect="100.10701,-16.941605,280.106995,102.839996"/>
</text>
</annots>
</xfdf>
</xdp:xdp>
詳しくは、LiveCycle Designer ES2 のヘルプと『XML Forms Architecture (XFA) Specification』を参照してください
PDF ドキュメントからの送信
フォーム開発者は Acrobat を使用して、PDF ドキュメントにレギュラーボタンを追加できます。このボタンには、click イベントによってトリガされる
スクリプトを割り当てることができます。スクリプトで exportAsXFDFStr メソッドを呼び出して、ファイルからデータとコメントを抽出します。また、
SOAP と Web サービスを使用して、URL に文字列を送信することもできます。
ユーザーがボタンをクリックすると、メソッドは XFDF 文字列を生成し、この文字列を使用してサーバーを呼び出します。
次に、XFDF ストリームのデコードされた文字列の例を示します。XFDF 文字列は Base64 でエンコードされます。このストリームは、ユーザーが「送
信」ボタンをクリックすると作成されます。
<?xml version="1.0" encoding="UTF-8"?>
<xfdf xmlns="http://ns.adobe.com/xfdf/" xml:space="preserve" >
<annots >
<text color="#FFFF00" creationdate="D:20090326165627+01'00'" flags="print,nozoom,norotate"
date="D:20090326165715+01'00'" name="3e792ddf-43a3-4194-b610-50b4486e3a64" icon="Comment"
page="1" rect="395.789001,172.511002,415.789001,190.511002" subject="Sticky Note"
title="myUserName" >
<contents-richtext >
<body xmlns="http://www.w3.org/1999/xhtml"
xmlns:xfa="http://www.xfa.org/schema/xfa-data/1.0/"
xfa:APIVersion="Acrobat:9.1.0" xfa:spec="2.0.2" >
<p dir="ltr" >
<span dir="ltr" style="font-size:10.0pt;text-align:left;color:#000000;fontweight:normal;font-style:normal" >ffddsd&#xD;&#xD;dffd&#xD;sd&#xD;&#xD;dd&#xD;</span >
</p >
</body >
</contents-richtext >
<popup flags="print,nozoom,norotate" open="yes" page="1" rect="792,70.510803,972,190.511002" />
</text >
</annots >
<f href="http://myreposserver:7001/LCCPLMViewer/ViewPfServlet" />
ADOBE LIVECYCLE ES2.5
LCCPLM サービス
LiveCycle ES2.5 サービス
<fields >
<field name="lccplmsubmitform[0]" >
<field name="lccplmsubmitpage[0]" >
<field name="fileName[0]" >
<value >mycadfile.CATProduct</value >
</field >
<field name="lclogin[0]" >
<value >administrator</value >
</field >
<field name="lcpassword[0]" >
<value >password</value >
</field >
<field name="livecycleService[0]" >
<value >http://mylcserver:8080/SubmitPdfServlet</value >
</field >
<field name="myplmhost[0]" >
<value >http://myserver:7001/myplm</value >
</field >
<field name="myplmuser[0]" >
<value >myUserName</value >
</field >
<field name="objectId[0]" >
<value >1898.21382.59476.64247</value >
</field >
</field >
</field >
</fields >
<ids original="1D9C55A458905E42A88ECB572F7E8C0C" modified="210B8FF4CE1B8AFFCD2E91DC39D884FF" />
</xfdf >
詳しくは、『XML Forms Data Format Specification』および『Developing Acrobat Applications Using JavaScript』を参照してください
83
84
24. LDAP サービス
LDAP サービスは、LDAP ディレクトリにクエリーを実行するための操作を提供します。LDAP ディレクトリは、通常、組織内のユーザー、グループお
よびサービスについての情報を保存するために使用されます。
例えば、LDAP ディレクトリには通常、ユーザーが所属するビジネスユニットについての情報、そのユーザーを識別する情報、および電話番号や電子
メールアドレスなどの連絡方法についての情報が保存されます。プロセスでは、LDAP サービスを使用して、ユーザーの ID に基づいて詳細を検索し、
フォームにデータを入力するためにその詳細をプロセス変数にマップすることもできます。
LDAP サービスの使用
LDAP サービスを使用するプロセスを LiveCycle Workbench で開発することによって、このサービスを対話的に操作できます。このサービスを使用し
て次のタスクを実行できます。
•
•
LDAP サーバーで検索を実行し、プロセスデータとして保存できる結果を返します。
LDAP サーバーで検索を実行し、プロセスデータとして保存できる XML ドキュメントで結果を返します。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。
LiveCycle 管理コンソールのアプリケーションおよびサービスのページを使用して、このサービスのデフォルトプロパティを設定できます（LiveCycle
ES2.5 の管理ヘルプの「LDAP サービスの設定」を参照）。
LDAP サービスに関する考慮事項
このサービスを使用するプロセスを開発する際には、次の事項を考慮します。
•
•
LDAP サービスの操作を使用する前に、LDAP サーバーに接続するために使用するプロパティを設定する必要があります。
LDAP ディレクトリでは、データモデルとしてツリー構造を使用します。Sun ONE や Microsoft Active Directory など、データベースの種類に
よって使用されるツリー構造も異なります。LDAP の管理者は、通常、組織の要件に基づいてディレクトリ構造をカスタマイズします。クエリーを行
うディレクトリに関する情報については、LDAP 管理者に問い合わせてください。
85
25. Output サービス
Output サービスを使用すると、PDF、PDF/A、レーザープリンタ形式、ラベルプリンタ形式など、様々な形式のドキュメントを作成できます。
レーザープリンタ形式には、PostScript と Printer Control Language（PCL）があります。ラベルプリンタ形式には、次のような種類があります。
•
•
•
•
Zebra（ZPL）
Intermec（IPL）
Datamax（DPL）
TecToshiba（TPCL）
ドキュメントは、ネットワークプリンタ、ローカルプリンタ、またはファイルシステムにあるファイルに送信できます。Output サービスは、XML フォー
ムデータをフォームデザインとマージしてドキュメントを生成します。Output サービスで XML フォームデータをドキュメントにマージせずにドキュメ
「フォームデータ」(94 ページ ) を参照）。
ントを生成することもできます。ただし、データをドキュメントにマージするのが本来のワークフローです （
注意 : 通常、フォームデザインは LiveCycle Designer ES2.5 を使用して作成します。Output サービス用のフォームデザインの作成について詳しくは、
『Designing Forms for LiveCycle Output ES2』を参照してください。
Output サービスを使用して XML データをフォームデザインとマージすると、非インタラクティブ PDF ドキュメントが生成されます。非インタラク
ティブ PDF ドキュメントのフィールドには、ユーザーがデータを入力することはできません。これに対し、Forms サービスを使用して作成したインタラ
クティブ PDF フォームでは、ユーザーがフィールドにデータを入力できます （「Forms サービス」(47 ページ ) を参照）。
LiveCycle Workbench 内で使用できる Output サービス操作は次の 4 つです。
generatePDFOuput2： フォームデザインをデータとマージして PDF ドキュメントを生成します。
generatePrintedOutput： フォームデザインをフォームデータとマージして、レーザーネットワークプリンタまたはラベルネットワークプリンタに送信
するドキュメントを生成します。
sendToPrinter： 指定したプリンタでドキュメントを印刷します。
transformPDF： インタラクティブ PDF フォームを非インタラクティブ PDF ドキュメントに変換します。
注意 : デフォルトでは、非推奨のメソッドは Workbench に表示されません。非推奨のメソッドを表示するには、個々のオプションを有効にしてくださ
い。
Workbench を使用する以外に、Output Service API を使用して、プログラムによって Output サービスを操作することもできます（『Programming
with LiveCycle ES2.5』を参照）。
Output サービスの使用
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench ヘルプを参照してください。監視フォルダまたは電子メール呼び出し
を使用したこのサービスの呼び出しについて詳しくは、『LiveCycle ES2.5 の概要』を参照してください。
このサービスの初期設定について詳しくは、LiveCycle ES2.5 の管理ヘルプを参照してください。
PDF ドキュメントの作成
Output サービスを使用して、フォームデザインと XML フォームデータに基づく PDF ドキュメントを作成できます。この PDF ドキュメントは、非イ
ンタラクティブ PDF ドキュメントです。つまり、ユーザーがフォームデータを入力したり変更したりすることはできません。Output サービスの基本的
なワークフローは、XML フォームデータをフォームデザインとマージして、PDF ドキュメントを作成することです。次の図は、フォームデザインと
XML フォームデータをマージして PDF ドキュメントを生成する Output サービスを示しています。
ADOBE LIVECYCLE ES2.5
Output サービス
86
LiveCycle ES2.5 サービス
PDF/A ドキュメントの作成
Output サービスを使用して PDF/A ドキュメントを作成できます。PDF/A は、ドキュメントのコンテンツを長期間保存するためのアーカイブ形式であ
るため、すべてのフォントが埋め込まれ、ファイルは圧縮されません。その結果、PDF/A ドキュメントは通常標準の PDF ドキュメントよりも大きくな
ります。また、PDF/A ドキュメントにオーディオやビデオコンテンツを含めることはできません。他の Output サービスタスクと同様に、PDF/A ド
キュメントを作成するには、マージするフォームデザインとデータの両方を指定します。
PDF/A-1 仕様には、2 つの準拠レベルがあります （a と b）。この 2 つのレベルの違いは論理構造（アクセシビリティ）のサポートに関するもので、準
拠レベル a ではこのサポートが必須ですが、準拠レベル b では不要です。準拠レベルにかかわらず、PDF/A-1 では生成される PDF/A ドキュメントにす
べてのフォントが埋め込まれている必要があります。
PDF/A は PDF ドキュメントをアーカイブするための標準ですが、ビジネス要件に合わせて PDF ドキュメントを保存してもかまいません。ただし、
PDF ドキュメントには利用できなくなるコンテンツが含まれている場合があります。例えば、Web サイトを参照する URL は時間が経つと利用できなく
なることがあります。PDF/A 標準の目的は、長期保存に耐える PDF ファイルを実現することです。
次の図は、フォームデザインと XML フォームデータをマージして PDF/A ドキュメントを生成する Output サービスを示しています。
注意 : AIIM の
Web サイトで、PDF/A に関する FAQ（http://www.aiim.org/documents/standards/19005-1_FAQ.pdf）を参照することができます。
ADOBE LIVECYCLE ES2.5
Output サービス
87
LiveCycle ES2.5 サービス
プリンタへのドキュメントの送信
Output サービスを使用して、レーザー印刷形式およびラベル印刷形式をプリンタに送信できます。サポートされている形式の一覧については、
「Output サービス」(85 ページ ) を参照してください。
注意 : ラベルプリンタの製造元では、様々な印刷言語を使用するデバイスを製造しています。Zebra のすべてのプリンタで ZPL が使用されるわけではあ
りません。使用しているデバイスで特定の印刷言語がサポートされているかどうかを確認してください。
次の図は、ドキュメントをネットワークプリンタに送信する Output サービスを示しています。
Output サービスは、次の印刷アクセスメカニズムをサポートしています。
直接アクセス型プリンタ： 印刷元のコンピュータにインストールされているプリンタを「直接アクセス型プリンタ」と呼び、そのコンピュータを「プリ
ンタホスト」と呼びます。コンピュータに直接接続されたローカルプリンタなどが該当します。
間接アクセス型プリンタ：
Common UNIX® Printing System（CUPS）や Line Printer Daemon（LPD）プロトコルなどのテクノロジがあります。プ
リントサーバーにインストールされたプリンタに対して、他のコンピュータからアクセスします。間接アクセス型プリンタにアクセスするには、プリン
トサーバーの IP またはホスト名を指定する必要があります。ネットワークで LPD が実行されている場合は、このメカニズムを使用してドキュメントを
LPD の URI に送信できます。このメカニズムを使用すると、LPD が実行されているネットワークに接続されたどのプリンタにでもドキュメントをルー
ティングすることができます。
この方法でドキュメントをプリンタに送信する場合は、次のいずれかの印刷プロトコルを指定します。
CUPS： Common UNIX Printing System の略称。このプロトコルは UNIX オペレーティングシステムで使用され、CUPS を実行するコンピュータは
プリントサーバーとして機能します。プリントサーバーはクライアントアプリケーションからの印刷要求を受け付けて処理し、設定されたプリンタに送
信します。IBM AIX® オペレーティングシステムでは、CUPS を使用しないでください。
DirectIP： リモート印刷や印刷ジョブ管理のための標準的なプロトコル。このプロトコルは、ローカルで使用することも、リモートで使用することもで
きます。プリントキューは不要です。
LPD： Line Printer Daemon プロトコルの略称。Line Printer Remote（LPR）プロトコルとも呼ばれます。このプロトコルは UNIX ベースのシステ
ムにネットワークプリントサーバー機能を提供します。
SharedPrinter： 特定のコンピュータに対して設定されているプリンタを使用できるようにする印刷プロトコル。このプロトコルは、Generate PDF
サービスがインストールされていて、さらに LiveCycle ES2.5 が Windows Server® 2008 オペレーティングシステムにインストールされている場合は機
能しません。この問題は Windows Server 2008 オペレーティングシステムにのみ当てはまります。これに該当する場合は、別のプリンタプロトコルを使
用してください。
ADOBE LIVECYCLE ES2.5
Output サービス
88
LiveCycle ES2.5 サービス
CIFS： Output サービスは、Common Internet File System（CIFS）印刷プロトコルをサポートしています （「Output サービスのパフォーマンスの
向上」(102 ページ ) を参照）。
次の表は、各種の入力値、印刷アクセスメカニズムおよびその結果を示しています。
アクセスメカニズム
プリントサーバー
プリンタ名
結果
URI
SharedPrinter
任意
Null
例外：必須の引数 sPrinterName を null にすることはできません。
SharedPrinter
任意
無効
Output サービスから、プリンタが見つからないという内容の例外がスローされます。
SharedPrinter
任意
有効
印刷ジョブが正常に作成されます。
LPD
Null
任意
Output サービスから、必須の引数 sPrintServerUri を null にすることはでき
ないという内容の例外がスローされます。
LPD
無効
Null
Output サービスから、必須の引数 sPrinterName を null にすることはできない
という内容の例外がスローされます。
LPD
無効
Null 以外
Output サービスから、 sPrintServerUri が見つからないという内容の例外がス
ローされます。
LPD
有効
無効
Output サービスから、プリンタが見つからないという内容の例外がスローされます。
LPD
有効
有効
印刷ジョブが正常に作成されます。
CUPS
Null
任意
Output サービスから、必須の引数 sPrintServerUri を null にすることはでき
ないという内容の例外がスローされます。
CUPS
無効
任意
Output サービスから、プリンタが見つからないという内容の例外がスローされます。
CUPS
有効
任意
印刷ジョブが正常に作成されます。
DirectIP
Null
任意
Output サービスから、必須の引数 sPrintServerUri を null にすることはでき
ないという内容の例外がスローされます。
DirectIP
無効
任意
Output サービスから、プリンタが見つからないという内容の例外がスローされます。
DirectIP
有効
任意
印刷ジョブが正常に作成されます。
CIFS
有効
Null
印刷ジョブが正常に作成されます。
CIFS
無効
任意
Output サービスから、CIFS を使用した印刷中に不明なエラーがスローされます。
CIFS
Null
任意
Output サービスから、必須の引数 sPrintServerUri を null にすることはでき
ないという内容の例外がスローされます。
注意 : Windows の場合、リモートネットワークプリンタで印刷するには、共有プリンタを使用するよりも、CIFS プロトコルを使用した方が簡単です。
CIFS プロトコルはリモート Windows プリントサーバーで使用できます （「Output サービスのパフォーマンスの向上」(102 ページ ) を参照）。
Windows でのサービスの実行
Windows で JBoss 版の自動インストールを使用して LiveCycle ES2 をインストールすると、JBoss はローカルシステムアカウントのコンテキストで実
行されます。このコンテキストで実行されるサービスはネットワーク上で認証されないので、プリンタなどのネットワークリソースにはアクセスできま
せん。Output Installation Verification Sample（Output IVS）を使用してドキュメントをネットワークプリンタに送信すると、次のエラーメッセージ
が表示されます。
Printer \\server\queue not found
この問題を解決するには、有効なユーザーのコンテキストで JBoss を有効にします。そのためには、「ログオン」タブをクリックし、「アカウント」を選
択して、JBoss サービスのプロパティを変更します。有効なユーザー名とパスワードを指定します。
注意 : この問題は、SharedPrinter アクセスメカニズムを使用する場合にのみ当てはまります。
ADOBE LIVECYCLE ES2.5
Output サービス
89
LiveCycle ES2.5 サービス
ネットワークプリンタへのドキュメントの送信
ネットワークで LP デーモンが実行されている場合は、ドキュメントを Line Printer Daemon（LPD）の URI に送信できます。ネットワークに接続さ
れているどのプリンタにでもドキュメントをルーティングすることができます。このプリンタは、別のコンピュータに接続されていてもかまいません。
XML フォームデータを参照し、印刷実行時オプションを設定したら、Output サービスを呼び出します。Output サービスによってドキュメントがネッ
トワークプリンタに送信されます。可能であれば CIFS プロトコルの使用をお勧めします。共有プリンタは、プリンタがローカルにインストールされてい
る場合に使用できます。
カスタムページサイズを含むフォームデザインから作成された PostScript ファイルは、正しく印刷されません。この問題を解決するには、カスタムサイ
ズを処理するようにプリンタを設定します。カスタムサイズの処理方法はプリンタごとに異なります。プリンタによっては、ページサイズ、メディアタイ
プ、給紙トレイなどを設定できる場合があります。カスタムサイズを処理するようにプリンタを設定する方法については、使用しているプリンタのマ
ニュアルを参照してください。
プリンタにドキュメントを送信する際は、次の点を考慮してください。
•
PrinterProtocol を SharedPrinter に設定し、ServerURI の値を空にします。また、PrinterName には、プリンタのパスを指定する値を
•
PrinterName の値は、プリンタがインストールされているパスを使用して取得できます。例えば、プリンタが server12r-nt サーバーに存在す
設定します（例：\\server12r-nt\HP LaserJet 8150 PCL 6 Tower II Level 5）。
るとします。プリンタの名前を取得するには、スタート／プリンタと FAX を選択し、特定のプリンタを右クリックして、「プロパティ」を選択しま
す。「全般」タブのテキストボックスにプリンタ名が表示されます。
•
SharedPrinter を使用した印刷で問題が発生した場合、その原因の 1 つとして、ログイン ID の誤りが考えられます （「Windows でのサービスの実
行」(88 ページ ) を参照）。
バッチデータ処理による複数ドキュメントの作成
Output サービスでは、XML バッチデータソース内のレコードごとに個別のドキュメントを作成できます。また、Output サービスで、すべてのレコー
ドを含む 1 つのドキュメントを作成することもできます（これがデフォルトの機能です）。例えば、XML データソース内に 10 個のレコードがある場合、
Output サービスでレコードごとに個別のドキュメント（PDF ドキュメントなど）を作成するように指定できます。その結果、Output サービスからは
10 個の PDF ドキュメントが生成されます
次の図は、Output サービスが複数のレコードを含んだ XML データファイルを処理する状況を示しています。ただし、Output サービスには、すべての
データレコードを含んだ単一の PDF ドキュメントを作成するように指示しました。この場合、Output サービスからは、すべてのレコードを含んだド
キュメントが 1 つだけ生成されます。
ADOBE LIVECYCLE ES2.5
Output サービス
90
LiveCycle ES2.5 サービス
次の図も、Output サービスが複数のレコードを含んだ XML データファイルを処理する状況を示しています。Output サービスには、データレコードご
とに個別の PDF ドキュメントを作成するように指示しました。この場合、Output サービスからは、各データレコードにつき 1 つの PDF ドキュメント
が生成されます。
次の XML データは、3 つのデータレコードを含むデータファイルの例を示しています。
<?xml version="1.0" encoding="UTF-8"?>
<batch>
<LoanRecord>
<mortgageAmount>500000</mortgageAmount>
<lastName>Blue</lastName>
<firstName>Tony</firstName>
<SSN>555666777</SSN>
<PositionTitle>Product Manager</PositionTitle>
<Address>555 No Where Dr</Address>
<City>New York</City>
<StateProv>New York</StateProv>
<ZipCode>51256</ZipCode>
<Email>[email protected]</Email>
<PhoneNum>555-7418</PhoneNum>
<FaxNum>555-9981</FaxNum>
<Description>Buy a home</Description>
</LoanRecord>
<LoanRecord>
<mortgageAmount>300000</mortgageAmount>
<lastName>White</lastName>
<firstName>Sam</firstName>
<SSN>555666222</SSN>
<PositionTitle>Program Manager</PositionTitle>
<Address>557 No Where Dr</Address>
<City>New York</City>
<StateProv>New York</StateProv>
<ZipCode>51256</ZipCode>
<Email>[email protected]</Email>
<PhoneNum>555-7445</PhoneNum>
<FaxNum>555-9986</FaxNum>
<Description>Buy a home</Description>
</LoanRecord>
ADOBE LIVECYCLE ES2.5
Output サービス
91
LiveCycle ES2.5 サービス
<LoanRecord>
<mortgageAmount>700000</mortgageAmount>
<lastName>Green</lastName>
<firstName>Steve</firstName>
<SSN>55566688</SSN>
<PositionTitle>Project Manager</PositionTitle>
<Address>445 No Where Dr</Address>
<City>New York</City>
<StateProv>New York</StateProv>
<ZipCode>51256</ZipCode>
<Email>[email protected]</Email>
<PhoneNum>555-2211</PhoneNum>
<FaxNum>555-2221</FaxNum>
<Description>Buy a home</Description>
</LoanRecord>
</batch>
注意 : 各データレコードを開始および終了する XML 要素は LoanRecord です。
PDF 実行時オプションの設定
バッチデータを正しく処理し、XML データソースに基づく複数のファイルを作成するには、Output サービスに次の実行時オプションを設定します。
Many Files： Output サービスで単一のドキュメントを作成するか、複数のドキュメントを作成するかを指定します。true または false を指定できま
す。XML データソース内のデータレコードごとに個別のドキュメントを作成する場合は、 true を指定します。
File URI： Output サービスによって生成されるファイルの場所を指定します。例えば、C:\\Adobe\\forms\\Loan.pdf を指定したとします。この場合、
Output サービスによって、Loan.pdf という名前のファイルが作成され、C:\\Adobe\\forms フォルダに格納されます。複数のファイルが存在する場合
は、ファイル名が Loan0001.pdf、Loan0002.pdf、Loan0003.pdf のようになります。ドキュメントはクライアントコンピュータではなく、LiveCycle
ES2.5 をホストするサーバーに格納されます。
Record Name： データソースの個々のデータレコードを表す XML 要素名を指定します。例えば、前述の XML データソースの例では、データレコード
を表す XML 要素は LoanRecord です。Record Name 実行時オプションを設定する代わりに、データレコードが含まれる要素レベルを表す数値を
Record Level に割り当てることもできます。ただし、設定できるのは Record Name と Record Level のどちらか一方だけです。両方の値を設定するこ
とはできません。前述の XML では、複数のドキュメントを作成するためのレコードレベルは 2 になります。
差分読み込み
Output サービスは、バッチレコードを処理する際、複数のレコードを含んだデータの差分を読み込みます。つまり、Output サービスは、データをメモ
リに読み込み、そのデータに含まれる一連のレコード（バッチ）の処理が完了した時点で、データを解放します。Output サービスがデータの差分を読み
込むのは、2 つの実行時オプションのいずれかが設定された場合です。Record Name 実行時オプションを設定した場合、Output サービスは、データの
差分読み込みを実行します。同様に、Record Level 実行時オプションを 2 に設定した場合も、Output サービスは、データの差分読み込みを実行します
（「バッチデータ処理による複数ドキュメントの作成」(89 ページ ) を参照）。
Output サービスで差分読み込みを実行するかどうかを制御するには、PDFOutputOptionsSpec または PrintedOutputOptionSpec オブジェクト
の setLazyLoading オプションを使用します。値を false に指定すると、差分読み込みがオフになります。
Output サービスでデータの差分読み込みを実行できなかった場合、Output サービスは LiveCycle ES2.5 をホストする J2EE アプリケーションサーバー
のログファイルに次の警告メッセージを出力します。
* 2007-11-01 11:51:23,215 WARN [com.adobe.document.XMLFormService]
$$$/com/adobe/document/xmlform/msg.XFA=Unable to perform an incremental data load.Performing a full data
load.
注意 : Output サービスでデータの差分読み込みを行わない場合は、バッチデータファイル全体がメモリに読み込まれます。この動作によって
サービスのパフォーマンスに悪影響が生じることがあります （「Output サービスのパフォーマンスの向上」(102 ページ ) を参照）。
Output
ADOBE LIVECYCLE ES2.5
Output サービス
92
LiveCycle ES2.5 サービス
検索ルールの作成
パターンマッチングルールを作成すると、Output サービスで入力データを検査し、データコンテンツに応じて異なるフォームデザインを使用すること
ができます。例えば、入力データに「mortgage」というテキストが含まれる場合に、Output サービスで Mortgage.xdp というフォームデザインを使用
することができます。同様に、入力データに「automobile」というテキストが含まれる場合は、Output サービスで AutomobileLoan.xdp という
フォームデザインを使用することができます。次の図は、XML データファイルを処理し、様々なフォームデザインの 1 つを使用して PDF ファイルを生
成する Output サービスを示しています。
Output サービスでは、ドキュメントパッケージを生成できます。ドキュメントパッケージでは複数のレコードがデータセットで提供され、各レコード
がフォームデザインに対応付けられます。Output サービスは、複数のフォームデザインから成る 1 つのドキュメントを生成します。
パターンマッチングルールを定義するには、Output サービスが入力データ内で検索する 1 つ以上のテキストパターンを定義します。定義したテキストパ
ターンごとに、そのテキストパターンがデータ内で見つかった場合に使用するフォームデザインを指定します。テキストパターンが見つかると、Output
サービスは対応するフォームデザインを使用して出力を生成します。テキストパターンの例として、「mortgage」を使用します。
インタラクティブ PDF ドキュメントの統合
Output サービスを使用して、インタラクティブ PDF ドキュメント（フォームなど）を非インタラクティブ PDF ドキュメントに変換できます。インタ
ラクティブ PDF ドキュメントでは、ユーザーは PDF ドキュメントフィールド内のデータを入力または変更できます。インタラクティブ PDF ドキュメ
ントを非インタラクティブ PDF ドキュメントに変換するプロセスは「統合」と呼ばれます。PDF ドキュメントの統合後、ユーザーはドキュメントの
フィールド内にあるデータを変更できません。PDF ドキュメントを統合する理由の 1 つは、データを変更できないようにするためです。
次のタイプの PDF ドキュメントを統合できます。
•
•
LiveCycle Designer ES2.5 で作成した（XFA ストリームを含む）インタラクティブ PDF ドキュメント
Acrobat PDF フォーム
非インタラクティブ PDF ドキュメントを統合しようとすると、例外が発生します。
ADOBE LIVECYCLE ES2.5
Output サービス
93
LiveCycle ES2.5 サービス
Output 用のカスタムフォームデザインのアセンブリ
Output サービスと Assembler サービスを一緒に使用して、高度にカスタマイズされたドキュメントを作成できます。Assembler サービスは、複数の
XDP ファイルにある複数の XDP フォームと挿入済みのフラグメントから成る XDP ドキュメント（フォームデザイン）をアセンブリします。アセンブ
リされた XDP ドキュメントは Output サービスに渡され、Output サービスによって PDF ドキュメントが作成されます。次の図は、このワークフロー
を示しています。
フラグメントからのフォームデザインの作成について詳しくは、『Guidelines for Dynamically Assembling Customized Forms and Documents』を参照
してください。
Output IVS を使用した PDL（ページ記述言語）の検証
Output IVS は、Output サービスをテストするためのサンプルアプリケーションです。このサンプルアプリケーションを使用して、ドキュメントを生成
し、フォームデザインとデータセットをテストすることができます。また、レーザープリンタやラベルプリンタを使用してドキュメントを印刷すること
もできます。
管理者は LiveCycle Configuration Manager を使用して Output IVS をデプロイすることができます。手動でデプロイすることもできます 詳しくは、
『LiveCycle ES2 のインストールおよびデプロイ（JBoss 版）』など、LiveCycle のインストールガイドを参照してください。
Output IVS アプリケーションを起動するには、http://[server_name:port_number]/OutputIVS に移動します。
Output IVS で使用する設定を変更するには、Adobe LiveCycle Output ES2.5 バナーの環境設定リンクをクリックします。環境設定ウィンドウでは、次
のような設定を指定できます。
•
•
•
•
Output IVS がフォーム、データ、XDC およびその関連ファイルを取得する場所。場所には、URL、リポジトリ、LiveCycle ES2.5 をホストするコ
ンピュータ上のフォルダからの絶対参照を指定することができます。リポジトリの場所は、repository:/ または repository:/// として指定できます。
共通の形式とオプション。例えば、Output IVS が 1 つの出力ストリームを作成するかどうかや、メタデータを含めるかどうかなど。
印刷オプション。両面印刷や印刷部数など。
管理者の秘密鍵証明書。
ジョブの特性を指定したり、ジョブを送信するには、Adobe LiveCycle Output ES2.5 バナーの Test Output リンクをクリックします。Test Output
ウィンドウから指定できる設定には、次のものがあります。
•
•
出力形式。PDF、PDFA-1/a、ZPL 300 DPI など。
ファイルの選択。テストで使用するフォーム、データ、XDC およびその関連ファイルを指定します。次の設定には、関連ファイルを使用します。
•
•
•
•
•
パターンマッチングルール。データエレメントを各種テンプレートにマッピングします。
バッチ設定。遅延読み込みを初期化します。
その他の多数の設定。環境設定ウィンドウを使用して指定できます。
出力場所の情報。サーバーファイルやプリンタ名など。
発行要求。要求を Output サービスを送信します。
ADOBE LIVECYCLE ES2.5
Output サービス
94
LiveCycle ES2.5 サービス
Output IVS で使用されるファイルを表示または削除するには、Adobe LiveCycle Output ES2.5 バナーの Maintenance リンクをクリックします。削除
できるのは、自分で Output IVS に追加したファイルだけです。Output IVS と共にインストールされたファイルは削除できません。Maintenance ウィ
ンドウは、環境設定ウィンドウを使用して指定した場所に、フォーム、データ、XDC とその関連ファイルを表示します。参照ボタンを使用して、使用し
ているコンピュータからファイルをアップロードすることもできます。
Output IVS の完全なヘルプを参照するには、Adobe LiveCycle Output ES2.5 バナーのヘルプリンクをクリックしてください。
Output サービスに関する考慮事項
フォームデータ
Output サービスは、通常 Designer ES2.5 で作成されるフォームデザインと XML フォームデータの両方を入力として受け入れます。ドキュメントにデー
タを入力するには、入力するすべてのフォームフィールドの XML フォームデータに XML 要素が存在する必要があります。XML 要素名は、フィールド名
と一致している必要があります。XML 要素がフォームフィールドに対応していない場合、または XML 要素名がフィールド名に一致していない場合、
XML 要素は無視されます。XML 要素が表示される順序を一致させる必要はありません。重要なのは、XML 要素を対応する値と共に指定することです。
次のローンの申し込みフォームの例について考えてみます。
ADOBE LIVECYCLE ES2.5
Output サービス
95
LiveCycle ES2.5 サービス
このフォームデザインにデータをマージするには、フォームに対応する XML データソースを作成します。次の XML は、住宅ローン申し込みフォームの
例に対応する XML データソースを表しています。
<?xml version="1.0" encoding="UTF-8"?>
- <xfa:datasets xmlns:xfa="http://www.xfa.org/schema/xfa-data/1.0/">
- <xfa:data>
- <data>
- <Layer>
<closeDate>1/26/2007</closeDate>
<lastName>Johnson</lastName>
<firstName>Jerry</firstName>
<mailingAddress>[email protected]</mailingAddress>
<city>New York</city>
<zipCode>00501</zipCode>
<state>NY</state>
<dateBirth>26/08/1973</dateBirth>
<middleInitials>D</middleInitials>
<socialSecurityNumber>(555) 555-5555</socialSecurityNumber>
<phoneNumber>5555550000</phoneNumber>
</Layer>
- <Mortgage>
<mortgageAmount>295000.00</mortgageAmount>
<monthlyMortgagePayment>1724.54</monthlyMortgagePayment>
<purchasePrice>300000</purchasePrice>
<downPayment>5000</downPayment>
<term>25</term>
<interestRate>5.00</interestRate>
</Mortgage>
</data>
</xfa:data>
</xfa:datasets>
サポートされるドキュメントタイプ
Output サービスのレンダリング機能をすべて利用するには、入力に XDP ファイルを使用することをお勧めします。場合によっては、PDF ファイルを使
用することもできます。ただし、PDF ファイルを入力に使用する場合、次のような制限があります。
•
XFA ストリームを含まない PDF ドキュメントは、PostScript、PCL または ZPL でレンダリングできません。Output サービスでは、XFA スト
リームを含んだ PDF ドキュメント（つまり、Designer ES2.5 で作成されたフォーム）をレーザー形式およびラベル形式にレンダリングできます。
PDF ドキュメントが署名、認証されていたり、（Reader Extensions サービスを使用して適用された）使用権限を含んでいる場合は、これらの印刷
•
PDF バージョンやタグ付き PDF などの実行時オプションは、Acrobat フォームではサポートされません。これらのオプションは XFA ストリームを
含む PDF フォームに対して有効ですが、これらのフォームは署名または認証できません。
形式にレンダリングすることはできません。
署名フィールド
フォームデザインに署名フィールドが含まれており、renderAtClient 実行時オプションを true に設定した場合、結果の PDF ドキュメントには未署
名の署名フィールドが保持されません。反対に、この実行時オプションを false に設定すると、生成される PDF ドキュメントで未署名の署名フィール
ドが保持されます。
電子署名された PDF ドキュメントの統合
署名済みの署名フィールドを含んだインタラクティブ XFA PDF ドキュメントを統合する場合に、 renderAtClient 実行時オプションを true に設定
すると、生成される PDF ドキュメントは統合されません。つまり、ドキュメントはインタラクティブなままとなり、ユーザーは PDF ドキュメント内の
フィールドにデータを入力したり、データを変更したりすることができます。renderAtClient は、Output サービスの操作に対する入力が PDF ファ
イルではなくフォームデザイン（XDP ファイル）である場合に使用する実行時オプションです。電子署名された PDF ドキュメントを正しく統合するに
は、 renderAtClient 実行時オプションを false に設定します。
ADOBE LIVECYCLE ES2.5
Output サービス
96
LiveCycle ES2.5 サービス
電子メールのサポート
電子メール機能の場合、電子メール サービスを使用するプロセスを Workbench で作成できます。プロセスとは、自動化するビジネスプロセスを示します
（LiveCycle Workbench 9.5 ヘルプを参照）
。
スループットの最大化
LiveCycle Output ES2.5 は、多くのレコードを含む大きな XML データファイルを処理できます。Output サービスで、レコードごとに個別の出力ファ
イルを作成するか、すべてのレコードを含む 1 つの出力ファイルを作成するかを指定できます （「バッチデータ処理による複数ドキュメントの作成」(89
ページ ) を参照）。
スループットの制限には相関性があり、フォームデザインの複雑さ、利用可能なメモリ、選択するオプション、その他のアクティビティによって変化し
ます。制限に達したときに生成されるエラーから、メモリ不足が問題であることがわかる場合があります。この制限を認識し、安全なページ生成数のガイ
ドライン内で Output サービスを使用してください。
通常のエントリレベルのビジネスサーバーにおける、複雑さが中程度のフォームの場合、安全なページ生成数のガイドラインは、概ね次のようになります。
形式
バッチレコードと多数の小型のドキュメント
大型のレコードと 1 つの大型のドキュメント
PDF（タグなし）と PDF/a-1b
10000 ページ
500 ページ
PDF（タグ付き）と PDF/a-1a
2500 ページ
250 ページ
PostScript
10000 ページ
500 ページ
PCL（TrueType またはプリンタの ?? フォント
10000 ページ
500 ページ
を使用）
PDF へのタグ付けは、必要な場合に限り選択してください。タグ付けされたファイルは、タグなしのファイルに比べサイズが非常に大きく、レンダリン
グにも時間がかかります。PDF/A-1a には常にタグが付き、PDF/A-1b にはタグが付きません。PCL 印刷の場合、フォームデザインで Microsoft
OpenType® フォントを使用すると適切にフォーマットされますが、スループットは低下し、大型の出力ファイルが生成されて、最適なパフォーマンスが
得られません。パフォーマンスを向上させるには、適切なライセンスを受けた True Type フォントを使用またはマップするか、プリンタの常駐フォント
を使用します。
大型のデータファイルを処理する場合、またはビジー状態のサーバー上で操作する場合は、Output サービスのタイムアウトを長くします。デフォルト
のタイムアウトは 180 秒です。タイムアウト値を変更するには、ハードウェアサーバーに十分なメモリがあり、そのメモリを Java アプリケーションサー
バーのヒープに使用できることを確認します。タイムアウト値の変更について詳しくは、LiveCycle ES2.5 の管理ヘルプを参照してください。
大きなレコードまたは 1 つの大きなドキュメントを処理する場合、 recordLevel 実行時オプションの 2 を使用できるように XML データが構築されて
いると、スループットが最大になります。例えば、データファイルを次のように構築するのではなく、
<datafile>
<field>123</field>…
</datafile>
次のように構築し、レベルを 1 つ追加します。
<datafile>
<record>
<field>123</field>
…
</record>
</datafile>
ADOBE LIVECYCLE ES2.5
Output サービス
97
LiveCycle ES2.5 サービス
印刷可能領域
デフォルトの 0.25 inch の印刷不可マージンは、ラベルプリンタには適用されず、プリンタごとおよびラベルサイズごとに異なります。0.25 inch のマー
ジンを維持するか、これを小さくすることをお勧めします。反対に、印刷不可マージンを大きくすることはお勧めできません。マージンを大きくすると、
印刷可能領域の情報が正しく印刷されなくなります。
プリンタには常に正しい XDC ファイルを使用してください。例えば、300 dpi のプリンタ用の XDC ファイルを選択し、ドキュメントを 200 dpi のプリ
ンタに送信するようなことは避けてください。
スクリプト
Output サービスで使用されるフォームデザインには、サーバーで実行するスクリプトを含めることができます。クライアントで実行するスクリプトは
フォームデザインに含めないでください。フォームデザインスクリプトの作成について詳しくは、LiveCycle Designer ES2.5 ヘルプを参照してください。
フォントの使用
以下のトピックでは、生成されるドキュメント内で Output サービスがフォントを処理する方法について説明します。
•
•
•
フォントが LiveCycle ES2.5 で使用できることの確認
プリンタの常駐フォントの使用
フォントマッピング
フォントが LiveCycle ES2.5 で使用できることの確認
フォーム内で使用されているフォントが、LiveCycle ES2.5 をホストする J2EE アプリケーションサーバーで使用できることを確認します。例えば、次の
ようなシナリオが考えられます。フォーム開発者が、Designer ES2.5 で使用するフォントをフォントディレクトリに追加し、そのフォントを使用する
フォームを別のコンピュータで作成します。
Output サービスでそのフォントを使用するには、カスタマーフォントディレクトリにフォントを配置します。LiveCycle 管理コンソールを使用して、カ
スタマーフォントディレクトリの場所を指定します。カスタマーフォントディレクトリが存在しない場合は、LiveCycle ES2.5 をホストする J2EE アプリ
ケーションサーバー上にディレクトリを作成します。新しいカスタマーフォントディレクトリにフォントを配置します。
カスタマーフォントディレクトリの場所の指定
1
LiveCycle 管理コンソールで、設定／コアシステム設定をクリックします。
2
コアシステムビューで、「設定」をクリックします。
3 「カスタマーフォントディレクトリの場所」テキスト入力ボックスで、カスタマーフォントディレクトリの場所を指定します。
4 「OK」をクリックします。
5
LiveCycle ES2.5 がインストールされている J2EE アプリケーションサーバーを再起動します。
プリンタの常駐フォントの使用
Output サービスは、常駐フォントを含んだドキュメントを生成できます。Output サービスで利用できる XDC ファイルには、一般的なプリンタ常駐
フォントのリストが定義されています。これらのフォントを使用するために XDC ファイルを編集する必要はありません。ただし、XDC ファイルは、
LiveCycle ES2.5 XDC エディタを使用して編集できます（LiveCycle ES2.5 XDC エディタのヘルプを参照）。
プリンタの常駐フォントは、特殊なハードウェアカートリッジとして、またはプリンタのメモリに組み込まれる形で、プリンタ内部に保存されます。
PostScript プリンタでは、フォントの名前のみ必要となります。PCL プリンタでは、文字のエスケープシーケンスを定義する必要があります。プリンタの
常駐フォント名は、プリンタのフロントパネルから取得できるほか、プリンタの組み込み Web サーバー（用意されている場合）を使用して取得できます。
ADOBE LIVECYCLE ES2.5
Output サービス
98
LiveCycle ES2.5 サービス
プリンタの常駐フォントを使用するには、次のタスクを実行します。
1
使用するプリンタ常駐フォントの名前を確認します。
2
フォームデザインでプリンタの常駐フォントの名前を指定します。
3
レンダリング出力の種類（PostScript または PCL）に基づいてプリンタに最適な XDC ファイルを探し、XDC ファイルに必要な変更を加えます。
4
出力をテストします。
注意 : これらのタスクの実行について詳しくは、LiveCycle ES2.5 XDC エディタのヘルプを参照してください。
フォントマッピング
クライアントコンピュータにインストールされているフォントは、Designer ES2.5 のドロップダウンリストに表示されます。フォントがインストールさ
れていない場合は、フォント名を手動で指定する必要があります。Designer ES2.5 の「見つからないフォントを置換して保存」オプションはオフにする
ことができます。このオプションをオフにしないと、Designer ES2.5 で XDP ファイルを保存するときに、XDP ファイルに代替フォント名が書き込ま
れます。つまり、プリンタの常駐フォントが使用されません。
プリンタの常駐フォントを使用したフォームを設計するには、Designer ES2.5 で、プリンタで利用できるフォントと一致する書体名を選択します。PCL
または PostScript でサポートされているフォントのリストは、対応するデバイスプロファイル（XDC ファイル）で確認できます。代わりに、フォント
マッピングを作成して、非プリンタ常駐フォントを、異なる書体名のプリンタ常駐フォントにマップすることもできます。例えば、PostScript のシナリ
オで、Arial フォントへの参照をプリンタ常駐の Helvetica 書体にマップすることができます。
OpenType フォントは 2 種類あります。1 つは、PCL でサポートされる TrueType OpenType フォントです。もう 1 つは、CFF OpenType です。PDF
および PostScript 出力では、Type-1、TrueType、OpenType の各埋め込みフォントがサポートされます。PCL 出力では、TrueType 埋め込みフォント
がサポートされます。
Type-1 フォントおよび OpenType フォントは PCL 出力には埋め込まれません。Type-1 フォントおよび OpenType フォントでフォーマットされたコン
テンツは、ラスタライズされ、ビットマップ画像として生成されます。ビットマップ画像はサイズが大きく、生成にも時間がかかる場合があります。
ダウンロードまたは埋め込まれたフォントは、PostScript、PCL または PDF 出力の生成時に自動的に置き換えられます。つまり、出力結果には、生成さ
れたドキュメントを適切にレンダリングするうえで必要なフォントグリフのサブセットだけが追加されます。
フォントの処理を含めて、Output サービス用のフォームデザインの作成について詳しくは、『Designing Forms for LiveCycle Output ES2』を参照して
ください。
CIFS 印刷サポート
Output サービスは、Common Internet File System（CIFS）印刷をサポートしています。CIFS 印刷を利用するには、プリンタの管理者が、CIFS プ
ロトコルを利用できるようにプリンタを設定する必要があります。Windows コンピュータの場合は、プリンタを共有するか、net share コマンドを使用
してこの設定を行います。UNIX 系のシステムでは、Samba サーバーを使用します。
プリンタがセキュリティで保護されている場合、プリンタの管理者は、プリンタキューに印刷するために必要なユーザー名とパスワードを LiveCycle
ES2.5 の管理者に提供します。このユーザー名とパスワードでプリンタにアクセスするには、LiveCycle ES2.5 の管理者が、LiveCycle ES2.5 Trust
Store を使用してそれらを登録する必要があります。Output サービスは、特定の UNC パスと、その親コンポーネントをプロファイル名として使用する
ことによって、その UNC パスに対するユーザー名とパスワードを検索します。
LiveCycle ES2.5 管理者は、LiveCycle ES2.5 Trust Store のプロファイルとして \\print-server.domain.name.com\printer を登録します。こ
の場合、Output サービスは Trust Store 内のエイリアスを次の順序で検索し、プリンタの秘密鍵証明書を探します。
\\print-server.domain.name.com\printer
\\print-server.domain.name.com
\\domain.name.com
\\name.com
\\com
\\
ADOBE LIVECYCLE ES2.5
Output サービス
99
LiveCycle ES2.5 サービス
Output サービスは、最初に一致したエントリに印刷ジョブを送ります。
注意 : LiveCycle ES2.5 の CIFS では NTLM v2 がサポートされます。Kerberos5 はサポートされません。
LiveCycle ES2.5 ユーザーが、サーバー名パラメータとしてプリンタのパスを渡し、プリンタ名パラメータを空のままにして、sendToPrinter 操作を
呼び出したとします。必要なユーザー名とパスワードの値は、LiveCycle ES2.5 Trust Store のプロファイルを使用して解決されます。
CIFS プロトコルを使用した場合、プリンタキューは、サーバーによってリソースとして共有されます。ファイルを印刷するには、次のタスクを実行します。
•
•
クライアントは、特定のリソース（サーバー上の共有プリンタキューなど）を利用するために、サーバーに対してクライアント自身の証明を行います。
認証後に、印刷ジョブがプリンタに送信されます。
デバイスプロファイルのファイル（XDC ファイル）の使用
デバイスプロファイル（XDC ファイル）は、XML 形式のプリンタ説明ファイルです。このファイルを利用して、Output サービスはレーザープリンタ
形式またはラベルプリンタ形式でドキュメントを出力します。Output サービスで使用される XDC ファイルには次のようなものがあります。
•
•
•
•
•
•
•
•
hppcl5c.xdc
hppcl5e.xdc
ps_plain_level3.xdc
ps_plain_mt.xdc
ps_plain.xdc
zpl203.xdc
zpl300.xdc
zpl600.xdc
Output サービスでドキュメントを作成するために、これらのファイルを修正する必要はありません。ただし、ビジネス要件を満たすために、これらを修
正することはできます（LiveCycle ES2.5 XDC エディタのヘルプを参照）。
注意 : XDC ファイルの詳細な一覧については、XDC エディタのヘルプを参照してください。
常駐フォント、用紙トレイ、ステープル印刷などの特定のプリンタ機能をサポートする XDC ファイルのサンプルを以下に示します。これらのサンプル
は、デバイスプロファイルを使用して自分のプリンタを設定する方法を理解しやすくするために提供されています。また、これらのサンプルは同じ製品
ラインの同様のプリンタの開始点として参照することができます。
プリンタトレイの選択
Output サービスを使用してプリンタにドキュメントを送信する際、使用するプリンタトレイを指定できます。Designer ES2.5 では、用紙（ページ）の
サイズと、プリンタ上の給紙トレイとが区別されます。つまり、用紙の指定と、給紙トレイの選択が独立しています。この機能により、同じサイズで種
類の異なる用紙が、それぞれ異なる給紙トレイにセットされていても、使用する給紙トレイをドキュメント側でページ単位で選択することが可能となり
ます。
Designer ES2.5 では、用紙サイズと給紙トレイの選択とが、独立した 2 つのプロパティとして公開されているわけではありません。その代わり、
Designer ES2.5 のマスターページを、Designer.xdc デバイスプロファイルに定義されたいずれかの（サポートされている）用紙タイプに関連付けるこ
とができます。デバイスプロファイルで、それぞれの用紙タイプについて、特定の給紙トレイの用紙を使用するように設定できます （「デバイスプロファ
イルのファイル（XDC ファイル）の使用」(99 ページ ) を参照）。
用紙トレイの選択に対応するために、Designer ES2.5 には Letter サイズと Legal サイズの一般的な用紙タイプが 2 種類ずつ用意されています。物理的
な給紙トレイを用紙タイプに対応付けるには、Workbench 内の XDC エディタを使用します。Designer ES2.5 に用意されている名前で、給紙トレイの
選択に関連するほとんどのニーズは満たされます。用紙タイプが Letter Color のときは第 2 給紙トレイにセットされた用紙が選択されるように、デプロ
イされたデバイスプロファイルを編集できます。
Output サービスでは、フォームで使用されている用紙タイプと、サーバーにデプロイされたデバイスプロファイルで定義されている用紙タイプが名前
で対応付けられます。デプロイされたデバイスプロファイルを編集するだけで、適切な給紙トレイが選択されるようになります。
ADOBE LIVECYCLE ES2.5
Output サービス
100
LiveCycle ES2.5 サービス
標準で用意されている用紙タイプで十分ですが、新しい用紙タイプを作成することもできます。用紙タイプ名を作成することにより、XDC エディタで新
しい用紙タイプを使用できます。ただし、使用する Designer ES2.5 にその用紙タイプ名が存在している必要があります。用紙タイプを追加するには、
Designer.xdc ファイルを直接編集する必要があります。正しい用紙サイズの既存のエントリをコピーし、適切な名前に変更してください。
プリンタトレイの概念は、PDF には当てはまりません。つまり、PDF ドキュメントの印刷時に特定のプリンタトレイを指定することはできません。プリ
ンタ側での選択はページサイズに基づき、必要なページサイズに合った、保護されていない最初のトレイが使用されます。サイズに合ったトレイが見つ
からなければ、手差しでの給紙が要求されます。
PCL ドキュメントの場合、XDP ファイル（Designer ES2.5 で作成されたフォームデザイン）内の各マスターページが、用紙タイプにマップされます。
さらに、この用紙タイプが、XDC ファイル内のエントリにマップされます。用紙タイプリストに表示されるリテラルが、Designer ES2.5 によって若干
異なるリテラルに変更される場合があるので注意が必要です。XDC ファイルで使用されている正確なリテラルを調べるには、XML ソースを確認してく
ださい。
XDC ファイルでは、用紙タイプが「ストック」カラムに表示されます。このエントリを編集することによって、使用する用紙タイプがセットされている
トレイ番号を表示できます。ただし、プリンタそのものに表記されているトレイ番号（トレイ 1、トレイ 2 など）は、必ずしもプリンタが認識する正しい
デバイス番号であるとは限りません。プリンタのリファレンスマニュアルを参照し、トレイ番号が正しく指定されていることを確認してください。
指定されたトレイ番号が無効であったり、要求されたページサイズと一致しなかった場合、プリンタがデフォルトの動作に戻り、正しい用紙サイズを表
す、保護されていない最初のトレイが選択されるようになります。
PostScript ドキュメントの場合、プリンタトレイの選択プロセスは PCL ドキュメントと同じです。メディアタイプに基づいてトレイを選択するには、
XDC ファイルの「トレイ番号を入力」カラムを空白にし、「トレイの種類を入力」カラムにメディアタイプを入力します。プリンタはメディアタイプを
認識するように設定されていることが前提になります。
注意 : カスタムページを含むフォームデザインから作成された PostScript ファイルは、印刷できない場合があります。この場合は、カスタムサイズを処理
するようにプリンタを設定します。カスタムサイズの処理方法はプリンタごとに異なります。プリンタによっては、ページサイズ、メディアタイプ、給紙
トレイなどを設定できる場合があります。カスタムサイズを処理するようにプリンタを設定する方法については、使用しているプリンタのマニュアルを
参照してください。
用紙の処理
Designer ES2.5 では、フォームを使用して PDF ドキュメントを生成し、Adobe Reader や Acrobat で印刷するか、フォームを PCL デバイスや
PostScript デバイスに直接出力するかに応じて、両面印刷を 2 種類の方法で制御できるようになっています。
フォームから PDF ドキュメントを生成する場合は、Designer ES2.5 内のフォームのプロパティダイアログボックスで PDF ドキュメントの印刷方法に
関する設定を行うことができます。これには印刷部数や両面印刷の設定が含まれます。その後、Adobe Reader または Acrobat から PDF ドキュメント
を印刷する際には、これらの設定が使用されます。
両面印刷は、Workbench 内にある Output サービス操作のページネーションプロパティを使用して指定することもできます。また、Output サービスの
Java および Web サービス API を使用して指定することもできます。Designer ES2.5 には、片面印刷か両面印刷かに応じて異なる動作をするような
フォームを設計する追加の機能が用意されています。
マスターページは、奇数ページ（表面）または偶数ページ（裏面）に割り当てることができます。表面ページと裏面ページに対して別々のマスターペー
ジを設計できます。Output サービスは、現在印刷しているページが表面か裏面かに応じて、適切なマスターページを自動的に選択します。この機能は、
ページの左側または右側にページ番号を配置するマスターページを作成する場合によく使用されます。マスターページを奇数または偶数として割り当て
ることによって、ページ番号が常に両面印刷ドキュメントの内側または外側に表示されるようになります。
XCI 設定ファイルの使用
XCI 設定ファイルは、Output サービスがドキュメントへのフォントの埋め込みなどのタスクを実行する際に使用されます。このファイル内の設定は編集
できますが、通常、値を変更することはありません。default.xci ファイルは svcdata\XMLFormService フォルダにあります。
例えば、LiveCycle ES2.5 が JBoss 上にインストールされている場合、フルパスは次のようになります。
[Install location]\Adobe\LiveCycle ES2\jboss\server\lc_turnkey\svcdata\XMLFormService
Output サービス操作の実行中に、変更した XCI ファイルを渡すことができます。これを行う場合は、デフォルトファイルのコピーを作成し、ビジネス
要件に合わせて必要な値だけを変更し、変更した XCI ファイルを使用します。
ADOBE LIVECYCLE ES2.5
Output サービス
101
LiveCycle ES2.5 サービス
Output サービスは、デフォルトの XCI ファイル（または変更したファイル）から開始します。次に、Workbench プロパティシートで指定された値、
または Output Service API を使用して指定された値を適用します。これらの値は XCI の設定よりも優先されます。例えば、Workbench プロパティ
シートで指定された値は、XCI の値よりも優先されます。
次の表は、XCI のオプションを示しています。
XCI オプション
説明
config/present/pdf/creator
ドキュメント情報ディクショナリの Creator エントリを使用してドキュメント作成者を識別します。
このディクショナリについて詳しくは、『PDF Reference』ガイドを参照してください。
config/present/pdf/producer
ドキュメント情報ディクショナリの Producer エントリを使用してドキュメントプロデューサを識別し
ます。このディクショナリについて詳しくは、『PDF Reference』ガイドを参照してください。
config/present/layout
出力を単一ページとするか、連続ページとするかを制御します。
config/present/pdf/compression/level
PDF ドキュメントの生成時に使用する圧縮レベルを指定します。
config/present/pdf/fontInfo/embed
出力ドキュメントへのフォントの埋め込みを制御します （
「フォントの埋め込み」(102 ページ ) を参照）。
config/present/pdf/scriptModel
出力 PDF ドキュメントに XFA 固有の情報を含めるかどうかを制御します。
config/present/common/data/adjustData
XFA アプリケーションがマージ後にデータを調整するかどうかを制御します。
config/present/pdf/renderPolicy
ページの内容をサーバー側で生成するか、後でクライアント側で生成するかを制御します。
config/present/common/locale
出力ドキュメントで使用されるデフォルトロケールを指定します。
config/present/destination
present エレメントで囲まれていた場合は、出力形式を指定します。openAction エレメントで囲
まれていた場合は、インタラクティブクライアントでドキュメントを開いたときに実行されるアク
ションを指定します。
config/present/output/type
ファイルに適用される圧縮タイプまたは生成される出力の種類を指定します。
config/present/common/temp/uri
フォームの URI を指定します。
config/present/common/template/base
フォームデザインの URI のベースを指定します。この要素が存在しないか空の場合、フォームデザイン
の場所が、ベースとして使用されます。
config/present/common/log/to
ログデータまたは出力データの書き込み先を制御します。
config/present/output/to
ログデータまたは出力データの書き込み先を制御します。
config/present/script/currentPage
ドキュメントを開いたときの初期ページを指定します。
config/present/script/exclude
LiveCycle ES2.5 で無視するイベントを指定します。
config/present/pdf/linearized
出力 PDF ドキュメントを線形化するかどうかを制御します。
config/present/script/runScripts
LiveCycle ES2.5 で実行するスクリプトを制御します。
config/present/pdf/tagged
出力 PDF ドキュメントへのタグの追加を制御します。PDF のコンテキストでの「タグ」は、ドキュメ
ントの論理構造を公開するためにドキュメントに追加される補足的な情報です。タグは、アクセシビリ
ティの支援や書式の再設定といった目的に使用されます。例えば、ページ番号を「装飾」としてタグ付
けすることで、スクリーンリーダーがテキストの途中でページ番号を読み上げてしまうのを防ぐこと
ができます。タグによって利便性が高まる反面、ドキュメントのサイズが大きくなり、作成にかかる処
理時間も長くなります。
config/present/pdf/fontInfo/alwaysEmbed
出力ドキュメントに埋め込まれるフォントを指定します。
config/present/pdf/fontInfo/neverEmbed
出力ドキュメントへの埋め込みを禁止するフォントを指定します。
config/present/pdf/pdfa/part
ドキュメントが準拠する必要のある PDF/A 仕様のバージョン番号を指定します。
config/present/pdf/pdfa/amd
PDF/A 仕様の修正レベルを指定します。
config/present/pdf/pdfa/conformance
PDF/A 仕様の準拠レベルを指定します。
config/present/pdf/version
生成する PDF ドキュメントのバージョンを指定します。
ADOBE LIVECYCLE ES2.5
Output サービス
102
LiveCycle ES2.5 サービス
フォントの埋め込み
XCI ファイルの使用方法を示すために、ここでは XCI ファイルを使用して、Output サービスで生成される PDF ドキュメントにフォントを埋め込みま
す。フォントの埋め込みが意味を持つのは、PDF 出力だけです。PCL 出力および PostScript 出力の場合、プリンタに存在しないフォントは自動的に埋め
込まれます。この設定では、グローバルな埋め込み設定をオフにして PDF ファイルのサイズを小さくする一方で、特定のフォントをドキュメントに埋め
込む手段を確保しています。
結果のドキュメントにフォントを埋め込むには、次のタスクを実行します。
1
LiveCycle ES2.5 がデプロイされているコンピュータの windows\fonts フォルダに対象のフォントを格納します。
2
前述のフォルダに格納されている XCI ファイルを別の場所にコピーして、ファイル名を custom.xci に変更します （C:\XCI\custom.xci など）。
3
この custom.xci ファイルを編集します。fontInfo という XML エレメントを作成し、pdf エレメントの子として追加してください。fontInfo
エレメント内に、次の XML データを追加します。
<alwaysEmbed>[name of the new font]</alwaysembed>
4
Workbench または Output Service API を使用して、XCI URI オプションを変更します。
Output サービスのパフォーマンスの向上
以下に、Output サービスの使用時にパフォーマンスを向上させるための考慮事項を示します。
•
プロセス内で Output サービスを呼び出す場合は、そのプロセスの有効期間を短くすることで、パフォーマンスを向上させることができます。長期
•
間有効なプロセスでは、データが長く LiveCycle ES2.5 データベース内に保持されるため、パフォーマンスコストが大きくなります。
LiveCycle 8.2 以降では、Output サービスのセキュリティを無効にできます。セキュリティを無効にした場合、Output サービスが操作を実行する
•
LiveCycle ES2.5 リポジトリのキャッシュオプションを変更し、パフォーマンスを手動で最適化します。Output サービスはフォーム（またはフラグ
•
•
両端揃えのフィールドを含んだフォームでは、パフォーマンスが低下します。つまり、両端揃えを適用すると、パフォーマンスが低下します。
•
•
バッチ処理を使用する場合は、できるだけ、差分読み込みを使用するようにします （「差分読み込み」(91 ページ ) を参照）。
際のユーザー認証が回避されるため、特定の操作のパフォーマンスが向上します。
メント）が前回の使用時から変更されていることを前提としているので、デフォルトの設定ではパフォーマンスが低くなります。
フォームデザインで暗黙的なデータバインディングを使用してバッチ処理を行うと、パフォーマンスが低下します （「バッチデータ処理による複数ド
キュメントの作成」(89 ページ ) を参照）。
フォームの設計時に、特定の言語をサポートするフォントを使用するとパフォーマンスが向上します。
注意 : 多数のレコードを含んだ大きな XML データファイルの処理について詳しくは、
「スループットの最大化」(96 ページ ) を参照してください。
103
26. PDF Utilities サービス
PDF Utilities サービスを使用して、PDF ファイル形式と XDP ファイル形式間の変換、PDF ドキュメントの保存モードの設定と取得、および PDF ド
キュメント情報のクエリーを実行することができます。例えば、PDF ファイルにコメントや添付ファイルが含まれているかどうかを確認できます。
PDF Utilities サービスの使用
このサービスを使用して次のタスクを実行できます。
PDF の複製： この機能は、LiveCycle Workbench でのみ使用できます。この機能は PDF ドキュメントを複製します。結果の PDF ドキュメントは、入
力 PDF ドキュメントとは独立して操作できます。指定された PDF ドキュメントが複製を作成せずに複数のサービスに渡された場合、その PDF ドキュメ
ントの効果的な使用が困難になる場合があります。
例えば、1 つの PDF ドキュメントが 2 つのサービスに連続して渡されるとします。1 つ目のサービスが PDF ドキュメントを変更してドキュメントの値と
して返した場合、そのドキュメントの値を使用する 2 つ目のサービスは 1 つ目のサービスが行った変更を検出します。
PDF の複製操作を行うと、入力ドキュメントと結果ドキュメントが同一の値を持ちながらも独立していることが保証されます。また、それ以降いずれか
一方の値を変更しても、他方のオブジェクトは影響を受けません。
PDF の複数複製： この機能は、Workbench でのみ使用できます。この機能は、PDF ドキュメントを指定された回数だけ複製します。結果の PDF ドキュ
メントは、入力 PDF ドキュメントとは独立して使用することができます。
PDF ドキュメントの XDP ドキュメントへの変換： PDF ドキュメントを XDP ファイルに変換します。PDF ドキュメントを XDP ファイルに正常に変換す
るには、ディクショナリ内の XFA ストリームが PDF ドキュメントに含まれている必要があります。
XDP ドキュメントの PDF ドキュメントへの変換： XDP ファイルを PDF ファイルに変換します。XDP ファイルを PDF ファイルに正常に変換するには、
エンコードされた PDF パケットが XDP ファイルに含まれている必要があります。
PDF ドキュメントのプロパティの取得： 指定された PDF ドキュメントに対するクエリーを実行し、結果を PDFPropertiesResult 値として返します。
以下のクエリーを実行できます。
•
•
•
•
•
•
•
•
•
•
•
Is a PDF Document
Is a PDF Package
Get the PDF Version
Check for Attachments
Check for Comments
Recommended Acrobat Version
Form Type
Check for AcroForm
Has a Fillable Form
Is an XFA Document
Get the XFA Version
PDF 保存モードの取得： PDF ドキュメントの保存モードを返します。保存モードは、PDF ドキュメントが保存されたモードを表します。また、保存モー
ドは、要求を要件と見なすか、単なる提案と見なすかを指定します。保存モードの値は、PDF ドキュメントのコンテンツの影響を受けません。PDF 保存
モードには、次の値を指定できます。
•
•
•
FAST_WEB_VIEW：PDF ドキュメントをオンラインで表示する場合に使用します
INCREMENTAL：最小限の時間で保存操作を実行します
FULL：最適化をより少なくして保存します
ADOBE LIVECYCLE ES2.5
PDF Utilities サービス
104
LiveCycle ES2.5 サービス
PDF 保存モードの設定： PDF ドキュメントの保存モードを設定します。保存モードは、PDF ドキュメントが保存されたモードを表します。また、保存
モードは、要求を要件と見なすか、単なる提案と見なすかを指定します。保存モードの値は、PDF ドキュメントのコンテンツの影響を受けません。PDF
保存モードには、次の値を指定できます。
•
•
•
FAST_WEB_VIEW：PDF ドキュメントをオンラインで表示する場合に使用します
INCREMENTAL：最小限の時間で保存操作を実行します
FULL：最適化をより少なくして保存します
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。プログラムによってこのサービスと
やり取りできるクライアントアプリケーションの作成について詳しくは、『Programming with LiveCycle ES2.5』を参照してください。
105
27. Reader Extensions サービス
Reader Extensions サービスでは、追加の使用権限で Adobe Reader の機能を拡張して、組織内でインタラクティブ PDF ドキュメントを簡単に共有す
ることができます。Reader Extensions サービスは、Adobe Reader 7.0 以降で使用できます。このサービスは、使用権限を PDF ドキュメントに追加し
ます。この追加により、ドキュメントへのコメントの追加、フォームへの入力、ドキュメントの保存など、Adobe Reader を使用して PDF ドキュメン
トを開いた場合には通常使用できない機能がアクティブになります。サードパーティユーザーは、使用権限を付与されたドキュメントを扱うためにソフ
トウェアまたはプラグインを追加する必要はありません。
PDF ドキュメントに適切な使用権限が追加されている場合、受信者は Adobe Reader 内で次の作業を行うことができます。
•
オンラインまたはオフラインで PDF ドキュメントおよびフォームを完成させ、追加された情報を保持しつつ、記録のためにコピーをローカル保存す
•
•
•
•
•
•
PDF ドキュメントをローカルのハードドライブに保存し、元のドキュメントと追加されたコメント、データ、または添付ファイルを保持します。
PDF ドキュメントにファイルおよびメディアクリップを添付します。
業界標準の公開鍵基盤（PKI）テクノロジを使用して電子署名を適用することによって、PDF ドキュメントの署名および認証を行います。
入力が完了した PDF ドキュメントまたは注釈が付いた PDF ドキュメントを電子的に送信します。
内部データベースおよび Web サービスへの直感的な開発フロントエンドとして PDF ドキュメントおよびフォームを使用します。
PDF ドキュメントを共有し、レビューアが直感的なマークアップツールを使用して注釈を追加できるようにします。使用できるツールには、電子付
箋、スタンプ、ハイライト、および取り消し線が含まれます。同じ機能は、Acrobat で使用できます。
•
バーコードフォームのデコードをサポートします。
ることを受信者に対して許可します。
これらの特別なユーザー機能は、使用権限を付与された PDF ドキュメントを Adobe Reader で開くと自動的にアクティブになります。権限を付与され
たドキュメントの編集を終了すると、これらの機能は Adobe Reader で再び無効になります。これらの機能は、使用権限を付与された別の PDF ドキュ
メントを受け取るまで有効にはなりません。
次のトピックでは、実行できるタスク、および最適な結果を得る方法について説明します。
•
•
「Reader Extensions サービスの使用」(105 ページ )
「Reader Extensions サービスに関する考慮事項」(107 ページ )
Reader Extensions サービスの使用
PDF ドキュメントへの使用権限の適用
Reader Extensions サービスを使用すると、PDF ドキュメントに使用権限を適用できます。使用権限は、Acrobat Professional および Acrobat
Standard で使用できる機能に適用されますが、Adobe Reader の機能には適用されません。例えば、適用される機能には、ドキュメントにコメントを追
加する、フォームに情報を入力する、ドキュメントを保存する、などがあります。使用権限が追加された PDF ドキュメントは、使用権限を付与されたド
キュメントと呼ばれます。使用権限を付与された PDF ドキュメントを Adobe Reader で開いたユーザーは、そのドキュメントで有効になっている操作
を実行できます。
各種の使用権限、およびその使用権限が付与されている場合にユーザーが Adobe Reader で実行できる操作について、以下に説明します。
基本フォームに記入： フォームフィールドに入力して、ファイルをローカルに保存することができます。
注意 : Adobe Reader 7 のユーザーにはフォームへの入力を求めるメッセージが表示されますが、Adobe Reader 8 ではこのメッセージが表示されません。
フォームデータの読み込みおよび書き出し： データを FDF、XFDF、XML または XDP ファイルとして読み込んだり書き込んだりできます。この機能を
選択すると、
「基本フォームに記入」の機能も自動的に追加されます。この追加機能の使用権限を選択する場合は、必要な機能に応じて「データベースと
Web サービスの接続性」または「埋め込まれた添付ファイル」の使用権限も有効にします。
ADOBE LIVECYCLE ES2.5
Reader Extensions サービス
106
LiveCycle ES2.5 サービス
Web ブラウザ以外で送信： 電子メールまたはオフラインでフォームデータを送信できます。この機能を選択すると、「基本フォームに記入」の機能も自動
的に追加されます。
データベースと Web サービスの接続性： フォーム内で定義されている
Web サービスを呼び出したり、データベースにアクセスしたりできます。この機能
を選択すると、「基本フォームに記入」の機能も自動的に追加されます。
フォームフィールドを追加、削除、および変更： フォーム上のフィールドを追加、削除または変更できます。この機能を選択すると、
「基本フォームに記
入」の機能も自動的に追加されます。
テンプレートからページを作成： Acrobat で作成されたフォームのフォームテンプレートからページを作成できます。ユーザーは、同じフォーム内のテン
プレートページからページを作成できます（XFA ドキュメントの場合、この機能は使用できますが、保存した最終的なドキュメントにこの使用権限は適
用されません）。この機能を選択すると、「基本フォームに記入」の機能も自動的に追加されます。
2D バーコードのデコード： 2D バーコードをサードパーティ製のスキャンデコードソリューションで使用できます。この機能を選択すると、「基本フォー
ムに記入」の機能も自動的に追加されます。
電子署名： PDF ドキュメントに電子署名して保存できます。このオプションを選択しない場合も、ユーザーは、電子署名が適用されたドキュメントの検
証、表示、印刷は行うことができます。
コメント： コメントの作成、編集、読み込みおよび書き出しを実行できます。コメントはファイルと共に保存され、転送されます。この使用権限を選択
しない場合、ユーザーに対しては PDF ドキュメントのコメントの表示のみが許可されます。
オンラインコメント： ドキュメントコメントをサーバーにアップロードしたり、サーバーからダウンロードしたりできます。この機能を選択すると、
「コ
メント」の機能も自動的に選択されます。
埋め込まれた添付ファイル： 添付ファイルや PDF パッケージ（以前の PDF ポートフォリオ）内のファイルの追加、削除、変更または書き出しを実行で
きます。
使用権限を適用する方法
•
•
•
LiveCycle Reader Extensions ES2.5 Web アプリケーションを使用する（LiveCycle Reader Extensions ES2.5 のヘルプを参照）。
LiveCycle Workbench を使用して作成したプロセスを使用します （LiveCycle Workbench 9.5 のヘルプを参照）。
Reader Extensions Service API を使用します （『Programming with LiveCycle ES2.5』を参照 )。
PDF ドキュメントからの使用権限の削除
Reader Extensions サービスを使用すると、使用権限を付与されたドキュメントから使用権限を削除できます。使用権限を付与された PDF ドキュメン
トに対して他の LiveCycle ES2.5 操作を実行するために、PDF ドキュメントから使用権限を削除しなければならない場合があります。例えば、使用権限
を設定するには、あらかじめ PDF ドキュメントに電子署名（または認証）する必要があります。したがって、権限が付与されたドキュメントに対して操
作を実行するには、以下のタスクを実行します。
•
•
•
PDF ドキュメントから使用権限を削除する
ドキュメントに電子署名する、などの他の操作を実行する
使用権限をドキュメントに再度適用する
使用権限を削除する方法
•
•
Workbench を使用して作成したプロセスを使用します （LiveCycle Workbench 9.5 のヘルプを参照）。
Reader Extensions Service API を使用します（『Programming with LiveCycle ES2.5』を参照）。
秘密鍵証明書情報の取得
Reader Extensions サービスを使用すると、PDF ドキュメントに使用権限を適用する際に使用された秘密鍵証明書に関する情報を取得できます。秘密鍵
証明書に関する情報を取得することにより、証明書の有効期限が切れる日付などの情報を確認することができます。
ADOBE LIVECYCLE ES2.5
Reader Extensions サービス
107
LiveCycle ES2.5 サービス
秘密鍵証明書情報の使用権限を取得するには
•
•
Reader Extensions Service API を使用します（『Programming with LiveCycle ES2.5』を参照）。
Workbench を使用して作成したプロセスを使用します （LiveCycle Workbench 9.5 のヘルプを参照）。
Reader Extensions サービスに関する考慮事項
Reader Extensions サービスを使用するアプリケーションを開発する場合は、次のことを考慮してください。
秘密鍵証明書の設定
PDF ドキュメントに使用権限を適用するには、有効な秘密鍵証明書が必要です。秘密鍵証明書は、LiveCycle ES2.5 のインストールの際に設定されてい
る場合があります。秘密鍵証明書について詳しくは、LiveCycle ES2.5 管理ヘルプの「秘密鍵証明書を Reader Extensions ES2.5 で使用するための設定」
を参照するか、アプリケーションサーバー管理者に問い合わせてください。
操作の順序
1 つのドキュメントに対して暗号化、認証方法、および使用権限の適用を組み合わせて使用する場合は、次に示す順序で行う必要があります。これらの
サービスは、短時間のみ有効なプロセス内で呼び出す必要があります。
1
ドキュメントに電子署名する（Signature サービス）前に、ドキュメントに暗号化を適用するか（Encryption サービス）、ポリシーを適用します
（Rights Management サービス）。電子署名は、署名時のファイルの状態を記録します。署名を適用した後にドキュメントを暗号化またはポリシー
を適用すると、ファイルのバイト数が変わり、署名は無効になります。
2
使用権限（Reader Extensions サービス）を設定する前に PDF ドキュメントを認証します（Signature サービス）。使用権限を適用した後にドキュ
メントを認証すると、使用権限の署名が無効となり、ドキュメントから使用権限が削除される場合があります。
3
使用権限を設定した後に PDF ドキュメントに電子署名します（Signature サービス）。使用権限を適用した後に PDF ドキュメントに署名すると、使
用権限の署名は無効になりません。
また、PDF ドキュメントを暗号化し、この PDF ドキュメントにポリシーを適用することはできません。また、暗号化済みの PDF ドキュメントにはポリ
シーを適用できません。
インタラクティブフォームへの使用権限の追加
LiveCycle Designer ES2.5 で作成されたインタラクティブフォームを使用しているとき、場合によっては、PDF ドキュメントに使用権限を追加する必
要があります。例えば、Designer ES2.5 を使用してインタラクティブフォームを作成し、フォームスクリプトを使用してフォームデータを取得するデー
タ接続 SOAP エンドポイントを参照したとします。次に、このフォームを Adobe Reader 8.0 で表示しようとします。
使用権限がないため、Adobe Reader はデータ接続 SOAP エンドポイントの設定に失敗し、事前に定義されたエンドポイント（Designer ES2.5 で設定）
が使用されることになります。フォームスクリプトを使用してデータ接続 SOAP エンドポイントを設定するには、enableFormsOnline 使用権限をイン
タラクティブフォームに追加する必要があります。
フィールドにデータを入力するフォームへの使用権限の追加
Adobe Reader 7.0 で使用するフォームを設計するとき、フィールドにデータを入力するために、そのフォームで Web サービスやデータベースの呼び出
しを実行する場合は、追加の使用権限をそのフォームに適用します。
Adobe Reader 8.0 用のフォームを設計する場合は、次の使用権限を適用します。
•
•
•
基本フォームに記入
データベースと Web サービスの接続性
フォームフィールドを追加、削除および変更
ADOBE LIVECYCLE ES2.5
Reader Extensions サービス
108
LiveCycle ES2.5 サービス
Adobe Reader 7.0 用のフォームを設計する場合は、次の使用権限を適用します。
•
•
•
•
基本フォームに記入
フォームデータの読み込みおよび書き出し
データベースと Web サービスの接続性
フォームフィールドを追加、削除および変更
Adobe Reader 7.0 では、「フォームデータの読み込みおよび書き出し」使用権限がない場合、Web サービスまたはデータベースの呼び出しでエラーが発
生します。
権限を付与した PDF ドキュメントのオープン
ユーザーが Adobe Reader 7.0 以前のバージョンで使用権限を付与された PDF ドキュメントを開こうとすると、特定の機能にアクセスできない場合があ
ります。これらのバージョンの Adobe Reader では、最新バージョンにアップグレードする必要があることを示すメッセージが表示されます。例えば、
ユーザーが Acrobat 5.0 互換の PDF ドキュメントに使用権限を適用する場合、この PDF ドキュメントはそのバージョンの Acrobat（または Adobe
Reader）と互換性がなくなります。この PDF ドキュメントは Adobe Reader 7.0 以降とのみ互換性があります。
109
28. Repository サービス
リポジトリでは、ストレージ機能が提供されます。開発者は、アプリケーションの作成時に、ファイルシステムではなくリポジトリにアセットをデプロ
イできます。リポジトリには、次のアセットを格納できます。
•
•
•
•
•
•
•
•
•
•
•
•
XML フォーム
PDF フォーム（Acrobat フォームなど）
フォームのフラグメント
画像
プロセス
プロファイル
ポリシー
SWF ファイル
DDX ファイル
XML スキーマ
WSDL ファイル
テストデータ
リポジトリでは、LiveCycle ES2.5 アプリケーションの各アセットのバージョンが追跡されます。実行時に、自動化されたビジネスプロセスの完了の一環
として、サービスでリポジトリからアセットを取得できます。
Repository サービスの使用
開発者は、プロセスで Repository サービスを使用して、リポジトリからリソースを取得できます。Repository Service API を使用すると、リポジトリ
へ情報を格納したり、リポジトリから情報を取得したりするために、その他の様々な操作を実行できます。例えば、アプリケーションの処理の一環とし
てファイルが必要な場合、リポジトリに格納されているファイルのリストまたは特定のファイルを取得できます。また、Repository Service API を使用
して、アプリケーションファイルをプログラムでデプロイすることもできます。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。プログラムによってこのサービスと
やり取りできるクライアントアプリケーションの作成について詳しくは、『Programming with LiveCycle ES2.5』を参照してください。
LiveCycle 管理コンソールのアプリケーションおよびサービスのページを使用して、このサービスのデフォルトプロパティを設定できます （LiveCycle
ES2.5 の管理ヘルプを参照）。
110
29. Rights Management サービス
Rights Management サービスを使用してポリシーを作成し、ドキュメントに適用できます。ポリシーは、機密設定および許可されたユーザーの一覧を含
む情報の集合です。ドキュメントを開くことができるユーザーを指定して、それらのユーザーによるドキュメントの利用方法を制限し、配布後にドキュ
メントを監視できます。さらに、ドキュメントへのアクセスを動的に制御し、ドキュメントへのアクセスを取り消すこともできます。
Rights Management サービスは、PDF ファイルに加え、次に示すタイプのファイルを保護します。
•
•
•
FLV および F4V
Microsoft Word、Excel および PowerPoint
Parametric Technology Corporation（PTC）Pro/ENGINEER Wildfire 4.0
ポリシーは、プログラムで PDF ドキュメントに適用できます。そのためには、Rights Management Service API を使用するか、またはプロセスの一部
として適用します。クライアントアプリケーションを使用してポリシーをドキュメントに適用することもできます。PDF ドキュメントへのポリシーの適
用方法について詳しくは、Acrobat のヘルプを参照してください。Microsoft Office などの他のアプリケーションを使用してポリシーを適用する方法
は、LiveCycle Rights Management ES2.5 Extension のヘルプの該当するアプリケーションに関するセクションに記載されています。
LiveCycle Rights Management ES2.5 Extension for Microsoft Office は、Adobe の Web サイトからダウンロードできます。
注意 : Rights Management ES2.5 では、SSL 接続経由での認証が求められます （LiveCycle ES2.5 の管理ヘルプの「SSL の設定」を参照）
。
管理者は、Rights Management ES2.5 Web ページを使用して、次のタスクを実行できます（LiveCycle ES2.5 の管理ヘルプを参照）。
•
•
•
•
•
様々な Rights Management サービス設定の指定
ポリシーで保護されたドキュメントの管理
ポリシーセットおよびポリシーセットに含まれるポリシーの作成と管理
Rights Management ES2.5 によって記録されるイベントの監視
招待ユーザーおよびローカルユーザーの管理
LiveCycle Workbench を使用して、次のタスクを行うプロセスを開発できます（LiveCycle Workbench 9.5 のヘルプを参照）。
•
•
•
•
•
•
•
テンプレートからのポリシーの作成または既存のポリシーの更新
ドキュメントへのポリシーの適用、ポリシーの切り替えまたはポリシーセキュリティの削除
ライセンス ID の取得、ライセンスの失効またはライセンスの復元
すべてのポリシーセット名またはポリシーセット内のすべてのポリシー名の取得
ポリシー識別子を使用したポリシーの取得
保護されたドキュメントの検査
ポリシーで保護された PDF ドキュメントのロック解除
Rights Management Service API を使用して、次のタスクを行うクライアントアプリケーションを開発できます（『Programming with LiveCycle
ES2.5』を参照）。
•
•
•
•
•
•
•
ポリシーの作成、変更または削除
PDF ドキュメントへのポリシーの適用または PDF ドキュメントからのポリシーの削除
PDF ドキュメントへのアクセス権限の失効または復元
透かしの作成
イベントの検索
ポリシーで保護されたドキュメントをバッチモードで開く
ポリシーで保護されたドキュメントに関する情報の取得
ADOBE LIVECYCLE ES2.5
Rights Management サービス
111
LiveCycle ES2.5 サービス
ポリシーについて
ポリシーは、許可されたユーザーおよびドキュメントに適用される機密設定に関する情報で構成されます。ユーザーは組織内の任意のユーザーだけでな
く、組織外の Rights Management ES2.5 に登録されているユーザー、または管理者がアカウントを作成したユーザーでもかまいません。管理者がユー
ザー招待機能を有効にしている場合は、新しく招待されたユーザーをポリシーに追加することができます。新しく招待されたユーザーを追加すると、そ
のユーザーに登録を勧める登録電子メールが Rights Management サービスによって送信されます。
ポリシーで指定する機密設定によって、受信者によるドキュメントの使用方法が決まります。例えば、テキストの印刷やコピー、変更、または保護され
たドキュメントへの署名や注釈の追加を実行できるかどうかを指定することができます。同じポリシーで、複数のユーザーに対してそれぞれ異なる機密
設定を指定することもできます。
様々な状況およびユーザーに対応するセキュリティ設定を使用して、いくつでもポリシーを作成および保存できます。
Rights Management ES2.5 を使用して、ドキュメントに対する権限を動的に変更できます。ポリシーによって、ドキュメントを保護するユーザーに、機
密設定の変更、ドキュメントのアクセス権限の失効またはポリシーの切り替えを行う権限を付与します。ドキュメントを配布した後、ドキュメントを保
護したユーザーは、誰がどのようにドキュメントを使用しているかを監視できます。
ポリシーは、Portable Document Rights Language（PDRL）を使用して記述します
ポリシーセットについて
ポリシーセットは、ある共通の目的を持つ一群のポリシーをグループ化するために使用します。通常、ポリシーセットを使用できるユーザーの数は制限
されています。この制限は、ドメイン内のどのユーザーやグループがドキュメントを保護するためにポリシーセットのポリシーを使用できるのかを指定
することにより行います。
それぞれのポリシーセットには、1 人以上のポリシーセットコーディネータを設定できます。ポリシーセットコーディネータは、管理者、または追加の権
限を持つユーザーです。一般に、ポリシーセットコーディネータには、特定のポリシーセット内に最も効果的なポリシーを作成できる組織内の専門家を
指定します。割り当てられた権限によっては、ポリシーセットコーディネータは次の操作も実行できます。
•
•
•
ポリシーセットに関連するイベントを表示する
ドキュメントを管理する
他のポリシーセットコーディネータを管理する
適切な権限を持つポリシーセット管理者が、Rights Management ES2.5 の管理 Web ページを使用してポリシーセットを作成および削除します。
Rights Management ES2.5 のインストール時に、グローバルポリシーセットと呼ばれるデフォルトのポリシーセットが作成されます。ポリシーセット管
理者は、このポリシーセットを管理できます。
セキュリティ方法およびテクノロジ
ポリシーによって保護されているドキュメントの機密を確保するために、Rights Management ES2.5 では 3 つのセキュリティのレイヤーが実装されます。
認証
すべてのユーザーは、Rights Management ES2.5 をインタラクティブに操作するには、ログインする必要があります。次のタスクを実行する前にログイ
ンする必要があります。
•
•
•
Web ブラウザで Rights Management ES2.5 Web アプリケーションを開く
サポートされるクライアントアプリケーションでポリシーを使用してドキュメントを保護する
ポリシーで保護されたドキュメントを開く
ADOBE LIVECYCLE ES2.5
Rights Management サービス
112
LiveCycle ES2.5 サービス
ポリシーを作成するときに、匿名ユーザーがポリシーで保護されたドキュメントを開くことを許可できます（その設定が Rights Management ES2.5 の
設定で有効になっている場合）。匿名ユーザーアクセスを許可すると、アカウントを持たないユーザーでもドキュメントにアクセスできますが、Rights
Management ES2.5 にログインしたり、他のポリシーで保護されたドキュメントを使用することはできません。
認証方法
Rights Management ES2.5 は、次の認証方法をサポートします。
ユーザー名とパスワード： ユーザーは、ユーザー名とパスワードを入力するように求められます。
Kerberos（Microsoft® Windows® の Acrobat のみ）： Windows プラットフォームの場合、Acrobat または Adobe Reader ユーザーを透過的に認証で
きます。
スマートカード（Microsoft Windows の Acrobat のみ）： Windows プラットフォームの場合、スマートカードを使用して
Acrobat または Adobe
Reader ユーザーを認証できます。
組織内のユーザーについては、それぞれのユーザーに対応するユーザーレコードが組織ユーザーディレクトリに保存されています。これらのレコードは、
User Management データベースと同期しています。Rights Management ES2.5 は、組織内のユーザーを User Management データベースと照合して
認証します。Rights Management ES2.5 は、組織外のユーザーのアカウントもデータベースに保存しており、それらのアカウントを使用して組織外の
ユーザーを認証します。ユーザーの管理について詳しくは、LiveCycle ES2.5 の管理ヘルプの「ユーザーの追加および設定」を参照してください。
SAML 認証のアサーション
ユーザーが最初に認証されてからは、それ以降に Rights Management ES2.5 がクライアントからメッセージを受信した場合、Rights Management
ES2.5 は SAML 認証のアサーションを使用してメッセージ送信者の ID を検証します。Security Assertion Markup Language（SAML）認証のアサー
ションは、アサーションが期限切れになるかユーザーがセッションを終了するまで認証に使用されます。
ユーザーがユーザー名およびパスワードを使用して最初に認証されるとき、Rights Management ES2.5 によって SAML 認証のアサーションが生成され
ます。SAML 認証のアサーションは SOAP ヘッダに埋め込まれ、クライアントに返されます。
Rights Management ES2.5 に送信される後続のメッセージのメッセージヘッダに、WS-Security 標準に従って SAML アサーションが埋め込まれます。
注意 : SAML アサーションはセッション管理のために内部で使用されますが、Rights Management ES2.5 ではサードパーティの
サポートされません。
SAML アサーションは
Acrobat およびその他のクライアントアプリケーションを介したログイン
Rights Management ES2.5 が Acrobat または Microsoft Office などの別のクライアントアプリケーションを介してユーザーを認証すると、サーバーか
らクライアントアプリケーションに SAML 認証のアサーションが返されます。
クライアントアプリケーションを使用してログインした後に、Web アプリケーションにアクセスするための SSO が SAML アサーションによって実現さ
れます。クライアントアプリケーションで Web アプリケーションを開く場合、ユーザーはアサーションで認証され、ユーザー名とパスワードを入力する
ように求められません。
ロールベースのアクセス制御
Rights Management ES2.5 はロールベースのモデルを使用して、Web アプリケーションの機能へのアクセスを制御します。ユーザーがサポート対象の
クライアントアプリケーションでポリシーを使用してドキュメントを保護できるかどうかも、ロールによって決まります。User Management Web ペー
ジを通してユーザーおよびグループをロールに関連付けます。ロール情報は、User Management データベースに格納されます。Rights Management
ES2.5 で使用されるロールについて詳しくは、LiveCycle ES2.5 の管理ヘルプの「LiveCycle Rights Management ES2.5 ユーザーについて」を参照して
ください。ロールのアサインについて詳しくは、LiveCycle ES2.5 の管理ヘルプの「ロールの管理」を参照してください。
ドキュメント機密
Rights Management ES2.5 では、いくつかのテクノロジを使用して、ドキュメントの保護とそれらのドキュメントへのアクセス権限の付与が行われま
す。通常、Rights Management ES2.5 は、暗号化に対称暗号キーシステムを使用します。Acrobat などのクライアントアプリケーションは、ドキュメン
トの暗号化を実行します。ドキュメントはクライアントアプリケーションを使用して保護されているときは Rights Management ES2.5 に送信されませ
ん。しかし、Rights Management Service API を使用して保護されているときはサーバーに送信されます。
ADOBE LIVECYCLE ES2.5
Rights Management サービス
113
LiveCycle ES2.5 サービス
ドキュメントの保護に使用される方法は、ポリシーにより、オンラインでドキュメントへアクセスする必要があるか、オフラインでの使用が有効である
かによって、異なります （「オンラインで使用するドキュメントのポリシーによる保護」(113 ページ ) および「ポリシーで保護されたドキュメントのオ
フラインでの使用」(115 ページ ) を参照）。
PDF ドキュメントにポリシーを適用すると、ドキュメントに保存されるファイルなど、ドキュメントに含まれる情報が、ポリシーで指定される機密設定
によって保護されます。
注意 : ポリシーを使用して適用されるドキュメントの機密設定は、Acrobat でパスワードまたは証明書セキュリティオプションを使用して
ントに適用されているすべての設定に代えて使用されます （Acrobat のヘルプを参照）。
PDF ドキュメ
オンラインで使用するドキュメントのポリシーによる保護
保護されているドキュメントを開くには、ユーザーは LiveCycle Rights Management ES2.5 にログインする必要があることをポリシーで設定できます。
オンラインで使用するドキュメントの保護には、ドキュメントを暗号化し、認証および承認されたユーザーにだけアクセスを許可する簡単なプロセスが
採用されています。
このダイアグラムにおける手順は次のとおりです。
1
ドキュメント所有者または管理者は、サポートされているクライアントアプリケーションのドキュメントを、オンラインでの使用を許可するポリ
シーで保護することを決定します。ユーザーは、サポートされているクライアントアプリケーションを使用して、ドキュメントにポリシーを適用でき
ます。また、開発者は、プロセスで Rights Management サービスを使用するか、または Rights Management Service API をプログラムで使用し
て、ドキュメントをポリシーで保護できます。
2
Rights Management ES2.5 によって、ドキュメントライセンスとドキュメントキーが作成され、ポリシーが暗号化されます。ドキュメントライセン
ス、ドキュメントキーおよび暗号化されたポリシーが、クライアントアプリケーションに返されます。
ドキュメントライセンスは、保護されているドキュメント、ポリシーおよびサーバーの ID を識別する XML ドキュメントです。サーバーはライセン
スに電子署名してデータの整合性を確保します。
ドキュメントキーは、ドキュメントを暗号化するための対称キーです。保護された各ドキュメントにはドキュメントキーが関連付けられています。
ADOBE LIVECYCLE ES2.5
Rights Management サービス
3
114
LiveCycle ES2.5 サービス
クライアントアプリケーションでは、ドキュメントキーを使用してドキュメントを暗号化し、ドキュメントキーを破棄して、ドキュメントライセン
スとポリシーを埋め込みます。これらのタスクは Web ページまたはサポートされるクライアントアプリケーションで実行されます。
ポリシーでドキュメントイベントをログに記録するように指定している場合、ユーザーがドキュメントを開くと、クライアントソフトウェアは直ちにイ
ベント情報をサーバーに送信してログに記録します。監査ログについて詳しくは、LiveCycle ES2.5 の管理ヘルプの「イベントの監視」を参照してくだ
さい。
ポリシーで保護されたドキュメントへのオンラインでのアクセス
ポリシーで保護されたドキュメントを開いて使用するには、ユーザーがドキュメントへアクセスすることを、ポリシーで許可する必要があります。さら
に、ドキュメントのユーザーは、有効な Rights Management ES2.5 アカウントおよび適切なクライアントアプリケーションを持っている必要がありま
す。PDF ドキュメントの場合は、Acrobat または Adobe Reader が必要です。その他のファイルタイプの場合は、Rights Management ES2.5
Extension がインストールされている適切なアプリケーションが必要です。
ユーザーがポリシーで保護されたドキュメントを開こうとすると、Acrobat、Adobe Reader、または Rights Management ES2.5
Extension が Rights
Management ES2.5 に接続してユーザー認証を行います。その後、ユーザーはログイン操作に進むことができます。ドキュメントの使用が監査されてい
る場合は、通知メッセージが表示されます。Rights Management ES2.5 では、付与されるドキュメント権限が確認され、ドキュメントの復号化が管理
されます。この後で、ユーザーはポリシーの機密設定に従ってドキュメントを使用できるようになります。
このダイアグラムにおける手順は次のとおりです。
1
ドキュメントユーザーが、サポートされているクライアントアプリケーションでドキュメントを開きます。このとき、サーバーによって認証が行わ
れます。このタスクはサポートされるクライアントアプリケーションで実行されます。ドキュメントの ID が Rights Management サービスに送信さ
れます。
2
Rights Management サービスでユーザーが認証され、認証用のポリシーが確認され、バウチャーが作成されます。バウチャー（ドキュメントキーと
権限を含む）は、クライアントアプリケーションに送り返されます。
3
ドキュメントはドキュメントキーを使用して解読され、ドキュメントキーは破棄されます。ドキュメントはポリシーの機密設定に従って使用できるよ
うになります。これらのタスクはサポートされるクライアントアプリケーションで実行されます。
ADOBE LIVECYCLE ES2.5
Rights Management サービス
115
LiveCycle ES2.5 サービス
ポリシーでドキュメントイベントをログに記録するように指定している場合、ユーザーがドキュメントを開くと、クライアントソフトウェアは直ちにイ
ベント情報をサーバーに送信してログに記録します。監査ログについて詳しくは、LiveCycle ES2.5 の管理ヘルプの「イベントの監視」を参照してくだ
さい。
ポリシーで保護されたドキュメントのコピーを保存すると、ポリシーは新しいドキュメントに対して自動的に適用、実行されます。新しいドキュメント
を開くなどのイベントも監査されて、元のドキュメントで記録されます。
ユーザーは、次の状況になるまでドキュメントを継続して使用できます。
•
•
無期限、またはポリシーで指定された有効期限まで
管理者、またはポリシーを適用したユーザーが、ドキュメントを開く権限を取り消すか、ポリシーを変更するまで
ポリシーで保護されたドキュメントのオフラインでの使用
ユーザーが Rights Management ES2.5 にネットワーク接続していないときにドキュメントを開くことができるようポリシーを設定できます。
注意 : 一般的に、オンラインのみでの使用を許可するポリシーで保護されたドキュメントは、オフラインでの使用を許可するポリシーで保護されたドキュ
メントよりも安全です。
ユーザーが初めてオフラインドキュメントにアクセスするとき、オフラインアクセスを有効にするように求められます。別のコンピュータから開く場合
を除き、今後オフラインドキュメントを開くときに同じように要求されることはありません。
ユーザーがオフラインアクセスを有効にすると、LiveCycle ES2.5 サーバーは、ドキュメントをオフラインで開くために必要なデータをクライアントと
同期します。このデータには、暗号キーと、ポリシー、ライセンスおよび失効情報に関連する更新情報が含まれています。このデータは、MicroSafe と
呼ばれる保護されたクライアントデータベースに格納されます。MicroSafe は暗号化されています。MicroSafe の保護には、プラットフォームに固有の
データ保護 API（例えば、Windows の場合は DPAPI、Mac OS® の場合は KeyChain）が使用されます。
ユーザーが保護されたドキュメントをオンライン中に開くたび、バックグラウンドで同期プロセスが開始されます。このプロセスによって、前回同期が行われた
以降の差分情報を使用して MicroSafe が更新されます。ポリシーに指定されたオフラインリース期間は、ユーザーがドキュメントをオフラインで開くためにどの
くらい前に同期を行っている必要があるかを決定します （LiveCycle ES2.5 の管理ヘルプの「オフラインセキュリティの設定」を参照）。
セキュリティ標準とテクノロジ
次の表に、セキュリティを実装するために Rights Management ES2.5 で使用される方法の詳細を示します。
アクション
使用されるテクノロジまたは方法
ドキュメントキーの作成
ANSI X9.61 に従って生成された擬似乱数ジェネレータ（PRNG）。
CBC モードの AES-128 または 256 ビット暗号化用
の初期化ベクトル（IV）の作成
使用される実装は、RSA BSafe Crypto-C（Acrobat の場合）または Crypto-J（Rights
Management ES2.5 の場合）ツールキットです。
PDF ドキュメントの暗号化
Federal Information Processing Standards（FIPS）Publication 197 に従った AES-128（Acrobat
9.0 の場合は AES 256）。
メッセージダイジェストの作成
FIPS Pub 180-2 に従った Secure Hash Algorithm-1（SHA-1）および Secure Hash Algorithm-2
（SHA-2）。
メッセージ送信者の ID の検証
SAML 認証のアサーションが SOAP メッセージに関連付けられます。
SAML アサーションは、SHA-1 を使用してハッシュされます。HMAC-SHA-1 メッセージ認証コード
を使用して、SAML アサーションに署名します。
ADOBE LIVECYCLE ES2.5
Rights Management サービス
116
LiveCycle ES2.5 サービス
Rights Management サービスの使用
ポリシーの作成
様々な状況およびユーザーに対応するセキュリティ設定を使用して、いくつでもポリシーを作成できます。
ポリシー属性
新しいポリシーを作成する場合、ポリシー名など、様々なポリシー属性を設定します。LiveCycle ES2.5 SDK または Rights Management ES2.5 Web
ページを使用してポリシーを作成する場合は、ポリシーの有効期間も設定できます。有効期間は、承認された受信者が、ポリシーで保護されたドキュメ
ントにアクセスできる期間です。この属性を設定しないと、ポリシーは常に有効になります。
有効期間の設定は、次のいずれかから選択できます。
•
•
•
•
日数。ドキュメントが発行されたときから、この日数の間、ドキュメントにアクセスできます。
終了日。この終了日を過ぎると、ドキュメントにはアクセスできません。
指定した日付範囲。この日付範囲の間、ドキュメントにアクセスできます。
常に有効。
開始日だけを指定することもできます。この場合、指定した開始日からポリシーが有効になります。終了日だけを指定した場合は、指定した終了日まで
ポリシーが有効です。
PDF ドキュメントに透かしを適用するポリシーを作成することもできます。透かしを使用すると、ドキュメントを一意に識別し、著作権の侵害を制御す
ることで、PDF ドキュメントのセキュリティを確保できます。透かしに表示できるテキストは、次のいずれかです。
•
ユーザー名： ドキュメントを開いたユーザーの名前
•
ユーザー ID： ドキュメントを開いたユーザーの
•
ポリシー名： ドキュメントに割り当てられたポリシーの名前
•
現在の日付： ドキュメントが開かれた日付
•
カスタムテキスト： 任意のテキスト（
「社外秘」など）
ID
透かしを作成したら、その透かしをポリシーの一部にすることができます。透かしを含むポリシーを PDF ドキュメントに適用すると、その透かしがポリ
シーで保護されたドキュメントの各ページに表示されます。
ポリシーエントリ
ポリシーエントリは、グループとユーザーであるプリンシパルおよび権限をポリシーに追加します。ポリシーには少なくとも 1 つのポリシーエントリが
必要です。例えば、次のタスクを実行するとします。
•
•
•
グループがドキュメントをオンラインでのみ表示できるようにし、受信者がドキュメントをコピーすることを禁止するポリシーエントリを作成する
このポリシーエントリをポリシーに追加する
このポリシーを使用してドキュメントを保護する
これらの操作の結果、受信者はドキュメントをオンラインでのみ表示できますが、コピーはできません。ドキュメントからセキュリティを削除するまで、
ドキュメントは保護されます。
ポリシーの作成方法
•
ユーザーおよび管理者は、Rights Management ES2.5 Web ページを使用できます（LiveCycle Rights Management ES2.5 ヘルプまたは LiveCycle
ES2.5 管理ヘルプの「ポリシーの作成および編集」を参照）。
•
Workbench を使用して、既存のポリシーからポリシーを作成します。Workbench でポリシーを作成する場合、設定できるプロパティは少なくな
ります （LiveCycle Workbench 9.5 ヘルプを参照）。
•
Rights Management Service API を使用します（『Programming with LiveCycle ES2.5』を参照）。
ADOBE LIVECYCLE ES2.5
Rights Management サービス
117
LiveCycle ES2.5 サービス
ポリシーの変更
ビジネス要件が変わり、ポリシーが要件を反映しなくなった場合、ポリシーを変更できます。新しいポリシーを作成する代わりに、既存のポリシーを単
純に更新できます。
ポリシーを変更するには、ポリシー属性の値を変更します。変更できないポリシー属性は、「変更できない詳細設定」セクションの属性だけです。
Workbench では、ポリシー名と有効期間も変更できません。例えば、ポリシーのオフラインリース期間を変更するために、ポリシーのオフラインリース
期間属性の値を変更できます。
ドキュメントを保護しているポリシーに対する変更は、ポリシーで保護されたドキュメントが Rights Management サービスと次回同期するときに更新
されます。
ポリシーの変更方法
•
ユーザーおよび管理者は、Rights Management ES2.5 Web ページを使用できます（LiveCycle Rights Management ES2.5 ヘルプまたは LiveCycle
ES2.5 管理ヘルプの「ポリシーの作成および編集」を参照）。
•
•
Workbench を使用します （LiveCycle Workbench 9.5 ヘルプを参照）。
Rights Management Service API を使用します（『Programming with LiveCycle ES2.5』を参照）。
ポリシーの削除
既存のポリシーが不要になった場合は削除できます。ポリシーは、削除するとドキュメントの保護に使用できません。ただし、そのポリシーを使用して保
護されていた既存のドキュメントはそのまま保護されます。
ポリシーを削除するには、削除するポリシーとそのポリシーが属するポリシーセットを指定します。LiveCycle ES2.5 の呼び出しに使用される設定を持
つユーザーには、ポリシーを削除する権限が必要です。権限がない場合は、例外が発生します。同様に、存在しないポリシーを削除しようとすると、例
外が発生します。
ポリシーの削除方法
•
ユーザーおよび管理者は、Rights Management ES2.5 Web ページを使用できます（LiveCycle Rights Management ES2.5 ヘルプまたは LiveCycle
ES2.5 管理ヘルプの「ポリシーの削除」を参照）。
•
Rights Management Service API を使用します（『Programming with LiveCycle ES2.5』を参照）。
ドキュメントへのポリシーの適用
ポリシーをドキュメントに適用してドキュメントを保護できます。ポリシーをドキュメントに適用することで、ドキュメントへのアクセスを制限し、機
密設定をドキュメントに適用します。
LiveCycle ES2.5 SDK を使用して PDF ドキュメントにポリシーを適用するには、既存のポリシーを参照し、そのポリシーが属するポリシーセットを指
定する必要があります。Rights Management ES2.5 への接続に使用するユーザーアカウントには、ポリシーへのアクセス権限が必要です。アクセス権
限がない場合は、例外が発生します。
ドキュメントに適用されるのは、一度に 1 つのポリシーだけです。
ポリシーの適用方法
•
•
ポリシーを PDF ドキュメントに適用するには、Acrobat Professional または Acrobat Pro Extended を使用します （Acrobat のヘルプを参照）。
ポリシーを Microsoft Office ドキュメントに適用するには、LiveCycle Rights Management ES2.5 Extension for Microsoft Office を使用します
（LiveCycle Rights Management ES2 Extension のヘルプ（Microsoft 2003）または LiveCycle Rights Management ES2 Extension のヘルプ
（Microsoft 2007）を参照）。
•
•
Workbench を使用します （LiveCycle Workbench 9.5 ヘルプを参照）。
Rights Management Service API を使用します（『Programming with LiveCycle ES2.5』を参照）。
ADOBE LIVECYCLE ES2.5
Rights Management サービス
118
LiveCycle ES2.5 サービス
ドキュメントからのポリシーの削除
ポリシーで保護されたドキュメントからポリシーを削除して、ドキュメントからセキュリティを削除できます。ポリシーで保護されたドキュメントを新
しいポリシーで更新するには、ポリシーを削除した後で更新したポリシーを追加するのではなく、ポリシーを切り替える方が効率的です。
ポリシーの削除方法
•
•
ポリシーを PDF ドキュメントから削除するには、Acrobat® Professional または Acrobat Pro Extended を使用します（Acrobat のヘルプを参照）。
ポリシーを Microsoft Office ドキュメントから削除するには、LiveCycle Rights Management ES2.5 Extension for Microsoft Office を使用しま
す （LiveCycle Rights Management ES2 Extension のヘルプ（Microsoft 2003）または LiveCycle Rights Management ES2 Extension のヘルプ
（Microsoft 2007）を参照）。
•
•
Workbench を使用します （LiveCycle Workbench 9.5 ヘルプを参照）。
Rights Management Service API を使用します（『Programming with LiveCycle ES2.5』を参照）。
ドキュメントに適用されるポリシーの切り替え
ポリシーで保護されたドキュメントを新しいポリシーで更新するには、ポリシーを削除した後で更新したポリシーを追加するのではなく、ポリシーを切
り替える方が効率的です。
ポリシーを切り替えると、新しいポリシーは以下のように適用されます。
•
ドキュメントがオンラインで閉じられている場合は、受信者が次にドキュメントをオンラインで開いて Rights Management ES2.5 と同期するとき
•
•
ドキュメントがオンラインで開いている場合は、ユーザーがドキュメントを閉じると変更が反映されます。
に、変更が反映されます。
ドキュメントがオフラインになっている場合は、ポリシーで保護されたドキュメントをオンラインで開くことによって、次にユーザーが Rights
Management ES2.5 と同期するときに変更が反映されます。
注意 : 現在匿名アクセスが許可されていない、ポリシーで保護されたドキュメントへの匿名アクセスを許可するには、クライアントアプリケーション内の
既存ポリシーを削除してから、匿名アクセスを許可するポリシーを適用します。ポリシーを切り替えても、ユーザーはドキュメントにアクセスするため
にログインする必要があります。
ポリシーの切り替え方法
•
ユーザーおよび管理者は、Rights Management ES2.5 Web ページを使用できます（LiveCycle Rights Management ES2.5 ヘルプまたは LiveCycle
ES2.5 管理ヘルプの「ドキュメントに適用されるポリシーの切り替え」を参照）。
•
•
Workbench を使用します （LiveCycle Workbench 9.5 ヘルプを参照）。
Rights Management Service API を使用します（『Programming with LiveCycle ES2.5』を参照）。
ポリシーで保護されたドキュメントへのアクセス権限の失効
ポリシーで保護されたドキュメントへのアクセス権限を失効させることができます。この操作を行った場合、ユーザーは、そのドキュメントのすべての
コピーにアクセスできなくなります。失効されたドキュメントを開こうとすると、指定されている URL にリダイレクトされて、改訂されたドキュメント
が表示されます。ドキュメントへのアクセス権限を失効させる場合、その変更が反映されるのは、次にユーザーがポリシーで保護されたドキュメントを
オンラインで開いたときです。
ドキュメントへのアクセス権限を失効する機能によってセキュリティを強化できます。例えば、ドキュメントの新しいバージョンが使用可能であり、古
いバージョンを表示できなくなるようにするとします。この場合、古いドキュメントへのアクセス権限を失効することができ、アクセス権限を復元しな
い限りドキュメントは表示できません。
ドキュメントへのアクセス権限の復元
失効されたドキュメントへのアクセス権限を復元（失効取り消し）することができます。これにより、ユーザーは、失効されたドキュメントのすべての
コピーにアクセスできるようになります。
ADOBE LIVECYCLE ES2.5
Rights Management サービス
119
LiveCycle ES2.5 サービス
ドキュメントへのアクセス権限の失効方法
•
ユーザーおよび管理者は、Rights Management ES2.5 Web ページを使用できます（LiveCycle Rights Management ES2.5 ヘルプまたは LiveCycle
ES2.5 管理ヘルプの「ドキュメントアクセスの失効と復元」を参照）。
•
•
Workbench を使用します （LiveCycle Workbench 9.5 ヘルプを参照）。
Rights Management Service API を使用します（『Programming with LiveCycle ES2.5』を参照）。
イベントの監視
Rights Management サービスは、ポリシーで保護されたドキュメントに対して特定のアクションが実行されたときに、そのアクションを追跡できます。
この追跡が行われるのは、監査機能が有効であり、なおかつドキュメントを保護するために使用されるポリシーで監査が有効に設定されている場合です。
追跡できるイベントとしては、ドキュメントにポリシーを適用する、ポリシーで保護されたドキュメントを開くなどのアクティビティがあります。
イベントは、次のいずれかのカテゴリに分類されます。
•
•
•
•
管理者イベントは、新しい管理者アカウントの作成など、管理者に関するアクションです。
ドキュメントイベントは、ポリシーで保護されたドキュメントを閉じるなど、ドキュメントに関するアクションです。
ポリシーイベントは、新しいポリシーの作成など、ポリシーに関するアクションです。
サービスイベントは、ユーザーディレクトリとの同期など、Rights Management サービスに関するアクションです。
Rights Management Service API を使用して、特定のイベントを検索できます。また、Rights Management ES2.5 Web ページを使用して、監査され
たイベントを検索および表示できます。ユーザーは、自分のポリシーで保護されたドキュメントおよび受信して使用している保護されたドキュメントに
関して監査されたイベントを表示できます。管理者は、ポリシーで保護されたすべてのドキュメントとユーザーに関して監査されたイベントを表示でき
ます。管理者はそれ以外のタイプのイベント（ユーザーイベント、ドキュメントイベント、ポリシーイベント、システムイベント）も追跡できます。
ポリシーで保護されたドキュメントのコピーに対して行われるイベントも、元のポリシー保護ドキュメントに対するイベントとして追跡されます。
許可されていないユーザーがドキュメントを表示しようとしたり、正しくないユーザー名やパスワードでログインしようとした場合には、失敗したイベ
ントが記録されます。
ポリシーを使って、匿名ユーザーにアクセスを許可できます。管理者が後で匿名アクセスを無効に設定すると、ポリシーによって保護されたドキュメン
トへの匿名アクセスが失敗するようになり、イベントがログに記録されません。
イベントの監視方法
•
ユーザーおよび管理者は、Rights Management ES2.5 Web ページを使用できます（LiveCycle Rights Management ES2.5 ヘルプまたは LiveCycle
ES2.5 管理ヘルプの「イベントの監視」を参照）。
•
Rights Management Service API を使用します（『Programming with LiveCycle ES2.5』を参照）。
Rights Management サービスに関する考慮事項
操作の順序
1 つのドキュメントに対して暗号化、認証方法、および使用権限の適用を組み合わせて使用する場合は、次に示す順序で行う必要があります。これらの
サービスは、短時間のみ有効なプロセス内で呼び出す必要があります。
1
ドキュメントに電子署名する（Signature サービス）前に、ドキュメントに暗号化を適用するか（Encryption サービス）、ポリシーを適用します
（Rights Management サービス）。電子署名は、署名時のファイルの状態を記録します。署名を適用した後にドキュメントを暗号化またはポリシーを
適用すると、ファイルのバイト数が変わり、署名は無効になります。
2
使用権限（Reader Extensions サービス）を設定する前に PDF ドキュメントを認証します（Signature サービス）。使用権限を適用した後にドキュ
メントを認証すると、使用権限の署名が無効となり、ドキュメントから使用権限が削除される場合があります。
3
使用権限を設定した後に PDF ドキュメントに電子署名します（Signature サービス）。使用権限を適用した後に PDF ドキュメントに署名すると、使
用権限の署名は無効になりません。
また、PDF ドキュメントを暗号化して、ポリシーを同じ PDF ドキュメントに適用することはできません。同様に、暗号化された PDF ドキュメントにポ
リシーを適用することはできません。
120
30. Set Value サービス
Set Value サービスを使用して、プロセスデータモデルの 1 つ以上のデータ項目の値を設定します。例えば、プロセス変数の値やフォームフィールドの値
を設定できます。
Set Value サービスの使用
Set Value サービスを使用するプロセスを LiveCycle Workbench で開発することによって、このサービスを対話的に操作できます。
XPath 式を使用して、データ項目とその項目に設定する値を指定できます。値を設定するデータ項目ごとにマッピングを作成します。変数データは、プロ
セス全体を通して使用できるように保持されます。XPath について詳しくは、XML Path Language（XPath）の仕様を参照してください。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 のヘルプを参照してください。
121
31. Signature サービス
Signature サービスを使用すると、LiveCycle ES2.5 サーバー上の電子署名やドキュメントを操作できます。このサービスは、LiveCycle Workbench で
作成されたプロセスから使用したり、LiveCycle ES2.5 SDK で作成された Java サービスクライアントや Web サービスクライアントから使用したりでき
ます。例えば、Signature サービスは、通常、次の状況で使用します。
•
Acrobat または Adobe Reader を使用してフォームを開くユーザーへフォームが送信される前に、LiveCycle ES2.5 サーバーでフォームが認証され
るとき。
•
•
Acrobat または Adobe Reader を使用してフォームに追加された署名が、LiveCycle ES2.5 サーバーで検証されるとき。
LiveCycle ES2.5 サーバーが公証人に代わってフォームに署名するとき。
Signature サービスが、Trust Store に格納されている証明書および秘密鍵証明書にアクセスします （LiveCycle ES2.5 の管理ヘルプの「証明書と秘密鍵
証明書の管理」を参照）。
この章には、電子署名および Signature サービスの背景情報に関する次のトピックが含まれています。
•
•
•
•
•
•
「電子署名について」(121 ページ )
「署名フィールドについて」(122 ページ )
「Signature サービスとフォームの種類について」(122 ページ )
「電子署名テクノロジについて」(123 ページ )
「セキュリティインフラストラクチャとの統合」(124 ページ )
「サポートされるテクノロジおよび標準」(125 ページ )
次のトピックでは、実行できるタスク、および最適な結果を得る方法について説明します。
•
•
「Signature サービスの使用」(125 ページ )
「ベストプラクティス」(128 ページ )
電子署名について
電子署名とは、電子ドキュメントに追加される情報のブロックです。電子署名を使用して、署名者の身元を証明し、ドキュメントまたはその一部の整合
性を検証します。
•
•
署名には、署名の所有者を特定できる情報が含まれています。この情報は、ドキュメントの作者の身元を確認する場合に便利です。
電子署名されたドキュメントでは、署名を使用して、署名が行われた時点以降にドキュメントが変更されたかどうかを判別できます。
秘密鍵証明書は、電子署名を作成するために使用します。証明書は、電子署名とその所有者を検証するために使用します。
電子署名と Signature サービス
Signature サービスでは、PDF 署名と XML 署名をサポートしています。
•
Signature サービスは、すべての PDF ドキュメント（例えば LiveCycle Designer ES2.5 や Acrobat を使用して作成された PDF ドキュメント）に
PDF 署名を作成できます。
• Signature サービスは、XFA ベースの PDF ドキュメント（例えば、Designer ES2.5 を使用して作成された PDF ドキュメントや Forms サービス
によって作成された PDF ドキュメント）の XML 署名を検証できます。
PDF 署名は、署名者の身元の基本認証やドキュメントの整合性の検証のみならず、次のような目的に使用できます。
承認署名： ドキュメントのコンテンツを承認するために使用します。例えば、ユーザーがフォームに記入した後、フォームデータを承認するためにフォー
ムに署名します。
ADOBE LIVECYCLE ES2.5
Signature サービス
122
LiveCycle ES2.5 サービス
認証署名： ドキュメントのコンテンツを証明し、ドキュメントが認証状態を保持するうえで許可される変更の種類を指定します。例えば、政府機関が作成
する署名フィールド付きのフォームがこれに該当します。政府機関は、ドキュメントを認証し、ユーザーがフォームのフィールドのみを変更してドキュ
メントに署名することを許可します。ユーザーはフォームに情報を入力し、ドキュメントに署名することができます。ただし、ページを削除したりコメン
トを追加したりした場合、ドキュメントの認証ステータスは保持されません。
認証署名は、Modify Detection Prevention（MDP）署名とも呼ばれます。
署名フィールドについて
フォームを電子署名すると、署名が署名フィールドに追加されます。フォームに署名するには、事前に署名フィールドが作成されている必要があります。
1 つのフォームに複数の署名フィールドを追加できます。署名フィールドはそれぞれ、フォーム内のフィールドのセットに関連付けることができます。署
名を追加した後、関連付けられているフィールドはロックされます。このような種類の署名は、MDP+ 署名と呼ばれます。この機能を PDF フォームや
XML フォームで使用するには、Acrobat または Adobe Reader 8.0 以降を使用してフォームを開く必要があります。
シード値ディクショナリを署名フィールドに追加して、ドキュメントの署名時にフィールドをどのように使用するかを設定できます。例えば、署名の理
由の一覧を提供したり、ドキュメントダイジェストの作成に使用できるハッシングアルゴリズムを指定したりできます。
署名フィールドは、デザイン時または実行時に追加できます。
•
•
デザイン時に署名フィールドを追加するには、Designer ES2.5 を使用します（LiveCycleDesigner ES2.5 のヘルプを参照）。
実行時に署名フィールドを追加するには、Signature サービスを使用します （「署名フィールドの追加、変更および削除」(128 ページ ) を参照）。
Signature サービスとフォームの種類について
LiveCycle ES2.5 では、いくつかの種類の PDF がサポートされます。Acrobat または Adobe Reader のユーザーは種類が異なるフォームに対して明確
な違いを認識しないでしょうが、これらの間では PDF フォームの作成方法が異なります。例えば、フォームは、LiveCycle ES2.5 サーバー上の Forms
サービス、Acrobat または Adobe Reader を使用して PDF にレンダリングできます。
レンダリングを必要としない PDF フォームは、あらゆる状況で Signature サービスと共に使用できます。ただし、レンダリングを必要とする PDF
フォームでは、その使用方法によって電子署名に関して問題が発生する可能性があります。
電子署名された PDF フォームをレンダリングすると、フォームの署名が無効になります。例えば、ユーザーが Acrobat で動的 PDF フォームを開き、電
子署名を行って保存してから、そのファイルを同僚に電子メールメッセージで送信するとします。同僚がそのフォームを開くと、Acrobat によってフォー
ムが PDF にレンダリングされ、電子署名が無効になります。
Signature サービスを使用するには、使用するフォームの種類を特定します。
Acrobat PDF フォーム： Acrobat（または類似のツール）を使用して作成された PDF フォーム。これらのフォームでは、作成された後のレンダリングは
必要ありません。
Adobe PDF フォーム： Designer ES2.5 を使用して作成された PDF フォーム。これらのファイルは、静的または動的な PDF フォームとして保存されます。
•
静的 PDF フォームのコンテンツは、フィールド値を除き、変更されません。ファイルを開くとき、Acrobat または Adobe Reader は、ファイル内
の情報を使用して PDF フォームをレンダリングします。ファイルを初めて保存するときに、PDF フォームもそのファイル内に保存されます。次回
フォームを開いたときに、フォームは再レンダリングされません。
•
動的 PDF フォームのコンテンツは、ユーザー入力によって変更されます。例えば、テーブルの行またはサブフォームを必要に応じて追加できます。
PDF フォームは、Acrobat または Adobe Reader を使用して開くときに常にレンダリングされます。
静的および動的 Adobe PDF フォームについて詳しくは、LiveCycle Designer ES2.5 ヘルプの「Designer ES2.5 の使用」／「フォームデザインの操作」
／「PDF フォーム作成のためのガイドライン」を参照してください。
ADOBE LIVECYCLE ES2.5
Signature サービス
123
LiveCycle ES2.5 サービス
Adobe XML フォーム： Designer ES2.5 を使用して作成された XDP ファイル。Adobe XML フォームは、Forms サービスを使用して Acrobat または
Adobe Reader で開くことができます。Forms サービスは、次のいずれかのエージェントによって PDF がレンダリングされるように構成できます。
•
•
•
クライアントに送信される前の（LiveCycle ES2.5 サーバー上の）Forms サービス
Acrobat
Adobe Reader.
非インタラクティブ PDF フォーム： ユーザーが電子的に表示または印刷できる
PDF フォーム。例えば、異なるファイル形式から PDF に変換できるファ
イルは非インタラクティブです。これらのフォームでは、作成された後のレンダリングは必要ありません。
LiveCycle Workspace ES2.5 で使用されるフォームのデザイン要件について詳しくは、「フォームデザインおよび Workspace ES2.5 に関する要件」
(129 ページ ) を参照してください。
電子署名テクノロジについて
公開鍵による暗号化
電子署名は、公開鍵 / 秘密鍵のペアを使用してテキストの暗号化および復号化が行われる、公開鍵による暗号化（または非対称の暗号化）に基づいてい
ます。
•
•
秘密鍵は、テキストおよびドキュメントを暗号化するために使用します。秘密鍵は、安全な場所に保管します。
対応する公開鍵は、秘密鍵によって暗号化されたテキストを復号化するために使用します。公開鍵で復号化できるのは、関連付けられている秘密鍵に
よって暗号化されたテキストのみです。公開鍵は、広範な配布先へ配布されることがあります。
例えば、Tony Blue が秘密鍵を使用して電子メールメッセージを暗号化してから受信者に送信するとします。受信者がメッセージ復号化して読むために
は、公開鍵が必要です。受信者が電子メールメッセージを読むことができるようにするために、Tony はあらかじめ公開鍵を受信者に渡しておく必要があ
ります。
電子証明書
電子証明書は、電子署名の信頼性を確認するために使用します。電子証明書は、公開鍵をユーザーの身元と関連付けます。
•
証明書は、信頼できる第三者の認証局（CA）から発行されます。CA は、証明書を発行するユーザーの身元を証明します。CA を信頼するというこ
とは、その CA によって発行される証明書を信頼することになります。
•
証明書は、自己署名することもできます。自己署名証明書は、通常、証明書の所有者によって生成されます。所有者を確実に信頼できる場合に、証明
書は便利です。
CA は、現在無効になっている証明書のシリアル番号が含まれた証明書失効リスト（CRL）を発行します。CRL には有効期限があり、通常、定期的に更
新されます。
CRL に似たオンライン証明書ステータスプロトコル（OCSP）は、X.509 証明書のステータスを取得するために使用されます。OCSP では、証明書のス
テータスを CRL システムよりもすばやく更新および取得できます。
CA は、証明書を発行する権限を下位レベルの CA に委任できます。その結果、CA の階層が構成されます。証明書チェーンは、下位レベルの CA から
ルート CA に至る階層におけるパスを示します。下位レベルの CA から発行される証明書には、証明書チェーンが含まれます。チェーン内の各 CA の信頼
性を確認することができます。
ADOBE LIVECYCLE ES2.5
Signature サービス
124
LiveCycle ES2.5 サービス
電子秘密鍵証明書
秘密鍵証明書は、ドキュメントを電子署名するために使用します。秘密鍵証明書には、ユーザーの秘密鍵やエイリアスなどのその他の識別情報が含まれ
ます。秘密鍵証明書のコンテンツにアクセスするには、パスワードが必要です。様々な標準によって秘密鍵証明書のコンテンツおよび形式が定義されてい
ます。例えば、次の標準があります。
•
Personal Information Exchange Syntax Standard（PKCS #12）では、秘密鍵および対応する電子証明書を格納するためのファイル形式を定義し
ています。
•
Cryptographic Token Interface（PKCS #11）では、ハードウェアに格納されている秘密鍵証明書を取得するためのインターフェイスを定義してい
ます。
電子署名
電子署名は、署名されたドキュメントの暗号化されたダイジェストです。このダイジェストと署名者の証明書を使用して、ドキュメントの整合性が検証
されます。
ドキュメントに電子署名すると、ハッシングアルゴリズムを使用してドキュメントコンテンツのダイジェストが作成されます。ダイジェストはドキュメ
ントに対して一意であり、ダイジェストを使用してドキュメントを再構築することはできません。ダイジェストは、署名者が署名を作成するために使用
した秘密鍵を使用して暗号化されます。
署名を作成するために使用された秘密鍵に対応する署名および証明書は、通常、ドキュメントにバンドルされます。
署名には、タイムスタンプを含めることができます。タイムスタンププロトコル（TSP）は、電子署名が作成された時刻を証明するために使用されます。
この情報は、関連する証明書が失効する前に電子署名が作成されていることを確認する場合に便利です。タイムスタンプ局（TSA）は、タイムスタンプ
情報を取得および確認するためのサービスを提供します。
ドキュメントの整合性の検証
署名を検証するために、証明書の公開鍵を使用してダイジェストが復号化されます。次に、ダイジェストは、復号化されたダイジェストに基づいて再計
算および比較されます。2 つのダイジェストが同一の場合は、ドキュメントに変更が加えられていません。
セキュリティインフラストラクチャとの統合
Signature サービスは、Trust Store の管理に格納されている証明書、秘密鍵証明書、および失効リストにアクセスします。また、Trust Store の管理を使
用して、ハードウェアセキュリティモジュール（HSM）デバイスに格納されている秘密鍵証明書にアクセスすることもできます （LiveCycle ES2.5 の
管理ヘルプの「HSM 秘密鍵証明書の管理」を参照）。
Signature サービスでは、次に示すような、証明書の取得や署名の検証を行うための外部リソースとの通信もサポートしています。
•
•
•
チェーン検証用の証明書を取得するための LDAP/LDAPS クエリーおよび HTTP/HTTPS クエリー。
HTTP/HTTPS を使用した TSA への接続。
HTTP/HTTPS および LDAP/LDAPS を使用した CRL の取得。Signature サービスは、Trust Store の管理を使用して格納されるオフライン CRL
もサポートしています。
•
•
OCSP サーバーへの接続。
秘密鍵証明書の取得および証明書の検証を行うための外部サービスプロバイダとの統合。
ADOBE LIVECYCLE ES2.5
Signature サービス
125
LiveCycle ES2.5 サービス
サポートされるテクノロジおよび標準
次の表に、LiveCycle Digital Signatures ES2.5 でサポートされるテクノロジと業界標準の概要を示します。
アイテム
サポートされるテクノロジまたは標準
一方向ハッシュ（ドキュメントダイジェストの作 SHA-1、SHA-256、SHA-384 および SHA-512
成に使用）
MD5
RIPEMD160
電子署名
PKCS #1 および PKCS #7
RSA（最大 4096 ビット）
DSA（最大 4096 ビット）
XML 署名
シード値（証明書使用条件の実行）
タイムスタンプの作成（タイムスタンププロバイダを使用）
証明書の有効性
証明書失効リスト（CRL）
オンライン証明書ステータスプロトコル（OCSP）
RFC 3280 準拠パス検証
Signature サービスは、連邦情報処理規格（FIPS）への準拠を強制し、RSA BSAFE ライブラリを使用します。
Signature サービスの使用
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。プログラムによってこのサービスと
やり取りできるクライアントアプリケーションの作成について詳しくは、『Programming with LiveCycle ES2.5』を参照してください。
LiveCycle 管理コンソールのアプリケーションおよびサービスのページを使用して、このサービスのデフォルトプロパティを設定できます （LiveCycle
ES2.5 の管理ヘルプの「Signature サービスの設定」を参照）。
ドキュメントの署名と認証
Signature サービスでは、サービスからアクセスできる任意の秘密鍵証明書を使用することにより、PDF ドキュメントの署名と認証を行うことができま
す。署名または認証を行う場合は、使用する署名フィールドを指定します。
Signature サービスで動的 Adobe PDF フォームを使用する場合、次の制限があります。
•
•
•
可視署名フィールドに署名することはできません。
不可視署名フィールドを認証することはできません。
可視署名フィールドは、Acrobat 9 の互換性を持つドキュメントを処理するように Signature サービスが設定されている場合にのみ、認証できます。
フォームは、Acrobat または Adobe Reader 9 でのみ表示できます。
注意 : すべての種類のフォームにおいて、Acrobat または
Adobe Reader のユーザーは、Signature サービスによって追加された署名を削除できます。
フォームへの署名または認証を行う場合、次の情報を指定できます。
ADOBE LIVECYCLE ES2.5
Signature サービス
126
LiveCycle ES2.5 サービス
秘密鍵証明書： 電子署名を作成するために使用された秘密鍵を含む秘密鍵証明書。
ドキュメント MDP 権限： 認証を行う場合に、ユーザーが認証を無効にすることなくドキュメントに対して実行できる変更。
失効情報： 署名者の証明書を検証するために、署名に失効情報を埋め込むかどうか。この情報は、OCSP チェックおよび CRL チェックを可能にします。
タイムスタンプ情報： 署名のタイムスタンプを作成するかどうか、およびタイムスタンププロバイダとの間でタイムスタンプトランザクションを実行す
るために必要な情報。
表示方法： Acrobat または
Adobe Reader で表示した場合の署名の表示方法に作用するプロパティ。例えば、署名の理由、署名者の連絡先情報、法的証
明、使用するアイコンなどです。
ドキュメントの整合性および信頼性の検証
Signature サービスを使用して、PDF フォームに追加されている署名を検証できます。署名を検証するには、証明書の失効確認、署名のタイムスタンプ
の確認およびドキュメントダイジェストの検証を行います。PDF ドキュメント内の署名を個別に検証したり、すべての署名をまとめて検証することがで
きます。
Signature サービスを使用して電子署名を検証する場合、次の制限があります。
•
•
Signature サービスは、動的 Adobe PDF フォーム上の署名を正確に検証できません。
Signature サービスは、Adobe PDF フォームおよび Adobe XML フォームに対して署名フィールドのフィールドロックルール（MDP+ ルール）が
適用されることを保証できません。
署名の検証を行う場合、次の情報を指定できます。
署名フィールド： 検証する署名が格納されている署名フィールドの名前。
失効確認： 署名者の証明書が失効していないか確認するかどうか。OCSP および CRL の種類の確認を有効にするための情報を指定できます。
タイムスタンプの確認： 署名のタイムスタンプを検証する方法。
パス検証： 署名者の証明書に含まれる証明書チェーン内の証明書の検証を可能にする情報。
署名サービスに「Process Documents With Acrobat 9 Compatibility」オプションが選択されているかどうかで、表示される検証ステータスメッセー
ジが異なります（LiveCycle ES2.5 の管理ヘルプの「Signature サービスの設定」を参照）。
次の表では、このオプションを選択した場合に、署名の様々な有効性状態が発生する状況について説明します。
値
署名のステータス
DynamicFormSignatureUnknown
Status Unknown
DocumentSignatureUnknown
ドキュメントまたは動的 PDF フォームの整合性が検証されませんでした。
CertifiedDynamicFormSignatureTamper
Tamper
SignedDynamicFormSignatureTamper
ドキュメントまたは動的フォームは、署名が適用された後で変更されたか破損しました。
CertifiedDocumentSignatureTamper
SignedDocumentSignatureTamper
SignatureFormatError
Invalid
形式または内部情報にエラーがあるため、署名は無効です。
DynamicFormSigNoChanges
Signed with no changes
DocumentSigNoChanges
ドキュメントまたは動的フォームは、署名が適用された後で変更されていません。
DynamicFormCertificationSigNoChanges
Certified with no changes
DocumentCertificationSigNoChanges
ドキュメントまたは動的フォームは、認証された後で変更されていません。
ADOBE LIVECYCLE ES2.5
Signature サービス
LiveCycle ES2.5 サービス
値
署名のステータス
DocSigWithChanges
Signed with changes
署名の対象となるドキュメントのリビジョンは変更されていませんが、それ以降にドキュメントが変更さ
れました。
CertifiedDocSigWithChanges
Signed with allowed changes
ドキュメントは、署名が適用された後で変更されました。ただし、この変更はドキュメントの認証元から
許可されたものであり、署名は無効にされません。
CertificationSignWithChanges
Certified with changes
ドキュメントは、認証された後で変更されました。ただし、この変更はドキュメントの認証元から許可さ
れたものであり、署名は無効にされません。
次の表では、このオプションを選択しなかった場合に、署名の様々な有効性状態が発生する状況について説明します。
値
署名のステータス
無効
Signature Invalid
署名の対象となるドキュメントのリビジョンに変更が加えられています。
Unknown
Status Unknown
署名されたコンテンツに対する署名の検証が行われていません。
ValidAndModified
Signature valid but document modified
署名の対象となるドキュメントのリビジョンは変更されていませんが、その後ドキュメントに変更が加えられています。
ValidUnmodified
Signature valid and document unmodified
署名の対象となるドキュメントのリビジョンは変更されていません。それ以降、ドキュメントは変更されていません。
署名を検証する場合、PDF 署名と XML 署名のどちらを検証するかを理解している必要があります。
署名の削除
Signature サービスを使用して、署名フィールドから署名を削除できます。
署名および署名フィールドの取得
Signature サービスを使用して、フォームから次のアイテムを取得できます。
•
•
•
署名フィールドおよび認証署名フィールドに関する情報
電子署名および署名に関する情報
署名フィールドが署名されたときに存在していた PDF フォームのリビジョン
注意 : クライアント上でレンダリングされるフォームから認証署名フィールドを取得することはできません。
127
ADOBE LIVECYCLE ES2.5
Signature サービス
128
LiveCycle ES2.5 サービス
署名フィールドの追加、変更および削除
Signature サービスを使用して、フォームの可視署名フィールおよび不可視署名フィールドを追加、変更、および削除できます。署名フィールドを追加お
よび変更する場合、次のプロパティを設定できます。
•
•
•
•
•
フィールド名、および可視署名フィールドの場合はその位置
署名が追加されたときにロックするフィールド
署名を検証する署名ハンドラ
署名に関する情報（例えば、失効情報を含めるかどうか、ユーザーが選択できる署名の理由の一覧、署名の検証に使用するサーバーの URL）
ドキュメントの認証用にのみフィールドを使用できるかどうか
注意 : Signature サービスでは、 動的
Adobe PDF フォーム上での署名フィールドの追加や変更を行うことができません。
ベストプラクティス
LiveCycle ES2.5 および Signature サービスが持つ次の特性により、動的 Adobe PDF フォームの使用に関する制限が発生します。
•
•
署名されたフォームが PDF にレンダリングされると、電子署名は無効になります。
Signature サービスは、フィールドロック（MDP+）署名ルールを Adobe PDF フォームや Adobe XML フォームに適用できません。
一般に、動的 PDF フォームの使用とサーバー上での電子署名の使用のどちらがソリューションにとってより重要であるかを確認する必要があります。
•
動的 Adobe PDF フォームをサポートしない Signature サービスの機能を使用する必要がある場合は、異なる種類のフォームを使用して、Acrobat
または Adobe Reader でレンダリングが発生しないようにします （「署名後にレンダリングが発生しないことを確認する」(128 ページ ) を参照）。
•
PDF 動的フォームを使用する必要がある場合は、フォーム上で Signature サービスの機能を使用する前に、フォームを非インタラクティブフォーム
に変換できます （「非インタラクティブフォームへの変換」(129 ページ ) を参照）。
• Signature サービスでフォームを使用する前に、フォームが動的 Adobe PDF フォームではないことを確認してください （「フォームの種類の確認」
(129 ページ ) を参照）。
また、Workspace ES2.5 で開くフォームにデジタル署名を使用するには、フォームが特定のデザイン条件を満たしている必要があります （XREF を参照）。
操作の順序
1 つのドキュメントに対して暗号化、認証方法、および使用権限の適用を組み合わせて使用する場合は、次に示す順序で行う必要があります。これらの
サービスは、短時間のみ有効なプロセス内で呼び出す必要があります。
1
ドキュメントに電子署名する（Signature サービス）前に、ドキュメントに暗号化を適用するか（Encryption サービス）、ポリシーを適用します
（Rights Management サービス）。電子署名は、署名時のファイルの状態を記録します。署名を適用した後にドキュメントを暗号化またはポリシーを
適用すると、ファイルのバイト数が変わり、署名は無効になります。
2
使用権限（Reader Extensions サービス）を設定する前に PDF ドキュメントを認証します（Signature サービス）。使用権限を適用した後にドキュ
メントを認証すると、使用権限の署名が無効となり、ドキュメントから使用権限が削除される場合があります。
3
使用権限を設定した後に PDF ドキュメントに電子署名します（Signature サービス）。使用権限を適用した後に PDF ドキュメントに署名すると、使
用権限の署名は無効になりません。
署名後にレンダリングが発生しないことを確認する
フォームが PDF にレンダリングされると、フォームに含まれるすべての電子署名が無効になります。電子署名された PDF フォームがレンダリングされ
ないことを確認してください。静的 Adobe PDF フォームまたは Adobe XML フォームを使用している場合は、レンダリングが行われないようにするこ
とができます。
ADOBE LIVECYCLE ES2.5
Signature サービス
129
LiveCycle ES2.5 サービス
静的 Adobe PDF フォーム
Designer ES2.5 を使用し静的 Adobe PDF フォームを作成して、Acrobat または Adobe Reader で初めて開かれるときだけレンダリングが発生するよ
うにします。
Forms サービスを使用してフォームとデータをマージする場合は、サービスによってフォームが動的 PDF フォームに変換されないようにします。
Designer ES2.5 を使用して、次のフォームプロパティを設定します。
対象バージョン：「Acrobat および Adobe Reader 8.0 以降」を指定します。
レンダリング形式：「スタティック
PDF フォーム」を指定します。
フォームプロパティの設定について詳しくは、LiveCycle Designer ES2.5 のヘルプを参照してください。
User サービスの処理中にフォームを使用する場合は、フォームデータを格納する Document Form 変数とフォームデータを使用します。Document
Form 変数を設定して、レンダリングサービスが 1 回だけ呼び出されるようにします （LiveCycle Workbench 9.5 ヘルプを参照）。
Adobe XML フォーム
Adobe XML フォーム（XDP ファイル）は、Forms サービスを使用して PDF にレンダリングできます。Adobe XML フォームと共に Signature サー
ビスを使用するには、クライアント上ではなくサーバー上でレンダリングが行われるように Forms サービスが設定されている必要があります。サーバー
上でレンダリングが行われると、レンダリングされた PDF フォームは XDP ファイルに埋め込まれ、再びレンダリングされることはありません。
非インタラクティブフォームへの変換
動的 Adobe PDF フォームを Signature サービスと共に使用するには、フォームを非インタラクティブ PDF フォームに変換する必要があります。
通常、このシナリオでは、データを収集するための動的 Adobe PDF フォームを使用します。データ収集アクティビティが完了した後、フォームは
Signature サービスで使用される非インタラクティブ PDF フォームに変換されます。
•
•
•
署名フィールドが、非インタラクティブフォームに追加されます。
Signature サービスは、署名をフォームに追加できます。
フォームは、電子署名をするためにユーザーに送信できます。Signature サービスは、この署名を検証できます。
Workspace ES2.5 では、非インタラクティブフォームをユーザーに表示できません。ただし、User サービスを使用して非インタラクティブフォー
ムを Workspace ES2.5 タスクに関連付けることができます。電子メールメッセージを使用してフォームを配布することもできます。
PDF 動的フォームを非インタラクティブ PDF フォームに変換するには、出力 サービスを使用します。
注意 : 電子署名を含むフォームを非インタラクティブ PDF フォームに変換する場合、電子署名は保持されません。電子署名の外観のみが保持されます。
フォームの種類の確認
フォームに対して Signature サービスを使用する前に、そのフォームが動的 Adobe PDF フォームではないことを確認できます。PDF Utilities サービス
を使用すると、PDF ドキュメントのプロパティを取得できます。結果はフォームの種類を含み、値 Dynamic-XFA と異なっている必要があります。
フォームデザインおよび Workspace ES2.5 に関する要件
Workspace ES2.5 で開く PDF フォームでデジタル署名を使用している場合は、Process Fields オブジェクトではなく、非表示の「送信」ボタンを
フォームに追加する必要があります。非表示の「送信」ボタンにより、Workspace ES2.5 を使用してフォームが送信される際にフォームのデジタル署名
は有効のままとなります。
フォームに Process Objects オブジェクトが含まれている場合は、LiveCycle ES2.5 サーバーにより、オブジェクトの「送信」ボタンの外観が変更され
ます。フォームが送信される前に追加されたデジタル署名はすべて、変更が加えられたことを示しています。黄色い三角形は、変更が加えられたことへの
警告です。
「送信」ボタンは、Control Type プロパティが「Submit」に設定された Button オブジェクトです。ターゲット URL を指定する必要はありません。
「送信」ボタンの追加後に、Presence プロパティを「Invisible」に変更します。
デザイン時に非表示の「送信」ボタンを追加するには、Designer ES2.5 を使用します（LiveCycleDesigner ES2.5 のヘルプを参照）。
130
32. Stall サービス
Stall サービスは、予想される状況エラーの発生を防ぐのに役立ちます。このサービスは、自らが属しているブランチを停止する機能を持ちます。
例えば、プロセスにおいてパートナーのデータベースなどの外部リソースから提供されるデータを使用できます。スクリプト実行アクションは、データ
が有効であるかを検証するために使用できます。データが有効でない場合、停止アクションが実行されて、データベース内のデータを修正している間プ
ロセスインスタンスが停止されます。
Stall サービスの使用
Stall サービスを使用するプロセスを LiveCycle Workbench で開発することによって、このサービスを対話的に操作できます。
プロセスで状況エラーが発生する可能性がある場合は、Stall サービスにつながるルートを追加できます。状況エラーが発生したかどうかをチェックする
条件をルートに追加します。該当する状況が発生した場合、ブランチが停止するので、エラーを修正して LiveCycle 管理コンソールでプロセスを再開で
きます。
注意 : トランザクションのブランチまたは短時間のみ有効なプロセスで使用している場合は、ブランチは停止せず、実行操作で例外が発生します。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。
131
33. User サービス
User サービスを使用すると、プロセスで LiveCycle Workspace ES2.5 のユーザーにタスクを作成して割り当てたり、タスクを電子メールメッセージで
ユーザーに送信したりすることが可能になります。Task Manager Service API を使用してプログラムによってタスクを割り当てることもできます。作
成したタスクは、プロセス、Task Manager Service API、および LiveCycle 管理コンソールを使用してインタラクティブに操作することができます。
この章には、以下のトピックが含まれています。
•
•
「User サービスの使用」(131 ページ )
「タスクの操作」(132 ページ )
User サービスの使用
User サービスには、プロセスでタスクを作成し、それを Workspace ES2.5 または電子メールを使用してユーザーに割り当てる、タスク割り当て操作が
用意されています。タスク割り当て操作を使用することで、Workspace ES2.5 ユーザーに公開されたタスクの機能を設定することもできます。
タスクの割り当て
ユーザーまたはグループに割り当てられたタスクは、Workspace ES2.5 のタスクリストに追加されます。タスクは、User Management に存在する任意
のユーザーまたはグループに割り当てることができます。
•
作成したプロセスのすべてのインスタンスについて、タスクを同じユーザーまたはグループに割り当てることができます。この方法で開発時のテスト
を簡略化することができます。例えば、すべてのタスクを同じ担当者に割り当てれば、一度 Workspace ES2.5 にログオンするだけでタスクの作成
を検証できます。
•
タスクは、プロセス変数に格納されている特定のユーザー ID またはグループ ID に割り当てることができます。運用環境では、ユーザーまたはグ
ループがプロセスインスタンスによって変わる場合があるため、この方法が特に実用的です。ユーザーまたはグループの ID は、タスクの割り当て前
に取得されて保存されます。
タスクを割り当てる方法
•
•
LiveCycle Workbench を使用します （LiveCycle Workbench 9.5 ヘルプを参照）。
Task Manager Service API を使用します（『Programming with LiveCycle ES2.5』を参照）。
タスクの機能の設定
タスクの作成時には、ユーザーエクスペリエンスに影響を与える機能を設定できます。その例を次に示します。
フォームおよびフォームデータ： Workspace ES2.5 ユーザーに対してどのフォームを表示するか、フォームにどのようなフォームデータを含めるかを指
定します。タスクの完了時に送信されるフォームデータの保存場所も指定します。
インストラクション： Workspace ES2.5 のユーザーに、タスクの実行方法を説明する手順を提供します。
タスクの委任と問い合わせ： ユーザーがタスクを他のユーザーに委任したり、タスクに関する質問を他のユーザーに問い合わせることができるかどうかを
指定します。
添付ファイルとメモ： ユーザーが添付ファイルやメモをタスクに追加できるかどうかを指定します。実行する必要のある作業に関連したものであれば、開
発者や設計者がタスクに添付ファイルを追加することもできます。
リマインダ、デッドラインおよびエスカレーション： これらのメカニズムを設定することにより、プロセスの進行に時間的制約を与えることができます。
タスクの機能を設定する方法
•
Workbench を使用します （LiveCycle Workbench 9.5 ヘルプを参照）。
ADOBE LIVECYCLE ES2.5
User サービス
132
LiveCycle ES2.5 サービス
電子メール通知の設定
次に示すイベントが発生したときに、電子メールメッセージによる通知を Workspace ES2.5 ユーザーに送信できます。
•
•
•
ユーザーに対するタスクの割り当て
ユーザーが所有しているタスクのリマインダまたはデッドライン
ユーザーが所有しているタスクのエスカレーション
メッセージには、件名と本文を設定できます。テキストには、実行時に更新されるタスクのプロパティのパラメータを含めることができます。パラメータ
を使用することで、タスクごとに異なるデータ（タスク ID など）をメッセージに追加できます。
LiveCycle 管理コンソールを使用して、デフォルトの電子メールメッセージを作成できます。デフォルトのメッセージは、すべてのプロセスに共通で作成
されるタスクに適用されます。タスク割り当て操作は、LiveCycle Workbench を使用して、タスクのデフォルトメッセージを上書きするか、タスクの
通知を無効にすることによって設定できます。
テキストベースのあらゆるプロセスデータをメッセージに含めることができるよう、Workbench を使用して設定されるメッセージには、XPath 式を含
めることもできます。
電子メール通知を設定する方法
•
•
LiveCycle 管理コンソールを使用します （LiveCycle ES2.5 の管理ヘルプの「ユーザーおよびグループへの通知の設定」を参照）。
Workbench を使用します （LiveCycle Workbench 9.5 ヘルプを参照）。
完了したタスクに関する情報の保存
タスクの完了時に、そのタスクに関する情報を保存できます。タスク割り当て操作を設定することにより、次の情報をプロセス変数に保存します。
タスク ID： 作成されたタスクの固有の識別子
ユーザー ID： タスクを実行したユーザーの固有の識別子
その後、この情報をプロセス内で必要に応じて使用できます。例えば、ユーザー ID を保存しておき、そのプロセスの後続のタスクを同じユーザーに割り
当てることができます。
タスク情報を保存する方法
•
Workbench を使用します （LiveCycle Workbench 9.5 ヘルプを参照）。
タスクの操作
ここでは、作成済みの既存のタスクを操作する方法について説明します。Workbench、LiveCycle 管理コンソール および LiveCycle ES2.5 SDK には、
タスクを操作するためのツールが用意されています。
注意 : Workspace ES2.5 を使用したタスクの操作方法について詳しくは、LiveCycle Workbench 9.5 のヘルプを参照してください。
タスクイベントの処理
LiveCycle Process Management ES2.5 には、プロセスで使用するためのいくつかの非同期イベントタイプが用意されています。発生したイベントには、
プロセスにイベントの受信処理（スタートポイント）を追加することによって対応できます。
イベントには、20 種類を超えるイベントが存在します。イベントは、タスクの完了など、タスクの状態の変化に対して定義されているほか、タスクへの
ファイルの添付など、それ以外の変化に対して定義されている場合もあります。例えば、TaskDeadlined イベントタイプは、タスクのデッドラインが発
生した場合にスローされます。プロセスのスタートポイントとして TaskDeadlined イベントを使用することにより、このイベントがスローされたときに
プロセスを呼び出すことができます。
イベントの処理方法
•
Workbench を使用します （LiveCycle Workbench 9.5 ヘルプを参照）。
ADOBE LIVECYCLE ES2.5
User サービス
133
LiveCycle ES2.5 サービス
タスク情報の取得
特定のユーザーに割り当てられたタスクを取得した後で、そのタスクに関する情報（タスク ID、タスクのステータス、タスクが所属するプロセスの名前
など）を取得できます。タスクの履歴を取得することもできます。
タスク情報を取得する方法
•
•
LiveCycle 管理コンソールの Process Management ES2.5 ページを使用します （LiveCycle ES2.5 の管理ヘルプを参照）。
Task Manager Service API を使用します（『Programming with LiveCycle ES2.5』を参照）。
タスクステータスへの介入
予測できない状況によって生じた問題を解消するために、プロセスの通常の進行過程に介入できます。
•
•
必要に応じて、各ユーザーにタスクを割り当てます。例えば、社内での役割が変更されたユーザーに対し、タスクを再割り当てすることができます。
タスクが停止した場合に、その原因となった問題が解消された後で、タスクを再試行します。例えば、タスク割り当て操作で、タスクをユーザーに割
り当てる XPath 式に、構文エラーがあったとします。このエラーが原因ですべてのタスクが停止しました。このエラーが解消された時点で、タスク
を再試行できます。
•
不要になったタスクを終了します。
タスクステータスへの介入方法
•
•
LiveCycle 管理コンソールの Process Management ES2.5 ページを使用します （LiveCycle ES2.5 の管理ヘルプを参照）。
Task Manager Service API を使用します（『Programming with LiveCycle ES2.5』を参照）。
134
34. Variable Logger サービス
Variable Logger サービスを使用すると、プロセスでは変数値に関するメッセージをシステムログ、または LiveCycle ES2.5 サーバーのファイルシステ
ム上のログファイルに送信できます。プロセスが停止して予想どおりに機能しない場合は、正しく設定されていないプロセス変数が関連している可能性
があります。Variable Logger サービスを使用すると、プロセス変数を追跡し、失敗の原因となっている問題を隔離することができます。
Variable Logger サービスの使用
Variable Logger サービスを使用するプロセスを LiveCycle Workbench で開発することによって、このサービスを対話的に操作できます。プロセスで
このサービスを使用するときには、以下のオプションを指定できます。
•
•
•
プロセス変数に関するログメッセージをシステムリソースに出力するか、ファイルに保存するか。
システムロギングが行われるときに記録される情報の種類。
ログファイルのファイル名とパス、またはファイルにログを記録する場合のファイル名とパスを含むプロセス変数に対する XPath 式。ログファイル
の上書き（ログファイルが既に存在する場合）、新しいログファイルの作成、または既存のログファイルへの追加のいずれかを指定できます。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。
135
35. Wait Point サービス
Wait Point サービスを使用すると、1 つのプロセスの 1 ステップ分の進行を遅延させることができます。
Wait Point サービスの使用
Wait Point サービスを使用するプロセスを LiveCycle Workbench で開発することによって、このサービスを対話的に操作できます。プロセスでこの
サービスを使用してプロセスの次の操作の実行を遅延させる場合は、カレンダーの日付または業務カレンダーの日付を使用して待機時間を指定します。
カレンダーの日付： カレンダーの日付を使用する場合、待機する日数、時間数、分数および秒数の値を指定します。
業務カレンダーの日付： 業務カレンダーの日付を使用する場合、使用する業務カレンダーの名前および待機する稼働日数を指定します。業務カレンダー
は、組織の稼働日と非稼働日（法定休日、週末、会社定休日など）を定義します。業務カレンダーを使用している場合、LiveCycle ES2.5 では待機時間
の計算時に非稼働日がスキップされます。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。
136
36. Web Service サービス
Web Service サービスを使用すると、プロセスで Web サービスの操作を呼び出すことができます。例えば、サービスプロバイダの公開されている Web
サービスを呼び出して、担当者やアカウントの詳細などの情報を保存および取得するためにプロセスを統合することができます。Web Service サービス
は、指定された Web サービスを呼び出し、その各パラメータの値を渡します。次に、操作からの戻り値を、プロセス内の指定された変数内に保存します。
Web Service サービスは、SOAP メッセージを送受信して Web サービスとやり取りします。また、このサービスは WS-Attachment プロトコルを使用
した SOAP メッセージでの MIME、MTOM および SwaRef 添付ファイルの送信もサポートします。Web Service サービス操作は、SAP システムおよ
び .NET Web サービスと互換性があります。
Web Service サービスの使用
Web Service サービスを使用するプロセスを LiveCycle Workbench で開発することによって、このサービスを対話的に操作できます。このサービスを
使用して次のタスクを実行できます。
•
Web サービスの操作を呼び出すために Web サービスに送信する SOAP メッセージを作成します。Web サービス定義に URL を指定した後に、呼び
出す Web サービスの操作を選択できます。選択した操作に基づいて、SOAP 要求メッセージのテンプレートが生成されます。それから必要に応じて
メッセージに値を挿入します。Web Service サービスは、SAP Web サービスで必要とされる場合がある Table データ型をサポートしています。SAP
テーブルは、複数の列で構成されるデータベースと似ています。テーブル内の各行がレコードを表します。
•
•
テストメッセージを送信し、Web サービスから送信された応答メッセージを表示して、呼び出し要求をテストします。
Web サービスの操作を呼び出し、添付ファイルを含め、応答をプロセスデータとして保存します。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。
137
37. XMP Utilities サービス
PDF ドキュメントにはメタデータが含まれています。メタデータは、ドキュメントに関する情報です（テキストやグラフィックなどのドキュメントのコ
ンテンツとは区別されます）。Adobe Extensible Metadata Platform（XMP）は、ドキュメントのメタデータを処理するための標準です。
XMP Utilities サービスは、PDF ドキュメントから XMP メタデータを取得および保存し、XMP メタデータを PDF ドキュメントに読み込むことがで
きます。
XMP メタデータについて
XMP は、様々なアプリケーションのメタデータを作成、処理、交換するための標準形式を提供します。XMP は、メタデータを表すためのモデルを提供
します。XMP メタデータは、W3C 標準である Resource Description Language（RDF）を使用する XML 形式のテキストとしてエンコードされます。
XMP では、メタデータはドキュメントに関連付けられている 1 組のプロパティで構成されます。メタデータには、ドキュメントの作成者、タイトル、変
更日などのプロパティが含まれています。
プロパティはドキュメントのコンポーネントと関連付けられることがありますが、XMP Utilities サービスはコンポーネントメタデータを処理する機能
を備えていません。
プロパティには、名前と値があります。
•
•
名前は有効な XML 名であることが必要です。
値には、数値および文字列、または配列（コンテナとも呼ばれる）などの単純な値を指定できます。すべての値は実際には Unicode 文字列で表され
ます。
XMP について詳しくは、Adobe Web サイトのメイン XMP ページを参照してください。
PDF ドキュメントのメタデータについて
PDF ファイルでは、メタデータを次の 2 つの場所に保存できます。
•
ファイルトレーラディクショナリの Info ディクショナリ。このディクショナリには、タイトル、作成者、作成日などファイルに関する情報が格納さ
れます。この情報は、XML 形式ではなく文字列や日付などの PDF オブジェクトとして保存されます。
Acrobat および Adobe Reader ユーザーは、ドキュメントプロパティを使用してこのディクショナリ内の情報を表示できます。ユーザーは、タイト
ル、作成者、件名、キーワードなどの一部のプロパティを設定できます。また、一意の名前と値を持つカスタムプロパティを追加できます。
•
ドキュメントカタログ内の Metadata ディクショナリ。このディクショナリには、ドキュメント全体に関連付けられているメタデータが含まれていま
す。この情報は、XMP メタデータとして表されます。
注意 : ドキュメント内の個々のストリーム（画像など）には、関連付けられた XMP メタデータを含むメタデータエントリが含まれる場合もありま
す。ただし、XMP Utilities サービスにはそのようなコンポーネントレベルのメタデータを処理する機能がありません。
メタデータディクショナリ内では Info ディクショナリ内のすべてのメタデータが XMP メタデータプロパティのフォームでも表されます。タイトルや作
成者などの標準プロパティは、XMP では PDF スキーマのプロパティとして表されます。
XMP Utilities サービスは PDF からメタデータを読み込むときに、次のようにして Info ディクショナリの値と XMP メタデータの値の不一致を解決します。
•
•
•
Info ディクショナリの方が新しい場合、Info ディクショナリプロパティを使用して XMP メタデータを更新します。
Info メタデータの方が新しい場合、XMP プロパティを使用して Info ディクショナリを更新します。
『PDF Reference』の「Document Information Dictionary」に記載されていない Info ディクショナリのプロパティは、 pdfx 名前空間
（"http://ns.adobe.com/pdfx/1.3/"）にマップされます。このマッピングは、最初の 2 つの項目で説明した状況においてリポジトリ間でプロパティを
コピーする場合に使用します。
ADOBE LIVECYCLE ES2.5
XMP Utilities サービス
138
LiveCycle ES2.5 サービス
PDF ドキュメントが保存されるときに、xmp:ModifyDate、xmp:MetadataDate、xapMM:InstanceID、および（これらが存在しない場合は）
xapMM:DocumentID などの一部のメタデータプロパティが自動的に更新されます。これらのプロパティを変更すると、指定した値がすべて上書きされ
ます。
XMP Utilities サービスの使用
このサービスを使用して次のタスクを実行できます。
メタデータの書き出し： 指定された
PDF ドキュメントからメタデータを書き出し、プロセスデータとして保存できます。指定した PDF ドキュメントは、
プロセスデータとして保存できるほか、ファイルシステムからファイルとして直接指定することもできます。
メタデータの読み込み： プロセスデータからメタデータを読み込み、指定された
PDF ドキュメント内の既存のメタデータと置き換えます。
XMP の書き出し： LiveCycle Workbench でのみ実行できます。指定された PDF ドキュメントからメタデータを XMP データとして書き出します。メタ
データは、PDF ドキュメントとしてプロセスデータに保存できるほか、再利用できるファイルとして保存することもできます。
XMP の読み込み： Workbench でのみ実行できます。ドキュメントの値からメタデータを読み込み、指定された PDF ドキュメント内の既存のメタデータ
と置き換えます。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 のヘルプを参照してください。プログラムによってこのサービス
とやり取りできるクライアントアプリケーションの作成について詳しくは、『Programming with LiveCycle ES2.5』を参照してください。
139
38. \XSLT Transformation サービス
XSLT Transformation サービスを使用すると、プロセスで XSLT（Extensible Stylesheet Language Transformations）を XML ドキュメントに適用
できます。
XSLT Transformation サービスの使用
XSLT Transformation サービスを使用するプロセスを LiveCycle Workbench で開発することによって、このサービスを対話的に操作できます。この
サービスを使用して次のタスクを実行できます。
•
XSLT 変換の実行に使用するデフォルトの Java クラスでサービスを設定します。サービスの操作プロパティで、サービス設定で指定した値を上書き
できます。
•
プロセスデータとして保存される XSLT スクリプトを使用して XML ドキュメントを変換します。XML ドキュメントもプロセスデータとして保存さ
•
URL を使用して参照される XSLT スクリプトを使用して XML ドキュメントを変換します。変換された XML ドキュメントは、プロセスデータとし
れます。
て保存されます。
•
•
変換をテストし、結果を確認します。
結果の XML ドキュメントをプロセスデータとして保存します。
このサービスを使用するプロセスの作成について詳しくは、LiveCycle Workbench 9.5 ヘルプを参照してください。
LiveCycle 管理コンソールのアプリケーションおよびサービスのページを使用して、このサービスのデフォルトプロパティを設定できます（LiveCycle
ES2.5 の管理ヘルプの「XSLT Transformation サービスの設定」を参照）。