レコードのリストを表示する Web ページの追加

エンティティ リストは、開発者がポータル内のグリッドを表示する必要なく、レコードのリストを表示するウェブ ページを追加するために使用するデータ駆動コンフィギュレーションです。 エンティティ リストを使い、ポータル上の表示の Dynamics 365 レコードを公開できます。

グリッドは並べ替えをサポートしており、レコードの数が指定したページサイズより大きい場合にページ番号が付けられます。 詳細表示の Web ページ が指定されている場合は、各レコードにページへのリンクが含まれ、レコードの ID が、ID クエリ文字列パラメータ名とともにクエリ文字列に追加されます。 エンティティ リストは、複数のビューもサポートしています。 複数のビューが指定されている場合、ドロップ ダウン リストが表示され、ユーザーはさまざまなビューを切り替えることができます。

現在のポータル ユーザー、現在のポータル ユーザーの親顧客アカウント、および現在のポータル ウェブサイトによって、データをフィルター処理することもできます。 フィルター条件の ポータル ユーザー 属性アカウント 属性 の両方に値が存在する場合、ポータルはドロップダウン リストを表示して、ユーザーが自分自身 ("自分の") データまたは親顧客アカウントのデータを表示できるようにします。

ポータルへのエンティティ リストの追加

エンティティ リストには、ポータル内のレコード リストの初期化を制御するためのウェブページと、さまざまなプロパティとの関係が含まれています。 ウェブページとの関係により、ウェブサイト内の所与のページ ノードに対するリスト定義の動的検索が可能になります。 既存のエンティティ ビューを表示、または新しいエンティティ ビューを作成するため、[ポータル > エンティティ リスト] へ移動します。

注意

エンティティ リストは、サイト内でリストを表示できるよう、特定のウェブサイト内のウェブページに関連付けられている必要があります。

エンティティ リストに関連付けられたウェブページは、左端メニューの [関連] ナビゲーション リンクにリストされている [Web ページ] リンクを選択すると表示できます。 エンティティ リストを作成するときは、最初に、ポータル上のリストを表示したいエンティティを選択します。 次に 1 つまたは複数の Dynamics 365 ビューを選択し表示します。

ウェブページを作成または編集するときに、Web ページ フォームに用意されている参照フィールドにエンティティ リストを指定できます。 ページ テンプレートは通常、Page テンプレートになりますが、エンティティ リストを表示必要があるかどうかを判断するために必要なロジックがマスター テンプレートに含まれているため、コンテンツ用に設計された他のいくつかのテンプレートの 1 つになります。

エンティティ リスト属性、および関連付け

件名 内容
件名 レコードの内容を示す名前です。 これは必須フィールドです。
エンティティ名 Saved Query ビューが読み込まれるエンティティの名前。 これは必須フィールドです。
ビュー 表示されるターゲット エンティティの Saved Query ビュー。 これは必須フィールドです。 複数のビューが指定されている場合、ウェブページには、ユーザーがさまざまなビューを切り替えるためのドロップダウン リストが含まれます。
ページ サイズ ページごとのレコード数を指定する整数値です。 これは必須フィールドです。 既定値: 10
詳細ビューの Web ページ 各レコードにリンクできるオプションのウェブページ。 ID クエリ文字列パラメータ名とレコード ID は、このウェブページの URL のクエリ文字列に追加されます。
詳細ボタン ラベル [詳細ビューの Web ページ] が指定されると、詳細ビュー ボタンのテキストが表示されます。 既定: 詳細の表示
注記: Dynamics 365 組織にインストールされ有効化されている各言語パックにおいて、関連する言語でメッセージを入力するためのフィールドが使用可能になります。
作成する Web ページ 作成ボタンのターゲットとなるオプションのウェブページ。
作成ボタン ラベル [作成 Web ページ] が指定されると、作成ボタンにテキストが表示されます。 既定値: 作成
注記: Dynamics 365 組織にインストールされ有効化されている各言語パックにおいて、関連する言語でメッセージを入力するためのフィールドが使用可能になります。
ID のクエリ文字列パラメーター名 詳細ビューの Web ページへの URL のクエリ文字列で指定されたパラメーターの名前。 既定値: id
空のリスト テキスト レコードがないと表示されるメッセージ。
注記: Dynamics 365 組織にインストールされ有効化されている各言語パックにおいて、関連する言語でメッセージを入力するためのフィールドが使用可能になります。
ポータル ユーザー属性 連絡先ユーザーまたはシステム ユーザーのポータル ユーザー レコードを表す基本エンティティのオプション ルックアップは特質で、現在のユーザーの ID を適用して、リストに表示されたデータをフィルター可能です。
取引先企業属性 現行のユーザー担当者の親カスタマー アカウント値を適用して、リストに表示されたデータをフィルターするためのアカウント レコードを表す基本エンティティのオプション ルックアップ 属性です。
Web サイト属性 現在のウェブサイトの ID を適用して、リストに表示されたデータをフィルターできるウェブサイトを表す基本エンティティのオプション ルックアップ属性です。
検索が有効 検索を有効にするかどうかを示すオプションのブール値。 ユーザーがレコードをすばやく検索できるように、テキスト ボックスが表示されます。 部分テキストを検索するには、アスタリスク (*) ワイルドカード文字を使用します。 検索では、ビュー内の各列の条件フィルターをビューの既存の定義済みフィルター条件に追加して、結果のレコードを照会して戻します。
検索プレースホルダー テキスト 初期ロード時に、テキスト ボックスに表示されるラベルとして使用されるオプションの文字列。
検索ツールヒント テキスト ユーザーが、検索 テキスト ボックスを指しているときに表示されるツールチップとして使用されるオプションの文字列。

カスタム JavaScript の追加

フォームのオプション タブには、カスタム JavaScript を入力できるテキスト領域が含まれ、jQuery ライブラリがページに含まれている場合は、ここでも使用できます。 スクリプト ブロックは、Web ページの下部のページ クローズ フォーム タグの直前に追加されます。

カスタム JavaScript の例

リストはそのデータを非同期的に取得し、完了すると、カスタム JavaScriptが聴取し、グリッド内の項目で何かを実行できるイベント loaded をトリガーします。 次のコードは簡単な例です。

$(document).ready(function (){
$(".entitylist.entity-grid").on("loaded", function () {
$(this).children(".view-grid").find("tr").each(function (){
// do something with each row
$(this).css("background-color", "yellow");
});
});
}); 

特定の属性フィールドを見つけて、そのレンダリング値を変更するために値を取得します。 次のコードは、 accountnumber 属性の値を含む各テーブル セルを取得します。 エンティティとビューに適した属性へ accountnumber を置き換えます。

$(document).ready(function (){
   $(".entitylist.entity-grid").on("loaded", function () {
      $(this).children(".view-grid").find("td[data-attribute='accountnumber']").each(function (i, e){
         var value = $(this).data("value");
         // now that you have the value you can do something to the value
      });
   });
});

エンティティ リスト構成

エンティティ リスト内のレコードに対するアクション (作成、編集、削除など) を簡単に有効化および設定することができます。 また、デフォルトのラベル、サイズ、およびその他の属性を上書きして、エンティティ リストが必要な方法で正確に表示されるようにすることもできます。

これらの設定は、エンティティ リスト フォームのコンフィギュレーション セクションにあります。 既定では、[基本設定] だけが表示されます。 [詳細設定] を選択して、追加の設定を表示します。

エンティティ リストの構成

属性

Name 内容
基本設定
ビューの操作 エンティティ セットに適用可能で、グリッドの上に表示されるアクションのアクション ボタンを追加するために使用します。 実行できる操作は次のとおりです。
  • 作成
  • ダウンロード
これらのオプションの 1 つを選択すると、その操作の構成領域が表示されます。
アイテムの操作 エンティティ アクセス許可によって適切な権限が付与されている場合は、個々のレコードに適用可能なアクションのアクション ボタンを追加し、グリッドの各行に表示されます。 一般に次の操作を使用できます。
  • 詳細
  • 編集​
  • 削除​​
  • ワークフロー
  • アクティブ化します
  • 非アクティブ化します
これらのオプションの 1 つを選択すると、その操作の構成領域が表示されます。 各操作の詳細については、以下を参照してください。 また、特定のエンティティには、エンティティごとに利用できる特殊な操作があります。
  • 営業案件の値の計算 (opportunity)
  • ケース アクション (incident) をキャンセル
  • ケース アクション (incident) を閉鎖 (resolve)
  • 見積もりから受注への変換 (quote)
  • 受注から請求書への変換 (salesorder)
  • 営業案件から見積もりを生成 (opportunity)
  • 営業案件のアクション (opportunity) を破棄
  • 営業案件のアクション (opportunity) を獲得
  • ケース アクション (incident) を再開
  • 営業案件を保留にする (opportunity)
列の属性の上書き グリッド内の個々の列の表示設定を上書きするために使用します。
  • 属性: 上書きする列の論理名
  • 表示名: 既定の表示名を上書きする新しい列のタイトル
  • 幅: 既定の表示列を上書きする列の (パーセントまたはピクセル単位による) 幅 グリッド列の幅スタイルも参照してください
列の設定を上書きするには、[+ 列] を選び、詳細を入力します。
詳細設定
メッセージの読み込み中 グリッドの読み込み中に表示される既定の HTML メッセージを上書きします。
エラー メッセージ グリッドの読み込み中にエラーが発生した場合に表示される既定の HTML メッセージを上書きします。
アクセス拒否メッセージ エンティティ リストを表示するために、ユーザーに十分なエンティティ アクセス許可がない場合に表示されるデフォルトの HTML メッセージを上書きします。
空のメッセージ グリッドにデータがない場合に表示される HTML メッセージを上書きします。
詳細フォーム ダイアログ ユーザーが詳細アクションをアクティブにするときに表示されるダイアログボックスの設定を制御します。
フォームの編集ダイアログ ユーザーが編集アクションをアクティブにするときに表示されるダイアログボックスの設定を制御します。
フォームの作成ダイアログ ユーザーが作成アクションをアクティブにするときに表示されるダイアログボックスの設定を制御します。
削除ダイアログ ユーザーが削除アクションをアクティブにするときに表示されるダイアログボックスの設定を制御します。
エラー ダイアログ 任意の操作中にエラーが発生した場合に表示されるダイアログ ボックスの設定を制御します。
CSS クラス グリッドおよびアクション ボタンを含むグリッド領域全体を格納している HTML 要素に適用される CSS クラスを指定します。
グリッド CSS クラス エンティティ リストの HTML <table> 要素に適用される CSS クラスを指定します。
グリッド列の幅スタイル 上書きする列の属性の 値が、ピクセル または パーセント で指定されているかどうかを設定します。

全般的なアクション設定

一般に、エンティティ アクションにはコンフィギュレーション可能な設定があります。 いずれの場合も、カスタマイズのための他のオプションを提供し、フィールドは必須ではありません。 エンティティのアクセス許可で適切なアクセス許可が与えられている場合、単純にアクションを追加するとポータルはアクションを取得します。

一般的には、アクションごとに対応するダイアログ ボックスを構成できます。これは、[確認が必要] を選択した場合にのみ表示されます。

件名 内容
[基本設定]
確認が必要? アクションが選択されたときに確認を求める承認をユーザーに求めるかどうかを決定します。
詳細設定
確認 ユーザーがアクションをアクティブにしたときに表示される確認 HTML メッセージを上書きします。
ボタンのラベル エンティティ リストの行に表示されるこのアクションの HTML ラベルを上書きします。
ボタンのツールヒント エンティティ リスト行に表示されたこのアクション ボタンを、ユーザーが選ぶと表示されるツールヒントのテキストを上書きします。
ボタンの CSS クラス ボタンに CSS クラスを追加します。
Web ページにリダイレクト 一部のアクション (すべてではない) は、アクションの完了時にリダイレクトを許可します。 削除アクションを強くお勧めします。ほとんどの場合、オプションで、アクションが完了したときにリダイレクトするウェブページを選択できます。
リダイレクト URL ウェブページにリダイレクト オプション— の代わりに、特定の URL にリダイレクトすることができます。

一般ダイアログ ボックスの詳細設定

名前 説明
タイトル ダイアログ ボックスのタイトル バーに表示される HTML を上書きします。
プライマリ ボタン テキスト ダイアログ ボックスの基本 ("削除") ボタンに表示される HTML を上書きします。
閉じるボタン テキスト ダイアログ ボックスの閉鎖 ("キャンセル") ボタンに表示される HTML を上書きします。
解除ボタン スクリーン リーダー テキスト ダイアログ ボックスの解任ボタンに関連付けられたスクリーン リーダー テキストを上書きします。
サイズ 削除 ダイアログ ボックスのサイズを指定します。 オプションは [既定値]、[大きい]、[小さい] です。 既定のサイズは既定です。
CSS クラス 表示されるダイアログ ボックスに適用される CSS クラスを指定します。
タイル CSS クラス 表示されるダイアログ ボックスのタイトル バーに適用される CSS クラスを指定します。
プライマリ ボタン CSS クラス ダイアログ ボックスの基本 ("削除") ボタンに適用される CSS クラスを指定します。
閉じるボタン CSS クラス ダイアログ ボックスの閉鎖 ("キャンセル") ボタンに適用される CSS クラスを指定します。

[作成アクション設定]

[アクション作成] を有効にすると、エンティティ リストの上にあるボタンが表示されます。このボタンを選択すると、ユーザーが新しいレコードを作成するために使用できるエンティティ フォームのダイアログ ボックスが開き、エンティティ アクセス許可によって作成権限が与えられます。

Name 内容
基本設定
エンティティ フォーム 新しいレコードの作成に使用されるエンティティ フォームを指定します。 ドロップダウン リストには、エンティティ リストのエンティティ タイプに設定されているすべてのエンティティ フォームが含まれます。
注記: エンティティ リストのエンティティ タイプにエンティティ フォームがない場合、ドロップダウン リストは空になります。 作成アクションにエンティティ フォームが指定されていない場合、エンティティ フォームは無視され、ボタンはエンティティ リストに表示されません。
詳細設定
ボタンのラベル リストの上にある作成アクション ボタンに表示されている HTML ラベルを上書きします。
ボタンのツールヒント ユーザーが作成アクション ボタンを選ぶと表示されるツールヒントのテキストを上書きします。

作成フォーム ダイアログ ボックスの詳細設定

名前 説明
メッセージの読み込み中 ダイアログ ボックスの読み込み中に表示されるメッセージを上書きします。
タイトル ダイアログ ボックスのタイトル バーに表示される HTML を上書きします。
解除ボタン スクリーン リーダー テキスト ダイアログ ボックスの解任ボタンに関連付けられたスクリーン リーダー テキストを上書きします。
サイズ フォームの作成ダイアログ ボックスのサイズを指定します。 オプションは [既定値]、[大きい]、[小さい] です。 既定のサイズはラージです。
CSS クラス 表示されるダイアログ ボックスに適用される CSS クラスを指定します。
タイトル CSS クラス 表示されるダイアログ ボックスのタイトル バーに適用される CSS クラスを指定します。

[ダウンロード アクションの設定]

[アクションをダウンロード] を有効にすると、エンティティ リストの上にあるボタンが表示されます。このボタンを選択すると、リストから Excel (.xlsx) ファイルにデータがダウンロードされます。

Name 内容
[基本設定]
なし
[詳細設定]
ボタンのラベル エンティティ リストの上にあるダウンロード アクション ボタンに表示されている HTML ラベルを上書きします。
ボタンのツールヒント ユーザーがダウンロード アクション ボタンを選ぶと表示されるツールヒントのテキストを上書きします。

[詳細アクションの設定]

[詳細アクション] を有効にすると、ユーザーはエンティティ リスト内の選択された行の読み取り専用エンティティ フォームを表示できます。

Name 内容
基本設定
エンティティ フォーム 選択したエンティティの詳細を表示するために使用されるエンティティ フォームを指定します。 ドロップダウン リストには、エンティティ リストのエンティティ タイプに設定されているすべてのエンティティ フォームが含まれます。
注記: エンティティ リストのエンティティ タイプにエンティティ フォームがない場合、ドロップダウン リストは空になります。 詳細アクションにエンティティ フォームが指定されていない場合、エンティティ フォームは無視され、ボタンはエンティティ リストに表示されません。
詳細設定
レコード ID のクエリ文字列パラメーター名 選択したエンティティ フォームで表示するエンティティを選択するために使用されるクエリ文字列パラメータの名前を指定します。 これは、そのエンティティ フォームのレコード IDク エリ文字列パラメータ名の値と一致する必要があります。 このフィールドとエンティティ フォーム構成の両方のデフォルト値は、id です。
ボタンのラベル エンティティ リストの行に表示されるこのアクションの HTML ラベルを上書きします。
ボタンのツールヒント エンティティ リスト行に表示されたこのアクション ボタンを、ユーザーが選ぶと表示されるツールヒントのテキストを上書きします。

詳細ダイアログ ボックス 詳細設定

名前 説明
メッセージの読み込み中 ダイアログ ボックスの読み込み時に表示される HTML を上書きします。
タイトル ダイアログ ボックスのタイトル バーに表示される HTML を上書きします。
解除ボタン スクリーン リーダー テキスト ダイアログ ボックスの解任ボタンに関連付けられたスクリーン リーダー テキストを上書きします。
サイズ 詳細 ダイアログ ボックスのサイズを指定します。 オプションは [既定値]、[大きい]、[小さい] です。 既定のサイズはラージです。
CSS クラス 表示されるダイアログ ボックスに適用される CSS クラスを指定します。
タイトル CSS クラス 表示されるダイアログ ボックスのタイトル バーに適用される CSS クラスを指定します。

[編集アクション設定]

[編集アクション] を有効にすると、ユーザーはエンティティ リストから選択された行のレコードにデータ バインドされている編集可能なエンティティ フォームを表示できます。ただし、エンティティ アクセス許可によって書き込み権限が与えられている必要があります。

Name 内容
基本設定
エンティティ フォーム 選択されたエンティティの編集に使用されるエンティティ フォームを指定します。 ドロップダウン リストには、エンティティ リストのエンティティ タイプに設定されているすべてのエンティティ フォームが含まれます。
注記: エンティティ リストのエンティティ タイプにエンティティ フォームがない場合、ドロップダウン リストは空になります。 編集アクションにエンティティ フォームが指定されていない場合、エンティティ フォームは無視され、ボタンはエンティティ リストに表示されません。
詳細設定
レコード ID のクエリ文字列パラメーター名 選択したエンティティ フォームで編集するエンティティを選択するために使用されるクエリ文字列パラメータの名前を指定します。 これは、そのエンティティ フォームのレコード IDク エリ文字列パラメータ名の値と一致する必要があります。 このフィールドとエンティティ フォーム構成の両方のデフォルト値は、id です。
ボタンのラベル エンティティ リストの行に表示されるこのアクションの HTML ラベルを上書きします。
ボタンのツールヒント エンティティ リスト行に表示されたこのアクション ボタンを、ユーザーが選ぶと表示されるツールヒントのテキストを上書きします。

編集フォーム ダイアログ ボックスの詳細設定

名前 説明
メッセージの読み込み中 ダイアログ ボックスの読み込み時に表示される HTML を上書きします。
タイトル ダイアログ ボックスのタイトル バーに表示される HTML を上書きします。
解除ボタン スクリーン リーダー テキスト ダイアログ ボックスの解任ボタンに関連付けられたスクリーン リーダー テキストを上書きします。
サイズ 編集ダイアログ ボックスのサイズを指定します。 オプションは [既定値]、[大きい]、[小さい] です。 既定のサイズはラージです。
CSS クラス 表示されるダイアログ ボックスに適用される CSS クラスを指定します。
タイトル CSS クラス 表示されるダイアログ ボックスのタイトル バーに適用される CSS クラスを指定します。

[削除アクション設定]

[削除アクション] を有効にすると、エンティティ アクセス許可によって削除権限が与えられていれば、エンティティ リストから選択した行のレコードを永久に削除することができます。

Name 内容
[基本設定]
なし
[詳細設定]
確認 ユーザーが削除アクションをアクティブにしたときに表示される確認 HTML メッセージを上書きします。
ボタンのラベル エンティティ リストの行に表示されるこのアクションの HTML ラベルを上書きします。
ボタンのツールヒント エンティティ リスト行に表示されたこのアクション ボタンを、ユーザーが選ぶと表示されるツールヒントのテキストを上書きします。

削除ダイアログ ボックス (詳細) 設定

名前 説明
タイトル ダイアログ ボックスのタイトル バーに表示される HTML を上書きします。
プライマリ ボタン テキスト ダイアログ ボックスの基本 ("削除") ボタンに表示される HTML を上書きします。
閉じるボタン テキスト ダイアログ ボックスの閉鎖 ("キャンセル") ボタンに表示される HTML を上書きします。
解除ボタン スクリーン リーダー テキスト ダイアログ ボックスの解任ボタンに関連付けられたスクリーン リーダー テキストを上書きします。
サイズ 削除 ダイアログ ボックスのサイズを指定します。 オプションは [既定値]、[大きい]、[小さい] です。 既定のサイズは既定です。
CSS クラス 表示されるダイアログ ボックスに適用される CSS クラスを指定します。
タイトル CSS クラス 表示されるダイアログ ボックスのタイトル バーに適用される CSS クラスを指定します。
プライマリ ボタン CSS クラス ダイアログ ボックスの基本 ("削除") ボタンに適用される CSS クラスを指定します。
閉じるボタン CSS クラス ダイアログ ボックスの閉鎖 ("キャンセル") ボタンに適用される CSS クラスを指定します。

[ワークフロー アクションの設定]

[ワークフロー アクション] を有効にすると、ユーザーはエンティティ リストから選択した行のレコードに対してオンデマンドのワークフローを実行できます。 エンティティ リストに任意の数のワークフロー アクションを追加することができます。

Name 内容
基本設定
ワークフロー ユーザーがこのアクションをアクティブにするときに実行されるオンデマンド ワークフローを指定します。
注記: エンティティ リストのエンティティ タイプにワークフローがない場合、ドロップダウン リストは空になります。 ワークフロー アクションにワークフロー指定されていない場合、エンティティ フォームは無視され、ボタンはエンティティ リストに表示されません。
ボタンのラベル エンティティ リストの行に表示されるこのアクションの HTML ラベルを設定します。 この設定は必須です。
詳細設定
ボタンのツールヒント エンティティ リスト行に表示されたこのアクション ボタンを、ユーザーが選ぶと表示されるツールヒントのテキストを上書きします。

エンティティ リストのセキュリティ保護

エンティティ リストを保護するには、レコードが表示されているエンティティのエンティティ アクセス許可を設定し、Dynamics 365 のエンティティ リスト レコードの [エンティティ アクセス許可を可能にする] のブール値を true に設定する必要があります。

エンティティ リストを保護する行為は、ページにアクセスするすべてのユーザに対して、それらが許可されたレコードのみが表示されることを保証します。 これはリスト表示の Dynamics 365 ビューに、フィルターを追加することで実行されます。 このフィルタは、[既読] アクセス許可を使用して、ユーザーがアクセスできるレコードのみをフィルターします。

さらに、リストに対して定義されたアクションは、そのアクションの対応する権限をレコード単位で尊重します。 つまり、レコードの編集アクセス許可がある場合、そのレコードに対して編集アクションが有効になります。 削除や作成などにも同じことが適用されます。 レコードがない場合、リストが読み込まれる時に、そのことを示すメッセージが表示されることに注意してください。

しかし、良いウェブサイト デザインでは、ユーザーがエンティティに対するアクセス許可を持つロールに属していない場合 (つまり、レコードを参照する状況がない) のページには、アクセスできないようにする必要があります。 理想的には、ウェブページにアクセス許可を使用してページを保護する必要があります。

ビュー詳細ページの追加

詳細ビュー ルックアップの Web ページをウェブページに設定すると、グリッドにリストされているレコードの詳細を、関連付けられたフォームまたはページの構成に応じて読み取り専用または編集として表示できます。

このページは完全にカスタマイズされたページ テンプレートで、おそらく流動を使用して作成できます。 最も一般的なシナリオはおそらく、詳細ページをエンティティ フォームまたは Web フォームのいずれかを含むウェブページにすることです。

重要な点として、グリッド内の各レコードには詳細ページへのハイパーリンクがあり、リンクにはレコードの ID の名前が付されたクエリ文字列パラメーターが含まれています。 クエリ文字列パラメータの名前は、エンティティ リストに指定された ID クエリ文字列パラメータ名に依存します。 注意する最後の手順として、対象となる詳細 Web ページも、クエリとデータの読み込を行う必要のあるレコードの ID を取得するために、このクエリ文字列パラメーター名を認識できる必要があります。

ビュー詳細ページの追加

エンティティ フォームを使用して詳細を表示

エンティティ フォームを作成するには、エンティティ フォーム ページの手順を参照してください。

エンティティ リストのレコードがエンティティ フォームに確実に読み込まれるようにするために重要な設定は、次のとおりです。

エンティティ フォームのレコード ID クエリ文字列パラメーター名は、エンティティ リストの ID クエリ文字列パラメーター名と一致している必要があります。

モードは、必要に応じて編集または読み取り専用のいずれかになります。

Web フォームを使用して詳細を表示

エンティティ リストのレコードが Web フォームに確実に読み込まれるようにするために重要な設定は、次のとおりです。

Web フォーム ステップの主キーのクエリ文字列パラメーター名は、エンティティ リストの ID クエリ文字列パラメーター名と一致している必要があります。

モードは、必要に応じて編集または読み取り専用のいずれかになります。

作成機能の詳細ページを使用

カスタム ページ、エンティティ フォーム、または Web フォームは、作成機能と同じ方法で使用できます。 これはフォーム上で、作成アクションを定義する代わりの方法です。 作成アクション と作成カスタム ページの 両方 を定義することはできません。カスタム アクションを定義することが優先されます。

エンティティ リストの作成ルックアップにウェブページを割り当て、コンフィギュレーションを使用して作成アクションを指定しない場合、リストに作成ボタンが表示されます。このボタンは、作成のために指定したカスタム ページにユーザーをリンクします。

エンティティ リスト フィルター構成

エンティティ リストのレコードをフィルターする機能を追加するのは簡単です。フィルター オプションを有効にしてから、ユーザーに表示する 1 つ以上のフィルター タイプを選択するだけです。 ユーザーが提供するテキストに一致する属性でフィルターすることも、一連のオプションから選択することもできます。 Dynamics 365 にある高度な検索を使用して、想像可能などのようなフィルターでも設計できます。

エンティティ リスト フィルターの有効化

メタデータ フィルター セクションで、有効チェック ボックスを選択します。 エンティティ リストが表示されたら、フィルター領域がエンティティ リストに追加されます。 少なくとも一つのフィルターを定義するまで、ボックスは空で表示されます。

オリエンテーション設定を使用して、エンティティ リストのフィルター領域を表示する方法を定義できます。 水平の規定値では、エンティティ リストの上にフィルター領域が表示されます。 垂直方向では、フィルター領域はエンティティ リストの左側のボックスとして表示されます。

メタデータでのフィルタの設定

[フィルター タイプ]

[フィルター タイプ] 説明
テキスト フィルター テキスト ボックスを使用してエンティティ リストをフィルターして、特定のエンティティの選択された属性で一致するテキストを検索します。
属性フィルター セット 一連のチェック ボックスを使用してエンティティ リストをフィルターします。各チェック ボックスは、条件を特定のエンティティの特定の属性と照合しようとします。
ルックアップ セット 各エンティティのレコードと関連エンティティのレコードとの関係を表す一連のチェック ボックスを使用して、エンティティ リストをフィルターします。
範囲フィルター セット 属性フィルター セットと同様ですが、各チェック ボックスは 1 つではなく 2 つの条件を表すことができます(たとえば、0 以上 100 未満)。
動的な候補リスト セット 属性フィルター セットでの候補リスト値の選択と同様です。 Dynamic 候補セットでは、代わりにフィルターする候補リスト オプションを指定する必要はなく、エンティティ リストがロードされたときにオプションの完全なリストを生成します。
動的な検索セット 検索セットと同様。 Dynamic ルックアップ セットでは、代わりにフィルターするルックアップ オプションを指定する必要はなく、エンティティ リストがロードされたときにオプションの完全なリストを生成します。
FetchXML フィルター FetchXML フィルター条件を使用して、エンティティ リストをフィルターします。

テキスト フィルター

テキスト フィルタは、エンティティ リストのエンティティ タイプの属性に関連付けられたエンティティ リストのフィルター領域にテキスト ボックスを追加します。 ユーザーがフィルターを適用すると、エンティティ リストには、選択した属性に値が含まれているレコードのみが表示されます。

テキスト フィルターを追加する際は、[+テキスト フィルター] を選択してください。

テキスト フィルターを追加

テキスト フィルター では次の属性が使われます。

名前 説明
属性 フィルターするエンティティ リストを選択したエンティティ タイプの属性名。 "文字列" タイプの属性のみがテキスト フィルターに有効。
表示名 エンティティ リストが表示されているときに、フィルターのラベルを上書きします。 既定では、これは自動的に選択された属性の名前に設定されます。

属性フィルター セット

属性フィルター セットは、エンティティ リストをフィルターする一連のオプションを追加し、エンティティ リストの選択されたエンティティ タイプの単一の属性に関連付けられます。 ユーザーがフィルターを適用すると、エンティティ リストには、選択したオプションの少なくとも 1 つに完全に一致するレコードのみが表示されます。

属性フィルターの設定

属性フィルター セットは、次の属性を使用します:

名前 説明
属性 フィルターするエンティティ リストを選択したエンティティ タイプの属性名。 次の型の属性のみがテキスト フィルターに有効です: 文字列、BigInt、実数、ダブル、整数、マネー、候補、日時、およびブール。
表示名 エンティティ リストが表示されているときに、フィルターのラベルを上書きします。 既定では、これは自動的に選択された属性の名前に設定されます。
オプション​​ フィルター処理で指定できる値の集合。 詳細については、下を参照してください。

属性のフィルター設定オプション

属性フィルター セットには、通常、候補の属性とブール型の属性を除き、任意の数のオプションがあります。 ブール型の属性フィルター セットには、1 つまたは 2 つのオプション — しか指定できません。1 つは true オプションで、もう 1 つは false オプションです。 候補リスト属性フィルター セットは、候補内の可能な値ごとに最大で 1 つのオプションを持つことができます。

オプションには次の属性があります:

名前 説明
演算子 フィルター結果に使用する演算子、たとえば、次の値と等しい、より小さい、など。 オプションの演算子のリストは、フィルターで選択された属性のタイプによって異なります。 たとえば、数値 (10 進数) 型は次の値以下または次の値以上などの演算子を持ちますが、文字列の属性は次の値ではじまるまたは次の値を含むなどの演算子を使用します。 候補リストとブール演算子は常に等しいです。
Value このフィルター条件に使用する実際の値。
表示名 このオプションの表示名をフィルター ボックスで上書きします。 既定では、値の属性と同じ値に設定されます。

ルックアップ セット

ルックアップ セットは、エンティティ リストをフィルターするための一連のオプションを追加し、エンティティ リストの選択されたエンティティ タイプに関連するエンティティに関連付けられます。 ユーザーがフィルターを適用すると、エンティティ リストには、選択した関連レコードの少なくとも 1 つに完全に一致するレコードのみが表示されます。

ルックアップ セット

ルックアップ セットは、次の属性を使用します:

名前 説明
リレーションシップ フィルターするエンティティ リストの選択したエンティティ タイプに対する関連エンティティの名前。 エンティティ リストの選択したエンティティ タイプと一対多または多対多の関係を持つエンティティのみが、このフィルター タイプのオプションとして表示されます。
表示名 エンティティ リストが表示されているときに、フィルターのラベルを上書きします。 既定では、これは自動的に選択された関係の名前に設定されます。
オプション​​ フィルター処理で指定できる値の集合。 詳細については、下を参照してください。

ルックアップ セット オプション

ルックアップ セットは通常、選択された関連の種類の関連レコード数の制限以外に、オプションの数に制限がありません。

オプションには次の属性があります:

名前 説明
フィルター処理する選択された関連の種類のレコード。
表示名 このオプションの表示名をフィルター ボックスで上書きします。 既定では、値の属性と同じ値に設定されます。

範囲フィルター セット

範囲フィルター セットはフィルター領域に一連のオプションを追加します。それぞれのオプションは 1 つまたは 2 つの条件を指定できます。 ユーザーがフィルターを適用すると、エンティティ リストには、選択したオプションの少なくとも 1 つの条件に完全に一致するレコードのみが表示されます。

範囲フィルター設定

範囲フィルター セットでは次の属性が使われます。

名前 説明
属性 フィルターするエンティティ リストを選択したエンティティ タイプの属性名。 次の型の属性のみがテキスト フィルターに有効です: 文字列、BigInt、実数、ダブル、整数、マネー、日時。
表示名 エンティティ リストが表示されているときに、フィルターのラベルを上書きします。 既定では、これは自動的に選択された属性の名前に設定されます。
オプション​​ フィルター処理で指定できる値の集合。 詳細については、下を参照してください。

範囲フィルター セット オプション

範囲のフィルターのオプション数には制限がありません。 それぞれのオプションは、1 つか 2 つのサブコンディションを持つフィルター条件を生成します。全ての条件が成り立たなければ条件は成立しません。

オプションには次の属性があります:

名前 説明
演算子 1 結果をフィルターするために使用された最初の比較演算子です。たとえば、次の値と等しいと次の値以下。 オプションの演算子のリストは、フィルターで選択された属性のタイプによって異なります。 たとえば、数値 (10 進数) 型は次の値以下または次の値以上などの演算子を持ちますが、文字列の属性は次の値ではじまるまたは次の値を含むなどの演算子を使用します。 候補リストとブール演算子は常に等しいです。
値 1 このフィルター条件に使用する最初の値。
演算子 2 (任意) 結果をフィルターするために使用された 2 番目の比較演算子です。たとえば、次の値と等しいと次の値以下。 オプションの演算子のリストは、フィルターで選択された属性のタイプによって異なります。 たとえば、数値 (10 進数) 型は次の値以下または次の値以上などの演算子を持ちますが、文字列の属性は次の値ではじまるまたは次の値を含むなどの演算子を使用します。 候補リストとブール演算子は常に等しいです。
値 2 (任意) このフィルター条件に使用する 2 番目の値。
表示名 このオプションの表示名をフィルター ボックスで上書きします。 既定では、これは選択された演算子と値に基づいて動的に設定されます。

動的な候補リスト セット

動的な候補リスト セットは、フィルターするための一連のオプションを追加します。それは指定された候補リスト フィールドのすべての値を表します。 これは属性フィルター セットでの候補リストの選択とは異なります。 属性フィルター セットでは、ユーザーがフィルター処理に使用できる一連のオプションを指定する必要があります。動的な候補リスト セットの場合、指定するのは候補リストのフィールドだけで、オプション セットはすべて自動的に提供されます。 より大規模なコントロールが必要な場合、属性フィルター セットの使用をお勧めします。

動的な候補リストの設定

動的な候補リストの設定は、次のオプションを使用します:

名前 説明
属性 フィルターするエンティティ リストを選択したエンティティ タイプの候補の属性名。
表示名 エンティティ リストが表示されているときに、フィルターのラベルを上書きします。 既定では、これは自動的に選択された属性の名前に設定されます。

動的な検索セット

Dynamic ルックアップ セットは、エンティティ リストをフィルターするための Dynamics 一連のオプションを追加し、エンティティ リストの選択されたエンティティ タイプに関連するエンティティに関連付けられます。 ユーザーがフィルターを適用すると、エンティティ リストには、選択した関連レコードの少なくとも 1 つに完全に一致するレコードのみが表示されます。

これは、ルックアップ セットとは異なります。 ルックアップセットでは、フィルターする関連エンティティを手動で指定する必要があります。 Dymanic ルックアップ セットでは、フィルターするリレーションシップを指定するだけで、関連するエンティティの指定されたビューに基づいてオプションのリストが生成されます。

動的ルックアップの設定

動的ルックアップ セットは、次のオプションを使用します:

名前 説明
リレーションシップ フィルターするエンティティ リストの選択したエンティティ タイプに対する関連エンティティの名前。 エンティティ リストの選択したエンティティ タイプと一対多または多対多の関係を持つエンティティのみが、このフィルター タイプのオプションとして表示されます。
ビュー​​ フィルターするエンティティの動的リストのソースとして使用するビュー (クエリの保存)。
ラベル列 各エンティティの名前の値を提供するビューのフィールド。
関連付けの検索のフィルター処理 リレーションシップ フィールドで指定されたエンティティとログインしているユーザーとの関係を指定します。 リレーションシップ フィールドで指定されたエンティティにも連絡先との関係がある場合、フィルター オプションのリストをサインインしたユーザーに関連するものに絞り込むことができます。
表示名 エンティティ リストが表示されているときに、フィルターのラベルを上書きします。 既定では、これは自動的に選択された関係の名前に設定します。

FetchXML フィルター

範囲フィルターは、テキスト フィルターのような単純なテキスト ボックス フィルターまたは他のフィルター タイプのようなオプションのセットを作成できます。 これにより、Dynamics 365 によって使用されるクエリ言語である FetchXML を使用して、エンティティ リスト用の任意のタイプのフィルターを手動で作成することができます。

FetchXML フィルター設定

FetchXML フィルターは、1 つの属性のみを使用します。

名前 説明
FetchXML フィルターを表す XML ステートメント。

エンティティ リスト マップ ビュー

エンティティ リストを使用すると、アドレスの近くの場所を検索するための検索機能付き Bing マップによって、データのマップ ビューを有効にして設定することができます。 レコードに緯度と経度の座標値を入力し、このセクションに記載されている必要な構成オプションを指定することで、レコードをマップ上のプッシュピンとして表示できます。 緯度値または経度値がないレコードは検索から除外されます。 ページの最初の読み込みには、既定の中心緯度と既定の中心緯度座標からの距離値フィールドの初期値 (指定された距離単位に応じてマイルまたは km 単位) 内のすべてのレコードが表示されます。 マップ ビューが使用されているときに、指定されたビューは無視され、距離のクエリがデータセットに適用されてマッピング可能な結果が返されます。

注意

このオプションは、ドイツの主権クラウド環境ではサポートされません。 この環境では、マップ ビュー セクションは表示されません。

エンティティ リスト カレンダー ビュー

エンティティ リストをカレンダーとして表示するには、エンティティ リストのカレンダー ビューを使用します。それぞれのレコードは、単一のイベントとして機能するように設定されています。

カレンダーを使用してレコードを表示するには、これらのレコードに少なくとも日付フィールドを含める必要があります。 イベントが正確な開始時刻と終了時刻を持つためには、適切なフィールドが適切に配置されている必要があります。 これらのフィールドが設定されていると仮定すると、エンティティ リスト カレンダー ビューがポータルに表示されます。

エンティティ リストの拡張 Dynamics 365 ビュー フィルター

有効にした場合、エンティティは OData フィードに公開できます。 OData プロトコルは、RESTful Web サービス経由でデータとやりとりするためのアプリケーションレベルのプロトコルです。 このフィードからのデータは Web ブラウザーで表示でき、クライアント側 Web アプリケーションによって使用されるか、または Excel にインポートされます。

エンティティ リスト OData フィード

レコードを保護する場合はエンティティ アクセス許可を使用できますが、現在のポータル ユーザに関連するフィルター オプション セットの一部としてフィルターを提供する場合は、エンティティ リスト機能を使用できます。 この機能では、現在のユーザー、親のアカウント、またはウェブサイトを任意の深さでフィルターできます。 単一の連絡先レコードに一致するように Dynamics 365 でビュー フィルターを作成するだけで、コードは実行時 — にその値を実際の値に置き換えて、フィルター コンディション セクションのフィールドに値を割り当てる必要はありません。

注意

公開されている OData フィードは匿名であり、権限チェックはありません。したがって、匿名ポータル アクセスには適さない Dynamics 365 データの oData フィードを有効にしないことが重要です。

関連項目

Dynamics 365 ポータルの構成
ポータルで広告を作成および実行
ポータルのポーリングを使用してフィードバックを収集する
Web ページの評価または投票、あるいはポータルのブログ記事
ポータル上で新しい URL にリダイレクトする