URL を使用して、アプリ、フォーム、ビュー、ダイアログ、レポートを開く

URL アドレス指定可能な要素を使用すると、モデル駆動型アプリケーション、フォーム、ビュー、ダイアログ、レポートへのリンクを他のアプリケーションに含めることができます。

アプリの URL

AppModule.UniqueName や AppModule.AppModuleId の値を使用して、モデル駆動型アプリケーションを開くことができます。

次のクエリを使用した Web API によって、これらの値を取得できます。

GET [Organization URI]/api/data/v9.1/appmodules?$select=appmoduleid,uniquename

詳細情報: Web APIを使用してデータをクエリする

一意の名前または AppModuleId 値で appname や appid のクエリ パラメーターのいずれかをそれぞれ使用できますが、両方を同時に使用できません。

一意の名前を使用する

固有名を使ってアプリを開くには、main.aspx ページに appname クエリ パラメーターを追加します。

https://myorg.crm.dynamics.com/main.aspx?appname={UniqueName}

たとえば一意の名前が msdyn_SolutionHealthHub の場合、このアプリを次の URL を使用して開けます。

https://myorg.crm.dynamics.com/main.aspx?appname=msdyn_SolutionHealthHub

AppModuleId を使用する

appid クエリ パラメーターを main.aspx ページに追加し、AppModuleId を使用してアプリを開きます。

https://myorg.crm.dynamics.com/main.aspx?appid={AppModuleId}

例:

https://myorg.crm.dynamics.com/main.aspx?appid=12fd1cf3-e06e-e911-a95f-000d3a13c42a

URL アドレス指定が可能なフォームとビュー

すべてのフォームとビューが main.aspx ページに表示されます。 このページに渡されたクエリ文字列パラメーターによって、表示される内容が制御されます。 例:

ID が {91330924-802A-4B0D-A900-34FD9D790829} のアカウント レコード フォームを開く方法:

https://myorg.crm.dynamics.com/main.aspx?etn=account&pagetype=entityrecord&id=%7B91330924-802A-4B0D-A900-34FD9D790829%7D  

クローズされた営業案件 ビューを開く場合:

https://myorg.crm.dynamics.com/main.aspx?etn=opportunity&pagetype=entitylist&viewid=%7b00000000-0000-0000-00AA-000010003006%7d&viewtype=1039  

ナビゲーション バーやコマンド バーなしで、 アクティブな連絡先 ビューを開くには

https://myorg.crm.dynamics.com/main.aspx?etn=contact&pagetype=entitylist&viewid={00000000-0000-0000-00AA-000010001004}&viewtype=1039&navbar=off&cmdbar=false  

通常は、getClientUrl メソッドを使用して、モデル駆動型アプリ用の組織のルート URL を取得します。

Main.aspx ページのクエリ文字列パラメーター

次に、フォームやビューを開くために main.aspx ページで使用されるクエリ文字列パラメーターを示します:

ビューの URL のコピー

多くのモデル駆動型アプリのビューには、特定のビューの URL をコピーしたり、電子メールのメッセージに特定のビューの URL を埋め込んで送信したりできる機能が備えられています。 この機能により、ユーザー間のやり取りが容易になり、ユーザーが別のアプリケーション (SharePoint サイトなど) に含めることのできるビューの URL にもアクセスできるようになります。

URL で表示されるページにはビュー全体が含まれます。 これにはリボンが含まれますが、アプリケーション ナビゲーションは含まれません。

ビューの URL の取得

1. 使用するビューを開きます。

2. コマンド バーで操作を選択し、リンクを電子メールで送信を選択します。

3. リンクをメモ帳に貼り付けて編集し、テキストから必要な URL 部分のみ抽出します。

サイト マップを使用したアプリケーション ナビゲーションへのビューの表示

サイト マップを使用してアプリケーション ナビゲーションをカスタマイズするときは、URL の設定に、ビューに URL をコピーする の手順に従って、アプリケーションからコピーしたビューの URL を使用しないでください。 この URL は、リボンを含むページを表示し、<SubArea> URL パラメーターで使用すると望ましくない結果になります。

SubArea のアプリケーションに含まれるテーブル レコードの一覧を表示するには、テーブル列の値を設定します。 これにより、そのテーブルの既定のビューが表示され、正しいタイトルとアイコンが表示されます。

ただし、SubArea 要素の既定の初期ビューとして特定のビューを使用する場合は、次の Url のパターンを使用します。

Url="/main.aspx?appid=e2bc1066-488f-eb11-b1ac-000d3a56ead9&pagetype=entitylist&etn=account&viewid=%7b<GUID value of view id>%7d"

この URL を使用するときは、<Titles> と <Descriptions> に適切な値を指定し、テーブルのアイコンを指定する必要もあります。

URL を使用してダイアログ プロセスを開く

一般的なカスタマイズは、ユーザーが特定のレコードのコンテキストで特定のダイアログ プロセスを開けるようにすることです。 たとえば、現在のレコードの ID 値をダイアログ プロセスの入力パラメーターとして使用して、特定のテーブルのリボンにカスタム ボタンを追加できます。

ダイアログを開くには、以下が必要です。

• ダイアログの一意識別子。

• ダイアログの作成対象のテーブルの論理名。

• ダイアログの実行対象のレコードの一意識別子。

次の例では、ダイアログを開くための URL とクエリ文字列パラメーターを示します。

[organization url]/cs/dialog/rundialog.aspx?DialogId=[dialog unique identifier]&EntityName=[table logical name]&ObjectId=[unique identifier for the record]  

たとえば、アカウント レコード ID ={40C9ADFD-90A8-DF11-840E-00155DBA380F} を持つ ID ={6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976} でダイアログを開くには、次の例にある URL を使用します。

[organization url]/cs/dialog/rundialog.aspx?DialogId=%7b6A6E93C9-1FE6-4C07-91A9-E0E2A7C70976%7d&EntityName=account&ObjectId=%7b40C9ADFD-90A8-DF11-840E-00155DBA380F%7d  

次の例に示すように、ダイアログを開くための JavaScript 関数を作成できます。

function openDialogProcess(dialogId, entityName, objectId)  
{  
 var url = Xrm.Page.context.getClientUrl() +  
  "/cs/dialog/rundialog.aspx?DialogId=" +  
  dialogId + "&EntityName=" +  
  entityName + "&ObjectId=" +  
  objectId;  
 window.open(url);  
}  

URL を使用してレポートを開く

URL [organization url]/crmreports/viewer/viewer.aspx に適切なパラメーター値の渡すことでレポートを開くことができます。

この URL は、次のパラメーターを受け取ります。

操作
このパラメーターに可能な 2 つの値は run または filter のいずれかです。 run が使用される場合、レポートは既定のフィルターを使用して表示されます。 filter を使用する際、レポートの実行ボタンを選択してレポートを表示する前に、レポートにはユーザーが編集できるフィルターが表示されます。

helpID
このパラメータは任意です。 モデル駆動型アプリに含まれているレポートでは、このパラメーターの値により、このページのヘルプを選択している場合に、ヘルプ ボタンはこのレポートに関する適切な内容を表示します。 値は、レポートの FileName 値に対応する必要があります。

ID
このパラメーターは、レポートの ReportId 値です。

次の例はモデル駆動型アプリでレポートを開くために使用できる URL を示します。

既定のフィルターを使用して放置されたサポート案件レポートを開きます。

[organization url]/crmreports/viewer/viewer.aspx?action=run&helpID=Neglected%20Cases.rdl&id=%7b8c9f3e6f-7839-e211-831e-00155db7d98f%7d  

上位のサポート情報記事レポートを開いて、ユーザーにフィルターの値を設定すよう促します。

[organization url]/crmreports/viewer/viewer.aspx?action=filter&helpID=Top%20Knowledge%20Base%20Articles.rdl&id=%7bd84ec390-7839-e211-831e-00155db7d98f%7d  

次の機能は、適切に URL の値をエンコードする方法を示しています。

function getReportURL(action,fileName,id) {  
 var orgUrl = GetGlobalContext().getClientUrl();  
 var reportUrl = orgUrl +   
  "/crmreports/viewer/viewer.aspx?action=" +  
  encodeURIComponent(action) +  
  "&helpID=" +  
  encodeURIComponent(fileName) +  
  "&id=%7b" +  
  encodeURIComponent(id) +  
  "%7d";  
 return reportUrl;  
}  

関連項目

フォームに渡すパラメーターを使用して列値を設定する
Xrm.Navigation.openUrl
カスタム クエリストリング パラメーターが許可されるフォームの構成
リボンのカスタマイズ
JavaScript を使用したクライアント スクリプト
Web リソース
SiteMap を使用したアプリケーション ナビゲーションの変更