メトリック・カードのバッジと摘要の構成

特定の条件に応じて異なるバッジと摘要が表示されるようにメトリック・カードを構成できます。たとえば、メトリック・カードに10個のオープン・リードが表示されている場合、警告バッジを表示する場合があります。ただし、オープン・リードが2つのみの場合は、バッジをまったく表示しない場合があります。この構成は、Oracle Visual Builder Studioで実行します。

前提条件

メトリック・カードには、保存済検索のデータが表示されます。営業ダッシュボードにメトリック・カードを追加して構成する前に、次のことを行う必要があります。

保存済検索を作成します。
保存済検索を適切なジョブ・ロールと共有します。
リスト・ページのURLから保存済検索のUUIDを取得します。保存済検索を表示する際のUUIDの場所を示すスクリーンショットを次に示します。
メトリック・カードを追加する営業ダッシュボード・レイアウトのコピーを作成します。詳細は、事前定義済の営業ダッシュボード・レイアウトの複製のトピックを参照してください。

設定タスクの概要

メトリック・カードのバッジと摘要を構成するには、営業ダッシュボード・レイアウト内で次のステップを実行します。

メトリック・カード・リージョンをレイアウトに追加します。
リージョン内に表示するメトリック・カードを指定します。
メトリック・カードごとに、カードのバッジ・プロパティを変更します。
1. バッジ・タイプとその表示テキストを指定します。
2. 各バッジ・タイプを表示する条件を指定します。
3. 必要に応じて、摘要テキストを追加します。

メトリック・カード条件の例

メトリック・カードのバッジと摘要を構成するには、最初に表示条件を決定します。各条件は、メトリック・カードに表示される集計合計数の範囲です。各範囲について、表示するバッジと摘要のタイプを決定します。たとえば、次のタイプの設定を構成できます。

期限超過タスクが5件未満の場合、バッジはまったく表示されません。
期限超過タスクが5件から10件存在する場合は、警告バッジを表示します。
10件を超える期限超過タスクが存在する場合は、クリティカル・バッジと摘要を表示します。

また、カードの集計合計に関係なく、カードに常に同じバッジまたは摘要が表示されるようにメトリック・カードを構成することもできます。

この設定はオプションです。メトリック・カードのこの設定をスキップすると、カードにバッジや摘要は表示されません。

条件の順序

メトリック・カードの表示条件を定義する場合、それらの条件の順序が重要です。各条件は、定義した順に上から下に評価されます。最初に満たされる条件が、適用される条件です。

バッジ・プロパティ: サンプル・フォーマット

メトリック・カードごとに、定義するバッジ・プロパティは常に特定のフォーマットに従う必要があります。必要なフォーマットのサンプルを次に示します。このサンプルでは、1つのUUIDのみがあり、これはメトリック・カードが1つのみであることを意味します。

saved-searches-list="[[ [
      {
        queryUuid: '5141f8ab-3aa8-4c0e-adf8-0b3ebb3218ac',
        badgeProp: [
          {badgeStatus:'success', lowerLimit: 0,upperLimit: 3, badgeText: 'All OK'},
          {badgeStatus:'warning', lowerLimit: 4, upperLimit: 5, badgeText: 'Please Check'},
          {badgeStatus:'danger', lowerLimit: 6, badgeText: 'Problem'}
        ]
      }
      ] ]]"

バッジ・プロパティ

バッジ・プロパティ	摘要
badgeStatus	危険情報普通成功警告各タイプのバッジ(badgeStatus)は特定の色で表示され、変更できません。いくつかのバッジと色の例を次に示します。
lowerLimit	特定のbadgeStatusの表示条件の下限。
upperLimit	特定のbadgeStatusの表示条件の上限。
badgeText	バッジに表示されるテキスト。各タイプのバッジ(badgeStatus)はデフォルト・テキストとともに表示されますが、このプロパティを使用してテキストを変更できます。
metaText	メトリック・カードのテキスト摘要。

バッジ・プロパティの構成

メトリック・カードのバッジと摘要を構成するには:

営業ダッシュボードから、Oracle Visual Builder Studioに入ります。「設定およびアクション」メニューで、「Visual Builder Studioのページの編集」を選択します。
ページ・デザイナの「営業日」タブが表示されます。
営業ダッシュボード・レイアウトを複製します。たとえば、マネージャ・レイアウトを複製し、デフォルト名の「Manager (Copy)」を受け入れます。

「事前定義済の営業ダッシュボード・レイアウトの複製」を参照してください。
「Manager (Copy)」レイアウトの「プロパティ」ペインで、+ (「セクションの追加」)アイコン→+ (「新規セクション」)をクリックします。
「セクションの作成」ダイアログの「タイトル」フィールドで、NewMetricSectionなどのセクション・タイトルを入力し、「OK」をクリックします。
新しく追加されたセクションがレイアウトの下部に追加されます。「上に移動」矢印を使用して、新しいセクションをレイアウトの上部に移動します。
既存のAttention Tile for Sales Managerセクションを削除します。
「NewMetricSection」リンクをクリックします。

テンプレート・エディタが開きます。
「コード」ボタンをクリックします。

NewMetricSectionテンプレートが表示され、空のプレースホルダtemplateタグが表示されます。
新しいメトリック・カード・リージョンをダッシュボード・レイアウトに追加するには、既存のプレースホルダtemplateタグの間にこのコードを入力します。
```
<oj-cx-saleshub-tile>
    <oj-cx-iss-attention-card>
    </oj-cx-iss-attention-card>
</oj-cx-saleshub-tile>
```
メトリック・カードの新しいtemplateコードのスクリーンショットを次に示します。
「設計」ボタンをクリックします。
「構成」ペインで、Sales Hub Tile Containerをクリックします。
「プロパティ」ペインの「すべて」タブで、サイズとして8x1を入力します。
「構成」ペインで、Sales Hub Attention Componentをクリックします。
「コード」ボタンをクリックします。
oj-cx-iss-attention-cardのオープン・タグ内にこのプレースホルダ・コードを追加します。
```
saved-searches-list="[[ [
      {
        queryUuid: '5141f8ab-3aa8-4c0e-adf8-0b3ebb3218ac',
        badgeProp: [
          {badgeStatus:'success', lowerLimit: 0,upperLimit: 3, badgeText: 'All OK'},
          {badgeStatus:'warning', lowerLimit: 4, upperLimit: 5, badgeText: 'Please Check'},
          {badgeStatus:'danger', lowerLimit: 6, badgeText: 'Problem'}
        ]
      },
      {
        queryUuid: 'b803d9db-8b59-44b9-8968-f3525ae62882',
        badgeProp: [
          {badgeStatus:'success', lower: 25, Upper: 35, badgeText: 'All OK'},
          {badgeStatus:'info', upper: 24, badgeText: 'Track'}
        ]
      }
      ] ]]"
```
前述の例では、2つのUUIDがあります。 UUIDは、メトリック・カードを移入する各保存済検索の一意の識別子を指します。各UUIDは、単一のメトリック・カードを表します。

このリージョンに追加するメトリック・カードの数に応じて、プレースホルダ・コードをコピーしてペーストします。表示を最適にするために、このリージョンに含める適切なメトリック・カードの最大数は6個または7個です。
必要なUUID (メトリック・カード)の数でコードを調整したら、残りのコードを更新できます。
1. メトリック・カードごとに、サンプルのUUIDを保存済検索の正しいUUIDに置き換えます。
2. (オプション) UUIDごとに、バッジ・プロパティ・セクションを構成します。
  - 表示するバッジのタイプを指定します。
  - 各バッジ(およびオプションで摘要)を表示する条件(上限と下限)を定義します。
  - (オプション)バッジ・テキストを指定します。たとえば、テキストは「警告」または「問題」ですか。
  - (オプション)摘要を指定します。
  ヒント:
  - 上限を指定せずに下限のみを指定できます(たとえば、10より大きい集計合計を指定する場合)。
  - 範囲条件を指定せずにmetaTextを追加できます。したがって、どの範囲も適用されない場合は、メトリック・カードに摘要を表示します。
  - バッジまたは摘要をまったく表示しない場合は、queryUUIDを追加します。次に例を示します。
```
saved-searches-list="[[ [
      {
        queryUuid: '5141f8ab-3aa8-4c0e-adf8-0b3ebb3218ac'
      },
      {
        queryUuid: 'b803d9db-8b59-44b9-8968-f3525ae62882'
      }
      ] ]]"
```
ノート:
テンプレート・エディタに追加したコードは、「プロパティ」ペインの「保存検索」のリスト・フィールドに表示されます。
「プレビュー」ボタンをクリックして、ランタイム・テスト環境の変更を表示します。