Comments
Description
Transcript
Composer - EMC Japan
EMC® Documentum® Composer バ ー ジ ョ ン 7.2 ユーザ ガイド EMC Corporation 本社: Hopkinton, MA 01748-9103 1-508-435-1000 www.EMC.com 法的通知 Copyright ©1994-2015 EMC Corporation. All rights reserved. EMC Corporation は、この資料に記載される情報が、発行日時点で正確であるとみなしています。この情報は予告なく変更さ れることがあります。 この資料に記載される情報は、「現状有姿」の条件で提供されています。EMC Corporation は、この資料に記載される情報に 関する、どのような内容についても表明保証条項を設けず、特に、商品性や特定の目的に対する適応性に対する黙示の保証 はいたしません。 この資料に記載される、いかなる EMC ソフトウェアの使用、複製、頒布も、当該ソフトウェア・ライセンスが必要です。 EMC の製品名の最新の一覧については、EMC.com の EMC Corporation の商標をご覧ください。Adobe および Adobe PDF Library は、米国またはその他の国における Adobe Systems Inc. の商標または登録商標です。他のすべての名称ならびに製 品についての商標は、それぞれの所有者の商標または登録商標です。 ドキュメントに関するフィードバック 皆様のご意見は大変貴重です。是非、製品のドキュメントに関するご意見をお聞かせください。ドキュメントを改良したり、使い やすくするためのご意見がありましたら、[email protected] まで直接お送りください。 目次 第1章 Documentum Composer .................................................................................... 11 Composer の概要............................................................................................... 11 headless Composer と Composer UI .................................................................... 11 Composer のインストール .................................................................................... 12 軽量システム オブジェクト プラグインをインストールする ..................................... 13 その他の Composer プラグインのインストール ....................................................... 13 Workflow Manager の起動 ............................................................................... 13 headless Composer のインストール ........................................................................ 14 Composer での UNIX および Linux のサポート ...................................................... 14 コネクション ブローカの設定 ............................................................................... 14 Composer の起動と設定 ..................................................................................... 15 Java JRE とコンパイラの設定 ............................................................................... 15 言語パックのインストール ................................................................................... 16 Composer 言語パックのインストール ................................................................. 17 第2章 プ ロ ジ ェ ク ト の 管 理 ............................................................................................ 19 Composer プロジェクト ........................................................................................ 19 プロジェクトの作成 ......................................................................................... 19 プロジェクトのインポート.................................................................................. 21 Composer の参照プロジェクト .............................................................................. 22 Documentum が提供する参照プロジェクト ......................................................... 22 プロジェクトの参照プロジェクトとしての指定 ...................................................... 23 新しい Composer プロジェクトに対する参照プロジェクトの指定......................... 23 既存の Composer プロジェクトに対する参照プロジェクトの指定 ........................ 24 Composer アーティファクト................................................................................... 25 アーティファクトの作成 ................................................................................... 27 アーティファクトのインポート ............................................................................ 28 プロジェクト プロパティの設定 ............................................................................. 30 Composer プロジェクトのローカライズ ................................................................... 31 トレースの有効化 .............................................................................................. 37 第3章 DocApp お よ び DocApp ア ー カ イ ブ の Composer プ ロ ジ ェ ク ト へ の 変 換 .................. 39 DocApp と DocApp アーカイブについて ............................................................... 39 DocApp の Composer プロジェクトへの変換 .......................................................... 40 DocApp アーカイブの Composer プロジェクトへの変換 ........................................... 42 DocApp アーカイブを変換するための準備........................................................ 42 DocApp アーカイブの変換 .............................................................................. 43 変換後のタスク ................................................................................................. 44 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 3 目次 第4章 Composer と xCelerated Composition Platform .................................................... 45 Composer と xCelerated Composition Platform について........................................... 45 TaskSpace アプリケーションまたは xCP アーティファクトのパッケージ化およびイン ストールのヒントと注意事項................................................................................. 46 Composer プロジェクトと DAR ファイル.................................................................. 47 TaskSpace アプリケーションのパッケージ化 ........................................................... 48 Composer での TaskSpace アプリケーションのパッケージ化.................................. 48 headless Composer での TaskSpace アプリケーションのパッケージ化...................... 49 xCP アーティファクトのパッケージ化 .................................................................... 50 Composer での xCP アーティファクトのパッケージ化 ........................................... 51 headless Composer での xCP アーティファクトのパッケージ化 ............................... 51 TaskSpace アプリケーションと xCP アーティファクトのインストール ............................ 53 Composer での TaskSpace アプリケーションと xCP アーティファクトのインストー ル................................................................................................................. 53 DAR インストーラでの TaskSpace アプリケーションと xCP アーティファクトのイン ストール ........................................................................................................ 53 headless Composer での TaskSpace アプリケーションと xCP アーティファクトのイン ストール ........................................................................................................ 54 headless Composer を使用した、xCP アーティファクトをすでに含む Composer プロ ジェクトのビルドとインストール ............................................................................. 55 ソース環境からターゲット環境への TaskSpace アプリケーションまたは xCP アー ティファクトの移行 ............................................................................................. 57 ソース環境上での TaskSpace アプリケーションまたは xCP アーティファクトのパッ ケージ化 ....................................................................................................... 57 ターゲット リポジトリ上での TaskSpace アプリケーションまたは xCP アーティファク トのデプロイ .................................................................................................. 58 トラブルシューティングのヒント ......................................................................... 58 第5章 Web Services の 管 理 ......................................................................................... 61 Web サービス .................................................................................................... 61 DFS モジュール オプションの設定 ....................................................................... 62 DFS サービス ライブラリを設定するには ............................................................... 62 サービス カタログの設定 .................................................................................... 63 Web サービスの表示 .......................................................................................... 65 サービスのフィルタ......................................................................................... 66 クライアント プロキシの生成 ................................................................................ 67 サービスの作成 ................................................................................................ 69 Java ファイルからのサービスの作成.................................................................. 69 WSDL からのサービスの作成 .......................................................................... 70 カタログおよびカテゴリに関する情報の変更 ......................................................... 71 サービスの発行 ................................................................................................ 72 サービスの発行停止.......................................................................................... 73 サービスのエクスポート ...................................................................................... 73 サービスのデプロイ ........................................................................................... 75 第6章 エ イ リ ア ス セ ッ ト の 管 理 ...................................................................................... 77 エイリアス、エイリアス値、およびエイリアス セット ................................................... 77 4 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 目次 エイリアス セットの作成 ...................................................................................... 77 第7章 ア ス ペ ク ト の 管 理 ............................................................................................... 81 アスペクト モジュールおよびアスペクト タイプ ....................................................... 81 アスペクト タイプの作成...................................................................................... 81 制約式の設定 ............................................................................................... 83 アスペクト属性の追加 ........................................................................................ 84 アスペクト UI 情報の設定 .................................................................................. 87 タブの追加.................................................................................................... 89 アスペクト モジュールの作成 .............................................................................. 90 アスペクト モジュールのデプロイの設定 ........................................................... 92 アスペクト モジュールの実行時環境の設定 ...................................................... 94 アスペクト タイプの設定 .................................................................................. 95 第8章 フ ォ ー マ ッ ト の 管 理 ............................................................................................ 99 フォーマット ...................................................................................................... 99 フォーマット アーティファクトの作成 ..................................................................... 99 第9章 JAR お よ び Java ラ イ ブ ラ リ の 管 理 .................................................................... 103 JAR 定義、JAR、および Java ライブラリ .............................................................. 103 JAR 定義の作成 ............................................................................................. 103 Java ライブラリのリンクと設定 ............................................................................. 105 第 10 章 ラ イ フ サ イ ク ル の 管 理 ....................................................................................... 107 ライフサイクル ................................................................................................. 107 ライフサイクルのオブジェクト タイプ ................................................................ 107 ライフサイクルの作成 ....................................................................................... 108 ライフサイクルのプロパティの設定..................................................................... 109 ライフサイクル状態の追加と設定........................................................................111 状態タイプの作成 .........................................................................................113 状態エントリの基準の設定 ................................................................................114 状態のアクションの設定 ....................................................................................115 繰り返し属性値の追加...................................................................................115 繰り返し属性値の削除...................................................................................116 属性の設定 ..................................................................................................117 バージョン ラベルの追加 ...............................................................................118 バージョン ラベルの削除 ...............................................................................119 ロケーション リンクの設定 ...............................................................................119 すべてのリンクの移動................................................................................... 120 ロケーション リンクの削除 .............................................................................. 122 ドキュメント レンダラーの割り当て ................................................................... 123 ドキュメント所有者の割り当て ........................................................................ 123 アクセス権セットの設定................................................................................. 124 変更後の情報の設定....................................................................................... 125 状態属性の設定 ............................................................................................. 125 ライフサイクル状態の削除 ................................................................................ 127 ライフサイクルの削除 ....................................................................................... 127 第 11 章 メ ソ ッ ド と ジ ョ ブ の 管 理 ...................................................................................... 129 メソッドとジョブ ................................................................................................ 129 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 5 目次 メソッドの作成 ................................................................................................. 129 ジョブの作成................................................................................................... 131 第 12 章 モ ジ ュ ー ル の 管 理 ........................................................................................... 135 モジュール ..................................................................................................... 135 モジュールの作成 ........................................................................................... 135 モジュールのデプロイの設定............................................................................ 138 モジュールの実行時環境の設定....................................................................... 139 第 13 章 アク セ ス 権 セ ッ ト ) を 管 理 す る ................................................................... 143 ACL (ア アクセス権、アクセス権セット、アクセス権セット テンプレート ................................. 143 基本アクセス権 ............................................................................................ 144 拡張アクセス権 ............................................................................................ 144 アクセス権セット テンプレートの作成 ................................................................. 145 標準またはパブリックのアクセス権セットの作成................................................... 148 ACL エントリ所有者の作成 ........................................................................... 150 第 14 章 プ ロ シ ー ジ ャ の 管 理 ........................................................................................ 153 プロシージャ ................................................................................................... 153 プロシージャの作成......................................................................................... 153 第 15 章 関 係 タ イ プ の 管 理 ........................................................................................... 155 関係タイプ...................................................................................................... 155 関係タイプの作成 ........................................................................................... 155 第 16 章 ス マ ー ト コ ン テ ナ の 管 理 .................................................................................. 159 スマート コンテナ............................................................................................. 159 スマート コンテナの構築 .................................................................................. 159 スマート コンテナ要素の追加............................................................................ フォルダの追加 ........................................................................................... 新規フォルダの追加 .................................................................................... ドキュメントの追加 ....................................................................................... 新規ドキュメントの追加 ................................................................................. テンプレートの追加 ..................................................................................... プレースホルダの追加.................................................................................. 161 161 161 162 163 164 164 スマート コンテナの関係の追加 ........................................................................ 165 第 17 章 シ ス テ ム オ ブ ジ ェ ク ト の 管 理 ............................................................................. 167 システム オブジェクト ....................................................................................... 167 システム オブジェクトの作成 ............................................................................. 167 システム オブジェクトの属性の表示と変更.......................................................... 169 第 18 章 タ イ プ の 管 理 .................................................................................................. 171 オブジェクト タイプ........................................................................................... 171 標準オブジェクト タイプの作成.......................................................................... 172 アスペクトの添付.......................................................................................... 175 軽量オブジェクト タイプの作成.......................................................................... 176 タイプの制約式の設定..................................................................................... 179 イベントの追加、削除、または変更 .................................................................... 180 6 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 目次 タイプ属性の追加 ........................................................................................... 181 条件付き属性値の設定 ................................................................................ 186 属性値のマッピングの設定 ........................................................................... 187 タイプ UI 情報の設定 ...................................................................................... 188 タブの追加 ..................................................................................................... 190 第 19 章 XML ア プ リ ケ ー シ ョ ン の 管 理 ........................................................................... 193 XML アプリケーションとアプリケーション設定ファイルについて............................. 193 XML Application アーティファクトの作成 ............................................................ 193 XML アプリケーション設定ファイルの表示または変更 ......................................... 195 第 20 章 プ ロ ジ ェ ク ト の ビ ル ド お よ び イ ン ス ト ー ル ............................................................. 199 ビルドおよびインストールのプロセスについて ..................................................... 199 プロジェクト インストール オプションの設定 ......................................................... 200 所有者インストール パラメータの追加............................................................. 201 インストール前プロシージャとインストール後プロシージャの設定 .......................... 202 アーティファクト インストール オプションの設定 ................................................... 203 DAR ファイルの生成........................................................................................ 205 プロジェクトのインストール ................................................................................ 206 インストール パラメータの作成 .......................................................................... 208 インストール パラメータ ファイルの作成 .............................................................. 210 DAR インストーラでの DAR ファイルのインストール ..............................................211 第 21 章 Ant タ ス ク と headless Composer を 使 用 し た プ ロ ジ ェ ク ト お よ び DAR フ ァ イ ル を 管 理 す る ............................................................................................................ 213 headless Composer ビルドの作成........................................................................ 213 Composer プロジェクトのビルド、変更、インストールを行う Ant スクリプトの作 成 .............................................................................................................. 213 ビルドを設定および実行するバッチ ファイルの作成 ......................................... 215 emc.importProject ............................................................................................ 216 emc.createArtifactProject ................................................................................... 216 emc.createTaskspaceApplicationProject ................................................................ 217 emc.importArtifacts .......................................................................................... 218 emc.importContent ........................................................................................... 219 emc.build ........................................................................................................ 220 emc.dar........................................................................................................... 220 emc.install....................................................................................................... 221 emc.setUpgradeOption ...................................................................................... 222 UNIX および Linux システムでの headless Composer を使用した DAR ファイルのイ ンストール....................................................................................................... 222 第 22 章 ソ ー ス 管 理 シ ス テ ム の 操 作 ............................................................................... 225 ソース管理システムの使用 ............................................................................... 225 プロジェクトのチェックイン ............................................................................. 225 プロジェクトのチェックアウトとインポート ......................................................... 225 プロジェクトのビルド......................................................................................... 227 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 7 目次 第 23 章 Composer に 関 す る よ く あ る 質 問 ....................................................................... 229 全般的な質問 ................................................................................................. 229 DAR ファイル .................................................................................................. 230 ライフサイクルとワークフロー............................................................................. 231 Composer と DAB/DAI...................................................................................... 232 8 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 本書について このガイドでは、Documentum Composer を使用してエンタープライズ アプリケーションを開発 し、Documentum Content Server に配置する方法について説明します。 対象読者 このガイドは、Documentum Content Server 用のアプリケーションを開発するユーザを対象とし ています。このガイドでは、ユーザが Documentum プラットフォームおよびコンテンツ管理に ついて基本的な知識を持っていることを前提としています。 表記規則 次の表に、このガイドで使用している表記規則を示します。 書体 テキストの種類 標準 本文中: • インターフェイス要素 (ボタン名、ダイアログ ボックス) • Java クラス、インターフェイス名 • リソース名、属性、プール、ブール式、ボタン、DQL ステートメント、 キーワードおよび句、環境変数、関数、メニュー、ユーティリティ • パス名、URL、ファイル名、ディレクトリ名、コンピュータ名、リンク、 グループ、サービス キー、ファイル システム、環境変数 (コマン ド ラインおよびテキスト)、通知 標準、二重引用符 章名および項名 太字 手順内: • ユーザ アクション (ユーザがクリック、押下、選択、または入力す るもの) • インターフェイス要素 (ボタン名、ダイアログ ボックス、ページ名) • キー名 本文中: • コマンド名、デーモン、オプション、プログラム、プロセス、通知、シス テム コール、man ページ、サービス、アプリケーション、ユーティリ ティ、カーネル イタリック • マニュアル名、強調用 (用語集の用語、索引で参照先を示す場 合など) • テキスト内の変数 (コマンド例以外) クーリエ プロシージャ (独立した行で使用されている場合)、プロンプト、システ ム出力、ファイル名、パス名、URL、構文例などの表記内。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 9 本書について 書体 テキストの種類 太字のクーリエ (独立した行で使用されている場合) ユーザが入力する内容。 イタリックのクーリエ 手順内: • コマンド文字列の変数 • ユーザが入力する変数 Composer の ユ ー ザ イ ン タ ー フ ェ イ ス に つ い て Composer のユーザ インターフェイスには、さまざまなダイアログ ボックスや画面に移動するため の方法がいくつか用意されています。たとえば、Composer では次のいずれかの方法で、[新し いエイリアス セット] ダイアログにアクセスしてエイリアス セット アーティファクトを作成できます。 • Documentum Navigator 領域で右クリックし、[新規作成] > [エイリアス セット] を選択する。 • Composer メニューで、[ファイル] > [新規作成] > [エイリアス セット] を選択する。 • プロジェクトで、[Artifacts] フォルダを右クリックし、[新規作成] > [エイリアス セット] を選択する。 • プロジェクトで、[Artifacts] フォルダを展開し、[エイリアス セット] を右クリックし、[新規作成] > [エイリアス セット] を選択する。 • ツールバーで、[新しい Documentum アーティファクトの作成] アイコンの横にある下向きの矢 印ボタンをクリックし、リストから [エイリアス セット] を選択する。 • Composer メニューで、[ファイル] > [新規作成] > [その他] を選択し、[Documentum アーティ ファクト] フォルダを展開し、[エイリアス セット] を選択し、[次へ] をクリックする。 『Documentum Composer User Guide (Documentum Composer ユーザ ガイド)』内のさまざまな 手順では、一般にダイアログ ボックスや画面への 1 つの移動方法しか示されていません。こ れは意図的なものです。 サポート情報 Documentum のテクニカル サポート サービスは、Documentum 製品のデプロイや管理を効率よ く行えるようにすることを目的としています。Documentum のサポート サービスやポリシーの詳細 な説明は、『Customer Guide to EMC Software Support Services (EMC Software サポート サービ スのカスタマー ガイド)』を参照してください。このドキュメントは EMC オンライン サポート Web サイト (https://support.emc.com) からダウンロードできます。 改訂履歴 本書の改訂履歴は次のとおりです。 改訂日付 説明 2015 年 2 月 初版発行 10 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 1 章 Documentum Composer この章では、次について説明します。 • Composer の 概 要 • Composer の イ ン ス ト ー ル • そ の 他 の Composer プ ラ グ イ ン の イ ン ス ト ー ル • headless Composer の イ ン ス ト ー ル • Composer で の UNIX お よ び Linux の サ ポ ー ト • コネクション ブローカの設定 • Composer の 起 動 と 設 定 • Java JRE と コ ン パ イ ラ の 設 定 • 言語パックのインストール Composer の 概 要 Documentum Composer には、Documentum Content Server 用のアプリケーションを作成およびカス タマイズするためのツールが用意されています。これらのアプリケーションでは、Content Server に よる各種コンテンツの処理方法を指定します。 Composer は、Eclipse ベースの製品であり、Eclipse プラットフォームで作成されたスタンドアロンの プログラムです。スタンドアロンのプログラムである Composer には、必要なコードやプラグインがす べて含まれています。Composer は zip 圧縮ファイルの形式で提供されます。このファイルは、 ローカルの開発用マシン上にあるディレクトリに展開されます。 headless Composer と Composer UI Composer には、Composer と headless Composer の 2 つのバージョンがあります。Composer は、 Composer プロジェクトの作成、ビルド、およびインストールするためのユーザ インターフェイスを提 供する一式の統合開発環境 (IDE) です。headless Composer は、Ant タスクを使用して Composer プロジェクトを作成、ビルド、インストールするためのコマンドライン型ビルド ツールです。Ant タスク を使用すると、Documentum プロジェクトのビルドと DAR ファイルのインストールを標準 Ant ビルド スクリプトに統合できます。Ant タスクでは Composer および Eclipse インフラストラクチャが活用さ れるため、これらのタスクを使用するビルド スクリプトは Eclipse AntRunner を使用して実行する 必要があります。Ant の詳細については、http://ant.apache.org を参照してください。Composer の 2 つのパッケージについて、次の表に相違点を示します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 11 Documentum Composer 特徴または機能 UI ベ ー ス Composer headless Composer 新しいプロジェクトを作成する はい はい 新しいアーティファクトを作成する はい いいえ リポジトリから DocApp をインポー トする はい いいえ DocApp アーカイブをインポート する はい いいえ ローカル ディレクトリからプロジェ クトをインポートする はい はい リポジトリからアーティファクトを インポートする はい はい プロジェクトをビルドする はい はい プロジェクトをインストールする はい はい DAR ファイルをインストールする いいえ はい emc.install Ant タスクを使用し、 Composer UI では、プロジェクト DAR ファイルをインストールしま をインストールできます (「背後 す。 で」DAR ファイルが自動的に生 成され、インストールされます)。 ただし、Composer UI には別個の [DAR ファイルのインストール] オ プションはありません。DAR イン ストーラを使用し、DAR ファイルを 対話形式でインストールします。 Composer の イ ン ス ト ー ル Documentum Composer は、Eclipse プラットフォームとすべての必須プラグインを含む圧縮 zip ファ イルとしてパッケージ化されています。Documentum Composer をインストールするには、任意の ディレクトリにこの zip ファイルを解凍します。 Composer のインストール前に、次の必要条件を満たしていることを確認してください。 • Documentum 5.3 SP6 以降のリポジトリ • Java JDK のサポートされているバージョン 『EMC Documentum 7.2 Environment and System Requirements Guide (EMC Documentum 7.1 環境および動作環境ガイド)』には、Composer に現在必要な Java JDK バージョン アップ デートが記載されています。 Composer を イ ン ス ト ー ル す る に は 1. DCTM_Composer_<version>.zip ファイルをローカル マシン上のディレクトリに展開します。シ ステムによって、Composer という名前のディレクトリが作成されます。 2. ご使用のローカル マシンで、JAVA_HOME 環境変数を、Java JDK のインストールを指し示す ように設定します。たとえば、Java JDK が C:\Program Files\Java\jdk_directory にインストールさ れている場合は、JAVA_HOME 変数にそのパスを設定します。 12 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Documentum Composer 3. <composer_root>\plugins\com.emc.ide.external.dfc_1.0.0\documentum.config\dfc.properties ファイルを編集し、 dfc.docbroker.host[0]=[リポジトリ IP アドレスまたはホスト名] のような接続ブローカ情報を追加します。 軽量システム オブジェクトを使用するには、軽量システム オブジェクト プラグインをインストールし ます (軽量システム オブジェクト プラグインをインストールする (13ページ) を参照)。 軽量システム オブジェクト プラグインをインストールする また、EMC Documentum は Composer に軽量システム オブジェクト プラグインを提供しま す。これは別途インストールする必要があります。軽量システム オブジェクト プラグインは、 Composer の主なディストリビューションには含まれないため、Composer をインストールした後に、 <Composer_root>/plugins ディレクトリにインストールする必要があります。 現在、軽量オブジェクトを適切に使用できるのは、Documentum High-Volume Server 用に設計され たアプリケーションだけです。Documentum High-Volume Server は、電子メールのアーカイブな ど、大きいコンテンツ ストアの一般的な問題を解決するために実装された機能をサポートする、 Documentum Content Server の拡張です。Content Server をインストールする時に指定する追加ラ イセンス キーが必要です。軽量オブジェクト タイプおよび Documentum High-Volume Server の詳 細については、Documentum High-Volume Server Developer Guide を参照してください。 軽量システム オブジェクト プラグインをインストールするには 1. LightweightObject_<バージョン>.zip file を EMC オンライン サポート サイト (https://support.emc.com) からダウンロードします。 2. プラグインを Composer と同じディレクトリに展開します。たとえば、Composer を C:\ ディレクトリ に展開した場合は、LightweightObject_<version>.zip ファイルを C:\ ディレクトリに展開します。 3. <Composer_root>/plugins ディレクトリに移動して、このディレクトリに次のファイルが存在する ことを確認します。 • com.emc.ide.artifact.lwdclass_1.0.0.jar • com.emc.ide.artifact.lwdclass_ui_1.0.0.jar そ の 他 の Composer プ ラ グ イ ン の イ ン ス ト ー ル 追加機能を提供する Composer プラグインで、Composer の主な配布物に含まれていないもの は、Composer をインストールした後、../Composer/plugins ディレクトリにインストールする必 要があります。 プラグインのパッケージ方法によっては、ローカル マシン上にある Composer のメイン ディレクトリ にパッケージを展開するか、あるいはパッケージを一時ディレクトリに展開し、プラグイン ファイル を ../Composer/plugins ディレクトリにコピーします。 Workflow Manager の 起 動 Workflow Manager は、Composer にバンドルされているだけで、統合されていません。Composer のインストール時に、Workflow Manager がローカル マシンの../Composer/WorkflowManager ディレクトリに展開されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 13 Documentum Composer Workflow Manager を 起 動 す る に は 1. 使用しているコンピュータで ../Composer/WorkflowManager ディレクトリに移動します。 2. launch_wfm.bat をダブルクリックします。 Workflow Manager のエディタおよびログイン ダイアログ ボックスが表示されます。Workflow Manager の詳細については、『Workflow Manager User Guide (Workflow Manager ユーザ ガイ ド)』を参照してください。 headless Composer の イ ン ス ト ー ル headless Composer は、UI ベースの Composer パッケージとは異なる .zip ファイルで配布されます。 headless Composer を イ ン ス ト ー ル す る に は 1. headless Composer の .ｚip ファイルを、ローカル マシン上のディレクトリに展開します。スペース が含まれるディレクトリ名は選択できません。headless Composer の zip ファイルの形式は、 DCTM_Headless_Composer_<platform>_<version>.zip です。 2. <Composer_root>/plugins/com.emc.ide.external.dfc_1.0.0/documentum.config/dfc.properties ファ イルを編集して、接続ブローカ情報を追加します。例: dfc.docbroker.host[0]=[リポジト リ IP アドレスまたはホスト名] アクセスするリポジトリすべてに有効なユーザ名とパスワードを持っている必要があります。そ れによりコネクション ブローカはこれらのリポジトリを認識します。 headless Composer の使用方法については、headless Composer ビルドの作成 (213ページ) を参照 してください。 Composer で の UNIX お よ び Linux の サ ポ ー ト UNIX および Linux システムで headless Composer を使用して、UNIX、Linux、および Windows シ ステムの Content Server リポジトリに DAR ファイルをインストールできます。UNIX および Linux 環境でサポートされているのは、Content Server にバンドルされている headless Composer の ディストリビューションのみです。 別の方法として、Windows システムで DAR インストーラまたは headless Composer を使用して、 UNIX および Linux システムの Content Server リポジトリに DAR ファイルをインストールできます。 headless Composer で Ant タスクを実行する方法については、UNIX および Linux システムでの headless Composer を使用した DAR ファイルのインストール (222ページ) を参照してください。 コネクション ブローカの設定 プロジェクトまたはアーティファクトをインポートするたびに、Documentum リポジトリにアクセス します。Documentum コネクション ブローカがリポジトリ アクセスを行います。コネクション ブ ローカはいつでも更新できます。 コネクション ブローカを設定するには 14 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Documentum Composer 1. <Composer_root>\plugins\com.emc.ide.external.dfc_1.0.0\documentum.config\dfc.properties ファ イルを編集し、 dfc.docbroker.host[0]=[リポジトリ DocBroker IP アドレスまたはホス ト名] のような接続ブローカ情報を追加します。 2. 変更を保存します。 Composer の 起 動 と 設 定 Composer は、Eclipse プラットフォーム上で動作し、同様の開発概念を使用します。Composer を実行するためには、1 つ以上のワークスペースを設定します。ワークスペースは、Composer での作業が保存されるディレクトリです。Composer を使用する前に、ワークスペースのロケー ションを指定します。 注 記 : 新しいバージョンの Composer は、古いバージョンの Composer で作成されたワークスペー スを使用できません。まずワークスペースを作成し、その後古いワークスペースから新しいワークス ペースにプロジェクトをインポートしてください。 Composer を 起 動 し 、 ワ ー ク ス ペ ー ス を 設 定 す る に は 1. Composer .zip ファイルを展開したマシンで ..\Composer インストール ディレクトリに移動 し、composer.exe をダブルクリックします。 Eclipse を初めて起動するときは、ワークスペースのロケーションを選択する [ワークスペース ラ ンチャー] ダイアログ ボックスが表示されます。 ワークスペースには、Composer のプロジェクトのソース ファイルと依存関係がすべて保存されま す。Composer では、複数のワークスペースを使用することができます (たとえば異なるプロジェ クトがある場合)。ただし、個々のプロジェクトは、1 つのワークスペースにのみ保存できます。 2. ワークスペースの場所をデフォルトのまま受け入れるか、または [ワークスペース] フィールドに 新しい場所を入力してから、[OK] をクリックします。 Composer ワークベンチが表示されます。 Java JRE と コ ン パ イ ラ の 設 定 Composer に設定されたインストール済み JRE (Java Runtime Environment) は、Composer を実行 しているローカル マシン上の環境変数に設定された JDK (Java Development Environent) に対 応している必要があります。JRE が対応していない場合、リポジトリに Composer プロジェクトが 正しくインストールされないことがあります。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 15 Documentum Composer 注 記 : Composer をインストールする前に、サポートされている Oracle JDK をインストールする 必要があります。以前のバージョンがローカルマシンにインストールされている場合は、Java を アップグレードしてから先に進んでください。『EMC Documentum 7.2 Environment and System Requirements Guide (EMC Documentum 7.1 環境と動作環境ガイド)』には、動作環境に関する 情報が記載されています。 Java JRE と コ ン パ イ ラ を 設 定 す る に は 1. コマンド プロンプト ウィンドウで、「SET JAVA_HOME」と入力し、JAVA_HOME 環境変数に設 定されているパスを確認します。JAVA_HOME は、サポートされているバージョンの JDK を指 し示している必要があります。JDK ディレクトリには、Composer で実行時に使用されるよう指 定する JRE ディレクトリも含まれています。 2. Composer のメイン メニューで、[ウィンドウ] > [設定] に移動します。 [設定] ダイアログ ボックスが表示されます。 3. [Java] オプションをクリックして展開し、[インストールされている JRE] をクリックします。 [インストールされている JRE] ページが表示されます。 4. デフォルトのインストール済み JRE が、JDK にバンドルされているものではない場合、[追 加] をクリックして別の JRE を追加します。 [JRE の追加] ダイアログボックスが表示されます。 5. [参照] をクリックして、サポートされている JDK にバンドルされている JRE ディレクトリ (C:\Program Files\Java\jdk_directory\jre など) を選択します。 6. [OK] をクリックし、新しい JRE が [インストールされている JRE] ページに表示され、選択され ていることを確認します。 7. 左側のツリーから [Java] > [Compiler (コンパイラ)] を選択し、[コンパイラ準拠レベル]をサポー トされている Java バージョンに設定します。 8. [OK] をクリックして変更を保存します。 言語パックのインストール このセクションでは、Composer 言語パックをインストールしてローカライズを有効にする方法につ いて説明します。次のアイテムを指定された順番にインストールする必要があります: • 英語版の Composer • 軽量システム オブジェクト プラグイン (省略可能) • Composer <language name> 言語パック • Eclipse <language name> 言語パック ソフトウェアをインストールまたはアップグレードする前に、ご使用のシステムが『EMC Documentum 7.2 Environment and System Requirements Guide (EMC Documentum 7.1 環境および動作環境 ガイド)』に記載されている要件を満たしていることを確認してください。『EMC Documentum 7.2 Environment and System Requirements Guide (EMC Documentum 7.1 環境および動作環境 ガイド)』および製品のドキュメントは、EMC オンライン サポート (https://support.emc.com) に 用意されています。 Composer 言語パックをインストールする手順については、Composer 言語パックのインストール (17ページ) を参照してください。 16 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Documentum Composer Composer 言 語 パ ッ ク の イ ン ス ト ー ル このセクションでは、Composer と関連する言語パックをインストールする方法について説明しま す。言語パックは、デフォルトの言語である英語以外の言語にローカライズ (翻訳) されたグラフィ カル ユーザ インターフェイスおよびオンライン ヘルプを含むプラグインで構成される、言語固有 のファイルをインストールします。現在、Composer は日本語でのみ利用可能です。 言語パックをインストールするには 1. ダウンロード サイトから 英語版 Composer の .zip ファイルをダウンロードします。 2. 英語版 Composer の .zip ファイルをローカル ドライブのディレクトリに解凍します。これによ り「Composer」という名前のディレクトリが作成されます。これは、以降、<Composer_root> と表記します。 3. 軽量システム オブジェクト プラグインをインストールしている場合は、プラグインを Composer 親ディレクトリに解凍します。たとえば、Composer が <Composer_parent_directory>\Composer ディレクトリにインストールされている場合は、ファイルを <Composer_parent_directory> に解 凍します。Eclipse <language name> 言語パックをインストールする前に、このプラグインをイ ンストールする必要があります。 4. Composer <language name> 言語パックを、<Composer_root>\plugins ディレクトリに解凍しま す。Eclipse <language name> 言語パックをインストールする前に、Composer <language name> 言語パックをインストールする必要があります。 5. <Composer_root>\plugins\Documentum ディレクトリを C:\Program Files ディレクトリにコピーし ます。 6. <Composer_root>\composer.exe を実行して Composer を起動します。 7. [ヘルプ] > [新規ソフトウェアのインストール] メニュー項目をクリックし、Eclipse <language name> 言語パックをインストールします。 注記: 更新では、インターネットに接続して Eclipse <language name> 言語パックをダウンロード する必要があります。Composer がインターネットにアクセスできることを確認するには、ファイ アウォールとプロキシの設定を構成します (該当する場合) 8. [追加...] ボタンをクリックします。 [Add site (サイトの追加)] ウィンドウが表示されます。 9. [ ロ ケ ー シ ョ ン ] フ ィ ー ル ド に http://download.eclipse.org/technology/babel/update-site/R0.11.0/indigo を入力し、 [OK] をクリックします。 10. http://download.eclipse.org/technology/babel/update-site/R0.11.0/indigo ノードを選択して折り たたみます。子ノードが [Pending... (保留中...)] となっている場合は、言語パックが表示される まで数分待機します。これが完了すると、[Install... (インストール...)] ボタンが有効になります。 11. [Install... (インストール...)] ボタンをクリックし、言語パックをインストールします。 12. インストールが完了したら、Composer を終了します。 13. コマンド ラインを使用して、Composer を Composer インストールのルート (composer -nl <language name>) から実行します。たとえば、Composer を日本語版にするには、コマン ド composer -nl ja を実行します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 17 Documentum Composer 18 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 2 章 プロジェクトの管理 この章では、次について説明します。 • Composer プ ロ ジ ェ ク ト • Composer の 参 照 プ ロ ジ ェ ク ト • Composer ア ー テ ィ フ ァ ク ト • プロジェクト プロパティの設定 • Composer プ ロ ジ ェ ク ト の ロ ー カ ラ イ ズ • トレースの有効化 Composer プ ロ ジ ェ ク ト Composer プロジェクトは、アプリケーションを構成するオブジェクトの集まりです。そのため、新しい アプリケーションの開発を始める前に、プロジェクトを作成する必要があります。 プロジェクトは、1 つのプロジェクト フォルダと、アーティファクト (ライフサイクル、アクセス権セット、 ジョブなど) を含む複数のサブフォルダで構成されます。Composer アーティファクト (25ページ) に アーティファクトのリストが載っています。Composer プロジェクトには のアイコンが付きます。 Composer プロジェクトを作成する方法には、次のようないくつかの方法があります。 • 空のプロジェクトを作成する (プロジェクトの作成 (19ページ) を参照)。 • 既存のプロジェクトを Composer にインポートする (プロジェクトのインポート (21ページ) を参照)。 • ローカルの 5.3 DocApp アーカイブから Composer プロジェクトを作成する (DocApp アーカ イブの変換 (43ページ) を参照)。 • 5.3 DocApp から Composer プロジェクトを作成する (DocApp の Composer プロジェクトへの変 換 (40ページ) を参照)。 注 記 : 新しいバージョンの Composer は、古いバージョンの Composer で作成されたワークスペー スを使用できません。まずワークスペースを作成し、その後古いワークスペースから新しいワークス ペースにプロジェクトをインポートしてください。 プロジェクトの作成 アプリケーションを最初から作成するときは常に、プロジェクトを作成します。 プロジェクトを作成するには 1. [Documentum Navigator] 領域で右クリックし、[新規作成] > [Documentum プロジェクト] を選 択します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 19 プロジェクトの管理 [新しい Documentum プロジェクト] ダイアログ ボックスが表示されます。 2. [プロジェクト名] フィールドにプロジェクトの名前を入力し、必要に応じて説明も入力してから、 [次へ] をクリックします。 [参照されるプロジェクト] ダイアログ ボックスが表示されます。 3. 参照プロジェクトとして指定するプロジェクトを選択し、[終了] をクリックします。参照プロジェク トの詳細については、Composer の参照プロジェクト (22ページ) を参照してください。 注 記 : 関連する Documentum アーティファクト パースペクティブを選択するためのダイアログ ボッ クスが表示されたら、[はい] をクリックします。 Composer によってプロジェクトが作成され、[Documentum Navigator] ビューに表示されます。 デフォルトでは、プロジェクトには次のフォルダが含まれます。 • Artifacts: [Artifacts] フォルダには、Composer で使用可能なすべてのアーティファクトのサブフォ ルダが含まれます。プロジェクトの作成時は、これらのアーティファクト サブフォルダは空です。 • Installation Parameter Files: [Installation Parameter Files] フォルダは、プロジェクトをインストー ルするためのインストール パラメータ ファイルの保存に使用されます。デフォルトでは、プロジェ クトの作成時は、このフォルダは空です。アーティファクトを追加してプロジェクトとアーティ ファクトのインストール オプションを設定すると、関連する .installparam インストール パラメー タ ファイルがこのフォルダに保存されます。 20 EMC Documentum Composer バージョン 7.2 ユーザ ガイド プロジェクトの管理 • src: [src] フォルダは、プロジェクトに追加するソース ファイルの保存に使用されます。デフォル トでは、プロジェクトの作成時は、[src] フォルダは空です。 • Web Services: [Web Services] フォルダには、クライアント ライブラリ、WSDL ファイル、ソース コード ファイルなどの Web サービス ファイルが含まれます。デフォルトでは、プロジェクトの作成 時は、[Web Services] フォルダは空です。 プロジェクトのインポート このセクションでは、ローカル ディレクトリからプロジェクトをインポートする方法について説明しま す。既存のプロジェクトをローカル ディレクトリから Composer ワークスペースにインポートできま す。ソース コントロール システムを使用してファイルを管理している場合、プロジェクトを Composer にインポートする前に、そのプロジェクトをソース コントロール システムからチェックアウトします。 Composer とソース コントロール システムを併用する方法の詳細については、ソース管理システ ムの使用 (225ページ) を参照してください。 注 記 : DAR ファイルは、プロジェクトにインポートすることができません。DAR ファイルは、プロジェ クトの実行可能バージョンであり、Documentum リポジトリにインストールされます。DAR ファイルに は、ソース ファイルではなく、プロジェクトのバイナリ ファイルだけが含まれます。 既存のプロジェクトをインポートするには 1. [Documentum Navigator] 領域内で右クリックし、[インポート] > [既存のプロジェクト (ワークス ペース)] を選択します。 [プロジェクトのインポート] ダイアログ ボックスが表示されます。 2. [ルート ディレクトリの選択] を選択してプロジェクト ディレクトリを入力するか、[参照] をクリッ クしてディレクトリを検索します。 [プロジェクト] リストボックスに、使用可能なプロジェクトが表示されます。 注 記 : Composer 7.2 では、[アーカイブ ファイルの選択] オプションはサポートされません。 3. インポートするプロジェクトを 1 つまたは複数選択して [プロジェクトをワークスペースにコピー] を選択したら、[終了] をクリックしてプロジェクトをインポートします。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 21 プロジェクトの管理 プロジェクトがインポートされ、[Documentum Navigator] ビューに表示されます。 注 記 : ソース コントロールを使用する場合、[プロジェクトをワークスペースにコピー] オプ ションは使用しないでください。Composer では、ドキュメントのレンディションのインポートは サポートされていません。 Composer の 参 照 プ ロ ジ ェ ク ト Composer では、プロジェクト間で参照を作成できます。この機能は、Documentum アーティファ クト、ライブラリ、JAR (Java ARchive) ファイルなどのリソースを共有するプロジェクトが存在する 場合に便利です。参照プロジェクトは、プロジェクトを作成するときに、または既存のプロジェ クトを編集することによって指定できます。 一般に、他のプロジェクトと共有したいリソースを持っているプロジェクトであれば、どんなプロジェ クトでも参照プロジェクトとして指定できます。Documentum では、Documentum の機能にアクセス できる特別な参照プロジェクトも提供しています。 Documentum が 提 供 す る 参 照 プ ロ ジ ェ ク ト Documentum が提供する参照プロジェクトは、Documentum アーティファクト (より具体的には、名 前が dm で始まる Documentum アーティファクト) を使用または拡張する必要がある、ビルド不 可能なプロジェクトです。 Composer 内で作成したすべてのプロジェクトには、参照プロジェクトとして DocumentumCoreProject がデフォルトで指定されています。DocumentumCoreProject には Content Server で提供されるすべ てのアーティファクトが含まれているので、これらのアーティファクトをすぐに使用したり拡張したり のアイ できます。このプロジェクトは読み取り専用で、変更はできません。このプロジェクトには コンが付き、[Package Explorer] ビューにのみ表示されます。[Documentum Navigator] ビューには 表示されません。プロジェクトに TaskSpace タイプなどの xCelerated Composition Platform (xCP) アーティファクトが含まれる場合、DocumentumCoreProject だけでなく、TCMReferenceProject も自 動的に参照プロジェクトとして割り当てられます。 別の Documentum 製品のアーティファクトを使用または拡張する場合は、使用するアーティ ファクトを含む参照プロジェクトを取得します。さまざまな Documentum 製品で Composer の 参照プロジェクトが提供されています。これらは、EMC のソフトウェア ダウンロード サイト (https://emc.subscribenet.com) の各製品のダウンロード ページで入手できます。 次の内容を把握しておくと便利です。どのような場合に Documentum が提供する参照プロジェクト をダウンロードおよび参照するかを理解するのに役立ちます。 • dm は Documentum 用に予約されたプレフィックスです。このため、Composer プロジェクトには 名前が dm で始まるアーティファクトを含めることはできません。dm は予約されたプレフィック スであるため、ユーザ プロジェクトに dm アーティファクトが存在すると、Composer によっ てエラーとして検出されます。ただし、dm アーティファクトは、DocumentumCoreProject や TCMReferenceProject など、Documentum が提供する参照プロジェクト内には存在可能です。こ れにより、dm アーティファクトを使用および拡張するメカニズムが提供されます。 • DocumentumCoreProject や TCMReferenceProject で提供される dm アーティファクトは、参照プ ロジェクトを別途ダウンロードせずに使用または拡張できます。必要なその他すべての dm アー ティファクトには、参照プロジェクトを取得します。 22 EMC Documentum Composer バージョン 7.2 ユーザ ガイド プロジェクトの管理 • リポジトリからアーティファクトをインポートする場合に、そのアーティファクトの機能が他のアー ティファクトに依存していることがあります。そのような他のアーティファクトがプロジェクトまた は参照プロジェクト内に存在しない場合、Composer では自動的にそれらのアーティファクト がリポジトリからインポートされます。自動的にインポートされるアーティファクトの名前が dm で始まる場合、次のエラーが発生します。 タイプ名が無効です。タイプ名は ’dm’ で始まることはできません。詳細について は、『Composer ユーザ ガイド』の「参照プロジェクト」セクションを参照してく ださい。 このエラーが発生した場合、新しくインポートしたアーティファクトを削除して、適切なプロジェ クトをインポートして参照プロジェクトとして指定し、目的のアーティファクトをもう一度イン ポートします。 • 間接的に dm アーティファクトを参照するアーティファクトをインポートする場合は、その dm アーティファクトを含むプロジェクトをインポートして参照プロジェクトとして指定します。たとえ ば、my_child_type という名前のタイプをインポートするとします。my_child_type は、ある dm タイプに依存している my_parent_type という名前のタイプに依存しています。この場合、そ の dm タイプを含むプロジェクトをダウンロードしてワークスペースにインポートし、参照プロ ジェクトとして指定します。 • 前述の内容は、DocApp および DocApp アーカイブを変換する場合にも適用されます。DocApp および DocApp アーカイブが DocumentumCoreProject に含まれていない dm アーティファクトを 使用または拡張している場合は、DocApp または DocApp アーカイブを変換する前に、必要な Documentum が提供する参照プロジェクトすべてをワークスペースにインポートします。変換中 に、Composer により、必要な参照プロジェクトを指定するように求めるプロンプトが表示されます。 プロジェクトの参照プロジェクトとしての指定 プロジェクトを参照プロジェクトとして指定する方法には次の 2 通りがあります。 • プロジェクトを作成するとき • 既存のプロジェクトを編集することによって指定する DocApp または DocApp アーカイブを変換する場合は、プロジェクト作成時に参照プロジェクト を指定します。 Documentum が提供する参照プロジェクトを必要とするリポジトリからアーティファクトをインポー トする場合は、アーティファクトをインポートする前に、まず参照プロジェクトを指定します。 参照プロジェクトは、プロジェクトを作成するときに、または既存のプロジェクトを編集すること によって、指定できます。 新 し い Composer プ ロ ジ ェ ク ト に 対 す る 参 照 プ ロ ジ ェ ク ト の 指 定 DocumentumCoreProject や TCMReferenceProject に含まれていない dm アーティファクトをプロ ジェクトで使用または拡張することがあらかじめわかっている場合は、適切な参照プロジェクトを取 得してワークスペースにインポートします。インポートが完了したら、それらのプロジェクトを参 照プロジェクトとして指定します。 DocApp または DocApp アーカイブを Composer プロジェクトに変換する際に、その DocApp また は DocApp アーカイブが DocumentumCoreProject や TCMReferenceProject に含まれていない dm アーティファクトを使用または拡張している場合、次の手順に従います。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 23 プロジェクトの管理 dm アーティファクト、または DocumentumCoreProject や TCMReferenceProject にない dm アーティ ファクトを拡張するアーティファクトをインポートする場合も同様に次の手順に従います。 Documentum が 提 供 す る 参 照 プ ロ ジ ェ ク ト を 取 得 し て ワ ー ク ス ペ ー ス に イ ン ポ ー ト す る に は 1. EMC のダウンロード サイト (https://emc.subscribenet.com/) にアクセスし、必要な参照プロジェ クトをダウンロードします。参照プロジェクトは、製品の Documentum ダウンロード ページ に置かれています。 2. 参照プロジェクトの .zip ファイルを Composer ワークスペースにインポートします (プロジェ クトのインポート (21ページ) を参照)。インポートが完了すると、プロジェクトが Composer の [Documentum Navigator] ビューに表示されます。 3. プロジェクトを最初から作成するか、あるいは DocApp または DocApp アーカイブから作成しま す。プロンプトが表示されたら、適切な参照プロジェクトを指定します。 • 最初からプロジェクトを作成するには、プロジェクトの作成 (19ページ) を参照してください。 • 5.3 DocApp から Composer プロジェクトを作成するには、DocApp の Composer プロジェクト への変換 (40ページ) を参照してください。 • ローカルの 5.3 DocApp アーカイブから Composer プロジェクトを作成するには、DocApp アーカイブの変換 (43ページ) を参照してください。 既 存 の Composer プ ロ ジ ェ ク ト に 対 す る 参 照 プ ロ ジ ェ ク ト の 指 定 この手順では、既存のプロジェクトに対して参照プロジェクトを指定する方法を説明します。参照プ ロジェクトは、プロジェクトを作成するときに、新規プロジェクト ウィザードで指定することもできます。 プロジェクトを参照プロジェクトとして指定するには、そのプロジェクトが Composer ワークスペース に存在している必要があります。ワークスペース内に存在しない場合は、まずプロジェクトをイン ポートします (プロジェクトのインポート (21ページ) を参照)。 注 記 : DocApp からプロジェクトを作成して Documentum が提供する参照プロジェクトを参照す る場合は、この手順には従わないでください。まず Documentum が提供する参照プロジェクト をワークスペースにインポートして、新規プロジェクト ウィザードでプロンプトが表示されたとき にそのプロジェクトを選択します。このようにしない場合、インポートのプロセスでエラーが発 生する可能性があります。 別のプロジェクトへの参照を作成するには 1. [Documentum Navigator] 領域で、参照を作成するプロジェクトを右クリックし、ドロップダ ウン リストから [プロパティ] を選択します。 [プロパティ] ダイアログ ボックスが表示されます。 24 EMC Documentum Composer バージョン 7.2 ユーザ ガイド プロジェクトの管理 2. [プロジェクト参照] を選択します。 参照用に使用可能なプロジェクトが、[Parentproject のプロジェクト参照] リストに表示されます。 3. プロジェクトが参照するプロジェクトを 1 つまたは複数選択します。 4. [OK] をクリックします。 注記: プロジェクトをインストールする準備ができ、そのプロジェクトで他のプロジェクトを参照する場 合、すべてのプロジェクトを正しい順序でインストールしてください。たとえば、プロジェクト B がプロ ジェクト A 内のアーティファクトを参照している場合、プロジェクト A を最初にインストールします。 Composer ア ー テ ィ フ ァ ク ト アーティファクトは、オブジェクト タイプ、モジュール、メソッド、アクセス権セット、プロシージャ などの Documentum リソースです。Composer でアーティファクトを作成でき、既存のリポジトリ からアーティファクトをインポートできます。 次の表に示すように、Documentum Composer にはさまざまなアーティファクトが用意されています。 アーティファクト名 説明 エイリアス セット エイリアスの集合。エイリアスは、実際のユーザ、グループ、キャ ビネット、またはフォルダの名前を指す記号名です。エイリアス の集合がエイリアス セットです。 アスペクト モジュール オブジェクト タイプのインスタンスの動作をカスタマイズします。 アスペクト タイプ オブジェクト タイプのインスタンスのメタデータを指定します。 BAM 構成 Business Activity Monitor (BAM) の制御に使用される構成ファ イル。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 25 プロジェクトの管理 アーティファクト名 説明 BAM レポート BAM を使用して作成されるレポートで、他のリポジトリにデプロ イできるように Composer にインポートされます。BAM レポート は、SLA 適用、サイクル タイム、トランザクション収入といった主 なパフォーマンスの問題の追跡に使用できます。 BPM Process Builder で作成されるプロセス テンプレート。他のリポジト リにデプロイできるように、Composer にインポートできます。 フォルダ 包含構造として使用される Documentum リポジトリ内のフォル ダ オブジェクト。ドキュメントなどの Documentum オブジェクト を含むフォルダ。 グループ ユーザまたは子グループの論理的なグループ化を定義します。 フォーマット Content Server で認識されるファイル フォーマットに関する情報 が含まれます。リポジトリの設定時にデフォルトで、事前定義され たファイル フォーマットのセットがインストールされます。 フォーム テンプレート DocApp 内で使用する機能要素を識別します。フォーム テンプ レートは、Composer を使用して作成できません。ただし、既存の DocApp からフォームをインポートすることは可能です。 インストール パラメータ インストール前プロシージャ、インストール後プロシージャ、アッ プグレード オプションなど、プロジェクト全体に適用されるインス トール オプションを指定します。 JAR 定義 JAR ファイルをカプセル化します。JAR ファイルは、複数のファ イルを 1 つにまとめたアーカイブ ファイルです。 Java ライブラリ Java ライブラリをカプセル化します。Java ライブラリは、モジュー ルなど他のアーティファクトにリンク可能なインターフェイス JAR および実装 JAR を格納します。 ジョブ メソッドの実行 (たとえば、コンテンツをストレージ領域の間に転 送) を自動化します。ジョブの属性により、実行スケジュールが 定義され、実行のオンまたはオフが切り替えられます。 ライフサイクル ドキュメントなどのオブジェクトが、ビジネス プロセスの間にさま ざまな段階に移行する際に生じるプロパティの変更に関する ビジネス規則を指定します。 メソッド リポジトリ内のメソッド オブジェクトによって表される実行可能プ ログラム。 モジュール 実行可能コードの単位。 アクセス権セット リポジトリ内のオブジェクトに割り当てられた基本アクセス権およ び拡張アクセス権の設定で、ユーザおよびユーザ グループと、 それぞれが実行可能なアクションのリストです。 プロシージャ Docbasic または Java プログラム。通常、プロシージャはインストー ル前やインストール後のタスクを指定するために使用されます。 関係タイプ リポジトリ内にある 2 つのオブジェクト間の関係を定義します。 スマート コンテナ テンプレートにオブジェクトと関係を定義します。テンプレートを 使用して実行時にインスタンスが作成されます。 26 EMC Documentum Composer バージョン 7.2 ユーザ ガイド プロジェクトの管理 アーティファクト名 説明 システム オブジェクト Documentum システムで最もよく使用されるオブジェクトの親タイ プ。システム オブジェクト タイプのプロパティは、そのすべての サブタイプに継承されます。 タイプ オブジェクトのクラスを表します。オブジェクト タイプの定義は 属性のセットです。属性値は、オブジェクト タイプの個々のオ ブジェクトを表します。 XML アプリケーション リポジトリ内での XML コンテンツの処理方法をカスタマイズ および自動化します。 アーティファクトの作成 アーティファクトを作成するには、アーティファクト ウィザードを使用します。 アーティファクトを作成するには 1. Documentum Navigator 領域で右クリックし、[新規作成] > [その他] を選択します。 [ウィザードを選択] ダイアログ ボックスが表示されます。 2. [Documentum アーティファクト] フォルダをダブルクリックして展開し、アーティファクト リストから 作成するアーティファクトを選択して、[次へ] をクリックします。 [New [artifact type] (新しい <アーティファクト タイプ>)] ダイアログ ボックスが表示されます (<アーティファクト タイプ> は以前に選択したアーティファクト名)。たとえば、アーティファ EMC Documentum Composer バージョン 7.2 ユーザ ガイド 27 プロジェクトの管理 クト リストから [エイリアス セット] を選択した場合は、[新しいエイリアス セット] ダイアログ ボックスが表示されます。 3. アーティファクトを作成するフォルダを [フォルダ] フィールドで指定するか、デフォルトの フォルダをそのまま使用します。 注 記 : アーティファクトは常に アーティファクト フォルダに作成します。プロジェクトのルー トの直下にアーティファクトを作成した場合、アーティファクトがリポジトリに正しくインストー ルされません。 4. [アーティファクト名] フィールドにアーティファクトの名前を入力するか、デフォルトのアー ティファクト名をそのまま受け入れます。アーティファクトのデフォルト名は、作成するアー ティファクトのタイプに応じて異なります。 5. [終了] をクリックします。 新しいアーティファクト用のエディタが表示されます。個々のアーティファクト エディタの詳 細、および各アーティファクトのプロパティの設定方法については、このガイドの関連す る章を参照してください。 注 記 : Composer では、同じプロジェクト内でのみアーティファクトのコピーと貼り付けがサポートさ れています。他のプロジェクトのアーティファクトはコピーできません。 アーティファクトのインポート Documentum Composer を使用して、個々のアーティファクトをリポジトリから既存のプロジェクトにイ ンポートできます。アーティファクトをインポートする前に、インポートするアーティファクトで必要 な、関連する Composer プロジェクトすべてがインポートおよび参照されていることを確認してくだ さい。インポートするアーティファクトが、プロジェクトや参照プロジェクトに存在しない他のアーティ ファクトに依存している場合、Composer ではリポジトリからの他の必要なアーティファクトのインポー トを試みます。詳細については、Composer の参照プロジェクト (22ページ) を参照してください。 注 記 : アーティファクトは、リポジトリからのみインポートできます。あるローカル プロジェクトから別 のローカル プロジェクトにアーティファクトをインポートすることはできません。 個々のアーティファクトをインポートするには 1. [Documentum Navigator] 領域内で右クリックし、ポップアップ メニューから [インポート] > [アーティファクト (リポジトリ)] を選択します。 [プロジェクトの選択とリポジトリのログイン] ダイアログ ボックスが表示されます。 28 EMC Documentum Composer バージョン 7.2 ユーザ ガイド プロジェクトの管理 2. 次の表の説明に従ってプロジェクトとリポジトリの情報を入力し、[ログイン] をクリックします。 プロパティ 説明 プロジェクト名 アーティファクトをインポートする既存のプロジェクトの名前。 既存のプロジェクトがない場合は、アーティファクトをイン ポートする前にプロジェクトを作成します。プロジェクトの作 成の詳細については、プロジェクトの作成 (19ページ) を参 照してください。 リポジトリ名 アーティファクトが格納されているリポジトリの名前。 ユーザ名 アーティファクトが含まれているリポジトリにログインする際に 使用する名前。 パスワード アーティファクトが含まれているリポジトリにログインする際に 使用するパスワード。 ドメイン リポジトリのドメイン名。クライアントがリポジトリにアクセスす るドメインと異なるドメインにリポジトリがある場合、ドメイン 名を指定します。 リポジトリに対するログイン認証情報に間違いがなければ、リポジトリにログインできます。 3. [次へ] をクリックします。 [アーティファクトの選択] ダイアログ ボックスが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 29 プロジェクトの管理 4. [アーティファクト タイプの選択] リストからアーティファクト オブジェクト タイプを選択します。 選択したタイプの使用可能なアーティファクトが、[使用可能なアーティファクトからの選 択] リストに表示されます。 使用可能なアーティファクト (FormTemplate など) のいくつかをクリックすると、[プロパティ] セク ションが表示され、選択したアーティファクトについての情報 (名前や値など) が表示されます。 5. [使用可能なアーティファクトからの選択] リストから 1 つまたは複数のオブジェクトを選択し、 [追加] をクリックします。 注 記 : Composer によりユーザ定義オブジェクトだけが一覧表示され、リポジトリの設定時に Content Server によって作成されたオブジェクトは表示されません。 6. アーティファクトの選択が終わったら、アーティファクトをリポジトリからインポートするために [終 了] をクリックします。アーティファクトがプロジェクトにインポートされます。 注 記 : 次の操作を行うと、プロジェクト内の異なる 2 つのロケーションに重複したアーティファ クトが存在する状態になります。 a. リポジトリからアーティファクトをインポートする。 b. プロジェクト内の別のロケーションにそのアーティファクトを移動する。 c. リポジトリからそのアーティファクトをもう一度インポートする。 プロジェクト プロパティの設定 [プロパティ] ダイアログ ボックスを使用すると、インストール オプション、DFS モジュール オプショ ン、プロジェクト インストール プロシージャなどのさまざまなプロジェクト プロパティを設定できます。 プロジェクトの [プロパティ] ダイアログ ボックスにアクセスするには、プロジェクトを右クリックし、ド ロップダウン リストから [プロパティ] を選択します。 [プロパティ] ダイアログ ボックスが表示されます。 30 EMC Documentum Composer バージョン 7.2 ユーザ ガイド プロジェクトの管理 設定の詳細については、次を参照してください。 • プロジェクトの参照については、既存の Composer プロジェクトに対する参照プロジェクトの指定 (24ページ) を参照してください。 • DFS モジュール オプションについては、DFS モジュール オプションの設定 (62ページ) を 参照してください。 • DFS ライブラリ オプションについては、DFS サービス ライブラリを設定するには (62ページ) を 参照してください。 • プロジェクト インストール オプションについては、プロジェクト インストール オプションの設定 (200ページ) を参照してください。 • プロジェクト インストール プロシージャについては、インストール前プロシージャとインストー ル後プロシージャの設定 (202ページ) を参照してください。 Composer プ ロ ジ ェ ク ト の ロ ー カ ラ イ ズ Composer では現在、プロパティ ファイル内のタイプラベル、タイプ属性ラベル、および UI 文字列 のローカライズのみをサポートしています。Composer では Business Object Framework (BOF) JAR ファイルおよび Java ライブラリのディレクトリ構造も作成されるので、ローカライズされた JAR ファイ ルがある場合、それらを指定できます。Composer はローカライズされた JAR ファイルそのものの生 成はしません。作成するのは、JAR ファイルをコピーするディレクトリ構造のみです。 ローカライズされたデータ ディクショナリとともに DAR または Composer プロジェクトをインストール する前に、リポジトリで必要なロケールを有効にします。リポジトリを作成すると、Content Server の ホスト ロケールに基づいてデータ ディクショナリ情報のセットがロードされます。ホスト ロケールが ロシア語、アラビア語、日本語、韓国語、または簡体字中国語の場合、リポジトリ作成時にそのロ ケールのデータ ディクショナリ情報がロードされます。それ以外の場合、ホスト ロケールは常に英 語です。ロケールを追加するには、Documentum で提供される移行スクリプトを使用します。デー タ ディクショナリ ファイルの移行と発行を行うには、『Documentum Content Server Administration EMC Documentum Composer バージョン 7.2 ユーザ ガイド 31 プロジェクトの管理 and Configuration Guide (Documentum Content Server 管理/構成ガイド)』の付録「Populating and Publishing the Data Dictionary (データ ディクショナリの移行と発行)」の手順に従います。 Composer プ ロ ジ ェ ク ト を ロ ー カ ラ イ ズ す る に は 1. プロジェクト内のタイプごとに、次の操作を行います。 a. [属性] タブで、属性ノードを展開して [アプリケーション インターフェイス表示] をクリックし ます。右側に [全般] セクションが表示されます。 b. [全般] セクションで、[ラベル] フィールドの値が指定されていることを確認します。 c. すべての属性について、手順 a および b を完了します。 d. [表示] タブで、[タイプ ラベル] フィールドの値が指定されていることを確認します。 2. [Documentum Navigator] ビューで、ローカライズするタイプを含むプロジェクトを右クリッ クします。 3. ドロップダウン リストから [ローカライズ テンプレートの生成] を選択します。 プロジェクトのルート ディレクトリの下にロケール ディレクトリが生成されます。ロケール ディレク トリにはデフォルトで、英語の en フォルダが含まれます。このフォルダはメインのプロジェクト フォルダと同じアーティファクト ディレクトリ構造を持ちます。 ロケール ディレクトリのアーティファクト フォルダには、ローカライズされるデータを含むアー ティファクトが一覧表示されます。 使用している Composer バージョンと異なるロケールのプロジェクトをインポートする場合、プ ロジェクト内でローカライズできる情報は、作成時のロケールに関連付けられたままとなり ます。使用中の Composer には変更と追加が元のロケールで表示されたままになります。 ローカライズ テンプレートも、元のロケールで生成されます。 4. ローカライズの必要な BOF JAR ファイルまたは Java ライブラリがある場合、これら の JAR ファイルの英語版を、locales/<lang>/Artifacts 内の適切なディレクトリにコピー します。JAR ファイルにはローカライズ可能な文字列を含む .properties ファイルを含 む必要があります。たとえば、Composer プロジェクトに my_tbo という名前のタイプベー ス オブジェクト (TBO) があり、ローカライズ テンプレートを生成した場合、対応する locales/<lang>/Artifacts/JARs/Modules/TBO/my_tbo ディレクトリが作成されるので、ローカライ ズ可能な JAR ファイルをそこに置くことができます。BOF JAR ファイルまたは Java ライブラリに にローカライズ可能な内容がない場合、不要なディレクトリは削除します。 Composer は、JAR ファイルにローカライズ可能なデータが何もない場合でも、BOF オブジェクトまたは JAR ライブ ラリ用のディレクトリを生成します。作成されるディレクトリを次のリストに示します。 • ライブラリ JAR 用: locales/<lang>/Artifacts/Java Libraries/<library name> • 標準モジュール JAR 用: locales/<lang>/Artifacts/[標準モジュール]/<module name> 32 EMC Documentum Composer バージョン 7.2 ユーザ ガイド プロジェクトの管理 • TBO/SBO モジュール JAR 用: locales/<lang>/Artifacts/TBO/<module name> • その他の (タイプの) モジュール JAR 用: locales/<lang>/Artifacts/<module type name>/<module name> 注 記 : JAR ファイルのうち、.properties ファイルをローカライズする際には、英語の .properties ファイル名にロケールを示す文字列を付加します。たとえば、英語の .properties ファイル名 が localizedStrings.properties でこれを日本語に翻訳した場合、ローカライズしたファイル名 は localizedStrings_ja.properties とします。ローカライズした JAR ファイルは、英語の JAR ファイル名と同じ名前にします。 5. ロケール ディレクトリの下にある en フォルダ全体をコピーし、このフォルダの名前を、使用可能 にする言語ロケールに変更します。たとえば、アプリケーションにドイツ語のラベルを付ける場 合は、次のように de フォルダを作成します。 翻訳する .properties ファイルを送信する場合は、次の手順でファイルをエクスポートします。 a. Composer で、[ファイル] > [エクスポート] に移動します。 [エクスポート] ダイアログ ボックスが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 33 プロジェクトの管理 b. [ファイル システム] を選択し、[次へ] をクリックします。 [ファイル システム] ダイアログ ボックスが表示されます。 34 EMC Documentum Composer バージョン 7.2 ユーザ ガイド プロジェクトの管理 c. エクスポートするロケール フォルダが含まれるプロジェクトを展開し、de などの言語 ロケールを選択します。 d. ファイルをエクスポートするディレクトリを [宛先ディレクトリー] フィールドに入力します。 e. [ファイルのディレクトリ構造を作成] オプションを選択し、[終了] をクリックします。 ディレクトリ構造のコンテンツと言語ロケール フォルダのコンテンツが、ローカル マシン上の選 択されたディレクトリにエクスポートされます。ファイルを翻訳チームに配信します。 翻訳チームが、ロケール フォルダ内の .properties ファイルに含まれる等号 (=) の右側の文 字列を翻訳します。ロケール フォルダのディレクトリ構造と .properties ファイル名は変更 しないでください。 注記: 次のキーはローカライズできません: type/primaryElement/typeAnnotations[0]/locales/value_mappings[xx]/map_data_string 6. .properties ファイルを翻訳したら、次の手順に従ってファイルをプロジェクトにインポートします。 a. Composer で、[ファイル] > [インポート] を選択します。 [インポート] ダイアログ ボックスが表示されます。 b. [ファイル システム] を選択し、[次へ] をクリックします。 [ファイル システム] ダイアログ ボックスが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 35 プロジェクトの管理 c. 翻訳されたファイルがあるロケール フォルダが含まれるプロジェクト フォルダへのディレクト リ パスを [次のディレクトリーから] フィールドに入力します。 d. プロジェクトとロケール フォルダを選択します。 e. ロケール フォルダのエクスポート元である Documentum プロジェクト のプロジェクト名を [イ ンポート先フォルダ] フィールドに入力します。翻訳チームがファイル名およびフォルダ 構造を変更していない場合、このプロジェクト名は [インポート元のディレクトリ] フィール ドのプロジェクト名と同じです。 f. [選択されたフォルダのみを作成] を選択します。各ファイルのインポートを確認しない場 合、[警告せずに既存のリソースを上書き] を選択します。 g. [終了] をクリックします。 7. インストール ウィザードを起動し、[ローカライズされたアーティファクト データをインストール] オ プションを選択し、ローカライズされたデータのパスとして「<Composer_project_root>/locales」 と入力します。 36 EMC Documentum Composer バージョン 7.2 ユーザ ガイド プロジェクトの管理 プロジェクトのインストール方法の詳細については、プロジェクトのインストール (206ペー ジ) を参照してください。 プロジェクトがリポジトリにインストールされる時に、新しい言語の文字列は自動的にマージ され、リポジトリで新しい言語を使用できるようになります。 注 記: 新しい言語の文字列が正しくマージされない可能性があるため、ローカライズ テンプ レートを作成した後にラベル、説明、タブを変更したり、.properties ファイルを移動したりしない でください。ラベルやその他のローカライズ可能なアプリケーション データの名前を変更する 場合、文字列を翻訳する前にローカライズ テンプレートを再生成してください。 トレースの有効化 トレースを有効にすると、プロジェクトをビルドまたはインポートするときなどに、プロセスを監視する ことができます。デフォルトでは、Eclipse のトレース機能は無効になっています。 注 記 : Composer のパフォーマンスに影響を与えるため、トレースはデバッグ目的でのみ行う ようにしてください。 トレースを有効にするには 1. Eclipse のメイン ツールバーで、[ウィンドウ] > [設定] に移動します。 [設定] ダイアログ ボックスが表示されます。 2. [Documentum] をクリックしてツリー構造を展開し、[ロガー] を選択します。 ロガーのオプションが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 37 プロジェクトの管理 3. [トレース メッセージ] と [メッセージを Eclipse ILog にコピーする] を選択して、[OK] をク リックします。 デフォルトでは、ワークスペースの .metadata サブディレクトリにすべてのエラー ログ ファイルが保存されます。 38 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 3 章 DocApp お よ び DocApp ア ー カ イ ブ の Composer プ ロ ジ ェ ク ト へ の 変 換 この章では、次について説明します。 • DocApp と DocApp ア ー カ イ ブ に つ い て • DocApp の Composer プ ロ ジ ェ ク ト へ の 変 換 • DocApp ア ー カ イ ブ の Composer プ ロ ジ ェ ク ト へ の 変 換 • 変換後のタスク DocApp と DocApp ア ー カ イ ブ に つ い て DocApp および DocApp アーカイブは、リリース 6.0 よりも前に DAB (Documentum Application Builder) を使用して作成された Documentum アプリケーションです。リリース 6.0 およびそれ以降で は、Composer を使用してアプリケーションの作成、編集、およびインストールを行います。既存の DocApp および DocApp アーカイブを変更する場合は、それらを Composer プロジェクトに変換し ます。DocApp および DocApp アーカイブは専用のバイナリ ファイルを使用してパッケージ化 されていますが、Composer では XML ファイルを使用してこれらの専用のバイナリ ファイルを 表現しているため、変換が必要になります。 DocApp は、DocApp をリポジトリから直接インポートすることによって Composer プロジェクトに変換 されます。また、Composer で DocApp アーカイブをリポジトリにインストールしてプロジェクトを変換 することによって、DocApp アーカイブを Composer プロジェクトに変換することもできます。 DocApp および DocApp アーカイブを変換するときには次の規則が適用されます。 • 既存のバージョン 5.3 以降のリポジトリ DocApp または DocApp アーカイブを Composer プロ ジェクトに変換できます。 • 変換して得られた Composer プロジェクトは 5.3 以降のリポジトリにインストールできます。 Composer プロジェクトに変換した DocApp は、機能がサポートされている限り、より古いリポジト リにインストールできます。たとえば、DocApp が dm_document というカスタムのサブタイプし か持っていない場合、6.0 DocApp を Composer プロジェクトに変換して、それを 5.3 リポジト リにインストールできます。ただし、Documentum 5.3 でサポートされないアーティファクト (ス マート コンテナやアスペクトなど) が DocApp に含まれる場合は、DocApp を 5.3 リポジトリにイ ンストールすることはできません。 • バージョン 5.3 より前のリポジトリに格納されている DocApp または DocApp アーカイブは変 換できません。変換する場合は、まず DocApp または DocApp アーカイブをバージョン 5.3 にアップグレードします。 • リポジトリをアップグレードする場合は、DocApp を変換する前に実施してください。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 39 DocApp および DocApp アーカイブの Composer プロジェクトへの変換 DocApp の Composer プ ロ ジ ェ ク ト へ の 変 換 Composer では、リポジトリ ディレクトリに格納されている DocApp を Composer ワークスペースに直 接変換できます。この機能により、既存の DocApp を Composer で変更してインストールできます。 DocApp を Composer プ ロ ジ ェ ク ト に 変 換 す る に は 1. 変換する DocApp が他の DocApp またはプロジェクトに依存している場合は、まずそれらの DocApp を変換します。たとえば、変換する DocApp が別の DocApp に含まれる JAR ファイル を使用する場合、まずその JAR ファイルを含む DocApp を変換します。 2. 参照プロジェクトとして指定するすべての Composer プロジェクトをワークスペースにインポート します。DocApp を変換する前に、DocApp で必要な Documentum が提供する参照プロジェク トすべてがワークスペースに存在する必要があります。参照プロジェクトの詳細については、 Composer の参照プロジェクト (22ページ) を参照してください。 3. [Documentum Navigator] ビュー内で右クリックし、[新規作成] > [Documentum プロジェクト (リ ポジトリの DocApp)] を選択します。 [新しい Documentum プロジェクト (DocApp)] ダイアログ ボックスが表示されます。 4. 次の表の説明に従って、インポートする DocApp を含んでいるリポジトリ用のログイン認証情 報を入力し、[ログイン] をクリックします。 プロパティ 説明 リポジトリ 必須のパラメータです。リポジトリの名前。 リポジトリにアクセスするには、スーパーユーザ権限が必要 です。 ユーザ名 リポジトリ用のユーザ名。 パスワード リポジトリ用のパスワード。 ドメイン リポジトリのドメイン名。クライアントがリポジトリにアクセスす るドメインと異なるドメインにリポジトリがある場合、ドメインを 指定します。 Composer がリポジトリに接続し、ログイン認証情報を検証します。 5. ログイン認証情報が検証されたら、[次へ] をクリックします。 40 EMC Documentum Composer バージョン 7.2 ユーザ ガイド DocApp および DocApp アーカイブの Composer プロジェクトへの変換 [Documentum アプリケーション] ダイアログ ボックスが表示されます。 6. 変換する DocApp をリストボックスから選択し、[次へ] をクリックします。 [新しい Documentum プロジェクト] が表示されます。 7. デフォルトのプロジェクト名をそのまま使用するか、新しい名前を入力し、必要な場合はプ ロジェクトの説明も入力してから、[次へ] をクリックします。 [参照されるプロジェクト] ダイアログ ボックスが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 41 DocApp および DocApp アーカイブの Composer プロジェクトへの変換 8. プロジェクトが参照するプロジェクトを選択して、[終了] をクリックします。 Composer に DocApp がインポートされ、プロジェクトが作成されます。[Documentum Navigator] ビューに新しいプロジェクトが表示されます。 DocApp ア ー カ イ ブ の Composer プ ロ ジ ェ ク ト へ の 変換 DocApp アーカイブは DocApp のポータブル版で、DAB (Documentum Application Builder) を使 用してアーカイブされています。DocApp アーカイブを Composer プロジェクトに変換するために、 Composer では DocApp アーカイブをターゲット リポジトリにインストールして、DocApp アーカイ ブからプロジェクトを作成します。 DocApp ア ー カ イ ブ を 変 換 す る た め の 準 備 DocApp アーカイブを Composer に変換する前に、次の要件が満たされていることを確認します。 • DocApp アーカイブのターゲット リポジトリがクリーンなリポジトリであり、リポジトリに DocApp や アーティファクトの残りが含まれていないこと。このリポジトリが、結果として得られる Composer プ ロジェクトに今後の変更をデプロイすることを計画している場所であること。 • 変換する DocApp アーカイブがバージョン 5.3 以降であることを確認します。5.3 よりも前の DocApp アーカイブは変換できません。DocApp アーカイブが 5.3 よりも前のバージョンである場 合、その DocApp アーカイブをバージョン 5.3 にアップグレードします。 • dfc.properties ファイルに設定されたコネクション ブローカがターゲット リポジトリを指しているこ とを確認してください。コネクション ブローカの設定の詳細については、コネクション ブロー カの設定 (14ページ) を参照してください。 • ターゲット リポジトリにアクセスするためのスーパーユーザ権限があることを確認します。 • 変換する DocApp アーカイブが他の DocApp に依存している場合は、それらの DocApp をまず 変換する必要があります。結果として得られた Composer プロジェクトがワークスペース内に存在 することも確認します。DocApp アーカイブが他の参照プロジェクトに依存している場合は、参照 42 EMC Documentum Composer バージョン 7.2 ユーザ ガイド DocApp および DocApp アーカイブの Composer プロジェクトへの変換 プロジェクトも同様にワークスペースにインポートします。詳細については、Composer の参照プ ロジェクト (22ページ) を参照してください。 DocApp ア ー カ イ ブ の 変 換 Composer では、DocApp アーカイブを Composer プロジェクトに変換することができます。DocApp アーカイブは、DAB (Documentum Application Builder) でアーカイブされた DocApp です。 DocApp ア ー カ イ ブ を 変 換 す る に は 1. DocApp アーカイブを、ローカル マシンまたはネットワーク ドライブのフォルダに展開します。 2. [Documentum Navigator] ビュー内で右クリックし、[新規作成] > [Documentum プロジェクト (ローカル DocApp アーカイブ)] を選択します。 [アーカイブおよびプロジェクト情報] ダイアログ ボックスが表示されます。 3. 次の表の説明に従って DocApp アーカイブのフォルダ名とプロジェクト名を入力し、[次 へ] をクリックします。 プロパティ 説明 DocApp アーカイブ フォルダ 必須のパラメータです。展開した DocApp アーカイブを格納 するフォルダ。パス名を入力するか、[参照] をクリックして フォルダを検索します。 プロジェクト名 必須のパラメータです。DocApp のインポート先となるプロジェ クトの名前。デフォルトでは、プロジェクト名は DocApp の名前 を受け継ぎます。デフォルトの名前をそのまま受け入れるか、 または新しいプロジェクト名を入力することができます。 [移行リポジトリ情報] ダイアログ ボックスが表示されます。 4. 次の表の説明に従って、ターゲット リポジトリの移行リポジトリ情報を入力します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 43 DocApp および DocApp アーカイブの Composer プロジェクトへの変換 プロパティ 説明 リポジトリ 必須のパラメータです。ターゲット リポジトリの名前。 ターゲット リポジトリは、クリーンなリポジトリである必要がありま す。このリポジトリは、新しいプロジェクトとして Composer に インポートする前に、DocApp アーカイブをインストールする ために使用されます。ターゲット リポジトリにアクセスするに は、スーパーユーザ権限が必要です。 ユーザ名 ターゲット リポジトリ用のユーザ名。 パスワード ターゲット リポジトリ用のパスワード。 ドメイン ターゲット リポジトリのドメイン名。クライアントがターゲット リポ ジトリにアクセスするドメインと異なるドメインにリポジトリがある 場合、ドメイン名を指定します。 5. ターゲット リポジトリの名前とログイン認証情報を入力したら、[ログイン] をクリックします。ログ イン認証情報が有効な場合、[次へ] ボタンが使用可能になります。[次へ] をクリックします。 6. 参照プロジェクトとして指定するプロジェクトを選択し、[終了] をクリックして変換プロセス を開始します。 Composer によって DocApp からプロジェクトが作成され、[Documentum Navigator] ビューにプロ ジェクトが表示されます。 変換後のタスク DocApp または DocApp アーカイブが Composer プロジェクトに変換された後、次の手順を完了 させます。 • 変換中に生じた、検証に関する警告やエラーを確認して修正する。 • DocApp に含まれているアーティファクトがすべて変換され、Composer プロジェクトに表示さ れていることを確認する。 • インストール前およびインストール後のスクリプトを確認する。 アーティファクトの重複やコンフリクトを避けるには、特定のスクリプトを修正しなければならない 場合があります。たとえば、Composer では、ユーザのインストール パラメータを作成します。イン ストール前スクリプトによってそれらのユーザが作成されるか、あるいはプロジェクトをインストー ルするターゲット リポジトリ内にそれらのユーザが存在していなければなりません。 44 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 4 章 Composer と xCelerated Composition Platform この章では、次について説明します。 • Composer と xCelerated Composition Platform に つ い て • TaskSpace ア プ リ ケ ー シ ョ ン ま た は xCP ア ー テ ィ フ ァ ク ト の パ ッ ケ ー ジ 化 お よ び イ ン ス ト ー ル のヒントと注意事項 • Composer プ ロ ジ ェ ク ト と DAR フ ァ イ ル • TaskSpace ア プ リ ケ ー シ ョ ン の パ ッ ケ ー ジ 化 • xCP ア ー テ ィ フ ァ ク ト の パ ッ ケ ー ジ 化 • TaskSpace ア プ リ ケ ー シ ョ ン と xCP ア ー テ ィ フ ァ ク ト の イ ン ス ト ー ル • headless Composer を 使 用 し た 、 xCP ア ー テ ィ フ ァ ク ト を す で に 含 む Composer プ ロ ジ ェ ク トのビルドとインストール • ソ ー ス 環 境 か ら タ ー ゲ ッ ト 環 境 へ の TaskSpace ア プ リ ケ ー シ ョ ン ま た は xCP ア ー テ ィ フ ァ ク トの移行 Composer と xCelerated Composition Platform に ついて EMC Documentum xCelerated Composition Platform (xCP) は、アプリケーション構成プラットフォー ムです。xCP は、エンタープライズ コンテンツ管理、ビジネス プロセス管理、インテリジェント キャ プチャ、顧客コミュニケーション管理、コラボレーション、コンプライアンスなどの機能を組み合わ せた、事前統合テクノロジです。このプラットフォームでは、デプロイにかかる時間とコストを削 減できるベスト プラクティスとともに、アプリケーション開発を迅速に行うためのツールが用意さ れています。xCP は、コーディングをほとんどまたはまったく行わずにサービス、コンポーネン ト、ユーザ インターフェイス要素の構成が可能であるため、ソリューションのデプロイに必要な リソースが少なくて済み、プロジェクト リスクが軽減されます。 xCP には、次の EMC Documentum 製品が含まれます。 • Composer • Content Server • Business Activity Monitor • Forms Builder • Process Builder • Process Engine EMC Documentum Composer バージョン 7.2 ユーザ ガイド 45 Composer と xCelerated Composition Platform • Process Integrator • TaskSpace • Process Reporting Services • Process Analyzer (オプションのアドオンであり、個別にライセンスを受ける) • xCP Designer xCP では、Composer は主に、TaskSpace アプリケーションや xCP 1.x アーティファクトのパッケージ 化およびデプロイのツールとして使用されます。TaskSpace アプリケーションは、関連する xCP 1.x アーティファクトのコンテナとして機能します。こうした xCP 1.x アーティファクトは、プロジェクトとし て Composer にインポートし、DAR ファイルとしてパッケージ化できます。 注 記 : Composer はインポート中の xCP 2.x アーティファクトをサポートしません。これは、アーティ ファクトは Sysobjects にリストされ、固有のオブジェクト名がないためです。また、アーティファクトを 別のドックベースにインストールすると、参照は失われます。 TaskSpace ア プ リ ケ ー シ ョ ン ま た は xCP ア ー テ ィ フ ァ クトのパッケージ化およびインストールのヒントと注意 事項 Composer で TaskSpace アプリケーションや xCP アーティファクトをパッケージ化およびデプロイす る際には、次のことに注意します。 • ソース リポジトリで TaskSpace アプリケーションまたは xCP アーティファクトを変更し、Composer プロジェクトに再パッケージ化する場合、Composer プロジェクトを作成して、アーティファクトのク リーン インポートを行います。古いバージョンのアーティファクトが含まれている作成済みの Composer プロジェクトは使用しないでください。 • TaskSpace アプリケーションを複数の Composer プロジェクトに分割して、移植性と管理性を高め ることができます。アプリケーションの一部が頻繁に更新される場合、そうしたアーティファクトを 1 つの Composer プロジェクトにバンドルし、アプリケーションの残りの部分を別の Composer プロ ジェクトに含めます。プロジェクトに多数のアーティファクトが含まれる場合、TaskSpace アプリ ケーションを複数の Composer プロジェクトに分割できます。たとえば、ワークフローに 1 つ、 TaskSpace アプリケーションを含めるのに 1 つというように、各タイプに個別の Composer プロ ジェクトを使用できます。これらのプロジェクトのいずれかを編集した場合、関連するすべての Composer プロジェクトを再パッケージ化および再ビルドすることがベスト プラクティスです。 • 埋め込みフォームを含むタスク フォームを使用したプロセスをインポートする際には、Composer プロジェクトに埋め込みフォームが自動的に含まれます。 • 埋め込みフォームを含むタスク フォームを使用したプロセスをインストールする際には、埋め込 みフォームにはプロセスのインストール アップグレード設定が継承されません。たとえば、プ ロセスが [バージョン] に設定されている場合、タスク フォームの個別設定に関わらず、タス ク フォームは自動的に [バージョン] に設定されます。タスク フォーム内の埋め込みフォーム には、インストール アップグレード設定が継承されません。 • フォーム テンプレートを含むプロジェクトまたは DAR ファイルをインストールする場合、その前 に、プロセス エンジンまたはターゲット リポジトリ内の FORMS.dar ファイルをインストールします。 • ユーザ コンテンツを TaskSpace アプリケーション (サンプル ドキュメントやドキュメントのライブラリ など) と関連付けるには、対応するフォルダを TaskSpace アプリケーションに追加します。たと えば、リポジトリ内に次のフォルダ構造が存在するとします。 46 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Composer と xCelerated Composition Platform Folder1 以下のすべてのコンテンツを関連付けるには、Folder1 を TaskSpace アプリケーションに 追加します。subfolder1 コンテンツだけを関連付けるには、subfolder1 だけを TaskSpace アプリ ケーションに追加します。 • TaskSpace アプリケーションをインポートする場合、インポートされないコンテンツやアーティファ クトがあります。次の項目は手動でインポートします。 – ACL および ACL テンプレート (Composer では、ACL と ACL テンプレートについてインストー ル パラメータが作成されるが、アーティファクト自体はインポートされない) – グループの子グループ – ワークフロー テンプレートで使用されるグループとロール – プロセスによって参照されるエイリアス セット – サンプル ドキュメントやドキュメントのライブラリなど、TaskSpace アプリケーションに明示的に 関連付けられていないユーザ コンテンツ – BOF モジュールとして実装されたカスタム アクティビティ テンプレート – BOF モジュールとして実装されていないカスタム ワークフロー メソッドに必要な .class ファイル – メソッドをインポートする際にそのメソッドによって参照される BOF モジュール – カスタム フォーム アダプタの .class ファイル ♦ カスタム フォーム アダプタがこのようにビルドされた場合、アプリケーション サーバに .class ファイルをコピーします。カスタム フォーム アダプタが BOF モジュールを使用してビルドさ れた場合、BOF モジュールおよび関連する JAR ファイルが自動的にインポートされます。 ♦ 接続に JDBC を使用するアダプタの場合、JDBC 文字列を含むプロパティ ファイルを アプリケーション サーバにコピーします。 ♦ フォーム アダプタによってプロパティ ファイルからデータが取り出される場合、そのプロパ ティ ファイルを手動でインポートします。 – ドロップダウン メニューなどの項目についてフォーム アダプタで使用されるカスタム タイプ。こ れらのアーティファクトが確実に Composer にインポートされるように、アーティファクトを明示 的に TaskSpace アプリケーションに追加することをお勧めします。 – フォーム アダプタで使用されるカスタム タイプのデータ (オブジェクト) – 登録済みテーブル – フォーム インスタンス Composer プ ロ ジ ェ ク ト と DAR フ ァ イ ル TaskSpace アプリケーションまたは xCP アーティファクトを、Composer プロジェクトまたは DAR ファイルとしてパッケージ化できます。DAR ファイルは、Composer プロジェクトの読み取り専用 バイナリ表現です。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 47 Composer と xCelerated Composition Platform Composer プロジェクトは、Composer IDE 内でアプリケーションの開発やデプロイを行うのに役立 ちます。DAR ファイルは、開発とデプロイを分離する場合に便利です。開発者は通常、この状況 でデプロイを行う際には管理者に DAR ファイルを渡します。 次の表では、DAR ファイルと Composer プロジェクトの主な相違点を示します。 DAR フ ァ イ ル Composer プ ロ ジ ェ ク ト Composer プロジェクトのバイナリ表現である単一 ファイル。DAR ファイルは、Composer プロジェクト から生成する必要がある。 Documentum アプリケーションのソースを含むファイ ル セット。 編集できない。 編集できる。 Composer プロジェクトに変換できない。 DAR ファイルにビルドできる。 DAR インストーラまたは headless Composer を使用 してインストールされる。 Composer UI または headless Composer を使用して インストールされる (まず DAR にビルドしなけれ ばならない)。 TaskSpace ア プ リ ケ ー シ ョ ン の パ ッ ケ ー ジ 化 Composer には、Documentum TaskSpace アプリケーションを Composer プロジェクトとしてインポート するための別個のプラグインがあります。また、Composer では、プロジェクトを DAR ファイルに パッケージ化して他のリポジトリにデプロイすることもできます。 Composer で の TaskSpace ア プ リ ケ ー シ ョ ン の パ ッ ケ ー ジ 化 TaskSpace アプリケーションをパッケージ化するには、Composer でプロジェクトを作成して TaskSpace アプリケーションをインポートします。TCMReferenceProject は現在 Composer にパッケー ジ化されているため、このプロジェクトを参照プロジェクトとして手動で指定する必要はありません。 Composer で TaskSpace ア プ リ ケ ー シ ョ ン を パ ッ ケ ー ジ 化 す る に は 1. [Documentum Navigator] 領域内で右クリックし、[新規作成] > [プロジェクト] > [Documentum プロジェクト (TaskSpace アプリケーション)] を選択します。 [リポジトリ内の TaskSpace アプリケーションからの新しい Documentum プロジェクト] ダイ アログ ボックスが表示されます。 2. TaskSpace アプリケーションが含まれるリポジトリのログイン認証情報を入力し、[ログイン] をク リックします。 3. Composer にインポートする TaskSpace アプリケーションを左のリストから選択して、[次へ] をク リックします。 4. TaskSpace アプリケーションに必要な参照プロジェクトを選択し、[終了] をクリックしてリポジ トリから TaskSpace アプリケーションをインポートします。インポート後、Documentum アー ティファクト パースペクティブへの切り替えを求めるメッセージが表示された場合は、この パースペクティブに切り替えます。 5. DAR インストーラまたは headless Composer でインストールする DAR ファイルを取得する場 合、次の手順のいずれかを実行します。 48 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Composer と xCelerated Composition Platform • [プロジェクト] > [Build Automatically (自動的にビルド)] オプションをオンにしている場 合、...\<workspace>\<project-name>\bin-dar ディレクトリから <project>.dar ファイルを取得 できます。 • [プロジェクト] > [Build Automatically (自動的にビルド)] オプションをオフにしている場合、 ビルドする TaskSpace プロジェクトを右クリックして、ドロップダウン リストから [Build Project (プロジェクトのビルド)] を選択します。 Composer によって TaskSpace プロジェクトがビルドされ、...\<workspace>\<project-name>\bin-dar ディレクトリに <project>.dar ファイルが生成されます。 headless Composer で の TaskSpace ア プ リ ケ ー シ ョ ン の パッケージ化 headless Composer では、Ant タスクを使用して、TaskSpace アプリケーションを Composer プロジェ クトとしてインポートし、Composer プロジェクトを DAR ファイルにビルドできます。 headless Composer で TaskSpace ア プ リ ケ ー シ ョ ン を パ ッ ケ ー ジ 化 す る に は 1. ビルド用ファイルの格納場所としてビルド ディレクトリを作成します。 2. ビルド ディレクトリで、build.xml という名前のファイルを作成します。このファイルを編集す るために開きます。 3. build.xml ファイル内に emc.createTaskSpaceApplicationProject タスクを使用して Composer プロジェクトを作成するターゲットを作成します。このタスクにより、TaskSpace アプリケーショ ンと同じ名前の Composer プロジェクトが作成され、リポジトリから TaskSpace アプリケーショ ンがインポートされます。 4. emc.build タスクを使用して、プロジェクトをビルドするターゲットを作成します。emc.dar タスクの 前にこのタスクを呼び出し、作成された最新のコードが DAR ファイルに含まれるようにします。 5. emc.dar タスクを使用して、DAR ファイルを生成するターゲットを作成します。次のスクリプト は、例のプロジェクトについて Ant ターゲットを作成する方法を示しています。環境に合わせ て、スクリプト上部のプロパティ値を変更できます。 <?xml version="1.0"?> <project name="xCPBuild"> <property name="project.name" value="project_name" /> <property name="repository" value="repository" /> <property name="username" value="username" /> <property name="password" value="password" /> <property name="dar.filename" value="myDAR.dar" /> <target name ="create-taskspace-project" description="Create a Composer project from a TaskSpace application in the repository"> <emc.createTaskSpaceApplicationProject name="${project.name}" docbase="${repository} username="${username}" password="${password}"> </emc.createTaskSpaceApplicationProject> </target> <target name="build-project" description="Build the project"> <emc.build dmproject="${project.name}" failonerror="true"/> </target> EMC Documentum Composer バージョン 7.2 ユーザ ガイド 49 Composer と xCelerated Composition Platform <target name="package-project" description="Package the project into a DAR for installation"> <delete file="${dar.filename}" /> <emc.dar dmproject="${project.name}" manifest="bin/dar/default.dardef.artifact" dar="${dar.filename}" /> </target> </project> 6. ビルドを実行するバッチ ファイル build.bat を作成します。このバッチ ファイルにより、Composer ワークスペースを設定し、Ant スクリプトを呼び出します。Ant スクリプトを呼び出す際には、例 に示すとおり正しい順序でターゲットを呼び出します。ターゲットの実行順序を保持することが 重要です。一般には、Composer プロジェクトを作成し、そのプロジェクトにアーティファクトをイ ンポートしてプロジェクトをビルドしてから、DAR ファイルを生成します。次のバッチ ファイル は、例の build.xml の Ant スクリプトを実行する方法を示しています。 REM Set environment variables to apply to this command prompt only SETLOCAL REM Sets the root location of headless Composer SET ECLIPSE="C:\ComposerHeadless" REM Sets the workspace directory where Composer builds the projects REM that you want to install to a repository SET BUILDWORKSPACE=".\build_workspace" REM Sets the Ant script that builds your projects SET BUILDFILE=".\build.xml" REM Delete old build and installation workspaces RMDIR /S /Q %BUILDWORKSPACE% REM Run Ant scripts to build the project. REM The JAVA command must be on one line. JAVA -cp %ECLIPSE%\startup.jar org.eclipse.core.launcher.Main -data %BUILDWORKSPACE% -application org.eclipse.ant.core.antRunner -buildfile %BUILDFILE% create-taskspace-project build-project package-project 7. コマンドラインから build.bat ファイルを実行します。ジョブが完了すると、指定した場所に DAR ファイルが出力されます。 xCP ア ー テ ィ フ ァ ク ト の パ ッ ケ ー ジ 化 TaskSpace アプリケーション外で xCP アーティファクトをパッケージ化すると、TaskSpace アプリケー ションを複数のプロジェクトに分割する場合に便利です。また、TaskSpace アプリケーション内の一 部の xCP アーティファクトを編集する場合にも役立ちます。Composer でも headless Composer でも、個々の xCP アーティファクトをパッケージ化できます。 50 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Composer と xCelerated Composition Platform Composer で の xCP ア ー テ ィ フ ァ ク ト の パ ッ ケ ー ジ 化 Composer UI を使用すると、パッケージ化対象のアーティファクトを選択できるため、xCP アーティ ファクトのパッケージ化を繰り返さずに一度のみ行う場合に便利です。このプロセスは、リポジト リからアーティファクトをインポートするプロセスと同様です。 Composer で xCP ア ー テ ィ フ ァ ク ト を パ ッ ケ ー ジ 化 す る に は 1. 目的のアーティファクトをインポートします (アーティファクトのインポート (28ページ) を参照)。 2. DAR インストーラまたは headless Composer でインストールする DAR ファイルを取得する場 合、次の手順のいずれかを実行します。 • [プロジェクト] > [Build Automatically (自動的にビルド)] オプションをオンにしている場 合、...\<workspace>\<project-name>\bin-dar ディレクトリから <project>.dar ファイルを取得 できます。 • [プロジェクト] > [Build Automatically (自動的にビルド)] オプションをオフにしている場合、 ビルドする TaskSpace プロジェクトを右クリックして、ドロップダウン リストから [Build Project (プロジェクトのビルド)] を選択します。 Composer によって TaskSpace プロジェクトがビルドされ、...\<workspace>\<project-name>\bin-dar ディレクトリに <project>.dar ファイルが生成されます。 headless Composer で の xCP ア ー テ ィ フ ァ ク ト の パ ッ ケ ー ジ化 headless Composer では、Ant タスクを使用して、プロジェクトを作成し、リポジトリから直接アーティ ファクトをインポートします。Ant タスクを使用すると、開発環境から運用環境または QA 環境に xCP アプリケーションを自動的に移行する際に役立ちます。次の手順では、リポジトリ内の既存の xCP アプリケーションを Composer プロジェクトにパッケージ化する方法を示します。また、別のシ ステムにデプロイ可能な DAR ファイルを生成する方法も説明します。 headless Composer で xCP ア ー テ ィ フ ァ ク ト を パ ッ ケ ー ジ 化 す る に は 1. ビルド用ファイルの格納場所としてビルド ディレクトリを作成します。 2. ビルド ディレクトリで、build.xml という名前のファイルを作成します。このファイルを編集す るために開きます。 3. build.xml ファイル内に emc.createArtifactsProject タスクを使用して Composer プロジェクトを作 成するターゲットを作成します。 4. emc.importArtifacts タスクを使用して、目的の xCP アーティファクトをプロジェクトにイン ポートするターゲットを作成します。 5. emc.build タスクを使用して、プロジェクトをビルドするターゲットを作成します。emc.dar タスクの 前にこのタスクを呼び出し、作成された最新のコードが DAR ファイルに含まれるようにします。 6. emc.dar タスクを使用して、DAR ファイルを生成するターゲットを作成します。次のスクリプト は、例のプロジェクトについて Ant ターゲットを作成する方法を示しています。環境に合わせ て、スクリプト上部のプロパティ値を変更できます。 <?xml version="1.0"?> <project name="xCPBuild"> <property name="project.name" value="project_name" /> <property name="repository" value="repository" /> EMC Documentum Composer バージョン 7.2 ユーザ ガイド 51 Composer と xCelerated Composition Platform <property name="username" value="username" /> <property name="password" value="password" /> <property name="artifact.path" value="/System/Applications/app_name/artifact_name" /> <property name="dar.filename" value="myDAR.dar" /> <target name ="create-project" description="Create a project to import artifacts into"> <emc.createArtifactProject name="${project.name}" overwrite="true"> </emc.createArtifactProject> </target> <target name ="import-project" description=" Must import a project before updating, building, or installing it"> <emc.importProject dmproject="HelloWorldArtifacts" failonerror="true"/> </target> <target name="import-artifacts"> <emc.importArtifacts project="${project.name}" docbase="${repository}" username="${username}" password="${password}"> <objectIdentities> <path value="${artifact.path}"/> </objectIdentities> </emc.importArtifacts> </target> <target name="build-project" description="Build the project"> <emc.build dmproject="${project.name}" failonerror="true"/> </target> <target name="package-project" description="Package the project into a DAR for installation"> <delete file="${dar.filename}" /> <emc.dar dmproject="${project.name}" manifest="bin/dar/default.dardef.artifact" dar="${dar.filename}" /> </target> </project> 7. ビルドを実行するバッチ ファイル build.bat を作成します。このバッチ ファイルにより、Composer ワークスペースを設定し、Ant スクリプトを呼び出します。Ant スクリプトを呼び出す際には、例 に示すとおり正しい順序でターゲットを呼び出します。ターゲットの実行順序を保持することが 重要です。一般には、Composer プロジェクトを作成し、そのプロジェクトにアーティファクトをイ ンポートしてプロジェクトをビルドしてから、DAR ファイルを生成します。次のバッチ ファイル は、例の build.xml の Ant スクリプトを実行する方法を示しています。 REM Set environment variables to apply to this command prompt only SETLOCAL REM Sets the root location of headless Composer SET ECLIPSE="C:\ComposerHeadless" REM Sets the workspace directory where Composer builds the projects REM that you want to install to a repository SET BUILDWORKSPACE=".\build_workspace" 52 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Composer と xCelerated Composition Platform REM Sets the Ant script that builds your projects SET BUILDFILE=".\build.xml" REM Delete old build and installation workspaces RMDIR /S /Q %BUILDWORKSPACE% REM Run Ant scripts to build the project. REM The JAVA command must be on one line. JAVA -cp %ECLIPSE%\startup.jar org.eclipse.core.launcher.Main -data %BUILDWORKSPACE% -application org.eclipse.ant.core.antRunner -buildfile %BUILDFILE% create-project import-artifacts build-project package-project build.bat ファイルの実行が完了すると、${dar.filename} プロパティに指定した場所に DAR ファイ ルが生成されます。DAR インストーラでも headless Composer でも、DAR をデプロイできます。 TaskSpace ア プ リ ケ ー シ ョ ン と xCP ア ー テ ィ フ ァ ク ト のインストール TaskSpace アプリケーションと xCP アーティファクトのインストールは、他の Composer プロジェクト と同様のプロセスです。Composer UI を使用して Composer プロジェクトをインストールするか、 DAR インストーラを使用して DAR ファイルをインストールするか、headless Composer を使用して Composer プロジェクトと DAR ファイルをインストールします。 Composer で の TaskSpace ア プ リ ケ ー シ ョ ン と xCP ア ー ティファクトのインストール TaskSpace アプリケーションをプロジェクトとして Composer に正常にインポートした後には、 Composer を使用してそのプロジェクトをリポジトリにインポートします。このプロセスは、他 の Composer プロジェクトをインストールする場合と同じです (プロジェクトのインストール (206 ページ) を参照)。 DAR イ ン ス ト ー ラ で の TaskSpace ア プ リ ケ ー シ ョ ン と xCP アーティファクトのインストール TaskSpace アプリケーションの DAR ファイルや xCP の DAR ファイルについては、DAR インス トーラを使用してインストールできます。このプロセスは、他の Composer DAR ファイルをインス トールする場合と同じです (DAR インストーラでの DAR ファイルのインストール (211ページ) を 参照)。インストール時に DAR ファイルと同じディレクトリに TCMReferenceProject.dar ファイ ルをコピーする必要はありません。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 53 Composer と xCelerated Composition Platform headless Composer で の TaskSpace ア プ リ ケ ー シ ョ ン と xCP アーティファクトのインストール headless Composer で TaskSpace アプリケーションや xCP アーティファクトをデプロイするには、 そのアプリケーションやアーティファクトを DAR ファイルにパッケージ化します (次のセクショ ンの説明を参照)。 • Composer での TaskSpace アプリケーションのパッケージ化 (48ページ) • headless Composer での TaskSpace アプリケーションのパッケージ化 (49ページ) • Composer での xCP アーティファクトのパッケージ化 (51ページ) • headless Composer での xCP アーティファクトのパッケージ化 (51ページ) Composer プロジェクトから DAR ファイルをビルドした場合、emc.install タスクを使用してその DAR ファイルをインストールできます。 headless Composer で xCP ア ー テ ィ フ ァ ク ト を デ プ ロ イ す る に は 1. ビルド用ファイルの格納場所としてビルド ディレクトリを作成します。 2. install.xml という名前のファイルを作成します。 3. emc.install タスクを使用して、DAR ファイルをインストールするターゲットを作成します。次のス クリプトは、emc.install タスクの宣言方法の例です。 <?xml version="1.0"?> <project name="headless-install"> <property <property <property <property name="repository" value="repository" /> name="username" value="username" /> name="password" value="password" /> name="dar.filename" value="myDAR.dar" /> <target name="install-project" description="Install the project to the specified repository. dfc.properties must be configured"> <emc.install dar="${dar.filename}" docbase="${repository}" username="${username}" password="${password}" domain="" /> </target> </project> 4. インストール スクリプトを実行するバッチ ファイル install.bat を作成します。このバッチ ファイル により、Composer ワークスペースを設定し、Ant スクリプトを呼び出します。Ant スクリプトを呼 び出す際には、例に示すとおり正しい順序でターゲットを呼び出します。次のバッチ ファイル は、例の install.xml の Ant スクリプトを実行する方法を示しています。 REM Set environment variables to apply to this command prompt only SETLOCAL REM Sets the root location of headless Composer SET ECLIPSE="C:\ComposerHeadless" 54 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Composer と xCelerated Composition Platform REM Sets the workspace directory where Composer extracts built DAR files REM before installing them to a repository SET INSTALLWORKSPACE=".\install_workspace" REM Sets the Ant script that builds your projects SET INSTALLFILE=".\install.xml" REM Delete old build and installation workspaces RMDIR /S /Q %INSTALLWORKSPACE% REM Run Ant scripts to install the project REM The JAVA command must be on one line. JAVA -cp %ECLIPSE%\startup.jar org.eclipse.core.launcher.Main -data %INSTALLWORKSPACE% -application org.eclipse.ant.core.antRunner -buildfile %INSTALLFILE% install-project headless Composer を 使 用 し た 、 xCP ア ー テ ィ フ ァ ク ト を す で に 含 む Composer プ ロ ジ ェ ク ト の ビ ル ド と イ ンストール xCP アーティファクトがすでに含まれている Composer プロジェクトについて、プロジェクトのビルド とデプロイを行う場合、headless Composer を使用すると、この手順を自動化できます。 xCP ア ー テ ィ フ ァ ク ト が 含 ま れ て い る Composer プ ロ ジ ェ ク ト を ビ ル ド お よ び デ プ ロ イ す る に は 1. ビルド用ファイルの格納場所としてビルド ディレクトリを作成します。 2. ビルド ディレクトリで、build.xml という名前のファイルを作成します。このファイルを編集す るために開きます。 3. build.xml ファイル内に emc.import タスクを使用して xCP アーティファクトが含まれている Composer プロジェクトをインポートするターゲットを作成します。 4. emc.build タスクを使用して、プロジェクトをビルドするターゲットを作成します。emc.dar タスクの 前にこのタスクを呼び出し、作成された最新のコードが DAR ファイルに含まれるようにします。 5. emc.dar タスクを使用して、DAR ファイルを生成するターゲットを作成します。emc.install タスク の前にこのタスクを呼び出し、emc.build タスクから作成されたコードが新しい DAR ファイル に含まれるようにします。 6. emc.install タスクを使用して、DAR ファイルをインストールするターゲットを作成します。次のス クリプトは、例のプロジェクトについて Ant ターゲットを作成する方法を示しています。環境に 合わせて、スクリプト上部のプロパティ値を変更できます。 <?xml version="1.0"?> <project name="xCPBuild"> <property name="project.name" value="project_name" /> <property name="repository" value="repository" /> <property name="username" value="username" /> <property name="password" value="password" /> <property name="dar.filename" value="myDAR.dar" /> <target name ="import-project" description=" Must import a project before updating, building, or installing it"> EMC Documentum Composer バージョン 7.2 ユーザ ガイド 55 Composer と xCelerated Composition Platform <emc.importProject dmproject="${project.name}" failonerror="true"/> </target> <target name="build-project" description="Build the project"> <emc.build dmproject="${project.name}" failonerror="true"/> </target> <target name="package-project" description="Package the project into a DAR for installation"> <delete file="${dar.filename}" /> <emc.dar dmproject="${project.name}" manifest="bin/dar/default.dardef.artifact" dar="${dar.filename}" /> </target> <target name="install-project" description="Install the project to the specified repository. dfc.properties must be configured"> <emc.install dar="${dar.filename}" docbase="${repository}" username="${username}" password="${password}" domain="" /> </target> </project> 7. ビルドを実行するバッチ ファイル build.bat を作成します。このバッチ ファイルにより、Composer ワークスペースを設定し、Ant スクリプトを呼び出します。Ant スクリプトを呼び出す際には、例 に示すとおり正しい順序でターゲットを呼び出します。ターゲットの実行順序を保持することが 重要です。一般には、Composer プロジェクトを作成し、そのプロジェクトにアーティファクトをイ ンポートしてプロジェクトをビルドしてから、DAR ファイルを生成します。次のバッチ ファイル は、例の build.xml の Ant スクリプトを実行する方法を示しています。 REM Set environment variables to apply to this command prompt only SETLOCAL REM Sets the root location of headless Composer SET ECLIPSE="C:\ComposerHeadless" REM Sets the location of your source projects. REM This location gets copied into your build workspace directory SET PROJECTSDIR="C:\Documents and Settings\Administrator\composer-workspace" REM Sets the workspace directory where Composer builds the projects REM that you want to install to a repository SET BUILDWORKSPACE=".\build_workspace" REM Sets the workspace directory where Composer extracts built DAR files REM before installing them to a repository SET INSTALLWORKSPACE=".\install_workspace" REM Sets the Ant script that builds your projects SET BUILDFILE=".\build.xml" REM Delete old build and installation workspaces 56 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Composer と xCelerated Composition Platform RMDIR /S /Q %BUILDWORKSPACE% RMDIR /S /Q %INSTALLWORKSPACE% REM Copy source projects into build workspace XCOPY %PROJECTSDIR% %BUILDWORKSPACE% /E REM Run Ant scripts to build and install the projects REM Each JAVA command must be on one line. JAVA -cp %ECLIPSE%\startup.jar org.eclipse.core.launcher.Main -data %BUILDWORKSPACE% -application org.eclipse.ant.core.antRunner -buildfile %BUILDFILE% import-project build-project package-project JAVA -cp %ECLIPSE%\startup.jar org.eclipse.core.launcher.Main -data %INSTALLWORKSPACE% -application org.eclipse.ant.core.antRunner -buildfile %BUILDFILE% install-project ソ ー ス 環 境 か ら タ ー ゲ ッ ト 環 境 へ の TaskSpace ア プ リ ケ ー シ ョ ン ま た は xCP ア ー テ ィ フ ァ ク ト の 移 行 Documentum Composer では、TaskSpace アプリケーションまたは個々の xCP アーティファクトを ソース環境からターゲット環境に移行できます。この手順が有効となるのは、ソース環境とター ゲット環境にその環境固有の xCP スタック (Content Server、プロセス エンジン、TaskSpace、 Composer など) が含まれている場合のみです。この状況の例として、プロジェクトを開発環境から 運用環境に移行する場合が挙げられます。 注 記: この手順は、TaskSpace アプリケーションまたは xCP アーティファクトを D6.5 SP2 環境から D6.6 またはそれ以降の環境に移行する場合に実行してください。 ソ ー ス 環 境 上 で の TaskSpace ア プ リ ケ ー シ ョ ン ま た は xCP アーティファクトのパッケージ化 アプリケーションのパッケージ化は、アーティファクトを Composer DAR ファイルに組み込む作 業を伴います。 この手順を開始する前に、次の前提条件を満たす必要があります。 • ターゲット環境は、バージョン 6.6 以降である必要があります。 • ソース環境のバージョンが 6.6 より前であっても、Composer バージョン 6.6 以降をインストー ルする必要があります。ベスト プラクティスとして、パッケージ化とデプロイの両方について 同じバージョンの Composer を使用します。 • dfc.properties ファイルが有効なコネクション ブローカを指す必要があります。このファイルは、 <Composer_root>\plugins\com.emc.ide.external.dfc_1.0.0\documentum.config フォルダにありま す。接続ブローカの設定方法の詳細については、コネクション ブローカの設定 (14ペー ジ) を参照してください。 TaskSpace ア プ リ ケ ー シ ョ ン を 移 行 す る に は 、 DAR と し て パ ッ ケ ー ジ 化 し ま す 。 1. Composer バージョン 6.6 を起動して、ワークスペースを作成します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 57 Composer と xCelerated Composition Platform 2. TaskSpace アプリケーションから Composer プロジェクトを作成します (Composer での TaskSpace アプリケーションのパッケージ化 (48ページ) を参照)。個々の xCP アーティファクトを移行する には、アーティファクトのインポート (28ページ) の説明に従ってそれらをインポートします。 3. フォルダや個々のドキュメントなど、移行するサンプル コンテンツがある場合、それらを個別に インポートします (アーティファクトのインポート (28ページ) を参照)。 プロジェクトは、Composer によって自動的に DAR ファイルに組み込まれます。ユーザは、 この DAR ファイルを使用してターゲット リポジトリへのインストールを行うことができます。 DAR ファイルは、<workspace_root>/<project_name>/bin-dar ディレクトリにあります。DAR ファ イルが見つからない場合は、DAR ファイルの生成 (205ページ) セクションで DAR ファイル の生成方法を確認してください。 4. ソース環境がターゲット環境と通信できない場合は、Composer プロジェクト ディレクトリ (<workspace_root>/<project_name>) 全体を圧縮した zip ファイルを作成し、このファイル をターゲット環境に転送します。 注記: パフォーマンスを向上させるには、Composer プロジェクト ディレクトリをターゲット環境に 転送して、インストール時間を減らします。 タ ー ゲ ッ ト リ ポ ジ ト リ 上 で の TaskSpace ア プ リ ケ ー シ ョ ン ま た は xCP ア ー テ ィ フ ァ ク ト の デ プ ロ イ DAR ファイルの準備ができたら、ターゲット環境にデプロイします。この手順を開始するには、事 前に Composer バージョン 6.7 をインストールする必要があります。 TaskSpace ア プ リ ケ ー シ ョ ン ま た は xCP ア ー テ ィ フ ァ ク ト を デ プ ロ イ す る に は 1. Composer プロジェクトの zip ファイルをターゲット環境に転送した場合 a. TaskSpace アプリケーションまたは xCP アーティファクトを含む Composer プロジェクト を、選択したディレクトリに解凍します。 b. <Composer_project>/bin-dar/<xCP_app>.dar を、選択したディレクトリにコピーします。 2. <Composer_root>\dardeployer.exe を実行します。 3. DAR インストーラを使用して、DAR ファイルをインストールします。 4. TaskSpace アプリケーションを移行する場合 a. TaskSpace 管 理 者 の ユ ー ザ 名 と パ ス ワ ー ド を 使 用 し て http://host:port/Taskspace/?appname=<TaskSpace_app_name> に移動し、TaskSpace アプリ ケーションにアクセスします。 b. [管理] タブに移動します。 c. 必要に応じてユーザを作成します。 d. TaskSpace アプリケーション内のロールにユーザを割り当てます。 トラブルシューティングのヒント ターゲット環境の TaskSpace アプリケーションにアクセスしようとしたときにプリセット関連のエラー が発生した場合、インストールが正しく行われていません。 プリセット エラーを修正するには 58 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Composer と xCelerated Composition Platform 1. Documentum Administrator にログインします。 2. System/Applications/<TaskSpace_application> フォルダに移動します。 3. 次のアーティファクトの所有者が dmc_wdk_presets_owner であることを確認します。 • プリセット • Presets/TaskSpace_App.definition • Presets/TaskSpace_Role.definition • Presets/Preset Packages • Presets/Preset Packages フォルダ内のファイル EMC Documentum Composer バージョン 7.2 ユーザ ガイド 59 Composer と xCelerated Composition Platform 60 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 5 章 Web Services の 管 理 この章では、次について説明します。 • Web サ ー ビ ス • DFS モ ジ ュ ー ル オ プ シ ョ ン の 設 定 • DFS サ ー ビ ス ラ イ ブ ラ リ を 設 定 す る に は • サービス カタログの設定 • Web サ ー ビ ス の 表 示 • クライアント プロキシの生成 • サービスの使用 • サービスの作成 • カタログおよびカテゴリに関する情報の変更 • サービスの発行 • サービスの発行停止 • サービスのエクスポート • サービスのデプロイ Web サ ー ビ ス Web サービスは、ネットワークを介した、相互運用可能なマシン間の通信をサポートするように 設計されたソフトウェア システムです。Web サービスは多くの場合、インターネットなどのネッ トワーク経由でアクセスされる Web API であり、要求されたサービスをホストするリモート シ ステム上で実行されます。 Composer では、EMC DFS (Documentum Foundation Services) レジストリ プラグインを提供すること で Web サービスがサポートされます。プラグインによって、ユーザは次の操作ができます。 • Web サービス レジストリに接続する。 • WSDL をインポートして Java クライアント ライブラリを作成する。 • サービスを作成する。 • サービスを EAR ファイルにエクスポートする。 Composer には、個々の新規 Documentum プロジェクト 用の DFS Services ライブラリおよび DFS Builder が含まれています。DFS Builder と DFS サービス ライブラリは、プロジェクトのプ ロパティで設定できます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 61 Web Services の管理 DFS モ ジ ュ ー ル オ プ シ ョ ン の 設 定 プロジェクトの DFS のコンテキスト ルートとモジュール名は、[DFS モジュール] ダイアログ ボッ クスで設定します。 DFS モ ジ ュ ー ル オ プ シ ョ ン を 設 定 す る に は 1. プロジェクトを右クリックし、ドロップダウン リストから [プロパティ] を選択します。 [プロパティ: <プロジェクト名>] ダイアログ ボックスが表示されます。 2. [Documentum プロジェクト] を展開し、[DFS モジュール] を選択します。 [DFS モジュール] ダイアログ ボックスが表示されます。 3. DFS のコンテキスト ルートとモジュール名を [コンテキスト ルート] フィールドと [DFS モジュー ル名] フィールドに入力します。 4. [OK] をクリックします。 DFS サ ー ビ ス ラ イ ブ ラ リ を 設 定 す る に は Composer では、プロジェクトで使用する DFS サービス ライブラリを選択できます。DFS サービス ラ イブラリは、プロジェクト プロパティで設定します。デフォルトで Composer に搭載されているのは 1 つの DFS サービス ライブラリですが、複数の DFS サービス ライブラリをサポートできます。 DFS サ ー ビ ス ラ イ ブ ラ リ を 設 定 す る に は 1. プロジェクトを右クリックし、ドロップダウン リストから [プロパティ] を選択します。 [プロパティ: <プロジェクト名>] ダイアログ ボックスが表示されます。 2. [Java のビルド パス] を選択します。 [Java のビルド パス] ダイアログ ボックスが表示されます。 62 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Web Services の 管 理 3. [ライブラリ] タブをクリックして、リスト ボックスから[DFS サービス ライブラリ] を選択し、[編 集] をクリックします。 [DFS サービス ライブラリ] ダイアログ ボックスが表示されます。 4. 追加する DFS ライブラリのタイプを選択し、[終了] をクリックします。 サービス カタログの設定 サービス カタログ接続オプションは、[設定] ダイアログ ボックスで設定します。 サービス カタログを設定するには EMC Documentum Composer バージョン 7.2 ユーザ ガイド 63 Web Services の管理 1. Composer のメイン メニューで、[ウィンドウ] > [設定] を選択します。 [設定] ダイアログ ボックスが表示されます。 2. [設定] リストで、[Documentum] をダブルクリックし、[サービス カタログ] を選択します。 [サービス カタログ] ダイアログ ボックスが表示されます。 [サービス レジストリ] テーブルに現在設定されているサービスが一覧表示されます。 3. 別のサービス レジストリを設定するには、[追加] をクリックします。 [サービス レジストリ] ダイアログ ボックスが表示されます。 4. 次の表の説明に従って、サービス レジストリの設定パラメータを入力します。 64 プロパティ 説明 レジストリ エイリアス サービス レジストリの名前を指定する文字列。 取得 URL サービスをホストするサーバの URL を指定する文字列。URL は、http://<domain>:<port>/catalog/inquiry のフォーマットで ある必要があります。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Web Services の 管 理 プロパティ 説明 発行 URL サービスの発行先となるサーバの URL を指定する文字列。 URL は、format http://<domain>:<port>/catalog/publish の フォーマットである必要があります。 ユーザ名 サービスをホストするサーバのログイン名。 パスワード サービスをホストするサーバのパスワード。 サービスを取得 このサービス レジストリ内のサービスを [サービス カタログ] ダ イアログ ボックスに表示する場合に選択します。 Web サ ー ビ ス の 表 示 Composer では、Web サービスとそれに関連するアクションのすべては、個別のパースペクティブ である [Documentum ソリューション] パースペクティブに表示されます。 使 用 可 能 な Web サ ー ビ ス を 表 示 す る に は 1. Composer のメイン メニューで、[ウィンドウ] > [パースペクティブを開く] > [その他...] に移 動します。 [パースペクティブを開く] ダイアログ ボックスが表示されます。 2. [Documentum ソリューション] を選択し、[OK] をクリックします。 [マイ サービス] タブと [サービス カタログ] タブが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 65 Web Services の管理 [サービス カタログ] タブには、そのサーバに設定されているすべてのサービス カタログとサー ビスが表示されます。[マイ サービス] タブには、インポートされた、または作成されたサービス が表示されます。Documentum Services Catalog Repository をインストールした場合、インストー ルの一部として Documentum サービスが自動的に発行されることはありません。Composer で サービスを表示するには、サービスをカタログに発行する必要があります。サービスが発行さ れていない場合、Composer ではサービスが表示されません。 3. Web サービスを表示するには、カタログを展開し、サービスの詳細を表示するサービス をダブルクリックします。 サービスの詳細が、[全般] タブが選択された状態で表示されます。 4. [処理] タブをクリックすると、サービス メソッドが表示されます。 サービスのフィルタ サービス フィルタを使用し、[サービス カタログ] タブに表示するサービスを指定します。 サービスをフィルタするには 1. [Documentum ソリューション] パースペクティブで、[サービス カタログ] タ ブ の 下 に あ る 検 索アイコン ( ) をクリックします。 [サービス検索] ダイアログ ボックスが表示されます。 2. [次を使用するフィルタ カタログ サービス] を選択し、検索条件を入力します。[組織名]、 [サービス名]、[カタログ名]、[カテゴリ名] でフィルタできます。 3. [OK] をクリックします。 66 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Web Services の 管 理 検索条件と一致するサービスが [カタログ サービス] ビューに表示されます。 クライアント プロキシの生成 [サービス カタログ] タブの [インポート] オプションを使用することで、サービスのクライアント プロキ シを生成し Composer プロジェクトで使用することが可能になります。 サービスのクライアント プロキシを生成するには 1. [サービス カタログ] ビューで、クライアント プロキシを生成するサービスを右クリックし、[イ ンポート] を選択します。 [サービスのインポート] ダイアログ ボックスが表示されます。 2. クライアント プロキシを生成するプロジェクトを入力するか、ドロップダウン リストからプロ ジェクトを選択して、[OK] をクリックします。 クライアント プロキシがプロジェクトにインポートされます。[マイ サービス] タブにサービス 名が表示されます。 [Documentum Navigator] ビューにあるプロジェクトの [Web Services] フォルダにサービス の JAR ファイルと WSDL が表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 67 Web Services の管理 サービスの使用 サービスを使用するには、クライアント プロキシの生成 (67ページ) の説明に従ってサービスのクラ イアント プロキシをインポートし、サービスを呼び出すコードを作成します。 次のコード例は、サービスの呼び出し方法を示しています。この例のカスタム コードは、太 字で強調表示された try ブロックだけです。 package com.acme.loanapp.services; import import import import import com.emc.documentum.fs.datamodel.core.context.RepositoryIdentity; com.emc.documentum.fs.rt.context.ContextFactory; com.emc.documentum.fs.rt.context.IServiceContext; com.emc.documentum.fs.rt.context.ServiceFactory; com.emc.services.ws.client.soap.*; public class AcmeLoanServiceOrchestration { public static void main(String [ ] args) { RepositoryIdentity m_theId = new RepositoryIdentity(); m_theId.setRepositoryName("D65Docbase"); m_theId.setUserName("dfsuser"); m_theId.setPassword("dfs"); //completion point ’get context’ IServiceContext context = ContextFactory.getInstance().newContext(); ServiceFactory sf = ServiceFactory.getInstance(); context.addIdentity(m_theId); try { ’ //completion point ’instantiate services’ IWorkflowService qSvc = sf.getRemoteService(IWorkflowService.class, context, "core", "http://localhost:9080/services"); qSvc.start("ProcessLoanApplication"); } catch (Exception e) { 68 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Web Services の 管 理 System.out.println("An exception has occured: " + e); } } } サービスの作成 サービスは、Java ファイルから作成するか、またはクライアント プロキシの WSDL ファイルか ら生成します。 Java フ ァ イ ル か ら の サ ー ビ ス の 作 成 サービスを作成するには、[Package Explorer] ビューに移動します。 注記: このガイドでは、サービスの Java ファイルの作成方法についてのみ説明し、サービスの開発 方法については説明しません。DFS サービスの開発方法については、『Documentum Foundation Services Development Guide (Documentum Foundation Services 開発ガイド)』を参照してください。 Java フ ァ イ ル か ら サ ー ビ ス を 作 成 す る に は 1. [ウィンドウ] > [ビューの表示] > [Package Explorer] を選択して、[Package Explorer] ビュー に移動します。 2. Web Service/src ディレクトリにサービスの Java パッケージを作成します。 a. Web Services/src ディレクトリを右クリックし、[新規作成] > [パッケージ] を選択します。 [新規 Java パッケージ] ダイアログ ボックスが表示されます。 b. Java パッケージの名前 (たとえば、com.emc.services) を入力し、[終了] をクリックします。 3. Java クラスを作成します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 69 Web Services の管理 a. 作成した Java パッケージを右クリックし、[新規作成] > [クラス] を選択します。 [新規 Java クラス] ダイアログ ボックスが表示されます。 b. Java クラスの名前 (たとえば、TestService) を入力し、含めるメソッドを選択して、[終了] をク リックします。 ワークスペースに Java ファイルが表示されます。 c. サービスを指定するコードを記述します。DFS サービスの開発の詳細については、 『 Documentum Foundation Services Development Guide (Documentum Foundation Services 開発ガイド)』を参照してください。 d. 変更を保存します。 [未分類] の下にある [Documentum ソリューション] パースペクティブの [マイ サービス] タブに新しいサービスが表示されます。 WSDL か ら の サ ー ビ ス の 作 成 サービスは、WSDL ファイルから直接作成します。 WSDL か ら サ ー ビ ス を 作 成 す る に は 1. [Documentum Navigator] ビューのプロジェクトの [Web Services] フォルダに移動します。 2. サービスを生成する WSDL を右クリックし、ドロップダウン メニューから [サービスの作成] を選択します。 [サービスの作成] ダイアログ ボックスが表示されます。 70 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Web Services の 管 理 3. サービスを作成するプロジェクトの名前を入力するか、ドロップダウン リストからプロジェクトを 選択して、[OK] をクリックします。 プロジェクトの [Web Services] フォルダの /src ディレクトリにサービスの Java ファイルが表示さ れます。 カタログおよびカテゴリに関する情報の変更 初めてサービスを作成する際にJava ファイルからのサービスの作成 (69ページ) の説明に従うと、 [マイ サービス] タブにある [未分類] のカタログおよびカテゴリの下にサービスが表示されます。 サービスのカタログ名およびカテゴリは、サービス エディタで変更できます。 サービスのカタログおよびカテゴリを作成するには 1. [マイ サービス] タブのサービスを右クリックし、[開く] を選択します。 [サービスエディタ] が表示されます。 2. 次の表の説明に従って、[全般] セクションおよび [分類] セクションにサービスに関する 情報を入力します。 プロパティ 説明 全般 名前 サービスの名前。 説明 サービスの説明。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 71 Web Services の管理 プロパティ 説明 発行用にマーク このサービスを発行できるかどうかを指定します。このオプ ションはデフォルトで有効になっています。 分類 カタログ カタログの名前。[追加] をクリックして新しいカタログ エントリ を追加し、[カタログ] 列のフィールドを選択して変更します。 カテゴリ カタログ カテゴリの名前。[追加] をクリックして新しいカテゴ リ エントリを追加し、[カテゴリ] 列のフィールドを選択して 変更します。 3. 変更を保存します。 新しいまたは変更したカタログ名とカテゴリが [マイ サービス] タブに表示されます。 サービスの発行 レジストリにサービスを発行するには、[サービスの発行] ダイアログ ボックスを使用します。 サービスを発行するには 1. [Documentum ソリューション] パースペクティブに切り替え、[マイ サービス] タブに発行 するサービスを探します。 2. サービスを右クリックし、ドロップダウン リストから [発行] を選択します。 [サービスの発行] ダイアログ ボックスが表示されます。 3. 次の表の説明に従って発行情報を入力し、[OK] をクリックします。 72 プロパティ 説明 レジストリ サービスの発行先となるレジストリのエイリアス。ドロップダウン リストからレジストリを選択します。 組織名 サービスが存在する組織の名前。 DFS サーバの URL DFS サーバの URL。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Web Services の 管 理 プロパティ 説明 コンテキスト ルート サービス アドレスのルートを指定します。たとえば、 https://127.0.0.1:7001/services/core という URL では、services がコンテキスト ルートになります。 モジュール名 サービス モジュールの名前を指定します。たとえば、 https://127.0.0.1:7001/services/core という URL では、core がモ ジュール名になります。 4. [サービス カタログ] をクリックし、ビューを更新します。 サービスが正常に発行されると、[サービス カタログ] リストにそのサービスが表示されます。 サービスの発行停止 サービスを発行停止すると、そのサービスは、DFS サーバで使用できなくなり、レジストリのクエリ に表示されなくなります。 サービスを発行停止するには 1. [サービス カタログ] ビューで、サービスを右クリックし、[発行停止] を選択します。 [サービスの発行停止] ダイアログ ボックスが表示されます。 2. [OK] をクリックすると、サービスが発行停止されます。 サービスは、[サービス カタログ] ビューに表示されなくなります。 サービスのエクスポート サービスをエクスポートすると、アーカイブ EAR ファイル、ランタイム リソースを含む JAR、およ びオプションのマニフェスト XML ファイルが生成されます。 サービスをエクスポートするには 1. [Documentum Navigator] ビューまたは [Package Explorer] ビューで、サービスが含まれる プロジェクトを右クリックします。 2. [エクスポート] > [Documentum] > [サービス アーカイブのエクスポート] に移動し、[次へ] をク リックします。 [サービス アーカイブのエクスポート] ダイアログ ボックスが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 73 Web Services の管理 3. 次の表の説明に従ってサービスのエクスポートに関する情報を入力し、[終了] をクリックします。 プロパティ 説明 アーカイブ名 アーカイブ EAR ファイルの名前。ファイルのフォーマット は <archive name>.ear です。 コンテキスト ルート サービス アドレスのルートを指定します。たとえば、 https://127.0.0.1:7001/services/core という URL では、services がコンテキスト ルートになります。 エクスポート先 EAR ファイルを保存するローカル マシンまたはネットワーク ド ライブ上のロケーション。[選択] をクリックし、EAR ファイルを 保存するロケーションを参照できます。 エクスポート用のサービス エクスポートするサービスを選択します。 ランタイム ライブラリ EAR ファイルに含まれ、その EAR ファイルとともにエクス ポートされる JAR。 [追加] をクリックして、Composer ワークスペースから JAR ファ イルを追加します。[外部 JAR の追加] をクリックして、ローカ ル ファイル システムから JAR ファイルを追加します。 ランタイム リソース 74 アーカイブ EAR ファイルに含まれ、その EAR ファイルととも にエクスポートされるランタイム リソース。ランタイム リソースは JAR ファイルにパッケージ化されます。[選択] をクリックし、エ クスポートするリソースを選択します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Web Services の 管 理 プロパティ 説明 発行マニフェストの生成 EAR ファイルとともにマニフェスト XML ファイルをエクスポー トする場合は、このオプションを選択します。マニフェスト ファ イルのフォーマットは <archive name>-publish-manifest.xml です。 組織名 サービスを作成した組織の名前。 Composer は、アーカイブ EAR ファイル、ランタイム リソース JAR ファイル、およびマニフェス ト ファイルをエクスポート先で作成します。 サービスのデプロイ サービスをエクスポートし、EAR ファイルを生成したら、EAR ファイルを DFS サーバにコピーして サービスをデプロイします。 サービスをデプロイするには 1. サービスのエクスポート (73ページ) の説明に従って、デプロイするサービスの EAR ファ イルを生成します。 2. EAR ファイルを DFS サーバのサービス ディレクトリにコピーします。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 75 Web Services の管理 76 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 6 章 エイリアス セットの管理 この章では、次について説明します。 • エイリアス、エイリアス値、およびエイリアス セット • エイリアス セットの作成 • エイリアス値の設定 エイリアス、エイリアス値、およびエイリアス セット Documentum アプリケーションのアスペクトの多くには、特定のユーザ、グループ、アクセス権 セット、リポジトリ キャビネットやフォルダへの参照が含まれています。実際のユーザ、グループ、 キャビネット、またはフォルダの名前を参照する代わりに、エイリアス (記号名) を割り当てること ができます。記号名は、エイリアス名と呼ばれます。また、実際の値はエイリアス値と呼ばれま す。エイリアスの集合がエイリアス セットです。 エイリアス セットの作成 エイリアス セットを作成するには、エイリアス セット エディタを使用します。 エイリアス セットを作成するには 1. Composer プロジェクトで、[Artifacts] フォルダを展開し、[エイリアス セット] を右クリックする。 [新規作成] > [エイリアス セット] を選択します。 [新しいエイリアス セット] ダイアログ ボックスが表示されます。 2. エイリアス セットを作成するプロジェクトのフォルダ パスとプロジェクト名を [フォルダ] フィール ドに入力するか、[参照] をクリックしてフォルダ リストからプロジェクトを選択します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 77 エイリアス セットの管理 3. エイリアス セットのファイル名を [アーティファクト名] フィールドに入力し、[終了] をクリッ クします。 エイリアス セット エディタが表示されます。 4. エイリアス セットの名前を [名前] フィールドに入力し、必要であれば [説明] フィールドに 説明を入力します。 5. [エイリアス] セクションの [追加] をクリックして、エイリアス セットを構成する 1 つまたは複数の エイリアスを作成します。 [新しいエイリアス] ダイアログ ボックスが表示されます。 6. [名前] フィールドに新しいエイリアスの名前を入力し、[タイプ] ドロップダウン リストからタイプ を選択します。次のエイリアス タイプのエイリアスを作成できます。 • 不明 • ユーザ • グループ • ユーザまたはグループ • キャビネット パス • キャビネットまたはフォルダ パス • アクセス権セット エイリアス値の設定 (79ページ) で、各エイリアス タイプに関連付けられるパラメータについ て説明します。 7. 設定が終わったら [OK] をクリックします。 78 EMC Documentum Composer バージョン 7.2 ユーザ ガイド エイリアス セットの管理 [エイリアスの詳細] セクションが表示されます。 8. 次の表の説明に従って、[エイリアスの詳細] セクションにエイリアスの詳細を入力します。 プロパティ 説明 名前 エイリアスの名前を表す文字列。 タイプ エイリアスを使用する対象のタイプを指定します。 値 エイリアスのパラメータと値を指定します。[新しいエイリアス] ダイアログ ボックスの [タイプ] フィールドで指定したエイリ アスに応じて、[値] セクションで使用可能なパラメータと値 のオプションは異なります。 エイリアス値の設定 (79ページ) で、各エイリアス タイプに関 連付けられるパラメータについて説明します。 カテゴリ エイリアス カテゴリは、開発者がアプリケーションでエイリアス を編成するために使用します。Documentum ソフトウェアでは このフィールドは使用しません。 説明 カテゴリの説明 (オプション)。 9. 変更を保存します。 エイリアス値の設定 エイリアスに設定できるパラメータと値は、[エイリアスの詳細] セクションの [タイプ] フィールドで指 定したエイリアスのタイプによって異なります。次の表に、各エイリアス タイプに関連付けられ るパラメータについて説明します。 エイリアス タイプ 不明 値オプション 説明 不明なエイリアス タイプには値を割り当てることができ ません。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 79 エイリアス セットの管理 エイリアス タイプ 値オプション 説明 ユーザ • 空白のままにする パラメータを割り当てるには、[パラメータ] をクリックし、 [選択] をクリックします。[ユーザ インストール パラメー タ] ダイアログ ボックスが表示されます。リスト ボックス からパラメータを選択するか、[新規作成...] をクリックし てユーザ パラメータを作成します。 • パラメータ グループ • 空白のままにする • パラメータ • 値 パラメータを割り当てるには、[パラメータ] をクリックし、 [選択] をクリックします。[グループ インストール パラメー タ] ダイアログ ボックスが表示されます。リスト ボックスか らパラメータを選択するか、[新規作成...] をクリックして グループ パラメータを作成します。 値を割り当てるには、[値] をクリックし、[選択] をクリック します。[Documentum グループ アーティファクト] ダイア ログ ボックスが表示されます。リスト ボックスからアーティ ファクトを選択し、[OK] をクリックします。 ユーザまたはグルー • 空白のままにする プ • パラメータ キャビネット パス • パラメータ • 値 パラメータを割り当てるには、[パラメータ] をクリックし、 [選択] をクリックします。[プリンシパル (ユーザまたはグ ループ) インストール パラメータ] ダイアログ ボックスが表 示されます。リスト ボックスからパラメータを選択するか、 [新規作成...] をクリックしてパラメータを作成します。 パラメータを割り当てるには、[パラメータ] をクリックし、 [選択] をクリックします。[フォルダ インストール パラメー タ] ダイアログ ボックスが表示されます。リスト ボックスか らパラメータを選択するか、[新規作成...] をクリックして パラメータを作成します。 値を割り当てるには、[値] をクリックし、[選択] をクリック します。[フォルダ サブタイプ アーティファクト] ダイアログ ボックスが表示されます。リスト ボックスからアーティファ クトを選択し、[OK] をクリックします。 キャビネットまたは フォルダ パス • パラメータ • 値 パラメータを割り当てるには、[パラメータ] をクリックし、 [選択] をクリックします。[フォルダ インストール パラメー タ] ダイアログ ボックスが表示されます。リスト ボックスか らパラメータを選択するか、[新規作成...] をクリックして パラメータを作成します。 値を割り当てるには、[値] をクリックし、[選択] をクリック します。[フォルダ サブタイプ アーティファクト] ダイアログ ボックスが表示されます。リストボックスからアーティファク トを選択し、[OK] をクリックします。 アクセス権セット • パラメータ • 値 パラメータを割り当てるには、[パラメータ] をクリックし、 [選択] をクリックします。[ACL インストール パラメータ] ダイアログ ボックスが表示されます。リスト ボックスから パラメータを選択するか、[新規作成...] をクリックして パラメータを作成します。 値を割り当てるには、[値] をクリックし、[選択] をクリック します。[アクセス権セット (ACL) テンプレート アーティ ファクト] ダイアログ ボックスが表示されます。リストボック スからアーティファクトを選択するか、[新規作成...] をク リックしてアーティファクトを作成します。 80 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 7 章 アスペクトの管理 この章では、次について説明します。 • アスペクト モジュールおよびアスペクト タイプ • アスペクト タイプの作成 • アスペクト属性の追加 • アスペクト属性の構造の設定 • アスペクト属性の制約の設定 • ア ス ペ ク ト UI 情 報 の 設 定 • アスペクト モジュールの作成 アスペクト モジュールおよびアスペクト タイプ アスペクト モジュールは、実行可能なビジネス ロジック、およびアスペクトをサポートする要素 (サードパーティのソフトウェアやドキュメントなど) で構成されます。アスペクトは、オブジェクト タイ プのインスタンスに対する動作のカスタマイズまたはメタデータの記録、あるいはその両方を行い ます。アスペクト モジュールは、次の要素から構成されます。 • アスペクト タイプの定義 • 実装クラスと、アスペクトによって実装される動作のインターフェイス クラスを含む JAR ファイル • アスペクトが依存するインターフェイス クラス モジュールには、Java ライブラリやドキュメントを含めることもできます。 アスペクト タイプの作成 アスペクト タイプを作成するには、アスペクト エディタを使用します。 アスペクト タイプを作成するには 1. Composer プロジェクトで、[Artifacts] フォルダを展開して [タイプ] を右クリックする。[新規 作成] > [アスペクト タイプ] を選択します。 [新しいアスペクト タイプ] ダイアログ ボックスが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 81 アスペクトの管理 2. アスペクト タイプを作成するプロジェクトのフォルダのパスと名前を [フォルダ] フィールドに入 力するか、[参照] をクリックしてフォルダ リストからプロジェクトを選択します。 3. [アーティファクト名] フィールドにアスペクト タイプのファイル名を入力し、[次へ] をクリッ クします。 アスペクト エディタの [全般] タブが表示されます。 4. 次の表の説明に従って、[情報]、[制約]、[イベント] の各セクションにアスペクトに関する 情報を入力します。 プロパティ 説明 情報 82 EMC Documentum Composer バージョン 7.2 ユーザ ガイド アスペクトの管理 プロパティ 説明 タイプ名 アスペクトの名前を表す文字列。アスペクト タイプ名は、アスペク トを参照しているアスペクト モジュールの名前と同じ名前にする 必要があります。 すべてのアスペクト名に次の規則が適用されます。 • 27 文字以内、すべて小文字。Content Server では大文字と小文 字は区別されず、タイプ名はすべて小文字で保存されます。 • 名前の先頭は必ず文字にします。その後は、文字、数字、アン ダースコアを使用できます。 • スペースや句読点は使用できません。 • 末尾をアンダースコア (_) にすることはできません。 制約 制約は、タイプの属性値同士またはタイプの属性値と定数値を関 係付ける、Docbasic 式の形式で表した内部的な整合性要件です。 式 制約を定義する Docbasic 式。[新規作成] をクリックして式を作 成します。制約の追加方法については、制約式の設定 (83ペー ジ) を参照してください。 適用 アプリケーションがこの制約を適用するかどうかを指定します。表の [適用] 列のセルをクリックして、関連付けられた式に対する制約の 適用を有効または無効にすることができます。 制約フィールドに指定できる値は次の 2 種類です。 • 無効: 制約は無効です。 • アプリケーションの実行: このタイプを使用するアプリケーション によって制約が実行されます。 イベント イベントは、オブジェクトに対する特定のアクションです。作成や変 更ができるのはアプリケーション イベントのみで、システム イベント の作成および変更はできません。新しいイベントを入力するには、 [新規作成] をクリックします。イベントを編集または削除するには、 対象のイベントを選択して [編集] または [削除] をクリックします。 イベント名 このタイプのインスタンスに関連付けられるイベントの名前を表 す文字列。 イベント ラベル イベントのラベルを表す文字列。 制約式の設定 制約は、アスペクトの属性値同士またはアスペクトの属性値と定数値を関係付ける、Docbasic 式 の形式で表した内部的な整合性要件です。 アスペクトの制約式を追加するには 1. アスペクト エディタの [全般] タブの [制約] セクションで、[新規作成...] をクリックします。 [制約の編集] ダイアログ ボックスが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 83 アスペクトの管理 2. [式] テキスト ボックスに、true または false に解決される有効な Docbasic 制約式を入力します。 Docbasic 式は、制約が満たされるときは true、制約違反のときは false に解決されます。 3. [制約違反の場合のエラー メッセージ] テキスト ボックスに、制約違反があった場合にアプリ ケーションで表示するメッセージを入力します。 4. アプリケーションでこの制約を適用するようにする場合は [制約を適用] チェックボックスをオン にし、制約を適用しないようにする場合はチェックボックスをオフにします。 5. [OK] をクリックして変更を保存します。 アスペクト属性の追加 アスペクトの属性は、アスペクト エディタの [属性] タブで設定します。アスペクト属性は、特定のタ イプのすべてのアスペクトに適用されるプロパティです。アスペクトが作成されると、その属性はそ のアスペクト タイプのインスタンスを定義する値に設定されます。各アスペクトの属性を設定する必 要があります。属性を設定せずにアスペクトを作成すると、アスペクトのアーティファクトは正しくイ ンストールされず、プロジェクト全体のインストールが失敗します。 属性を作成するには 1. アスペクト エディタの [属性] タブをクリックして [アスペクト属性] ビューを表示します。 2. [新規作成] をクリックして属性エントリを作成し、その新しい属性エントリを選択します。 [アスペクト属性] ビューが展開します。 84 EMC Documentum Composer バージョン 7.2 ユーザ ガイド アスペクトの管理 3. アスペクト属性の構造を設定します (アスペクト属性の構造の設定 (85ページ) を参照)。 4. アスペクト属性の制約を設定します (アスペクト属性の制約の設定 (86ページ) を参照)。 アスペクト属性の構造の設定 [アスペクト属性] ビューの [構造] セクションで、属性構造を設定します。 次の表の説明に従って、属性構造のプロパティを入力します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 85 アスペクトの管理 プロパティ 説明 名前 新しい属性の名前を表す文字列。属性名に使用する文字はすべて小 文字にする必要があります。先頭の文字を、dm_、a_、i_、r_、数値、ス ペース、一重引用符にすることはできません。また、select、from、また は where という名前を付けることはできません。 データ タイプ 新しい属性のデータ タイプ。ドロップダウン リストから次のいずれか のデータ タイプを選択します。 • BOOLEAN • INTEGER • STRING • ID • TIME • DOUBLE • UNDEFINED 長さ このパラメータは、STRING データ タイプを使用する属性にのみ適 用されます。この属性の文字数を入力します。この属性に割り当て 可能な最大文字数は、アプリケーションをインストールするデータ ベースによって異なります。 繰り返し この属性が複数の値を持てるかどうかを指定します。この属性に対 して複数の値を指定できるようにするには、チェックボックスをオン にします。 修飾不可 属性が修飾可能かどうかを指定します。 修飾できない属性のプロパティおよび値は直列形式で格納され、プロ パティや値が定義されるオブジェクト タイプを表す各自の列は、基 になるデータベース テーブルに存在しません。つまり、データベー スに公開されていないため、修飾できない属性をクエリで使用する ことはできません。 デフォルト値 単一値属性のデフォルト値 (1 つ) または繰り返し属性のデフォルト 値 (複数) を指定します。 アスペクト属性の制約の設定 アスペクト属性の制約は、[アスペクト属性] ビューの [構造] セクションで設定します。 86 EMC Documentum Composer バージョン 7.2 ユーザ ガイド アスペクトの管理 制約は、タイプの属性値同士またはタイプの属性値と定数値を関係付ける、Docbasic 式の形式で 表した内部的な整合性要件です。 次の表の説明に従って、アスペクト属性制約のプロパティの入力または指定を行います。 プロパティ 説明 式 制約を定義する Docbasic 式。[新規作成] をクリックして式を作 成します。式の作成または変更を行う方法の詳細については、 制約式の設定 (83ページ) を参照してください。 適用 アプリケーションがこの制約を適用するかどうかを指定します。 表の [適用] 列のセルをクリックして、関連付けられた式に対す る制約の適用を有効または無効にすることができます。 制約フィールドに指定できる値は次の 2 種類です。 • 無効: 制約は無効です。 • アプリケーションの実行: このタイプを使用するアプリ ケーションによって制約が実行されます。 属性は空白不可 アスペクト属性に必ず値を設定するように指定する場合に選択 します。ユーザは、アプリケーションの実行時にこのアスペク ト属性の値を入力する必要があります。 属性は読み取り専用 アスペクト属性を読み取り専用に指定する場合に選択します。 ユーザは、アプリケーションの実行時にアスペクト属性の値を 変更することはできません。 属性に NULL 値を指定可能 アスペクト属性に値を割り当てる必要がないことを指定する場合 に選択します。ユーザは、アプリケーションの実行時にこのアス ペクト属性の値を入力する必要はありません。 不変オブジェクトでの属性の変更が 可能 オブジェクト自体が不変 (変更不可) の場合でも、ユーザがその アスペクト属性を変更できるようにする場合に選択します。 ア ス ペ ク ト UI 情 報 の 設 定 [アスペクト UI 情報] ビューでは、Documentum クライアントおよびカスタム アプリケーションに表 示されるアスペクト属性を指定できます。使用するクライアント アプリケーションでアスペクト属 性情報の表示がサポートされていることを確認してください。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 87 アスペクトの管理 注 記 : Webtop では、アスペクト属性の表示はサポートされていません。 クライアントに表示される 1 つまたは複数の属性を設定するには 1. アスペクト エディタの [表示] タブをクリックすると、[アスペクト UI 情報] ビューが表示されます。 2. 次の表の説明に従って、アスペクト UI 情報を入力します。 プロパティ 説明 アプリケーション インターフェイス表示 タイプ ラベル このアスペクトに関してクライアント アプリケーションで表 示する文字列。 ユーザ ヘルプ アプリケーションに表示される説明 (オプション)。 開発者へのコメント 開発者に対するコメント (オプション)。 表示設定 スコープ アスペクトが表示されるアプリケーションの名前。アプリケー ションの名前が、リポジトリに存在している必要があります。 注 記 : Webtop では、アスペクト属性の表示はサポー トされていません。 88 EMC Documentum Composer バージョン 7.2 ユーザ ガイド アスペクトの管理 プロパティ 説明 表示設定リスト アスペクト属性が表示されるタブを指定します。次のように してタブの追加、削除、タブ名の変更、タブ位置の変更を 行うことができます。 • 新しいタブを追加するには、[新規作成] をクリックしま す。[表示設定] ダイアログ ボックスが表示されます。ク ライアント アプリケーションに属性を表示するためのタ ブを追加する方法については、タブの追加 (89ペー ジ) を参照してください。 • タブを削除するには、リストからタブ名を選択して [削 除] をクリックします。 • タブの名前を変更するには、リストからタブ名を選択して [名前変更] をクリックします。 • タブの表示順序を変更するには、リストからタブ名を選 択し、[上へ] または [下へ] をクリックして目的の位置に タブを移動します。 表示設定の属性 タブに表示される属性を編集できます。 タブの追加 [表示設定] ダイアログ ボックスを使用して、属性を表示するタブを追加します。 属性を表示するタブを追加するには 1. [アスペクト UI 情報] ビューの [表示設定リスト] セクションで [新規作成] をクリックします。 [表示設定] ダイアログ ボックスが表示されます。 2. 次の表の説明に従って、タブ プロパティを設定します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 89 アスペクトの管理 タブのプロパティ 説明 設定名 タブの内部オブジェクト名を表す文字列。このダイアログ ボックス でこの名前を変更することはできません。 設定ラベル クライアント アプリケーションのタブに表示される名前を指定 する文字列。 使用可能な属性 タブに表示できる属性の一覧が表示されます。タブに表示する 属性を選択して、[追加] をクリックします。選択した属性は [選択 した属性の配列] リストに表示されます。 使用可能な属性のリストが空の場合、属性はまだ 1 つも設定され ていません。属性の設定については、アスペクト属性の追加 (84 ページ) を参照してください。 選択した属性の配列 タブに表示される属性と、それらの属性をどのように表示するか を指定します。タブに表示される属性の配置は、属性を選択し、 次のボタンを使用することによって変更できます。 • 上へ: 表示順序の上の方に属性を移動します。 • 下へ: 表示順序の下の方に属性を移動します。 • 区切り文字の追加: 選択した属性とその次の属性の間に区切 り文字を追加します。 • 区切り文字の削除: 区切り文字を削除します。 • 次のページへ: 1 つのタブにすべての属性が収まらない場合、 次のページに表示されるようにします。 カスタム属性のみ [使用可能な属性] リストにカスタム属性のみ表示するには、 このオプションを選択します。 非表示属性のみ [使用可能な属性] リストに非表示の属性のみ表示するには、 このオプションを選択します。 3. [OK] をクリックして変更を保存します。 アスペクト モジュールの作成 アスペクト モジュールを作成する前に、Documentum プロジェクト を作成します。Documentum プロ ジェクトの作成方法については、プロジェクトの作成 (19ページ) を参照してください。 アスペクト モジュールを作成するには 1. Composer プロジェクトで、[Artifacts] フォルダを展開し、[モジュール] を右クリックします。[新 規作成] > [アスペクト モジュール] を選択します。 [新しいアスペクト モジュール] ダイアログ ボックスが表示されます。 90 EMC Documentum Composer バージョン 7.2 ユーザ ガイド アスペクトの管理 2. 新しいアスペクト モジュールの名前を入力してから、[終了] をクリックします。 注 記 : アスペクト モジュールの名前は、そのモジュールに関連付けられたアスペクト タイ プと同じ名前にします。 アスペクト モジュール エディタの [全般] タブが表示されます。 3. 次の表の説明に従って、[情報]、[説明]、[必須モジュール]、[Javadoc]、[コア JAR] セクション に必須のプロパティとオプションのプロパティを入力します。 プロパティ 説明 全般 名前 モジュールの名前を表す文字列。必須のパラメータです。 最大 255 文字の名前を入力できます。 タイプ モジュールのタイプを表す文字列。必須のパラメータで す。アスペクト モジュールに指定できるタイプは [アスペ クト] のみです。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 91 アスペクトの管理 プロパティ 説明 説明 作成者 モジュール プロバイダの作成者。オプションのパラメータ。 説明 モジュールの説明 (255 文字以内)。オプションのパラメータ。 必須モジュール このモジュールが正常に機能するのに必要なモジュールを 指定します。[追加] をクリックし、[モジュール アーティファ クト] ダイアログ ボックスを開きます。リストボックスからモ ジュールを選択して [OK] をクリックするか、[新規作成] を クリックしてモジュールを作成します。 Javadoc 実行時にアスペクト モジュールと共にダウンロードできる Javadoc と他のリソースを指定します。[選択] をクリックする と、[システム オブジェクト サブタイプ アーティファクト] ダイ アログ ボックスが開きます。リストから Javadoc またはリソース コンテンツを含むシステム オブジェクトを選択するか、[新 規作成] をクリックして、ダウンロードするコンテンツを含む システム オブジェクトを作成します。 コ ア JAR 実装 JAR モジュールの実装。必須のパラメータです。[追加] をクリッ クして、ローカル マシンから実装 JAR を追加します。 クラス名 モジュール用の主要な Java 実装クラス。必須のパラメータ です。TBO は IDfBusinessObject インターフェイスを、SBO は IDfService インターフェイスを実装する必要があります。 また、すべてのモジュールは IDfModule インターフェイスを 実装する必要があります。 インターフェイス JAR このモジュールが実装する Java インターフェイス。オプショ ンのパラメータ。[追加] をクリックして、ローカル マシンから インターフェイス JAR を追加します。 4. [デプロイ] タブをクリックし、アスペクト モジュールのデプロイの設定 (92ページ) の説明に従っ てモジュールの依存関係を設定します。 5. [実行時] タブをクリックし、アスペクト モジュールの実行時環境の設定 (94ページ) の説明に 従ってこのモジュールの実行時環境を設定します。 6. [アスペクト タイプ] タブをクリックし、アスペクト タイプの設定 (95ページ) の説明に従ってこの モジュールのアスペクト タイプを設定します。 アスペクト モジュールのデプロイの設定 [デプロイ] タブでは、Java ライブラリおよびその他のモジュールを、独自に作成または編集 するモジュールにリンクすることができます。 モジュールのデプロイを設定するには 92 EMC Documentum Composer バージョン 7.2 ユーザ ガイド アスペクトの管理 1. アスペクト モジュール エディタの [デプロイ] タブをクリックします。 [デプロイ] ビューが表示されます。 2. このモジュールで使用する Java ライブラリを追加するために、[Java ライブラリ] セクションの [追加] をクリックします。 [JAR 定義 Java ライブラリ アーティファクト] ダイアログ ボックスが表示されます。 [一致するアーティファクト] リストボックスから Java ライブラリを選択して [OK] をクリックするか、 [新規作成] をクリックして Java ライブラリを作成します。このモジュールには既存の Java ライ ブラリのみをリンクできます。複数のモジュールで共有されている既存ライブラリは変更で きません。Java ライブラリの作成方法については、Java ライブラリのリンクと設定 (105ペー ジ) を参照してください。 3. [添付ファイル] セクションで、このモジュールがデプロイされるときにダウンロードできる追 加のオブジェクトを指定します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 93 アスペクトの管理 4. ログ出力セクションで、ダウンロード後のメッセージを指定して、メッセージのログ レベル を選択します。 ログ レベルに指定できる値は次のとおりです。 • 警告: ダウンロード後のメッセージは警告として記録されます。 • なし: ダウンロード後のメッセージは記録されません。 • 情報: ダウンロード後のメッセージは情報メッセージとして記録されます。 • デバッグ: ダウンロード後のメッセージはデバッグ レベルで記録されます。 5. 変更を保存します。 アスペクト モジュールの実行時環境の設定 実行時環境設定では、実行時環境に必要なオプションの プロパティ (バージョン要件、Java シス テム プロパティ、静的にデプロイされたクラス、ローカル リソースなど) を設定できます。 実行時環境を設定するには 1. アスペクト モジュール エディタの [実行時] タブをクリックします。 [実行時] ビューが表示されます。 2. 次の表を参照して、バージョン要件、Java システム プロパティ、静的にデプロイされたクラス、 ローカル リソースを指定します。 94 プロパティ 説明 バージョン要件 このセクションでは、モジュールが正常に機能するため にクライアントで必要な DFC および Java VM のバージョ ンを指定します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド アスペクトの管理 プロパティ 説明 必須 DFC バージョン このモジュールが正常に機能するために必要な、クライアン ト マシンの DFC の必須バージョン。 必須 VM バージョン このモジュールが正常に機能するために必要な、クライアン ト マシンの Java VM の必須バージョン。 Java シ ス テ ム プ ロ パ テ ィ このセクションでは、Java のシステム プロパティを名前と値 のペアとして指定します。モジュールがダウンロードされると きに、指定されたすべての Java のプロパティがクライアン ト マシンでのプロパティと一致するかどうか、そのクライア ント マシンがチェックされます。[追加] をクリックして名前 のプレースホルダと Java システム プロパティの値を入力 し、次に [名前] フィールドと [値] フィールドをクリックして、 プロパティの名前と値を編集します。 名前 Java システム プロパティの名前。 値 Java システム プロパティの名前に対応する値。 静的にデプロイされたクラス このセクションでは、モジュールが正常に機能するため に必要な静的 Java クラスを指定します。モジュールがダ ウンロードされるときに、指定した Java クラスのクラス パス がチェックされます。 完全修飾クラス名 Java クラスの完全修飾名。クラス名を入力して [追加] を クリックします。 ローカル リソース このセクションでは、モジュールが正常に機能するために ローカル マシンで必要なファイルを指定します。モジュー ルがダウンロードされるときに、指定したファイルがあるかど うかクライアント マシンがチェックされます。 デプロイメントへの相対ファイル パス ファイルの絶対パス。ファイル名とパスを入力して [追加] を クリックします。 3. 変更を保存します。 アスペクト タイプの設定 [アスペクト タイプ] タブを使用して、アスペクト タブを設定します。 アスペクト タイプを設定するには 1. アスペクト モジュール エディタの [アスペクト タイプ] タブをクリックします。 [アスペクト タイプ] ビューが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 95 アスペクトの管理 2. 次の表の説明に従って、[情報] セクションのアスペクト タイプのプロパティを設定します。 プロパティ 説明 タイプ参照 このアスペクト モジュールに関連付けられているアスペクト タイプを指定します。 [選択] をクリックして、タイプ参照を追加します。[アスペク ト アーティファクトの選択] ダイアログ ボックスが表示されま す。リストからアスペクト タイプを選択するか、[新規作成] をクリックしてアスペクト タイプを作成します。アスペクト タ イプの作成方法については、アスペクト タイプの作成 (81 ページ) を参照してください。 96 オブジェクトがコピーされる アスペクトに関連するオブジェクトがコピーされるときに、アス ペクトが一緒にコピーされるかどうかを指定します。デフォル トでは、アスペクトはオブジェクトとともにコピーされます。 オブジェクトのバージョンが更新される アスペクトに関連するオブジェクトのバージョンが設定され るときに、アスペクトが一緒にコピーされるかどうかを指定 します。デフォルトでは、アスペクトはオブジェクトとともに コピーされます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド アスペクトの管理 プロパティ 説明 アスペクト カテゴリ このアスペクト モジュールに関連付けられるアスペクト カ テゴリを指定します。 アスペクト カテゴリを追加するには、リストからアスペクト カテ ゴリを選択し、[追加] をクリックします。 ターゲット オブジェクト タイプ アスペクトを添付できるオブジェクト タイプを指定します。 [追加] をクリックして、ターゲット オブジェクト タイプを追加し ます。[タイプ アーティファクトの選択] ダイアログ ボックスが 表示されます。リストからタイプを選択するか、[新規作成] を クリックしてタイプを作成します。タイプの作成方法について は、オブジェクト タイプ (171ページ) を参照してください。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 97 アスペクトの管理 98 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 8 章 フォーマットの管理 この章では、次について説明します。 • フォーマット • フォーマット アーティファクトの作成 フォーマット フォーマット オブジェクトには、Content Server で認識されるファイル フォーマットに関する情報 があります。リポジトリの設定時にデフォルトで、事前定義されたファイル フォーマットのセット がインストールされます。 フォーマット アーティファクトの作成 フォーマット アーティファクトを作成するには、フォーマット エディタを使用します。 フォーマット アーティファクトを作成するには 1. Composer プロジェクトで、[Artifacts] フォルダを展開し、[フォーマット] を右クリックする。 [新規作成] > [フォーマット] を選択します。 [新しいフォーマット] ダイアログ ボックスが表示されます。 2. フォーマット アーティファクトのフォルダ パスと名前を入力するか、デフォルトのパスと名前を 受け入れ、[終了] をクリックします。 フォーマット エディタが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 99 フォーマットの管理 3. 次の表の説明に従って、[全般] セクション、[Digital Asset Management] セクション、[全文検索 用インデックス] セクションにフォーマットのプロパティを入力します。 パラメータ 説明 全般 名前 フォーマットの名前を表す ASCII 文字列。この文字列は、64 文 字を超えることはできません。 説明 フォーマットを説明する文字列。この文字列は、64 文字を超える ことはできません。 デフォルトのファイル拡張子 このフォーマットのファイルを共通領域、クライアントのローカル領 域、またはストレージにコピーする際に使用する DOS 拡張子を表す 文字列。この文字列は、10 文字を超えることはできません。 COM クラス ID コンテンツ タイプについて Windows レジストリで認識されるクラス ID を表す文字列。この文字列は、38 文字を超えることはできません。 MIME タイプ コンテンツ タイプの MIME (Multipurpose Internet Mail Extension) を 表す文字列。この文字列は、64 文字を超えることはできません。 Macintosh 作成者 Macintosh リソース ファイルを管理するときに内部的に使用される 最大 4 文字の文字列。 Macintosh タイプ Macintosh リソース ファイルを管理するときに内部的に使用される 最大 4 文字の文字列。 非表示 クライアント アプリケーションのユーザ インターフェイスでこのフォー マット オブジェクトを表示するかどうかを指定する際にクライアント ア プリケーションで使用します。選択した場合、フォーマットはクライア ントのユーザ インターフェイスで表示されません。 クラス フォーマットが属するフォーマットのクラスを指定します。たとえば、 xml、xsd、xsl フォーマットは、XML クラスおよび MSOffice クラスに 属します。 Digital Asset Management 100 EMC Documentum Composer バージョン 7.2 ユーザ ガイド フォーマットの管理 パラメータ 説明 資産クラス このフォーマットのオブジェクトについてコンテンツの資産タイプ (オーディオ、ビデオ、イメージなど) を分類する際にアプリケーション で使用される文字列 (最大 32 文字)。 デフォルト ストレージ このフォーマットのオブジェクトのコンテンツが格納されるデフォルト のストレージ領域 (その object_id で識別される) を指定します。シ ステム オブジェクトにストレージ タイプが指定されていない場合、 関連付けられたフォーマットのデフォルト ストレージが使用されま す。デフォルト ストレージが指定されていない場合は、そのオブジェ クト タイプに指定されたストレージ タイプが使用されます。上記の いずれも指定されていない場合、ターボ ストレージがデフォルト ストレージとして使用されます。 ファイル名修飾子 同じ拡張子を持つ (オブジェクトの) レンディションが複数エクス ポートされた場合に、クライアント アプリケーションでファイル名に 追加する文字列を指定します。たとえば、jpeg_th フォーマットの filename_modifier として_th を指定した場合、jpeg_th フォーマットの レンディション my_picture.jpeg がエクスポートされると、レンディショ ンのファイル名は my_picture_th.jpeg となります。 リッチ メディアの有効化 Content Server でコンテンツのサムネール、自動プロキシ、およびメ タデータを自動的に生成するかどうかを指定します。 全文検索用インデックス インデックス付け可能 このフォーマットのオブジェクトのコンテンツに全文検索用インデック ス付けが可能かどうかを指定します。 フィルタ付きのインデックス 全文検索用インデックス付けに使用する Verity トピック フィルタの名 前。トピック フィルタの値は次のとおりです。 • ユニバーサル • なし レンディション付きのインデッ クス 全文検索用インデックス付けの際にこのフォーマットから変換する必 要のあるフォーマットを表す文字列。[選択] をクリックしてリストボック スからフォーマットを選択します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 101 フォーマットの管理 102 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 9 章 JAR お よ び Java ラ イ ブ ラ リ の 管 理 この章では、次について説明します。 • 、お よ び Java ラ イ ブ ラ リ JAR 定 義 、 JAR、 • JAR 定 義 の 作 成 • Java ラ イ ブ ラ リ の リ ン ク と 設 定 、お よ び Java ラ イ ブ ラ リ JAR 定 義 、 JAR、 JAR (Java ARchive) ファイルは、複数のファイルを 1 つにまとめたアーカイブ ファイルです。これ は、Java クラスや関連するメタデータの配布に使用され、アプリケーションや拡張機能の基本要素 とすることができます。JAR ファイルは、1 つの Java ライブラリにまとめることが可能です。 JAR ファイルには、インターフェイス JAR と実装 JAR の 2 つの種類があります。インターフェイス JAR には、Java インターフェイス クラスが含まれ、実装 JAR にはインターフェイス クラスを実装 するクラスが含まれます。通常、インターフェイス クラスと実装クラスは、別個の JAR ファイルに まとめられますが、場合によっては、1 つの JAR ファイルにインターフェイス クラスと実装クラス の両方が含まれることもあります。 Composer により、JAR ファイルと Java ライブラリをポイントする定義を作成できます。定義は、JAR ファイルと Java ライブラリをカプセル化し、モジュールなどのアーティファクトにリンクします。 JAR 定 義 の 作 成 Composer により、Java インターフェイスと実装クラスを含む JAR ファイルを指す JAR 定義を作成 できます。JAR 定義は、モジュール エディタまたは Composer のメイン メニューから作成できます。 JAR 定 義 を 作 成 す る に は 1. Composer プロジェクトで、[Artifacts] フォルダを展開し、[JAR 定義] を右クリックする。 [新規作 成] > [JAR 定義] を選択します。 [新しい JAR 定義] ダイアログ ボックスが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 103 JAR および Java ライブラリの管理 2. JAR 定義のフォルダ パスと名前を入力するか、デフォルトのパスと名前を受け入れ、[終 了] をクリックします。 JAR 定義 エディタが表示されます。 3. 次の表の説明に従って、JAR 定義のプロパティを入力し、ファイルのコンテンツを追加します。 プロパティ 説明 情報 名前 JAR 定義の名前を指定する文字列。 タイプ JAR 定義のタイプを指定します。タイプの値は次のとおりです。 • 実装 : 実装クラス、または実装およびインターフェイス クラスを 含む JAR ファイル定義です。 • インターフェイス : インターフェイス クラスのみを含む JAR ファイル定義です。 • インターフェイスおよび実装: この JAR ファイル定義は、イン ターフェイス クラスと実装クラスの両方を指します。 JAR コンテンツ JAR ファイルにまとめられるローカル ファイルを指定します。 [参照] をクリックしてローカル マシン上の JAR ファイルを選択 します。[JAR ファイルからコンテンツを選択] ダイアログ ボック スが表示されます。リストから JAR ファイルを選択し、[開く] をク リックします。 選択した JAR ファイルのコンテンツを表示するには、[ファイ ル] リンクをクリックし、コンテンツの表示に使用するエディタを 選択します。 104 EMC Documentum Composer バージョン 7.2 ユーザ ガイド JAR お よ び Java ラ イ ブ ラ リ の 管 理 4. 変更を保存します。 Java ラ イ ブ ラ リ の リ ン ク と 設 定 Composer により、Java ライブラリをモジュールにリンクすることができます。Java ライブラリには、モ ジュールのインターフェイス JAR および実装 JAR が含まれます。Java ライブラリは、モジュール エ ディタまたは Composer のメイン メニューを使用してリンクできます。 Java ラ イ ブ ラ リ を リ ン ク す る に は 1. Composer プロジェクトで、[Artifacts] フォルダを展開し、[Java ライブラリ] を右クリックします。 [新規作成] > [Java ライブラリ] を選択します。 [新しい Java ライブラリ] ダイアログ ボックスが表示されます。 2. Java ライブラリのフォルダ パスと名前を入力するか、デフォルトのパスと名前を受け入れ、 [終了] をクリックします。 Java ライブラリ エディタが表示されます。 3. 次の表の説明に従って、Java ライブラリを設定します。 プロパティ 説明 情報 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 105 JAR および Java ライブラリの管理 プロパティ 説明 名前 Java ライブラリの名前を指定する文字列。 サンドボックス この Java ライブラリがサンドボックスを使用するかどうかを 指定します。これを選択すると、Java ライブラリはサンドボッ クスを使用します。デフォルトでは、サンドボックスは無効 になっています。 注 記 : Java ライブラリにサンドボックスを使用しないと、 その Java ライブラリはデプロイできません。 ファイル Java ライブラリに含める JAR およびプロパティ ファイル。[追 加] をクリックしてリストボックスから JAR とプロパティ ファイ ルを選択します。 4. 変更を保存します。 106 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 10 章 ライフサイクルの管理 この章では、次について説明します。 • ライフサイクル • ライフサイクルの作成 • ライフサイクルのプロパティの設定 • ライフサイクル状態の追加と設定 • 状態エントリの基準の設定 • 状態のアクションの設定 • 変更後の情報の設定 • 状態属性の設定 • ライフサイクル状態の削除 • ライフサイクルの削除 ライフサイクル ライフサイクルでは、ドキュメントなどのオブジェクトのプロパティの変更に関するビジネス規則を指 定します。つまり、ライフサイクルでは、添付されているドキュメントのさまざまな段階を定義します。 たとえば、ドキュメントには下書き状態、確認状態、完成状態という段階があります。ライフサイクル では、ドキュメントがなんらかの状態にあるときに、そのドキュメントに対して発生するアクティビティ を定義するわけではありません。アクティビティはワークフローによって定義されます。 ライフサイクルは大まかに分けて、1 つの添付オブジェクトとそのオブジェクトのプロパティを定義 する複数の状態で構成されます。ライフサイクルを計画する際は、次の項目について決定します。 • ライフサイクルに添付できるオブジェクト タイプ (複数可)。 • 通常状態 (開始と終了の条件を含む)、状態のアクション、およびプロシージャ。 • 例外状態 (開始と終了の条件を含む)、状態のアクション、およびプロシージャ。 • 検証プロシージャ。 • エイリアス セット。 ライフサイクルのオブジェクト タイプ 一般に、ライフサイクルにはすべてのタイプのコンテンツ オブジェクトを添付することができます。 システム オブジェクトは、コンテンツを含めることが可能なすべてのオブジェクト タイプの (直接ま EMC Documentum Composer バージョン 7.2 ユーザ ガイド 107 ライフサイクルの管理 たは間接の) スーパータイプであり、システム オブジェクトおよびシステム オブジェクトのサブタ イプをライフサイクルに添付できます。コンテンツと関連付けられる最も一般的なシステム オブ ジェクトのサブタイプは、dm_document です。 ライフサイクルにはプライマリ オブジェクト タイプが 1 つ必要です。また、複数のセカンダリ オブ ジェクト タイプを含めることができます。プライマリ オブジェクト タイプは、ライフサイクルに添付可 能なドキュメントのタイプを表します。ドキュメントをライフサイクルに添付できるのは、そのドキュメ ント タイプがプライマリ オブジェクト タイプと一致する場合に限ります。プライマリ オブジェクト タイ プに該当するのは、dm_sysobject またはそのサブタイプの 1 つのみです。セカンダリ オブジェク ト タイプは、プライマリ オブジェクト タイプのサブタイプです。 デフォルトでは、Composer によってそのライフサイクル エディタ内に dm_sysobject とそのサブタ イプが用意されています。 オブジェクト タイプも作成できます。オブジェクト タイプの詳細については、オブジェクト タイプ (171ページ) を参照してください。オブジェクト タイプの作成方法については、標準オブジェクト タ イプの作成 (172ページ) を参照してください。 ライフサイクルの作成 Composer のライフサイクル エディタを使用してライフサイクルを作成できます。 ライフサイクルを作成するには 1. Composer プロジェクトで、[Artifacts] フォルダを展開し、[ライフサイクル] を右クリックする。 [新 規作成] > [ライフサイクル] を選択します。 [ライフサイクル] ダイアログ ボックスが表示されます。 2. 作成するライフサイクルを保存するフォルダの絶対パス名を [フォルダ] フィールドに入力する か、[参照] をクリックしてドロップダウン リストからフォルダを選択します。 3. ライフサイクルの名前を [アーティファクト名] フィールドに入力するか、デフォルトの名前を そのまま受け入れます。 4. [終了] をクリックします。 ライフサイクル エディタが表示されます。 108 EMC Documentum Composer バージョン 7.2 ユーザ ガイド ライフサイクルの管理 5. ライフサイクルのプロパティの設定 (109ページ) の説明に従って、ライフサイクルのプロパ ティを設定します。 6. ライフサイクル状態の追加と設定 (111ページ) の説明に従って、ライフサイクルの状態を設 定します。 7. 変更を保存します。 ライフサイクルのプロパティの設定 [ライフサイクル エディタ - プロパティ] ページの [全般] タブで、ライフサイクルのプロパティ を設定します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 109 ライフサイクルの管理 ライフサイクル プロパティには、プライマリ オブジェクト タイプ、セカンダリ オブジェクト タイプ、検 証プロシージャ、実装タイプ、およびエイリアス セットが含まれます。[主要情報] および [一般情 報] のセクションで、次の表の説明に従ってライフサイクルのプロパティを設定します。 パラメータ 説明 主要情報 名前 ライフサイクルの名前を表す文字列。 プライマリ タイプ 次のいずれかの方法で、プライマリ オブジェクト タイプを割り当てます。 • [選択] をクリックします。[タイプ アーティファクト を選択] ダイアログ ボックスが表示されます。リ ストボックスからプライマリ オブジェクト タイプを 選択します。 • [プライマリ タイプ] リンクをクリックしてオブジェク ト タイプを作成します。新規オブジェクト タイプ アーティファクト ウィザードが表示されます。カ スタム オブジェクト タイプの作成方法の詳細に ついては、標準オブジェクト タイプの作成 (172 ページ) を参照してください。 プライマリ タイプとすべてのサブタイプを選択 このオプションを選択すると、選択したプライマリ タイプとそのすべてのサブタイプがライフサイクル に適用されます。 個別のセカンダリ タイプを選択 セカンダリ タイプを個別に割り当てる場合は、この オプションを選択します。[セカンダリ タイプ] リスト ボックスからセカンダリ タイプを選択します。 セカンダリ タイプ このライフサイクルに割り当て可能なセカンダリ タイ プが表示されます。 セカンダリ オブジェクト タイプは、[プライマリ タイ プ] フィールドで指定されるプライマリ オブジェクト タイプのサブタイプです。セカンダリ オブジェクト タ イプを指定すると、ライフサイクルに添付できるのは セカンダリ オブジェクト タイプのオブジェクトのみと なります。セカンダリ オブジェクト タイプを選択しな い場合、添付のタイプはプライマリ オブジェクト タ イプと一致する必要があります。 一般情報 実装タイプ 実装タイプを指定します。ドロップダウン リストから 実装のタイプを選択します。実装タイプには、次の 2 つの種類があります。 • Docbasic • Java 110 EMC Documentum Composer バージョン 7.2 ユーザ ガイド ライフサイクルの管理 パラメータ 説明 エイリアス セット このライフサイクルに関連付けるエイリアス セット を指定します。[一般情報] セクションの [エイリア ス セット] フィールドの横にある [追加] をクリックし て、1 つまたは複数のエイリアス セットを追加しま す。これらのエイリアスは、ライフサイクルの実行 時に実際のユーザ名、グループ名、またはフォル ダ パスに解決されます。 エイリアス セットの管理の補足情報についてはエ イリアス、エイリアス値、およびエイリアス セット (77 ページ) を参照してください。 カスタム検証プロシージャ このライフサイクルに関連付ける検証プロシージャ を指定します。 [検証プロシージャ] フィールドを使用して検証プロ シージャを割り当てます。[参照] をクリックして検証 プロシージャを選択します。 このライフサイクルを非アクティブにする このライフサイクルを非アクティブにするには、この オプションを選択します。 ライフサイクル状態の追加と設定 ライフサイクルを作成した後、状態を追加できます。ライフサイクル状態は、ライフサイクル エディタ のメイン ウィンドウで、状態ダイアグラムの形式で追加します。次の図に示すように、各状態が四角 形で表示され、1 つの状態から次の状態への移行が矢印で示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 111 ライフサイクルの管理 ライフサイクル状態には次の 2 種類があります。 • 通常状態: 通常状態は、最初の (ベース) 状態から最後の (終了) 状態まで直線的に進行します。 • 例外状態: 例外状態は、直線経路から逸脱した状態を処理します。通常の状態には、ドキュメ ントが移行する可能性のある例外状態がそれぞれ 0 個または 1 個付随します。一方、1 つの例 外状態に対して複数の通常状態を接続することが可能です。 ライフサイクル状態を追加するには 1. ライフサイクル エディタ パレットで、追加する状態のタイプに応じて [通常の状態] または [例外の状態] をクリックします。 2. マウス カーソルをエディタ ウィンドウ上に移動し、エディタ ウィンドウ内で左クリックしてラ イフサイクル状態を描画します。 3. 次の表の説明に従って、[概要] タブの [状態の概要]、[一般設定]、および [ドキュメントの降 格設定] に状態のプロパティを入力します。 プロパティ 説明 状態の概要 名前 ライフサイクル状態の名前を表す文字列。 説明 ライフサイクル状態の目的または機能を説明する文字列。オ プションのパラメータ。 状態タイプ 状態をタイプで表した文字列。状態タイプは、クライアント アプ リケーションが使用する状態を識別します。一部のクライアント アプリケーションは、状態を名前ではなくタイプで識別します。 [状態タイプ] フィールドに既存の状態タイプを入力し、[選択] をクリックしてリストから状態タイプを選択するか、[状態タイ プ] をクリックして、状態タイプを作成します。状態タイプの作 成方法についての詳細は、状態タイプの作成 (113ページ) を参照してください。 一般設定 この状態への直接の添付を許可する この設定を選択すると、ユーザはドキュメントをこの状態に添 付できます。ドキュメント タイプは、ライフサイクルに対して指 定されているプライマリ オブジェクト タイプおよびセカンダリ オブジェクト タイプと一致する必要があります。 この状態からのスケジュールされた 移行を許可する この設定を選択すると、ドキュメントをスケジュールに合わせ て現在の状態から次の状態に移行できます。明示的なユー ザ アクションは必要ありません。 以前の状態への降格を許可する この設定を選択すると、現在の状態に添付されたドキュメン トを、直前の状態またはベース状態 (最初の状態) に戻す ことができます。 ドキュメントの降格設定 チェックイン 112 この設定を選択すると、ドキュメントはチェックインされたとき に自動的にベース状態に戻ります。正常にチェックインされ るためには、ドキュメントがベース状態のエントリの基準を満 たしている必要があります。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド ライフサイクルの管理 プロパティ 説明 上書き保存 この設定を選択すると、ドキュメントは保存されたときに自動 的にベース状態に戻ります。正常に保存されるためには、 ドキュメントがベース状態のエントリの基準を満たしている 必要があります。 新規保存 この設定を選択すると、ドキュメントは新しいドキュメントとし て保存されたときに自動的にベース状態に戻ります。正常 に保存されるためには、ドキュメントがベース状態のエントリ の基準を満たしている必要があります。 分岐 この設定を選択すると、ドキュメントは分岐したときに自動的 にベース状態に戻ります。 状態タイプの作成 状態タイプは、クライアント アプリケーションが使用する状態を識別します。一部のクライアント ア プリケーションは、状態を名前ではなくタイプで識別します。ライフサイクル状態エディタから状 態タイプのアーティファクトを作成できます。 状態タイプを作成するには 1. ライフサイクル エディタで、状態タイプを作成するライフサイクル状態を選択します。 2. [プロパティ] ペインの [概要] タブをクリックして [状態の概要] ページを表示します。 3. [状態の概要] セクションで、[状態タイプ] リンクをクリックします。 [新しい状態タイプ] ダイアログ ボックスが表示されます。 4. 作成する状態タイプを保存するフォルダのフル パス名を [フォルダ] フィールドに入力するか、 [参照] をクリックしてドロップダウン リストからフォルダを選択します。 5. [アーティファクト名] フィールドに状態タイプの名前を入力するか、デフォルトの名前をそのま ま受け入れます。状態タイプの名前は一意にする必要があります。 6. [次へ] をクリックします。 [状態タイプ アーティファクト] ダイアログ ボックスが表示されます。 7. アプリケーション コードを入力します。アプリケーション コードは、DCM (Documentum Compliance Manager) を表す dm_dcm など、クライアント アプリケーションが認識する文字列で す。アプリケーション コードと有効な状態タイプについては、クライアント アプリケーションの ドキュメントを参照してください。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 113 ライフサイクルの管理 8. [終了] をクリックします。 状態エントリの基準の設定 状態エントリの基準では、ドキュメントが特定の段階に移行するために満たす必要のある基準 と、その段階に移行するときに実行されるプロシージャを指定します。状態エントリの基準は、 [プロパティ] ページの [エントリの基準] タブで設定します。 状態エントリの基準を設定するには 1. [プロパティ] ペインの [エントリの基準] タブをクリックして [状態エントリの基準] ページを表 示します。 2. [状態エントリの基準] セクションの [追加] をクリックして、状態エントリの基準の規則を 1 つ または複数追加します。行内の任意のフィールドをクリックし、次の表の説明に従って値を 入力または編集します。 プロパティ 説明 状態エントリの基準 論理演算子 論理演算子。値は AND または OR を使用できます。 属性名 この状態のエントリの基準を表す属性の名前。フィールドをク リックして、ドロップダウン リストから属性名を選択します。リス トには、ライフサイクルに関連付けられたプライマリ オブジェ クト タイプに対して有効な属性のみが表示されます。 インデックス エントリ基準のリストでのエントリ基準の位置を指定します。デ フォルトでは、インデックスは [NONE] に設定されています。 関係演算子 関係演算子。次の値を指定できます。 • > (より大きい) • >= (以上または等しい) • < (より小さい) • <= (以下または等しい) • = (等しい) 114 EMC Documentum Composer バージョン 7.2 ユーザ ガイド ライフサイクルの管理 プロパティ 説明 属性値 属性の値を表す文字列。 プロシージャ プロシージャ ドキュメントがライフサイクルのこの段階に移行したときに 実行されるプロシージャ。次のいずれかの方法でプロシー ジャ名を入力します。 • [選択] をクリックします。[プロシージャ アーティファクト] ダイアログ ボックスが表示されます。リストボックスからプ ロシージャを選択するか、[新規作成] をクリックしてプ ロシージャを作成します。 • [プロシージャ:] リンクをクリックしてプロシージャを作成し ます。 プロシージャの作成方法については、プロシージャの作成 (153ページ) を参照してください。 状態のアクションの設定 状態ごとに、その状態に移行するオブジェクトで実行されるアクションを定義できます。移行時の アクションは、エントリの基準が評価された後で実行されます。このアクションが正常に実行され ないと、オブジェクトはその状態に移行できません。すべての状態アクションは、[プロパティ] ページの [アクション] タブで設定できます。 繰り返し属性値の追加 繰り返し属性は、複数の値を持つことができる属性です。たとえば、ドキュメントには複数の作成者 がいる場合があるため、ドキュメント オブジェクトの作成者属性は繰り返し属性です。 繰り返し属性値を追加するには 1. ライフサイクル状態ダイアグラムで、繰り返し属性値を追加する状態をクリックします。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 115 ライフサイクルの管理 2. [プロパティ] ペインの [アクション] タブをクリックします。 [アクション] ページが表示されます。 3. [繰り返し属性に値を追加] リンクをクリックします。 [繰り返し属性に値を追加] ダイアログ ボックスが表示されます。 4. 次の表の説明に従って、繰り返し属性の名前、位置、および値を入力します。 プロパティ 説明 属性 繰り返し属性の名前。[属性] フィールドに名前を入力するか、ド ロップダウン リストから名前を選択します。リストには、ライフサイク ルに割り当てられているプライマリ オブジェクトに対して有効な属 性のみが表示されます。 リストの末尾に追加 既存の値リストの最後に値を追加する場合に選択します。 ポジションに追加 特定の位置に値を追加して古い値を置き換える場合に選択しま す。指定した位置を入力します。 値 繰り返し属性の値。 値の指定 実際の値を指定する場合にこのオプションを選択します。次に、保 存する値を入力します。 エイリアスの指定 実行時にエイリアスからの値を解決する場合に選択します。ドロップ ダウン リストにエイリアスが表示されない場合、そのプロジェクトには エイリアスが設定されていません。 エイリアス セットの管理については、エイリアス、エイリアス値、および エイリアス セット (77ページ) を参照してください。 5. 設定が終わったら [OK] をクリックします。 繰り返し属性値の削除 繰り返し属性は、2 つ以上の値を持つことが可能な属性です。たとえば、ドキュメントには複数の作 成者がいる場合があるため、ドキュメント オブジェクトの作成者属性は繰り返し属性です。 繰り返し属性から 1 つまたは複数の値を削除するには 1. ライフサイクル状態ダイアグラムで、1 つまたは複数の繰り返し属性値を削除する状態をク リックします。 116 EMC Documentum Composer バージョン 7.2 ユーザ ガイド ライフサイクルの管理 2. [プロパティ] ペインの [アクション] タブをクリックします。 [アクション] ページが表示されます。 3. [繰り返し属性から値を削除] リンクをクリックします。 [繰り返し属性から値を削除] ダイアログ ボックスが表示されます。 4. 属性を選択し、次の表の説明に従って、削除する値またはエイリアスを指定します。 プロパティ 説明 属性 繰り返し属性の名前。[属性] フィールドに名前を入力するか、ド ロップダウン リストから名前を選択します。リストには、ライフサイ クルに割り当てられているプライマリ オブジェクトに対して有効 な属性のみが表示されます。 すべての値を削除 繰り返し属性からすべての値を削除するには、このオプションを選 択します。 指定した値を削除 特定の値またはエイリアスを削除する場合はこのオプションを選択 し、[値] セクションにその値またはエイリアス セットを入力します。 値 繰り返し属性の値。 値の指定 属性から特定の値を削除する場合はこのオプションを選択し、 値を入力します。 エイリアスの指定 実行時に解決し、削除するエイリアスを指定するには、このオプ ションを選択します。次に、ドロップダウン リストからエイリアス を選択します。選択したエイリアスは、実行時に解決される値か ら削除されます。 5. 設定が終わったら [OK] をクリックします。 属性の設定 [属性を設定] アクションでは、状態の属性 (ドキュメントの表題やバージョンなど) を指定できます。 ライフサイクル状態の属性を設定するには 1. ライフサイクル状態ダイアグラムで、属性を設定する状態をクリックします。 2. [プロパティ] ペインの [アクション] タブをクリックします。 [アクション] ページが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 117 ライフサイクルの管理 3. [属性を設定] リンクをクリックします。 [属性を設定] ダイアログ ボックスが表示されます。 4. 属性を選択し、次の表の説明に従って、その属性のインデックスと値を入力します。 プロパティ 説明 属性 属性の名前。[属性] フィールドに名前を入力するか、ドロップダウ ン リストから名前を選択します。リストには、ライフサイクルに割り 当てられているプライマリ オブジェクトに対して有効な属性のみ が表示されます。 インデックス 入力するインデックス値に従って属性の位置が格納されます。すべ て属性が 1 つのリストに格納されるため、インデックス値は属性名とと もに格納する必要があります。 値 属性の値。 値の指定 属性を値として保存したい場合はこのオプションを選択し、値を入 力します。 エイリアスの指定 実行時にエイリアスから値を解決する場合に選択し、ドロップダ ウン リストからエイリアスを選択します。ドロップダウン リストにエイ リアスが表示されない場合、そのプロジェクトにはエイリアスが設 定されていません。 エイリアス セットの管理については、エイリアス、エイリアス値、および エイリアス セット (77ページ) を参照してください。 5. 設定が終わったら [OK] をクリックします。 バージョン ラベルの追加 ドキュメントが特定の状態に移行する場合にそのドキュメントに追加するバージョン ラベルを 指定できます。 バージョン ラベルを指定するには 1. ライフサイクル状態ダイアグラム内で、ドキュメントのバージョン ラベルを指定する状態をクリッ クします (その状態に移行するドキュメントにバージョン ラベルが指定されます)。 2. [プロパティ] ペインの [アクション] タブをクリックします。 [アクション] ページが表示されます。 118 EMC Documentum Composer バージョン 7.2 ユーザ ガイド ライフサイクルの管理 3. [バージョン ラベルを設定] リンクをクリックします。 [バージョン ラベルを設定] ダイアログ ボックスが表示されます。 4. [バージョン ラベル] フィールドにバージョン ラベルを入力してから、[OK] をクリックして 変更を保存します。 バージョン ラベルの削除 [バージョン ラベルを削除] リンクをクリックして、ライフサイクル状態からバージョン ラベルを削 除します。 バージョン ラベルを削除するには 1. ライフサイクル状態ダイアグラム内で、その状態に移行するドキュメントのバージョン ラベルを 削除する状態をクリックします。 2. [プロパティ] ペインの [アクション] タブをクリックします。 [アクション] ページが表示されます。 3. [バージョン ラベルを削除] リンクをクリックします。 [バージョン ラベルを削除] ダイアログ ボックスが表示されます。 4. [バージョン ラベル] フィールドにバージョン ラベルを入力してから、[OK] をクリックして 変更を保存します。 ロケーション リンクの設定 ロケーション リンクでは、フォルダ、キャビネット、エイリアス、またはローカル式などの特定のロ ケーションにドキュメントをリンクできます。リンクは、ドキュメントが対象の状態に移行すると きに作成されます。 ドキュメントを特定のロケーションにリンクするには 1. ライフサイクル状態ダイアグラムで、ロケーション リンクを設定する状態をクリックします。 2. [プロパティ] ペインの [アクション] タブをクリックします。 [アクション] ページが表示されます。 3. [ロケーション リンクを設定] リンクをクリックします。 [ロケーション リンク] ダイアログ ボックスが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 119 ライフサイクルの管理 4. いずれかのロケーション リンク オプションを選択し、次の表の説明に従ってドキュメントがこの 状態に移行するときにリンクする場所を入力します。 プロパティ 説明 キャビネットまたはフォルダの名前を選択する 状態をキャビネットまたはフォルダにリンクするに は、このオプションを選択します。[選択] をクリッ クします。[フォルダ サブタイプ アーティファクト] ダイアログ ボックスが表示されます。リストボックス からキャビネットまたはフォルダを選択します。 ロケーション エイリアスを選択する 状態をロケーション エイリアスにリンクするには、 このオプションを選択します。ロケーション エイ リアスを入力するか、ドロップダウン リストからエ イリアスを選択します。 属性とロケーション式を入力または選択する 状態を属性とロケーション式にリンクするには、こ のオプションを選択します。 属性 ロケーション式の属性の名前を表す文字列。属 性名を入力するか、ドロップダウン リストから属性 を選択します。リストには、ライフサイクルに割り当 てられているプライマリ オブジェクトに対して有 効な属性のみが表示されます。 ロケーション式 [属性] ドロップダウン リストから選択した属性と 関連付けられる動的なロケーション パス。ロケー ション式を入力します。ロケーション パスは実 行時に解決されます。 5. 設定が終わったら [OK] をクリックします。 すべてのリンクの移動 [ロケーションを設定してすべてのリンクを移動] リンクでは、すべてのリンクを特定のロケーショ ンに移動できます。 すべてのロケーション リンクを移動するには 1. ライフサイクル状態ダイアグラムで、すべてのリンクを移動する状態をクリックします。 120 EMC Documentum Composer バージョン 7.2 ユーザ ガイド ライフサイクルの管理 2. [プロパティ] ペインの [アクション] タブをクリックします。 [アクション] ページが表示されます。 3. [すべてのリンクをロケーションに移動] をクリックします。 [すべてのリンクを移動] ダイアログ ボックスが表示されます。 4. いずれかのロケーション リンク オプションを選択し、次の表の説明に従って、ドキュメントがこ の状態に移行するときにすべてのリンクが移動されるロケーションを入力します。 プロパティ 説明 キャビネットまたはフォルダの名前を選択する すべてのリンクをキャビネットまたはフォルダに 移動するには、このオプションを選択します。 [選択] をクリックします。[フォルダ サブタイプ アーティファクト] ダイアログ ボックスが表示され ます。リストボックスからキャビネットまたはフォル ダを選択します。 ロケーション エイリアスを選択する すべてのリンクをロケーション エイリアスに移動 するには、このオプションを選択します。ロケー ション エイリアスを入力するか、ドロップダウン リ ストからエイリアスを選択します。 属性とロケーション式を入力または選択する すべてのリンクを属性とロケーション式に移動す るには、このオプションを選択します。 属性 ロケーション式の属性の名前を表す文字列。属 性名を入力するか、ドロップダウン リストから属性 を選択します。リストには、ライフサイクルに割り当 てられているプライマリ オブジェクトに対して有 効な属性のみが表示されます。 ロケーション式 [属性] ドロップダウン リストから選択した属性と 関連付けられる動的なロケーション パス。ロケー ション式を入力します。ロケーション パスは実 行時に解決されます。 5. 設定が終わったら [OK] をクリックします。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 121 ライフサイクルの管理 ロケーション リンクの削除 [ロケーション リンクの削除] ダイアログ ボックスを使用して、ロケーション リンクの削除します。 ロケーション リンクの削除 1. ライフサイクル状態ダイアグラムで、ロケーション リンクを削除する状態をクリックします。 2. [プロパティ] ペインの [アクション] タブをクリックします。 [アクション] ページが表示されます。 3. [ロケーション リンクの削除] リンクをクリックします。 [ロケーション リンクの削除] ダイアログ ボックスが表示されます。 4. いずれかのロケーション リンク オプションを選択し、次の表の説明に従って、ドキュメントがこ の状態に移行するときに削除するロケーションを入力します。 122 プロパティ 説明 キャビネットまたはフォルダの名前を選択する キャビネットまたはフォルダへのリンクを削除する には、このオプションを選択します。[選択] をク リックします。[フォルダ サブタイプ アーティファク ト] ダイアログ ボックスが表示されます。リストボック スからキャビネットまたはフォルダを選択します。 ロケーション エイリアスを選択する ロケーション エイリアスへのリンクを削除するに は、このオプションを選択します。ロケーション エ イリアスを入力するか、ドロップダウン リストからエ イリアスを選択します。 属性とロケーション式を入力または選択する 属性とロケーション式へのリンクを削除するには、 このオプションを選択します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド ライフサイクルの管理 プロパティ 説明 属性 ロケーション式の属性の名前を表す文字列。属 性名を入力するか、ドロップダウン リストから属性 を選択します。リストには、ライフサイクルに割り当 てられているプライマリ オブジェクトに対して有 効な属性のみが表示されます。 ロケーション式 [属性] ドロップダウン リストから選択した属性と 関連付けられる動的なロケーション パス。ロケー ション式を入力します。ロケーション パスは実 行時に解決されます。 5. 設定が終わったら [OK] をクリックします。 ドキュメント レンダラーの割り当て Composer では、Auto Render Pro for Windows または Auto Render Pro for Macintosh を使用し てライフサイクルに添付されているドキュメントを表示します。 添付されているドキュメントにレンダリング アプリケーションを割り当てるには 1. ライフサイクル状態ダイアグラムで、レンダリング アプリケーションを設定する状態をクリッ クします。 2. [プロパティ] ペインの [アクション] タブをクリックします。 [アクション] ページが表示されます。 3. [レンディション タイプを設定] をクリックします。 [レンディション タイプ] ダイアログ ボックスが表示されます。 4. 次のいずれかのレンダリング オプションを選択します。 • Windows オペレーティング システムがインストールされたマシンで Composer を実行してい る場合は、AutoRender Pro for Windows を選択する。 • Macintosh オペレーティング システムがインストールされたマシンで Composer を実行して いる場合は、AutoRender Pro for Macintosh を選択する。 5. 設定が終わったら [OK] をクリックします。 ドキュメント所有者の割り当て デフォルトでは、ドキュメントの所有者は、そのドキュメントを作成したユーザになります。ただし、 別のユーザまたはグループに所有権を割り当てることも可能です。スーパーユーザは、他の ユーザを所有者として割り当てることができます。グループをオブジェクトの所有者として割り 当てる場合は、スーパーユーザであるか、またはドキュメントの所有者で、かつ所有権を割り当 てようとしているグループのメンバーであることが必要です。 注 記 : ドキュメントに所有者を割り当てるには、ライフサイクルに割り当てられているエイリアス セットが必要です。エイリアス セットは、ライフサイクルのプロパティ ページの [全般] タブで割 り当てることができます。ライフサイクルへのエイリアス セットの割り当てについては、ライフサ イクルのプロパティの設定 (109ページ) を参照してください。 ドキュメントに所有者を割り当てるには EMC Documentum Composer バージョン 7.2 ユーザ ガイド 123 ライフサイクルの管理 1. ライフサイクル状態ダイアグラムで、ドキュメント所有者を割り当てる状態をクリックします。ライ フサイクル エディタの下に [プロパティ] ペインが表示されます。 2. [プロパティ] ペインの [アクション] タブをクリックします。 [アクション] ページが表示されます。 3. [所有者を設定] リンクをクリックします。 [ドキュメント所有者] ダイアログ ボックスが表示されます。 4. 次の表の説明に従って、いずれかのユーザ オプションを選択します。 プロパティ 説明 ユーザの値 ユーザ値を割り当てるには、このオプションを選択します。[選択] をクリッ クします。[プリンシパル (ユーザまたはグループ) インストール パラメー タ] ダイアログ ボックスが表示されます。リストボックスからユーザ値を選 択するか、[新規作成] をクリックしてユーザ値を作成します。 インストール パラメータは、インストール アプリケーションによってアプリ ケーションがインストールされ、かつインストールを行うユーザによってパ ラメータが指定される際にすべて解決されます。 ユーザ エイリアス ユーザ エイリアスを割り当てるには、このオプションを使用します。ドロッ プダウン リストからエイリアスを選択します。エイリアスは、実行時に Content Server によって解決されます。 5. [OK] をクリックして変更を保存します。 アクセス権セットの設定 アクセス権セット (アクセス コントロール リスト (ACL) とも呼ばれる) では、ライフサイクルに添付 されたドキュメントに対してユーザが実行できる処理 (読み取り、編集、バージョンの作成、 削除など) を指定します。 ライフサイクルの状態にアクセス権セットを割り当てるには 1. ライフサイクル状態ダイアグラムで、アクセス権セットを割り当てる状態をクリックします。 2. [プロパティ] ペインの [アクション] タブをクリックします。 [アクション] ページが表示されます。 3. [アクセス権セットを設定] リンクをクリックします。 [アクセス権セット] ダイアログ ボックスが表示されます。 124 EMC Documentum Composer バージョン 7.2 ユーザ ガイド ライフサイクルの管理 4. 次の表の説明に従って、アクセス権セットのオプションのいずれかを選択します。 プロパティ 説明 アクセス権セット ライフサイクルの状態にアクセス権セットを割り当てるには、このオプショ ンを選択します。[選択] をクリックし、[アクセス権セット (ACL) テンプレー ト アーティファクト] ダイアログ ボックスを開きます。リストからアクセス権 セットを選択するか、[新規作成] をクリックしてアクセス権セットを作成し ます。アクセス権セットについては、アクセス権、アクセス権セット、アクセ ス権セット テンプレート (143ページ) を参照してください。 アクセス権セット エイリアス アクセス権セット エイリアスを割り当てるには、このオプションを選択し、ド ロップダウン リストからアクセス権セット エイリアスを選択します。アクセス 権セットについては、アクセス権、アクセス権セット、アクセス権セット テ ンプレート (143ページ) を参照してください。 変更後の情報の設定 状態の移行が完了すると、変更後プロシージャが実行されます。トランザクション内で発生する移 行の一部が完了すると、システムによって変更後プロシージャが実行されます。変更後プロシー ジャで発生したエラーによって移行がエラーになることはありません。 ライフサイクルの状態に変更後プロシージャを割り当てるには 1. ライフサイクル状態ダイアグラムで、変更後プロシージャを割り当てる状態をクリックします。 2. [プロパティ] ペインの [変更後] タブをクリックします。 [モジュール] ページが表示されます。 3. [選択] をクリックします。 [モジュール アーティファクト] ダイアログ ボックスが表示されます。 4. リストから変更後プロシージャを選択するか、[新規作成] をクリックして変更後プロシー ジャを作成します。 プロシージャの作成方法については、プロシージャの作成 (153ページ) を参照してください。 状態属性の設定 状態属性には、状態のラベル、ヘルプ テキスト、コメント、および属性のプロパティが含まれま す。必須と空白不可のプロパティは、オブジェクトがその状態に移行するときではなく、クライ アント アプリケーションでオブジェクトを検証するとき (通常、オブジェクトを保存またはチェッ クインする場合) に選択されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 125 ライフサイクルの管理 状態属性を設定するには 1. ライフサイクル状態ダイアグラムで、属性を設定する状態をクリックします。 2. [プロパティ] ペインの [属性] タブをクリックします。 [属性] ページが表示されます。 ページには、ライフサイクルに割り当てるプライマリ オブジェクトに対して有効な属性の みが表示されます。 3. 任意の属性のプロパティを変更するには、[属性] テーブルから属性を選択し、[プロパ ティを変更...] をクリックします。 選択した属性の [プロパティ] ダイアログ ボックスが表示されます。 4. 使用可能な任意のオプションを選択して属性のプロパティを設定し、[OK] をクリックします。 [属性] ページの [タイプ定義に復元] をクリックすると、属性の元のタイプ定義に戻すこ とができます。 126 EMC Documentum Composer バージョン 7.2 ユーザ ガイド ライフサイクルの管理 ライフサイクル状態の削除 ライフサイクルの状態を削除するには 1. ライフサイクル状態ダイアグラムで、削除する状態を選択します。 2. 状態を右クリックして、ドロップダウン メニューから [削除] を選択します。 ライフサイクルの削除 ライフサイクルを削除するには 1. Composer プロジェクトの [Documentum Navigator] ビューで、[Artifacts] フォルダを展開します。 2. [ライフサイクル] を右クリックし、ドロップダウン メニューから [削除] を選択します。 [Delete Resources (リソースの削除)] ダイアログ ボックスが表示されます。 3. [OK] を削除してライフサイクルを削除します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 127 ライフサイクルの管理 128 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 11 章 メソッドとジョブの管理 この章では、次について説明します。 • メソッドとジョブ • メソッドの作成 • ジョブの作成 メソッドとジョブ メソッドは、リポジトリ内のメソッド オブジェクトで表される実行可能プログラムです。プログラム は、Docbasic スクリプト、Java メソッド、または C++ など別のプログラミング言語で書かれたプログ ラムのいずれでもかまいません。 ジョブはメソッドの実行 (たとえば、コンテンツをストレージ領域の間に転送) を自動化します。ジョ ブの属性により、実行スケジュールが定義され、実行のオンまたはオフが切り替えられます。 メソッドの作成 メソッドの作成には、メソッド エディタを使用します。 メソッドを作成するには 1. Composer プロジェクトで、[Artifacts] フォルダを展開し、[メソッド] を右クリックします。[新規 作成] > [メソッド] を選択します。 [新しいメソッド] ダイアログ ボックスが表示されます。 2. 新しいメソッドの名前を入力するか、デフォルトの名前を受け入れ、[終了] をクリックします。 [メソッド] エディタが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 129 メソッドとジョブの管理 3. 次の表の説明に従って、メソッドのプロパティを入力します。 パラメータ 説明 全般 名前 メソッドの名前を表す文字列。メソッド名は dm_methodname の 形式で指定しないでください。この命名規則はデフォルトの Documentum オブジェクト用に予約されています。 タイプ このメソッドで使用する言語またはプログラムを指定します。 次のタイプのいずれかを選択します。 • java: メソッドは Java で書かれており、Java メソッド サー バで実行されます。 • dmbasic: メソッドは Docbasic で書かれています。 • dmawk: メソッドは dmawk で書かれています。 • program: メソッドはプログラムです。 コマンド メソッドを起動するコマンド。 実行コントロール 130 非同期実行 プロシージャを非同期に実行するかどうかを指定します。メ ソッドがメソッド サーバまたは Content Server で起動され、コマ ンド ラインで SAVE_RESULTS が TRUE に設定される場合、こ のパラメータは無視されます。 同期実行 メソッドを同時に実行するかどうかを指定します。 タイムアウト メソッドがタイムアウトするまでの最小時間、デフォルト時間、 最大時間を指定します。 サーバとして実行 メソッドをサーバ アカウントとして実行するかどうかを指定し ます。選択した場合、メソッドはサーバ アカウントとして実 行されます。 起動のトレース 実行しているプログラムで生成される内部のトレース メッセー ジを記録するかどうかを指定します。選択した場合、メッセー ジはセッション ログに保存されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド メソッドとジョブの管理 パラメータ 説明 メソッド サーバを使用 Dmbasic メソッドや Java メソッドの実行にメソッド サーバまたは アプリケーション サーバを使用するかどうかを指定します。選 択した場合、メソッド サーバまたはアプリケーション サーバが使 用されます。選択しない場合、Content Server が使用されます。 直接起動 プログラムをオペレーティング システムの system API 呼び出し または exec API 呼び出しのどちらで実行するかを指定します。 選択した場合、サーバは exec 呼び出しを使用してプロシー ジャを実行します。このチェックボックスをオフにした場合、サー バは system 呼び出しを使用してプロシージャを実行します。 ワークフロー メソッドとして使用 このメソッドをワークフローで使用するかどうかを指定します。 4. 変更を保存します。 ジョブの作成 ジョブによって、メソッドの実行が自動化されます。 ジョブを作成するには 1. Composer プロジェクトで、[Artifacts] フォルダを展開し、[ジョブ] を右クリックします。[新規 作成] > [ジョブ] を選択します。 [新しいジョブ] ダイアログ ボックスが表示されます。 2. 新しいジョブの名前を入力するか、デフォルトの名前を受け入れ、[終了] をクリックします。 ジョブ エディタが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 131 メソッドとジョブの管理 3. 次の表の説明に従って、[情報] セクション、[ジョブのスケジュール] セクション、[実行間隔] セ クションにジョブのプロパティを入力します。 パラメータ 説明 情報 名前 ジョブの名前を表す文字列。 主題 ジョブに関するコメントまたは説明。 メソッド このジョブにより自動化されるメソッド。[選択] をクリックして [Documentum メソッド アーティファクト] ダイアログ ボックスか らメソッドを選択するか、[メソッド] をクリックしてこのジョブの メソッドを作成します。 メソッドのデータ ジョブに関連付けられたメソッドで使用されるデータ。このプロ パティは、実行中に必要に応じて書き込みや読み取りを行うメ ソッドで使用可能です。[メソッドのデータ] フィールドにデータを 入力して [追加] をクリックします。 標準引数 標準引数をメソッドに渡す場合に選択します。標準引数は 次のとおりです。 • リポジトリ所有者 • リポジトリ名 • ジ ョ ブ ID • トレースのレベル カスタム引数 132 1 つまたは複数のカスタム引数をメソッドに渡す場合に選択し ます。[カスタム引数] フィールドに引数を入力して [追加] をク リックします。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド メソッドとジョブの管理 パラメータ 説明 エラー発生時に機能停止 基本のメソッドが失敗したときにアプリケーションでジョブの実行 を停止する場合に選択します。 トレースのレベル メソッドのトレースを制御します。0 以外の値でトレース機能 がオンになります。デフォルトでは、トレース レベルは 0 に設 定されています。 このジョブを非アクティブにする ジョブを非アクティブにする場合に選択します。 ジョブのスケジュール 最大実行数 ジョブの最大実行回数を指定します。 保存時に一度実行してから、スケ ジュールどおりに実行 ジョブを保存した直後に実行してから、設定したスケジュールに 従って実行する場合に選択します。 実行間隔 実行間隔 分、時間、日、または週ごとにこのジョブを実行する回数を 指定します。 日付指定 このジョブを実行する日を指定します。ジョブは、毎週一度、毎 月一度、または毎年一度、同じ日に実行可能です。 4. 変更を保存します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 133 メソッドとジョブの管理 134 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 12 章 モジュールの管理 この章では、次について説明します。 • モジュール • モジュールの作成 • モジュールのデプロイの設定 • モジュールの実行時環境の設定 モジュール モジュールは、実行可能なビジネス ロジックとサポート マテリアル (サードパーティ ソフトウェアや ドキュメントなど) から構成されます。モジュールは、モジュールの機能実行のための実装クラスと インターフェイス クラスを含む JAR ファイル、モジュールが依存するインターフェイス クラスで構成 されます。モジュールには、Java ライブラリやドキュメントを含めることもできます。 モジュールには次の 3 種類があります。 • サービスベース モジュール (SBO) SBO は、特定のオブジェクト タイプやリポジトリに固有でない機能を提供します。たとえば、SBO を使用してユーザの受信ボックスをカスタマイズできます。 • タイプベース モジュール (TBO) TBO は、オブジェクト タイプに固有の機能を提供します。たとえば、TBO を使用して、カスタム ドキュメント サブタイプのタイトル、キーワード、主題のプロパティを検証できます。 • アスペクト アスペクトは、特定のオブジェクトに適用される機能を提供します。たとえば、アスペクトを使 用して、あるプロパティの値を、別のプロパティの値に基づいて設定できます。アスペクト モ ジュールは、別のエディタであるアスペクト モジュール エディタを使用して作成します (アス ペクト タイプの作成 (81ページ) を参照)。 モジュールの作成 モジュールを作成するには、モジュール エディタを使用します。 モジュールを作成するには 1. Composer プロジェクトで、[Artifacts] フォルダを展開し、[モジュール] を右クリックします。 [新規作成] > [モジュール] を選択します。 [新しいモジュール] ダイアログ ボックスが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 135 モジュールの管理 2. 新しいモジュールの名前を入力するか、デフォルトの名前を受け入れ、[終了] をクリックします。 モジュール エディタの [全般] タブが表示されます。 3. 次の表の説明に従って、[情報]、[説明]、[必須モジュール]、[Javadoc]、[コア JAR] セクション に必須のプロパティとオプションのプロパティを入力します。 プロパティ 説明 情報 名前 モジュールの名前を表す文字列。必須のパラメータです。 モジュールのタイプに関連付けられたモジュール名を次 のとおり入力します。 • SBO モジュール: SBO の完全修飾プライマリ インター フェイス名を入力します。 • TBO モジュール: 対応するオブジェクト タイプの名前を 入力します。最大 255 文字の名前を入力できます。 136 EMC Documentum Composer バージョン 7.2 ユーザ ガイド モジュールの管理 プロパティ 説明 タイプ モジュールのタイプを表す文字列。必須のパラメータです。 モジュール タイプを入力するか、ドロップダウン リストから タイプを選択します。 Composer では、次の標準モジュール タイプが提供され ます。 • 標 準 モ ジ ュ ー ル : 一般的なモジュールを提供します。 • TBO: オブジェクト タイプに固有の機能を提供します。 たとえば、TBO を使用して、カスタム ドキュメント サブタ イプのタイトル、主題、キーワードのプロパティを検証で きます。 • SBO: 特定のオブジェクト タイプやリポジトリに固有でな い機能を提供します。たとえば、SBO を使用してユーザ の受信ボックスをカスタマイズできます。 説明 作成者 モジュール プロバイダの作成者。オプションのパラメータ。 説明 モジュールの説明 (255 文字以内)。オプションのパラメータ。 必須モジュール このモジュールが正常に機能するのに必要なモジュー ルを指定します。 [追加] をクリックし、[モジュール アーティファクト] ダイアロ グ ボックスを開きます。リストボックスからモジュールを選 択して [OK] をクリックするか、[新規作成] をクリックして モジュールを作成します。 Javadoc 実行時にモジュールと共にダウンロードできる Javadoc と 他のリソースを指定します。 [選択] をクリックすると、[システム オブジェクト サブタイプ アーティファクト] ダイアログ ボックスが開きます。リストから Javadoc またはリソース コンテンツを含むシステム オブジェ クトを選択するか、[新規作成] をクリックして、ダウンロード するコンテンツを含むシステム オブジェクトを作成します。 Javadoc はコンテンツを含む zip ファイルである必要があり ます。 コ ア JAR 実装 JAR モジュールの実装。必須のパラメータです。 [追加] をクリックして、ローカル マシンから実装 JAR を 追加します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 137 モジュールの管理 プロパティ 説明 クラス名 モジュールのプライマリ Java 実装クラス。必須のパラメータ です。 TBO は IDfBusinessObject インターフェイスを実装する必要 があり、SBO は IDfService インターフェイスを実装する必要 があります。また、すべてのモジュールは IDfModule イン ターフェイスを実装する必要があります。 インターフェイス JAR このモジュールが実装する Java インターフェイス。オプ ションのパラメータ。 [追加] をクリックして、ローカル マシンからインターフェイ ス JAR を追加します。 4. [デプロイ] タブをクリックし、モジュールのデプロイを設定します (モジュールのデプロイの設 定 (138ページ) を参照)。 5. [実行時] タブをクリックし、モジュールの実行時環境の設定 (139ページ) の説明に従ってこの モジュールの実行時環境を設定します。 モジュールのデプロイの設定 [デプロイ] タブでは、Java ライブラリおよびその他のモジュールを、独自に作成または編集 するモジュールにリンクすることができます。 モジュールのデプロイを設定するには 1. モジュール エディタで [デプロイ] タブをクリックします。 [デプロイ] ビューが表示されます。 2. このモジュールで使用する Java ライブラリを追加するために、[Java ライブラリ] セクションの [追加] をクリックします。 [JAR 定義 Java ライブラリ アーティファクト] ダイアログ ボックスが表示されます。 138 EMC Documentum Composer バージョン 7.2 ユーザ ガイド モジュールの管理 リストボックスから Java ライブラリを選択して [OK] をクリックするか、[新規作成] をクリックして Java ライブラリを作成します。このモジュールには既存の Java ライブラリのみをリンクできます。 複数のモジュールによって共有されている既存ライブラリは変更できません。Java ライブラリの 作成の詳細については、Java ライブラリのリンクと設定 (105ページ) を参照してください。 3. [添付ファイル] セクションで、このモジュールがデプロイされるときにダウンロードできる Javadoc およびその他のリソースを指定します。 4. ログ出力セクションで、ダウンロード後のメッセージを指定して、メッセージのログ レベル を選択します。 ログ レベルに指定できる値は次のとおりです。 • 警告: ダウンロード後のメッセージは警告として記録されます。 • なし: ダウンロード後のメッセージは記録されません。 • 情報: ダウンロード後のメッセージは情報メッセージとして記録されます。 • デバッグ: ダウンロード後のメッセージはデバッグ レベルで記録されます。 5. 変更を保存します。 モジュールの実行時環境の設定 実行時環境では、実行時環境に必要なオプションのプロパティ (バージョン要件、Java システム プ ロパティ、静的にデプロイされたクラス、ローカル リソースなど) を設定できます。 実行時環境を設定するには 1. モジュール エディタで [実行時] タブをクリックします。 [実行時環境] ビューが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 139 モジュールの管理 2. 次の表を参照して、バージョン要件、Java システム プロパティ、静的にデプロイされたクラス、 ローカル リソースを指定します。 140 プロパティ 説明 バージョン要件 このセクションでは、モジュールが正常に機能するため にクライアントで必要な DFC および Java VM のバージョ ンを指定します。 必須 DFC バージョン このモジュールが正常に機能するために必要な、クライアン ト マシンの DFC の必須バージョン。 必須 VM バージョン このモジュールが正常に機能するために必要な、クライアン ト マシンの Java VM の必須バージョン。 Java システム プロパティ このセクションでは、Java のシステム プロパティを名前と値 のペアとして指定します。モジュールがダウンロードされると きに、指定されたすべての Java のプロパティがクライアン ト マシンでのプロパティと一致するかどうか、そのクライア ント マシンがチェックされます。[追加] をクリックして名前 のプレースホルダと Java システム プロパティの値を入力 し、次に [名前] フィールドと [値] フィールドをクリックして、 プロパティの名前と値を編集します。 名前 Java システム プロパティの名前。 値 Java システム プロパティの名前に対応する値。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド モジュールの管理 プロパティ 説明 静的にデプロイされたクラス このセクションでは、モジュールが正常に機能するため に必要な静的 Java クラスを指定します。モジュールがダ ウンロードされるときに、指定した Java クラスのクラス パス がチェックされます。 完全修飾クラス名 Java クラスの完全修飾名。クラス名を入力して [追加] を クリックします。 ローカル リソース このセクションでは、モジュールが正常に機能するために ローカル マシンで必要なファイルを指定します。モジュー ルがダウンロードされるときに、指定したファイルがあるかど うかクライアント マシンがチェックされます。 デプロイメントへの相対ファイル パス ファイルの絶対パス。ファイル名とパスを入力して [追加] を クリックします。 3. 変更を保存します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 141 モジュールの管理 142 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 13 章 アク セ ス 権 セ ッ ト ) を 管 理 す る ACL (ア この章では、次について説明します。 • アクセス権、アクセス権セット、アクセス権セット テンプレート • アクセス権セット テンプレートの作成 • 標準またはパブリックのアクセス権セットの作成 アクセス権、アクセス権セット、アクセス権セット テ ンプレート リポジトリ内のフォルダおよびドキュメントへのアクセスは、組織のセキュリティ制限の対象となりま す。リポジトリ内のコンテンツはすべて、オブジェクト アクセス権と関連付けられます。オブジェクト アクセス権により、リポジトリ内の各オブジェクト (ファイル、フォルダ、キャビネットなど) に対する ユーザのアクセス権が決定されます。オブジェクト アクセス権によって、特定のアクションを実行す るユーザの権限も管理されます。オブジェクトのアクセス権には、次の 2 つの種類があります。 • 基 本 : リポジトリの各オブジェクトに必須。 • 拡 張 : 省略可能。 アクセス権セット (アクセス コントロール リストまたは ACL とも呼ばれる) は、基本アクセス権と拡張 アクセス権の設定です。アクセス権セットは、ユーザおよびユーザ グループと、それらが実行で きるアクションを一覧表示するリポジトリ内のオブジェクトに割り当てられます。各リポジトリ オブ ジェクトには、適用されるオブジェクト レベルのアクセス権 (そのオブジェクトにアクセス可能な ユーザも含む) を定義するアクセス権セットがあります。アクセス権に応じて、ユーザは、オブ ジェクトの作成、ファイル管理操作 (ファイルのインポート、コピー、リンクなど)、プロセスの起動 (ワークフローへのファイル送信など) を行うことができます。 ACL は、システム オブジェクトにオブジェクトレベルのアクセス権を付与するために Content Server が使用するメカニズムです。アクセス権セットには、ユーザまたはグループを識別する 1 つま たは複数のエントリと、ユーザまたはグループに割り当てられたオブジェクトレベルのアクセス 権が含まれます。Composer では、次のようなアクセス権セット テンプレート、パブリック ACL、 および標準 ACL を作成できます。 • テ ン プ レ ー ト : アクセス権セット テンプレートを作成します。テンプレート ACL を使用すると、ア プリケーション、ワークフロー、およびライフサイクルを移植することができます。たとえば、テ ンプレート ACL を使用するアプリケーションは、ACL が実際のドキュメントに割り当てられる まで ACL エントリ内のユーザまたはグループが定義されないので、企業内のさまざまな 部署で使用することができます。 • パ ブ リ ッ ク : リポジトリ内のどのユーザでも使用できるパブリック ACL を作成します。パブリッ ク ACL は、リポジトリ内のすべてのユーザが使用できます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 143 ACL (アクセス権セット) を管理する • 標 準 : 作成者であるユーザまたはグループだけが使用できる標準 ACL を作成します。 基本アクセス権 基本アクセス権によって、オブジェクトのコンテンツにアクセスしたり、それらのコンテンツを操作し たりする権限が付与されます。7 つの基本アクセス権レベルは階層的であり、1 つ上のアクセ ス レベルには、前のアクセス レベルの権限がすべて含まれています。たとえば、関連付けア クセス権を持つユーザは、読み取りと参照のアクセス権も持ちます。次の表で、基本アクセス 権について説明します。 基本アクセス権 説明 なし オブジェクトにアクセスできません。 参照 読み取り ユーザはオブジェクトのプロパティを表示できますが、オブジェクトのコン テンツは表示できません。 オブジェクトのプロパティとコンテンツの両方を表示できます。 関連付け 前述の操作に加え、オブジェクトに注釈を追加できます。 バージョン 前述の操作に加え、オブジェクトのコンテンツの変更、アイテムの新し いバージョンのチェックイン (新しいバージョン番号を使用) が可能で す。ユーザは、既存のバージョンを上書きしたり、アイテムのプロパティ を編集したりできません。 書き込み 前述の操作に加え、オブジェクトのプロパティを編集したり、オブジェ クトを同じバージョンでチェックインできます。 削除 前述の操作がすべて可能であるほか、オブジェクトを削除できます。 拡張アクセス権 拡張アクセス権は、オブジェクトに対して特定のアクションを実行する権限を必要に応じて付与す るもので、基本アクセス権に加えて割り当てられます。拡張アクセス権には階層を構成しない 6 つのレベルがあり、各アクセス レベルは明示的に割り当てる必要があります。次の表で、拡張 アクセス権について説明します。 拡張アクセス権 説明 プロシージャの実行 スーパーユーザは、アイテムの所有者を変更でき、またプロシージャの 実行を使用して特定のオブジェクト タイプに対して外部プロシージャを 実行できます。プロシージャは、dm_procedure オブジェクトとしてリポ ジトリに保存される Docbasic プログラムです。 ロケーションの変更 ユーザは、リポジトリ内のフォルダから別のフォルダにオブジェクトを移動 できます。オブジェクトを移動するには、書き込みアクセス権も必要で す。オブジェクトをリンクする場合、ユーザは参照アクセス権も必要です。 状態の変更 ユーザは、ライフサイクルが適用されているアイテムの状態を変更で きます。 アクセス権の変更 ユーザは、オブジェクトの基本アクセス権を変更できます。 144 EMC Documentum Composer バージョン 7.2 ユーザ ガイド ACL ( ア ク セ ス 権 セ ッ ト ) を 管 理 す る 拡張アクセス権 説明 所有権の変更 ユーザは、オブジェクトの所有者を変更できます。オブジェクトの所有者 またはスーパーユーザでない場合、書き込みアクセス権も必要です。 拡張削除権 ユーザは、オブジェクトの削除のみが可能です。たとえば、ユーザがド キュメントの削除は可能だが読み取りはできないように指定できます。こ の拡張アクセス権は、別個のアクセス権が一般的な、レコード管理アプリ ケーションの場合に便利です。 アクセス権セット テンプレートの作成 アクセス権セット テンプレートを使用すると、アプリケーション、ワークフロー、およびライフサイクル を移植することができます。たとえば、アクセス権セット テンプレートを使用するアプリケーション は、ACL が実際のドキュメントに割り当てられるまで ACL エントリ内のユーザまたはグループが定 義されないので、企業内のさまざまな部署で使用することができます。 アクセス権セット テンプレートには、特定のユーザまたはグループを追加できます。アクセス権セッ ト テンプレートは、アクセス権セットのテンプレートとしても使用できます。アクセス権セットが存在す るが、このアクセス権セットにだれを割り当てるかをまだ決定してないという場合を考えてみましょ う。たとえば、次のアクセス権を持つ Template_1 というアクセス権セット テンプレートを設定します。 • dm_owner: VERSION (バージョン設定権) と一部の拡張アクセス権 • dm_world: READ (読み取り権) と一部の拡張アクセス権 • admingroup: DELETE (削除権) と一部の拡張アクセス権 • %superuser: DELETE (削除権) と一部の拡張アクセス権 • %otheruser: BROWSE (参照権) と一部の拡張アクセス権 この例では、アクセス権セット テンプレートが使用される際に解決されるように、%superuser と %otheruser を 1 つのエイリアス セットで設定する必要があります。 アクセス権セット テンプレートを作成するには 1. Composer プロジェクトで、[Artifacts] フォルダを展開し、[アクセス権セット] を右クリックする。 [新規作成] > [アクセス権セット] を選択します。 [新しいアクセス権セット] ダイアログ ボックスが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 145 ACL (アクセス権セット) を管理する 2. [フォルダ] フィールドに、アクセス権セットを作成するプロジェクトのフォルダ パスと名前を入力 するか、[参照] をクリックしてフォルダ リストからプロジェクトを選択します。 3. [アーティファクト名] フィールドにアクセス権セットの名前を入力します。 4. [ACL クラス] フィールドで [テンプレート] を選択し、[終了] をクリックします。 アクセス権セット テンプレート エディタが表示されます。 新しいアクセス権セットの [すべてのユーザとグループ] セクションには、次のような 2 つのデ フォルトのエイリアス エントリが含まれます。 • dm_owner: アクセス権セット テンプレートの所有者。 • dm_world: すべてのリポジトリ ユーザ。 これらのデフォルト エイリアス エントリは、アクセス権セット テンプレートから削除できません。 5. 次の表の説明に従って、[全般] セクションに一般的な情報を入力します。 パラメータ 説明 名前 アクセス権セット テンプレートの名前を入力します。 説明 省略可能。アクセス権セット テンプレートの説明を入力します。 所有者 [選択] をクリックし、アクセス権セット テンプレートの所有者を選択 します。 6. [すべてのユーザとグループ] セクションで、dm_owner エイリアスまたは dm_world エイリアス を選択するか、あるいは次の操作を行います。 • エイリアスの追加 • ユーザの追加 • グループの追加 [ACL エントリ詳細] セクションが表示されます。 146 EMC Documentum Composer バージョン 7.2 ユーザ ガイド ACL ( ア ク セ ス 権 セ ッ ト ) を 管 理 す る 7. 次の表の説明に従って、[ACL エントリ詳細] セクションで、選択したエイリアス、ユーザ、また はグループの名前とアクセス権を指定します。 パラメータ 説明 所有者エイリアス エイリアスの所有者を指定する文字列。[選択] をクリックし、ACL エン トリの所有者を選択します。[Documentum エイリアスセット アーティ ファクト] ダイアログ ボックスが表示されます。リストからエイリアスの所 有者を選択します。リストが空の場合、最初にエイリアスを作成しま す。エイリアス セットの作成の詳細については、エイリアス セットの作 成 (77ページ) を参照してください。 [所有者エイリアス] については、次のいずれかの選択も行います。 • 相対: 相対エイリアス名 (%alias_name) を指定する場合に選択し ます。 • 絶対: 複数のエイリアス セット (%alias_set_name.alias_name) から エイリアスを指定する場合に選択します。 所有者のユーザまたは所有 者のグループ ACL エントリの所有者を指定する文字列。[選択] をクリックし、ACL エントリの所有者を選択します。ユーザ ACL とグループ ACL のどち らを追加するかによって、[ユーザ インストール パラメータ] ダイアログ ボックスまたは [グループ インストール パラメータ] ダイアログ ボックス が表示されます。リストから所有者を選択します。[インストール パラ メータ] ダイアログ ボックスのリストボックスが空である場合や、目的の ユーザまたはグループが含まれていない場合は、ユーザ インストー ル パラメータまたはグループ インストール パラメータのフォームで所 有者を作成します。ACL に直接ユーザやグループを追加することは できません。ACL に追加する各グループやユーザに対してインストー ル パラメータを作成し、インストール パラメータでグループやユーザ の値を指定します。その後、ACL でそのインストール パラメータを 指定します。ACL エントリ所有者の作成に関する詳細については、 ACL エントリ所有者の作成 (150ページ) を参照してください。 アクセス権 エイリアスのアクセス権を指定します。ドロップダウン リストからアクセ ス権を選択し、必要に応じて、[拡張アクセス権] 列で関連するオプ EMC Documentum Composer バージョン 7.2 ユーザ ガイド 147 ACL (アクセス権セット) を管理する パラメータ 説明 ションをオンにして拡張アクセス権を割り当てます。アクセス権の詳 細については、基本アクセス権 (144ページ) および拡張アクセス権 (144ページ) を参照してください。 8. 変更を保存します。 標準またはパブリックのアクセス権セットの作成 標準 ACL は作成したユーザまたはグループだけが使用でき、パブリック ACL はリポジトリ内のす べてのユーザまたはグループが使用できます。 標準またはパブリックのアクセス権セットを作成するには 1. Documentum プロジェクトで、[Artifacts] フォルダを展開し、[アクセス権セット] を右クリックしま す。[新規作成] > [アクセス権セット] を選択します。 [新しいアクセス権セット] ダイアログ ボックスが表示されます。 2. [フォルダ] フィールドに、アクセス権セットを作成するプロジェクトのフォルダ パスと名前を入力 するか、[参照] をクリックしてフォルダ リストからプロジェクトを選択します。 3. [アーティファクト名] フィールドにアクセス権セットの名前を入力します。 4. 作成する ACL のタイプに応じて、[ACL クラス] ドロップダウン リストから [レギュラー] または [パブリック] を選択し、[終了] をクリックします。 アクセス権セット エディタが表示されます。 148 EMC Documentum Composer バージョン 7.2 ユーザ ガイド ACL ( ア ク セ ス 権 セ ッ ト ) を 管 理 す る 新しいアクセス権セットの [すべてのユーザとグループ] セクションには、次のような 2 つの デフォルトの ACL エントリが含まれます。 • dm_owner: アクセス権セットの所有者。 • dm_world: すべてのリポジトリ ユーザ。 これらのデフォルト エントリは、アクセス権セットから削除できません。 5. [全般] セクションに、アクセス権セットの名前とオプションの説明を入力します。 6. [すべてのユーザとグループ] セクションで dm_owner または dm_world の ACL エントリを選 択するか、次のいずれかをクリックします。 • [ユーザの追加] をクリックして、新しいユーザ ACL を追加する。 • [グループの追加] をクリックして、新しいグループ ACL を追加する。 [ACL エントリ詳細] セクションが表示されます。 7. 次の表の説明に従って、選択した ACL エントリに名前とアクセス権を指定します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 149 ACL (アクセス権セット) を管理する パラメータ 説明 所有者のユーザまたは所有 者のグループ ACL エントリの所有者を指定する文字列。[選択] をクリックし、ACL エントリの所有者を選択します。ユーザ ACL とグループ ACL のどち らを追加するかによって、[ユーザ インストール パラメータ] ダイアログ ボックスまたは [グループ インストール パラメータ] ダイアログ ボックス が表示されます。リストから所有者を選択します。[インストール パラ メータ] ダイアログ ボックスのリストボックスが空である場合や、目的の ユーザまたはグループが含まれていない場合は、ユーザ インストー ル パラメータまたはグループ インストール パラメータのフォームで所 有者を作成します。ACL に直接ユーザやグループを追加することは できません。ACL に追加する各グループやユーザに対してインストー ル パラメータを作成し、インストール パラメータでグループやユーザ の値を指定します。その後、ACL でそのインストール パラメータを 指定します。ACL エントリ所有者の作成に関する詳細については、 ACL エントリ所有者の作成 (150ページ) を参照してください。 アクセス権 ACL エントリのアクセス権を指定します。ドロップダウン リストからアク セス権を選択し、必要に応じて、[拡張アクセス権] 列で関連するオプ ションをオンにして拡張アクセス権を割り当てます。アクセス権の詳 細については、基本アクセス権 (144ページ) および拡張アクセス権 (144ページ) を参照してください。 8. 変更を保存します。 ACL エ ン ト リ 所 有 者 の 作 成 すべての ACL エントリには所有者が必要です。所有者には、ユーザまたはユーザのグループを 指定できます。Composer では、ユーザまたはグループのインストール パラメータのフォーム内で 所有者パラメータを作成できます。所有者パラメータは、プロジェクトをリポジトリにインストールす るとき、リポジトリ内で関連付けられている所有者にマップすることができます。 ACL エ ン ト リ に 対 し て ユ ー ザ ま た は グ ル ー プ の 所 有 者 を 作 成 す る に は 1. アクセス権セット エディタの [ACL エントリ詳細] セクションで [選択] をクリックします。 [ユーザ インストール パラメータ] または [グループ インストール パラメータ] ダイアログ ボックスが表示されます。 2. [新規作成] をクリックします。 [新しいユーザ インストール パラメータ] または [新しいグループ インストール パラメータ] ダイ アログ ボックスが表示されます。 3. フォルダの場所とアーティファクト名をデフォルトのまま使用するか、[次へ] をクリックします。 [インストール パラメータ アーティファクト] ダイアログ ボックスが表示されます。 150 EMC Documentum Composer バージョン 7.2 ユーザ ガイド ACL ( ア ク セ ス 権 セ ッ ト ) を 管 理 す る 4. [パラメータ名] フィールドに ACL エントリ所有者の名前を入力します。また、オプションの説明 とデフォルト値を入力することもできます。 5. [終了] をクリックします。[ユーザ インストール パラメータ] または [グループ インストール パ ラメータ] ダイアログ ボックスの [一致するアーティファクト] リストに、新しい所有者の名 前が表示されます。 6. [OK] をクリックして変更を保存します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 151 ACL (アクセス権セット) を管理する 152 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 14 章 プロシージャの管理 この章では、次について説明します。 • プロシージャ • プロシージャの作成 プロシージャ プロシージャは、Documentum クライアントまたは Content Server を拡張またはカスタマイズするア プリケーションです。プロシージャはリポジトリ内の格納場所により、ユーザがリポジトリに接続する 際、またはメニュー項目を選択する際に必要に応じて、自動的に実行できます。プロシージャは、 Docbasic という専用の Documentum 言語 (Visual Basic に基づく) で記述されます。 Docbasic の詳細については、『Docbasic Reference Manual (Docbasic リファレンス マニュアル)』に 記載されています。 プロシージャの作成 プロシージャを作成するには、プロシージャ エディタを使用します。 プロシージャを作成するには 1. Documentum プロジェクトで、[Artifacts] フォルダを展開し、[プロシージャ] を右クリックします。 [新規作成] > [プロシージャ] を選択します。 [新しいプロシージャ] ダイアログ ボックスが表示されます。 2. [フォルダ] フィールドに、プロシージャを作成するプロジェクトのフォルダ パスと名前を入力す るか、[参照] をクリックしてフォルダ リストからプロジェクトを選択します。 3. [アーティファクト名] フィールドにプロシージャのファイル名を入力して、[終了] をクリックします。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 153 プロシージャの管理 プロシージャ エディタが表示されます。 4. [名前] フィールドにプロシージャの名前を入力するか、デフォルト名を受け入れます。 5. 関連するクライアント アプリケーションでユーザがプロシージャを実行できるようにする場 合、[ユーザが実行可能] チェックボックスをオンにします。 6. [DocBasic コンテンツ] セクションにプロシージャの Docbasic コードを入力するか、[ロード] をク リックしてローカル ファイルからプロシージャ コードをロードします。 154 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 15 章 関係タイプの管理 この章では、次について説明します。 • 関係タイプ • 関係タイプの作成 関係タイプ 関係タイプは、リポジトリ内の 2 つのオブジェクト間の関係を定義します。一般に、2 つのオブジェ クトを関係で結ぶと、一方は親オブジェクト、他方は子オブジェクトと認識されます。 関係タイプはアイテム間の関係のあり方を示します。関係タイプには、次の 2 つの種類があります。 • ア ド ホ ッ ク : この関係タイプは、ユーザが追加、変更、削除できます。 • シ ス テ ム : この関係タイプは、ユーザが操作することはできません。たとえば、ファイルとサム ネールの関係はシステム関係タイプです。 関係タイプの作成 関係タイプを作成したり、既存の関係タイプを変更するには、関係タイプ エディタを使用します。 関係タイプを作成するには 1. Documentum プロジェクトで、[Artifacts] フォルダを展開し、[関係タイプ] を右クリックします。 [新規作成] > [関係タイプ] を選択します。 [新しい関係タイプ] ダイアログ ボックスが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 155 関係タイプの管理 2. [フォルダ] フィールドに、関係タイプを作成するプロジェクトのフォルダ パスと名前を入力する か、[参照] をクリックしてフォルダ リストからプロジェクトを選択します。 3. [アーティファクト名] フィールドに関係タイプのファイル名を入力して、[次へ] をクリックします。 4. [関係タイプ名] フィールドに関係タイプの名前を入力して、[終了] をクリックします。 関係タイプ エディタが表示されます。 5. 次の表の説明に従って、[全般] セクションと [親と子] セクションに関係タイプのプロパティ を入力します。 プロパティ 説明 全般 名前 関係タイプの名前を指定する文字列。名前には最大 255 文字まで 使用できます。 説明 関係タイプを説明する文字列。説明には最大 250 文字まで使用 できます。 セキュリティ タイプ 関係タイプのセキュリティ レベルを指定する文字列。セキュリティ タイプの値は次のとおりです。 • シ ス テ ム : この関係タイプを作成、変更、削除できるのは、スーパー ユーザ権限またはシステム管理者権限を持つユーザのみです。 • 親: この関係タイプは、その親からセキュリティ レベルを継承します。 • 子: この関係タイプは、その子からセキュリティ レベルを継承します。 • な し : この関係タイプにはセキュリティ レベルはありません。 156 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 関係タイプの管理 プロパティ 説明 参照整合性 参照整合性の適用方法を指定します。ドロップダウン リストから次 の値のいずれかを選択します。 • 削除を許可する • 削除を制限する • 段階的に削除する デフォルトの参照整合性の値は、[削除を許可する] です。 親と子 子のタイプ 子オブジェクトのオブジェクト タイプを指定する文字列 (最大 32 文 字)。子のタイプは、オプションの関係タイプ プロパティです。 次のいずれかの方法で指定できます。 • [子のタイプ:] フィールドに子のタイプの名前を入力します。 • [選択] をクリックして子のタイプを選択します。[タイプ アーティファ クトを選択] ダイアログ ボックスが表示されます。リスト ボックス から子のタイプを選択します。 • [子のタイプ] リンクをクリックして子のタイプを作成します。 Documentum アーティファクト - 名前とロケーション ウィザードが表 示されます。アーティファクトの作成の詳細については、アーティ ファクトの作成 (27ページ) を参照してください。 親のタイプ 有効な親オブジェクトのオブジェクト タイプを指定する文字列 (最大 32 文字)。親のタイプは、オプションの関係タイプ プロパティです。 次のいずれかの方法で指定できます。 • [親のタイプ:] フィールドに親のタイプの名前を入力します。 • [選択] をクリックして親のタイプを選択します。[アーティファクト セ レクタ] ダイアログ ボックスが表示されます。リストボックスから親 のタイプを選択します。 • [親のタイプ] リンクをクリックして親のタイプを作成します。[新しい Documentum アーティファクト - 名前とロケーション] ウィザードが表 示されます。アーティファクトの作成の詳細については、アーティ ファクトの作成 (27ページ) を参照してください。 関係の方向 関係の方向を指定する整数。関係の方向の値は次のとおりです。 • 親から子へ • 子から親へ • 双方向 デフォルトの関係の方向の値は、[親から子へ] です。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 157 関係タイプの管理 プロパティ 説明 永久リンク 親がコピーまたはバージョン設定された場合に関係を維持するかどう かを決定します。このオプションを選択した場合、次のいずれかの方 法で親と子の関係が維持されます。 • 親がコピーされる場合、子オブジェクトもコピーする • 子オブジェクトはコピーしない 158 子から親へのラベル 子対親の関係のラベルを指定する文字列 (最大 255 文字)。テキスト フィールドに文字列を入力して [追加] をクリックします。 親から子へのラベル 親対子の関係のラベルを指定する文字列 (最大 255 文字)。テキスト フィールドに文字列を入力して [追加] をクリックします。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 16 章 スマート コンテナの管理 この章では、次について説明します。 • スマート コンテナ • スマート コンテナの構築 • スマート コンテナ要素の追加 • スマート コンテナの関係の追加 スマート コンテナ スマート コンテナは、実行時にインスタンス化を行う際に使用するテンプレートでオブジェクトと関 係を定義します。Composer には、スマート コンテナ エディタが用意されています。このエディタを 使用すると、開発者は、プログラムではなく宣言によってスマート コンテナを構築できるので、DFC アプリケーションの記述にかかる時間を大幅に削減できます。スマート コンテナを構築した後のオ ブジェクトは、Documentum の永続オブジェクトと似ています。 スマート コンテナ テンプレートの使用目的はモデル化された複合オブジェクトを繰り返し構築する ことなので、複合オブジェクトの新規インスタンスはそれぞれ異なる必要があります。これは、設計 時にスマート コンテナをパラメータ化することによって実現します。 注 記 : スマート コンテナ アーティファクトのインストール オプションを設定する場合、[アップグ レード オプション] を [一致するオブジェクトの新しいバージョンを作成] に設定する必要があ ります。スマート コンテナ オブジェクトを上書きすると既存のインスタンスに対するモデル イン スタンスの関連付けが無効になるので、スマート コンテナ アーティファクトには [一致するオブ ジェクトを上書き] を選択しないでください。 スマート コンテナの構築 スマート コンテナを構築または変更するには、スマート コンテナ エディタを使用します。 スマート コンテナを構築するには 1. Documentum プロジェクトで、[Artifacts] フォルダを展開し、[スマート コンテナ] を右クリック します。[新規作成] > [スマート コンテナ] を選択します。 [新しいスマート コンテナ] ダイアログ ボックスが表示されます。 2. [フォルダ] フィールドに、スマート コンテナを構築するプロジェクトのフォルダ パスと名前を入 力するか、[参照] をクリックしてフォルダ リストからプロジェクトとフォルダ パスを選択します。 3. [アーティファクト名] フィールドにスマート コンテナのファイル名を入力して、[次へ] をク リックします。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 159 スマート コンテナの管理 スマート コンテナ エディタが表示されます。 4. 次の表の説明に従って、スマート コンテナのプロパティを設定します。 パラメータ 説明 一般設定 オブジェクト名 スマート コンテナの名前を指定する文字列。Composer によって割り当て られているデフォルト名をそのまま受け入れるか、新しい名前を入力す ることができます。 プライマリ インスタンス スマート コンテナのプライマリ オブジェクトを指定します。ドロップダウン リストからプライマリ インスタンスを選択します。 すべてのスマート コンテナは、プライマリ インスタンスを 1 つだけ持つ必 要があります。プライマリ インスタンスには、新規フォルダ、既存のフォル ダ、新規ドキュメント、既存のドキュメント、またはテンプレートを指定でき ますが、プレースホルダは指定できません。 説明 スマート コンテナの説明。 カテゴリ ドロップダウン リストなどのフィルタで使用できる識別子を指定する文 字列。 パラメータ 名前 実行時にスマート コンテナが使用するパラメータの名前。 デフォルト値 実行時パラメータのデフォルト値。 5. 次に示すように、1 つまたは複数のアーティファクトをスマート コンテナに追加します。 • フ ォ ル ダ (フォルダの追加 (161ページ) を参照) • 新 規 フ ォ ル ダ (新規フォルダの追加 (161ページ) を参照) • ド キ ュ メ ン ト (ドキュメントの追加 (162ページ) を参照) 160 EMC Documentum Composer バージョン 7.2 ユーザ ガイド スマート コンテナの管理 • 新 規 ド キ ュ メ ン ト (新規ドキュメントの追加 (163ページ) を参照) • テ ン プ レ ー ト (テンプレートの追加 (164ページ) を参照) • プ レ ー ス ホ ル ダ (プレースホルダの追加 (164ページ) を参照) 6. アーティファクトに関係を追加します (スマート コンテナの関係の追加 (165ページ) を参照)。 7. 変更を保存します。 8. スマート コンテナのアーティファクトのインストール パラメータを設定します (アーティファ クト インストール オプションの設定 (203ページ) を参照)。 注 記 : インストール パラメータのアップグレード オプションは、[一致するオブジェクトの新しい バージョンを作成] に設定する必要があります。スマート コンテナ オブジェクトを上書きすると 既存のインスタンスに対するモデル インスタンスの関連付けが無効になるので、スマート コン テナ アーティファクトには [一致するオブジェクトを上書き] を選択しないでください。 スマート コンテナ要素の追加 スマート コンテナには、フォルダ、ドキュメント、テンプレート、プレースホルダなどのさまざまな要 素を含めることができます。 フォルダの追加 既存のフォルダのインスタンスをスマート コンテナに追加するには、スマート コンテナ エディタの [フォルダ] オプションを使用します。リポジトリ内に存在するフォルダを追加するので、フォルダの Documentum オブジェクト ID またはそのパスを追加してフォルダを定義します。 フォルダを追加するには 1. スマート コンテナの構築 (159ページ) の説明に従って、スマート コンテナ エディタを開きます。 2. ([フォルダ] アイコン) を選択し、ワークスペースをクリックします。スマート コンテナ ワークス ペースにフォルダが表示されます。 3. [プロパティ] ビューの [フォルダ情報] タブをクリックし、フォルダ プロパティを定義します (次 の表を参照)。 パラメータ 説明 表示名 ワークスペースに表示されるフォルダの名前。この名前は表示目的 のみに使用されるので、フォルダをワークスペース内で識別すること ができます。表示名は、リポジトリやその他のアプリケーションでは使 用されません。 オブジェクト ID フォルダの Documentum オブジェクト ID (16 文字)。 パス フォルダのリンク先となる場所の相対パス。 新規フォルダの追加 新しいスマート コンテナ フォルダは、標準の新規フォルダに似ていますが、実行時まではイン スタンス化されないという点が異なります。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 161 スマート コンテナの管理 新規のフォルダを追加するには 1. スマート コンテナの構築 (159ページ) の説明に従って、スマート コンテナ エディタを開きます。 2. ([フォルダの新規作成] アイコン) を選択し、ワークスペースをクリックします。スマート コンテナ ワークスペースに新規フォルダが表示されます。 3. [プロパティ] ビューの [新規フォルダ情報] タブをクリックし、フォルダ プロパティを定義 します (次の表を参照)。 パラメータ 説明 表示名 ワークスペースに表示されるフォルダの名前。この名前は表示目的のみに 使用されるので、フォルダをワークスペース内で識別することができます。 表示名は、リポジトリやその他のアプリケーションでは使用されません。 オブジェクト名 新規フォルダのオブジェクト名。 タイプ 新規フォルダのオブジェクト タイプ。[選択] をクリックしてリストからオブジェ クト タイプを選択するか、[タイプ] リンクをクリックしてオブジェクト タイプ を作成します。タイプについては、オブジェクト タイプ (171ページ) を参 照してください。 アクセス権セット フォルダに割り当てられているアクセス権セット。[選択] をクリックしてリス トからアクセス権セットを選択するか、[アクセス権セット] リンクをクリックし てアクセス権セットを作成します。アクセス権セットの管理については、ア クセス権、アクセス権セット、アクセス権セット テンプレート (143ページ) を参照してください。 4. [アスペクト] タブをクリックして、1 つまたは複数のアスペクトを新規フォルダに添付します。[追 加] をクリックしてリストからアスペクトを選択するか、アスペクトを作成します。 アスペクトについては、アスペクト モジュールおよびアスペクト タイプ (81ページ) を参照 してください。 5. [属性] タブをクリックして、1 つまたは複数の属性を新規フォルダに追加します。[追加] をクリックし、リストから属性を選択します。 6. 変更を保存します。 ドキュメントの追加 既存のドキュメントのインスタンスをスマート コンテナに追加するには、スマート コンテナ エディタ の [ドキュメント] オプションを使用します。リポジトリ内に存在するドキュメントを追加するので、ド キュメントの Documentum オブジェクト ID またはそのパスを追加してドキュメントを定義します。 ドキュメントを追加するには 1. スマート コンテナの構築 (159ページ) の説明に従って、スマート コンテナ エディタを開きます。 2. ([ドキュメント] アイコン) を選択し、ワークスペースをクリックします。スマート コンテナ ワー クスペースにドキュメントが表示されます。 3. [プロパティ] ビューの [インスタンス情報] タブをクリックし、ドキュメント プロパティを定義 します (次の表を参照)。 162 EMC Documentum Composer バージョン 7.2 ユーザ ガイド スマート コンテナの管理 パラメータ 説明 表示名 ワークスペースに表示されるドキュメント インスタンスの名前。この名前は 表示目的のみに使用されるので、ドキュメント インスタンスをワークス ペース内で識別することができます。表示名は、リポジトリやその他のア プリケーションでは使用されません。 オブジェクト ID ドキュメント インスタンスの Documentum オブジェクト ID (16 文字)。 パス ドキュメント インスタンスのリンク先となる場所の相対パス。 新規ドキュメントの追加 新しいスマート コンテナ ドキュメントは、標準の新規ドキュメントに似ていますが、実行時まではイ ンスタンス化されないという点が異なります。 ドキュメントを追加するには 1. スマート コンテナの構築 (159ページ) の説明に従って、スマート コンテナ エディタを開きます。 2. ([ドキュメントの新規作成] アイコン) を選択し、ワークスペースをクリックします。スマート コ ンテナ ワークスペースに新規ドキュメントが表示されます。 3. [プロパティ] ビューの [新規インスタンス情報] タブをクリックし、新規ドキュメントのプロパティ を定義します (次の表を参照)。 パラメータ 説明 表示名 ワークスペースに表示される新規ドキュメント インスタンスの名前。この名 前は表示目的のみに使用されるので、新規ドキュメント インスタンスを ワークスペース内で識別することができます。表示名は、リポジトリやそ の他のアプリケーションでは使用されません。 オブジェクト名 新規ドキュメント インスタンスのオブジェクト名。 タイプ 新規ドキュメント インスタンスのオブジェクト タイプ。[選択] をクリックして リストからオブジェクト タイプを選択するか、[タイプ] リンクをクリックしてオ ブジェクト タイプを作成します。タイプについては、オブジェクト タイプ (171ページ) を参照してください。 アクセス権セット ドキュメント インスタンスに割り当てられているアクセス権セット。[選択] をクリックしてリストからアクセス権セットを選択するか、[アクセス権セッ ト] リンクをクリックしてアクセス権セットを作成します。アクセス権セット の管理については、アクセス権、アクセス権セット、アクセス権セット テ ンプレート (143ページ) を参照してください。 4. [アスペクト] タブをクリックして、1 つまたは複数のアスペクトを新規ドキュメント インスタンスに 添付します。[追加] をクリックしてリストからアスペクトを選択するか、アスペクトを作成します。 アスペクトについては、アスペクト モジュールおよびアスペクト タイプ (81ページ) を参照 してください。 5. [属性] タブをクリックして、1 つまたは複数の属性を新規ドキュメント インスタンスに追加しま す。[追加] をクリックし、リストから属性を選択します。 6. 変更を保存します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 163 スマート コンテナの管理 テンプレートの追加 スマート コンテナ テンプレートとは、構築時にスマート コンテナにコピーして使うための既存 のドキュメントです。 テンプレートを追加するには 1. スマート コンテナの構築 (159ページ) の説明に従って、スマート コンテナ エディタを開きます。 2. ([テンプレート] アイコン) を選択し、ワークスペースをクリックします。スマート コンテナ ワー クスペースにテンプレートが表示されます。 3. [プロパティ] ビューの [テンプレート情報] タブをクリックし、テンプレート プロパティを定義 します (次の表を参照)。 パラメータ 説明 表示名 ワークスペースに表示されるテンプレートの名前。この名前は表示目的 のみに使用されるので、新規ドキュメント インスタンスをワークスペース 内で識別することができます。表示名は、リポジトリやその他のアプリ ケーションでは使用されません。 オブジェクト名 テンプレートのオブジェクト名。 アクセス権セット テンプレートに割り当てられているアクセス権セット。[選択] をクリックして リストからアクセス権セットを選択するか、[アクセス権セット] リンクをク リックしてアクセス権セットを作成します。アクセス権セットの管理につ いては、アクセス権、アクセス権セット、アクセス権セット テンプレート (143ページ) を参照してください。 次に基づく オブジェクト ID テンプレートの Documentum オブジェクト ID (16 文字)。 パス テンプレートのリンク先となる場所の相対パス。 4. [アスペクト] タブをクリックして、1 つまたは複数のアスペクトをテンプレートに添付します。[追 加] をクリックしてリストからアスペクトを選択するか、アスペクトを作成します。 アスペクトについては、アスペクト モジュールおよびアスペクト タイプ (81ページ) を参照 してください。 5. [属性] タブをクリックして、1 つまたは複数の属性をテンプレートに追加します。[追加] をクリッ クし、リストから属性を選択します。 6. 変更を保存します。 プレースホルダの追加 プレースホルダ オブジェクトは、テンプレート オブジェクトに似ていますが、構築時には作成され ません。プレースホルダ オブジェクトを使用すると、モデル化を行う際に、複合オブジェクトを完 了したものと見なすために後で他のオブジェクトを追加する必要があることを示すことができま す。プレースホルダは、リーフ ノードである必要があります。 プレースホルダを追加するには 1. スマート コンテナの構築 (159ページ) の説明に従って、スマート コンテナ エディタを開きます。 164 EMC Documentum Composer バージョン 7.2 ユーザ ガイド スマート コンテナの管理 2. ([プレースホルダ] アイコン) を選択し、ワークスペースをクリックします。スマート コンテナ ワークスペースにプレースホルダが表示されます。 3. [プロパティ] ビューの [プレースホルダ情報] タブをクリックし、プレースホルダ プロパティ を定義します (次の表を参照)。 パラメータ 説明 表示名 ワークスペースに表示されるプレースホルダの名前。この名前は表示 目的のみに使用されるので、新規プレースホルダをワークスペース 内で識別することができます。表示名は、リポジトリやその他のアプリ ケーションでは使用されません。 オブジェクト名 プレースホルダのオブジェクト名。 タイプ プレースホルダのオブジェクト タイプ。[選択] をクリックしてリストからオブ ジェクト タイプを選択するか、[タイプ] リンクをクリックしてオブジェクト タイプを作成します。タイプについては、オブジェクト タイプ (171ペー ジ) を参照してください。 必ず指定 プレースホルダをオブジェクト タイプに割り当てる必要があるかどうか を指定します。 4. 変更を保存します。 スマート コンテナの関係の追加 スマート コンテナ オブジェクト間の関係は、フォルダ リンクと一般的な関係という 2 つの形式 で表されます。スマート コンテナ エディタには、関係を視覚的に区別するために 2 つのオプ ションが用意されています。 • フ ォ ル ダ メ ン バ リ ン ク : この関係は、フォルダとそのメンバのモデル化を行う場合に使用します。 • 関 係 リ ン ク : この関係オプションは、その他のすべての一般的な関係に使用します。一般的な 関係とは、たとえば、保険金請求と顧客の間の関係です。 関係を追加するには 1. [フォルダ メンバー リンク] (矢印) または [関係リンク] (直線) をクリックし、そのリンク ツー ルをアクティブにします。 2. 1 つ目のスマート コンテナのオブジェクトをクリックします。 3. 2 つ目のスマート コンテナのオブジェクトをクリックします。 2 つのオブジェクトが接続されたことを示す矢印または直線が表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 165 スマート コンテナの管理 166 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 17 章 システム オブジェクトの管理 この章では、次について説明します。 • システム オブジェクト • システム オブジェクトの作成 • システム オブジェクトの属性の表示と変更 システム オブジェクト システム オブジェクト タイプは、Documentum システムで最もよく使用されるオブジェクトの親タイプ です。システム オブジェクトは、コンテンツを含めることが可能な階層内にあるすべてのオブジェク ト タイプの (直接または間接の) スーパータイプです。システム オブジェクト タイプの定義済み属 性には、オブジェクトのバージョン、オブジェクトに関連付けられたコンテンツ ファイル、オブジェク トに対するセキュリティ権限、コンテンツ管理にとって重要なその他の情報が保存されます。コンテ ンツと関連付けられる最も一般的なシステム オブジェクトのサブタイプは、dm_document です。 システム オブジェクトの作成 システム オブジェクトを作成または変更するには、システム オブジェクト エディタを使用します。 システム オブジェクトを作成するには 1. Composer プロジェクトで、[Artifacts] フォルダを展開し、[システム オブジェクト] を右クリック する。[新規作成] > [システム オブジェクト] を選択します。 [新しいシステム オブジェクト] ダイアログ ボックスが表示されます。 2. [フォルダ] フィールドに、システム オブジェクトを作成するプロジェクトのフォルダ パスと名前を 入力するか、[参照] をクリックしてフォルダ リストからプロジェクトを選択します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 167 システム オブジェクトの管理 3. [アーティファクト名] フィールドにシステム オブジェクトのファイル名を入力して、[次へ] をク リックします。 [タイプ、ファイル、フォーマット] ダイアログ ボックスが表示されます。 4. 次のいずれかを実行します。 • システム オブジェクトのファイル名およびフォーマットを入力しない場合、[終了] をク リックします。 • 必要に応じて、次の表の説明に従ってシステム オブジェクトのタイプ、ファイル、フォーマッ トの情報を入力し、[次へ] をクリックします。 プロパティ 説明 タイプ コンテンツを含むオブジェクトのタイプ。デフォルトでは、オブジェクト タイ プは dm_sysobject に設定されています。[選択] をクリックして、ドロップダ ウン リストから別のオブジェクト タイプを選択します。 ファイル コンテンツを含むファイルの名前 (該当する場合)。[参照] をクリックして、 ローカル マシンまたはネットワーク ドライブからファイルを選択します。 フォーマット コンテンツ ファイルのフォーマット。[選択] をクリックして、ドロップダウン リ ストからファイルのフォーマットを選択します。 システム オブジェクト エディタが表示されます。 168 EMC Documentum Composer バージョン 7.2 ユーザ ガイド システム オブジェクトの管理 5. [添付されたアスペクト] セクションの [追加] をクリックして、1 つまたは複数のアスペクトをシス テム オブジェクトに添付します。 [アスペクト モジュール アーティファクト] ダイアログ ボックスが表示されます。 6. リストからアスペクトを選択するか、[新規作成] をクリックしてアスペクトを作成します。 アスペクトについては、アスペクト モジュールおよびアスペクト タイプ (81ページ) を参照 してください。 7. システム オブジェクトの属性の表示と変更 (169ページ) に従って、システム オブジェクトの 属性を表示または変更します。 8. 変更を保存します。 システム オブジェクトの属性の表示と変更 システム オブジェクト エディタの [属性] タブでは、属性を表示し、指定したシステム オブジェク トに関連付けられている属性値を変更することができます。 システム オブジェクトの属性を表示または変更するには 1. システム オブジェクト エディタの [属性] タブをクリックします。 [属性] ビューが表示されます。 2. リストから属性を選択して、属性の詳細を表示します。 [属性] ビューでは、次の処理を行うことができます。 • [編集可能な属性のみを表示] ラジオ ボタンを選択し、変更できる属性だけを一覧表示する。 • [すべての属性を表示] ラジオ ボタンを選択し、システム オブジェクトのすべての属性 を一覧表示する。 • [詳細] セクションの [属性値] フィールドで、編集可能な属性の値を入力または変更する。 3. 変更を保存します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 169 システム オブジェクトの管理 170 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 18 章 タイプの管理 この章では、次について説明します。 • オブジェクト タイプ • 標準オブジェクト タイプの作成 • 軽量オブジェクト タイプの作成 • タイプの制約式の設定 • イベントの追加、削除、または変更 • タイプ属性の追加 • 属性構造の設定 • 属性の制約の設定 • タ イ プ 属 性 UI の 設 定 • タ イ プ UI 情 報 の 設 定 • タブの追加 オブジェクト タイプ オブジェクト タイプはテンプレートに似ており、オブジェクトのクラスを表します。Composer では、 次のような 2 つのオブジェクト タイプを作成できます。 • 標準オブジェクト • 軽量オブジェクト 一式の属性によって、各オブジェクト タイプを定義します。オブジェクトを作成すると、その属 性は、そのオブジェクト タイプのインスタンスを表す値に設定されます。たとえば、ドキュメント オブジェクト タイプの 2 つの属性は、タイトルと主題です。ユーザがドキュメントを作成する場 合、そのドキュメントに特有のタイトル属性と主題属性の値を指定します。オブジェクトおよびオ ブジェクト タイプの詳細については、『Documentum Content Server Fundamentals (Documentum Content Server の基本操作)』を参照してください。 軽量オブジェクトはオブジェクト モデルの拡張の一部であり、アプリケーション固有のデータだ けを保持するオブジェクト間で、システムによって管理されるメタデータを共有するために導入 されました。たとえば、セキュリティ、保持期限、およびストレージのポリシーは、すべての軽量 オブジェクトの間で共有される標準のシステム オブジェクトに保存されます。システムによって 管理されるメタデータが保存されるのは 1 回だけなので、必要なディスク ストレージが大幅に 削減され、読み込みのパフォーマンスが著しく向上します。 注 記 : 現在、軽量オブジェクトを適切に使用できるのは、Documentum High-Volume Server 用 に設計されたアプリケーションだけです。Documentum High-Volume Server は、電子メールの EMC Documentum Composer バージョン 7.2 ユーザ ガイド 171 タイプの管理 アーカイブなど、大きいコンテンツ ストアの一般的な問題を解決するために実装された機能 をサポートする、Documentum Content Server の拡張です。このサーバには、Content Server のインストール時に指定した追加のライセンス キーが必要です。軽量オブジェクト タイプ と Documentum High-Volume Server の詳細については、『 Documentum High-Volume Server Developer Guide(EMC Documentum High-Volume Server 開発者ガイド)』を参照してください。 標準オブジェクト タイプの作成 標準オブジェクト タイプを作成または変更するには、タイプ エディタを使用します。 標準オブジェクト タイプを作成するには 1. Composer プロジェクトで、[Artifacts] フォルダを展開して [タイプ] を右クリックする。[新規 作成] > [タイプ] を選択します。 [新しいオブジェクト タイプ] ダイアログ ボックスが表示されます。 2. [フォルダ] フィールドに、オブジェクト タイプを作成するプロジェクトのフォルダ パスと名前を入 力するか、[参照] をクリックしてフォルダ リストからプロジェクトを選択します。 3. [アーティファクト名] フィールドにオブジェクト タイプのファイル名を入力します。 4. 軽量システム オブジェクト プラグインがインストールされている場合は、[標準オブジェクト タ イプ] を選択し、[次へ] をクリックします。 軽量システム オブジェクト プラグインのインストール方法については、軽量システム オブジェ クト プラグインをインストールする (13ページ) を参照してください。 タイプ エディタの [全般] タブが表示されます。 172 EMC Documentum Composer バージョン 7.2 ユーザ ガイド タイプの管理 5. [情報]、[デフォルトの添付アスペクト]、[制約]、[イベント] の各セクションにオブジェクト タイプ 情報を入力します (次の表の説明を参照)。 プロパティ 説明 全般 タイプ名 タイプの名前を表す文字列。すべてのタイプ名には次の 規則が適用されます。 • 27 文字以内、すべて小文字。Content Server では大文 字と小文字は区別されず、タイプ名はすべて小文字で 格納されます。 • 名前の先頭は必ず文字にします。その後は、文字、数 字、アンダースコアを使用できます。 • スペースや句読点は使用できません。 • 末尾をアンダースコア (_) にすることはできません。 共有可能 このタイプのプロパティを他のオブジェクト タイプと共有す る場合に選択します。 スーパータイプ 新しいタイプのスーパータイプ。スーパータイプは、別のタイ プの基礎となるタイプです。新しいタイプは、指定したスー パータイプのプロパティをすべて継承します。 [選択...] をクリックしてリスト ボックスからスーパータイプを 選択します。 ストレージ エリア このタイプのインスタンスについて、デフォルトのストレージ ロケーションを指定します。カスタムのデフォルト ストレージ ロケーションを割り当てない場合、システムのデフォルト スト レージ ロケーションが自動的に割り当てられます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 173 タイプの管理 プロパティ 説明 デフォルトの添付アスペクト [選択...] をクリックして、このタイプのインスタンスに添付され る 1 つまたは複数のアスペクトを指定します。アスペクトに より、タイプ インスタンスの動作を変更できます。アスペクト の添付の詳細については、アスペクトの添付 (175ページ) を参照してください。 制約 制約は、タイプの属性値同士またはタイプの属性値と定数 値を関係付ける、Docbasic 式の形式で表した内部的な整 合性要件です。 式 制約を定義する Docbasic 式。新しい式を作成する場合は、 [新規] をクリックします。式の作成や変更の詳細について は、制約式の設定 (83ページ) を参照してください。 適用 アプリケーションがこの制約を適用するかどうかを指定しま す。表の [適用] 列のセルをクリックして、関連付けられた式に 対する制約の適用を有効または無効にすることができます。 制約フィールドに指定できる値は次の 2 種類です。 • 無効: 制約は無効です。 • アプリケーションの実行: このタイプを使用するアプリケー ションによって制約が実行されます。 イベント イベントは、オブジェクトに対する特定のアクションです。作 成や変更ができるのはアプリケーション イベントのみで、シ ステム イベントの作成および変更はできません。新しいイ ベントを入力するには、[新規作成] をクリックします。イベ ントを編集または削除するには、対象のイベントを選択して [編集] または [削除] をクリックします。イベントの作成の 詳細については、イベントの追加、削除、または変更 (180 ページ) を参照してください。 このタイプで定義されたイベントのみ このオプションを選択すると、イベント テーブルにあるこのタ イプについて定義されたイベントが表示されます。 スーパータイプからの継承を含むす べてのイベント このオプションを選択すると、スーパータイプから継承された イベントも含め、イベント テーブルにあるこのタイプのイベン トがすべて表示されます。 イベント名 このタイプのインスタンスに関連付けられるイベントの名前 を表す文字列。 イベント ラベル イベントのラベルを表す文字列。 6. [属性] タブをクリックします。 [タイプ属性] ビューが表示されます。 174 EMC Documentum Composer バージョン 7.2 ユーザ ガイド タイプの管理 7. [新規作成] をクリックし、タイプ属性を追加します。タイプ属性の追加 (181ページ) の説明に 従って、[構造] セクションと [制約] セクションに情報を入力します。 8. [表示] タブをクリックします。 [タイプ UI 情報] ビューが表示されます。 9. タイプ UI 情報の設定 (188ページ) の説明に従って、[アプリケーション インターフェイス表示] セクションと [表示設定] セクションにタイプ UI 情報を入力します。 アスペクトの添付 オブジェクト タイプを作成する場合、そのオブジェクト タイプにデフォルトで添付されるアス ペクトを割り当てることもできます。 アスペクトを添付するには 1. タイプ エディタの [全般] タブにある [デフォルトの添付アスペクト] セクションで [追加] をク リックします。 [アスペクト モジュール アーティファクト] ダイアログ ボックスが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 175 タイプの管理 2. [一致するアーティファクト] リストボックスからアスペクトを選択して、[OK] をクリックします。 注 記: [一致するアーティファクト] リストボックスにアスペクトが表示されない場合、アスペクト はまだ作成されていません。アスペクトの作成の詳細については、アスペクト タイプの作成 (81ページ) を参照してください。 軽量オブジェクト タイプの作成 軽量オブジェクト タイプを作成する場合は、まずビルドするアプリケーションがそのオブジェクトの タイプを実際に使用できるかどうかを確認します。現在のところ、軽量オブジェクト タイプを使用で きるのは Documentum High-Volume Server 用に設計されたアーカイブ アプリケーションだけです。 Documentum High-Volume Server は、電子メールのアーカイブなど、大きいコンテンツ ストアの一 般的な問題を解決するために実装された機能をサポートする、Documentum Content Server の拡 張です。このサーバには、Content Server のインストール時に指定された追加のライセンス キーが 必要です。この他、軽量システム オブジェクト プラグインがインストールされているかどうかも確認 する必要があります。軽量システム オブジェクト プラグインのインストール方法については、軽量 システム オブジェクト プラグインをインストールする (13ページ) を参照してください。 軽量オブジェクト タイプを作成するには 1. Composer プロジェクトで、[Artifacts] フォルダを展開して [タイプ] を右クリックする。[新規 作成] > [タイプ] を選択します。 [新しいオブジェクト タイプ] ダイアログ ボックスが表示されます。 2. [フォルダ] フィールドに、オブジェクト タイプを作成するプロジェクトのフォルダ パスと名前を入 力するか、[参照] をクリックしてフォルダ リストからプロジェクトを選択します。 3. [アーティファクト名] フィールドにオブジェクト タイプのファイル名を入力します。 4. [軽量オブジェクト タイプ] を選択し、[次へ] をクリックします。 軽量タイプ エディタの [全般] タブが表示されます。 176 EMC Documentum Composer バージョン 7.2 ユーザ ガイド タイプの管理 5. 次の表の説明に従って、[情報]、[制約]、[イベント] の各セクションにオブジェクト タイプに関 する情報を入力します。 プロパティ 説明 全般 タイプ名 この軽量オブジェクト タイプの名前を指定する文字列。すべ てのタイプ名には次の規則が適用されます。 • 27 文字以内、すべて小文字。Content Server では大文 字と小文字は区別されず、タイプ名はすべて小文字で 格納されます。 • 名前の先頭は必ず文字にします。その後は、文字、数 字、アンダースコアを使用できます。 • スペースや句読点は使用できません。 • 末尾をアンダースコア (_) にすることはできません。 共有親 この軽量オブジェクトとプロパティを共有している親オブ ジェクト タイプ。 スーパータイプ この軽量オブジェクト タイプのスーパータイプ。スーパータイ プは、別のタイプの基礎となるタイプです。新しいタイプは、 指定したスーパータイプのプロパティをすべて継承します。 [選択...] をクリックしてリストボックスからスーパータイプを 選択します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 177 タイプの管理 プロパティ 説明 具現化動作 この軽量オブジェクトが親オブジェクトを共有する場合と、親 の独自のコピーを持つ場合を指定します。 軽量オブジェクトが他の軽量オブジェクトと親オブジェクト を共有する場合は、具現化されない、と分類されます。軽 量オブジェクトが親の独自のコピーを持つ場合は、具現化 される、と分類されます。軽量オブジェクトを具現化するこ とにより、データベース テーブルのサイズが大幅に増加 する場合があります。 具現化動作は、次の値に設定できます。 • 自 動 的 に 具 現 化 : チェックアウト/チェックイン操作や分 岐操作など、特定の操作が行われた場合に、軽量オブ ジェクトが自動的に具現化されます。 • 要 求 に 応 じ て : 明示的な API 呼び出しにより要求された 場合のみ、軽量オブジェクトが具現化されます。軽量オ ブジェクトの具現化に使用可能な API については、『 Documentum Archive Developer Guide (EMC Documentum Archive 開発者ガイド)』を参照してください。 • 非 認 可 : 軽量オブジェクトは具現化されません。 デフォルトでは、具現化動作は [自動的に具現化] に設 定されています。 制約 制約は、タイプの属性値同士またはタイプの属性値と定数 値を関係付ける、Docbasic 式の形式で表した内部的な整 合性要件です。 式 制約を定義する Docbasic 式。[新規作成] をクリックして式を 作成します。式の作成や変更の詳細については、制約式の 設定 (83ページ) を参照してください。 適用 アプリケーションがこの制約を適用するかどうかを指定しま す。表の [適用] 列のセルをクリックして、関連付けられた式に 対する制約の適用を有効または無効にすることができます。 制約フィールドに指定できる値は次の 2 種類です。 • 無効: 制約は無効です。 • アプリケーションの実行: このタイプを使用するアプリケー ションによって制約が実行されます。 178 EMC Documentum Composer バージョン 7.2 ユーザ ガイド タイプの管理 プロパティ 説明 イベント イベントは、オブジェクトに対する特定のアクションです。作 成や変更ができるのはアプリケーション イベントのみで、シ ステム イベントの作成および変更はできません。新しいイ ベントを入力するには、[新規作成] をクリックします。イベ ントを編集または削除するには、対象のイベントを選択して [編集] または [削除] をクリックします。イベントの作成の 詳細については、イベントの追加、削除、または変更 (180 ページ) を参照してください。 このタイプで定義されたイベントのみ イベント テーブルにあるこのタイプについて定義されたイ ベントを表示する場合に選択します。 スーパータイプからの継承を含むす べてのイベント スーパータイプから継承されたイベントも含め、イベント テー ブルにあるこのタイプのイベントをすべて表示する場合に 選択します。 イベント名 このタイプのインスタンスに関連付けられるイベントの名前 を表す文字列。 イベント ラベル イベントのラベルを表す文字列。 6. [属性] タブをクリックします。 [タイプ属性] ビューが表示されます。 7. [追加] をクリックして新しいタイプ属性を追加します。タイプ属性の追加の詳細については、タ イプ属性の追加 (181ページ) を参照してください。 8. [表示] タブをクリックします。 [タイプ UI 情報] ビューが表示されます。 9. [表示設定] セクションと [アプリケーション インターフェイス表示] セクションにタイプ UI 情報を 入力します (タイプ UI 情報の設定 (188ページ) を参照)。 タイプの制約式の設定 制約は、タイプの属性値同士またはタイプの属性値と定数値を関係付ける、Docbasic 式の形式で 表した内部的な整合性要件です。 タイプの制約式を追加するには EMC Documentum Composer バージョン 7.2 ユーザ ガイド 179 タイプの管理 1. タイプ エディタの [タイプの概要] タブにある [制約] セクションで [追加] をクリックします。 [制約の編集] ダイアログ ボックスが表示されます。 2. [式] テキスト ボックスに、true または false に解決される有効な Docbasic 制約式を入力します。 Docbasic 式は、制約が満たされるときは true、制約違反のときは false に解決されます。 [リセット] ボタンをクリックすると、制約式のテキスト ボックスの内容が、構文テストを最後 にパスしたときの値に戻ります。 3. 制約違反のときにアプリケーションに表示されるメッセージを、[制約違反の場合のエラー メッセージ] テキスト ボックスに入力します。 4. アプリケーションでこの制約を適用するようにする場合は [制約を適用] をオンにし、制約を適 用しないようにする場合はこのチェックボックスをオフにします。 5. [OK] をクリックして変更を保存します。 イベントの追加、削除、または変更 イベントは、オブジェクトでの特定のアクションです。作成や変更ができるのはアプリケーション イ ベントのみで、システム イベントの作成および変更はできません。 イベントを作成するには 1. [タイプの概要] の [イベント] セクションで、[新規作成] をクリックします。 [イベントの編集] ダイアログが表示されます。 2. イベントの名前を入力して、[OK] をクリックします。イベントがイベント テーブルに表示されます。 180 EMC Documentum Composer バージョン 7.2 ユーザ ガイド タイプの管理 タイプ属性の追加 タイプ属性は、タイプ エディタの [属性] タブで設定されます。タイプ属性とは、そのタイプのオ ブジェクトすべてに適用されるプロパティです。オブジェクトを作成すると、その属性は、オブ ジェクト タイプの特定のインスタンスを表す値に設定されます。 属性を作成するには 1. タイプ エディタの [属性] タブをクリックして、[属性] ビューを表示します。 2. [新規作成] をクリックして属性エントリを作成してから、プラス記号 (+) をクリックして設定 オプションを表示します。 [タイプ属性] ビューが展開され、[構造] セクションと [制約] セクションが表示されます。 3. 属性の構造を設定します (属性構造の設定 (182ページ) を参照)。 4. 属性の制約を設定します (属性の制約の設定 (183ページ) を参照)。 5. [属性]ペインの [アプリケーション インターフェイス表示] アイコン () をクリックして、属性の UI 設定オプションを表示します。 6. 属性の UI オプションを設定します (タイプ属性 UI の設定 (184ページ) を参照)。 7. [値のマッピング] アイコン ( ) をクリックして、属性値のマッピング オプションを表示します。 8. 属性の条件を設定します (条件付き属性値の設定 (186ページ) を参照)。 9. 属性値マッピングを設定します (属性値のマッピングの設定 (187ページ) を参照)。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 181 タイプの管理 属性構造の設定 属性構造は、[タイプ属性] ビューの [構造] セクションで設定します。 次の表の説明に従って、属性構造のプロパティを入力します。 プロパティ 説明 名前 新しい属性の名前を表す文字列。属性名に使用する文字はすべて小 文字にする必要があります。先頭の文字を、dm_、a_、i_、r_、数値、ス ペース、一重引用符にすることはできません。また、select、from、また は where という名前を付けることはできません。 データ タイプ 新しい属性のデータ タイプ。ドロップダウン リストから次のいずれか のデータ タイプを選択します。 • BOOLEAN • INTEGER • STRING • ID • TIME • DOUBLE • UNDEFINED 長さ このパラメータは、STRING データ タイプを使用する属性にだけ適 用されます。この属性の文字数を入力します。この属性に割り当て 可能な最大文字数は、アプリケーションをインストールするデータ ベースによって異なります。 繰り返し この属性が複数の値を持てるかどうかを指定します。この属性に対 して複数の値を指定できるようにするには、チェックボックスをオン にします。 182 EMC Documentum Composer バージョン 7.2 ユーザ ガイド タイプの管理 プロパティ 説明 修飾不可 この属性が修飾可能であるか修飾不可であるかを指定します。 修飾できない属性のプロパティと値は、直列形式で格納されます。基 になるデータベース テーブルには、これらのプロパティまたは値専用 の、プロパティや値が定義されるオブジェクト タイプを表す列は存在し ません。つまり、データベースに公開されていないため、修飾できない 属性をクエリで使用することはできません。 デフォルト値 単一値属性のデフォルト値 (1 つ) または繰り返し属性のデフォルト 値 (複数) を指定します。[新規作成] をクリックしてデフォルト値を入 力します。 属性の制約の設定 属性制約は、[タイプ属性] ビューの [制約] セクションで設定します。 制約は、タイプの属性値同士またはタイプの属性値と定数値を関係付ける、Docbasic 式の形式で 表した内部的な整合性要件です。 次の表の説明に従って、属性制約のプロパティの入力または指定を行います。 プロパティ 説明 式 制約を定義する Docbasic 式。[新規作成] をクリックして式を作 成します。式の作成または変更を行う方法の詳細については、 制約式の設定 (83ページ) を参照してください。 適用 アプリケーションがこの制約を適用するかどうかを指定します。 表の [適用] 列のセルをクリックして、関連付けられた式に対す る制約の適用を有効または無効にすることができます。 制約フィールドに指定できる値は次の 2 種類です。 • 無効: 制約は無効です。 • アプリケーションの実行: このタイプを使用するアプリケーショ ンによって制約が実行されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 183 タイプの管理 プロパティ 説明 アプリケーション実行時にスーパータ イプ制約を無視 アプリケーションで、このタイプの属性に関するスーパータイプ 制約を無視するよう指定する場合に選択します。 属性は空白不可 属性に必ず値を設定するように指定する場合に選択します。 エンド ユーザは、アプリケーションの実行時にこの属性の値 を入力する必要があります。 属性は読み取り専用 属性が読み取り専用であることを示す場合に選択します。エ ンド ユーザは、アプリケーションの実行時に属性の値を変更 することはできません。 属性に NULL 値を指定可能 属性に値を割り当てなくてもよいことを示す場合に選択します。 エンド ユーザは、アプリケーションの実行時にこの属性の値を 入力する必要はありません。 不変オブジェクトでの属性の変更が 可能 オブジェクト自体が不変 (変更不可) の場合でも、ユーザがその 属性を編集できるようにする場合に選択します。 タ イ プ 属 性 UI の 設 定 属性 UI は、クライアント アプリケーションでの属性の表示方法を指定するもので、[UI] ビュー [アプリケーション イン で設定されます。[UI] ビューを開くには、属性ディレクトリ ツリーで ターフェイス表示] をクリックします。 [タイプ属性] UI プロパティ ビューには、[全般] セクションと [検索] セクションが表示されます。 184 EMC Documentum Composer バージョン 7.2 ユーザ ガイド タイプの管理 次の表の説明に従って、[全般] セクションと [検索] セクションで、属性 UI のプロパティを入力 または指定します。 プロパティ 説明 全般 ラベル クライアント アプリケーションでこの属性に対して表示される 名前。 入力マスク クライアント アプリケーションでこの属性に対してエンド ユーザ が入力できる文字および形式を指定します。入力マスクは、マ スク文字およびリテラルで構成されます。バックスラッシュ (\) の直後の文字はリテラルに変換されます。入力マスクに使用 できる値は次のとおりです。 • #: 数字 (0 ～ 9) • A: 英数字 (0 ～ 9、a ～ z、A ～ Z) • &: 任意の ASCII 文字 • ?: アルファベット (a ～ z、A ～ Z) • U: アルファベット (大文字に変換) • L: アルファベット (小文字に変換) 入力マスクの例については、入力マスク (186ページ) を参 照してください。 カテゴリ デスクトップ クライアントで表示されるカスタム タブを表す文字 列。[カテゴリ] フィールドに入力した値は、親タイプの表示設定 の継承が壊れていたり、タイプまたはその親に対してすでに表 示設定が指定されている場合以外に使用されます。 ユーザ ヘルプ アプリケーションに表示されるタイプの説明 (オプション)。 開発者へのコメント 開発者に対するコメント (オプション)。 検索 検索可能 属性が検索可能かどうかを指定します。オブジェクトが属性の タイプから派生している場合に、クライアントでユーザがそのオ ブジェクトの属性値のリポジトリを検索できるようにするには、こ のオプションを選択します。 使用可能な演算子 属性検索用に指定可能な演算子が表示されます。1 つまたは 複数の演算子を選択して [追加] をクリックすると、選択した演 算子が [許可された演算子] 列に移動します。 許可された演算子 クライアント アプリケーションで属性値を検索する際に使用でき る検索演算子を指定します。 デフォルト検索値 クライアントにデフォルトで表示される検索値。オプションのパラ メータ。デフォルトの検索値が指定されていない場合、クライア ントでは空のフィールドが表示されます。 デフォルト検索演算子 クライアントにデフォルトで表示される検索演算子。オプション のパラメータ。デフォルトの検索演算子が指定されていない場 合、クライアントでは空のフィールドが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 185 タイプの管理 入力マスク 次の表に、マスクの値と有効なユーザ入力の例を示します。 マスク値 説明 有効なユーザ入力 ##/##/#### 日付のエントリを表します。 08/23/1968 ##:## UU 時間のエントリを表します。 2:42 PM ###-##-#### 連続する数値 (アメリカの社会保障番号など) を入力するための形式を表します。 111223333 ??????????????? 15 文字以内で入力する文字列 (都市名など) を表します。 Munich 条件付き属性値の設定 条件付き値マッピングにより、クライアント プログラムが実行時にオブジェクト属性に対して表示す る値のリストが生成されます。ユーザはこのリストから値を選択したり、新しい値をリストに追加したり することができます。条件付き値マッピングには次の 2 種類があります。 • デ フ ォ ル ト の 値 マ ッ ピ ン グ: オブジェクトの新規作成時など、選択されている値がない場合に 表示される値。 • 条 件 付 き の 値 マ ッ ピ ン グ : ある属性で表示される値が別の属性の値に依存している場合など、 指定した条件を満たした場合に表示される値。 条件付き値マッピングは、[値のマッピング] ビューの [条件アシスタンス] セクションで設定します。 条件付き値マッピングを作成するには 1. [値のマッピング] ビューの [条件アシスタンス] セクションで、[新規作成] をクリックします。 [条件値アシスタンス] ダイアログ ボックスが表示されます。 186 EMC Documentum Composer バージョン 7.2 ユーザ ガイド タイプの管理 2. 次の表の説明に従って、条件値のプロパティを設定します。 プロパティ 説明 式 条件を表す Docbasic 式。この Docbasic 式は、true または false のいずれかに解決される必要があります。 固定リスト 固定リストのフォームの条件に値が関連付けられることを指定 します。値の固定リストを使用する場合はこのオプションを選 択し、[値] フィールドにそれぞれの値を入力します。 値 条件に関連付けられる値を指定します。[値] フィールドに、 値をカンマで区切って入力します。文字列値は、個々の行 に入力する必要があります。 リスト完了 ユーザによるリストへの値の追加ができないことを指定します。 クエリ 条件に関連付けられる値がクエリによって取得されることを 指定します。[クエリ] テキストボックスにクエリを入力します。 $value キーワードを使用すると、属性値を実行時に解決でき ます。 キャッシュされたクエリの許可 キャッシュされたクエリを許可する場合に選択します。 データを持つクエリ属性 条件用のデータ値を持つクエリ属性を指定します。クエリ 属性の名前を入力します。 3. [OK] をクリックして変更を保存します。 属性値のマッピングの設定 値マッピングでは、クライアント プログラムに表示される文字列と属性値を関連付けまたはマッピン グします。クライアント プログラムに表示されるマッピングされた文字列を選択し、オブジェクトをリ ポジトリに保存すると、対応する値がマッピングされた文字列に保存されます。属性値は、[値の マッピング] ビューの [値のマッピング テーブル] セクションでマップします。 値のマッピングを作成または変更するには EMC Documentum Composer バージョン 7.2 ユーザ ガイド 187 タイプの管理 1. [値のマッピング] ビューの [値のマッピング テーブル] セクションで、[新規作成] をクリッ クします。 システムによって、[属性値] 列と [表示文字列] 列に dataValue と displayValue が表示さ れます。 2. [属性値] のデータ値 フィールドをクリックして、リポジトリに保存される属性値を入力します。 3. [表示文字列] 列の表示値 フィールドをクリックして、マップされた値としてクライアント アプリ ケーションに表示される文字列を入力します。 4. [説明] 列のフィールドをクリックして、値マッピングを説明する文字列を入力します。 値マッピングを削除するには、[値のマッピング テーブル] で対応する行を選択し、[削除] を クリックします。 タ イ プ UI 情 報 の 設 定 [タイプ UI 情報] ビューでは、Documentum クライアントやカスタム アプリケーションに表示される 属性を指定できます。タイプ エディタの [タイプ] タブをクリックすると [タイプ UI 情報] ビューが 表示されます。 188 EMC Documentum Composer バージョン 7.2 ユーザ ガイド タイプの管理 クライアントに表示する 1 つまたは複数の属性を設定するには、次の表の説明に従ってタイ プ UI 情報を入力します。 プロパティ 説明 アプリケーション インターフェイス表示 タイプ ラベル このタイプについてクライアント アプリケーションで表示さ れる文字列。 ユーザ ヘルプ アプリケーションに表示されるタイプの説明 (オプション)。 開発者へのコメント 開発者に対するコメント (オプション)。 表示設定 スコープ タイプ属性が表示されるアプリケーションの名前。アプリケー ションの名前が、リポジトリに存在している必要があります。 表示設定リスト 属性が表示されるタブを指定します。次のようにしてタブ の追加、削除、タブ名の変更、タブ位置の変更を行うこと ができます。 • タブを追加するには、[新規作成] をクリックします。[表 示設定] ダイアログ ボックスが表示されます。クライアン ト アプリケーションに属性を表示するためのタブを追加 する方法の詳細については、タブの追加 (190ページ) を参照してください。 • タブを削除するには、リストからタブ名を選択して [削除] を クリックします。 • タブの名前を変更するには、リストからタブ名を選択して [名前変更] をクリックします。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 189 タイプの管理 プロパティ 説明 • タブの表示順序を変更するには、リストからタブ名を選択 し、[上へ] または [下へ] をクリックして目的の位置にタブ を移動します。 表示設定の属性 タブに表示される属性を編集できます。 タブの追加 タブを追加するには、[表示設定] ダイアログ ボックスを使用します。 タブを追加するには 1. [タイプ UI 情報] ビューの [表示設定リスト] セクションで、[新規作成] をクリックします。タイプ UI 情報の設定 (188ページ) で、[タイプ UI 情報] ビューを示しています。 [設定リストの表示] テキストボックスに、新規タブ用のデフォルトのタブ (NewConfig1) が 表示されます。 2. デフォルトのタブを選択して [編集] をクリックします。 [表示設定] ダイアログ ボックスが表示されます。 3. 次の表の説明に従って、タブ プロパティを設定します。 190 EMC Documentum Composer バージョン 7.2 ユーザ ガイド タイプの管理 タブのプロパティ 説明 設定名 タブ名を表す文字列。新しいタブ名を入力するか、デフォルトの タブ名をそのまま受け入れます。この設定名がクライアント アプ リケーションに表示されます。 使用可能な属性 タブに表示できる属性の一覧が表示されます。タブに表示する 属性を選択して、[追加] をクリックします。選択した属性は [選択 した属性の配列] リストに表示されます。 使用可能な属性の一覧が空の場合は、設定されている属性が ありません。属性の設定の詳細については、タイプ属性の追加 (181ページ) を参照してください。 選択した属性の配列 タブに表示される属性と、それらの属性をどのように表示するか を指定します。タブに表示される属性の配置は、属性を選択し、 次のボタンを使用することによって変更できます。 • 上へ: 表示順序の上の方に属性を移動します。 • 下へ: 表示順序の下の方に属性を移動します。 • 区切り文字の追加: 選択した属性とその次の属性の間に区切 り文字を追加します。 • 区切り文字の削除: 区切り文字を削除します。 • 次のページへ: 1 つのタブにすべての属性が収まらない場合、 次のページに表示されるようにします。 カスタム属性のみ [使用可能な属性] リストにカスタム属性のみ表示する場合に 選択します。 非表示属性のみ [使用可能な属性] リストに非表示属性のみ表示する場合に 選択します。 4. [OK] をクリックして変更を保存します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 191 タイプの管理 192 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 19 章 XML ア プ リ ケ ー シ ョ ン の 管 理 この章では、次について説明します。 • XML ア プ リ ケ ー シ ョ ン と ア プ リ ケ ー シ ョ ン 設 定 フ ァ イ ル に つ い て • XML Application ア ー テ ィ フ ァ ク ト の 作 成 • XML ア プ リ ケ ー シ ョ ン 設 定 フ ァ イ ル の 表 示 ま た は 変 更 XML ア プ リ ケ ー シ ョ ン と ア プ リ ケ ー シ ョ ン 設 定 フ ァ イルについて XML アプリケーションは、XML オブジェクトとリンクされた未解析エンティティをリポジトリに格納す る方法をカスタマイズおよび自動化します。XML アプリケーションを設定すると、さまざまな種類の XML ドキュメントを自動的に認識したり、格納場所、小さいファイルに分割するかどうか、メタデー タを抽出してリポジトリ内のオブジェクトに割り当てる方法、割り当てるセキュリティのレベル、ドキュ メントのライフサイクルをアタッチするかどうかを決定するルールを設定することができます。 XML Application ア ー テ ィ フ ァ ク ト の 作 成 Composer には、XML Application アーティファクトを定義できる組み込みエディタがあります。 XML Application ア ー テ ィ フ ァ ク ト を 作 成 す る に は 1. [Documentum Navigator] ビューでプロジェクトの [XML Applications] フォルダを右クリック し、[新規作成] > [XML アプリケーション] を選択します。 [新しい XML アプリケーション アーティファクト ウィザード] が表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 193 XML アプリケーションの管理 2. ［アーティファクト名] フィールドに、XML Application アーティファクトに付ける名前を入 力します。 3. 次のいずれかを実行します。 • 既存の XML 設定ファイルを使用する場合は、[ファイル システムの既存の設定ファイルを 使用] を選択し、[参照] をクリックしてファイルを検索します。 • [Documentum のデフォルトの設定ファイルをテンプレートとして使用] を選択します。 4. [終了] をクリックします。 XML アプリケーション エディタの [全般] タブが表示されます。 5. [ルート要素] セクションで、次のいずれかの操作を行うことによって、処理するルート要素 を追加します。 • [ルート要素の選択] リストからルート要素を選択する。 • [または新しいルート要素を入力して追加] フィールドにルート要素を入力する。 操作が完了したら [追加] をクリックします。 194 EMC Documentum Composer バージョン 7.2 ユーザ ガイド XML ア プ リ ケ ー シ ョ ン の 管 理 6. DTD またはスキーマを使用して XML アプリケーションを検証する場合は、[高度] タブを クリックして指定します。 [XML アプリケーション文法とサポート ドキュメント] ビューが表示されます。 7. [文法] セクションで、次の操作を実行します。 a. [文法の使用] を選択します。 b. 次のいずれかを選択します。 • DTD またはスキーマをリポジトリで管理する場合は、[リポジトリ]。 • DTD またはスキーマをローカル ファイル システムで管理する場合は、[ローカル ファイ ル システム]。 c. どれを使用するかに応じ、[XML スキーマ] または [DTD] を選択し、XML スキーマまたは DTD を指定します。XML スキーマ または DTD をリポジトリで管理する場合は、選択でき るように、アーティファクトがプロジェクト内にある必要があります。 8. [サポート ドキュメント フォルダ] セクションで、XML アプリケーションに必要なアーティファ クトを追加します。 9. [XML サンプル ドキュメント] セクションで、XML ドキュメントのサンプルを追加します。 XML アプリケーション設定ファイルの表示または変更 Composer では、既存の XML アプリケーションをプロジェクトにインポートできます。その後、XML 設定ファイル エディタを使用して XML アプリ ーション設定ファイルを変更できます。XML 設定 ファイル エディタには、種類ごとにまとめられたルールのリストがあり、XML ドキュメント内の要素を ルールのベースとすることができます。ルールの 4 つの種類は次のとおりです。 • XML コ ン テ ン ツ ル ー ル XML コンテンツ ルールは、最もよく使用されるルールで、解析済み XML コンテンツに適用さ れます。XML コンテンツ ルールの主な機能は、一般にドキュメント内の XML コンテンツを分割 することです。しかし、このルールに、分割されない XML ドキュメントに対するメタデータの割り 当てのような、他の主要な目的もあります。 • リンク ルール リンク ルールは、XML ドキュメントにある外部ファイルへのリンクや、NDATA エンティティへ の参照を使用して、グラフィックス ファイルなどの未解析エンティティを特定および処理しま EMC Documentum Composer バージョン 7.2 ユーザ ガイド 195 XML アプリケーションの管理 す。リンク ルールの機能は、オブジェクトのロケーション、メタデータの値、アクセス権などを 割り当てるという点では XML コンテンツ ルールと似ています。リンクされたファイルを子とし て扱うか、それとも XML 仮想ドキュメントのピアとして扱うか、このリンクが永続的なリンク であるかどうかも指定できます。 • 非 XML コ ン テ ン ツ ル ー ル 非 XML コンテンツ ルールは、base64 エンコード データなど、XML ドキュメントに含まれている 非 XML コンテンツをサーバーが処理する方法を指定します。非 XML コンテンツ ルールの機 能は、オブジェクトのロケーション、メタデータ値、またはアクセス権を割り当てるという点では XML コンテンツ ルールやリンク ルールと似ています。加えて、デコードされたデータが含ま れるリポジトリ オブジェクトのファイル形式を指定できます。 • 要素ルール 要素ルール、つまりエンティティ ルールは、すべての外部解析済み (XML) エンティティを、イン ポートまたはチェックイン時に XML 仮想ドキュメントの個々のコンポーネントとして保持し、メイ ン XML ドキュメントのエクスポートまたはチェックアウト時にそれらのステータスを外部エンティ ティとして保持することを、XML アプリケーションに指示します。 XML アプリケーションと XML アプリケーション設定ファイルについては、『Documentum XML Applications Development Guide (Documentum XML アプリケーション開発ガイド)』を参照して ください。 XML ア プ リ ケ ー シ ョ ン 設 定 フ ァ イ ル を 表 示 ま た は 変 更 す る に は 1. プロジェクトで、[XML Applications] フォルダを展開します。 2. 変更する .xmlapplications ファイルをダブルクリックします。 XML アプリケーション エディタが表示されます。 3. [全般] セクションの [設定] リンクをクリックします。 [XML 設定ファイル エディタ] が表示されます。 196 EMC Documentum Composer バージョン 7.2 ユーザ ガイド XML ア プ リ ケ ー シ ョ ン の 管 理 4. 必要に応じて XML 設定ファイルを変更し、変更内容を保存します。 注 記 : XML アプリケーション設定ファイルでリポジトリ オブジェクトへの参照を追加または削除 した場合、プロジェクト内でも同じ変更を加えます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 197 XML アプリケーションの管理 198 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 20 章 プロジェクトのビルドおよびインストール この章では、次について説明します。 • ビルドおよびインストールのプロセスについて • プロジェクト インストール オプションの設定 • インストール前プロシージャとインストール後プロシージャの設定 • アーティファクト インストール オプションの設定 • DAR フ ァ イ ル の 生 成 • プロジェクトのインストール • インストール パラメータの作成 • インストール パラメータ ファイルの作成 • DAR イ ン ス ト ー ラ で の DAR フ ァ イ ル の イ ン ス ト ー ル ビルドおよびインストールのプロセスについて Composer プロジェクトを実行するには、リポジトリ内でビルドおよびインストールする必要がありま す。ビルド プロセスでは、Composer によりプロジェクトの実行可能バージョンが生成されます。 Composer プロジェクトのこの実行可能なバージョンは、DAR (Documentum アーカイブ) と呼ば れ、プロジェクトの実行可能なバイナリ ファイルが含まれる単一のファイルで構成されています。 Composer プロジェクトをインストールする方法は次の 3 通りがあります。 • Composer の ユ ー ザ イ ン タ ー フ ェ イ ス Composer のユーザ インターフェイスを使用すると、リポジトリに Documentum プロジェクトをイン ストールできます。インストール プロセスの一部として、プロジェクト インストール オプションの 設定 (200ページ) 、および アーティファクト インストール オプションの設定 (203ページ) の 説明に従って、プロジェクト全体と個々のアーティファクトに適用される特定のインストール パラメータを設定します。 アプリケーションをビルドして、DAR インストーラまたは headless Composer で使用する DAR アー カイブ ファイル (.dar) を生成することもできます (DAR ファイルの生成 (205ページ) を参照)。 • DAR イ ン ス ト ー ラ DAR インストーラはプロジェクトをビルドすることはできませんが、Composer または headless Composer で事前にビルドした DAR ファイルをインストールできます。 • Ant タ ス ク と headless Composer Ant タスクと headless Composer を使用すると、プロジェクトをビルドして DAR ファイルを生成し、 自動化に便利なコマンド ライン インターフェイスを使用して DAR ファイルをリポジトリにインス EMC Documentum Composer バージョン 7.2 ユーザ ガイド 199 プロジェクトのビルドおよびインストール トールできます。Ant タスクと DAR ファイルの使用方法については、headless Composer ビルド の作成 (213ページ) を参照してください。 プロジェクト インストール オプションの設定 プロジェクト インストール オプションを使用すると、DFS モジュール オプション、インストール前プロ シージャ、インストール後プロシージャ、アップグレード オプションなど、プロジェクト全体に適用さ れるインストール パラメータを設定できます。 プロジェクト インストール オプションを設定するには 1. Composer のメイン メニューで、インストールするプロジェクトの名前を右クリックし、ドロップダウ ン メニューから [プロパティ] を選択します。 [Documentum プロジェクト] ダイアログ ボックスが表示されます。 2. 次の表の説明に従って、プロジェクトのインストール オプションを指定します。 200 インストール オプション 説明 所有者 このプロジェクトをインストールするための所有者のインストール パラ メータを指定します。所有者は、プロジェクトがインストールされるリポジ トリで有効なユーザである必要があります。[選択] をクリックしてリスト ボックスから所有者を選択します。新しい所有者インストール パラメー タを追加する方法の詳細については、所有者インストール パラメー タの追加 (201ページ) を参照してください。 ロケーション このプロジェクトをインストールするためのロケーションのインストール パラメータを指定します。[選択] をクリックし、リストボックスからロケー ションを選択するか、デフォルト値を受け入れます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド プロジェクトのビルドおよびインストール インストール オプション 説明 セキュリティ このプロジェクトをインストールするためのアクセス権セット (ACL) パ ラメータを指定します。[選択] をクリックしてリストボックスからロケー ションを選択します。 アップグレード オプション このプロジェクトをインストールする際に使用するアップグレード オプ ションを指定します。アップグレード オプションには次の 3 つの種 類があります。 • 一 致 す る オ ブ ジ ェ ク ト を 上 書 き : プロジェクトで一致するオブジェクト を持つリポジトリ内のオブジェクトをすべて上書きします。プロジェクト に新しいオブジェクトがある場合、それらのオブジェクトは新しいオ ブジェクトとしてリポジトリにインストールされます。 • 一 致 す る オ ブ ジ ェ ク ト は 更 新 し な い : プロジェクトで一致するオブ ジェクトを持つリポジトリ内のオブジェクトをすべて無視します。プロ ジェクトに新しいオブジェクトがある場合、それらのオブジェクトは新 しいオブジェクトとしてリポジトリにインストールされます。 • 一致するオブジェクトの新しいバージョンを作成: リポジトリで一致す るオブジェクトを持つプロジェクト内のすべてのオブジェクトについて 新しいバージョンを作成します。プロジェクトに新しいオブジェクト がある場合、それらのオブジェクトは新しいオブジェクトとしてリポ ジトリにインストールされます。 3. [Documentum プロジェクト] をダブルクリックしてメニュー ツリーを展開します。 4. 必要に応じて [インストール プロシージャ] を選択してインストール前プロシージャおよびインス トール後プロシージャを指定し、関連する [インストール前プロシージャ] フィールドおよび [イ ンストール後プロシージャ] フィールドでプロシージャ名を入力します。 5. [OK] をクリックしてプロジェクト インストール オプションを保存します。 所有者インストール パラメータの追加 プロジェクトをインストールするための所有者インストール パラメータを指定するには、[プリンシパ ル (ユーザまたはグループ)] ダイアログ ボックスを使用します。所有者は、プロジェクトがインストー ルされるリポジトリで有効なユーザまたはグループである必要があります。 所有者インストール パラメータを追加するには 1. [Documentum プロジェクト] ダイアログ ボックスで、[所有者] フィールドの横にある [選択] をク リックします。 [プリンシパル (ユーザまたはグループ) インストール パラメータ] ダイアログ ボックスが表示さ れます。 2. [新規作成] をクリックします。 [新しいプリンシパル (ユーザまたはグループ) インストール パラメータ] ダイアログ ボック スが表示されます。 3. [次へ] をクリックしてデフォルトのフォルダとアーティファクト名を受け入れます。 [インストール パラメータ アーティファクト] ダイアログ ボックスが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 201 プロジェクトのビルドおよびインストール 4. 次のとおり、パラメータの名前、タイプ、説明 (オプション)、デフォルト値を入力します。 パラメータ 説明 パラメータ名 所有者インストール パラメータの名前を指定する文字列。 パラメータ タイプ 所有者インストール パラメータのタイプを指定する文字列。タイプはデ フォルトで [プリンシパル (ユーザまたはグループ) インストール パラ メータ] に設定されており、変更できません。 説明 所有者インストール パラメータの説明 (オプション)。 デフォルト値 所有者インストール パラメータのオプションのデフォルト値。所有者イ ンストール パラメータのデフォルト値を指定する場合、所有者はプ ロジェクトがインストールされたリポジトリで有効なユーザである必 要があります。 5. [終了] をクリックします。 インストール前プロシージャとインストール後プロシー ジャの設定 プロジェクトのインストール前プロシージャとインストール後プロシージャは、[インストール プロ シージャ] ダイアログ ボックスで設定できます。 インストール前プロシージャとインストール後プロシージャを設定するには 1. プロジェクトを右クリックし、ドロップダウン リストから [プロパティ] を選択します。 [プロパティ] ダイアログ ボックスが表示されます。 2. [Documentum プロジェクト] を展開し、[インストール プロシージャ] を選択します。 [インストール プロシージャ] ダイアログ ボックスが表示されます。 202 EMC Documentum Composer バージョン 7.2 ユーザ ガイド プロジェクトのビルドおよびインストール 3. [インストール前プロシージャ] フィールドまたは [インストール後プロシージャ] フィールドの横 の [選択] ボタンをクリックします。 [プロシージャ アーティファクト] ダイアログ ボックスが表示されます。 4. [一致するアーティファクト] リストからプロシージャを選択するか、[新規作成] をクリック してプロシージャを作成します。 5. [OK] をクリックします。 アーティファクト インストール オプションの設定 Composer により、プロジェクト レベルと個々のアーティファクトについて、インストール オプ ションを設定できます。アーティファクトのインストール オプションは、プロジェクト インストール オプションに優先します。 個々のアーティファクトのインストール オプションを設定するには 1. [Documentum Navigator] ビューで、インストール オプションを設定するアーティファクトを右ク リックし、ドロップダウン リストから [プロパティ] を選択します。 [Documentum アーティファクト] プロパティ ダイアログ ボックスが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 203 プロジェクトのビルドおよびインストール 2. 次の表の説明に従って、アーティファクトのインストール オプションを指定します。 インストール オプション 説明 所有者 このアーティファクトをインストールするための所有者のインストール パ ラメータを指定します。所有者は、アーティファクトがインストールされる リポジトリで有効なユーザである必要があります。[選択] をクリックしてリ ストボックスから所有者を選択します。新しい所有者インストール パラ メータを追加する方法の詳細については、所有者インストール パラメー タの追加 (201ページ) を参照してください。 ロケーション このアーティファクトをインストールするためのロケーションのインストー ル パラメータを指定します。[選択] をクリックしてリストボックスからロ ケーションを選択します。 セキュリティ このアーティファクトをインストールするためのアクセス権セット (ACL) パラメータを指定します。[選択] をクリックしてリストボックスからロケー ションを選択します。 ストレージ ストレージ インストール パラメータを指定します。[選択] をクリックし、リ ストボックスからストレージ インストール パラメータを選択します。 ストレージ パラメータは、システム オブジェクトのアーティファクトと、シ ステム オブジェクトのサブタイプであるその他のアーティファクト (プロ シージャ、JAR 定義など) で指定できます。 たとえばタイプなどのようなシステム オブジェクトのサブタイプではな いアーティファクトで使用可能なストレージ フィールドがありません。 Composer はインストール中にタイプ オブジェクト用のストレージ タ イプを設定します。 デフォルトでは、プロジェクトまたは DAR のインストールではストレージ 属性が設定されません。インストール中、Content Server はリポジトリ に格納されたストレージ ポリシーに基づいてこの値を設定します。デ フォルトの動作を上書きして各アーティファクトに [プロパティ] ページ で指定されたストレージ タイプを設定するには、システム プロパティ (com.emc.ide.installer.enableStorage) を指定します。Java VM 引数に 行を追加するには、composer.ini または darinstaller.ini を変更します。 次の図は、composer.ini ファイルにシステム プロパティを追加する方 法を示しています。 204 EMC Documentum Composer バージョン 7.2 ユーザ ガイド プロジェクトのビルドおよびインストール インストール オプション 説明 -vmargs -Xms64m -Xmx512m -XX:MaxPermSize=256m -Dcom.emc.ide.installer.enableStorage アップグレード オプション このアーティファクトをインストールする際に使用するアップグレード オ プションを指定します。アップグレード オプションは 3 つあります。 • 一 致 す る オ ブ ジ ェ ク ト を 上 書 き : プロジェクトで一致するオブジェクト を持つリポジトリ内のオブジェクトをすべて上書きします。プロジェクト に新しいオブジェクトがある場合、それらのオブジェクトは新しいオブ ジェクトとしてリポジトリにインストールされます。 • 一致するオブジェクトは更新しない: プロジェクトで一致するオブジェ クトを持つリポジトリ内のオブジェクトをすべて無視します。プロジェク トに新しいオブジェクトがある場合、それらのオブジェクトは新しいオ ブジェクトとしてリポジトリにインストールされます。 • 一 致 す る オ ブ ジ ェ ク ト の 新 し い バ ー ジ ョ ン を 作 成 : リポジトリで一致 するオブジェクトを持つプロジェクト内のすべてのオブジェクトに ついてバージョンを作成します。プロジェクトに新しいオブジェクト がある場合、それらのオブジェクトは新しいオブジェクトとしてリポ ジトリにインストールされます。 注 記 : スマート コンテナ アーティファクトのインストール オプショ ンを設定する場合、アップグレード オプションを [一致するオブ ジェクトの新しいバージョンを作成] に設定する必要があります。 スマート コンテナ オブジェクトを上書きすると既存のインスタンス に対するモデル インスタンスの関連付けが無効になるので、ス マート コンテナ アーティファクトには [一致するオブジェクトを上 書き] を選択しないでください。 3. [OK] をクリックして変更を保存します。 DAR フ ァ イ ル の 生 成 DAR ファイルは、プロジェクトの実行可能バージョンであり、Documentum リポジトリにインストール されます。DAR ファイルには、ソース ファイルではなく、プロジェクトのバイナリ ファイルだけが含ま れるため、DAR ファイルを Composer プロジェクトに変換することはできません。DAR ファイルは、 DAR インストーラまたは headless Composer を使用してインストールできます。 [プロジェクト] > [Build Automatically (自動的にビルド)] オプションをオンにしている場合、Composer ワークスペースの ...\<workspace>\<project>\bin-dar ディレクトリから <project>.dar ファイルを取得で きます。多くの場合、このオプションをオンにしておくことをお勧めします。[プロジェクト] > [Build Automatically (自動的にビルド)] オプションをオフにしている場合は、次の手順を完了させます。 DAR フ ァ イ ル を 生 成 す る に は 1. ビルドするプロジェクトを右クリックします。 2. ドロップダウン リストから [Build Project (プロジェクトのビルド)] を選択します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 205 プロジェクトのビルドおよびインストール Composer によってプロジェクトがビルドされ、...\<workspace>\<project>\bin-dar ディレクトリ に <project>.dar ファイルが生成されます。ここで、<workspace> はワークスペースの名前 で、<project> はプロジェクトの名前です。 プロジェクトのインストール プロジェクトを作成し、アプリケーションのデプロイの準備が整ったら、アプリケーションをビルドし てリポジトリにインストールします。ソース管理システムを使用している場合、アプリケーションをビ ルドしてデプロイする前に、ソース管理からプロジェクトをチェックアウトします。 プロジェクトをインストールするには 1. [Documentum Project Navigator] ビューで、インストールするプロジェクトを右クリックし、ドロッ プダウン メニューから [Documentum プロジェクトのインストール] を選択します。Composer によ り、プロジェクトがバックグラウンドで自動的にビルドされます。ビルド プロセス中のすべてのエ ラーは、[エラー] ビューに表示されます。 [インストール設定] ダイアログ ボックスが表示されます。 2. 次の表の説明に従って、インストール情報を入力します。 206 インストール パラメータ 説明 リポジトリ インストール リポジトリの名前。必須パラメータ。リポジトリの名前 を入力するか、ドロップダウン リストからリポジトリを選択します。リ ポジトリにアクセスするには、スーパーユーザ権限が必要です。 ユーザ名 リポジトリのログイン ユーザ名。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド プロジェクトのビルドおよびインストール インストール パラメータ 説明 パスワード リポジトリのログイン パスワード。 ドメイン リポジトリのドメイン名。クライアントがリポジトリにアクセスする ドメインと異なるドメインにリポジトリがある場合、ドメイン名を 指定します。 インストール オプション プロジェクトをリポジトリにインストールする方法を指定します。イ ンストール オプションには次の 3 つの種類があります。 • プ ロ ジ ェ ク ト と ア ー テ ィ フ ァ ク ト 設 定 を 使 用: プロジェクト プ ロパティの [プロジェクト インストール オプション] ダイアロ グ ボックスで設定したオプションに従ってプロジェクトをイン ストールします。 • 上 書 き : プロジェクトがリポジトリに存在している場合、プロジェ クトの変更バージョンがインストールされると、すべてのオブ ジェクトが上書きされます。 • バ ー ジ ョ ン: プロジェクトがリポジトリに存在している場合、プロ ジェクトの変更バージョンがインストールされると、バージョン 更新が可能なオブジェクトのバージョンが更新されます。バー ジョン更新できないオブジェクトは上書きされます。 インストール パラメータ ファイル を使用 インストール パラメータ ファイルを使用する場合は、このオプショ ンを選択します。オプションのパラメータ。[参照] をクリックし、イ ンストール パラメータ ファイルを選択します。このプロジェクトを 初めてインストールする場合に入力パラメータ ファイルを使用す るには、まず入力パラメータ ファイルを作成します (インストール パラメータ ファイルの作成 (210ページ) を参照)。 ローカライズされたアーティファク ト データのインストール プロジェクトをローカライズする場合は、このオプションを選択し ます。オプションのパラメータ。[参照] をクリックし、ローカライズさ れたファイルが含まれる [ロケール プロパティ フォルダ] を選択し ます。プロジェクトのローカライズの詳細については、Composer プロジェクトのローカライズ (31ページ) を参照してください。 3. [次へ] をクリックします。 [インストール パラメータ ファイル値の編集] ダイアログ ボックスが表示されます。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 207 プロジェクトのビルドおよびインストール インストール パラメータ テーブルには、各インストール パラメータの名前、タイプ、デフォルト 値が一覧表示されます。 注 記 : 各インストール パラメータのデフォルト値を変更し、入力パラ メータ ファイルに新しい値を保存できます。入力パラメータ ファイルの作成の詳細について は、インストール パラメータ ファイルの作成 (210ページ) を参照してください。 4. [終了] をクリックすると、プロジェクトがリポジトリにインストールされます。 注 記 : リポジトリにプロジェクトをインストールして、そのプロジェクトを Composer で編集し、1 つ または複数のオブジェクトを削除してプロジェクトを再インストールすると、古いオブジェクトはリ ポジトリ内に残ります。プロジェクトからオブジェクトが削除されている場合でも、インストール 時にリポジトリからオブジェクトを削除することはしません。 インストール パラメータの作成 インストール パラメータ ファイルを作成するには 1. Composer プロジェクトで、[Artifacts] フォルダを展開し、[インストール パラメータ] を右クリック します。[新規作成] > [インストール パラメータ] を選択します。 [新しいインストール パラメータ] ダイアログ ボックスが表示されます。 2. 新しいインストール パラメータの名前を入力してから、[次へ] をクリックします。 208 EMC Documentum Composer バージョン 7.2 ユーザ ガイド プロジェクトのビルドおよびインストール [インストール パラメータ アーティファクト] ダイアログ ボックスが表示されます。 3. 次の表の説明に従って、プロパティを入力します。 インストール オプション 説明 パラメータ名 インストール パラメータの名前を表示します。 パラメータ タイプ インストール パラメータのタイプを選択します。 • ユ ー ザ イ ン ス ト ー ル パ ラ メ ー タ : プロジェクトをインストールするため に所有者インストール パラメータを作成する場合に選択します。 • ACL イ ン ス ト ー ル パ ラ メ ー タ : アクセス権セット (ACL) インストール パラメータを作成する場合に選択します。 • フ ォ ル ダ イ ン ス ト ー ル パ ラ メ ー タ : フォルダ インストール パラメータ を作成する場合に選択します。 • ス ト レ ー ジ イ ン ス ト ー ル パ ラ メ ー タ : ストレージ インストール パラメー タを選択する場合に選択します。ストレージ インストール パラメータ の詳細については、アーティファクト インストール オプションの設定 (203ページ) を参照してください。 ユー ザ ま た は グ ル ー プ ) イ ン ス ト ー ル パ ラ メ ー タ : プロ • プ リ ン シ パ ル (ユ ジェクトをインストールするために所有者インストール パラメー タを作成する場合に選択します。 新しい所有者インストール パラメータを追加する方法の詳細 については、所有者インストール パラメータの追加 (201ペー ジ) を参照してください。 • グ ル ー プ イ ン ス ト ー ル パ ラ メ ー タ : プロジェクトをインストールするた めに所有者インストール パラメータを作成する場合に選択します。 説明 インストール パラメータの説明を入力します。 デフォルト値 インストール パラメータのデフォルト値を入力します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 209 プロジェクトのビルドおよびインストール インストール パラメータ ファイルの作成 1 つまたは複数のインストール パラメータのデフォルト インストール値を変更する場合は、インス トール パラメータ ファイルを作成します。インストール パラメータ ファイルには、プロジェクトの各イ ンストール パラメータの名前、タイプ、デフォルト値が含まれます。 インストール パラメータ ファイルを作成するには 1. Composer プロジェクトで、[インストール パラメータ ファイル] を右クリックする。ドロップダウン メ ニューから [新規作成] > [その他] を選択します。 [ウィザードを選択] ダイアログ ボックスが表示されます。 2. [インストール パラメータ ファイル] をダブルクリックして展開し、[インストール パラメータ ファイ ルの新規作成ウィザード] を選択して [次へ] をクリックします。 [入力ファイル モデル] ダイアログ ボックスが表示されます。 3. インストール パラメータ ファイルの親フォルダを選択して [ファイル名] フィールドにファ イル名を入力し、[次へ] をクリックします。 2 つ目の [入力ファイル モデル] ダイアログ ボックスが表示されます。 210 EMC Documentum Composer バージョン 7.2 ユーザ ガイド プロジェクトのビルドおよびインストール 4. [モデル オブジェクト] ドロップダウン リストで、[インストール パラメータ ファイル] を選択し ます。[XML エンコード] ドロップダウン リストで、[UTF-8] を選択します。次に、[終了] をク リックします。 Composer により入力パラメータ ファイルが作成され、そのファイルが [リソース セット] ビューに 表示されます。 DAR イ ン ス ト ー ラ で の DAR フ ァ イ ル の イ ン ス ト ー ル DAR ファイルは、Composer プロジェクトがデプロイ可能なパッケージとなったものです。このイン ターフェイスを Composer 内で使用しない場合は、DAR インストーラを使用して DAR ファイルをリ ポジトリにインストールします。DAR インストーラは、Documentum 製品の DAR ファイルをインス トールする場合や、DAR ファイルのインストールと DAR ファイルの開発を分離する場合に便利で す。DAR インストーラを使用するには Composer がインストールされている必要がありますが、 完全な Composer IDE は起動されません。 DAR ファイルは、headless Composer を使用してインストールすることもできます。headless Composer を使用して DAR ファイルをインストールする方法の詳細については、headless Composer ビルドの作成 (213ページ) を参照してください。 DAR インストーラを開くと、Composer のインストール ディレクトリに 3 つのフォルダが作成されます。 • darinstallerconfig: DAR インストーラ プラグインの設定ファイルを含みます。 • darinstallerlogs: ログ ファイルのデフォルトのロケーションです。 • darinstallerworkspaces: DAR インストーラ プラグインによって作成され使用されるワーク スペースです。 DAR インストーラ プラグインは、DAR ファイルのインストール後、これらのワーク スペースを自動的に削除することはありません。ワークスペース ディレクトリには、 darinstaller_workspace_yyyy-mm-dd-hh-mm-ss という形式で名前が付けられます。ワークスペー スでプロジェクトを手動で移動、削除、または追加すると、DAR のインストールに悪影響を及 ぼす可能性があります。 DAR インストーラでは、アスタリスク (*) が付いている値は必ず入力する必要があります。それ以 外のフィールドの入力は任意です。 DAR フ ァ イ ル を イ ン ス ト ー ル す る に は EMC Documentum Composer バージョン 7.2 ユーザ ガイド 211 プロジェクトのビルドおよびインストール 1. DAR インストーラを起動するには、Composer ルート ディレクトリにある dardeployer.exe を実 行します。 2. [DAR の詳細] セクションで、各フィールドの値を指定します。 3. [Connection Broker Details (コネクション ブローカの詳細)] セクションで、[Connection Broker Host (コネクション ブローカのホスト)] および [Connection Broker Port (コネクション ブローカの ポート)] の値を指定して、[接続] をクリックします。 4. [リポジトリの詳細] セクションで、各フィールドの値を指定し、[インストール] をクリックして DAR ファイルをリポジトリにインストールします。 [ログ ファイル] ドロップダウン メニューからログ ファイルを選択し、[開く] をクリックすると、DAR の インストールに関するログを見ることができます。 次の表で、DAR インストーラ プラグインのフィールドについて説明します。 パラメータ 必ず指定 説明 DAR はい インストールする .dar ファイルの 絶対ファイル パス。ファイル パス に国際化文字が含まれていると インストールが失敗します。 入力ファイル いいえ インストール ベースのパラメータ ファイルの絶対ファイル パス。 ローカル フォルダ いいえ ローカライズされた .properties ファイルの絶対ファイル パス。ア プリケーションを他の言語で使 用可能にする場合、プロジェクト データ (ラベル、タブ、説明など) をローカライズします。 ログ ファイル いいえ ログが保存されるファイル。指定 しない場合、デフォルトのファイル 名 <DAR>.log が付けられます。 コネクション ブローカのホスト はい 接続ブローカのアドレス。 コネクション ブローカのポート はい 接続ブローカ リポジトリのポート。 リポジトリ はい DAR ファイルをインストールする リポジトリの名前。Docbroker のホ ストとポートを入力してから [接続] ボタンをクリックすると、利用可能 なリポジトリが取得されます。 ユーザ名 はい リポジトリのログイン名。 パスワード はい リポジトリにログインするための パスワード。 ドメイン いいえ ユーザのドメイン。 212 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 21 章 Ant タ ス ク と headless Composer を 使 用 し た プ ロ ジ ェ ク ト お よ び DAR フ ァ イ ル を 管 理する この章では、次について説明します。 • headless Composer ビ ル ド の 作 成 • emc.importProject • emc.createArtifactProject • emc.createTaskspaceApplicationProject • emc.importArtifacts • emc.importContent • emc.build • emc.dar • emc.install • emc.setUpgradeOption • UNIX および Linux システムでの headless Composer を使用した DAR ファイルのインストール headless Composer ビ ル ド の 作 成 headless Composer は、Composer の非 UI コマンドライン バージョンであり、インポート、ビルド、 インストールなど、Composer の一般的なビルドやデプロイの機能を持つ Ant タスクのセット が含まれます。 headless Composer ビルドにより、Composer プロジェクトのビルドとインストールを自動化できます。 headless Composer ビルドは主に 2 つの部分で構成されます。1 つはビルドを定義する Ant スクリ プトで、もう 1 つは、ビルド環境を設定して Ant スクリプトを実行するバッチ ファイルです。 Composer プ ロ ジ ェ ク ト の ビ ル ド 、 変 更 、 イ ン ス ト ー ル を 行 う Ant ス ク リ プ ト の 作 成 Ant スクリプトは、ビルドを定義する XML ファイルです。Composer の Ant タスクにより、自動化され たビルドから特定の Composer 機能を呼び出すことができます。 一般に、プロジェクトのビルドとインストールを行うには、それぞれ別個の Ant ビルド ファイルを作 成します。Ant スクリプトを正常に機能させるには、UTF-8 でエンコードしてください。 Ant ス ク リ プ ト を 作 成 す る に は 1. build.xml という名前のファイルを作成します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 213 Ant タスクと headless Composer を使用したプロジェクトおよび DAR ファイルを管理する 2. emc.importProject タスクを使用して、作業対象のプロジェクトを headless Composer ワークス ペースにインポートするターゲットを作成します。emc.createArtifactProject タスクを使用して新 しいプロジェクトを作成することもできます。他の Ant タスクを呼び出す前に、プロジェクトを ワークスペースに作成するかインポートする必要があります。 3. emc.importArtifacts タスクまたは emc.importContent タスクを使用して、プロジェクトに変 更を加えます。 4. emc.build タスクを使用して、プロジェクトをビルドするターゲットを作成します。emc.dar タスクの 前にこのタスクを呼び出し、作成された最新のコードが DAR ファイルに含まれるようにします。 5. emc.dar タスクを使用して、DAR ファイルを生成するターゲットを作成します。emc.install タスク の前にこのタスクを呼び出し、emc.build タスクから作成されたコードが、後でインストール可能 な新しい DAR ファイルに含まれるようにします。 6. install.xml という名前のファイルを作成します。 7. emc.install タスクを使用して、DAR ファイルをインストールするターゲットを作成します。 build.xml フ ァ イ ル の 例 <?xml version="1.0"?> <project name="HelloWorldBuild" default="package-project"> <target name ="import-project" description=" Must import a project before updating, building, or installing it"> <emc.importProject dmproject="HelloWorldArtifacts" failonerror="true"/> </target> <target name="update-jardef" depends="import-project" description=" Update JARDef with most current JAR file"> <emc.importContent dmproject="HelloWorldArtifacts" artifactpath="Artifacts/JAR Definitions/hello.jardef" contentfile="build_workspace/HelloWorldBOFModule/bin-impl/hello.jar" /> </target> <target name="build-project" depends="update-jardef" description="Build the project"> <emc.build dmproject="HelloWorldArtifacts" failonerror="true"/> </target> <target name="package-project" depends="build-project" description="Package the project into a DAR for installation"> <delete file="HelloWorld.dar" /> <emc.dar dmproject="HelloWorldArtifacts" manifest="bin/dar/default.dardef.artifact" dar="HelloWorld.dar" /> </target> </project> install.xml フ ァ イ ル の 例 <?xml version="1.0"?> <project name="headless-install" default="install-project"> <target name="install-project" description="Install the project to the specified repository. dfc.properties must be configured"> <emc.install dar="HelloWorld.dar" 214 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Ant タスクと headless Composer を使用したプロジェクトおよび DAR ファイルを管理する docbase="GlobalRegistry" username="Administrator" password="emc" domain="" /> </target> </project> 注 記: 他の参照 DAR ファイルに依存している DAR ファイルをインストールする場合、まず、それ らの参照 DAR ファイルを、インストール対象の DAR ファイルと同じ Ant スクリプトでインストールし ます。これは、以前にインストールした参照 DAR ファイルであっても同様です。 ビルドを設定および実行するバッチ ファイルの作成 バッチ ファイルを使用してローカル マシン上で環境変数とワークスペースを設定し、ビルドのイン ポート、作成、またはインストールの命令を含む Ant スクリプトを呼び出します。 次のバッチ ファイル例では、これらのアクションが実行されます。 • Eclipse のディレクトリ パスを C:\ComposerHeadless に指定する。 • プロジェクトのインポートおよびビルド用のワークスペース (BUILDWORKSPACE) と、生成され た DAR ファイルのインストール用のワークスペース (INSTALLWORKSPACE) を作成する。 • ビルド スクリプトとインストール スクリプト (build.xml および install.xml) の格納場所を指定する。 • ワークスペースを削除する。 • ビルドしたワークスペースに Composer プロジェクトをコピーする。 • ビルド スクリプトおよびインストール スクリプトを実行する。 バッチ ファイルの例 REM Set environment variables to apply to this command prompt only SETLOCAL REM Sets the root location of headless Composer SET ECLIPSE="C:\ComposerHeadless" REM Sets the location of your source projects. REM This location gets copied into your build workspace directory SET PROJECTSDIR="C:\Documents and Settings\Administrator\composer-workspace" REM Sets the workspace directory where Composer builds the projects REM that you want to install to a repository SET BUILDWORKSPACE="C:\ComposerHeadless\example build\build_workspace" REM Sets the workspace directory where Composer extracts built DAR files REM before installing them to a repository SET INSTALLWORKSPACE="C:\ComposerHeadless\example build\install_workspace" REM Sets the Ant script that builds your projects SET BUILDFILE="C:\ComposerHeadless\example build\build.xml" REM Sets the Ant script that installs your projects set INSTALLFILE="C:\ComposerHeadless\example build\install.xml" REM Delete old build and installation workspaces EMC Documentum Composer バージョン 7.2 ユーザ ガイド 215 Ant タスクと headless Composer を使用したプロジェクトおよび DAR ファイルを管理する RMDIR /S /Q %BUILDWORKSPACE% RMDIR /S /Q %INSTALLWORKSPACE% REM Copy source projects into build workspace XCOPY %PROJECTSDIR% %BUILDWORKSPACE% /E REM Run Ant scripts to build and install the projects JAVA -cp %ECLIPSE%\startup.jar org.eclipse.core.launcher.Main -data %BUILDWORKSPACE% -application org.eclipse.ant.core.antRunner -buildfile %BUILDFILE% JAVA -cp %ECLIPSE%\startup.jar org.eclipse.core.launcher.Main -data %INSTALLWORKSPACE% -application org.eclipse.ant.core.antRunner -buildfile %INSTALLFILE% emc.importProject emc.importProject タスクは Documentum プロジェクトを headless Composer ワークスペースにイ ンポートします。プロジェクトをビルドまたはインストールする際は、事前にワークスペースにイ ンポートしておく必要があります。 構文 <emc.importProject dmproject="project_name" /> 次の表に、emc.importProject パラメータの説明を示します。 パラメータ 説明 dmproject インポートするプロジェクトの名前を指定します。 emc.createArtifactProject emc.createArtifactProject タスクは、Composer プロジェクトを作成します。 構文 角かっこ内の要素および属性は省略可能です。 <emc.createArtifactProject name="project_name" [overwrite="true|false"]> [<projectReferences [failOnMissingReferences="true|false"]> <project name="reference_project_name"/> <projectReferences>] </emc.createArtifactProject> 次の表に、emc.createArtifactProject パラメータの説明を示します。 パラメータ 説明 emc.createArtifactProject タ スク emc.createArtifactProject タスクは、作成するプロジェクトを指定します。作 成するプロジェクトの参照プロジェクトを指定する projectReferences 要 素を含めることもできます。 name 作成するプロジェクトの名前を指定します。 216 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Ant タスクと headless Composer を使用したプロジェクトおよび DAR ファイルを管理する パラメータ 説明 overwrite 既存のプロジェクトを上書きする場合は true を、それ以外の場合は false を 指定します。デフォルトは false です。 projectReferences 要素 (省 略可能) この要素は、プロジェクトに参照プロジェクトを割り当てる場合に指定しま す。参照プロジェクトは、emc.importProject コマンドを使用してワークスペー スにインポートされている必要があります。 projectReferences 要素には、作成するプロジェクトの参照プロジェクトを指 定する project 要素が含まれています。projectReferences 要素には、複数の project 要素を含めることができます。 failOnMissingReferences (省略可能) 参照プロジェクトが使用できないときにビルドを失敗させる場合は true を、それ以外の場合は false を指定します。デフォルトの動作は false に 設定されています。 project 要素 project 要素は、参照プロジェクトとして指定するプロジェクトの名前を指 定します。複数の project 要素を指定できます。 name 参照プロジェクトとして指定するプロジェクトの名前を指定します。プロジェ クトは、emc.importProject タスクを使用して headless Composer のビルド ワー クスペースに事前にインポートされている必要があります。 例 次のターゲットは、Test という名前のプロジェクトを作成します。overwrite 属性を true に設定してい るので、その名前の既存プロジェクトが存在する場合は上書きされます。MyReferenceProject を参 照プロジェクトとして定義し、failOnMissingReferences 属性を true に設定しているので、参照プロ ジェクトが存在しない場合はプロジェクトの作成が失敗します。 <emc.createArtifactProject name="Test" overwrite="true"> <projectReferences failOnMissingReferences="true"> <project name="MyReferenceProject"/> </projectReferences> </emc.createArtifactProject> emc.createTaskspaceApplicationProject emc.createTaskspaceApplicationProject タスクは、TaskSpace アプリケーションから Composer プロ ジェクトを作成します。 構文 角かっこ内の要素および属性は省略可能です。 <emc.createTaskSpaceApplicationProject name="project_name" docbase="repo_name" username="username" password="password"> [<projectReferences> <project name="reference_project_name"/> </projectReferences>] </emc.createTaskSpaceApplicationProject> 次の表に、emc.createTaskspaceApplicationProject パラメータの説明を示します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 217 Ant タスクと headless Composer を使用したプロジェクトおよび DAR ファイルを管理する パラメータ 説明 emc.createArtifactProject タ スク name emc.createTaskspaceApplicationProject タスクは、リポジトリ内の既存の TaskSpace アプリケーションから作成するプロジェクトを指定します。 Composer プロジェクトの名前は、TaskSpace アプリケーションと同じに なります。また、作成するプロジェクトの参照プロジェクトを指定する projectReferences 要素を宣言することもできます。参照プロジェクトは、使用 する前にワークスペースにインポートする必要があります。 作成するプロジェクトの名前を指定します。 Docbase TaskSpace アプリケーションが存在するリポジトリの名前。 username リポジトリにログインするためのユーザ名。 password ユーザ名のパスワード。 projectReferences 要素 (省 略可能) projectReferences 要素には、作成するプロジェクトの参照プロジェクトを 指定する project 要素が含まれています。projectReferences 要素には、複 数のプロジェクト要素を含めることができます。この要素は、プロジェクト に参照プロジェクトを割り当てる場合に指定します。参照プロジェクトは、 emc.importProject コマンドを使用してワークスペースにインポートされてい る必要があります。 project 要素 project 要素は、参照プロジェクトとして指定するプロジェクトの名前を指 定します。複数の project 要素を指定できます。 name 参照プロジェクトとして指定するプロジェクトの名前を指定します。プロジェ クトは、emc.importProject タスクを使用して headless Composer のビルド ワー クスペースに事前にインポートされている必要があります。 例 <emc.createTaskSpaceApplicationProject name="TaskSpaceApp" docbase="repository" username="dmadmin" password="n0lif3"> <projectReferences> <project name="TSWorkflows"/> </projectReferences> </emc.createTaskSpaceApplicationProject> emc.importArtifacts emc.importArtifacts タスクは、アーティファクトをリポジトリから指定したプロジェクトにインポー トします。 構文 角かっこ内の要素および属性は省略可能です。 <emc.importArtifacts project="project_name" docbase="repo_name" username="username" password="password" [domain="xyz"] > <objectIdentities> [<id value="object_id"/>] [<path value="object_path"/>] [<qualification value="dql_qualifer"/>] </objectIdentities> </emc.importArtifacts> 218 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Ant タスクと headless Composer を使用したプロジェクトおよび DAR ファイルを管理する 次の表に、emc.importArtifacts パラメータの説明を示します。 パラメータ 説明 project アーティファクトのインポート先のプロジェクトの名前を指定します。 Docbase アーティファクトが存在するリポジトリ名を指定します。 username リポジトリにログインするためのユーザを指定します。 password リポジトリにログインするためのパスワードを指定します。 domain ユーザのドメインを指定します。 objectIdentities 要素 インポートするアーティファクトの識別情報を指定する id、path、または qualification 要素が含まれます。objectIdentities 要素には、インポートするリポ ジトリ内のオブジェクトの識別情報が含まれています。識別情報の各要素は、 識別情報の値を指定する 1 つの属性 (value) を持っています。 id 要素 リポジトリ内のアーティファクトのオブジェクト ID を指定するために使用します。 path 要素 リポジトリ内のアーティファクトのパスを指定するために使用します。 qualification 要素 リポジトリ内のアーティファクトの DQL 修飾子を指定するために使用します。 例 たとえば、次のターゲットは test_repository から Test プロジェクトにアーティファクトをインポートしま す。インポートするアーティファクトは objectIdentities で宣言され、オブジェクト ID で 1 つ、パスで 1 つ (システム オブジェクトであることが必要)、および DQL 修飾子で 1 つ (通常、タイプやグループ などのシステム オブジェクト以外のオブジェクトに使用される) のオブジェクトが指定されています。 <emc.importArtifacts project="Test" docbase="test_repository" username="dmadmin" password="n0lif3"> <objectIdentities> <id value="08000001800737f7"/> <path value="/System/Applications/Collaboration Services/CreateAcl"/> <qualification value="dm_group where group_name = ’my_group"/> </objectIdentities> </emc.importArtifacts> emc.importContent emc.importContent タスクは、コンテンツ ファイルを、指定したアーティファクトおよびプロジェクトに インポートまたは更新します。現在、emc.importContent コマンドでは、プロシージャ アーティファク トおよび JAR 定義へのコンテンツのインポートのみサポートされます。 構文 <emc.importContent dmproject="project_name" artifactpath="path/to/artifact" contentfile="path/to/content" contentid="content_id" /> 次の表に、emc.importContent パラメータの説明を示します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 219 Ant タスクと headless Composer を使用したプロジェクトおよび DAR ファイルを管理する パラメータ 説明 dmproject コンテンツのインポート先のアーティファクトが含まれるプロジェクトの名前を 指定します。 artifactpath プロジェクトに対するアーティファクトの相対パス名を、アーティファクト自体の名 前を含めて、たとえば Artifacts/JAR Definitions/myjardef のように指定します。 contentfile インポートするコンテンツ ファイルの絶対ファイル パスを指定します。ファイル は読み取り可能なフォーマットでなければなりません。相対パスを指定する場 合は、Ant スクリプトの場所に対する相対パスにします。 contentid (省略可能) コンテンツの識別子を指定します。指定された場合、contentid はプロジェク トのコンテンツ ストア内のコンテンツに一意な名付けをするために使用され ます。contentid が指定されない場合、Composer によりランダムな名前が生 成されて割り当てられます。 emc.build emc.build タスクは、Composer プロジェクトをビルドします。次にプロジェクトを emc.dar タスクに渡し て、DAR ファイルを生成することができます。 構文 角かっこ内の要素および属性は省略可能です。 <emc.build dmproject="project_name" [failonerror="true|false]"/> 次の表に、emc.build パラメータの説明を示します。 パラメータ 説明 dmproject ビルドするプロジェクトの名前を指定します。 failonerror (省略可能) プロジェクトが正しくビルドされないときにビルドを失敗させる場合は true を、そ れ以外の場合は false を指定します。 emc.dar emc.dar タスクは、Documentum プロジェクトから DAR ファイルを生成します。emc.dar タスクは emc.build タスクの出力に依存しているので、同じ Java プロセスで実行する必要があります。適切 に機能するように、両方のタスクを同じ Ant スクリプトに定義して、同じビルド内で呼び出します。 構文 <emc.dar dmproject="project_name" manifest="bin/dar/project_name.dardef.artifact|default.dardef.artifact" dar="path/to/dar/dar_name.dar" /> 次の表に、emc.dar パラメータの説明を示します。 220 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Ant タスクと headless Composer を使用したプロジェクトおよび DAR ファイルを管理する パラメータ 説明 dmproject DAR ファイルのビルド元のプロジェクトの名前を指定します。 manifest プロジェクトの bin/dar ディレクトリにある project.dardef.artifact または default.dardef.artifact ファイルへの相対ファイル パスを指定します。このファイル は通常、default.dardef.artifact という名前です。ただし、リポジトリから DocApp をインポートしてプロジェクトが作成された場合は例外です。その場合は、 ファイルは project.dardef.artifact という名前になります。ここで、project はプロ ジェクトの名前です。ただし、この場合には、空の default.dardef.artifact ファ イルも作成されます。 dar ターゲット .dar ファイルの絶対ファイル パス。.dar ファイルがすでに存在し てはなりません。 emc.install emc.install タスクは、プロジェクトの DAR ファイルをリポジトリにインストールします。 構文 角かっこ内の属性は省略可能です。 <emc.install dar="path/to/dar/dar_name.dar" docbase="repository" username="user" password="password" [domain="domain"]/> [inputfile="path/to/dar/filename.installparam"] [localesFolder="/path/to/locales/folder"] /> 注 記 : 他の参照 DAR ファイルに依存している DAR ファイルをインストールする場合、まず、それ らの参照 DAR ファイルを、インストール対象の DAR ファイルと同じ Ant スクリプトでインストールし ます。これは、以前にインストールした参照 DAR ファイルであっても同様です。 次の表に、emc.install パラメータの説明を示します。 パラメータ 説明 dar インストールする .dar ファイルの絶対ファイル パス。ファイル パスには、Unicode (UTF-8) 文字だけが含まれている必要があります。それ以外の文字が含まれて いる場合は、インストールが失敗します。 Docbase .dar ファイルのインストール先となるリポジトリの名前。 username リポジトリのログイン名。 password リポジトリにログインするためのパスワード。 localesFolder (省略可 能) ローカライズされた .properties ファイルの絶対ファイル パス。アプリケーションを 他の言語で使用可能にする場合、プロジェクト データ (ラベル、タブ、説明など) をローカライズします。プロジェクトのローカライズの詳細については、Composer プロジェクトのローカライズ (31ページ) を参照してください。 inputfile (省略可能) インストール ベースのパラメータ ファイルの絶対ファイル パス。 domain (省略可能) リポジトリが存在するドメイン。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 221 Ant タスクと headless Composer を使用したプロジェクトおよび DAR ファイルを管理する インストール中のデバッグ メッセージを有効化する場合は、次の Ant タスクを呼び出してログ を設定します。 <emc.preferences logTraceMessages="false" logDebugMessages="true /> emc.setUpgradeOption emc.setUpgradeOption タスクにより、プロジェクト ファイルのインストール中にアップグレード オ プションを設定できます。 構文 <emc.setUpgradeOption dmProject="project_name" artifactPath="path/to/artifact" option="OVERWRITE/VERSION/IGNORE"> 次の表に、emc.setUpgradeOption パラメータの説明を示します。 パラメータ 説明 dmproject アップグレード オプションを設定するプロジェクトの名前を指定します。 artifactpath (省略可能) プロジェクトに関連したアーティファクトのパス名を指定します。これは、アー ティファクト ファイルまたはアーティファクトを含むフォルダのパスになります。 たとえば、Artifacts/SysObjects/mysysobject.sysobject や Artifacts/SysObjects のように指定します。 artifactpath を指定すると、アップグレード オプションは特定のアーティファクトに 対して適用されます。そうでない場合、アップグレード オプションはプロジェ クトに対して適用されます。 option アップグレード オプションを指定します。利用可能なオプションは、 OVERWRITE、IGNORE、VERSION です。 このタスク では、複数のアップグレード オプションを設定してアーティファクトにバージョンを設定 し、別のアーティファクトを上書きすることができます。 これらのオプションは、プロジェクト全体、 アーティファクト セット、または特定のアーティファクトに対して設定することができます。 UNIX および Linux システムでの headless Composer を 使 用 し た DAR フ ァ イ ル の イ ン ス ト ー ル UNIX または Linux 用の Content Server にバンドルされている headless Composer のディストリ ビューションは、DAR ファイルを UNIX、Linux、または Windows システムにインストールするため に使用できます。独自のデプロイ スクリプトを作成する手間をかけたくない場合のために、環境を 設定して DAR ファイルのインストールを行うスクリプトが用意されています。 UNIX お よ び Linux シ ス テ ム で headless Composer を 使 用 し て DAR フ ァ イ ル を イ ン ス ト ー ル するには 1. DAR ファイルをインストールするリポジトリの所有者として Content Server システムにログイ ンします。 222 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Ant タスクと headless Composer を使用したプロジェクトおよび DAR ファイルを管理する 2. 環境変数が Content Server のデプロイ ガイドに従って設定されていることを確認します。最 もよく使用するのは、$DM_HOME/bin/dm_set_server_env.sh シェル スクリプトを実行して 環境変数を設定する方法です。 3. 次のコマンドを実行して DAR ファイルをインストールします。各変数は、それぞれの環 境の適切な値に置き換えます。 $JAVA_HOME/bin/java -Ddar=$PATH_TO_DAR_FILE -dlogpath=$PATH_TO_LOG_FILE -Ddocbase=$REPOSITORY_NAME -Duser=$REPOSITORY_SUPER_USER -Ddomain=$REPOSITORY_USER_DOMAIN -Dpassword=$PLAIN_TEXT_PASSWORD -cp $DM_HOME/install/composer/ComposerHeadless/startup.jar org.eclipse.core.launcher.Main -data $DM_HOME/install/composer/workspace -application org.eclipse.ant.core.antRunner -buildfile $DM_HOME/install/composer/deploy.xml 注 記 : 他の参照 DAR ファイルに依存する DAR ファイルをインストールする場合は、提供されてい る deploy.xml スクリプトは使用できません。参照DAR ファイルをまずインストールし、その後に DAR ファイルをインストールするターゲットを含む、独自のAnt スクリプトを作成します。これらの ターゲットは同じ Ant スクリプトに配置し、同じ Ant 呼び出し内で実行する必要があります。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 223 Ant タスクと headless Composer を使用したプロジェクトおよび DAR ファイルを管理する 224 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 22 章 ソース管理システムの操作 この章では、次について説明します。 • ソース管理システムの使用 • プロジェクトのビルド ソース管理システムの使用 開発者のチームが同じ Composer プロジェクトと他の参照先オブジェクトで作業する場合、通常は ソース管理システムを使用して共同作業を可能にします。ほとんどのソース管理システムには、統 合開発環境をサポート する Eclipse ベースのプラグインが用意されています。これらのプラグイン は、Eclipse 3.4 と互換性がある限り Documentum Composer で使用できます。 注 記 : Composer プロジェクトは、読み取り専用であるソース管理システムで開くことはできません。 プロジェクトのチェックイン ソース管理システムを使用する場合には、次のガイドラインに従うことをお勧めします。 • ワークスペースは個人用であるため、Composer ワークスペースではなくプロジェクトをチェック インする。 • 次の Documentum プロジェクト ディレクトリおよびファイルをチェックインする。 – アーティファクト – コンテンツ – dar – Web Services – src (このフォルダが空の場合でも) – プロジェクトのルートにあるディレクトリ以外のすべてのファイル (.classpath、.dmproject、.procject、.template など) その他のディレクトリ (bin、bin-dar など) およびそのディレクトリ内のファイルは派生リソースであ るため、チェックインできません。 プロジェクトのチェックアウトとインポート ソース管理システムを操作する場合は、ソース管理システムからプロジェクトを取得した後、プロ ジェクトを Composer ワークスペースにインポートします。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 225 ソース管理システムの操作 プ ロ ジ ェ ク ト を Composer ワ ー ク ス ペ ー ス に チ ェ ッ ク ア ウ ト お よ び イ ン ポ ー ト す る に は 1. プロジェクトおよび参照されているすべてのプロジェクトを、ソース管理システムからチェック アウトします。 2. Composer で、[ファイル] > [インポート] に移動します。 [インポート - 選択] ダイアログ ボックスが表示されます。 3. [Documentum] をダブルクリックして [既存のプロジェクト (ワークスペース)] を選択し、[次 へ] をクリックします。 [プロジェクトのインポート] ダイアログ ボックスが表示されます。 4. [ルート ディレクトリの選択] フィールドを選択してチェックアウトしたプロジェクトが存在する ルート ディレクトリのパスを入力するか、[参照] をクリックしてルート ディレクトリを探します。[プ ロジェクト] リスト ボックスに、使用可能なプロジェクトが表示されます。 注記: • インポートするプロジェクトが [プロジェクト] リスト ボックスに表示されない場合、Composer ワークスペースに以前のバージョンのプロジェクトが存在していないことを確認してください。 ローカル Composer ワークスペースに存在していないプロジェクトのみインポートできます。 • Composer 7.2 では、[アーカイブ ファイルの選択] オプションはサポートされません。 5. インポートするプロジェクトを選択して、[終了] をクリックします。 [プロジェクトをワークスペースにコピー] オプションは選択しないでください。 226 EMC Documentum Composer バージョン 7.2 ユーザ ガイド ソース管理システムの操作 プロジェクトのビルド プロジェクトのビルドは、コードのコンパイルと似ています。ビルド プロセス中、Composer により アーティファクトが検証されて、検証エラーが報告されます。ビルド プロセスは、次のいずれか の方法で開始できます。 • Composer UI から開始 • headless Composer と Ant タスクの使用 Composer プロジェクトがビルド/テスト/デプロイからなる重要な開発サイクルの一部であり、プロ ジェクトを夜間にビルドするスケジュールの場合は、Ant タスクを使用して DAR ファイルをビル ドするほうが効率的です。Ant タスクを使用した DAR ファイルのビルドの詳細については、 emc.build (220ページ) を参照してください。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 227 ソース管理システムの操作 228 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 第 23 章 Composer に 関 す る よ く あ る 質 問 この章では、次について説明します。 • 全般的な質問 • DAR フ ァ イ ル • ライフサイクルとワークフロー • Composer と DAB/DAI 全般的な質問 • Documentum 6.0 または 5.3 リポジトリとともにComposer は使用できますか。 はい。スマート コンテナ (Documentum 6.0 の後に導入) やアスペクト (Documentum 5.3 の後に導 入) など、Documentum の新機能を利用するアーティファクトや、BPM アーティファクトをインス トールしない限り、Documentum 6.0 または 5.3 リポジトリで Composer を使用することは可能です。 Composer の最新バージョンは、Documentum バージョン 5.3 SP6 以降をサポートしています。 • Composer を使用して、あるリポジトリから別のリポジトリにキャビネット、フォルダ、またはコン テンツを移行できますか。 Composer はデータ移行用ではなくアプリケーション開発用に設計されているので、そのような 使い方はお勧めしません。そのため、キャビネット、フォルダ、コンテンツが多数ある場合、効 率よく移行されることは保証できません。サポート ドキュメントを含む XML アプリケーション フォルダなど、アプリケーションの開発や設定に関連しているフォルダやコンテンツについて は、Composer プロジェクトにインポートすることが可能です。 • 使用しているバージョンの Eclipse 上に Composer プラグインをインストールできるように、 Composer をプラグインのセットとして入手できますか。 いいえ。サポート上の理由から、またインストールを容易にするために、Composer は、Eclipse が 組み込まれた 1 つのパッケージとしてのみ提供しています。 • Linux や Solaris はサポートしていますか。 Linux および Solaris での headless Composer の使用はサポートしていますが、注意事項があり ます。Linux 用または Solaris 用として別個のバージョンの Composer は提供していません。 Content Server インストーラには、これら 2 つのオペレーティング システム用に適切な環境変数 で設定されたバージョンの headless Composer が含まれています。 • Documentum 提供の参照プロジェクトとは何ですか。なぜそれが必要なのですか。 Documentum が提供する参照プロジェクトはビルド不可能なプロジェクトで、このプロジェクトによ り、名前が ’dm’ で始まるアーティファクト (Documentum アーティファクト) を使用または拡張でき ます。Composer では、リポジトリ内の Documentum アーティファクトに意図しない変更が加えられ るのを防ぐために、プロジェクト内に ’dm’ アーティファクトを含めることはできません。’dm’ アー ティファクトを使用または拡張するには、適切な参照プロジェクトを指定する必要があります。 • アーティファクトは個別にインストールできますか。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 229 Composer に関するよくある質問 現在、アーティファクトは Composer プロジェクトの一部としてインストールする必要があります。 • Composer プロジェクトまたは DAR のアンインストールはサポートしていますか。 いいえ。Content Server では、タイプなど特定のアーティファクトのアンインストールはサポートし ていないためです。実験が可能な開発環境で作業する場合は、必要な場合に変更をロール バックできるように VMWare の使用をお勧めします。 • Docbasic のインストール前スクリプトとインストール後スクリプトはまだ使用できますか。 はい。インストール前スクリプトとインストール後スクリプトは、Documentum プロジェクトのプロパ ティに指定します。スクリプトを指定するには、[Documentum プロジェクト] > [インストール プロ シージャ] セクションで Composer プロジェクトを右クリックします。 • Composer を使用して大容量サーバ用のアプリケーションを開発できますか。 はい。軽量システム オブジェクト プラグインを別個にダウンロードして、Composer 上にイン ストールできます。 • 使用している Composer のバージョンを確認するには、どうすればよいですか。 [ヘルプ] メニューから、[Documentum Composer のバージョン情報] を選択します。[バージョン 情報] ダイアログ ボックスが表示されます。Composer のバージョンはここで確認できます。 DAR フ ァ イ ル • DAR とは何ですか。 DAR ファイルは、Composer プロジェクトのパッケージ出力ファイルです。DAR インストーラ プラグインまたは headless Composer でリポジトリにインストールするアーティファクトが含ま れますが、アーティファクトのソース コードは含まれません。Java ソース コードと比較する と、JAR ファイルと似たようなものです。DAR ファイルは、Composer では、DAB の DocApp アーカイブに相当します。 • DAR ファイルをインストールするには、どうすればよいですか。 DAR インストーラか、Ant タスクと headless Composer を使用します。Composer UI では、DAR ファイルのインストールはできません。 • 「Unzipped resource must exist (<アーティファクト パス\アーティファクト名>) (解凍されたリソース が (<アーティファクト パス\アーティファクト名>) に存在する必要があります)」というエラーが発生 して、DAR のインストールが失敗します。何が問題ですか。 解凍されたアーティファクト ファイルのパスの長さが、Windows で許可される長さを超えて います。ファイル パスを短くするには、システム ルート フォルダかパスが長くないフォルダ に Composer をインストールしてください。 • darinstaller.exe を実行して DAR インストーラ UI を起動しようとすると、エラーが発生します。何 が問題ですか。 – 互換性のある Java 環境がインストールされていないか、JAVA_HOME が設定されていま せん。これを確認するには、コマンド ラインで ’java -version’ コマンドを実行します。シス テムで java コマンドが認識されない場合やバージョンに互換性がない場合は、サポート されているバージョンの Java をインストールして、JAVA_HOME 環境変数が Java のインス トール場所を指すように設定してください。 – Composer ディレクトリに darinstallerstartup.jar ファイルがないか、間違ったディレクトリから darinstaller.exe が実行されています。darinstaller.exe は、Composer のルート フォルダから実 行する必要があります。darinstallerstartup.jar がない場合は、Composer を再インストールして ください。次のコマンドを実行すると、DAR インストーラが起動するか、エラーが発生します。 java \-cp darinstallerstartup.jar com.emc.ide.installer.darinstaller.starter.DarInstallerStarterMain 230 EMC Documentum Composer バージョン 7.2 ユーザ ガイド Composer に 関 す る よ く あ る 質 問 ライフサイクルとワークフロー • ライフサイクルを検証するには、どうすればよいですか。 DAB では、メニュー アイテムを明示的に起動してライフサイクルを検証できました。Composer では、ライフサイクルはインストール時に自動的に検証されます。Composer の場合、ライフサイ クルを手動で検証する必要はありません。ライフサイクルが検証できないと、エラーが表示 され、Composer プロジェクトのインストールが失敗します。 • ライフサイクルをアンインストールするには、どうすればよいですか。 ライフサイクルのアンインストールはサポートしていませんが、非アクティブ化をサポートしてい プロ パ テ ィ ] ウィンドウの [概要] タブにある ます。ライフサイクルを非アクティブにするには、[プ [Inactivate lifecycle (ライフサイクルの非アクティブ化)] チェックボックスをオンにして、Composer プロジェクトを再インストールします。 • Composer でワークフロー テンプレートを作成するには、どうすればよいですか。 Composer では、IDE にワークフロー エディタが組み込まれていません。Composer には Workflow Manager ツールが含まれており、これは <Composer_root>\WorkflowManager ディ レクトリにあります。 • ワークフロー テンプレートを Composer にインポートできますか。 ワークフロー テンプレートと BPM プロセス テンプレートは、同一のインフラストラクチャに基づい ています。Composer UI では、BPM の用語を使用することを選択しました。Composer を使用し てリポジトリから個別のアーティファクトをインポートする場合、アーティファクト タイプとして [プロ セス テンプレート] を選択すると、ワークフロー テンプレートが表示されます。個別のワークフ ロー テンプレート/BPM プロセス テンプレートをインポートする手順は、次のとおりです。 1. Composer プロジェクトを右クリックして [インポート...] を選択します。 2. リポジトリから、[Documentum] -> [アーティファクト] に移動します。 3. リポジトリの認証情報を入力します。 4. [アーティファクト タイプ] ドロップダウンから、[プロセス テンプレート] を選択します。 • ワークフロー テンプレートを開発環境から QA 環境に移行するために、そのテンプレートを Composer にインポートしようと思います。テンプレートをインストールする際、バージョン作成か 上書きのどちらを選ぶべきですか。 このような場合、Documentum では一般的なベスト プラクティスはありません。次に示す 2 つ の選択肢について説明します。 – 上書き: ターゲット環境にある既存のワークフロー テンプレートを上書きします。つまり、処理 中のワークフローはすべて、新しいワークフロー テンプレートの影響を受けます。現在の状況 や用途について、この方法が適切であるかどうかを判断する必要があります。 – バージョン: ターゲット環境にある既存のワークフロー テンプレートのバージョンを設定しま す。新しく作成されたワークフロー プロセスでは新しいテンプレートが使用され、処理中 のワークフローについては古いバージョンのワークフロー テンプレートが使用されます。 Documentum のデフォルト設定では、上書きします。 • Composer で、間違ったバージョンのワークフロー テンプレートおよびフォーム テンプレートがイ ンポートされているようです。最新のインストール バージョンがインポートされることもあれば、下 書きバージョンがインポートされることもあります。何が起きているのですか。 Composer は常に、現在 (CURRENT) のバージョンのワークフロー テンプレートやフォーム テン プレートを取得します。オブジェクトのステータス (下書き、インストール済みなど) は考慮されま せん。常に最新のインストール バージョンが取得されるようにするには、開発時に、最新インス トールバージョンが現在 (CURRENT) のラベルを持つように設定します。 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 231 Composer に関するよくある質問 • 5 つのワークフロー テンプレート、20 ～ 30 のフォーム テンプレート、20 ～ 30 の UI テンプレート を含む、大きな TaskSpace アプリケーションがあります。各ワークフロー テンプレートには数百の アクティビティが含まれています。Composer プロジェクトを構築する際のベスト プラクティスはあ りますか。Composer プロジェクトは、1 つまたは複数のいずれにするべきでしょうか。 パフォーマンスの観点からは、複数の Composer プロジェクトでも、1 つの大きい Composer プロ ジェクトでも、インストールされるアーティファクトの総数は同じであるため、違いはありません。 ただし、アプリケーションの開発方法によっては、Composer プロジェクトを複数にしたほうが都合 がよい場合もあります。たとえば、特定のワークフローが頻繁に変更される場合、そのワークフ ローを別個の Composer プロジェクトに含めるのがよいこともあります。このように、TaskSpace ア プリケーション全体を再インストールしなくても、ワークフローをインストールすることが可能です。 十分な大きさの最大ヒープ サイズで Composer を起動することをお勧めします。 <Composer_root>/eclipse.ini ファイルを開いて ’-Xmx’ オプションを編集することにより、ヒープ サイズを変更できます。値がまだ設定されていない場合、1024m に変更してください。編集が 済むと、オプションは ’-Xmx1024m’ のように表示されます。 Composer と DAB/DAI • Composer と DAB/DAI の違いは何ですか。 DAB/DAI は、MFC ベースのアプリケーションであり、Documentum アーティファクトを設定する 際に使用されていました。Composer は、DAB/DAI に取って代わるものとして、Eclipse インフラ ストラクチャ上にビルドされます。 • Composer を使用しなければならないのは、なぜですか。DAB/DAI を引き続き使用できない のは、なぜですか。 近い将来、DAB/DAI は生産終了になります。 • DocApp と DAR はどちらでも同じように使用できますか。Composer と DAB/DAI はどちら でも同じように使用できますか。 いいえ。DocApp と DAR を同じように使用することはできません。早急に Composer に切り替 えることをお勧めします。 • DocApp を変換しようとしています。移行リポジトリはどれになりますか。 Composer では、DocApp アーカイブを変換する場合、DocApp アーカイブをリポジトリにインス トールしてから、そのインストールされた DocApp に基づいて Composer プロジェクトを作成しま す。移行リポジトリは、DocApp アーカイブのインストール先として選択したリポジトリになりま す。ベスト プラクティスとして、この移行リポジトリは、DocApp アーカイブが以前にインストール されたことがないリポジトリとし、DocApp アーカイブに含まれるいずれのアーティファクトもそ のリポジトリ内に存在しないようにします。 • 5.3 SPx DocApp から 7.2 Composer プロジェクトに移行できますか。 はい。5.3 SPx から 7.2 に直接移行可能です。 232 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 索引 英数字 ACL 概要, 143 拡張アクセス権, 144 基本アクセス権, 144 作成, 143 テンプレート, 143, 145 パブリック, 143 標準, 144 Ant タスク DAR の生成, 220 DAR ファイルのインストール, 221 アップグレード オプションの設定, 222 プロジェクトのインポート, 216 プロジェクトのビルド, 220 AntRunner, 11 Composer アーキテクチャ, 11 インストール, 12 ワークスペースの設定, 15 Composer 言語パック、インストール, 16–17 Composer 言語パックのインストール, 16–17 Composer と DAB/DAI, 232 DAR インストーラ, 230 DAR ファイル, 230 Ant を使用したインストール, 221 Ant を使用した生成, 220 生成, 205 DFS サービス カタログ, 63 サービス ライブラリ, 62 モジュール オプション, 62 DocApp インポート, 40 DocApp アーカイブ インポート, 43 変換, 42 Documentum が提供する参照プロジェクト, 229 Documentum アーティファクト, 25 Documentum ソリューション パースペクティブ, 65 EAR file, 73 emc.build コマンド, 220 emc.dar コマンド, 220 emc.importProject コマンド, 216 emc.install コマンド, 221 headless Composer DAR のインストール, 221 DAR の生成, 220 アップグレード オプションの設定, 222 インストール, 14 プロジェクトのビルド, 220 JAR エディタ, 104 概要, 103 JAR 定義、作成, 103 Java ライブラリ エディタ, 105 Java ライブラリ EMC Documentum Composer バージョン 7.2 ユーザ ガイド 概要, 103 リンク, 105 JRE、設定, 15 SBO, 135 TBO, 135 Web サービス エクスポート, 73 発行, 72 Web サービス DFS モジュール, 62 Documentum ソ リ ュ ー シ ョ ン パースペクティブ, 65 WSDL, 70 サービス カタログ, 63 サービスのインポート, 67 サービスの使用, 68 Workflow Manager、起動, 13 WSDL, 70 XML アプリケーション エディタ, 195 設定ファイル, 195 説明, 193 ア アクセス権 概要, 143 拡張, 144 基本, 144 アクセス権セット 作成, 143 テンプレート, 145 標準, 148 ライフサイクル, 124 アクセス権セット エディタ, 148 アスペクト UI 情報, 87 制約式, 83 説明, 81 タイプへの添付, 175 モジュール, 81 アスペクト エディタ, 82 アスペクト属性 制約, 86 アスペクト タイプ、作成, 81 アスペクト モジュール, 135 DFC のバージョン, 95 Java VM のバージョン, 95 Java システム プロパティ, 95 エディタ, 90 作成, 90 実行時環境, 94 静的にデプロイされたクラス, 95 タイプ, 91 デプロイの設定, 92 名前, 91 バージョン要件, 94 ローカル リソース, 95 233 索引 値のマッピング、オブジェクト タイプ, 186 アンインストール、Composer プロジェクトまたは DAR, 229 アーティファクト インストール オプション, 203 インポート, 28 作成, 25 アーティファクト、使用可能リスト, 25 イ 一時関係タイプ, 155 イベント、オブジェクト タイプ, 180 インストール Ant を使用した DAR ファイル, 221 Composer, 12 Composer を使用するプロジェクト, 200 アーティファクト オプション, 203 パラメータ, 200 プロジェクト オプション, 200 インストール、DAR ファイル, 230 インストール オプション 上書き, 231 バージョン, 231 インポート DocApp, 40 DocApp アーカイブ, 43 Web サービス, 67 アーティファクト, 28 外部プロジェクト, 21 エ エイリアス セット エディタ, 77 作成, 77 詳細, 79 説明, 77 エクスポート、Web サービス, 73 エディタ JAR ファイル, 104 Java ライブラリ, 105 XML, 195 アクセス権セット, 148 アスペクト タイプ, 82 アスペクト モジュール, 90 エイリアス セット, 77 関係タイプ, 155 軽量オブジェクト タイプ, 176 サービス カタログ, 71 システム オブジェクト, 167 ジョブ, 131 スマート コンテナ, 159 フォーマット, 99 メソッド, 129 モジュール定義, 135 ライフサイクル, 108 234 オ オブジェクト システム オブジェクト, 167 スマート コンテナ, 159 オブジェクト タイプ UI, 188 アスペクト属性の制約, 86 イベント, 180 属性, 181 属性 UI, 184 属性構造, 182 属性制約, 183 定義, 171 入力マスク, 186 表示設定, 190 カ 関係、スマート コンテナ エディタ, 165 関係タイプ 一時, 155 エディタ, 155 システム, 155 ク 具現化, 178 繰り返し属性、ライフサイクル エディタ, 115 ケ 軽量オブジェクト 具現化, 178 作成, 176 説明, 171 コ コマンド emc.build, 220 emc.dar, 220 emc.importProject, 216 emc.install, 221 emc.setUpgradeOption, 222 サ 作成 JAR 定義, 103 アスペクト タイプ, 81 アスペクト モジュール, 90 モジュール定義, 135 サポート、Linux または Solaris, 229 参照、他のプロジェクト, 24 EMC Documentum Composer バージョン 7.2 ユーザ ガイド 索引 サービス カタログ エディタ, 71 設定, 63 サービス カタログ、サービスのインポート, 67 サービスベース モジュール, 135 シ システム オブジェクト エディタ, 167 属性, 169 定義, 167 システム関係タイプ, 155 実行時環境 アスペクト モジュール, 94 モジュール, 139 状態 アクション, 115 エントリの基準, 114 属性, 125 タイプ, 113 ジョブ エディタ, 131 ス ストレージ インストール パラメータ, 205 スマート コンテナ エディタ, 159 関係, 165 新規ドキュメント, 163 新規フォルダ, 161 定義, 159 テンプレート, 164 ドキュメント, 162 フォルダ, 161 プレースホルダ, 164 セ 生成、DAR ファイル, 220 接続ブローカ、設定, 14 設定 Java JRE, 15 アスペクト モジュールのデプロイ, 92 モジュールのデプロイ, 138 設定、アップグレード オプション, 222 設定ファイル、XML アプリケーション, 195 ソ 属性 値のマッピング, 186 オブジェクト タイプ, 181 システム オブジェクト, 169 制約, 183 ソース管理システム 使用, 225 プロジェクトのチェックイン, 225 EMC Documentum Composer バージョン 7.2 ユーザ ガイド プロジェクトのビルド, 227 タ タイプ アスペクトの添付, 175 エディタ, 176 制約式, 179 属性, 181 属性入力マスク, 186 タイプ UI, 188 タイプベース モジュール, 135 チ 違い、Composer と DAB/DAI, 232 テ テンプレート、スマート コンテナ, 164 ト ドキュメント所有者、ライフサイクル エディタ, 123 ドキュメント、スマート コンテナ, 162 ドキュメント レンダラ、ライフサイクル エディタ, 123 トレース、有効化, 37 ニ 入力パラメータ ファイル, 210 入力マスク, 186 ハ 発行、Web サービス, 72 バージョン ラベル、ライフサイクル エディタ, 118 パースペクティブ、Documentum ソリューション, 65 ヒ 表示設定、オブジェクト タイプ, 190 ビルド、プロジェクト, 199 フ フォルダ、スマート コンテナ, 161 フォーマット エディタ, 99 プレースホルダ、スマート コンテナ エディタ, 164 プロジェクト, 19 Ant を使用したビルド, 220 DFS サービス ライブラリ, 62 DFS モジュールの設定, 62 DocApp アーカイブから作成する, 43 DocApp から作成, 40 インストール オプション, 200 235 索引 インストール プロシージャ, 202 インポート, 21 作成, 19 参照, 24 ソース管理システムからのインポート, 225 ソース管理へのチェックイン, 225 入力パラメータ ファイル, 210 ビルド, 199 ローカライズ, 31 プロジェクトのローカライズ, 31 プロシージャ エディタ, 154 プロパティ エイリアス セット, 79 ライフサイクル, 109 ヘ 変換 DocApp アーカイブ, 42 変更後の情報、ライフサイクル エディタ, 125 ライフサイクルとワークフロー ライフサイクルのアンインストール, 231 ライフサイクルの検証, 231 ワークフロー テンプレートのインポート, 231 ワークフロー テンプレートの作成, 231 リ リポジトリ、dfc.properties ファイル, 14 リンク、Java ライブラリ, 105 ロ ロケーション リンク、ライフサイクル エディタ, 119 ローカライズ テンプレート, 31 ワ ワークスペース 設定, 15 メ メソッド エディタ, 129 モ モジュール アスペクト, 135 インターフェイス JAR, 92 エディタ, 135 クラス名, 92 作成, 135 サービスベース (SBO), 135 実行時環境, 139 実装 JAR, 92 タイプベース (TBO), 135 デプロイの設定, 138 ラ ライフサイクル アクセス権セット, 124 エディタ, 108 オブジェクト タイプ, 107 繰り返し属性, 115 状態, 111 状態エントリの基準, 114 状態属性, 125 状態タイプ, 113 状態のアクション, 115 ドキュメント所有者, 123 ドキュメント レンダラ, 123 バージョン ラベル, 118 プロパティ, 109 変更後の情報, 125 ロケーション リンク, 119 236 EMC Documentum Composer バージョン 7.2 ユーザ ガイド