11.2 ECMAScriptエディタの使用

ECMAScriptオブジェクトは、Identity Manager 3.5.1バージョンを持つサーバでのみサポートされます。 選択したドライバセット内のサーバがIdentity Manager 3.5.1以前のバージョンの場合、エラーメッセージが表示され、Designerはオブジェクトの作成を許可しません。 サーバのプロパティでサーバのバージョンをIdentity Manager 3.5.1に変更すると、ECMAScriptオブジェクトを作成できます。

Designerは、ECMA式ビルダを含むECMAScriptエディタを提供します。両方を使用してECMAScriptを作成します。

ECMAScriptエディタにアクセスする

  1. ［アウトライン］ビュー内でECMAScriptオブジェクトを右クリックし、［編集］を選択します。

    または

    ECMAScriptオブジェクトを作成するときに、［オブジェクトの作成後にエディタを開く］チェックボックスを選択します。

ECMAScriptエディタは、使用しているセクションによって異なるタイプの機能を提供します。

11.2.1 メインスクリプト記述エリア

ECMAScriptエディタは、ECMAScriptが作成されるメインスクリプト記述エリアを提供します。 新しいスクリプトを入力するか、または既存のスクリプトをコピーできます。

図 11-1 メインスクリプト記述エリア

既存のECMAScriptの使用

  1. ECMAScriptをテキストエディタで開いて、スクリプトをコピーします。

  2. ECMAScriptをECMAScriptエディタに貼り付けます。

  3. <Ctrl>+<S>キーを押してECMAScriptを保存します。

ECMAScriptの編集

  1. メインスクリプト記述エリア内で右クリックして、目的のオプションを選択します。

    ECMAScriptオブジェクトを編集するためのオプション

    • 入力を元に戻す: 行われた入力を元に戻します。

    • やり直し: 最後のアクションをやり直します。

    • ［切り取り］: 選択したエリアを切り取ります。

    • コピー: 選択したエリアをコピーします。

    • 貼り付け: クリップボード内の情報をメインスクリプト記述エリアに貼り付けます。

    • 削除: 選択した情報をメインスクリプト記述エリアから削除します。

    • すべて選択: メインスクリプト記述エリア内の情報すべてを選択します。

    • 検索/置換: 指定した情報を検索および置換します。

    • Expression Builderを表示: 式ビルダを起動します。詳細については、セクション 11.2.2, 式ビルダを参照してください。

ECMAScriptのコーディングヘルプ

  1. メインスクリプト記述エリアの左余白を右クリックして、目的のオプションを選択します。

    ECMAScriptオブジェクトのコーディングヘルプ

    • ブレークポイントの切り替え: 実装予定です。

    • ブレークポイントの有効化: ECMAScriptにブレークポイントを設定します。

    • ブレークポイントのプロパティ: ブレークポイントのプロパティを表示します。

    • ブックマークの追加: ECMAScriptエディタ内の行にブックマークアイコンを配置します。

    • タスクの追加: 完了する必要がある追加作業のリマインダとして行内にタスクアイコンを配置します。ツールバーから［タスク］ビューを開く場合、［ウィンドウ］ > ［ビューの表示］ > ［タスク］を選択するとタスクが表示されます。

    • Quick Diffの表示: 実装予定です。

    • 行番号を表示: メインスクリプト記述領域に行番号を表示します。

    • 初期設定: 行区切りを設定して、ECMAScriptエディタ内で作成したファイルのサフィックスを設定します。 デフォルトでは、行区切りには変換はありません。サフィックスはjsになります。

11.2.2 式ビルダ

式ビルダは、ECMAScript式の作成の支援となります。式ビルダは、ECMAScriptエディタを介して2つの方法でアクセスできます。ポリシービルダおよび引数ビルダからもアクセスできます。

ECMAScriptエディタ内で式ビルダにアクセスする

  1. ECMAScriptエディタのメインスクリプト記述エリアで右クリックします。

    または

    ECMAScriptエディタのシェルエリアで右クリックします。

ポリシービルダを介して式ビルダにアクセスする

  1. 次のアクションまたは条件の隣にある［ECMA Expression Builderの起動］アイコンをクリックします。

    • XPath式

    • XML要素の追加

    • XMLテキストの追加

    • XPath式によるクローン

    • XML属性の設定

    • ストリップXPath式

引数ビルダを介して式ビルダにアクセスする

  1. XPath名詞トークンをダブルクリックします。

  2. 引数ビルダ内の［ECMA Expression Builderの起動］アイコンをクリックします。

式ビルダには、［ECMAScript/変数)］、［関数/メソッド］、および［ECMAScript演算子］の3つのペインがあります。

図 11-2 式ビルダ

［ECMAScript/変数］は、ECMAScript内の現在の定義済関数すべてを一覧表示します。 ［関数/メソッド］は、標準ECMAScript関数とDirXMLスクリプト関数を含んでいます。［ECMAScript演算子］は、標準ECMAScript演算子を表示します。

式ビルダを使用する

  1. (オプション) 目的の［ECMAScript/変数］をクリックします。

  2. (オプション) 目的の［関数/メソッド］をクリックします。

  3. (オプション) 目的の［ECMAScript演算子］をクリックします。

  4. ［シンタックスのチェック］をクリックして、式を評価します。

  5. ［OK］をクリックして式ビルダを閉じます。

次の例では、結合ECMAScript変数がNodeSet関数またはメソッドと一緒に使用されていますが、ECMAScript演算子は選択されていません。

図 11-3 式ビルダの例

11.2.3 関数と変数

関数および変数がECMAScriptに定義されているため、ECMAScriptエディタの左側に表示されます。

図 11-4 関数と変数

関数に格納されているすべての変数はグループ化されています。+アイコン(Linuxの場合は矢印アイコン)をクリックすることによって、関数を展開してすべての変数を表示することができます。-アイコン(Linuxの場合は矢印アイコン)をクリックすることによって、変数を持たない関数を表示することができます。

11.2.4 エラー表示

ECMAScriptが作成されると、メインスクリプト記述エリアおよび［問題］ビューにエラーが表示されます。メインスクリプト記述エリアは、エラーが発生した行に赤いXでエラーを表示します。

図 11-5 メインスクリプト記述エリアのエラー

［問題］ビューは、ECMAScriptが入力されるときにエラーを累積し、エラーの原因を表示します。

［問題］ビュー内のエラーをダブルクリックします。メインスクリプト記述エリア内の問題行にカーソルが移動します。

［問題］ビューにアクセスする

  1. ツールバーで、［ウィンドウ］> ［ビューの表示］ > ［その他］ > ［一般的な問題］を選択します。

    ［問題］ビューはECMAScriptエディタの下に表示されます。

    ［問題］ビュー

11.2.5 シェルエリア

ECMAScriptエリアのシェルエリアでは、ECMAScriptを実行できます。ECMAScriptが作成された後に、スクリプトの機能をテストすることができます。

図 11-6 シェルエリア

図 11-6は、サークルエリアを決定する関数の例を含みます。関数は、areaOfCircle(10)値を指定することによってテストされます。シェルは、値628.3185307179587を表示します。

式を実行するには、<Enter>キーを押します。コンソールに複数のコード行を入力する場合は、数値キーパッドの<Enter>を押します。