ドット連結の例

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間:8分
  • ドット連結を使用して、フォーム、リスト、またはスクリプトから関連テーブルのフィールドにアクセスします。このトピックでは、ドット連結のさまざまな方法の例を紹介します。

    リストフィールド

    フィルターのフィールドリストなど、リスト内の関連フィールドにドット連結することができます。この例では、インシデントを登録した発信者の会社でインシデント [incident] テーブルをフィルタリングする方法を示します。

    フィルタリングするフィールドのリストを開くと、利用可能なインシデントテーブルのフィールドのリストが表示されます。参照フィールドの後に関連フィールドが続きます。たとえば、 発信者 の後には 問い合わせユーザー > ユーザーフィールドこれは、[ 発信者 ] が参照フィールドであり、関連フィールドが [発信者 ] レコードのユーザーフィールドであることを意味します。関連フィールドがリストに存在しない場合は、リストの下部にある [ 関連フィールドを表示 ] を選択します。
    関連フィールドを表示

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

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

    [発信者] フィールド→ [ユーザー] フィールドで[会社] を選択すると、フィールドは [発信者] [会社] になります。

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

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

    関連フィールドは、リストの下部にある [関連フィールドの削除 ] を選択することで削除できます。
    関連フィールドを削除

    条件ビルダー

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

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

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


    この GIF は、条件ビルダーでドット連結する方法を示しています

    リストコレクター

    注:
    [名前] フィールド (例では「B」) の [新しいフィールドを作成] セクション (例では「A」) を入力して、ドット連結で新しいフィールドを追加することはできません。許可されていないフィールドを追加したり、ドット連結を使用して推奨事項に対してフィールドを追加したりすると、プラットフォームで予期しない動作が発生する可能性があります。[新しいフィールドを作成] セクションからの権限のないドット連結
    リストコレクターからフィールドのリストを選択する場合 (フォームを構成する場合など)、他のフォームからフィールドにドット連結することができます。
    どのフィールドが参照フィールドであり、ドット連結できるかを確認するには、プラス記号が付いた緑色のフィールドを探します。
    参照フィールド
    参照フィールドがハイライト表示されると、追加アイコンの上に展開アイコン ( 展開アイコン) が表示されます。
    展開オプション付きの参照フィールド
    展開アイコンを選択すると、関連リストからフィールドのリストが [ 利用可能 ] ペインに表示されます。次の例は、[ アサイン先 ] フィールドが選択されていることを示しています。前のフィールドリストがリストの一番上に表示されます。
    フィールドのリスト
    フィールドが [選択済み ] ペインに追加されると、完全なドット連結構文で表示されます。次の例は、[ アサイン先] を示しています。アクティブ が選択されました。
    ドット連結フィールド

    スクリプト

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

    ビジネスルールなど、サーバー側で実行されるスクリプトの場合は、 current を追加する必要があります。

    たとえば、次のスクリプトは、チケットをオープンしたユーザーのマネージャーからの承認を要求するスクリプト化された承認ルールです。
    try{
      current.opened_by.manager;
    }
    catch(err){}
    クライアントスクリプトなど、クライアント側で実行されるスクリプトの場合、 current は必要ありません。たとえば、次の Highlight VIP Caller スクリプトはクライアント側で実行されます。
    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 = '';
        }
      }
    }

    変数

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

    たとえば、 ${assigned_to} は [ アサイン先 ] フィールドの変数です。

    例に示すように、任意の参照フィールドの元のレコードのフィールドにドット連結できます。assigned_toレコードの任意のフィールド ( ${assigned_to.manager} など) にドット連結することができます。

    ドット連結する場合、この例のように、必要に応じてチェーンを長くすることができます: ${assigned_to.department.manager.mobile_phone}

    場合によっては、ツリーピッカーからこの変数を選択できます。

    ツリーピッカー

    ツリーピッカーインターフェイスには、次のアイテムを検索するために使用できる展開可能な階層ビューがあります。
    • 別の上位レベルの CI に従属する構成アイテム (CI)。
    • 特定のグループのメンバー。たとえば、ツリーピッカーを使用して、サービスデスクグループ内のユーザーを検索します。
    • 階層テーブルの参照要素。階層テーブルは、それ自体を指す親フィールドを持つテーブルです。たとえば、グループ [sys_user_group] テーブルは、特定のグループが親グループの子であるため、階層テーブルと見なされます。

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

    最初に任意のインシデントレコードに移動し、[Assignment group] フィールドに「Database」と入力します。


    リストフィールド

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


    フィールドを選択

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


    参照フィールドを選択

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


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