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

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

始める前に

必要なロール：admin

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

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

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

手順

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

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

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

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

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

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

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

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

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

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

タスクの結果

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