---
sourceDocument: Xanadu プラットフォームアナリティクス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/xanadu/now-intelligence

 Release :

    - xanadu

ft:locale :

    - ja-JP

ft:publication_title :

    - Xanadu プラットフォームアナリティクス

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# 可視化デザイナーのドット連結の例

# 可視化デザイナーのドット連結の例 {#ariaid-title1}

* リリースバージョン: Xanadu
* 
* 更新日 2023年08月03日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：8分

ドット連結を使用して、フォーム、リスト、またはスクリプトから関連テーブルのフィールドにアクセスします。このトピックには、可視化デザイナーでドット連結を行うさまざまな方法の例が含まれています。

## リストフィールド {#dot-walking-examples-vis-des__section_m2n_3dy_h1b}

フィルターのフィールドリストなど、リスト内の関連フィールドにドット連結することができます。この例では、インシデントを登録した発信者の会社でインシデント \[incident\] テーブルをフィルタリングする方法を示します。  
フィルタリングするフィールドのリストを開くと、使用可能なインシデントテーブルフィールドのリストが表示されます。参照フィールドの後に関連フィールドが続きます。たとえば、 Caller の後には 問い合わせユーザーユーザーフィールドこれは、 問い合わせユーザーが 参照フィールドであり、関連フィールドが 問い合わせユーザー レコードのユーザーフィールドであることを意味します。関連フィールドがリストに存在しない場合は、リストの一番下にある \[ 関連フィールドを表示 \] を選択します。  

\[ 関連フィールドを表示\] を選択すると、メニューが再ロードされ、関連フィールドが表示されます。  

関連フィールドを選択すると、関連テーブルのフィールドとともにメニューが再ロードされます。  

次の例は、ドット連結の現在位置を示しています。選択した各参照は、フィールドメニューの上部に保存されます。フィールドラベルの前のドット数は、ユーザーが最初のレコードから到達したドット数を示します。  

この例は、ユーザーが Incident.Caller.Company にいることを示しています。階層の上位レベルに戻るには、メニューの上部にあるフィールドを選択します。たとえば、\[ インシデントフィールド \] を選択すると、インシデントフィールドのリストに戻ります。  
関連フィールドを削除するには、リストの下部にある \[ 関連フィールドを削除 \] を選択します。  

## Condition Builder {#dot-walking-examples-vis-des__section_aj3_d53_lfb}

条件ビルダーでドット連結することで、テーブルに対して詳細なクエリを実行できます。

条件ビルダーでドット連結するには、まずフィールドメニューの \[関連フィールドを表示 \] を選択します。このアクションにより、関連テーブルのフィールドをクエリに追加できます。

次の GIF は、条件ビルダーでフィールドをドット連結して、特定のユーザー Beth Anglin にアサインされたすべてのインシデントレコードを検索する方法を示しています。この例では、ユーザーは インシデントオープン 次に、条件ビルダーを開きます。フィールドメニューで、ユーザーは最初に \[関連フィールドを表示 \] を選択し、次にフィールドメニューを再度開いて \[Assigned to → User fields\] を選択します。ユーザーはフィールドメニューを再度開き、\[ 姓\] を選択します。ユーザーは条件 \[Last name\] \[is\] \[Anglin\] を作成します。ユーザーが \[ Run\] を選択すると、\[Incident\] リストに Beth Anglin にアサインされたレコードのみが表示されます。  

<br />

## リストコレクター {#dot-walking-examples-vis-des__ListCollectors}

リストコレクターからフィールドのリストを選択するとき (フォームを設定するときなど) は、他のフォームのフィールドにドット連結することができます。  
ドット連結できる参照フィールドを確認するには、プラス記号の付いた緑色のフィールドを探します。  

参照フィールドがハイライト表示されると、追加アイコンの上に展開アイコン (![]()) が表示されます。  

展開アイコンを選択すると、\[ 利用可能 \] ペインの関連リストからフィールドのリストが開きます。次の例は、\[ アサイン先 \] フィールドが選択されたことを示しています。前のフィールドのリストがリストの一番上に表示されます。  

フィールドが \[選択済み \] ペインに追加されると、完全なドット連結構文で表示されます。次の例は、\[ アサイン先\] を示しています。\[アクティブ \] が選択されています。  

## スクリプト {#dot-walking-examples-vis-des__section_nb2_kdy_h1b}

ドット連結構文を呼び出すことで、スクリプト内でドット連結を行うことができます。この機能を使用するには、JavaScript のナレッジが必要です。

ビジネスルールなど、サーバー側で実行されるスクリプトの場合は、 <kbd class="ph userinput">current</kbd> を追加する必要があります。  
たとえば、次のスクリプトは、チケットを開いたユーザーのマネージャーからの承認を要求するスクリプト化された承認ルールです。

    try{
      current.opened_by.manager;
    }
    catch(err){}

クライアント・スクリプトなど、クライアント側で実行されるスクリプトの場合、 <kbd class="ph userinput">current</kbd> は必要ありません。たとえば、次の VIP 発信者をハイライト表示スクリプトはクライアント側で実行されます。

    function onChange(control, oldValue, newValue, isLoading){
      //wait until there is a valid record in the field
      if(newValue){ 
        //get the caller object so we can access fields
        var caller = g_form. getReference('caller_id');
        var callerLabel = document.getElementById('label.incident.caller_id');
        var callerField = document.getElementById('sys_display.incident.caller_id');
     
      //check for VIP status
      if(caller.vip == 'true') { 
        //change the caller label to red background
        //style object is CSSStyleDeclaration, style names are not standard css names
      if(callerLabel) 
        document.getElementById('label.incident.caller_id').style.backgroundColor = 'red';
     
      //change the caller's name field to red text
      if(callerField)
         document.getElementById('sys_display.incident.caller_id').style.color = 'red';
      } 
        else { //not a VIP, remove temporary styles if(callerLabel)
         document.getElementById('label.incident.caller_id').style.backgroundColor = '';

        if(callerField)
          document.getElementById('sys_display.incident.caller_id').style.color = '';
        }
      }
    }

## 変数 {#dot-walking-examples-vis-des__section_t4q_kdy_h1b}

多くの場合、テンプレート、通知、またはフォームから値が呼び出されるその他のフォームに変数を追加できます。

たとえば、 <var class="keyword varname">${assigned_to}</var> は \[Assigned to (アサイン先 )\] フィールドの変数です。

例に示すように、任意の参照フィールドの元のレコードのフィールドにドット連結することができます。assigned_toレコードの任意のフィールドにドット連結することができます (例: <var class="keyword varname">${assigned_to.manager}</var>)。

必要に応じて、ドット連結時にチェーンを長くすることができます。例: <var class="keyword varname">${assigned_to.department.manager.mobile_phone}</var>。

ツリーピッカーからこの変数を選択できる場合があります。

## ツリーピッカー {#dot-walking-examples-vis-des__section_zny_m2z_tfb}

ツリーピッカーインターフェイスには、次のアイテムを検索するために使用できる拡張可能な階層ビューがあります。

* 別の上位レベルの CI に従属する構成アイテム (CI)。
* 特定のグループのメンバー。たとえば、ツリーピッカーを使用してサービスデスクグループ内のユーザーを検索します。
* 任意の階層テーブルの参照要素。階層テーブルとは、それ自体を指している親フィールドを持つテーブルのことです。たとえば、グループ \[sys_user_group\] テーブルは、特定のグループが親グループの子であるため、階層テーブルと見なされます。
{#dot-walking-examples-vis-des__ul_cbz_kjy_h1b}

次の例は、ツリーピッカーを使用してインシデントレコードをデータベースグループのユーザーにアサインする方法を示しています。

まず任意のインシデントレコードに移動し、\[Assignment group\] フィールドに「<kbd class="ph userinput">Database</kbd>」と入力します。  

![リストフィールド]()  

この例では、データベースグループは親グループであり、その下に複数の子グループがあります。\[アサイン先\] フィールドの横にある検索アイコン (![検索アイコン)]() を選択すると、ウィンドウに \[データベース\] グループの参照フィールドが表示されます。  

<br />

参照フィールドには、名前の横に展開アイコン (+) があります。\[+\] をクリックすると、その参照フィールドのフィールドのリストが展開されます。この例では、\[ Database Atlanta \] または \[ Database San Diego \] フィールドを展開すると、各子グループ内のユーザーレコードのリストが開きます。  

<br />

いずれかのユーザーレコードを選択して、\[ アサイン先 \] フィールドに値として追加します。  

![ドット連結変数]()  
注:  
glide.ui.group_heirarchy.max_nodesプロパティを構成するときに、最大 1,000 個のノードを選択するようにツリーピッカーを構成できます。プロパティを設定するには、フィールドの辞書属性を変更し、\[属性\] フィールドに <kbd class="ph userinput">tree_picker=true</kbd> を追加します。属性が複数ある場合は、間にスペースを入れずにカンマで区切ります。