リボン アクションの定義

公開日: 2017年1月

対象: Dynamics 365 (online)、Dynamics 365 (on-premises)、Dynamics CRM 2016、Dynamics CRM Online

<CommandDefinition> (RibbonDiffXml) 要素でコマンド バーまたはリボン コントロールによって実行するアクションを、リボンでそのコントロールを有効化するか、表示するかを制御するルールと一緒に定義します。

リボン コントロールは、次の 2 種類のアクションを実行できます。複数のアクションが含まれることもあります。

• JavaScript 関数: <JavaScriptFunction> (RibbonDiffXml) 要素はスクリプト Web リソースに定義される関数を参照します。

• URL を開く: リボンは、<Url> (RibbonDiffXml) 要素の Address 属性の値を使用して URL を開きます。 追加パラメーターによって、どの QueryString パラメーターをどのように渡すかと、ウィンドウが開くときのモードに関する情報を渡すことができます。

  リボンを使用してパラメーターを URL に渡すための選択肢はいくつかあります。詳細:リボンの使用による URL へのパラメーターの受け渡し

パラメーターをリボン アクションに渡す

ユーザー定義のアクションに渡すデータを定義するには、以下の要素を使用します。

• <BoolParameter> (RibbonDiffXml)
  パラメーターとして渡すことのできるブール データ型の値を指定します。

• <CrmParameter> (RibbonDiffXml)
  Microsoft Dynamics 365 アプリケーションから取得されたデータを表します。このデータはパラメーターとして渡すことができます。詳細:Microsoft Dynamics 365 データをページからパラメーターとしてリボン操作に渡す

• <DecimalParameter> (RibbonDiffXml)
  パラメーターとして渡すことのできる 10 進データ型の値を指定します。

• <IntParameter> (RibbonDiffXml)
  パラメーターとして渡すことのできる整数データ型の値を指定します。

• <StringParameter> (RibbonDiffXml)
  パラメーターとして渡すことのできる文字列データ型の値を指定します。

パラメーターは、<Url> (RibbonDiffXml) 要素に渡される場合、クエリ文字列として渡されます。 そのため、クエリ文字列のキー/値のペアの "キー" を表す名前値を含める必要があります。

<JavaScriptFunction> (RibbonDiffXml) に渡すパラメーターに名前は必要ありませんが、これらのパラメーターは、関数が必要とする順序で指定し、正しいデータ型を使用する必要があります。

関連項目

コマンドおよびリボンをカスタマイズする
リボンの表示ルールの定義
Microsoft Dynamics 365 データをページからパラメーターとしてリボン操作に渡す

Microsoft Dynamics 365

© 2017 Microsoft. All rights reserved. 著作権