次の方法で共有

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

  • [アーティクル]

注意

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

コマンドを定義する新しい方法があります。 最新コマンドの概要 (プレビュー).

リボン アクションは、<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 を使用してフォームおよびビューを開く
リボン タブ表示ルールを定義する
サンプル: リボン定義をエクスポートする

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。