カスタム クエリ文字列パラメーターを受け入れるようにフォームを構成する

カスタム クエリ文字列パラメーターを使用すると、パラメーター名とデータ型を検証しながら、期待される値をモデル駆動型のアプリ フォームに渡すことができます。 この記事では、レコードの作成時に既定値を安全に設定できるように、許可されるパラメーターを構成する方法について説明します。

モデル駆動型アプリは、既定でクエリ文字列の所定のパラメーター セットをフォームに渡すことを許可します。 アプリケーション内で新しいレコードを作成するときは、これらのパラメーターを使用して既定値を設定します。 各パラメータには、列の論理名への参照を含む標準的な命名規則を使用する必要があります。 詳細については、フォームに渡すパラメーターを使用して列を設定する を参照してください。

アプリケーションでは、カスタム クエリ文字列パラメーターをフォームに渡すことができます。 この記事では、特定のフォームで受け入れ可能な一連の特定のパラメーター名とデータ型を定義する方法について説明します。

許可されるクエリ文字列パラメーターの定義

フォームで受け入れるクエリ文字列パラメーターを指定するには、次の 2 つの方法があります。

  • クラシック エディターを使用してフォームプロパティを編集する
  • フォーム XML の編集

フォーム プロパティの編集

「モデル駆動型アプリ フォーム エディターを開く」の説明に従ってモダン フォーム エディターを使用してフォームを編集する場合は、メニューで省略記号を選択し、[クラシックに切り替える] を選択します。

  1. [ ホーム ] タブの [ フォーム ] グループで、[ フォームのプロパティ] を選択します。

    クラシック フォーム エディターの [ホーム] タブの [フォームのプロパティ] ボタンのスクリーンショット。

  2. フォームのプロパティダイアログ ボックスで、パラメータータブを選択します。

    [フォームのプロパティ] ダイアログ ボックスの [パラメーター] タブのスクリーンショット。

    このタブで、フォームが許可する名前とデータ型を変更します。

次の詳細情報をご確認ください:

FormXml の編集

エクスポートしたソリューション ファイル customizations.xml 内で、フッター要素の直後に <formparameters> 要素を追加します。 <formparameters>要素で、<querystringparameter>要素を追加して、許可するパラメーターを指定します。

次の表では、 querystringparameter 要素のパラメーター、 name 、および typeについて説明します。

name

各名前列には少なくとも 1 つのアンダースコア (_) 文字を含める必要がありますが、クエリ文字列パラメーターの名前をアンダースコアで始めることはできません。 名前は crm_で始めることはできません。 名前付け規則として、ソリューション発行元のカスタマイズ プレフィックスを使用します。 テーブルの列の名前と同じ名前を querystringparameter に使用しないでください。 有効な querystringparameter 名の値が myISV_contact_specialvalue。

重要

querystringparameter要素名が一意でない場合は、別のデータ型を使用する別のパラメーター定義によって上書きされる可能性があります。

Type

パラメーターが無効なデータを渡さないよう、データ型の値をパラメーター値と一致させます。 次のデータ型が有効です。

  • Boolean
  • DateTime
  • Double
  • EntityType
  • Integer
  • Long
  • PositiveInteger (有効な値の範囲内に "0" が含まれます)
  • SafeString
  • UniqueId
  • UnsignedInt

関連項目

フォームに渡すパラメーターを使用して列値を設定する
フォームやビューを URL で開く
クラシック フォーム エディターの概要
モデル駆動型アプリ フォームのプロパティ

  • Last updated on