URL を使用して Customer Engagement モバイル クライアントでフォーム、ビュー、およびダッシュ ボードを開く
Customer Engagement モバイル クライアントの新しいアプリケーション ハンドラーを使用して、Customer Engagement のフォーム、ビュー、およびダッシュボードに外部のアプリケーションから直接リンクし、外部アプリケーションでリンクをクリックしたときに、対象となる要素が電話用 Dynamics 365 またはタブレット PC 用 Dynamics 365 で開くようにすることができます。 また、エンティティ レコードを作成するために空のフォームを開くことができます。
電話用 Dynamics 365 またはタブレット PC 用 Dynamics 365 で Customer Engagement インスタンスに既にサインインしている場合は、外部アプリケーションでリンクをクリックすると対象となるレコードがモバイル クライアントに表示されます。 それ以外の場合は、Customer Engagement モバイル クライアントで Dynamics 365 Customer Engagement (on-premises) インスタンスにサインインするように求められ、サインインすると対象の要素が表示されます。 この機能を使用するには、モバイル デバイスに Dynamics 365 for phones または Dynamics 365 for tablets をインストールしている必要があります。
URL のクエリ文字列パラメーター
次のアプリケーション ハンドラーとクエリ文字列パラメーターを使用して、URL を作成します。
ms-dynamicsxrm://?pagetype=<VALUE>&etn=<VALUE>&id=<VALUE>
次の表に示したクエリ文字列パラメーターが使用されます。
| クエリ文字列パラメーター | 内容 |
|---|---|
| pagetype | 開くページの種類を指定します。 有効な値は、entity、view、dashboard、および create です。このパラメーターは必須です。 |
| etn | レコードを開くか作成する対象のエンティティの論理名を指定します。 エンティティの論理名は小文字で、EntityMetadata.LogicalName プロパティで定義されます。 このパラメーターは、 pagetype パラメーターが entity、view、またはcreate に設定されている場合は必須です。 |
| id | 開くエンティティ、ビュー、またはダッシュボード レコードの ID を指定します。 このパラメーターは、 pagetype パラメーターが entity または dashboard に設定されている場合、必須です。これは、 pagetype パラメーターが view に設定されている場合は、省略可能です。 ビュー ID を指定しない場合、etn パラメーターに指定されたエンティティの既定のビューが表示されます。 |
例の URL
フォーム、ビュー、およびダッシュボードを開くときに使用するいくつかの URI の例を示します。
| アクション | 例の URL |
|---|---|
| 取引先企業レコード ID が 91330924-802A-4B0D-A900-34FD9D790829 の取引先企業エンティティを開きます | ms-dynamicsxrm://?pagetype=entity&etn=account&id=91330924-802A-4B0D-A900-34FD9D790829 |
| 取引先担当者エンティティに対して、ビュー レコード ID が 899D4FCF-F4D3-E011-9D26-00155DBA3819 のビューを開きます | ms-dynamicsxrm://?pagetype=view&etn=contact&id=899D4FCF-F4D3-E011-9D26-00155DBA3819 |
| 取引先企業エンティティの既定のビューを開く | ms-dynamicsxrm://?pagetype=view&etn=account |
| ダッシュボード レコード ID が 2E3D0841-FA6D-DF11-986C-00155D2E3002 のダッシュボードを開きます | ms-dynamicsxrm://?pagetype=dashboard&id=2E3D0841-FA6D-DF11-986C-00155D2E3002 |
| 取引先企業レコードを作成するためのフォームを開く | ms-dynamicsxrm://?pagetype=create&etn=account |