のレコードフィールドにカスタムアクションを設定する 従来のワークスペース

参照フィールドの値を使用してアクションを実行するように設定します。たとえば、電話番号が入力されたフィールドに、その電話番号をダイヤルするアイコンを追加します。または、ユーザーレコードをタブで開くアイコンを参照フィールドに追加します。

始める前に

必要なロール：admin

フィールドデコレーターは、エージェントがクリックして何らかのアクションを実行できる [フォーム] ペインの参照フィールドに追加されるアイコンです。ワークスペースは、フィールドごとに最大 3 つのデコレーターをサポートします。

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

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

手順

1. 次のように移動する。 All (すべて) > ワークスペースエクスペリエンス > アクション & コンポーネント > フィールドデコレーター.
   既存のフィールドデコレーターのリストが表示されます。
2. [New] をクリックします。
3. フォームのフィールドに入力します。

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

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

   フィールド	説明
   Action label (アクションラベル)	フィールドデコレーターの名前 ( 「URL を開く」など)。二重中括弧 {{}} を使用して、実行時にテキストに値を挿入できます (例: {{count}})。たとえば、エージェントが選択したレコードの数を中括弧を使用して表示できます。
   アクション名	アクションのアサインのリストでこのレコードに表示される名前: ワークスペースエクスペリエンス > アクション & コンポーネント > フィールドデコレーター( 例:open_a_url)。
   実装方法	クライアントアクション は、フィールドデコレーターの唯一の有効な選択です。フィールドデコレーターは、フィールド、フォーム、リスト、または関連リストにアイコンとして表示されます。クリックすると、デコレーターは、電話番号の呼び出し、レコードのオープン、コンテンツの更新、URL のオープンなどのアクションを実行します。UI コンポーネントは 、 ワークスペースのさまざまな領域に配置できる UI 要素です。クライアントアクション は、[ クライアントアクションを指定] で指定されたアクションをディスパッチします。サーバースクリプト は、サーバー上でデータベースレコードの追加、削除、変更などのアクションを実行します。
   クライアントアクションを指定	虫眼鏡 ) をクリックし、実行するアクションを選択します。URL を開くには、[ URL を開く] を選択します。このフィールドは、[そのまま実装された クライアントアクション] の場合にのみ表示されます。このリストにカスタムアクションを追加することはできません。
   UI コンポーネントを指定	虫眼鏡 ) をクリックし、追加するコンポーネントを選択します。このフィールドは、[実装方法] UI コンポーネントがある場合にのみ表示されます。
   デコレーターの適用先	フィールドタイプ は、このタイプのすべてのフィールドにデコレーターが表示されることを意味します。特定のフィールドは 、指定したフィールドが開いたときにのみデコレータが表示されることを意味します。多くの特定のフィールドが同じフィールドタイプです。たとえば、このフィールドデコレーターアイコンをすべての URL フィールドに適用するには、[ フィールドタイプ ] を選択します。
   フィールドタイプ	フィールドデコレーターを表示するフィールドタイプ ( [参照] など) を選択します。多くのフィールドは [参照] タイプです。別の例として、電話番号をダイヤルするには、[ 電話番号] を選択します。このフィールド、フィールドタイプは、デコレーターの適用先がフィールドタイプである場合にのみ表示されます。
   フィールド名	フィールドデコレーターを表示するフィールドを選択します。フィールドの選択肢は、[ テーブル] の値によって異なります。たとえば、[ 日付] を選択します。このフィールドは、[ デコレーターの適用先]が [特定のフィールド] の場合にのみ表示されます。
   アイコン	アクションを開始する [フィールドタイプ ] または [フィールド名 ] で指定されたフィールドに表示されるクリック可能なアイコン。
   ツールヒント	エージェントがアイコンの上にマウスを置いたときに表示されるテキスト。
   説明	このコンポーネントの簡単な説明。
   アプリケーション	このコンポーネントが適用されるアプリケーション。[グローバル (Global)] とは、コンポーネントがすべてのアプリケーションに適用されることを意味します。
   ワークスペース	このコンポーネントが属するワークスペース (エージェントワークスペース、ITSM、CSM など)。
   テーブル	このコンポーネントが関連付けられているテーブル。このテーブルのレコードを開くと、[ フィールドタイプ ] または [フィールド名] で指定されたフィールドにフィールドデコレーターが表示されます。デフォルトは [グローバル] です。デフォルト値のままにして、[ フィールドタイプ] で指定されたフィールドを持つすべてのオープンレコードにフィールドデコレーターアイコンが表示されるようにすることができます。テーブルを指定すると、そのテーブルのレコードが開いている場合にのみ、フィールドデコレーターアイコンが表示されます。
   ビュー	一連の視覚的な構成。この値は通常ワークスペースです。
   [Active (アクティブ)]	このフィールドデコレーターを表示 (選択) するかどうかを切り替えます。
   順序	フィールド内のフィールドデコレーターのリストでのこのアイコンの配置を制御する整数。数値が小さいほど、リストの左に移動します。一般的には、これらの数字を 100、200、300、400 などのように数百にし、将来既存のアイコンの間に新しいアイコンを配置できるようにします。

4. 上部のバナーを右クリックし、[ 保存] を選択します。
   関連リンクが表示されます。
5. オプション: [ アクションの除外 ] タブで、[ 新規 ] をクリックして、コンテキストサイドパネルでこのコンポーネントを継承する子テーブル、または親テーブルからコンポーネントを継承するテーブルを除外します。
   コンテキストサイドパネルのコンポーネントは、エージェントワークスペースで開いているレコードに従って表示されます。子テーブルは、デフォルトでこれらのコンポーネントを継承します。あなたはそれが起こらないようにすることができます。
   1. フォームのフィールドに入力します。

      表 : 2. [アクションの除外] フォーム

      フィールド	説明
      アクションのアサイン	虫眼鏡 ) をクリックし、アクションの割り当てを指定するアクションの割り当てを選択します。
      テーブル	このコンポーネントに関連付けられたテーブル。ワークスペースこのテーブルのレコードを開くたびに、このコンポーネントのアイコンがコンテキストサイドパネルに表示されます。
      このテーブルを除外	この テーブル が親テーブルからこのコンポーネントを継承しないように切り替えます。
      すべての子テーブルを除外	テーブルの子テーブルがこのフィールドデコレーターを継承しないように切り替えます。

   2. [Submit (送信)] を選択します。
6. [関連リンク] の [詳細ビュー] をクリックします。
   ここまでは、エージェントがフィールドデコレーターアイコンをクリックしたときに開く URL を指定していません。これは 、詳細ビューで実行するタスクです。
7. [ アクション属性 ] タブの [ペイロードマップ] で、定義するアクション属性を選択します。
   この例では、[ URL] を選択します。
8. 値フィールドに、開く URL を入力します。
9. オプション: [ 条件 ] タブの [スクリプト条件] に、フィールドデコレーターを非表示にするスクリプトを入力します。
10. オプション: [ 条件 ] タブの [クライアント条件] で、フィールドデコレーターを非表示にするクライアントの条件を指定します。

    エージェントがレコードリストを変更するたびに、クライアント条件が再評価されます。たとえば、エージェントがリスト内の 1 つ以上のレコードを選択するまで、リストアクションのボタンを非表示にすることができます。この場合、クライアント条件は「カウントがゼロより大きい」です。カウントは選択されたレコードの数です。

11. オプション: [ 条件 ] タブの [レコード条件] で、フィールドと値を指定します。開いているレコードにその値を持つフィールドがある場合に、フィールドデコレーターアイコンが表示されないようにします。
12. オプション: [ 条件 ] タブの [必要なロール] で、エージェントがフィールドデコレーターを表示するために必要なロールを指定します。
13. オプション: フィールドデコレーターが実行するアクションの確認をエージェントに求めるポップアップを表示する場合は、[ 確認 設定] タブで [ 確認が必要 ] チェックボックスをオンにします。
14. [Update (更新)] をクリックします。

タスクの結果

フィールドデコレーターアイコンは、[ テーブル] で指定したすべてのテーブルの参照タイプのすべてのレコードフィールドに表示されます。アイコンをクリックすると、 ペイロードマップで指定された URL が開きます。