サービスカタログ ウィザードの宣言アクションの作成

宣言アクションを作成して設定すると、管理者は サービスカタログ ウィザードでボタン (ウィザードアクション) を設定できるようになります。

始める前に

カタログウィザードには、次の 2 つのタイプの宣言アクションがあります。

• UXF クライアントアクション：宣言アクションを作成し、アクションを UIB ページレベルのイベントハンドラーにマップします。モーダルを開く、別のカタログウィザードを開くなど、UIB レベルでイベントを処理する必要がある場合は、これを使用します。
• クライアントスクリプト：ボタンのクリックで実行されるクライアントスクリプトを使用します。カタログウィザードにリンクされている複合レコードプロデューサーの g_form フィールドを操作する必要がある場合は、これを使用します。

カタログウィザードモデルは、カタログウィザードの宣言アクションモデルであり、ウィザードのプロパティを定義するモデルフィールドがあります。これらのフィールドを使用して、ペイロードに含めることができる内容を定義したり (UXF クライアントアクションタイプの場合)、ウィザードのボタン表示の条件を定義したりします。すべてのウィザードでは、カタログウィザードモデルを使用して宣言アクションを作成する必要があります。

必要なロール：wizard_admin または admin

手順

1. 移動先 Service Catalog ウィザード > カタログウィザード宣言アクション.
   重要:

   このナビゲーションパスは、宣言アクションを作成する場合にのみ使用します。このパスは、宣言アクションフォームがロードされたときにフィールドを正しく設定します。
2. [新規] をクリックして、新しい宣言アクションを作成します。
3. ペイロードを作成するカタログウィザードのアクションモデルフィールドを指定します。
   アクションモデルフィールドは、デフォルトでカタログウィザードの宣言アクションに使用でき、アクションのアサインフォームの [アクションモデルフィールド] タブに表示されます。

   表 : 1. [アクションモデルフィールド] タブ

   フィールド	説明
   [現在のステップ順序 (Current Step Order)]	現在選択されているステップの順序。
   [ターゲットテーブル]	ウィザードで使用されるレコードプロデューサーまたは複合レコードプロデューサーのターゲットテーブル。
   [レコードプロデューサー]	ウィザードで使用されるレコードプロデューサーまたは複合レコードプロデューサーのターゲットテーブル。
   [ウィザード ID]	ウィザードの sys_id。
   保存を有効にする	ウィザードレコードの [保存を有効にする] フィールドの値。
   変数	ウィザードに関連付けられた複合レコードプロデューサー変数の名前と値を含むオブジェクト。
   新規レコード	ウィザードを使用して新しいレコードを作成する場合、この値は True です。
   テンプレート ID	ウィザードに適用したテンプレートの sys_id。
   [レビューステップあり (Has Review Step)]	ウィザードレコードの [レビューステップあり (Has Review Step)] フィールドの値。
   [最後のステップ (Is Last Step)]	ウィザードの最後のステップかどうかを示します。最後のステップは順序に依存せず、クライアントスクリプトまたはウィザードの UI ポリシーに基づいて動的に変更する可能性があります。
   [フォームがダーティ (Form Dirty)]	ウィザードに未保存の変更がある場合、この値は True です。
   送信中	ウィザードの送信が進行中の場合、この値は True です。
   モード	ウィザードが動作しているモード (テンプレートまたは通常モード)。
   [ターゲットレコードデータ (Target Record Data)]	適用外 (このフィールドは使用されません)。
   レコード ID	ウィザードによって編集または作成されるレコードの sys_id。

4. アクション (挿入、削除など) の [アクションラベル] リンクをクリックします。

   表 : 2. アクションのアサインフォーム

   フィールド	説明
   アクションラベル	ウィザードのボタンの表示ラベル。
   アクション名	アクションの識別子。
   実装方法	ウィザード宣言アクションの [UXF クライアントアクション] または [クライアントスクリプト]。
   クライアントアクションを指定	[実装方法] が [UXF クライアントアクション] の場合のペイロード定義。
   クライアントスクリプト	[実装方法] フィールドの値が [クライアントスクリプト] の場合は、この値を指定する必要があります。 重要: ウィザードにリンクされている CRP の変数のみを使用できます。
   ツールヒント	ボタンのツールヒント。
   ボタンタイプ	可能な値は、[プライマリ] または [セカンダリ] です。
   順序	ボタンが表示される順序。
   グループ	ボタンがグループの一部である場合に選択する必要があるオプション。
   グループ	[グループ] オプションのボタンが属するグループ。グループ化されたボタンは、ウィザードで分割ボタンとして表示されます。
   [スクリプト化されたクライアント条件]	ボタンの表示中に評価される条件。例： mode==‘template’&&variables.var==‘xxxx’。 注: このフィールドはデフォルトでフォームに表示されません。

5. [送信] をクリックしてウィザードアクションを作成します。
6. 移動先 サービスカタログウィザード > カタログウィザードアクション構成 をクリックし、「 新規」をクリックします。
   ウィザードで宣言アクションを使用できるように、ウィザードアクション構成レコードを作成します。フォームに次のフィールドを入力します。

   表 : 3. ウィザードアクション構成レコード

   フィールド	説明
   名前	ウィザードアクション構成レコードの識別子。
   宣言アクション	カタログウィザードモデルを使用して作成された宣言アクションを選択します。
   適用先	このアクションが表示されるウィザードモード。値は、[通常モード]、[テンプレートモード]、または [すべて] (両方のモード) です。
   グローバル	このアクション構成は、特定のウィザードにマッピングされているかどうかに関係なく、すべてのウィザードに適用されます。 注: デフォルトでは、グローバルアクションの保存および送信を使用できます。
   オーバーフロー	ボタンはオーバーフローメニューの一部として表示されます。
   強制保存	アクションをトリガーする前にウィザードでフィールド値が更新された場合に、ウィザードを保存します。
   ラベルの上書き	宣言アクションで指定されたラベルを上書きするラベルを入力します。
   ボタンタイプの上書き	宣言アクションによって指定されたボタンが上書きされます。

7. 移動先 カタログウィザード > ウィザードの管理.

   宣言アクションをウィザードのボタンとして表示するには、ウィザードアクション構成をカタログウィザードにマッピングします。

   宣言アクションを追加するウィザードを開きます。関連リスト [ウィザードアクション構成] を使用して、ウィザードとウィザードアクション構成間のマッピングレコードを作成します。

   1. [新規] をクリックして、新しい構成を直接作成します。
   2. [編集] をクリックして既存の構成を追加し、ウィザードと構成間のマッピングレコードを作成します。マッピングレコードには、特定のアクションを非表示にするトグルもあります。
   3. [アクションを非表示] フィールドを True に切り替えて、特定のアクションを非表示にします。
      ヒント:

      グローバル構成のボタンは、デフォルトでウィザードで使用できます。ウィザードでグローバルアクションを非表示にするには、グローバル構成をウィザードにマッピングし、[アクションを非表示] を true に設定します。

   カタログウィザードの詳細については、「サービスカタログ ウィザードの作成」を参照して ください。

8. UI Builder の [構成] タブの [宣言アクションイベントマッピングの設定] アクションを使用します。
   [宣言アクションイベントマッピングの設定] は、 UXF クライアントアクションタイプの宣言アクションにのみ適用されます。ページレベルのイベントハンドラーを作成し、宣言アクションをページレベルのイベントハンドラーにマップしてペイロードを指定します。UI Builder で宣言アクションにイベントをバインドする方法の詳細については、「宣言アクションへのイベントのバインド」を参照してください。