|
| |
| Sun Java™ System Identity Manager 7.0 ワークフロー、フォーム、およびビュー | |
第 3 章
Identity Manager フォームこの章では、Sun JavaTM System Identity Manager の管理者向けおよびユーザー向けインタフェースの各種ページを定義するフォームを編集することで、選択したページの外観や動作をカスタマイズする方法について説明します。
この章の内容
この章は、次の各節で構成されています。
- フォームについて - フォームの基本概念を紹介し、Identity Manager にフォームを統合する方法について説明します。
- フォームのカスタマイズ - フォームを操作するときに使用する、プログラミングの構文とロジックに関するガイドラインについて説明し、各種フォーム要素の例を示します。
- カスタマイズしたフォームの検証 - フォームの構文を検証したり、カスタムフォームのフィールドロジックを追跡したりする方法について説明します。
関連する章
- 「Identity Manager のビュー」- ユーザービューと呼ばれる Identity Manager の内部データ構造と連携する Identity Manager フォームについて説明します。フォームをカスタマイズするときは、ビューの属性を呼び出します。
- 「HTML 表示コンポーネント」- フォームを編集するときは、フィールド定義の作成に HTML コンポーネント言語を使用します。
- 「XPRESS 言語」- 式を使用して、フォームにロジックを設定します。
- 「Identity Manager 配備ツール」に記載されている「Identity Manager 統合開発環境 の概要」- Identity Manager 統合開発環境 (IDE) と、ツールの起動、エディタオプションの設定、フォームの保存とデバッグの方法について説明します。
フォームについてIdentity Manager の Web ベースのユーザーインタフェースの外観と機能をカスタマイズするには、編集する Web ページに関連するフォームを修正します。
「フォーム」という用語は、ユーザーが情報を入力する Web ページと、ビューへのデータの表示方法に関する規則を含むオブジェクトの両方を意味します。このガイドでは、「フォーム」という用語を、主に、ビューへのデータの表示方法に関する規則を含むオブジェクトという意味で使用します。
この節で説明する内容は次のとおりです。
フォームとは
フォームは、ページに関連付けられたオブジェクトであり、そのページでユーザービュー属性をブラウザ上にどのように表示するかについての規則が含まれています。フォームにはビジネスロジックを組み込むことができ、通常はユーザーに表示する前に、表示データを処理するためにフォームが使用されます。
たとえば、新しいユーザーアカウントを作成するときは、新規ユーザーに関する情報を入力するための「ユーザーの作成」ページを使用します。このページは、Tabbed User Form という Identity Manager リポジトリに含まれるオブジェクト (フォーム) から生成されます。このフォームは、「ユーザーの作成」ページにどのフィールドを表示するか、および各フィールドの表示にどの HTML フォームエレメント (たとえば、テキストボックス、チェックボックス、選択ボックスなど) を使用するかを指定します。また、このフォームは、フィールドの無効化、空のフィールドへのデフォルト値の挿入、別フィールドの値からのフィールド値の計算を行う追加ロジックも指定します。
フォームが制御する内容
フォームによって制御されるオブジェクトやアクティビティーは次のとおりです。
フォームは、Web ページ用のインタフェースにもなりますが、ActiveSync リソースのように対話的でないシステムのインタフェースとなることもできます。この場合、フォームは表示フィールドを持ちませんが、デフォルト値やその他のフィールド値を設定する規則を提供できます。
たとえば、「フルネーム」フィールドは、ページを使用する管理者には表示されないかもしれませんが、ユーザーが「名」、「ミドルネーム」、「姓」の各フィールドに入力した値に基づいて設定させることができます。別のフィールドからフィールドに値を取り込むことで、ユーザーや管理者が行うデータ入力が減り、そのためデータ入力エラーが生じる可能性も低くなります。同様に、テキスト入力フィールドにオプションメニューを用意することで、管理者は部署名を入力する代わりに、リストから選択することができます。デフォルトの Identity Manager フォームを定義する各種 HTML コンポーネントについては、「HTML 表示コンポーネント」を参照してください。
Identity Manager では、バックグラウンド処理にもフォームが使用されます。たとえば、フォームとリソースアダプタを一緒に使用して、外部リソースから得た情報を処理し、Identity Manager リポジトリにこれを保存できます。
ユーザーに表示されないフォームでは、外観は意味を持たないため、バックグラウンドでデータを操作するフォームを作成するときは、主にエンコーディングのロジックに注意します。非表示のコンポーネントの詳細については、「非表示コンポーネントの使用」の節を参照してください。
フォームの例
次の XML コード例は、ユーザーがアカウント ID、姓、名、およびフルネームを入力するときに使用するフォームフィールドを定義しています。この例は、「姓」フィールドと「名」フィールドに入力された情報から、ユーザーのフルネームがどのように構築されるのかを示しています。
<Field name='waveset.accountId'/>
<Display class='text'>
<Property name='title' value='AccountID'/>
</Display>
</Field>
<Field name='global.firstname'>
<Display class='Text'>
<Property name='title' value='First Name'/>
<Property name='size' value='32'/>
<Property name='maxLength' value='128'/>
</Display>
</Field>
<Field name='global.lastname'>
<Display class='Text'>
<Property name='title' value='Last Name'/>
<Property name='noNewRow' value='true'/>
<Property name='size' value='32'/>
<Property name='maxLength' value='128'/>
</Display>
</Field>
<Field name='global.fullname'>
<Display class='Text'>
<Property name='title' value='FullName'/>
<Property name='size' value='32'/>
<Property name='maxLength' value='32'/>
</Display>
<Expansion>
<concat>
<ref>global.firstname</ref>
<s> </s>
<ref>global.lastname</ref>
</concat>
</Expansion>
</Field>
フォームの編集が必要な理由
デフォルトの Identity Manager ページには、製品でのアクションの実行に必要なすべてのフィールドがすでに用意されていますが、なぜこれをカスタマイズするのでしょうか。これは、デフォルトのフォームをカスタマイズすることで、企業のポリシーとプロセスをより確実に適用できるからです。
Identity Manager フォームのデフォルトフィールドをカスタマイズすることで、実際の環境に合わせてアプリケーションを拡張し、カスタマイズすることができます。具体的には、デフォルトフォームを次のようにカスタマイズできます。
- 組織内のユーザーの固有のニーズに対応します。これは、複数の異なる種類の管理者が、同じビューデータの異なる部分にアクセスする必要があり、記録されているすべてのデータ属性を表示できない場合に特に重要です。たとえば、人事担当の管理者は、ヘルプデスクの管理者とは異なるサブセットのユーザーアカウント属性にアクセスする必要があります。
- ユーザーアカウント属性の表示と内容 (特に、「ユーザーの作成」ページと「ユーザーの編集」ページに表示される属性) を制御します。これらのページには、制御が必要なほとんどの属性が含まれます。
- ユーザービュー属性のデフォルト値 (および、関連するその他の属性) を定義します。たとえば、管理者がホームディレクトリのパスを入力する代わりに、ユーザーのデフォルトのホームディレクトリを定義できます。
- 画面に表示する前にユーザービュー属性を処理できます。たとえば、頭字語や数値 ID としてリソースに記録されている部署コードを、ユーザーにわかりやすいフルネーム表記で表示することができます。
- 入力後にユーザービュー属性データを処理できます。たとえば、場所のフィールドの値に基づいて、メールアカウントを自動的に作成できます。
- 複数のフィールドを 1 つの行に配置することで、画面の構成を制御できます。Identity Manager フォームのフィールドの配置をカスタマイズすることで、印刷時の形式や、以前からの Web フォームにより近づけることができます。
- 非表示の属性を計算するための規則を定義します。たとえば、ユーザーの名前、ピリオド、ユーザーの姓、次にメールドメイン (joe.user@sun.com) となるように、ユーザーの電子メールアドレスを計算できます。
シナリオの例
さまざまなニーズや目的を持つ人々が同じデータにアクセスする環境では、フォームは特に便利です。
たとえば、企業で採用を担当するマネージャー用のフォームを作成し、新規従業員アカウントの作成に使用できます。デフォルトの Tabbed User Form には、採用責任者に必要な情報より多くの情報が表示されます。99 すべてのフィールドが表示される、冗長で込み入ったフォームでは、ユーザータスクが複雑になる可能性があります。その代わりに、採用責任者に必要な 10 の属性フィールドだけを表示し、それ以外の 89 の属性は、管理者が定義した規則に従って設定されるようなフォームを作成できます。
フォームが使用される Identity Manager ページ
通常は、Identity Manager フォームは次のいずれかのカテゴリに分類されます。
Identity Manager に付属するデフォルトのフォームは、独自のカスタムフォームを作成するためのたたき台として使用できます。これらのフォームのサブセットのみをコピーし、直接編集する必要がある場合は (「編集されたフォーム」の節を参照)、たとえば、特定の属性や動作をエンコードする方法について、別のフォームを参考にできます。
次の表は、最初のタイプのフォームを使用する Identity Manager ページの一部を示しています。編集するページの表示特性を制御するフォームを特定するときは、この表を使用してください。
編集されたフォーム
Identity Manager に付属するデフォルトフォームの中で、次の 5 つのフォームのいずれかの編集が必要となることが考えられます。
これらの編集されたフォームは、ユーザーの作成と修正を制御し、ユーザーに表示されるメインメニューの表示を制御します。各フォームについては、次の節でさらに詳しく説明します。
エンドユーザーメニューフォーム
エンドユーザーメニューフォームは、Identity Manager のユーザーインタフェースのメインメニューの表示を制御します。通常、このフォームには、ユーザーパスワードの変更、アカウント属性の編集、秘密質問の回答の変更などを行うためのリンクが含まれます。
エンドユーザーメニューフォームをカスタマイズして、ユーザーがアクセスできる特別なワークフロープロセス (たとえば、システムへのアクセスを要求するプロセス) を呼び出すリンクを追加できます。
たとえば、エンドユーザーページでクリックするリンクとしてエンドユーザーテストプロセスを表示するときは、次のコード例のようなエントリを追加します。
コード例 3-1 エンドユーザーメニューフォームへのエンドユーザーテストプロセスリンクの追加
Identity Manager のユーザーインタフェースには、選択可能なセルフサービスプロセスリストが表示されます。これは、リストのサブリストとなります。サブリストの最初の要素はプロセス名を示し、2 番目の要素はプロセスの機能を示します。
注
ページの表示を更新するたびに、Identity Manager はフォームの <Default> 式を再評価します。エンドユーザーメニューフォームに doNotRegenerateEndUserMenu プロパティー (true に設定) を追加することで、このフォームの再生成を無効にできます。
ページの表示を更新するたびに、Identity Manager はフォームの <Default> 式を再評価します。エンドユーザーメニューフォームに doNotRegenerateEndUserMenu プロパティー (true に設定) を次のように追加することで、このフォームの再生成を無効にできます。
<Properties>
<Property name='doNotRegenerateEndUserMenu'>
<Boolean>true</Boolean>
</Property>
</Properties>
Anonymous User Menu Form
Anonymous User Menu Form は、未知のユーザーがログインしたときに、Identity Manager のユーザーインタフェースのメインメニューの表示を制御します。
ユーザーセルフプロビジョニングのプロセス経由でシステムに定義されていないユーザーに対しては、Identity Manager は匿名エンドユーザーページを使用します。たとえば、Identity Manager 管理者は、Active Directory リソースのパススルー認証を設定することができます。それにより、Active Directory アカウントを持つ人であれば、Identity Manager のユーザーインタフェースにログインできるようになります。ユーザーが Identity Manager アカウントログインを持たない場合に、Identity Manager のユーザーオブジェクトが作成され、Active Directory リソースが追加されるように、これらのページをカスタマイズできます。それに続いて一連の質問を設けることで、システムはユーザーのロール、組織、およびその他のリソースを設定できます。
Identity Manager ユーザーが作成される前に、サービスを要求するワークフロープロセスを呼び出すよう Anonymous User Menu Form をカスタマイズすることができます。
Tabbed User Form
Tabbed User Form は、Identity Manager の管理者インタフェースでユーザーを作成、修正するときに使用されるデフォルトフォームです。独自にデザインしたフォームとして、このフォームの拡張版を作成するためには、このフォームのコピーをカスタマイズします。
ヒント
Tabbed User Form を直接編集しないでください。代わりに、これらのフォームのコピーを作成して一意の名前を付け、このファイル名を変更したコピーフォームを編集することをお勧めします。こうすることにより、カスタマイズしたコピーがサービスパックの更新やアップグレードの際に上書きされるのを防止できます。
Tabbed User Form のコピーは、次の処理を行うようにカスタマイズできます。
- 「ユーザーの編集」ページに表示される属性の数を制限します。デフォルトでは、このページにリソースのスキーママップに定義されているすべての属性が表示されるため、採用責任者に入力や設定が求められる属性のリストが多くなり過ぎてしまいます。
- デフォルトのフィールドタイプを、より便利な選択ボックス、チェックボックス、および複数の値を示すフィールドに設定します。デフォルトでは、ユーザーに割り当てられるリソースに定義されるすべての属性は、「ユーザーの作成」ページと「ユーザーの編集」ページにテキストボックスとして (または、Boolean 型の場合はチェックボックスとして) 表示されます。
- 複数のページで共通のフォームを使用できるように、追加のフォームを含めます。
Tabbed User Form には、次のフィールドが含まれます。
デフォルトでは、ユーザーに割り当てられるリソースに定義されるすべての属性は、「ユーザーの作成」ページと「ユーザーの編集」ページにテキストボックスとして (または、ブール型の値ではチェックボックスとして) 表示されます。
エンドユーザーフォーム
エンドユーザーフォームは、ユーザーが Identity Manager のユーザーインタフェースで /user/main.jsp から アカウント属性 を選択した場合に、システムによって自動的に表示されるページを制御します。ユーザーはこのページで、自分自身のパスワード、秘密の質問、および電子メールアドレスを変更できます。
エンドユーザーフォームをカスタマイズして、電話番号、住所、事務所の地理的な場所などを扱うフィールドをユーザーが制御できるように権限を与えることができます。たとえば、ユーザーが、Identity Manager ページを通じて追加の NT グループへのアクセスを要求するためにフィールドを追加できます。
承認フォーム
承認フォームは、ユーザー要求の承認者を指定するときに、リソース、ロール、または組織の所有者に表示される情報を制御します。デフォルトでは、このページには、プロセスを開始した管理者の名前を示す、一連の読み取り専用フィールドが表示されます。また、アカウント ID、ロール、組織、電子メールアドレスなど、ユーザーに関する情報も表示されます。
このフォームは、ユーザーの作成前に、ユーザーの値を変更する最後の機会をリソースの所有者に提供できるようにします。デフォルトでは、ユーザーを承認すると、読み取り専用フィールドにすべてのユーザー属性が表示されます。
承認フォームは、次の処理を行うようにカスタマイズできます。
フォームが機能するしくみ
ブラウザによるフォームの表示には、さまざまな要因が影響します。ただし、ブラウザでのフォームの動作は、主に次の要素によって決定されます。
- フォームに関連付けられているビュー。すべてのフォームは、ビューとともに使用されます。フォームとともに使用されるもっとも一般的なビューは、ユーザービューです。ビューは、フォームが評価されるときに使用できるデータを定義します。
- 未定義の属性。Tabbed User Form は、フィールドが明示的に定義されていないリソースアカウント属性を編集するためのテキストフィールドを自動的に生成するメカニズムを提供します。この機能は、フォームで無効にすることができます。
- フォームとその他の Identity Manager コンポーネントとの連携。これには、Identity Manager がフォームまたは フォーム評価 を評価するためのプロセスが含まれます。フォームによって駆動されるすべてのページは、同様に処理されます。Identity Manager がフォームを評価する方法については、この章の「フォームの評価」を参照してください。
- フォームで使用される表示コンポーネント。フォームフィールドには、ブラウザにフィールドをどのように表示するかを決定する、表示コンポーネントを関連付けることができます。
ユーザービューとフォーム
ユーザービューは、Identity Manager ユーザーの利用可能な全情報が含まれるデータ構造です。このビューには、次の項目が含まれます。
ビューには多くの属性があり、ビュー属性はビュー内にある名前を付けられた値 (たとえば、waveset.accountId は、Identity Manager のアカウント名が値となるユーザービュー中の属性)です。
ほとんどのフォームフィールドの名前は、ビュー属性と関連付けられています。フォームフィールドの名前として、ビュー属性の名前を指定することで、フィールドとビュー属性を関連付けます。詳細については、「フィールド名の定義」を参照してください。
ユーザービューの全属性の参照情報など、ユーザービューの詳細については、「Identity Manager のビュー」を参照してください。
未定義の属性
管理者インタフェースでユーザーにリソースやロールを割り当てると、表示が更新されます。新しいリソースアカウントの属性は、ユーザービューで定義されます。Tabbed User Form の <FormRef name = 'Missing Fields'/> は、対応するフィールドがフォームに明示的に定義されていないリソースアカウント属性について、テキストフィールドを生成するようにフォーム生成ツールに伝えます。この機能を無効にするときは、Tabbed User Form から <FormRef name = 'Missing Fields'/> を削除します。
フォームの評価
システムがフォームをどのように処理するかを理解することは、ブラウザでのフォームの動作を決定するときに役立ちます。フォームによって駆動されるすべてのページは、次のように同様に処理されます。
- ページは、Identity Manager のユーザーインタフェースまたは管理者インタフェースから要求されます。
- インタフェースは、サーバーからビューを要求します。ビューは、編集が可能な、名前が付けられた値の集合です。それぞれのビューは、ビューの値をユーザーにどのように表示するかを定義するフォームと関連付けられます。
- サーバーは、リポジトリ内の 1 つまたは複数のオブジェクトからデータを読み込むことで、ビューを構築します。ユーザービューの場合は、リソースアダプタを通じてリソースからアカウント属性も取得されます。
- Derivation 式が評価されます。これらの式は、リソースからの暗号化され、エンコードされた値を、ユーザーにとって意味のある値に変換するときに使用されます。この Derivation 式は、フォームが最初に読み込まれるとき、あるいは、1 つまたは複数のリソースからデータがフェッチされるときに評価されます。
- Default 式が評価されます。フィールドが NULL の場合は、フィールドにデフォルト値が設定されます。
- HTML コードが生成されます。システムはビューデータとフォームを処理し、HTML ページを生成します。この処理では、式に含まれる allowedValues プロパティーが評価され、Select または MultiSelect HTML コンポーネントが構築されます。
- ブラウザにページが表示されます。ユーザーは、表示される値を編集できます。編集時にユーザーがフィールドを修正すると、多くの場合は、それによってページの表示が更新されたり、再計算されたりします。これにより、ページが再生成されます。ただしこの時点では、システムは編集後のデータをリポジトリにまだ格納しません。
- 変更した値が、ビューに同化されます。表示更新イベントが発生した場合は、インタフェースはブラウザで編集されたすべてのフォームフィールドの値を受信します。
- Expansion 式が評価されます。これにより、追加の値がビューに配置される場合があります。Expansion 規則は、ページを再計算するとき、またはフォームを保存するときに実行されます。
- ビューの表示が更新されます。インタフェースは、ビューの表示を更新し、編集された値の現在の設定を提供するようにサーバーに要求します。サーバーは、リポジトリまたはリソースからデータを読み込んで、より多くの値をビューに挿入する場合があります。
- Derivation 式が評価されます。通常は、ビューの表示を更新するときには、Derivation 式は評価されません。一部の複雑な事例では、表示の更新後にシステムが導出を要求する場合があります。
- システムは、表示が更新されたビューとフォームを処理し、ブラウザに返される別の HTML ページを構築します。ユーザーは、表示更新の結果を確認し、編集を継続します。ユーザーは、変更を保存またはキャンセルするまで、任意の回数だけビューの表示を更新できます (毎回、手順 7 〜 12 を繰り返す)。
- A. 編集をキャンセルすると、ビューに取り込まれたすべてのデータは破棄され、サーバーにそれが通知されます。これにより、サーバーは任意のリポジトリロックを解除し、別のページへのパスを制御できます。
- B. 編集を保存すると、インタフェースは変更された値を受信し、それをビューに同化させます (手順 8 を参照)。
- Validation 式が評価されます。フィールドの値が必要な仕様を満たしていない場合は、エラーが示され、フィールドの値を修正できます。変更を加えると、プロセスは手順 13 に戻ります。
- 最後にもう一度、Expansion 式が評価されます (手順 9 を参照)。
- サーバーがビューを保存すると、通常は、リポジトリ内の 1 つまたは複数のオブジェクトが修正されます。ユーザービューでは、リソースアカウントも更新される場合があります。
これらの手順の一部は、フォームのすべてのフィールドに対して繰り返す必要があります。これには、Derivation 式の評価、Default および Validation 式の評価、HTML の生成、および Expansion 式の評価が含まれます。すべてのフィールドに対する繰り返しでは、このフィールドの処理が必要であるかどうかを判断するために、Disable 式が評価されます。Disable 式の評価結果が true であれば、そのフィールド (および、入れ子になっているすべてのフィールド) は無視されます。これら特別な種類の式の詳細については、この章の「フィールド名の定義」を参照してください。
フォームのカスタマイズIdentity Manager 製品のデフォルトの動作を理解すると、カスタマイズが必要なページを特定できます。
- 編集可能なページと、それに対応するフォームについては、「編集されたフォーム」の節を参照してください。
- フォームを編集するときは、Identity Manager IDE を起動し、「リポジトリオブジェクトを開く」を選択します。表示されるポップアップダイアログから、編集するフォームを選択します。
ここで説明する内容は次のとおりです。
カスタマイズの概要
フォームをカスタマイズして、よりわかりやすくし、表示特性を変更したり、フィールドデータを処理するロジックを含めたりすることができます。
基本的な手順
Identity Manager システムでフォームをカスタマイズする基本的な手順は次のとおりです。
一般的なタスク
フォームを編集するときは、通常、次のタスクを実行します。
- フォームのフィールドを追加、削除します。一般的なタスクには、一部のデフォルトフィールドの削除と、環境に合わせてカスタマイズされたフィールドの追加が含まれます。
- フィールドをフォームにどのように表示するかを定義します。この操作には、Identity Manager に付属する HTML コンポーネントのライブラリを使用する必要があります。フィールドの表示特性の編集については、「フィールドの表示プロパティー」の節を参照してください。
- フィールドの値を定義する論理式を設定します。この操作では、XPRESS 言語を使用して論理式を作成する必要があります。XPRESS の使用については、「XPRESS 言語」を参照してください。
表 3-2 フォームの要素
プロパティー
説明
Title
フォームフィールドの横に表示されるテキストを指定します。
Class
要素が属す HTML 表示クラスを指定します。
Required
フォームの処理にその要素が必須であるかどうかを指定します。送信の時点では、このフィールドに NULL 以外の値が入力されている必要があります。必須に設定すると、フィールドの右に赤いアスタリスクが表示されます。フォームの下部にはメッセージテキストが表示され、フィールドの横の赤いアスタリスクが、送信時にフィールドへの値の入力が必須であることを示していることを通知します。
Action
これを設定すると、変更によって、すべての Select コントロールまたは MultiSelect コントロールの表示が更新されます。Identity Manager の管理者インタフェースでは、この設定によって、基本となるビューの表示が更新されます。ロールの選択は、この動作のよい例です。Tabbed User Form で新しいロールを選択すると、編集セッション中にそのロールを通じて割り当てられるリソースを反映して、ビューの表示が更新されます。ビューの表示が更新されると、新たに割り当てられたリソースのリソースアカウント属性を明示的に設定できるようになります。
No New Row
フォームのレイアウトに限定して使用されます。true に設定すると、そのフィールドが直前のフィールドの右に強制的に表示されます。たとえば、Name フィールドでは、この設定が便利です。ユーザーは、姓、名、およびミドルネームのイニシャルを上から下へではなく、右から左に入力できるようになります。
Hidden
そのフィールドをユーザーに表示しないことを指定します。このようなフィールドは、姓と名を連結してフルネームを構築する場合のように、通常は別のフィールドから計算される属性値の設定に使用されます。
Title
コントロール (テキストボックス) の文字の幅を指定します。
Class
コントロールバッファー (テキストボックス) の文字の幅を指定します。ユーザーが、size プロパティーに指定した値より長い文字列を入力した場合は、文字がスクロールされます。
Required
このフォームフィールドの名前を指定します。通常は、このフォームで使用されるビューのパス式が指定されます。
次の特性は、メインタブビューから設定します。
表 3-3 メインタブビューから設定する特性
フィールド
説明
Name
このフィールドの名前を入力します。多くの場合、フィールド名は、このフォームで使用されるビューのパス式です。テキストボックス、チェックボックス、選択フィールドなどの編集コンポーネントとして表示されるすべてのフィールドには、ビューのパスを示す名前が必要です。SectionHead や Javascript のように編集コンポーネントとして表示されないフィールドは、名前を必要としません。ただし、フィールド参照を通じて別のフォームから参照する必要がある場合は、編集コンポーネント以外のフィールドにも名前を付けることができます。
Title
そのフィールドのタイトルを指定します。このタイトルは、フォーム上のフィールドの横に表示されます。このフィールドの横にあるドロップダウンメニューから、この要素のデータ型を選択してください。このフィールドに表示されるテキストを編集するには、横に表示される「編集」ボタンをクリックします。
Sub Title
(省略可能) フォームタイトルの下に表示されるテキストを指定します。このフィールドの横にあるドロップダウンメニューから、この要素のデータ型を選択してください。このフィールドに表示されるテキストを編集するには、横に表示される「編集」ボタンをクリックします。
Help Catalog
フィールドにガイダンスヘルプを関連付けるヘルプキーを指定します。この値は、フォームによって指定される、関連するヘルプカタログに含まれるエントリの名前です。ヘルプキーを指定すると、フィールドの左にアイコンが表示されます。このアイコンにカーソルを合わせると、ヘルプカタログから参照されるテキストが表示されます。
Base Context
(標準のユーザーフォームでは、通常、使用されない) すべてのフィールドに完全パスを指定する必要をなくすためのベースコンテキストを指定します。ベースコンテキストは、基本となるマップを特定します。具体的には com.waveset.object.Genericobject で、通常は user または userview という名前が付けられます。Identity Manager の管理者インタフェースでは、編集コンテキストはユーザーであり、ベースコンテキストの参照は空白のまま残されます。承認のように、手動アクションによって呼び出されるフォームでは、フォームのコンテキストはワークフローコンテキストとなります。
Options
フィールドの、1 つまたは複数の表示オプションを選択します。
Required - フォームの処理にその要素が必須であるかどうかを指定します。送信の時点では、このフィールドに NULL 以外の値が入力されている必要があります。必須に設定すると、フィールドの右に赤いアスタリスクが表示されます。フォームの下部にはメッセージテキストが表示され、フィールドの横の赤いアスタリスクが、送信時にフィールドへの値の入力が必須であることを示していることを通知します。
Button - フォーム下部の 1 つの水平行にフィールドを表示します。このオプションを選択しない場合、フィールドはフォームの次の行に表示されます。ほとんどの場合、このオプションは Button 表示クラスを使用するフィールドに設定されます。
Action - これを設定すると、変更によって、すべての Select コントロールまたは MultiSelect コントロールの表示が更新されます。Identity Manager の管理者インタフェースでは、この設定によって、基本となるビューの表示が更新されます。ロールの選択は、この動作のよい例です。Tabbed User Form で新しいロールを選択すると、編集セッション中にそのロールを通じて割り当てられるリソースを反映して、ビューの表示が更新されます。ビューの表示が更新されると、新たに割り当てられたリソースのリソースアカウント属性を明示的に設定できるようになります。
Library - 宣言したときではなく、参照した場合にのみフィールドを表示することを指定します。このオプションは、フォームで評価されるフィールドの順序が、ユーザーに表示されるフィールドの順序と異なる場合に便利です。
Default
フィールドのデフォルト値を計算するための式を指定します。このフィールドの現在の値が NULL の場合は、フォームの表示前に Default 式が呼び出されます。
Derivation
表示前にフィールドの値を計算するための式を指定します。これは Default 式に似ていますが、現在のフィールド値が NULL 以外でも、この式は評価されます。Derivation 式は、フォームが最初に表示される前に評価され、その後、フォームの表示が更新されるたびに評価されます。
Validation
フォームに入力した値が有効であるかどうかを判断するためのロジックを指定します。Validation 式は、成功を示す場合は NULL を返し、失敗を示す場合は判読可能なエラーメッセージを含む文字列を返します。
Expansion
フォームの送信後にフィールドの値を計算するための式を指定します。多くの場合、Expansion 式は非表示のマークが付けられたフィールドで使用されます。非表示フィールドは、ユーザーが直接編集することができないため、値は Expansion 式を使用して計算できます。「フィールドの非表示」を参照してください。
Disable
true と評価された場合に、フィールドと、その入れ子フィールドを無効にする式を指定します。無効化されたフィールドは、フォームに表示されません。このオプションは、ユーザーが特定タイプのリソースを持っているかどうかを判断するときに使用されます。ユーザーがこのようなリソースを持っている場合は、フォームにはそのリソースに適したフィールドが表示されます。
Display Class
このフォームコンポーネントをブラウザに表示するときに使用される HTML コンポーネントクラスを指定します。デフォルトでは、EditForm 表示クラスが選択されます。フォームがエンドユーザーメニューのようなリンクフォームの場合は、Display Class オプションから LinkForm を選択します。
「HTML 表示コンポーネント」の HTML 表示クラスの表を参照してください。
size
コントロール (テキストボックス) の文字の幅を指定します。
maxLength
この要素の最大文字数を指定します。
ヒント
多くの場合、フィールド名はこのフォームで使用されるビューのパス式で、通常はリソースの特定の属性と関連付けられます。リソースとその属性のリストを表示するには、「リソースの表示」をクリックします。展開可能なリソースタイプのツリーを示す「リソースの表示」ダイアログが表示されます。リソースインスタンスと、その属性名のリストを表示するときは、リソースタイプの名前をクリックします。新しいフォームフィールドの名前として、リソースの属性名を使用するときは、リソースの属性名をクリックし、「OK」をクリックします。これにより、Name フィールドに属性名が挿入されます。
表 3-4 表示クラスのオプション
HTML コンポーネント
目的
Apple
ページにアプレット参照を挿入します。
BackLink
前のページに戻るリンクを表示します。
BorderedPanel
コンポーネントを、東西南北と中央の 5 つの領域に配置するコンテナ。
Button
ボタンを表示します。
ButtonRow
それぞれの間に隙間を設けて、コンポーネントを水平の行に配置するコンテナ。通常は、Button コンポーネントの行の表示に使用されます。
CheckBox
それぞれの間に隙間を設けて、コンポーネントを水平の行に配置します。通常は、Button コンポーネントの行の表示に使用されます (Container)。
DatePicker
ページにカレンダのアイコンを表示します。ユーザーは、このアイコンをクリックして日付を選択し、ページフィールドに値を適用できます。
EditForm
フォームのデフォルトコンテナ。1 つの列にコンポーネントのタイトルを表示し、もう 1 つの列にコンポーネントを表示します。各行の背景は、交互に灰色と白になります。
FileUpload
アップロードするファイルの名前を指定するための、Text コンポーネントの形式。
Hidden
表示されないデータを HTML ページに含めるときに使用されるコンポーネント。
Html
事前にフォーマットされている HTML をページに挿入します。
Javascript
JavaScript 関数を定義します。
Label
読み取り専用のテキストを表示します。
Link
ページにリンクを配置します。
LinkForm
縦の箇条書きリストに、タイトルなしでコンポーネントを配置します。通常は、Link コンポーネントのリストを含むページで使用されます。EditForm コンテナの代わりに使用されます (Container)。
MultiSelect
複数の選択項目を持つボックスを表示します。これは、1 つのボックスに含まれる定義済みの値セットを選択ボックスに移動できる、2 つの部分から構成されるオブジェクトです。
NameValueTable
ベージュ色の背景を持つ簡易テーブルに、名前と値のペアのリストを表示します。
Panel
コンポーネントを水平の行、または垂直の列に配置します (Container)。
Radio
1 つまたは複数のラジオボタンの水平リストを表示します。ユーザーが一度に選択できるラジオボタンは 1 つだけです。コンポーネントの値が NULL の場合、または許可される値のいずれとも一致しない場合は、ボタンは選択されません。
SectionHead
セクションの見出しを表示します。これは EditForm コンテナで認識され、タイトルとコンポーネントの列を太字で表示します。
Select
1 つの項目を選択できるリストボックスを表示します。
SimpleTable
列のタイトル行を持つ、簡単なグリッドにコンポーネントを配置します。
SubTitle
フォームタイトルの下に表示されるテキストを指定します。
Text
読み取り専用のテキストを表示します。
TextArea
ページにリンクを配置します。
Title
フォーム上部に表示されるテキストを指定します。
表 3-5 フォームの要素
フォーム要素
説明
Name
このフィールドの名前を入力します。多くの場合、フィールド名は、このフォームで使用されるビューのパス式です。テキストボックス、チェックボックス、選択フィールドなどの編集コンポーネントとして表示されるすべてのフィールドには、ビューのパスを示す名前が必要です。SectionHead や Javascript のように編集コンポーネントとして表示されないフィールドは、名前を必要としません。ただし、フィールド参照を通じて別のフォームから参照する必要がある場合は、編集コンポーネント以外のフィールドにも名前を付けることができます。
Title
そのフィールドのタイトルを指定します。このタイトルは、フォーム上のフィールドの横に表示されます。このフィールドの横にあるドロップダウンメニューから、この要素のデータ型を選択してください。このフィールドに表示されるテキストを編集するには、横に表示される「編集」ボタンをクリックします。
Help Key
フィールドにガイダンスヘルプを関連付けるヘルプキーを指定します。この値は、フォームによって指定される、関連するヘルプカタログに含まれるエントリの名前です。ヘルプキーを指定すると、フィールドの左にアイコンが表示されます。このアイコンにカーソルを合わせると、ヘルプカタログから参照されるテキストが表示されます。
Options
フィールドの、1 つまたは複数の表示オプションを選択します。
Required - このフィールドへの入力または選択が、フォームを処理する上で必須であるかどうかを指定します。
Button - フォーム下部の 1 つの水平行にフィールドを表示します。このオプションを選択しない場合、フィールドはフォームの次の行に表示されます。ほとんどの場合、このオプションは Button 表示クラスを使用するフィールドに設定されます。
Action - これを設定すると、変更によって、すべての Select コントロールまたは MultiSelect コントロールの表示が更新されます。Identity Manager の管理者インタフェースでは、この設定によって、基本となるビューの表示が更新されます。ロールの選択は、この動作のよい例です。Tabbed User Form で新しいロールを選択すると、編集セッション中にそのロールを通じて割り当てられるリソースを反映して、ビューの表示が更新されます。ビューの表示が更新されると、新たに割り当てられたリソースのリソースアカウント属性を明示的に設定できるようになります。
Library - 宣言したときではなく、参照した場合にのみフィールドを表示することを指定します。このオプションは、フォームで評価されるフィールドの順序が、ユーザーに表示されるフィールドの順序と異なる場合に便利です。
Default
フィールドのデフォルト値を計算するための式を指定します。このフィールドの現在の値が NULL の場合は、フォームの表示前に Default 式が呼び出されます。
Derivation
表示前にフィールドの値を計算するための式を指定します。これは Default 式に似ていますが、現在のフィールド値が NULL 以外でも、この式は評価されます。Derivation 式は、フォームが最初に表示される前に評価され、その後、フォームの表示が更新されるたびに評価されます。
Validation
フォームに入力した値が有効であるかどうかを判断するためのロジックを指定します。Validation 式は、成功を示す場合は NULL を返し、失敗を示す場合は判読可能なエラーメッセージを含む文字列を返します。Validation 規則は、フォームの送信時にのみ評価され、表示を更新したり、再計算したりした場合には評価されません。
Expansion
フォームの送信後にフィールドの値を計算するための式を指定します。多くの場合、Expansion 式は非表示のマークが付けられたフィールドで使用されます。非表示フィールドは、ユーザーが直接編集することができないため、値は Expansion 式を使用して計算できます。
Disable
true と評価された場合に、フィールドと、その入れ子フィールドを無効にする式を指定します。無効化されたフィールドは、フォームに表示されません。このオプションは、ユーザーが特定タイプのリソースを持っているかどうかを判断するときに使用されます。ユーザーがこのようなリソースを持っている場合は、フォームにはそのリソースに適したフィールドが表示されます。
Display Class
このフォームコンポーネントをブラウザに表示するときに使用される HTML コンポーネントクラスを指定します。デフォルトでは、EditForm 表示クラスが選択されます。フォームがエンドユーザーメニューのようなリンクフォームの場合は、Display Class オプションから LinkForm を選択します。
「HTML 表示コンポーネント」の HTML 表示クラスの表を参照してください。
value
プロパティーの属性を指定します。通常は文字列です。
maxLength
この要素の最大文字数を指定します。
表 3-6 フォームツールボックスのデフォルトサービス
サービス
説明
Text
通常のテキスト入力ボックスを表示します。
Secret Text
テキストをアスタリスク (*) として表示します。通常は、パスワードのように暗号化されるデータで使用されます。
Select
1 つの項目を選択できるリストボックスを表示します。このリストボックスの値は、allowedValues プロパティーで指定します。
MultiSelect
複数の選択項目を持つテキストボックスを表示します。これは、1 つのボックスに含まれる定義済みの値セットを選択ボックスに移動できる、2 つの部分から構成されるオブジェクトです。左のボックスの値は allowedValues プロパティーで指定します。多くの場合、この値は FormUtil.getResources などの Java メソッドを呼び出すことで動的に取得されます。複数選択ボックスの右側部分に表示される値には、フィールド名によって特定される関連ビュー属性の現在値が適用されます。
Checkbox
チェックボックスを表示します。チェックマークが付けられると、そのボックスの値は true となります。選択されていないボックスの値は false となります。
Label
複数行のテキスト入力ボックスを表示します。
TextArea
1 つまたは複数のラジオボタンの水平リストを表示します。ユーザーが一度に選択できるラジオボタンは 1 つだけです。コンポーネントの値が NULL の場合、または許可される値のいずれとも一致しない場合は、ボタンは選択されません。
Radio
ページにリンクを配置します。
Link
ボタンを表示します。
Button
このフォームで使用されるビューによって定義される変数を参照します。
accountId
複数行のテキスト入力ボックスを表示します。
カスタマイズに関連するその他のトピック
ここでは、次のトピックについて説明します。
フォームの構造
フォームは、XML オブジェクトとして Identity Manager リポジトリに格納されます。各フォームは、次の構造を持つ独自のオブジェクトとして格納されます。
注
フォームの XML 構造を理解している必要はありません。Identity Manager IDE を使用することで、フォームの構造を簡単に操作できます。次に示す情報は、参照のみを目的としています。
次のスタブフォームは、フォームの一般的な構造を示しています。
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE Configuration PUBLIC 'waveset.dtd' 'waveset.dtd'>
<!-- id="#ID#UserForm:EndUserMenu" name="End User Menu"-->
<Configuration id='#ID#UserForm:EndUserMenu' name='End User Menu' createDate='1012185191296' lastModifier='Configurator' lastModDate='1013190499093' lastMod='44' counter='0' wstype='UserForm'>
<Extension>
<Form name='End User Menu'>
<Display class='LinkForm'>
<Property name='title' value='User Self Service'/>
<Property name='subtitle' value='Select one of the following options'/>
</Display>
… フィールドコンテンツ
</Form>
</Extension>
<MemberObjectGroups>
<ObjectRef type='ObjectGroup' id='#ID#Top' name='Top'/>
</MemberObjectGroups>
</Configuration>
注
Identity Manager のユーザーインタフェースページは、ナビゲーションバーを含む 2 番目の XPRESS フォームを実装しています。これは、描画されるページに 2 つの <FORM> タグがあり、各タグで name 属性の設定が次のように異なることを意味します。
<form name="endUserNavigation">
および
<form name="mainform">
フォームのコンポーネント
次の表は、フォームに表示される順序でフォームコンポーネントを示しています。各フォームコンポーネントの詳細については後述します。
表 3-7 フォームのコンポーネント
フォームコンポーネント
目的
ヘッダー
フォームのオブジェクト定義に関する情報を示します。<Form>、<Extension>、および <Configuration> 要素の開始タグが含まれ、フォームのプロパティー (フォームの呼び出し時に表示される title、subtitle、titleWidth など) を定義します。
フォーム本文
フィールド定義、フォーム関数、およびフォーム変数が含まれます。これは、フォームの中で編集する部分です。
フッター
<Form>、<Extension>、および <Configuration> 要素の終了タグが含まれます。
ヘッダー
フォームヘッダーに含まれる内容は次のとおりです。
ヘッダーには、作成日、ファイルを最後に修正したユーザーのログイン、フォームタイプなどの内部識別情報をはじめとする、フォームに関する情報が含まれます。この情報は、通常、ページプロセッサによって生成されます。
表 3-8 フォームヘッダーのコンポーネント
要素
定義
構文/例
<Extension>
<Form> 要素を囲むために使用されます。
<Element>…</Element>
<Configuration>
最後の修正日や、このフォームを最後に修正したユーザーのログインなど、フォームオブジェクトを処理するときにシステムが内部的に使用する情報が含まれます。これらの情報のほとんどは、通常、Identity Manager リポジトリに格納されているいずれかの持続オブジェクトと関連付けられています。多くの場合、この情報を編集する必要はありません。
Configuration id='#ID#UserForm:EndUserMenu' name='End User Menu' createDate='1012185191296' lastModifier='Configurator' lastModDate='1013190499093' lastMod='44' counter='0' wstype='UserForm'>
フォーム本文
フォーム本文は、次の内容から構成されます。
次の表は、フォームヘッダーのプロパティーを示しています。
表 3-9 フォームヘッダーのプロパティー
プロパティー
目的
title
フォーム上部に表示されるテキストを指定します。多くの場合、このタイトルは、画面のその他のフォントより大きな太字で表示されます。フォームの title は、Identity Manager ページの下に表示されます。タイトルの表示特性は編集できません。
「フォームのコンポーネント」の節で示した例では、title の値は User Self Service です。
subtitle
このフォームによって定義されるページのフォームタイトルの下に表示されるテキストを指定します。タイトルの表示特性は編集できません。
前述の例では、subtitle の値は Select one of the following options です。
titleWidth
ブラウザウィンドウのタイトルの幅を、ピクセル単位で指定します。
例
<Display>
<Property name='titleWidth'>
<Integer>120</Integer>
</Property>
</Display>
次の表は、フォーム本文で使用されるすべての要素を示しています。
表 3-10 フォーム本文で使用される要素
コンポーネント
定義
例
defun
XPRESS 関数を定義します。この要素は、フォーム内のどのフィールド要素からも呼び出すことができます。
<defun name='add100'>
<def arg name='x'/>
<add><i>x</i><i>100</i>
</add>
</defun>
defvar
計算結果を保持するための、XPRESS 変数を定義します。
<defvar name='nameLength'
<length>
<ref>fullname</ref>
</length>
</defvar>
Display
フィールドの外観を定義する表示コンポーネントを指定します。詳細については、「Display 要素」の節を参照してください。
<Display class='LinkForm'>
<Property name='title' value='User Self Service'/>
<Property name='subtitle' value='Select one of the following options'/>
</Display>
Field
フォーム本文で使用される主要要素。詳細については、「Field 要素」の節を参照してください。
<Field name='fullname'/>
FieldRef
含まれるフォームに定義されているフィールドへの参照を設定します。
<FieldRef name='fieldName'/>
Include
別のフォームオブジェクトへの参照を設定します。現在のフォームにこのコンポーネントを含めると、そのフォームに定義されるフィールドを参照し、表示できるようになります。
<Include>
<ObjectRef type='UserForm' id='#ID#UserForm:UserFormLibrary'/>
</Include>
FormRef
別のフォームオブジェクトへの参照を設定します。
<FormRef name='formName'/>
Namespace
ビューへのショートカットを定義するときに使用されます。フィールド名と参照に、長い名前の代わりに短縮名を使用できます。代替名を使用するときは、名前の後にコロン (:) を続けます。
<Namespace name='w' value='waveset'/>
Form 要素
<Form> 要素は、すべての Field 要素を囲み、フォームの一意の名前を含みます。前のページに示される要素は、Form の開始タグと終了タグの間に記述されます。
<Form name='Create User Form'
<Field name='waveset.accountId'>
additional fields
</Form>
別の例:
<Form name='Task Launch Form'>
<Display class='EditForm'>
<Property name='title' value='Task Launch'/>
<Property name='subTitle' value='Enter task launch parameters'/>
</Display>
...
</Form>
Display 要素
Form 要素内の Display 要素は、フォームの表示に使用されるコンポーネントを表現します。デフォルトでは、この Display 要素は EditForm コンポーネントで使用されます。Form コンポーネントクラスの変更が必要となることはあまりありませんが、コンポーネントのプロパティーは設定可能です。もっとも多く指定される 2 つのプロパティーは title と subTitle です。
EditForm は、隣接するフィールドのタイトルの幅を設定する adjacentTitleWidth プロパティーもサポートします。このプロパティーが定義されていない場合は、デフォルト値のゼロが適用されます。
adjacentTitleWidth の値をゼロに設定すると、列のタイトルの大きさは自動的に変更されます。ゼロ以外の値を設定した場合は、隣接する列 (たとえば、2 番目と 3 番目の列) のタイトルの幅は adjacentTitleWidth の値に設定されます。
<Form name='Default User Form' help='account/modify-help.xml'>
<Display class='EditForm'>
<Property name='titleWidth' value='120'>
<Property name='adjacentTitleWidth' value='60'>
</Display>
Field 要素
Field 要素は、フォーム本文で使用される主要要素です。フィールドは、ユーザーの各属性の定義に使用されます。Field 要素を使用して、フォームフィールドに XPRESS ロジックを含めることができます。フォームの Field 要素の操作の詳細については、「フィールドの定義」の節を参照してください。
次の例は、Email Address というラベルを持つ編集フィールドを作成します。
<Field name='waveset.email'>
<Display class='Text'>
<Property title='Email Address'/>
<Property size='60'/>
<Property maxLength='128'/>
</Display>
...
</Field>
編集フィールドの名前は、多くの場合、フォームで使用されるビュー内のパス式です。この例で waveset.email は、Identity Manager リポジトリ内のユーザーオブジェクトに関連付けられている電子メールアドレスを参照します。
フッター
フッターには、フォームが関連付けられている Identity Manager オブジェクトグループまたは組織に関する情報が含まれます。また、</Form>、</Extension>、および</Configuration> 要素の終了タグ、またはヘッダー内で開始したその他の要素の終了タグも含まれます。前述の例には、次のようなフッターが含まれます。
</Form>
</Extension>
<MemberObjectGroups>
<ObjectRef type='ObjectGroup' id='#ID#Top' name='Top'/>
</MemberObjectGroups>
</Configuration>
<MemberObjectGroups> は、システムがオブジェクトを格納するオブジェクトグループまたは組織を特定します。オブジェクトグループを指定しない場合は、システムはデフォルトの組織である Top にオブジェクトを割り当てます。多くの場合、フォームを含む Configuration オブジェクトは、次の構文で All グループに含まれます。
<MemberObjectGroups>
<ObjectRef type='ObjectGroup' name='All'/>
</MemberObjectGroups>
フォームフィールドとは
フォーム本文には、Web ページの各要素の外観と動作を定義する Field 要素が含まれます。各 Field 要素には、それぞれが独自の表示コンポーネントを持つその他のフィールドを含めることができます。
フォームフィールドは、<Field> タグのセットに囲まれた、いくつかの部分から構成されます。
- 値の式: フィールドには、フィールドの値を計算したり、許可される値のセットを定義したりする XPRESS 式を数多く含めることができます。たとえば、フィールドのデフォルト値を定義するときは <Default> を使用し、フォームを最初に読み込んだときに計算されるフィールド値を定義するときは <Derivation> を使用します。すべてのフィールド要素が式を含むわけではありません。「フィールド名の定義」の節を参照してください。
- HTML 表示コンポーネント: 表示コンポーネントは、可視要素をどのように表示するかを決定します。Identity Manager のフォームフィールドでは、フォームフィールドの動作と外観の設定に表示コンポーネントが使用されます (フォームには <Display> 要素で定義)。それぞれのフィールドに設定できる表示コンポーネントは 1 つだけです。これらの表示コンポーネントの詳細については、第 8 章「HTML 表示コンポーネント」を参照してください。
- Disable 式: Disable 式を使用することで、条件に応じて、フィールドをフォームに含めることができます。Disable 式が true と評価される場合は、フィールドは無視されます。
変数の作成
定数または静的データの長いリストを含む変数を作成するときは、次の構文を使用します。この構文は、静的なリストを 1 回作成し、それぞれの参照で再利用します。
<defvar name='states'>
<List>
<String>Alabama</String>
...
</List>
</defvar>
参照のたびに新しいリストを作成するときは、<list><s>Alabama</s>...</list> という構文を使用します。
フィールドの定義
ここでは、フォームをカスタマイズするときに実行する手順について説明します。次の手順が含まれます。
次に、設定するフィールド特性について、より詳しく説明します。
フィールド名の定義
リソースに定義されている属性と、Web ページに表示されるテキスト入力フィールドを一致させるには、フィールド名を使用します。リソースを定義すると、システムはリソースのアカウント属性と Identity Manager の属性をマップするスキーママップを設定します。たとえば、Active Directory リソースには、firstname、lastname、Office Phone などの属性が含まれる可能性があります。フォームでこれらの属性を参照するときは、Identity Manager スキーマに記録されている属性名と、ビューから属性へのパスがわかっていなければなりません。
Field 要素の name 属性を定義するには、2 つの方法があります。
Field 名がビューのパス式を表すか、単なる参照名を表すかは、Display 要素で選択した class 属性の値によって決まります。編集するコンポーネントクラスの名前が Display クラスである場合は、その名前はビューのパス式であると考えられます。コンポーネントクラスの詳細については、「HTML 表示コンポーネント」の節を参照してください。
ビュー属性へのパス式の作成
Field 名を定義するときは、通常、ユーザービュー内の属性へのパス (パス式) を指定します。これらの属性のリストについては、「Identity Manager のビュー」を参照してください。
次のフィールド定義は、Identity Manager の電子メールアドレスを編集できるようにテキストフィールドを表示します。
<Field name='waveset.email'>
<Display class='Text'>
<Property name='size' value='60'/>
</Display>
</Field>
waveset.email という文字列は、Identity Manager のリポジトリに格納される電子メールアドレスをターゲットとした、ユーザービューのパス式です。
例:
このフィールド例は、特定のリソースアカウント用に定義されている電子メールアドレスを編集します。フィールド名は、アカウント内のリソースを参照します。
<Field name='accounts[Microsoft Exchange].email'>
<Display class='Text'>
<Property name='size' value='60'/>
</Display>
</Field>
accounts[Microsoft Exchange].email という文字列は、指定されたリソースのアカウント属性に関する情報を保持するユーザービュー内の別の場所へのパス式です。この例では、リソースの名前は Microsoft Exchange です。
例:
このフィールド例は、スキーママップの左側部分に email という属性を持つ、Identity Manager を含むすべてのリソースの電子メールアドレスを定義します。
<Field name='global.email'>
<Display class='Text'>
<Property name='size' value='60'/>
</Display>
</Field>
参照するフィールドの指定
フィールドに名前を付けることで、別のフィールドからそのフィールドの値を参照できます。別のフィールドからフィールド値を参照するときは、<ref></ref> のタグセットを使用します。次の例は、firstname フィールドと lastname フィールドの値を取得し、lastname, firstname のように、フィールドの文字列、カンマ、および空白文字を連結して、fullname フィールドの値を導出します。文字列の指定には、<s> タグを使用します。
<Field name='global.firstname'>
<Display class='Text'/>
</Field>
<Field name='global.lastname'>
<Display class='Text'/>
</Field>
<Field name='global.fullname'>
<Expansion>
<concat>
<ref>global.lastname</ref><s>, </s> <ref>global.firstname</ref>
</concat>
</Expansion>
</Field>
すべての Field 名がビューのパス式を表すわけではありません。一部のフィールドは、別のフィールドのコンテナを表すように定義され、ビューのその他の属性に対応しません。このような場合は、FieldRef 要素によって参照できるように、Field 名を使用してフィールドを特定します。フィールドを参照する必要がない場合は、名前を指定する必要はありません。
たとえば、フォームボタンはアクションを実行しますが、値を持たず、別のフォームから参照する必要がありません。このため、フィールド名の指定も必要ありません。
<Field>
<Display class='Button'>
<Property name='label' value='Recalculate'/>
<Property name='command' value='Recalculate'/>
</Display>
</Field>
ユーザービューの詳細については、「ユーザービューとフォーム」の節を参照してください。
フィールドの表示プロパティー
Display 要素は、すべての可視フォームフィールドに共通です。Display 要素には、ブラウザに表示されるフィールドの特性を定義する Property 要素が含まれます。フィールドに true と評価される Disable 要素が含まれる場合を除き、フォームの Display 要素を定義すると、その要素を画面に表示できます。フィールドを再計算するフォームが画面に表示されないように設定できる場合に、別のフィールドまたは値が設定されるまでフォームを表示する、という条件を指定することができます。「フィールドの無効化」の節を参照してください。
Display
可視フィールドのクラスとプロパティーを表現します。この要素は、インスタンス化するコンポーネントクラスと、そのインスタンスに割り当てるプロパティー値のセットを指定します。
<Display class='Text'>
<Property name='size' value='20'/>
<Property name='maxLength' value='100'/>
</Display>
Display 要素の class 属性は、Component クラスの名前である必要があります。デフォルトでは、これらのクラスは Applet、Button、DatePicker などを含み、com.waveset.ui.util.html パッケージに格納されています。デフォルトのすべてのクラスとその説明については、「HTML 表示コンポーネント」の「基本コンポーネントクラス」の節を参照してください。このパッケージに含まれないクラスを参照するときは、class 属性の完全修飾クラス名を指定します。このマニュアルで説明するすべてのクラスはデフォルトパッケージに含まれるので、修飾名を指定する必要はありません。
Property
Display 要素内に指定されます。Property の値は、コンポーネントに割り当てられるプロパティーの名前と、その値を定義します。プロパティー名は、常に name 属性で指定されます。
Display 要素の Property 値の指定
Display 要素の Property の値は、次の方法で指定できます。
ほとんどのプロパティーの値は、value 属性を使用して、値に適切なタイプを割り当てるようにシステムに強制することで設定できます。
value 属性の使用
プロパティーの値を設定するもっとも一般的な方法は、value 属性の使用です。value 属性の値は文字列として認識されますが、システムは必要に応じてコンポーネントに適したデータ型を強制します。前述の例では、size には整数値 20 が設定され、maxLength には整数値 100 が設定されています。
次の例では、SimpleTable を使用して、いくつかのサブフィールドを構成するフィールドを作成します。XML フォームでもっとも一般的に使用される Container コンポーネントは、SimpleTable と ButtonRow です。
<Field name='SelectionTable'>
<Display class='SimpleTable'>
<Property name='columns'>
<List>
<String>Account</String>
<String>Description</String>
</List>
</Property>
</Display>
<Field name='accounts[LDAP].selected'>
<Display class='Checkbox'>
<Property name='label' value='LDAP'/>
</Display>
</Field>
<Field>
<Display class='Label'>
<Property name='text' value='Primary Corporate LDAP Server'/>
</Display>
</Field>
<Field name='accounts[W2K].selected'>
<Display class='Checkbox'>
<Property name='label' value='Windows 2000'/>
</Display>
</Field>
<Field>
<Display class='Label'>
<Property name='text' value='Primary Windows 2000
Server'/>
</Display>
</Field>
</Field>
Display 要素には、ゼロ個以上の Property 要素が含まれます。これらの要素は、そのコンポーネントに割り当てられるプロパティーの名前と値を定義します。Property 要素の名前は、常に name 属性で指定されます。プロパティー値の設定には、多くの場合、value 属性が使用されます。value 属性の値は文字列として認識されますが、必要に応じて、コンポーネントに適したデータ型が強制されます。
XML オブジェクト言語の使用
XML オブジェクト言語を使用してプロパティー値を指定することもできます。これは、主にリストの値を指定するときに便利です。この言語の構文を使用することで、いくつかの標準 Java オブジェクトと、Identity Manager によって定義されるその他オブジェクトを表現できます。
もっとも一般的な Java XML オブジェクトは次のとおりです。
XML オブジェクト構文を使用してプロパティー値を指定するときは、要素が Property 要素内に配置されます。XML オブジェクト言語の詳細については、「XML オブジェクト言語」を参照してください。
<Property name='size'>
<Integer>10</Integer>
</Property>
<Property name='title'>
<String>New Password</String>
</Property>
<Property name='leftLabel'>
<Boolean>true</Boolean>
</Property>
<Property name='allowedValues'>
<List>
<String>Texas</String>
<String>Iowa</String>
<String>Berkshire</String>
</List>
</Property>
リストの値を認識するすべてのプロパティーは、List 要素を認識します。また、ほとんどの属性は、リストを指定するカンマ区切りのリスト構文を認識します。
値を計算する式の使用
Property の値を式で指定することもできます。これにより、固定のリテラル値と、ページプロセッサによって定義される変数の値を組み合わせるなどの方法で、実行時に値を計算することができます。次に例を示します。
<Property name='title'>
<concat>
<s>Welcome </s>
<ref>waveset.accountId</ref>
<s>, select one of the following options.</s>
</concat>
</Property>
この例では、waveset.accountId が変数を参照しています。システムがこのコンポーネントの HTML を生成するときに、ページプロセッサシステムが waveset.accountId 変数の値を供給します。参照できる変数の名前は、ページプロセッサによって定義されます。ほとんどの場合、これらの変数の定義には、XML フォームで使用される view が使用されます。フォームは、そのフォームを使用するビューと、そのビューによって定義される参照属性のみに注意するだけで設計できます。
Disable 要素
ブール型の値を計算します。計算結果が true となる場合は、現在のフォームの処理で、そのフィールドと、すべての入れ子フィールドが無視されます。
例
この例は、<Disable> 要素内の式を使用してフィールドの可視性を制御するフィールド定義を示しています。accountInfo.typeNames は、そのユーザーが割り当てられているすべてのリソースのタイプの検出に使用されます。これらのタイプは、ユーザーのすべてのリソースタイプのリストとして返されます (たとえば、Windows NT)。返されるタイプ名のリストに Solaris が含まれるときは、そのフィールドは画面に表示されます。含まれない場合は、そのフィールドは無効化されます。
<Field name='HomeDirectory' prompt='Home Directory'>
<Display class='Text'/>
<Disable>
<not>
<contains>
<ref>accountInfo.typeNames</ref>
<s>Solaris</s>
</contains>
</not>
</Disable>
</Field>
Default 要素
NULL 以外の値がフィールドに設定されていない場合にのみ、このフィールドの値として使用される値を計算します。Default は基本的には Derivation と同じですが、現在値が NULL 以外の場合にのみ値が適用されます。Default 式は、次の場合に計算されます。
例
この例は、文字列操作式を使用して、ユーザーの名の頭文字と姓から構成されるデフォルトのアカウント ID を返すフィールド定義を示しています。
<Field name='waveset.accountId'>
<Display class='Text'>
<Property name='title' value='AccountID'/>
</Display>
<Default>
<concat>
<substr>
<ref>accounts[Exchange].firstname</ref>
<i>0</i>
<i>1</i>
<ref>accounts[Exchange].lastname</ref>
</substr>
</concat>
</Default>
</Field>
Derivation 要素
フィールドの値を無条件で計算します。Derivation 式が評価されると、フィールドの現在値は常に置き換えられます。
Derivation 式は、フォームが最初に読み込まれるとき、あるいは、1 つまたは複数のリソースからデータが返されるときに計算されます。
次の例は、条件ロジックを使用して、値のセットを別のセットにマップするフィールド定義を示しています。このフィールドを処理すると、<Derivation> 要素内の式が評価され、リソースから返される場所のコードに基づいて、このフィールドに表示される説明的な値が決定されます。
<Field name='location'>
<Display class='Text'>
<Property name='title' value='Location'/>
</Display>
<Derivation>
<switch>
<ref>accounts[Oracle].locCode</ref>
<case>
<s>AUS</s>
<s>Austin</s>
</case>
<case>
<s>HOU</s>
<s>Houston</s>
</case>
<case>
<s>DAL</s>
<s>Dallas</s>
</case>
<case default='true'>
<s>unknown</s>
</case>
</switch>
</Derivation>
</Field>
Expansion 要素
フィールドの値を無条件で計算します。この要素は、式の評価のタイミングが Derivation 要素とは異なります。
Expansion ステートメントは、次の場合に計算されます。
次の例は、条件ロジックを使用して、前述の例の location フィールドから得られる値を、Oracle リソースに格納される 3 文字の略号に変換するフィールド定義を示しています。フィールド名の違いに注意してください。location フィールドの値は、どのリソースにも格納されません。これは、別のフィールドの計算に使用されます。
<Field name='accounts[Oracle].locCode'>
<Expansion>
<switch>
<ref>location</ref>
<case>
<s>Austin</s>
<s>AUS</s>
</case>
<case>
<s>Houston</s>
<s>HOU</s>
</case>
<case>
<s>Dallas</s>
<s>DAL</s>
</case>
</switch>
</Expansion>
</Field>
Validation 要素
フォームに入力された値が有効であるかどうかを検証します。Validation 規則は、フォームを送信するたびに評価されます。
この例では、ユーザーの郵便番号が 5 桁であるかどうかが Validation 規則によって確認されます。
<Validation>
<cond>
<and>
<eq><length><ref>global.zipcode</ref></length>
<i>5</i>
</eq>
<gt><ref>global.zipcode</ref><i>99999</i></gt>
</and>
<null/>
<s>zip codes must be five digits long</s>
</cond>
</Validation>
編集フィールドとコンテナフィールド
Field 要素に指定された Display 要素は、フィールドの表示に使用されるコンポーネントを表現します。これには、次の 2 種類のフィールドが使用されます。
編集フィールドは必ず名前を持ち、常に Text や Checkbox など、いずれかの編集コンポーネントとともに使用されます。
編集フィールドの例
<Field name='waveset.email'>
<Display class='Text'>
<Property title='Email Address'/>
<Property size='60'/>
<Property maxLength='128'/>
</Display>
...
</Field>
編集フィールドの名前は、多くの場合、フォームで使用されるビュー内のパス式です。前述の例で waveset.email は、Identity Manager リポジトリ内のユーザーオブジェクトに関連付けられている電子メールアドレスを参照します。
コンテナフィールドは名前を持たない場合があり、常に ButtonRow、SimpleTable、EditForm などのいずれかのコンテナコンポーネントとともに使用されます。
よく使用されるコンテナのタイプには、1 つの列にタイトル、別の列にコンポーネントを持つ HTML テーブルを作成する EditForm コンテナがあります。これらのタイトルは title プロパティーに定義され、そのフォームに関連付けられている Identity Manager ページに表示されます。
フィールドの無効化
フィールドを無効にすると、フィールドと、その入れ子フィールドはページに表示されなくなります。その値の式は評価されないか、またはどの global.* 属性にも組み込まれません。無効化されたフィールドの値がすでにビューに含まれる場合、その値は変更されません。
<Disable></Disable>
例
<Field name='waveset id'>
<Display class='Text'>
<Property title='accountId'>
</Display>
<Disable>
<eq><ref>userExists</ref><s>true</s></eq>
</Disable>
</Field>
注
Disable 式は、その他の式よりも頻繁に評価されます。このため、Disable 式は、比較的単純に記述してください。データベースのルックアップのように、負荷の大きい処理を実行する Java クラスは呼び出さないようにしてください。
Disable 式の規則でフィールドを参照するときは注意が必要です。誤って設定すると、コンテナ内のフィールドが無効化される場合があります。
フィールドの非表示
フィールドを非表示に設定すると、フィールドと、その入れ子フィールドはページに表示されなくなります。ただし、フォームの処理によって、フィールドの値は設定されます。
フィールドに Display クラスを割り当てないだけで、フィールドは簡単に非表示にできます。
<Field name='field A'/>
フィールド値の計算
フィールドの値は、別のフィールドの値や、任意の論理式の値から計算できます。たとえば、ユーザーの姓、ミドルネームのイニシャル、および名からフルネームを導出できます。
<Field name='global.fullname'>
<Expansion>
<concat>
<ref>global.firstname</ref>
<s> </s>
<ref>global.middle</ref>
<s> </s>
<ref>global.lastname</ref>
</concat>
</Expansion>
</Field>
デフォルト値の設定
ユーザーの名の頭文字と、姓の最初の 7 文字を使用して、電子メールアドレスを設定することができます。この例では、それらを連結する前に値が設定されていることを確認するため、システムが追加チェックを行います。この追加チェックの目的は次のとおりです。
- アカウントの最初の作成時にのみ、電子メールアドレスを設定できるようにする
- 姓、名の各フィールドに値が設定されていることを確認する
<Field name='global.email'>
<Default>
<and>
<notnull><ref>global.firstname</ref></notnull>
<notnull><ref>global.lastname</ref></notnull>
</and>
<concat>
<downcase>
<substr>
<ref>global.firstname</ref>
<i>0</i>
<i>1</i>
</substr>
</downcase>
<downcase>
<substr>
<ref>global.lastname</ref>
<i>0</i>
<i>6</i>
</substr>
</downcase>
<s>@waveset.com</s>
</concat>
</Default>
</Field>
フィールド値の導出
一部のフィールドは、別のフィールドを計算するときにだけ、フォーム上で使用されます。これらのフィールドは、ユーザーが属すどのリソースにも格納できません。ユーザーレコードを編集すると、それぞれのリソースが参照され、属性のフィールド値が取り込まれます。計算に使用されるフィールドの値を取り込むときは、Derivation 規則を記述します。
例
電話番号のフィールドは、1 つのテキストボックスとしてフォームに表示されます。しかし、より高度なフォームには、リソースに保存する電話番号の計算に使用される、市外局番と電話番号の 3 つのフィールドが含まれる場合があります。
電話番号を表す単純な例では、次のようなフォームフィールドを使用できます。
<Field name='P1'>
<Display class='Text'>
<Property name='title' value='Office Phone Number'/>
<Property name='size' value='3'/>
<Property name='maxLength' value='3'/>
</Display>
</Field>
<Field name='P2'>
<Display class='Text'>
<Property name='title' value='-'/>
<Property name='size' value='3'/>
<Property name='maxLength' value='3'/>
</Display>
</Field>
<Field name='P3'>
<Display class='Text'>
<Property name='title' value='-'/>
<Property name='size' value='4'/>
<Property name='maxLength' value='4'/>
</Display>
</Field>
<Field name='global.OfficePhone'>
<Expansion>
<concat>
<ref>P1</ref><s>-</s>
<ref>P2</ref><s>-</s>
<ref>P3</ref>
</concat>
</Expansion>
</Field>
例
次の例は、前述の例で定義されている P1 フィールドのフィールド定義を拡張します。これは、電話番号の属性をフォームに読み込む方法を定義し、それを 3 つのフィールドの表示に展開します。
<Field name='P1'>
<Display class='Text'>
<Property name='title' value='Office Number'/>
<Property name='size' value='3'/>
<Property name='maxlength' value='3'/>
</Display>
</Field>
ユーザーが Identity Manager にデータを入力すると、データが適切に入力されかどうかがフォームによって確認されます。しかし、リソースに直接入力された場合は、リソースが同じ要件を満たしているかどうかについて Identity Manager が検証することはできません。たとえば、長年にわたって、管理者が電話番号を 123-4567 (8 文字) と入力したり、123-123-4567 (12 文字) または (123) 123-4567 (14 文字) のように入力したりしている可能性もあります。
例
OfficePhone フィールドの定義は、これまでの例と同様ですが、Derivation 規則を使用するには、3 つのフィールド (P1、P2、および P3) のそれぞれを更新する必要があります。この例は、P1 フィールドの更新を表しています。
<defvar name='lenOfficePhone'>
<length><ref>Office Phone</ref></length>
</defvar>
<Field name='P1'>
<Display class='Text'>
<Property name='title' value='Office Phone Number'/>
<Property name='size' value='3'/>
<Property name='maxLength' value='3'>
</Display>
<Derivation>
<or>
<cond><eq>
<ref>lenOfficePhone</ref>
<s>8</s></eq>
<s> </s></eq>
</cond>
<cond><eq>
<ref>lenOfficePhone</ref>
<s>12</s></eq>
<substr>
<ref>Office Phone</ref>
<i>0</i>
<i>1</i>
</substr>
</cond>
<cond><eq>
<ref>lenOfficePhone</ref>
<s>14</s></eq>
<substr>
<ref>Office Phone</ref>
<i>0</i>
<i>1</i>
</substr>
</cond>
</or>
</Derivation>
</Field>
フィールドを計算するときは、データの現在の形式と、リソースの品質に注意してください。新規ユーザーを作成するときは、正しいフィールド値の確認は比較的容易です。リソースから読み込む場合に、既存のデータをフィールドに適合させることのほうがずっと困難です。どのフィールドにも Derivation 規則を適用し、読み込むときに属性の形式を確認することができます。
フィールドの再計算
ユーザーがフォームを操作するときに、システムは何度もフィールドを計算します。フィールドの計算は、フィールドを最初に表示したときにデフォルト値を設定するために行われ、フォームの計算は、ユーザーが「保存」をクリックしたときに行われます。これ以外に、「ユーザーの編集」ページの「再計算」をクリックすると、フォームが評価されます。また、action フィールドを使用してフォームを評価することもできます。
例
<Field>
<Display class='Button'>
<Property name='label' value='Recalculate'/>
<Property name='command' value='Recalculate'/>
</Display>
</Field>
システムがフィールドの値を再計算するように設定するときは、次のように、Display クラス要素の action を true に設定します。
<Display class='Select' action='true'>
この値は、ユーザーが選択またはクリックするフィールドのみに追加します。テストエリアやテキストエリアのフィールドに追加しないでください。フィールドに action=true が設定されると、ブラウザでフィールドを変更するたびにフォームが再計算されます。
例
<Field name='Region'>
<Display class='Select' action='true'>
<Property name='title' value='Geographic Region'/>
<Property name='allowedvalues' value='North, South,
Central, Midwest'./>
<Property name='nullValue' value='Select a region'/>
</Display>
</Field>
フォームの作成に関するガイドライン
新しいフォームの構造を作成したり、既存のフォームを編集したりするときは、次のガイドラインに注意してください。
フォームフィールド内の式の最適化
フォームで実行される一部のアクティビティーは、Identity Manager の外部にあるリソースを呼び出すことができます。これらのリソースへのアクセスは、Identity Manager のパフォーマンスに影響します。特に、グループや電子メール配信のリストのコンパイルのように、結果が値の長いリストになる場合は大きく影響します。このような呼び出し実行中のパフォーマンスを改善する方法については、「フィールドデータを取得する Java クラスの使用」の節のガイドラインを参照してください。
シナリオの例
次に、式を最適化する例を示します。
Identity Manager に格納されていない情報や、リソースアカウント属性としてアクセスできない情報をデータベースに照会する場合の一般的な手順は次のとおりです。
フィールドデータを取得する Java クラスの使用
情報の取得時に呼び出されるメソッドを持つ Java クラスを記述します。次の節「非表示フォームフィールドの定義」で紹介する例は、カスタムメソッドである getJobGrade メソッドを使用します。このカスタムクラスは、idm¥WEB-INF¥classes¥com¥waveset¥custom ディレクトリ構造に配置してください。システムにこれらのディレクトリが存在しない場合は、作成する必要があります。
このクラスを記述するときは、次のガイドラインに注意してください。
非表示フォームフィールドの定義
まず、Java クラスを呼び出す Default 式を使用する非表示フォームフィールドを、フィールド定義に Display クラスを含めずに定義します。
<Field name='jobGrade'>
<Default>
<invoke name='getJobGrade'
class='com.waveset.custom.DatabaseAccessor'>
<ref>waveset.accountId</ref>
</invoke>
</Default>
</Field>
Default 式は、jobGrade 属性の値がビューに含まれない場合にのみ評価されます。一度 Default 式を実行すると、結果が jobGrade に格納され、再実行されません。
要素の「フォーム要素」ダイアログで次の操作を行います。
非表示属性の参照
非表示属性を定義すると、次のように別の式からその属性を参照できるようになります。
<Field name='secureKey'>
<Disable><lt><ref>jobGrade</ref><i>10</i></lt></Disable>
...
</Field>
XPRESS の defvar 変数を使用して計算結果を保持することもできますが、通常は非表示フォームフィールドを使用する場合ほど効率的ではありません。
繰り返し時の変数の最適化に関する注意点
XPRESS 変数の値は、通常、フォームフィールドに対する 1 回の実行の間だけ持続します。このため、Expnasion 式に変数を使用することはできますが、それに続く Derivation 式では使用できません。計算結果の値を複数回の実行でも有効にする必要があるときは、代わりに非表示フォームフィールドを使用します。非表示フィールドの値はビューに格納され、変数セッションをキャンセルまたは保存するまで持続します。
新しいリソースとユーザーの自動リンク設定の無効化
Identity Manager には、ユーザーに新しいリソースを割り当てるときに、既存のアカウントとのリンクを制御する方法が用意されています。
ユーザーに新しいリソースを割り当てるときに、ID を割り当てられたアカウントがすでにリソースに存在する場合は、Identity Manager はデフォルトで、そのアカウントを自動的に Identity Manager ユーザーにリンクしてからプロビジョニングを継続します。反対に、この自動リンク設定を無効にし、ユーザーの新規アカウントを作成するときに別のアカウント ID を入力することもできます。
ユーザーに新規アカウントをどのようにリンクさせるかは、次の 2 つの方法で制御できます。
ユーザーフォームでの手動リンク設定の有効化
手動リンク設定を有効にする方法は次のとおりです。
手順 1: プロパティー定義の設定
フォームの先頭に次のようなプロパティー定義を追加します。
<Form>
<Properties>
<Property name='InteractiveLinking' value='true'/>
</Properties>
...
</Form>
手順 2: 標準フォームライブラリに含まれるフィールドの参照
フォーム内の任意の場所にフィールド参照を追加します。次に例を示します。
<FieldRef name='DiscoveredAccountFields'/>
このフィールドを参照するには、ユーザーフォームに次の Include ステートメントを設定してください。この Include 式は、通常、すべてのユーザーフォームにすでに存在します。
<Include>
<ObjectRef type='UserForm' name='User Library'/>
</Include>
これらのフォーム変更を完了すると、Identity Manager はフォームの表示を更新するたびに、また、フォームを保存する前に、既存のアカウントを調べます。Identity Manager が既存のアカウントを検出すると、フォームの最上部に警告メッセージが表示され、検出されたアカウントごとに新しいフィールドが挿入されます。これらの新規フィールドには、リンクを設定するアカウントを手動で指定するためのチェックボックスがあります。
さらに、Identity Manager は、各属性のフィールドをリソースのアイデンティティーテンプレート内に生成します。このフィールドを使用して、アカウントに別のアイデンティティーを指定することができます。Identity Manager は既存アカウントの属性をフェッチし、それをビューに含めます。
これらの属性は、MissingFields 参照または独自のカスタムフィールドを使用して表示できます。存在しないアカウントには別のアイデンティティーを指定するか、フォームを保存する前に既存アカウントとのリンクを設定できるようにチェックボックスを選択してください。
プロビジョニング時の自動リンク設定の回避
対話的でない方法でワークフローからプロビジョニングを行うときは、Identity Manager にアカウントのリンク設定を自動的に行わせるかどうかも制御できます。checkinView の呼び出しに NoLinking ビューオプションを渡すことで、リンクの自動設定を回避できます。このオプションは、いくつかの方法で指定できます。
- 次のように、このオプションを引数として WorkflowServices メソッドに渡します。
<Action application='com.waveset.provision.WorkflowServices'>
<Argument name='op' value='checkinView'/>
<Argument name='view' value='$(user)'/>
<Argument name='NoLinking' value='true'/>
</Action>
- このオプションをビューの属性として設定します。この場合のビュー属性の名前は、viewOptions.NoLinking となります。この属性をワークフローに設定するときは、次のように XPRES ロジックを使用します。
<set name='user.viewOptions.NoLinking'>
<s>true</s>
</set>
結果ページでのクリアテキストによる属性の表示の回避
Identity Manager では、編集フォームにアスタリスク付きで表示されるように属性を設定した場合でも、結果ページの属性の値は平文形式で表示されます。
属性が結果ページにクリアテキストとして表示されないようにするには、その属性をシークレット属性として登録します。シークレット属性を登録するには、次のようにしてシークレット属性を System Configuration オブジェクトに追加します。
<Attribute name='secretAttributes'>
<List>
<String>email</String>
<String>myAttribute</String>
</List>
</Attribute>
フォームからのリソースメソッドの呼び出し
invoke メソッドを使用することで、フォームからリソースのメソッドを呼び出すことができます。
invoke メソッドを呼び出すには、クラス名とメソッド名を指定します。invoke タグ内部のメソッドには、次の例のように引数を渡すこともできます。
<Default>
<block>
<defvar name='vmsResName'>
<index i='0'>
<ref>accountInfo.accounts[type=vms].name</ref>
</index>
<defvar>
<invoke name='callResourceMethod'
class='com.waveset.ui.FormUtil'>
<ref>display.session</ref>
<ref>vmsResName</ref>
<null/>
</invoke>
</Default>
フィールドの「フォーム要素」ダイアログで次の操作を行います。
別のフォームからのフォームの参照
<FormRef> 要素を使用することで、完全なフォームではなく、別のフォーム内の特定のフィールドを参照できます。
外部フォームからの別のフォームを含めるには、<FormRef> 要素を使用します。次の例は、MissingFields というフォームを呼び出します。
<FormRef name='MissingFields'/>
<FieldRef name='AuthenticationAnswers'/>
<FieldRef name='AccountInformation'/>
<Field name='waveset.backgroundSave'>
<Display class='Hidden'/>
</Field>
別のフォームからのフィールドの参照
<FieldRef> 要素を使用することで、完全なフォームではなく、別のフォーム内の特定のフィールドを参照できます。
外部フォームからの特定のフィールドを含めるには、<FieldRef> 要素を使用します。このとき、次の項目を指定します。
- フィールドが存在するフォームの名前。このフォーム名は、<ObjectRef> 要素を使用して、フォームヘッダーの Include セクションのリストに含めてください。フォーム名 (UserForm) と一意の設定 ID は、プロパティータイプで指定します。name プロパティーは、後で参照するフィールドの名前を識別します。
- ページ上に表示する位置に対応したフォームセクションに挿入されるフィールド名。
<Include>
<ObjectRef type='UserForm'
id='#ID#04F5F14E01889DFE:2E5C94:F131DD723D:-7FE4'
name='Password Library'/>
<ObjectRef type='UserForm'
id='#ID#04F5F14E01889DFE:2E5C94:F131DD723D:-7FE3'
name='Account Summary Library'/>
<ObjectRef type='UserForm'
id='#ID#UserForm:UserFormLibrary'/>
<ObjectRef type='UserForm' name='Global Attributes'/>
</Include>
次の例では、ページ上に表示する位置に対応したフォームセクションにフィールド名が挿入されています。
<Field name='global.fullname' hidden='true'>
<Expansion>
<cond>
<and>
<ref>global.firstname</ref>
<ref>global.lastname</ref>
</and>
<concat>
<ref>global.firstname</ref>
<s> </s>
<ref>global.lastname</ref>
</concat>
</cond>
</Expansion>
</Field>
次の例の <FieldRef> 要素は、参照する属性の名前を識別します。
<Field>
<Disable>
<isnull>
<ref>waveset.id</ref>
</isnull>
</Disable>
<FieldRef name='DynamicChangePasswordFields'/>
</Field>
フォームの編集フォームを編集することで表示特性を変更したり、論理処理を追加してフィールドやコンポーネントを選択したりできます。ここでは、次の 2 つのカテゴリに分けて、フォーム関連編集タスクについて説明します。
- Display 要素の操作: ここでは、Identity Manager のフォームを編集するときに、特にユーザーに表示される基本ページコンポーネントの表示特性の変更について説明します。このようなコンポーネントには、ボタン、ラジオボタン、チェックボックスなどがあります。
- 非表示コンポーネントの操作: このセクションでは、バックグラウンド処理や、表示されるフォームへの論理処理の追加などの目的で Identity Manager のフォームに追加される、HTML 要素コンポーネントについて説明します。このような要素には、<Disable> コンポーネントや <Expansion> コンポーネント、FormUtil メソッドなどがあります。
タスク関連のセクションで説明される HTML コンポーネントは、「HTML 表示コンポーネント」でアルファベット順に説明されています。
Display 要素の操作
Identity Manager フォームでの変更や追加がもっとも多い Display 要素は、ボタン、フィールド、およびテキスト入力ボックスです。Display 要素には、これ以外にテーブルやセクションのヘッダーがあります。
クラスが指定されていない Display 要素は非表示となります。
ボタン
一般的な押しボタンを作成するときは、<Button> コンポーネントを使用します。
複数のボタンを水平に並べるときは、<ButtonRow> コンポーネントを使用します。
<Field>
<Display class='Button'>
<Property name='location' value='true'/>
<Property name='label' value='キャンセル'/>
<Property name='command' value='Cancel'/>
</Display>
</Field>
ボタンをボタン行に配置するときは、ボタンの定義に <Property name='location ' value=' button '/> というコードを追加します。この Property フィールドを設定しない場合、ボタンはフォームに記述されている順序で縦に表示されます。
ボタンラベルの割り当てと変更
ボタンを定義するとき、ラベルの値は、次のように label プロパティーの value の設定によって指定されます。
<Display class='Button'>
<Property name='label' value='キャンセル'/>
ブラウザは、このコードに指定されている「キャンセル」をボタンのラベルとして表示します。
ボタンのデフォルト名の無効化
Identity Manager フォームの下部には、通常は 2 つのボタンが表示されます。しかし、これらのボタンには「保存」と「キャンセル」というデフォルトラベルが付けられています。これらのボタン名を変更するときは、フォームを次のように変更します。
フォームの下部に次のような「保存」ボタンと「キャンセル」ボタンのフィールドを追加し、ラベル名を適切に変更します。
<Field>
<Display class='Button'>
<Property name='label' value='Submit'/>
<Property name='name' value='submitButton'/>
<Property name='value' value='true'/>
<Property name='command' value='保存'/>
</Display>
</Field>
<Field>
<Display class='Button'>
<Property name='label' value='キャンセル'/>
<Property name='command' value='Cancel'/>
<Property name='location' value='true'/>
</Display
</Field>
command パラメータの値とボタン
Identity Manager のインタフェースのすべてのページでは、クリックされたフォーム送信ボタンを伝達するメカニズムとして、command というデータ送信パラメータが使用されてきました。この条件は、コンポーネントを使用するページプロセッサシステムには適用されませんが、特に Button などの一部のコンポーネントには、command パラメータ用の特別サポートが含まれます。
XML フォームを処理するシステムをはじめとする一部のページプロセッサシステムは、command パラメータの使用を前提としています。さらに、特定のアクションを示すために、いくつかの command パラメータの値が使用されています。次の表は、このような値について説明しています。
表 3-11 command パラメータに指定できる値
パラメータ
説明
Save
フォームコンテンツを保存すべきであることを示します。
Cancel
フォームコンテンツを破棄すべきであることを示します。
Recalculate
入力データに基づいてフォーム表示を更新すべきであることを示します。
command パラメータでは、どのような値も使用できますが、認識されない値がページの再表示につながることを覚えておいてください。
<ButtonRow> 要素によるボタンの整列
複数のボタンを 1 行に整列させるときは、ButtonRow 要素を使用します。
<Field name='OrganizeButtons'>
<Display class='ButtonRow'>
<Property name='title' value='Choose a Button'/>
</Display>
<Field name='ChangePassword'>
<Display class='Button'>
<Property name='label' value='Change Password'/>
<Property name='value' value='Recalculate'/>
</Display>
</Field>
<Field name='ResetPassword'>
<Display class='Button'>
<Property name='label' value='Reset Password'/>
<Property name='value' value='Recalculate'/>
</Display>
</Field>
テキストフィールド
フォームには、単一行と複数行の両方のテキスト入力ボックスを含めることができます。単一行のテキスト入力フィールドを作成するときは、<Text> 要素を使用します。複数行のテキスト入力フィールドを作成するときは、<TextArea> 要素を使用します。
<Display class='Text'>
<Property name='title' value='Zip Code'/>
<Property name='size' value='10'/>
<Property name='maxLength' value='10'/>
<Property name='required' value='true'/>
</Display>
フィールドラベルの割り当てと変更
テキストフィールドまたはエリアを定義するとき、ラベルの値は、次のように label プロパティーの value プロパティーで設定されます。
<Display class='Text'>
<Property name='label' value='入力'/>
ブラウザは、このコードに指定されている「入力」をテキスト入力フィールドのラベルとして表示します。
コンテナ
一部の Display 要素は、コンテナコンポーネントというコンポーネント内に配置されます。コンテナコンポーネントには、次のような用途があります。
コンテナクラスを作成すると、通常は HTML table タグが生成されます。
次の表は、代表的なコンテナコンポーネントについて説明しています。
表 3-12 代表的なコンテナコンポーネント
コンポーネント
説明
<SimpleTable>
コンポーネントをグリッドに配置します。オプションとして、上部に列のタイトル行も設定できます。
<ButtonRow>
ボタンを横方向で 1 行に配置します。このコンポーネントは、基本的には、水平レイアウトが事前に設定されたパネルです。
<BorderedPanel>
コンポーネントを、東西南北と中央の 5 つの領域に配置します。
<SortingTable>
ソートに対応した列を持つ、行の背景色が交互に青とベージュで示される表を表示します。
簡単な表の作成
Identity Manager フォームのコンテナコンポーネントでは、<SimpleTable> というコンポーネントが頻繁に使用されます。これは、コンポーネントをグリッドに配置します。オプションとして、上部に列のタイトル行も設定できます。この Display コンポーネントの唯一のプロパティーは、列にタイトルを割り当て、プロパティー文字列のリストで表の幅を定義する columns です。
次の例は、複数のサブフィールドの配置に SimpleTable を使用するフィールドを示しています。
<Field name='SelectionTable'>
<Display class='SimpleTable'>
<Property name='columns'>
<List>
<String>Account</String>
<String>Description</String>
</List>
</Property>
</Display>
<Field name='accounts[LDAP].selected'>
<Display class='Checkbox'>
<Property name='label' value='LDAP'/>
</Display>
</Field>
<Field>
<Display class='Label'>
<Property name='text' value='Primary Corporate LDAP Server'/>
</Display>
</Field>
<Field name='accounts[W2K].selected'>
<Display class='Checkbox'>
<Property name='label' value='Windows 2000'/>
</Display>
</Field>
<Field>
<Display class='Label'>
<Property name='text' value='Primary Windows 2000 Server'/>
</Display>
</Field>
</Field>
コンポーネントのグループ化
フォームの複数のコンポーネントをグループ化して非表示または無効にするときは、<SimpleTable> コンテナを次の例のように使用します。
コード例 3-2 フォームのコンポーネントのグループ化
<Field>
<Disable>
<not>
<contains>
<ref>accountInfo.typeNames</ref>
<s>Windows Active Directory</s>
</contains>
</not>
</Disable>
<Field name='accounts[AD].HomeDirectory'>
<Display class='Text'>
<Property name='title' value='Home Directory'>
</Display>
</Field>
</Field>
リストの操作
リストの作成に使用するコンポーネントは、リストの長さと、ユーザーが複数のオプションを同時に選択できるかどうかによって異なります。
多くのテキストボックスには、選択可能な複数のオプションを示すリストを備えています。これらのリストのデータを取り込むときは、allowedValues というプロパティーの内部でリストを指定して選択するか、リソースのメソッド呼び出し (FormUtil クラスメソッド) を利用して動的に取得します。リストのテキストエリアへの情報の取り込みについては、この章の「リストデータの取り込み」の節を参照してください。
次の表は、代表的なリストタイプと、その作成に使用される HTML Display コンポーネントについて説明しています。
表 3-13 代表的なリストタイプと関連する Display コンポーネント
リストタイプ
HTML コンポーネント
true と false のように、互いに排他的な値を持つオプションリスト
<CheckBox>
「チェックボックスの作成」の節を参照してください。
ユーザーが 1 つのオプションのみを選択できる複数オプションのリスト
<RadioButton>
「ラジオボタンの作成」の節を参照してください。
ユーザーが 1 つのオプションのみを選択できる複数オプションのリスト (オプション数が多いリスト)
<Select>
「単一選択リストの作成」の節を参照してください。
複数のオプションを同時に選択できる複数オプションのリスト
<MultiSelect>
「複数選択リストの作成」の節を参照してください。
チェックボックスの作成
チェックボックスの表示には、<Checkbox> コンポーネントを使用します。チェックボックスを選択すると、そのボックスの値は true となります。選択していないボックスの値は false です。label プロパティーの値を編集することで、チェックボックス名を変更できます。
例 1
<Field name='accounts[LDAP].selected'>
<Display class='Checkbox'>
<Property name='label' value='LDAP'/>
</Display>
</Field>
例 2
<Field name='global.Password.Expired'>
<Display class='CheckBox'>
<Property name='title' value='User must change password at
next login'/>
<Property name='alignment' value='left'/>
</Display>
</Field>
ラジオボタンの作成
1 つまたは複数のラジオボタンの水平リストを表示するには、<Radio> コンポーネントを使用します。ユーザーが一度に選択できるラジオボタンは 1 つだけです。コンポーネントの値が NULL の場合、または許可される値のいずれとも一致しない場合は、ボタンは選択されません。
<Field name='global.EmployeeType'>
<Display class='Radio'>
<Property name='title' value='EmployeeType'/>
<Property name='labels' value='Employee, Contractor, Temporary, Part Time'/>
<Property name='required' value='true'/>
</Display>
</Field>
単一選択リストの作成
<MultiSelect> コンポーネント以外に、<Select> コンポーネントも、選択できる項目のリストを作成できます。選択できる値のリストが長くなる場合、ラジオボタンではフォームを占める面積が大きくなります。一方、select リストでは、選択できる値の長いリストからユーザーが値を選択できます。リストが整っている場合は、このリストは先行入力をサポートします。ユーザーが選択できる項目を指定するには、allowedValues プロパティーを使用します。
<Field name='global.title'>
<Display class='Select'>
<Property name='title' value='Title'/>
<Property name='allowedValues'>
<List>
<String>Staff</String>
<String>Manager</String>
<String>Director</String>
<String>VP</String>
</List>
</Property>
</Display>
</Field>
複数選択リストの作成
複数のオプションを選択できるリストボックスの表示には、<MultiSelect> コンポーネントを使用します。このテキストボックスは、1 つのボックスに含まれる定義済みの値セットを選択ボックスに移動できる、2 つの部分から構成されるオブジェクトを表示します。リストボックスの値の指定には、allowedValues 要素を使用するか、getResources などのメソッド呼び出しを利用して動的に値を取得します。
<Select> コンポーネント以外に、<MultiSelect> コンポーネントも、選択できる項目リストを動的に作成できます。これらのリストのデータを取り込むときは、allowedValues というプロパティーの内部でリストを指定して選択するか、リソースのメソッド呼び出しを利用して動的に取得します。複数選択入力ボックスに表示するリストの取り込みについては、「リストデータの取り込み」の節を参照してください。
<Field name='waveset.roles'>
<Display class='MultiSelect' action='true'>
<Property name='title' value='Roles'/>
<Property name='availableTitle' value='Available Roles'/>
<Property name='selectedTitle' value='Current Roles'/>
<Property name='allowedValues'>
<invoke name='getObjectNames' class='com.waveset.ui.FormUtil'>
<ref>display.session</ref>
<s>Role</s>
<ref>waveset.original.roles</ref>
</invoke>
</Property>
</Display>
</Field>
選択リストの別の表示値セット
フィールドに実際に割り当てられている値セットとは異なる値セットを表示する選択リストを作成できます。このリストは、暗号化された複数の値の判読可能な名前を表示したり、フォームを国際化するために別の表示言語に対応したりする場合によく使用されます。このようなリストを作成するには、valueMap プロパティーを使用して、実際の値と表示値を関連付けます。次の例を参照してください。
コード例 3-3 valueMap プロパティーによる選択リストの値の変更
<Field name='waveset.organization'>
<Display class='Select'>
<Property name='title' value='Add Account'/>
<Property name='nullLabel' value='Select...'/>
<Property name='valueMap'>
<list>
<s>Top</s>
<s>Top Level</s>
<s>Top:OrgB</s>
<s>Ted's Organization</s>
<s>Top:OrgC</s>
<s>Super Secret Org</s>
</list>
</Property>
</Display>
</Field>
前述の例では、値のマップが文字列ペアのリストとして指定されます。リスト項目の奇数行の文字列は、このフィールドに割り当てられる実際の値です。偶数行の文字列は、選択リストに表示される値です。たとえば、選択リストから Ted's Organization を選択すると、このフィールドの値は Top:Orgb となります。
リストデータの取り込み
リストには、ユーザーオブジェクトや外部リソースに格納されている情報から動的に計算されたオプションが取り込まれることがよくあります。このようなリストを作成するには、まず、リストデータを取り込む前に、HTML List コンポーネントを作成します。HTML テキストボックスコンポーネントの使用についての詳細は、「単一選択リストの作成」と「複数選択リストの作成」の節を参照してください。
ここで説明するメソッドを含め、これらのリストデータの取り込みには 2 つの方法があります。
特定のタスクの実行に、XPRESS ではなく XML オブジェクト言語を使用する利点については、「XML オブジェクト言語と XPRESS でのリストの表現」の節を参照してください。
リストへの選択可能値セットの取り込み
フォームで使用されるリストにデータを取り込むためのもっとも一般的な方法は、allowedValues プロパティーを使用することです。このプロパティーを使用することで、<Select> 要素と <MultiSelect> 要素で選択できる値のオプションリストを指定できます。このコンポーネントの値は常にリストであり、その値は通常、文字列です。
<Field name='department'>
<Display class='Select' action='true'>
<Property name='title' value='Department'/>
<Property name='allowedValues��gt;
<List>
<String>Accounting</String>
<String>Human Resources</String>
<String>Sales</String>
<String>Engineering</String>
</List>
</Property>
</Display>
</Field>
グループの複数選択リストへの動的なデータ取り込み
複数選択リストは、通常、2 つの部分から構成されます。
グループの複数選択リストの追加
リソースから動的に取得されたデータを、グループの複数選択リストに追加する方法は次のとおりです。
次の例の display.session の直前の : (コロン) は、フォームのベースコンテキストを無視し、ワークフローコンテキストのルートからオブジェクトを参照できることを表します。
<Field name='global.AD Groups'>
<Display class='MultiSelect' action='true'>
<Property name='title' value='AD Group Membership'/>
<Property name='availableTitle' value='Available AD Groups'/>
<Property name='selectedTitle' value='Selected AD Groups'/>
<Property name='allowedValues'>
<invoke class='com.waveset.ui.FormUtil' name='listResourceObjects'>
<!-- メソッドがユーザー権限の検証に使用するセッション情報を送信します -->
<ref>:display.session</ref>
<!-- リソースオブジェクトタイプ - これはリソースごとに異なりますが、アカウ ント、グループ、および "配信リスト" のタイプは共通です -->
<s>Group</s>
<! -- 呼び出されるリソースの名前 -->
<s>AD Resource Name</s>
<!-- オプションマップ - 一部のリソースにはコンテキストのようなオプションが あり、グループのリストが含まれます。たとえば、Active Directory の場合は、複数のコン テナが含まれます。デフォルトでは、リソースに指定されているコンテナが使用されます。こ こに指定する値は、デフォルト値に優先して適用されます。リソースがオプションをサポート しない場合は、値を <null/> にしてください -->
<Map>
<MapEntry key='context' value='ou=Austin,ou=Texas,dc=Sun,dc=com'/>
</Map>
<!-- cacheList - このリストをリソースオブジェクトのリストキャッシュに取り 込むかどうかに応じて、true または false に設定します-->
<s>true</s>
</invoke>
</Property>
</Display>
</Field>
注
リソースがオプションをサポートしない場合は、options map の値を null にしてください。一部のリソースにはコンテキストのようなオプションがあり、グループのリストが含まれます。たとえば、Active Directory の場合は、複数のコンテナが含まれます。デフォルトでは、リソースに指定されているコンテナが使用されます。ここに指定する値は、デフォルト値に優先して適用されます。
cacheList の値は、このリストをリソースオブジェクトのリストキャッシュに格納するかどうかに応じて、true または false に設定します。これにより、メソッドは 1 回実行され、結果はサーバーに格納されます。
選択リストのテキスト入力フィールドの作成
項目を選択するだけでなく、ユーザーが値を入力できる選択リストが必要となる場合もあります。このようなリストを作成するには、次の例のように 3 つのフィールドを実装します。
次の例には、説明的なテキストが組み込まれています。
<defvar name='titleList'>
<list>
<s>Manager</s>
<s>Accountant</s>
<s>Programmer</s>
<s>Assistant</s>
<s>Travel Agent</s>
<s>Other</s>
</list>
</defvar>
この例の次の部分には、title と otherTitle という 2 つの可視フィールドが含まれます。otherTitle フィールドは、ユーザーが選択リストから「Other」オプションを選択した場合にのみ表示されます。3 番目の非表示フィールドは global.Title です。これは、Title と otherTitle のいずれかから設定されます。
ユーザーが選択するためのメインフィールドは Title フィールドです。リストに必要な項目を見つけられなかった場合、ユーザーは「Other」オプションを選択できます。これは一時的なフィールドであり、ユーザーが「保存」をクリックしたときに、格納されたり、ワークフロープロセスに渡されることはありません。リソースからの値の送信と、値がリストに含まれるかどうかの判断には、Derivation 規則が使用されます。
<Field name='Title'>
<Display class='Select' action='true'>
<Property name='title' value='Title'/>
<Property name='allowedValues'>
<Property name='nullLabel' value='Select ��/>
<expression>
<ref>titleList</ref>
</expression>
</Property>
</Display>
<Derivation>
<cond>
<isnull><ref>global.Title</ref></isnull>
<null/>
<cond>
<eq>
<contains>
<ref>titleList</ref>
<ref>global.Title</ref>
</contains>
<i>1</i>
</eq>
<ref>global.Title</ref>
<s>Other</s>
</cond>
</cond>
</Derivation>
</Field>
Other フィールドは、ユーザーが Title フィールドから「Other」を選択した場合にのみフォームに表示されます。Other フィールドの値は、フォームの読み込み時に設定されます。この値は、Titleフィールドと global.title フィールドの値に基づきます。
<Field name='otherTitle'>
<Display class='Text'>
<Property name='title' value='Other Title'/>
<Property name='rowHold' value='true'/>
<Property name='noWrap' value='true'/>
<Property name='size' value='15'/>
<Property name='maxLength' value='25'/>
</Display>
<Disable>
<neq>
<ref>Title</ref>
<s>Other</s>
</neq>
</Disable>
<Derivation>
<cond>
<eq>
<ref>Title</ref>
<s>Other</s>
</eq>
<ref>global.Title</ref>
</cond>
</Derivation>
</Field>
Field の値は、Title フィールドの値に基づきます。このフィールドの値が Other に設定されると、フィールドの値は otherTitle フィールドの値となります。それ以外の値に設定された場合は、Title フィールドの値となります。
<Field name='Title'>
<Expansion>
<cond>
<eq>
<ref>global.fieldTitle</ref>
<s>Other</s>
</eq>
<ref>otherTitle</ref>
<ref>Title</ref>
</cond>
</Expansion>
</Field>
フォームに表示する前のリソースアカウントリストのフィルタリング処理
フォームに表示する前に、リソースアカウントのリストをフィルタリングできます。ユーザーに表示されるリストから無効化されたアカウントを除去するデフォルトのフィルタリング動作が維持されるユーザーインタフェースの「Change Password Form」を除き、デフォルトでは、フィルタは適用されません。
この除去フィルタは、Form プロパティーとして定義されます。このフィルタは、1 つまたは複数の属性条件のリストです。これは、指定されたリソースアカウントを表示リストから除外するかどうかを決定するときに評価されます。
この機能をサポートするフォーム
次のフォームは、Form プロパティーによる除去フィルタの指定をサポートします。
Change Password Form (ユーザーインタフェース)
管理者インタフェースのフォーム:
排除プロパティーの形式
フォームの排除 (Exclude Form) プロパティーの形式は次のとおりです。
<Configuration wstype='UserForm' ...
<Extension>
<Form noDefaultButtons='true'>
...
<Properties>
表示されるアカウントのリストに、無効化されたリソースアカウントを含めるときは、リストから無効化属性条件を削除します。
<Property name='Exclude'>
<list>
<new class='com.waveset.object.AttributeCondition'>
<s>disabled</s>
<s>equals</s>
<s>yes</s>
</new>
</list>
</Property>
</Properties>
...
</Form>
</Extension>
</Configuration>
有効なビュー属性
有効な属性名は、currentResourceAccounts オブジェクトの各インスタンスの、前述の各フォームと関連付けられているビューによって参照される名前です。次の属性は、有効な属性です。
例: リソースアカウントリストからの LDAP リソースタイプの排除
指定されたフォームリストから、直接割り当てられない、LDAP タイプのすべてのリソースアカウントを排除するには、排除プロパティーを次のように設定します。
<Property name='Exclude'>
<list>
<new class='com.waveset.object.AttributeCondition'>
<s>type</s>
<s>equals</s>
<s>LDAP</s>
</new>
<new class='com.waveset.object.AttributeCondition'>
<s>directlyAssigned</s>
<s>equals</s>
<s>false</s>
</new>
</list>
</Property>
allowedValues プロパティー内からの FormUtil メソッドの呼び出し
データベースのような Identity Manager の外部にあるリソースから情報を動的に取得し処理するための FormUtil メソッドは、allowedValues プロパティー内からも呼び出すことができます。
この例は、FormUtil メソッドを呼び出して、選択リストにデータを取り込む方法を示しています。次の例では、allowedValues プロパティーの内部からメソッドが呼び出されます。getOrganizationsWithPrefixes メソッド (または任意の FormUtil メソッド) は、式の内部から呼び出されます。
<Field name='waveset.organization'>
<Display class='Select'>
<Property name='title' value='Organization'/>
<Property name='autoSelect' value='true'/>
<Property name='allowedValues'>
<expression>
<invoke class='com.waveset.ui.FormUtil'
name='getOrganizationsWithPrefixes'>
<ref>:display.session</ref>
</invoke>
</expression>
</Property>
</Display>
</Field>
XPRESS は、リソースまたは ActiveSync アダプタ内から Java メソッドを呼び出す機能もサポートしています。呼び出しの結果として得られるデータは、複数選択リストまたは単一選択リストに取り込むことができます。式の内部からのメソッドの呼び出しについては、「XPRESS 言語」を参照してください。
ラベルフィールドの作成
ラベルは、読み取り専用フィールドの値を表示するときに便利なコンポーネントです。<Label> コンポーネントのプロパティーを使用することで、色、値 (文字列)、フォントスタイルなどの表示特性を定義できます。
<Field>
<Display class='Label'>
<Property name='text' value='Primary Corporate LDAP
Server'/>
</Display>
</Field>
value 属性の値は常に文字列です。
その他の Display 要素の操作
これまでに説明した要素以外に、次の Display 要素をフォームに組み込むことができます。
フォームへのセクション見出しの追加
長いフォームを目立つラベルで分割するときは、セクション見出しが便利です。<SectionHead> 要素は、title (prompt) プロパティーの値によって定義される、新しいセクション見出しを表示します。これは、font プロパティーに大きな太字のスタイルを設定する Label クラスの実行に相当します。また、pad プロパティーはゼロに設定され、デフォルトの 2 文字分の隙間は取り除かれます。
<Field>
<Display class='SectionHead'>
<Property name='title' value ='Calculated Fields'/>
</Display>
</Field>
フォームへのカレンダアイコンの追加
DatePicker 要素を使用することで、ページにカレンダアイコンを追加できます。ユーザーは、このアイコンをクリックして日付を選択し、ページフィールドに値を適用できます。たとえば、Identity Manager の「監査レポートの作成」ページは、開始日と終了日の選択に、このコンポーネントを使用しています。
DatePicker 要素は、日付オブジェクトを返します。DatePicker 要素を使用して設定するほとんどのリソース属性は、文字列形式の日付を必要とします。追加のテキストフィールドは、新しい日付オブジェクトから文字列への変換、または現在の設定の表示に使用されます。
次の表に示される、さまざまな形式の文字列を渡して dateToString メソッドを呼び出すことで、形式が異なるいずれかの日付を取得できます。
<Field name='aix_account_expire'>
<Display class='DatePicker'>
<Property name='title' value='Set Password Expiration Date'/>
</Display>
</Field>
次のフィールドは、/etc/security/user ファイルに指定されている、パスワードの有効期限日を表示します。このフィールドは、新しい日付を選択したあとに表示の更新や再計算を行った場合、aix_account_expire フィールドによって選択される新しい日付も表示します。Identity Manager は、aix_account_expire 日付フィールドに DatePicker フィールドから NULL 以外の値が設定されたかどうかを確認します。
この日付フィールドが設定されている場合、Identity Manager は invoke メソッドを呼び出して、指定された形式 (MMddHHmmyy) に日付オブジェクトを変換します。
設定されていない場合は、AIX OS に設定されている現在の日付 (accounts[AIX].aix_expires) が表示されます。
<Field name='accounts[AIX].aix_expires'>
<Display class='Text'>
<Property name='title' value='Current Password
Expiration Date'/>
<Property name='noNewRow' value='true'/>
<Property name='readOnly' value='true'/>
<Property name='size' value='10'/>
</Display>
<Expansion>
<cond>
<notnull>
<ref>aix_account_expire</ref>
</notnull>
<invoke name='dateToString'
class='com.waveset.util.Util'>
<!-- dateToString メソッドの最初の引数は日付オブジェクトです -->
<ref>aix_account_expire</ref>
<!-- 2 番目の引数は、変換後の日付/文字列の形式です -->
<s>MMddHHmmyy</s>
</invoke>
<ref>accounts[AIX].aix_expires</ref>
</cond>
</Expansion>
</Field>
バックリンクの追加
ブラウザの「戻る」ボタンと同じように動作するコンポーネントを追加できます。このコンポーネントを使用することで、フォーム上の任意の場所にバックリンクを追加できます。
<Field name='back'>
<Display class='BackLink'>
<Property name='title' value='Back'/>
<Property name='value' value='previous page'/>
</Display>
</Field>
フォーム上のコンポーネントの位置
フォーム上でのコンポーネントの位置は、次の要因によって決定されます。
非表示コンポーネントの使用
多くのフォームはユーザーに表示されず、リソースアダプタを通じて外部リソースから取得したデータを、Identity Manager に渡す前に処理するために使用されます。表示されるフォームでも、一部のコンポーネントは非表示に設定できます。非表示コンポーネントは、この入力データの処理と、判読可能な形式へのデータ変換にも使用されます。
フォーム内の一部の非表示処理は、FormUtil Java クラス内のメソッドによって実行されます。これは、フォーム内のリストの情報を、外部リソースから動的に取得する場合に頻繁に使用されます。
ここでは、データを処理し、フォームで行われるその処理をオプションとして非表示に設定するタスクについて説明します。代表的なタスクには、次のものがあります。
Derivation 要素と Expansion 要素による XPRESS ロジックの追加
一般に、フィールドには Derivation 規則または Expansion 規則のいずれかが適用されます。フィールドに両方の規則が含まれる場合は、これらのフィールドが相互に競合しないことを確認してください。
XPRESS を使用してフォームフィールドの値を計算するときは、<Expansion> コンポーネントと <Derivation> コンポーネントを実装します。これらの式は、式が評価されるタイミングが異なるだけで、基本的には同じです。多くの場合、Derivation 規則は、フォームの読み込み時にフィールドの値を設定する場合に使用されます。Expansion 規則は、ページを再計算するとき、またはフォームを保存するときにフィールドの値を設定する場合に使用されます。
表 3-15 Derivation 式と Expansion 式
コンポーネント
説明
評価
<Derivation>
このフィールドの値として使用される任意の値を無条件で計算します。Derivation 式が評価されると、フィールドの現在値は常に置き換えられます。
Derivation 規則は、フォームが最初に読み込まれるとき、あるいは、1 つまたは複数のリソースからデータがフェッチされるときに実行されます。
<Expansion>
フィールドの値を無条件で計算します。
Expansion 規則は、ページを再計算するとき、またはフォームを保存するときに実行されます。
ユーザービュー以外のすべてのフォームでは、Expansion 規則は、ページを再計算するとき、またはフォームを保存するときに実行されます。ユーザービューでは、ユーザーフォームを最初に読み込むときにも <Expansion> タグが実行されます。
<Validation>
フォームに入力された値が有効であるかどうかを検証します。
Validation 規則は、フォームを送信するたびに評価されます。
<Derivation> ステートメントの例
次の 2 つの例は、Derivation 要素の使用例を示しています。
例 1:
最初の値が定義されている場合、次の例はその値を使用します。最初の値が定義されていない場合は、2 番目の値が使用されます。
<Derivation>
<or>
<ref>accounts[AD].fullname</ref>
<ref>accounts[LDAP].fullname</ref>
</or>
</Derivation>
例 2:
次の <Derivation> 要素の使用例は、条件ロジックを使用して、値のセットを別のセットにマップするフィールド定義を示します。
この例では、リソースアカウント属性 accounts[Oracle].locCode が、まず、case 要素 AUS に対して評価されます。結果が true となる場合は、返される値が 2 番目の値となり、location フィールドに表示されます。いずれの case 要素とも一致しない場合は、case 式のデフォルト値が返されます。case 式に含まれる最初の式で一致する略号が見つかった場合は、case 式に含まれる 2 番目の式の値が、switch 式の結果として返されます。
<Field name='location' prompt='Location'>
<Display class='Text'/>
<Derivation>
<switch>
<ref>accounts[Oracle].locCode</ref>
<case>
<s>AUS</s>
<s>Austin</s>
</case>
<case>
<s>HOU</s>
<s>Houston</s>
</case>
<case>
<s>DAL</s>
<s>Dallas</s>
</case>
<case default='true'>
<s>unknown</s>
</case>
</switch>
</Derivation>
</Field>
<Expansion> ステートメントの例
次の 2 つの例は、Expansion 要素の使用例を示しています。
例 1:
Expansion 規則は、フィールドに入力された情報を、リソース側で前提とされる形式、または規則によって指定される形式と一致する値に変換します。たとえば、ユーザーが名前を入力する自由形式のテキストボックスに Expansion 規則を含め、頭文字を大文字、残りの文字を小文字にそろえることができます。
フィールドでグローバル変数を使用すると、フォームの保存時に、この値を持つすべてのリソースが設定されます。このフォームを読み込むと、Identity Manager は各リソースから値を取り込みます (フィールドが無効化されている場合を除く)。最後のリソースの読み込みによって、フォームの値が設定されます。ユーザーがローカルに変更を加えた場合は、その変更は表示されない可能性があります。このため、フィールドの信頼できるソースとして 1 つまたは複数のリソースを指定する Derivation 規則を使用することで、正しい値を確実に属性に適用することができます。
<Field name='global.lastname'>
<Display class='Text'>
<Property name='title' value='Last Name'/>
<Property name='size' value='32'/>
<Property name='maxLength' value='128'/>
<Property name='noNewRow' value='true'/>
<Property name='required'>
<Boolean>false</Boolean>
</Property>
</Display>
<Expansion>
<block>
<defvar name='lname'>
<downcase>
<ref>global.lastname</ref>
</downcase>
</defvar>
<defvar name='nlength'>
<sub>
<length>
<ref>global.lastname</ref>
</length>
<s>1</s>
</sub>
</defvar>
<concat>
<substr>
<upcase>
<ref>global.lastname</ref>
</upcase>
<s>0</s>
<s>1</s>
</substr>
<substr>
<ref>lname</ref>
<s>1</s>
<ref>nlength</ref>
</substr>
</concat>
</block>
</Expansion>
</Field>
この XPRESS ロジックが複数のフィールドに実装される場合は、それを規則に含めることを検討してください。
例 2:
次の例には Display クラス定義が含まれないため、このフィールドは非表示にも設定されます。Display クラス定義を取り除くことで、フィールドはフォームに表示されなくなります。ただし、フィールドは依然としてフォームのアクティブ部分と見なされ、<Expansion> 式を利用してリソース属性の値を生成します。
<Field name='accounts[Oracle].locCode'>
<Expansion>
<switch>
<ref>location</ref>
<case>
<s>Austin</s>
<s>AUS</s>
</case>
<case>
<s>Houston</s>
<s>HOU</s>
</case>
<case>
<s>Dallas</s>
<s>DAL</s>
</case>
</switch>
</Expansion>
</Field>
この例では、location フィールドによるマッピングとは逆のマッピングが行われます。
<Validation> ステートメントの例
Validation 式を使用することで、フォームに入力した値が有効であるかどうかを判断するためのロジックを指定できます。
Validation 式は、成功を示す場合は NULL を返し、失敗を示す場合は判読可能なエラーメッセージを含む文字列を返します。Validation 式のエラーメッセージは、フォーム最上部に赤のテキストで表示されます。
次の例には、ユーザーがフィールドに入力した年齢の値が、0 より大きいことを確認するロジックが含まれます。入力された年齢が 0 より大きいか、または 0 である場合、この式は NULL を返します。
<Field name='age'>
<Validation>
<cond>
<lt>
<ref>age</ref>
<i>0</i>
</lt>
<s>Age may not be less than zero.</s>
</cond>
</Validation>
</Field>
メソッドの呼び出しによるリストへのデータの取り込み
単一選択リストと複数選択リストのテキストボックスには、外部リソースから取得した情報が取り込まれることがよくあります。Sun でサポートされるいずれかの FormUtil メソッドを呼び出すことで、この情報を動的にリストに取り込むことができます。これらの一般的なメソッドは、次のタスクを実行できます。
<Select> コンポーネントと <MultiSelect> コンポーネント、および allowedValues プロパティーについては、「リストデータの取り込み」の節を参照してください。
リソースオブジェクトの名前について
リソース上の情報を検索または要求し、Identity Manager にインポートするには、Identity Manager がサポートするオブジェクト定義を使用する必要があります。
次の表は、Identity Manager でサポートされるオブジェクトタイプを示しています。
表 3-16
サポートされるオブジェクトタイプ
説明
account
ユーザーアカウント ID のリスト
Administrator_Groups
ユーザーが所属できる管理者グループの名前
Applications
アプリケーションのリスト
Distribution Lists
電子メール配信エイリアスのリスト
Entitlements
PKI 権利書のリスト
group
セキュリティーオブジェクトと配信リストグループオブジェクトのリスト
Group
セキュリティーグループ
groupofNames
Exchange 5.5 用の電子メール配信エイリアスのリスト
Nodes
SP2 ノードのリスト
PostOffices
GroupWise ポストオフィスのリスト
profile
トップシークレットプロファイルのリスト
PROFILE
DBA_PROFILES テーブルからの Oracle プロファイルのリスト
ROLE
DBA_ROLES テーブルからの Oracle ロールのリスト
shell
使用できる UNIX シェルのリスト
Template
NDS テンプレートのリスト
USERS
DBA_USERS テーブルからの Oracle プロファイルのリスト
UnassignedTokens
使用できる未割り当てトークンのリスト
User_Properties
ユーザープロパティー定義 (ユーザーに設定できるプロパティー) のリスト
リソースオブジェクト名のリストの取得
使用している特定のリソースに定義されたオブジェクト名のリストを取得するときは、listResourceObjects メソッドを使用します。マップオプションを持つ、または持たないリストを取得できます。マップオプションは、完全なリストを返す代わりに、返される値をフィルタリングして 1 つのコンテナに集約できるディレクトリ構造を持つリソースのみで使用されます。
サーバーのキャッシュからではなく、必ずリソースからリソースオブジェクトリストを取得するには、まず、clearResourceObjectListCache() メソッドを呼び出すか、cacheList 引数を false に設定します。ただし、大規模なリストでは、キャッシュを使用するほうがパフォーマンスが向上します。リソースへのアクセスは 1 回のみで、結果はキャッシュに格納されます。このため、キャッシュを利用することをお勧めします。
また、オブジェクトリストの要求対象となるリソースを指定する、キーと文字列値の 1 つまたは複数のペアのセットを指定することもできます。
次の表は、各リソースでサポートされるオブジェクトタイプを示しています。
表 3-17 サポートされるオブジェクトタイプ
リソース
サポートされるオブジェクトタイプ
AIX
account、Group
ACF2
account
ClearTrust
account、Group、group、Administrator_Groups、Applications、Entitlements、User_Properties
Entrust
Group、Role
Exchange5.5
groupofNames
GroupWise
account、Distribution Lists、PostOffices
HP-UX
account、Group、shell
LDAP
account、Group
Oracle
USERS、ROLE、PROFILE
Natural
account、Group
NDS
account、Group
PeopleSoft
account
RACF
account、Group
SAP
account、table、profiles、activitygroups
SecurID
UnassignedTokens
SP2
Nodes
Solaris
account、Group、shell
TopSecret
account
VMS
account
Windows Active Directory
account、Group
Active Directory のどの有効オブジェクトクラス名も、オブジェクトタイプとして指定できます (オブジェクトクラス名のリストは Active Directory スキーマドキュメントに記載されている)。返されるリストには、オブジェクトの識別名が含まれます。デフォルトでは、メソッドは、Container リソース属性によって指定されるコンテナを検索します。ただし、listResourceObjects の呼び出し時のオプションとして、コンテナを指定することができます。その名前は、コンテナの識別名としてください。この場合、そのコンテナに含まれるオブジェクトの名前のみがリストに取得されます。
Windows NT
account、Group
マップオプションを持たないリソースオブジェクトのリストの取得
マップオプションを持たないリソースオブジェクトのリストを取得するには、リソースオブジェクトのタイプとリソース名を指定します。一部のリソースは、リストのサブセットでの機能をサポートすることに注意してください。これは、開始ディレクトリを指定することで実行できます。
次の例の詳細は次のとおりです。
- <UnassignedTokens> という文字列は、取得するリソースのオブジェクトタイプを表します。一般的なリソースオブジェクトタイプには、これ以外にも groups、distribution lists、および accounts があります。
- <SecurID> という文字列は、オブジェクトタイプの取得元リソースを表します。
- null という値は、マップオプションを含めないことを表します。
- true という値は、結果をキャッシュに格納することをサーバーに伝えます。
<invoke name='listResourceObjects'
class='com.waveset.ui.FormUtil'>
<ref>:display.session</ref>
<s>UnassignedTokens</s>
<s>SecurID</s>
<null/>
<s>false</s>
</invoke>
マップオプションを持つリソースオブジェクトのリストの取得
マップオプションを持つリソースオブジェクトのリストを取得するには、リソースオブジェクトのタイプ、リソース名、および検索を開始するディレクトリを表すマップオプションを指定します。リソースは、ディレクトリベースで指定してください。
たとえば、Software Access ディレクトリ内のすべての Active Directory グループのリストを取得するには、指定したディレクトリパス (ou=Software Access, dc=mydomain, dc=com) で検索を行うマップオプションを作成します。
例:
次の例の詳細は次のとおりです。
DN 文字列の作成
指定したユーザー ID とベースコンテキストから、識別名のリスト、または単一の識別名を動的に作成できます。このメソッドでは、リストは返されません。通常は、Expansion 規則で使用されます。
DN 文字列のリストの動的な作成
ユーザー ID とベースコンテキストを指定して、DN 文字列のリストを動的に作成することができます。
次の例は、ユーザー ID とベースコンテキストを使用して DN 文字列のリストを動的に作成する方法を示しています。
次のコードでは、まず、ユーザーに追加するベースコンテキストが定義されます。
<Field name='baseMemberContextContractor'>
<Default>
<s>ou=Contractors,dc=example,dc=com</s>
</Default>
</Field>
<Field name='baseMemberContextEmployee'>
<Default>
<s>ou=Employees,dc=example,dc=com</s>
</Default>
</Field>
このフォームのユーザーは、次のフィールドにデータを入力します。多くの場合、これは、動的に生成したユーザー ID のリストの格納場所を表します。
<Field name='userIds'>
<Display class='TextArea'>
<Property name='title' value='UserIds'/>
</Display>
</Field>
次の非表示フィールドには、値を計算するロジックが含まれます。
<Field name='Members'>
<Expansion>
<switch>
// ユーザーに割り当てられているロールを参照します
<ref>waveset.role</ref>
<case>
// ユーザーに "Contractor ロール" が割り当てられている場合に、次の
ような DN を生成します:// ex: CN=jsmith,ou=Contractors,dc=example,dc=com
<s>Contractor Role</s>
<invoke name='buildDns' class='com.waveset.ui.FormUtil'>
<ref>userId</ref>
<ref>baseMemberContextContractor</ref>
</invoke>
</case>
<case>
// また、ユーザーに "Employee ロール" が割り当てられている場合は、次の
ような DN を生成します:// ex: CN=jdoe,ou=Employees,dc=example,dc=com
s>Employee Role</s>
<invoke name='buildDns' class='com.waveset.ui.FormUtil'>
<ref>userId</ref>
<ref>baseMemberContextEmployee</ref>
</invoke>
</case>
</switch>
</Expansion>
</Field>
単一 DN 文字列の作成
1 つの DN を指定して、リストまたはテキストエリアにデータを取り込む buildDn メソッドを呼び出すことができます。次に例を示します。
<invoke name='buildDn' class='com.waveset.ui.FormUtil'>
<s>jdoe</s>
<s>dc=example,dc=com</s>
</invoke>
この例は、CN=jdoe,dc=example,dc=com という文字列を返します。
未割り当てリソースのリストの取得
指定したユーザー ID には表示する権限はあるが、現時点では割り当てられていないすべてのリソースのリストを取得するときは、getUnassignedResources メソッドを使用します。
<ref> ステートメントは、指定したユーザーに関する情報を持つビュー属性を表します。次に例を示します。
<invoke name='getUnassignedResources' class='com.waveset.ui.FormUtil'>
<ref>:display.session</ref>
<ref>waveset.role</ref>
<ref>waveset.original.resources</ref>
</invoke>
アクセス可能なオブジェクトタイプのリストの取得
セッション所有者が現時点でアクセスできるオブジェクトタイプのリストを取得するときは、getObjectNames メソッドを使用します。
検索できるオブジェクトタイプは次のとおりです。
すべてのオブジェクトタイプのリストは、「デバッグ」ページの「List Objects」オプションで表示できます。次に例を示します。
<invoke name='getObjectNames' class='com.waveset.ui.FormUtil'>
<ref>:display.session</ref>
<s>UserForm</s>
</invoke>
セッション所有者がアクセスできるオブジェクトタイプのリストの取得
セッション所有者がアクセスできるオブジェクト名のリストを取得するときは、getObjectNames メソッドを使用します。次に例を示します。
<invoke name='getObjectNames' class='com.waveset.ui.FormUtil'>
<ref>:display.session</ref>
</invoke>
プレフィックスを持つ組織のリストの取得
プレフィックス (たとえば、TOP, TOP:IT, TOP:HR) を持つ組織のリストを取得するときは、getOrganizationsWithPrefixes メソッドを使用します。次に例を示します。
<invoke name='getOrganizationsWithPrefixes'
class='com.waveset.ui.FormUtil'>
<ref>:display.session</ref>
</invoke>
プレフィックスを持たない組織のリストの取得
プレフィックス (たとえば、TOP, TOP, TOP) を持たない組織のリストを取得するときは、getOrganizations メソッドを使用します。次に例を示します。
<invoke name='getOrganizations'
class='com.waveset.ui.FormUtil'>
<ref>:display.session</ref>
</invoke>
プレフィックスを持つ組織表示名のリストの取得
プレフィックスを持つ組織表示名のリストを取得するときは、getOrganizationsDisplayNamesWithPrefixes メソッドを使用します。
<invoke name='getOrganizationsDisplayNamesWithPrefixes'
class='com.waveset.ui.FormUtil'>
<ref>:display.session</ref>
</invoke>
ユーザーに割り当てられていないアプリケーションのリストの取得
現時点でユーザーに割り当てられていないアプリケーションのリストを取得するときは、getUnassignedApplication メソッドを使用します。次に例を示します。
<invoke name='getUnassignedApplications' class='com.waveset.ui.FormUtil'>
<ref>:display.session</ref>
<ref>waveset.roles</ref>
<ref>waveset.original.applications</ref>
</invoke>
ハッシュマップの作成
listResourceObjects メソッドと callResourceMethods メソッドは、ハッシュマップを受け付けます。ハッシュマップは、<Map> 要素を使用して作成できます。
次の例の <Map> 要素は、変更されない制的なマップを作成します。
<Map>
<MapEntry name='key1' value='value1'/>
<MapEntry name='key2' value='value2'/>
</Map>
<map> 要素を使用して、XPRESS 式でマップを作成することもできます。<map> 要素は、コンテンツが別の式によって定義されるマップを動的に作成することができます。
XPRESS 言語によるマップの作成については、「XPRESS 言語」を参照してください。
フィールドの無効化
フィールドを無効にすると、フィールドと、その入れ子フィールドはページに表示されなくなります。また、値の式も評価されません。無効化されたフィールドの値がすでにビューに含まれる場合、その値は変更されません。
<Disable></Disable>
注
global.* 属性は、有効なフィールドのみから取得されます。フォームがフィールドを非表示にするのではなく、動的に無効にする場合は、global.* 属性を使用して、そのフィールドの値を取得することはできません。
例:
<Disable>
<eq><ref>userExists</ref><s>true</s></eq>
</Disable>
注
Disable 式は、その他の式よりも頻繁に評価されます。このため、Disable 式は、比較的単純に記述してください。データベースのルックアップのように、負荷の大きい処理を実行する Java クラスは呼び出さないようにしてください。
フィールドの非表示
フィールドを非表示に設定すると、フィールドと、その入れ子フィールドはページに表示されなくなります。ただし、フォームの処理によって、フィールドの値は設定されます。
フィールドを非表示にするには、表示しない特定のフィールドの Display プロパティーを定義しません (これは条件に依存しない)。
<Field name='field A'/>
値の計算
フォーム内での動的な値の計算には、次の方法があります。
フィールド値の生成
一部のフォームでは、最初は抽象的な導出フィールドのセットをユーザーに表示し、その後のフォームの送信時に、リソースアカウントの実際の属性値のさまざまなセットを生成することが必要となる場合があります。これは、フォームの展開と呼ばれます。展開されたフィールドは、よく導出フィールドと組み合わせて使用されます。
フォーム内での規則の使用
フォームでは、通常、allowedValues 表示プロパティーを計算する規則を呼び出したり、<Disable> 式の中でフィールドの可視性を制御したりします。フォーム内で次の項目を格納および再利用するもっとも効率的なメカニズムは、規則の使用であると考えられます。
規則の詳細については、『Identity Manager 配備ツール』の「規則」の章を参照してください。
XPRESS ステートメントの使用
XPRESS 言語は、式とスクリプトを記述するための XML ベースの言語です。この言語で記述されたステートメントは式と呼ばれ、フォームにデータ変換機能を追加したり、ワークフローやフォームなどの Identity Manager オブジェクトに状態遷移ロジックを組み込んだりするために、Identity Manager 全体で使用されます。
XPRESS は、XML に基づいた構文を使用する関数言語です。この言語で記述されるすべてのステートメントは、0 個以上の引数をとる関数を呼び出し、値を返します。製品には関数が組み込まれていますが、新しい関数を定義することもできます。XPRESS は、任意の Java クラスでのメソッドの呼び出しと、式に含まれる Javascript の評価もサポートします。
XPRESS の機能の詳細については、「XPRESS 言語」を参照してください。
XPRESS を使用する理由
式は、主に次の Identity Manager タスクに使用されます。
これらの要素に含まれる式は、Identity Manager 全体で使用できます。
式の例
次の例の <add> 要素は、add という XPRESS 関数の呼び出しを表します。
<add> <ref>counter</ref> <i>10</i> </add>
この関数には、2 つの引数が渡されます。
add 関数から返される値は、counter 変数の現在値に整数 10 を加えた結果となります。すべての関数呼び出しは、次の処理で使用される値を返します。たとえば、ref の呼び出しによってカウンタの値が得られると、<i> 呼び出しは整数 10 を返し、<add> 呼び出しは 2 つの呼び出しの結果を合計します。
フォームに組み込まれた式の例
次の例は、Identity Manager フォームに組み込まれた XPRESS ロジックの使用例を示しています。XPRESS は、ブラウザに表示するロール関連の選択項目を生成するいずれかの FormUtil Java メソッドの呼び出しに使用されています。式全体が <expression> というタグに囲まれていることに注目してください。
<Field name='waveset.role'>
<Display class='Select' action='true'>
<Property name='title' value='Role'/>
<Property name='nullLabel' value='None'/>
<Property name='allowedValues'>
<expression>
<invoke class='com.waveset.ui.FormUtil' name='getRoles'>
<ref>:display.session</ref>
<ref>waveset.original.role</ref>
</invoke>
</expression>
</Property>
</Display>
</Field>
フォームへのガイダンスヘルプの追加
Identity Manager には、次の 2 種類のオンラインヘルプが用意されています。
コンポーネントにガイダンスヘルプを指定する方法
ガイダンスヘルプのテキストは、どのコンポーネントにも関連付けることができます。ただし、現時点では、表示に EditForm コンテナが必要です。ガイダンスヘルプのテキストは、次の 3 つの方法で指定できます。
- help プロパティーを使用して、コンポーネントに明示的に割り当てます。「help プロパティーの使用」の節を参照してください。
- ヘルプカタログ内のエントリを参照する helpKey プロパティーを使用して、コンポーネントに間接的に割り当てます。「helpKey プロパティーの使用」の節を参照してください。
- コンポーネントの title プロパティーとヘルプカタログ内のエントリを一致させることで、コンポーネントに間接的に割り当てます。「コンポーネントの title プロパティーとヘルプエントリの一致」の節を参照してください。
help プロパティーの使用
ガイダンステキストを指定するもっとも簡単な方法は、help プロパティーの使用です。XML フォームの使用時は、これは、大容量である可能性もある XML にヘルプテキストを組み込むことを意味し、この場合、ヘルプテキストの表示と編集は比較的困難になります。これに代わる方法として、ヘルプカタログにヘルプテキストを保存し、コンポーネントからカタログ内のエントリを参照する方法があります。
helpKey プロパティーの使用
ヘルプカタログ内の各エントリは、一意の名前またはキーを持ちます。これを利用し、helpKey プロパティーを設定して、コンポーネントからカタログエントリを参照することができます。この設定を行うと、システムはこの値が現在のヘルプカタログ内のキーの値であるものと見なし、コンポーネントを表示するときに関連ヘルプテキストを読み込みます。
コンポーネントの title プロパティーとヘルプエントリの一致
コンポーネントのタイトルと一致する、ヘルプカタログ内のキーの値を使用して、カタログエントリをコンポーネントに自動的に関連付けることもできます。XML フォームの使用時は、Property 要素を使用して、コンポーネントのタイトルを明示的に指定できます。このプロパティーが設定されていない場合は、Field 要素に含まれる prompt 属性の値が適用されます。
Identity Manager によるヘルプリソースの評価
コンポーネントを表示するとき、システムはまず、help プロパティーが設定されているかどうかを調べます。設定されている場合は、そのテキストが使用されます。次に、helpKey が設定されているかどうかを調べ、キーを利用してエントリのカタログを検索します。helpKey プロパティーが設定されていない、または、一致するキーがカタログに見つからない場合は、システムは、コンポーネントのタイトルをヘルプキーとして検索を再試行します。
ヘルプカタログの使用方法
ヘルプカタログは、XML テキストが記録されたファイルです。特定のコンポーネントで使用されるヘルプカタログは、次のように決定されます。
- ページプロセッサシステムは、HTML を生成する前に、HtmlPage オブジェクトの helpCatalog プロパティーにカタログ名を割り当てることで、そのカタログを指定できます。
- helpCatalog プロパティーの値が設定されていない場合は、HtmlPage は要求 URL に基づく命名規則を利用してカタログの特定を試みます。HtmlPage は、URL (通常は .jsp ページの URL) を調べ、ベースコンテキストの先頭の trailing.jsp を削除します。次に、残りの URL の先頭には Identity Manager のインストールディレクトリ、末尾には -help.xml を追加します。
XML フォームの設計者は、フォームプロセッサシステムを利用して、適切なカタログを自動的に特定できます。しかし、使用するカタログファイルを、より明示的に制御することが必要となる場合もあります。フォームで使用されるヘルプカタログは、Form 要素の help 属性で指定できます。たとえば、次のようにします。
<Form name='Task Launch Form' help='task/common-help.xml'>
...
</Form>
これは、それぞれが異なる要求 URL で参照される複数のフォーム間で 1 つのヘルプカタログを共有する場合に便利です。
ヘルプカタログの構文
ヘルプカタログファイルの構文は、比較的簡単です。これには、1 つまたは複数の Page 要素を持つドキュメント要素、WebHelp を使用します。これらの Page 要素には、1 つまたは複数の Item 要素が含まれます。それぞれの Item 要素は、ヘルプテキストのカタログキーを表す key 属性を持ちます。Item 要素の内容は、ヘルプテキストです。
ヘルプカタログの構文を利用することで複数の Page 要素を指定できますが、現時点では、複数の要素をサポートするページプロセッサシステムは存在しません。
簡単なヘルプカタログファイルの例
次に、簡単なヘルプカタログファイルの例を示します。
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE WebHelp>
<WebHelp>
<Page name='user/changeAll.jsp'>
<Item key='Account Information'>
Miscellaneous information about your accounts.
</Item>
<Item key='Passwords'>
<![CDATA[
<b>Passwords</b><br>Enter and confirm a new password.
]]>
</Item>
</Page>
</WebHelp>
Item 要素へのヘルプテキストの指定
Item 要素には、次の 2 つの方法でヘルプテキストを指定できます。
- 単純なテキストを指定します。単純なテキストを指定するときは、前述の例の Account Information のように、Item タグの間にテキストを入力します。ブラウザは、ヘルプテキストの先頭および末尾に含まれる改行文字を削除します。
- HTML マークアップをヘルプテキストに組み込むことで、フォントを指定したり、改行を挿入したりします。この方法では、XML が呼び出す CDATA というマークが付けられたセクションのテキスト (前述の例の Passwords を参照) をより柔軟に囲むことができます。「CDATA」というテキストは、ヘルプテキストの一部ではありません。これは、内容を解析対象外文字データとして処理するようにパーサーに指示する、特別な XML 宣言です。この場合、マークが付けられたセクションに含まれる <b> などの要素は、XML 要素としてではなく、リテラルテキストとして解釈されます。
CDATA のマークが付けられたセクションを使用しない場合は、次の例のように、ヘルプテキスト中の右開き不等号を代替文字列 < で表記しなければなりません。
<b>Passwords</b><br>Enter and confirm a new password.
ガイダンスヘルプの優先指定
カスタムメッセージカタログを使用して、ポップアップウィンドウに表示されるガイダンステキストを優先指定できます。カスタムメッセージカタログに defaultCustomCatalog という名前を付けると、Identity Manager はこれを認識し、このカタログを自動的に使用します。また、別のカタログ名を付け、customMessageCatalog という属性名の後に、System Configuration オブジェクトの値としてそのカタログ名を指定することもできます。
たとえば、次のようにします。
<Attribute name='customMessageCatalog' value= 'sampleCustomCatalog' />
次に示すカスタムカタログの例は、「ヘルプ」タブの吹き出しテキストとして「Waveset Lighthouse 4.1 SP2」と表示します。
<Waveset>
<Configuration name="sampleCustomCatalog">
<Extension>
<CustomCatalog id="defaultCustomCatalog" enabled="true">
<MessageSet language="en" country="US">
<Msg id="UI_END_USER_VERSION">Waveset Lighthouse 4.1 SP2</Msg>
</MessageSet>
<MessageSet language="es" country="ES" variant= "Traditional">
<Msg id="UI_END_USER_VERSION">Sun Lighthouse 4.1 SP2</Msg>
</MessageSet>
<MessageSet language="fr">
<Msg id="UI_END_USER_VERSION">Waveset Lighthouse 4.1 SP2</Msg>
</MessageSet>
</CustomCatalog>
</Extension>
</Configuration>
</Waveset>
フォームに関連するその他のタスク
フォーム関連では、ほかに次のようなタスクがあります。
FormUtil メソッドの呼び出し
FormUtil クラスは、フォームオブジェクトを使用して XPRESS 式から呼び出せるユーティリティーメソッドの集合です。これは、許可される値のリストへの取り込みと、入力の検証に使用できます。一般に、FormUtil メソッドは、リストまたはフィールドの許可される値の定義を支援するために呼び出されます。
これらのメソッドの一覧と説明については、「FormUtil メソッド」を参照してください。
<invoke class = 'com.waveset.ui.FormUtil'
name = 'listResourceObjects'>
</invoke>
この name フィールドは、メソッドの名前を表します。
フォーム内でのこれらのメソッドの使用例については、「非表示コンポーネントの使用」の節を参照してください。
フォームへの JavaScript の挿入
事前にフォーマットされた Javascript をフォームに挿入するとき、特に、コンポーネントの onClick または onChange プロパティーを使用し、カスタム Javascript 機能を使用するときは、<JavaScript> コンポーネントを使用します。
コンポーネントには、JavaScript テキストを格納できる script という拡張プロパティーがあります。
これとは別に、ソースプロパティーを設定して JavaScript を含めることもできます。これは、ベースコンテキストに関連する URL フラグメントを含んだ文字列です。指定されたファイルに含まれる JavaScript が、ブラウザに読み込まれます。
オブジェクトまたはユーザーの存在確認
アクションを実行する前に、オブジェクトの存在を確認できると便利かもしれません。たとえば、新規ユーザーを作成したり、フィールドに入力したマネージャー名が有効であることを確認したりする前に、ユーザー名が Identity Manager に存在するかどうかを確認できます。
オブジェクトの存在を確認するときは、testObject メソッドを使用します。このメソッドの使用時にオブジェクトタイプを指定するときは、SectionTitle&Page#の節に記載されているオブジェクトタイプを使用してください。次の例では、<s>User</s> というユーザータイプが指定されています。2 番目の文字列は、オブジェクトタイプの値 (この例では jdoe) を指定します。
例:
<invoke name='testObject' class='com.waveset.ui.FormUtil'>
<ref>:display.session</ref>
<s>User:</s>
<s>jdoe</s>
</invoke>
オブジェクトが検出されると、testObject メソッドは true を返します。検出に失敗した場合は、NULL が返されます。
ユーザーの存在を確認するときは、testUser メソッドを使用します。検索するユーザーオブジェクトの名前は、<s> 要素で指定されます。次に例を示します。
<invoke name='testUser' class='com.waveset.ui.FormUtil'>
<ref>:display.session</ref>
<s>jdoe</s>
</invoke>
検出に成功した場合は、true が返されます。検出に失敗した場合は、NULL が返されます。
ウィザードフォームとタブ付きフォーム
ウィザードフォームとタブ付きフォームはどちらも、扱いにくい単一ページのフォームを、管理がより容易な、複数ペインのフォームに変えるメカニズムです。どちらのフォームも、論理セクションまたはページの間にセパレータを持ちます。これらのページセパレータは、Tabbed User Form のようにフォームの上部に配置されるタブである場合と、前後のページに移動するためのナビゲーションボタンを利用してページを切り替えながらユーザーに操作を促すウィザードである場合があります。
デフォルトの Tabbed User Form の XML バージョンについては、この章の「Tabbed User Form」を参照してください。
ウィザードフォームとは
次のような場合は、タスクから複数のフォームを呼び出すよりも、ウィザードフォームを使用するほうが便利です。
ウィザードフォームには、次に説明する 2 つのボタン行があります。
表 3-18 最初のボタン行
ボタン行
説明
上の行
フォームペインを切り替えるための「次へ」および「戻る」ボタン
次の行
次の表に示される、標準のユーザーフォームボタン。この行は、noDefaultButtons オプションを true に設定して、独自のボタンを実装することで制御できます。
2 番目のボタン行は、次のように異なります。
表 3-19 2 番目のボタン行
ウィザードのページ
デフォルトボタン
最初のページ
「次へ」、「キャンセル」
中間のページ
「戻る」、「次へ」、「キャンセル」
最後のページ
「戻る」、「OK」、「キャンセル」
ウィザードフォームの実装
ウィザードフォームの構文は、Tabbed User Form の構造によく似ています。ウィザードフォームを作成する方法は次のとおりです。
次の例には、説明のためのコメントが含まれます。
<Form>
<Display class="HtmlPage"/> ----- これを設定しないと、インデントと色に問題 が生じます
…
<Field name='MainTabs'> -- タブページを格納した最上位コンテナの名前
<Display class='TabPanel'/> -- 最上位コンテナの表示クラス、TabPanel ま たは WizardPanel のいずれか
<Field name='Identity'> -- タブのラベル
<Display class='EditForm'> -- 各 "ページ" は編集フォームである必要があ ります
<Property name='helpKey' value='Identity and Password Fields'/>
</Display>
<Field name='waveset.accountId'>
<Display class='Text'>
<Property name='title' value='_FM_ACCOUNT_ID'/>
</Display>
<Disable> <ref>waveset.id</ref> </Disable>
</Field>
…
</Field>
…
</Field>
ヒントおよび対策
- 検証エラーは、属性が表示されるページではなく、ユーザーが最後に表示したページに表示されます。これに対応するには、適切なページに戻るように促すように、検証メッセージに説明を追加します。
- 複雑なウィザードでは、プロセス全体のどの段階にいるかを視覚的にユーザーに表示してください。各ページの上部に表示されるラベルまたはセクション見出しを使用して、「ページ 1」のようなテキストを表示します。
- ウィザードフォームでは、条件付きナビゲーションを使用しないでください。この機能の実装が必要なときは、WizardPanel の直下にある各子要素の Disable 式を使用します。たとえば、次のようにします。
<Field name='Page2'>
<Display class='EditForm'/>
<Disable><neq><ref>showPage2</ref><s>true</s></neq></Disable>
...
</Field>
- フィールドやボタンは、ゲート変数を設定する、直前のページに配置します。無効化されたページは、遷移ロジックから自動的に削除されます。
デフォルトのユーザー作成フォームとユーザー編集フォームの代替フォーム
管理者がデフォルトのユーザーフォームを使用してユーザーを編集する場合、管理者がユーザーアカウントの編集を開始するのと同時に、そのユーザーが所有するすべてのリソースがフェッチされます。ユーザーが多くのリソースにアカウントを持つ場合、この処理に時間がかかる可能性があり、パフォーマンスを低下させかねません。このような環境に Identity Manager を配備したときは、デフォルトのユーザー作成インタフェースやユーザー編集インタフェースの代わりに、スケーラブルフォームを使用してみてください。
スケーラブルフォームの概要
スケーラブルフォームは、ユーザー数とリソース数が多い環境で、Identity Manager のユーザー作成インタフェースとユーザー編集インタフェースのパフォーマンスを改善するようにカスタマイズされたフォームです。パフォーマンスの改善は、次のような機能によるものです。
Identity Manager には、デフォルトのユーザー編集フォームとユーザー作成フォームのスケーラブルバージョンが用意されています。
リソースの差分フェッチ
リソースの差分フェッチは、ネットワーク接続などの方法で、Identity Manager サーバーがリソースから直接、情報を取得する手段の 1 つです。管理者がデフォルトのユーザーフォームを使用してユーザーを編集する場合、通常は、管理者がユーザーアカウントの編集を開始するのと同時に、そのユーザーが所有するすべてのリソースがフェッチされます。これに対し、スケーラブルフォームの設計に込められた目的は、管理者が表示または変更するリソースのみをフェッチすることで、フェッチに制限をかけることです。
選択的な参照
選択的な参照は、スケーラブルフォームに組み込まれたもう 1 つの機能です。管理者は、所有ロール、リソースタイプ、またはリソースリストに基づいて、リソースを差分表示できます。
複数リソースの編集
複数リソースの編集により、管理者はリソースのサブセットを選択してリソース属性を編集できます。管理者は、ロール、リソースタイプ、またはリソースリストに基づいてサブセットを選択できます。
スケーラブルフォームの使用
次のようなケースでは、スケーラブルフォームの使用を検討してください。
別のリソースを参照する属性がフォームロジックに含まれる場合は、スケーラブルフォームを使用しないでください。この設定では、対象リソースをまとめてフェッチしない限り、このような相互参照属性に最新データが取り込まれません。
新規ユーザーは、最初はリソースを持たないため、ユーザー作成フォームのスケーラブルバージョンには、限定的ではありますが、標準のデフォルトバージョンに対してメリットがあります。
使用できるスケーラブルフォーム
Identity Manager には、次の 2 つのスケーラブルユーザーフォームが用意されています。各フォームについては後述します。
Dynamic Tabbed User Form
管理者が編集を開始するのと同時にすべてのリソースをフェッチする、デフォルトのTabbed User Form の代替フォームです。Dynamic Tabbed User Form には、差分フェッチ機能と、リソースタイプに基づいて複数のリソースを編集する機能が用意されています。
フォームのインポートとマッピング
Dynamic Tabbed User Form によるデフォルトの Tabbed User Form の代用には、次の 3 つのフォームが関連します。
表 3-20 Dynamic Tabbed User Form と関連するフォーム
フォーム
説明
Dynamic Tabbed User Form
デフォルトの Tabbed User Form の機能を持ちますが、リソースタイプごとに 1 つのタブを動的に作成します。
動的ユーザーフォーム
ユーザーフォームのリソースタイプタブを作成するためのフィールドを持ちます。
動的フォームの規則ライブラリ
指定されたユーザーフォームを持たないリソースの属性を動的に出力するための規則ライブラリを持ちます。
動的リソースフォーム
現時点で Dynamic Tabbed User Form との互換性を持つすべてのフォームを持ちます。ユーザーは、このリストをカスタマイズできます。
Dynamic Tabbed User Form のインストールは、フォームのインポートと、フォームマッピングの変更という 2 段階で行われます。
手順 1: フォームのインポート
手順 2: フォームマッピングの変更
ユーザーフォームをエンドユーザーに割り当てるには、2 つの方法があります。これらのフォームマッピングを編集する方法は、実際の環境で管理者がこれらのフォームをどのように使用するかによって異なります。次の方法があります。
- すべての管理者のデフォルトユーザーフォームとしてスケーラブルユーザーフォームを割り当てる。この方法で割り当てるときは、「デフォルトユーザーフォームとしてのスケーラブルユーザーフォームの割り当て」を参照してください。Identity Manager の管理者は、すべての管理者が使用する 1 つのフォームを割り当てることができます。
- 特定の管理者に、個別にスケーラブルユーザーフォームを割り当てる。この方法で割り当てるときは、「管理者ごとのスケーラブルユーザーフォームの割り当て」を参照してください。
デフォルトユーザーフォームとしてのスケーラブルユーザーフォームの割り当て
管理者ごとのスケーラブルユーザーフォームの割り当て
リソーステーブルユーザーフォーム
リソーステーブルユーザーフォームには、ユーザー編集フォームのスケーラブルバージョンのほとんどの駆動ロジックが含まれます。このフォームは、差分フェッチ機能と、リソースタイプに基づいて複数リソースを編集する機能を実装します。
実装の詳細については、WSHOME/samples/resourcetableformsinit.xml に記載されているコメントを参照してください。
フォームのインポートとマッピング
リソーステーブルユーザーフォームによるデフォルトの Tabbed User Form の代用には、次の 5 つフォームが関連します。
表 3-21 リソーステーブルユーザーフォームと関連するフォーム
フォーム
説明
リソーステーブルユーザーフォーム
ナビゲーション、差分フェッチ、およびフォームのレイアウトに使用される、グローバルに利用できるすべてのフィールドを持ちます。リソース関連のその他すべてのスケーラブルフォームは、このメインフォームによって駆動されます。
リソーステーブルユーザーフォームライブラリ
リソーステーブルユーザーフォームのプライマリフィールドを持ちます。ブレッドクラムフィールドとナビゲーションフィールドが含まれます。
リソーステーブルアカウント情報フォーム
リソーステーブルフォームのアカウント情報セクションのフィールドを持ちます。
リソーステーブル規則ライブラリ
ユーザーのリソースの取得、カウント、分析に適用される規則ライブラリを持ちます。これは、主にユーザーフォームライブラリで使用され、ロールとリソースに基づいてテーブルデータを生成します。
リソーステーブルユーティリティーライブラリ
たとえば、ロールごと、またはタイプごとにリソースを取得する規則のように、リソーステーブルフォームでの選択プロセスで使用される規則を持ちます。
リソーステーブルユーザーフォームのインストールは、フォームのインポートと、フォームマッピングの変更という 2 段階で行われます。
手順 1: フォームのインポート
手順 2: フォームマッピングの変更
スケーラブルフォームのカスタマイズ
スケーラブルユーザーフォームのインポートとマッピングが完了したら、それをカスタマイズしてください。差分フェッチを有効にするには、次の情報を指定しなければなりません。
動的なユーザーフォームとリソーステーブルユーザーフォームはどちらも、ユーザーのリソースに固有の属性を表示するのに、リソース固有のフォームを使用します。次のユーザーフォームは、スケーラブルフォームで使用するために WSHOME/sample/forms ディレクトリに追加されました。
- ./ACF2UserForm.xml
- ./ActivCardUserForm.xml
- ./ADUserForm.xml
- ./AIXUserForm.xml
- ./BlackberryUserForm.xml
- ./ClearTrustUserForm.xml
- ./Exchange55UserForm.xml
- ./HP-UXUserForm.xml
- ./NDSUserForm.xml
- ./OS400UserForm.xml
- ./PeopleSoftCompIntfcUserForm.xml
- ./RACFUserForm.xml
- ./SAPPortalUserForm.xml
- ./SolarisUserForm.xml
- ./SunISUserForm.xml
- ./TopSecretUserForm.xml
これらのフォームは、Dynamic Tabbed User Form とリソーステーブルユーザーフォームの両方とともに自動的にインポートされます。
配備したシステムが上記以外のリソースタイプを使用している場合は、スケーラブルフォームには、スキーママッピングに指定されているすべての属性名と値を示すデフォルトのユーザーフォームが表示されます。上記以外の既存のカスタムリソースユーザーフォームを使用するときは、スケーラブルフォームとの互換性を維持するために、特定の修正を加えてください。次に、互換性の維持に必要な手順の一部について説明します。
スケーラブルユーザーフォームとの互換性を維持するためのリソースフォームのカスタマイズ
独自にカスタマイズしたリソースフォームを追加して、Dynamic Tabbed User Form またはリソーステーブルユーザーフォームと併用する場合は、次の一般的な手順に従ってください。
手順 1: 動的リソースフォームの修正
独自のリソースフォームを追加する方法については、dynamicformsinit.xml ファイルを参照してください。このファイルで動的リソースフォームを検索し、フォームに記載されている手順を実行します。
手順 2: リソースフォームの修正
前述のリストに含まれないフォームを使用している場合は、互換性を維持できるようにリソースフォームに修正を加えます。前述のリストに含まれるいずれかのファイルを例として参照してください。方法は、各リソースフォームの冒頭に記載されています。
Tabbed User Form のカスタマイズ: 属性エリアへのパスワードフィールドの移動
同時に異なるパスワードを持つ 2 つのリソースを更新するには、割り当てられているリソースごとにパスワードフィールドを作成します。たとえば、「アカウント」ページの Exchange リソースの属性エリアに「Exchange」パスワードフィールドを設けることによっても、その他のリソースとは別に設定できるパスワードポリシーを適用できます。
デフォルトパスワードポリシーの表示
デフォルトでは、パスワードポリシーの情報は、「アカウント」>「ID」タブに次のように表示されます。
パスワードフィールドを、デフォルトの位置である ID エリアから属性エリアに移動するには、次の 3 段階の手順を実行して、Identity Manager のデフォルトのパスワード同期メカニズムを無効にしなければなりません。
次に、これらの手順について詳しく説明します。
手順 1: manualPasswordSynchronization チェックアウトプロパティーの設定
フォームに次のプロパティーを追加して、manualPasswordSynchronization ビューチェックアウトオプションを設定します。
<Form>
<Properties>
<Property name='manualPasswordSynchronization' value='true'/>
...
</Properties>
...
</Form>
manualPasswordSynchronization を true に設定すると、Identity Manager は、パスワードシンクロナイザを使用する代わりに、リソースごとのパスワードフィールドを表示します。
手順 2: パスワードの同期の無効化
「パスワード」ビューの下の selectAll フラグをオフにすることで、パスワードの同期を無効にできます。このためには、デフォルトフォームに次のフィールドを追加します。
<Field name='password.selectAll'>
<Comments>
同期を行わないように、selectAll フラグを強制的にオフにします。
ビューハンドラによって true に設定されることがあるため、この無効化が必要です。
</Comments>
<Expansion><s>false</s></Expansion>
</Field>
<FieldLoop for='res'>
<expression>
<remove>
<ref>password.targets</ref>
<s>Lighthouse</s>
</remove>
</expression>
<Comments>
また、新規アカウントではビューハンドラによってデフォルトで true に設定される
ため、個々の選択フラグも強制的に false に設定し、リソースごとにパスワードプロ
ンプトを表示する必要があります。</Comments>
<Field name='password.accounts[$(res)].selected'>
<Expansion><s>false</s></Expansion>
</Field>
</FieldLoop>
手順 3: 「属性」ページへのリソース固有のパスワードフィールドの追加
各リソースに固有のパスワードフィールドを次のように記述します。
<Field name='accounts[resname].password'>
カスタマイズしたフォームの検証実行時環境に実装する前に、編集したフォームに関する情報を、次の方法で収集できます。
エラーロギングの有効化と無効化
Identity Manager のエラーロギングユーティリティーは、フォームに含まれる式の構文に関する問題を標準出力に出力します。XPRESS のトレースを有効にすると、<block> タグを使用して、フォームのサブセットの XPRESS ステートメントにログメッセージを限定できます。XPRESS ステートメントの処理の詳細情報を取得するには、waveset.properties ファイルの設定オプション、xpress.trace を true に設定します。このオプションを true に設定すると、XPRESS ステートメントのすべての評価が、トレースメッセージとしてコンソールに出力されます。これは、XPRESS API によるトレースを有効にするためにコードを変更できない実行中アプリケーションで評価される、ステートメントのデバッグに使用できます。
すべての XPRESS フィールドの XPRESS トレースは、コマンド行または Identity Manager の管理者インタフェースから有効にできます。この方法で有効にしたトレースは、すべてのフィールドに影響します。ログメッセージをフォームのサブセットに限定するときは、<block> タグセットを使用して、エラートレースの対象を <block></block> タグ内のコードのみに制限します。
Identity Manager のすべての式の評価に関するエラーロギングをコマンド行から有効にする方法は次のとおりです。
これとは別に、Identity Manager の管理者インタフェースからエラーロギングの有効化と無効化を切り替えることもできます。
XPRESS のトレースを無効にするときは、xpress.trace の値を false に変更し、waveset.properties ファイルを読み込みなおします。
フォームとフォームフィールドのサンプルここでは、製品に付属するデフォルトフォームのサンプルを示します。また、環境にサンプルフォームを組み込む方法についても説明します。
ユーザーフォームライブラリ
フォームは、フォーム自体としてではなく、フィールドの集合を格納したコンテナとして使用できます。Identity Manager は、ユーザーフォームライブラリというオブジェクトを利用して、フォームのこの用途をサポートしています。このライブラリには、パスワードの変更などに使用される、リソースの詳細な選択に関連する複雑なフィールドが含まれます。
次のリストは、ユーザーライブラリに割り当てられている各ライブラリの概要を示しています。
ユーザーライブラリ
ユーザーフォームのプライマリライブラリ。このライブラリは、このリストに示されるその他のライブラリを含み、秘密質問の回答を表示、編集するための AuthenticationAnswers フィールドを定義します。
パスワードライブラリ
パスワードの仕様と同期に関するフィールドを持ちます。
アカウント概要ライブラリ
ユーザーに関連付けられているアカウントに関する、読み取り専用の概要情報を表示するフィールドを持ちます。
アカウントリンクライブラリ
アカウントのリンクと、リソースごとの複数のアカウントに関するフィールドを持ちます。
ユーザーセキュリティーライブラリ
機能、フォームの割り当て、承認の転送など、ユーザーセキュリティーに関するフィールドを持ちます。
ユーザーフォームライブラリ
このライブラリには、次のような、リソースアカウントビューに関連するフィールドのみが含まれます。
このライブラリは主に、Identity Manager ユーザーに関連付けられているリソースアカウントの情報を表示したテーブルから構成され、各種操作で使用されるこれらの情報を選択できます。
サンプルフォーム
次の表は、Identity Manager に付属するサンプルフォームと、その格納場所を示しています。どのフォームも sample¥forms に格納されています。
表 3-22 サンプルフォーム
ユーザーフォーム名
ファイル名
Active Directory、Active Sync
ActiveDirectoryActiveSyncForm.xml
AD ユーザーフォーム
ADUserForm.xml
Domino ユーザーフォーム
DominoUserForm.xml
GroupWise ユーザーフォーム
GroupWiseUserForm.xml
HP-UX ユーザーフォーム
HP-UXUserForm.xml
LDAP Active Sync
SkeletonDatabaseActiveSyncForm.xml
Linux ユーザーフォーム
LinuxUserForm.xml
Netegrity Siteminder Admin
SiteMinderAdminUserForm.xml
Netegrity Siteminder LDAP
SiteMinderLDAPUserForm.xml
Netegrity Siteminder ExampleTable
SiteMinderExampleTableUserForm.xml
NDS ユーザーフォーム
NDSUserForm.xml
NT ユーザーフォーム
NTform.xml
Open Networks
ONTUserForm.xml
Oracle ERP
OracleERPUserForm.xml
OS400 ユーザーフォーム
OS400UserForm.xml
RACF ユーザーフォーム
RACFUserForm.xml
SAP
SAPUserForm.xml
RSA ClearTrust
ClearTrustUserForm.xml
SecurID ユーザーフォーム
SecurIDUserForm.xml
Solaris ユーザーフォーム
SolarisUserForm.xml
AIX ユーザーフォーム
AIXUserForm.xml
Exchange55 ユーザーフォーム
Exchange55UserForm.xml
Active Directory、Active Sync
vitalStatform.xml
AD ユーザーフォーム
AccessManagerUserForm.xml
Domino ユーザーフォーム
TopSecretUserForm.xml
GroupWise ユーザーフォーム
ACF2UserForm.xml
サンプルフォームライブラリの使用
<FormRef> 要素を使用することで、Identity Manager に付属するサンプルフォームは、カスタマイズしているどのフォームにも含めることができます。
環境にサンプルフォームを追加する一般的な手順は次のとおりです。
手順 1: 規則のインポート
手順 2: フォームのインポート
手順 3: デフォルトフォームからの新規フォームの作成 (Include 参照の追加と、フォーム参照の追加)
手順 1: 規則のインポート
Identity Manager の管理者インタフェースを使用して、サンプル規則を読み込みます。次の手順で実行します。
- Identity Manager のメニューバーから、「設定」>「交換ファイルのインポート」を選択します。
- サンプルファイル名を入力するか、「参照」をクリックして、idm¥sample¥rules ディレクトリからファイルを探します。
サンプル規則の共通ファイルの名前は次のとおりです。
- sample¥rulesListGroups.xml
- sample¥rules¥NamingRules.xml
- sample¥rules¥RegionalConstants.xml
サンプル規則のリソースファイルの名前は次のとおりです。
- sample¥rules¥ADRules.xml
- sample¥rules¥NDSRules.xml
- sample¥rules¥NTRules.xml
- sample¥rules¥OS400UserFormRules.xml
- sample¥rules¥RACFUserFormRules.xml
- sample¥rules¥TopSecretUserFormRules.xml
- 「インポート」をクリックします。インポートに成功したことを示すメッセージが表示されます。
手順 2: フォームのインポート
Identity Manager の管理者インタフェースを使用して、サンプルフォームを読み込みます。次の手順で実行します。
- Identity Manager のメニューバーから、「設定」>「交換ファイルのインポート」を選択します。
- サンプルファイル名を入力するか、「参照」をクリックして、idm¥sample¥forms ディレクトリからファイルを探します。サンプルフォームのファイル名は次のとおりです。
- sample¥forms¥ACF2UserForm.xml
- sample¥forms¥ AIXUserForm.xml
- sample¥forms¥Exchange55UserForm.xml
- sample¥forms¥HP-UXUserForm.xml
- sample¥forms¥NDSUserForm.xml
- sample¥forms¥NTform.xml
- sample¥forms¥OS400UserForm.xml
- sample¥forms¥SecurIDUserForm.xml
- sample¥forms¥SolarisUserForm.xml
- sample¥forms¥TopSecretUserForm.xml
- sample¥forms¥vitalStatform.xml
- 「インポート」をクリックします。インポートに成功したことを示すメッセージが表示されます。
手順 3: Tabbed User Form の更新 (Include 参照の追加)
Tabbed User Form または作成するメインフォームから、サンプルフォームに Include 参照を追加します。次の手順で実行します。
- Tabbed User Form をコピーし、名前を変更します (たとえば、<CompanyName>tabbedUserForm)。
- Web ブラウザのアドレス行にこの URL を入力し、Enter キーを押します。
http://ApplicationServerHost:Port/idm/debug
- 認証が完了すると、「システム設定」ページが表示されます。
- 「タイプ」リストから UserForm オプションを選択し、「List Objects」をクリックします。
- <CompanyName>tabbedUserForm (または、作成するメインフォーム) の横の「編集」をクリックします。
- フォームの Include エリアを変更し、次の例に太字で表示されている各サンプルフォームを追加します。
<Include>
<ObjectRef type='UserForm' id='#ID#UserForm:UserformLibrary' name='UserForm Library'/>
<ObjectRef type='UserForm' name='UserFormName'/>
<Include>UserFormName に設定できる値は次のとおりです。
- ACF2 User Form
- AIX User Form
- Exchange55 User Form
- HP-UX User Form
- LDAP Active Sync User Form
- Netegrity Siteminder Admin Form
- Netegrity Siteminder LDAP User Form
- Netegrity Siteminder ExampleTable User Form
- NDS User Form
- NT User Form
- Open Networks User Form
- OS400 User Form
- Oracle ERP User Form
- RACF User Form
- RSA ClearTrust User Form
- SecurID User Form
- Skeleton Database Active Sync User Form
- Solaris User Form
- Tivoli Access Manager
- Top Secret User Form
- グローバル属性 (vitalStatform.xml)
フォームを保存する前に、継続して次の手順を実行します。
手順 4: Tabbed User Form の更新 (フォームの追加)
各サンプルフォームの FormRef を追加するには、それをメインフォームに追加します。
) からアクセスできます。