でのフィールドデコレーターの設定 構成可能ワークスペース

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む7読むのに数分
  • フィールドの横で選択されたときにアクションを実行するフィールドデコレーター (アイコン) を追加します。たとえば、タブでユーザーレコードを開く参照フィールドにアイコンを追加します。

    始める前に

    必要なロール:admin

    このタスクについて

    フィールドデコレーターは、 フォーム コンポーネントのフィールドに追加されるアイコンです。エージェントは、アイコンを選択してアクションを実行できます。 ワークスペース フィールドごとに最大 3 つのデコレーターをサポートします。

    フィールドデコレーターを設定する目的は、エージェントが他のページを開く必要のある作業を 1 つのページで実行できるようにすることです。たとえば、別のページを開いてインシデントで指定されたユーザーのレコードを表示する代わりに、エージェントは [発信者] フィールドの [ワークスペースアクション] フィールドデコレーターを選択して、タブでユーザーレコードを開くことができます。


    フィールドデコレーターを選択して、ユーザーレコードを開きます。

    アクションのアサインを作成する前に、フィールドアクション [レコードを開く] がワークスペースアクション定義として存在している必要があります。アイコン icon-user は、インスタンスで利用可能なアイコンである必要があります。

    手順

    1. 移動先 すべて > ワークスペースエクスペリエンス > アクション & コンポーネント > フィールドデコレーター.
    2. [新規] を選択します。
    3. フォームのフィールドに入力します。

      次のフォームでは、フィールドデコレーターアイコンを URL フィールドに追加します。エージェントがアイコンを選択すると、URL が開きます。

      表 : 1. アクションのアサインフォーム
      フィールド 説明
      アクションラベル フィールドデコレーターの名前 ( 例:Open a URL)。
      アクション名 アクションのアサインのリストでこのレコードに表示される名前: ワークスペースエクスペリエンス > アクション & コンポーネント > フィールドデコレーターopen_a_url など。
      注:
      アクション名は、オーバーライドを実装して識別するために一意です。同じアクション名を持つデコレーターが複数ある場合 (空であっても)、システムはそれらを重複と見なし、順序に基づいて最初のデコレーターのみを表示します。
      実装方法
      • UXF クライアントアクション は、アクションがトリガーされたとき (モーダルを開く、タブに移動するなど) に内部イベントにディスパッチするペイロードです。
      • g_form および g_list API を使用してクライアントスクリプトを作成および実行するクライアントスクリプト
      • サーバー アクションがトリガーされたときに実行するスクリプト。
      注:
      UI コンポーネントクライアントアクション は、従来の ワークスペース 有効な選択肢であり、構成可能なワークスペースでは機能しません。
      クライアントアクションを指定 虫眼鏡アイコン ( 虫眼鏡アイコン) を選択し、実行するアクションを選択します。URL を開くには、[ URL を開く] を選択します。このフィールドは、[ 実装方法 ] が UXF クライアントアクションの場合にのみ表示されます。このリストにカスタムアクションを追加することはできません。
      デコレーターの適用先 フィールドタイプ とは、デコレーターがこのタイプのすべてのフィールド(たとえば、すべての参照フィールド)に表示されることを意味します。特定のフィールド は、デコレーターが選択した特定のフィールド ( たとえば、担当者) の横にのみ表示されることを意味します。
      フィールドタイプ フィールドデコレーターを表示するフィールドタイプ ( [参照] など) を選択します。フィールドタイプ、デコレーターフィールドタイプに適用される場合にのみ表示されます。
      フィールド名 フィールドデコレーターを表示するフィールドを選択します。フィールドの選択肢は 、テーブルの値によって異なります。たとえば、[ アサイン先] を選択します。このフィールドは、デコレーターが特定のフィールドに適用される場合にのみ表示されます。
      注:
      フィールド タイプのサブセットのみがフィールド デコレーターをサポートします。テーブル上の任意のフィールドを選択できますが、そのタイプはサポートされている必要があります。
      アイコン アクションを開始する [フィールドタイプ ] または [フィールド名 ] で指定されたフィールドに表示される選択可能なアイコン。
      ツールヒント エージェントがアイコンの上にマウスを置いたときに表示されるテキスト。
      説明 このアクションの説明。
      アプリケーション このコンポーネントが適用されるアプリケーション。[グローバル (Global)] とは、コンポーネントがすべてのアプリケーションに適用されることを意味します。
      テーブル このコンポーネントが関連付けられているテーブル。このテーブルのレコードを開くと、[ フィールドタイプ ] または [フィールド名] で指定された場所にフィールドデコレーターが表示されます。デフォルトは [グローバル] です。デフォルト値のままにして、[ フィールドタイプ] で指定されたフィールドを持つオープンレコードにフィールドデコレーターアイコンが表示されるようにすることができます。テーブルを指定すると、そのテーブルのレコードが開いている場合にのみ、フィールドデコレーターアイコンが表示されます。
      表示 デコレーターを表示するフォームビュー。空のままにすると、デコレーターはすべてのフォームビューに表示されます。
      制限されたエクスペリエンス デコレーターを特定のワークスペースエクスペリエンスでのみ表示する場合に選択します。これを選択する場合は、デコレーターを表示するエクスペリエンスを選択する必要があります。これを行うには、[アクション構成] 関連リストで対応するアクション構成を選択します。
      アクティブ このフィールドデコレーターを表示 (選択) するかどうかを切り替えます。
      順番 フィールド内のフィールドデコレーターのリストでのこのアイコンの配置を制御する整数。数値が小さいほど、リストの左端になります。一般的には、これらの数字を 100、200、300、400 などのように数百にし、将来既存のアイコンの間に新しいアイコンを配置できるようにします。
    4. 上部のバナーを右クリックし、[ 保存] を選択します。
    5. オプション: [ アクションの除外] 関連リストタブで [ 新規 ] を選択し、このデコレーターの継承からテーブルと子テーブルを除外します。
      1. フォームのフィールドに入力します。
        表 : 2. [アクションの除外] フォーム
        フィールド 説明
        アクションのアサイン 虫眼鏡アイコン、 虫眼鏡アイコン を選択し、アクションのアサインを指定するアクションのアサインを選択します。
        テーブル このデコレーターに関連付けられたテーブル。
        このテーブルを除外 この テーブル が親テーブルからこのコンポーネントを継承しないように切り替えます。
        すべての子テーブルを除外 テーブルの子テーブルがこのフィールドデコレーターを継承しないように切り替えます。
      2. [送信] を選択します。
    6. [Related Links (関連リンク)] で [Advanced View (詳細ビュー)] を選択します。
      注:
      ここまでは、エージェントがフィールドデコレーターアイコンを選択したときに開く URL を指定していませんでした。これは、 詳細ビューで実行するタスクです。
    7. [ペイロードマップ] の下の [アクション属性] タブ。定義するアクション属性を選択します。
    8. 値フィールドに、開く URL を入力します。
    9. オプション: [ 条件] タブで、フィールドデコレーターの条件を指定します。
      1. フィールドデコレーターを非表示にするスクリプトを入力するには、[ スクリプト条件 ] を選択します。
      2. 注:
        この構成では、すべてのフィールドにアクセスし、フォームを保存しなくてもクライアント側で条件を評価できます。クライアント条件は、フィールドのサブセットへのアクセスのみを許可します。
        [ スクリプト化されたクライアント条件 ] を選択して、フィールドデコレーターを表示または非表示にするクライアント上の条件を指定します。
      3. [ クライアント条件 ] を選択して、フィールドデコレーターを表示または非表示にするクライアント上の条件を指定します。
      4. [レコード条件] を選択して、開いているレコードでフィールドデコレーターを表示しないフィールドと値を指定します。
      5. フィールドデコレーターを表示するために必要なロールを指定する には、必要なロール を選択します。
    10. 注:
      [ 確認の設定 ] タブで、次の操作を行います。
      [ 確認が必要 ] を選択すると、フィールドデコレーターが実行するアクションの確認をエージェントに求めるポップアップが表示されます。
    11. [更新] を選択します。