5.0 XPathビルダの使用

XPathビルダは、任意のXMLドキュメントに対してXPath式を作成してテストできる強力なツールです。XDSドキュメントに対して異なる式をテストして、式をテストしている間にXDSドキュメントを変更することができます。XPath式の詳細については、『Identity Manager 3.5.1ポリシーの理解』の「 XPath 1.0式」を参照してください。

図 5-1 XPathビルダ

XPathビルダを使用する

  1. ポリシービルダで、以下の条件またはアクションのいずれかを選択して、[XPathビルダの起動]アイコン[XPathビルダ]アイコンをクリックします。

  2. インポート]を選択し、テストするXDSドキュメントを参照して選択します。

    XDSドキュメントのインポート

    Designerには、XPath式をテストするためのサンプルのイベントファイルが付属します。ファイルは、プラグインcom.novell.designer.idm.policy_ version\simulationにあります。versionは、Designerの現在のバージョンです。イベントは、追加、関連付け、削除、インスタンス、変更、移動、クエリ、名前変更、およびステータスです。

    サンプルイベントファイル
  3. フォルダをダブルクリックして、使用可能なイベントを表示します。選択できるファイルは、イベントごとに異なります。たとえば、[追加]を選択した場合は、Organization.xmlOrganizationalUnit.xml、およびUser.xmlの3つのオプションがあります。 ファイルはイベントを示します。User.xmlを選択した場合、これはユーザオブジェクトの追加のイベントになります。

    User.xmlファイル
  4. ファイルを選択して、[開く]をクリックします。

    入力ドキュメントが[XPathコンテキストセレクタ]ビューに表示されます。[XMLソース]タブを使用すると、XMLソースエディタを使用してインポートされたドキュメントを編集したり、別のエディタからXMLドキュメントをコピーしてソースビューに貼り付けることができます。ドキュメントを変更した場合は、[名前を付けて保存]をクリックして、変更したドキュメントを保存します。

    [XPathコンテキストセレクタ]ビュー

    XDSドキュメントをスクロールせずに参照したい場合は、[XPathの詳細の非表示]アイコン[XPathの詳細の非表示]アイコンをクリックします。 [XPath式]および[結果]ウィンドウを表示するには、[XPathの詳細の表示]アイコン[XPathの詳細の表示]アイコンをクリックします。

    [XDSドキュメント]ビュー
  5. XPath式の作成を開始するドキュメント内の現在の位置を選択します。

    ドキュメント内の現在の位置

    選択したXPathコンテキストは、示されているように[XPathの選択されたコンテキスト]に表示されます。

    XPathの選択されたコンテキスト
  6. 汎用]または[固有]を選択します。

    汎用]は、XMLドキュメント全体を検索して指定したXPath式と一致させます。XPath式の各インスタンスに対して結果を返します。この例では、XPath式は“/nds/input/add”です。追加されたそれぞれのインスタンスに対してXMLドキュメント全体を検索します。

    固有]は、一致を検出するまでXMLドキュメントを検索して停止します。固有のXPath式は、“/nds/input[1]/add[1]”です。追加の最初のインスタンスを検索して停止します。どのインスタンスを使用するかは、[XMLコンテキストセレクタ]内でXPath要素の次のインスタンスを選択することによって指定することができます。

  7. XPath式を[XPath式]フィールドに指定します。

    XPath式

    メモ:Ctrl Space 3、/、[、または(のキー操作の組み合わせを使用して、コードの完了をトリガします。式は、カーソルの位置まで評価され、挿入可能な要素がドロップダウンリストに表示されます。

    XPath式の結果は、下の[結果]テキストエリアに表示されます。

    結果テキストエリア

    XPathエディタが指揮を評価しない場合は、[Evaluate XPath expression (XPath式の評価)]アイコンEvaluate XPath expression (XPath式の評価)]アイコンをクリックして、XPathビルダが式を評価するようにします。

  8. XPath式の作成およびテストが完了したら、[OK]をクリックしてXPathビルダを終了します。[XPath式]に表示されているテキストは、編集しているポリシー内に配置されます。