リボンの使用による URL へのパラメーターの受け渡し

[アーティクル]
02/23/2023

注意

このトピックは、従来のコマンドに関するものです。

リボンアクションは、<CommandDefinition> 要素の <Actions> 要素に定義されます。リボンを使用してモデル駆動型アプリのコンテキスト情報をクエリ文字列パラメーターとして URL に渡す方法はいくつかあります。

<Url> 要素を使用します。 Url 要素内で、PassParams パラメーターを使用します。
<Url> 要素と <CrmParameter> 要素を一緒に使用します。 Url 要素から使用する場合は、名前パラメーターの値を設定する必要があります。
<JavaScriptFunction> 要素と <CrmParameter> 要素を一緒に使用します。

PassParams パラメーターを使用して動的な値を設定する

PassParams パラメーターを使用してターゲット URL にパラメーターを渡すと、レコードまたはユーザーのコンテキストについての情報をターゲットアプリケーションに提供します。 PassParams を使用してリボンコントロールを構成している場合、すべてのパラメーターが渡されます。渡されるパラメーターを次の表に示します。

パラメーター	件名	内容
`typename`	テーブル名	テーブルの名前です。カスタムテーブルの場合、カスタマイズの接頭辞 (new_tablename など) が含まれます。
`type`	エンティティの種類コード	現在の組織内のテーブルを一意に識別する整数です。注: `Entity Type Code` 値は、組織でテーブルが作成された順序によって決まります。カスタムテーブルの `Entity Type Codes` は、通常、組織が違うと異なります。
`id`	オブジェクトの GUID	レコードを表すグローバル一意識別子 (GUID) です。
`orgname`	組織名	組織の一意の名前です。
`userlcid`	ユーザー言語コード	現在のユーザーが使用する言語コードの識別子です。
`orglcid`	組織言語コード	組織の基本言語を表す言語コードの識別子です。

言語コードは 4 桁または 5 桁のロケール ID です。有効なロケール ID 値は、ロケール ID (LCID) の一覧のページで確認できます。

注意

エンティティの種類コードではなく、テーブル名を使用することをお勧めするのは、エンティティの種類コードが、モデル駆動型アプリのインストール間で異なる場合があるためです。

例

次のサンプルは、パラメーターのない URL の表示方法を示しています。

https://myserver/mypage.aspx

次のサンプルは、ユーザーの言語および組織の基本言語が英語で、取引先企業レコードの GUID が DBD5DBFB-0666-DC11-A5D9-0003FF9CE217 であるときに、"AdventureWorksCycle" という組織の、取引先企業テーブルに対するリボンコントロールを表示する場合に含めるパラメーターを示しています:

https://myserver/mypage.aspx?orgname=AdventureWorksCycle&userlcid=1033&orglcid=1033&type=1&typename=account&id=%7BDBD5DBFB-0666-DC11-A5D9-0003FF9CE217%7D

URL での Querystring パラメーターの使用

URL には querystring パラメーターを含めることができます。これは、「URL を使用してフォーム、ビュー、ダイアログ、およびレポートを開く」の説明に従って特定のレコードやビューを開く場合に非常に役立ちます。

注意

URL で複数の querystring パラメーターの区切り文字としてアンパサンド文字 (&) が使用されている場合は、リボンをインポートできません。この文字を使用すると、XML が無効になります。 "&" を含む URL 値では、アンパサンド文字をエスケープする必要があります。

渡されたパラメーターの読み取り

渡されたパラメーターは、通常、HttpRequest.QueryString プロパティを使用して、ターゲットの .aspx ページに読み込まれます。詳細: HttpRequest.QueryString プロパティ

注意

URL のターゲットが Web リソースの場合は、トピック「HTMLWeb リソースへのパラメーターの引き渡し」に指定されているパラメーターのみを使用できます。ユーザー定義値を渡す方法は、data パラメーターにその値を含める方法のみです。 1 つのパラメーターに複数の値を含めるには、特殊な処理が必要です。詳細: Sample: サンプル: データパラメーターを使用した Web ページの Web リソースへの複数の値の引き渡し

次の方法で共有

リボンの使用による URL へのパラメーターの受け渡し

PassParams パラメーターを使用して動的な値を設定する

例

URL での Querystring パラメーターの使用

渡されたパラメーターの読み取り

関連項目

その他のリソース