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 のクエリ パラメーターのいずれかをそれぞれ使用できますが、両方を同時に使用できません。

一意の名前を使用する

一意の名前を使用してアプリを開くには、appname ページに main.aspx クエリ パラメーターを追加します。

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

たとえば、一意の名前が msdyn_SolutionHealthHubされている場合は、次の URL を使用してこのアプリを開くことができます。

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

AppModuleId を使用する

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

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

例:

https://myorg.crm.dynamics.com/main.aspx?appid=00001111-aaaa-2222-bbbb-3333cccc4444

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=11112222-bbbb-3333-cccc-4444dddd5555&pagetype=entitylist&etn=account&viewid=%7b<GUID value of view id>%7d"

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

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 を使用したアプリケーション ナビゲーションの変更