エンティティにバインドされたグリッドでのデータ行の既定オープン動作の上書き

ヒント

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

エンティティバインドグリッド内のデータ行の既定のオープン動作をオーバーライドして、行を選択すると、URL を開くなどのカスタムアクションが実行されるようにする方法について説明します。既定では、次のいずれかのアクションでテーブルレコードが開きます。

データ行をダブルクリックするか、行のプライマリ列のリンクを選択します。
データ行を選択して、Enter キーを押します。
タッチ対応デバイスでデータ行を選択します。

(デフォルトの動作である) テーブルレコードを開かずに、JavaScript 関数を使用して URL を開くなどのカスタムアクションを実行する場合もあります。 ID パラメータ Mscrm.OpenRecordItem の値として CommandDefinition を持つテーブルのコマンド定義を作成し、アクション タブでカスタムアクションを定義することで、既定の動作を上書きし、独自のカスタム動作を定義できます。アプリケーションは、エンティティバインドグリッドからレコードを開こうとしたときに、テーブルの Mscrm.OpenRecordItem コマンド ID を検索し、存在する場合は、テーブルレコードを開く既定の動作を実行する代わりに、カスタムアクションを実行します。

ヒント

この機能は、統一インターフェイスでのみサポートされます。
コミュニティツールであるリボンワークベンチを使用して、UI を使用してリボンを視覚的に編集することもできます。コミュニティにより作成されたツールは Microsoft ではサポートされていないことに注意してください。コミュニティツールに関するご質問または問題については、ツールの発行元にお問い合わせください。

テーブルレコードが選択されたときにカスタムアクションを指定するには、次の手順を実行します。

アクションを実行する Web リソースを作成します。
customization.xml ファイルを編集して、フォームにカスタムボタンを作成します。
customization.xml ファイルをインポートします。

ステップ 1: Web リソースを作成する

既定の動作を変更する Web リソースを作成します。次の例では、レコードを表示する代わりに URL を開く場合は、そのアクションを実行する JavaScript Web リソースを作成します。

新しいソリューションを作成するか、既存のソリューションを編集する

「ソリューションの作成」の手順に従うか、サインインしてPower Appsし、左側のナビゲーションから [ソリューション] を選択します。編集するアンマネージドソリューションを選択します。
ソリューションを開き、左側のナビゲーションで [オブジェクト] を選択します。
メニューの [ + 新規>詳細>Web リソース] を選択します。

次のコードをコピーし、[ コード ] フィールドに貼り付けて、開く URL の値を編集します。

function ChangeBehavior(){

 // Enter the url
 var url =  "Enter the URL";
 var OpenUrlOptions = {height: 800, width: 1000};
 Xrm.Navigation.openUrl(url, openUrlOptions);
}

Web リソースの名前を入力し、 ファイルの種類 として JavaScript (JS) を選択します。
Web リソースを保存して発行します。

ステップ 2: カスタムボタンを作成する

既定の動作を変更するカスタムボタンをフォームに作成します。たとえば、アカウントフォーム上にサブグリッドに取引先担当者レコードを表示するサブグリッドがある場合、ボタンを作成して取引先担当者フォームに追加する必要があります。ボタンを作成するには、customization.xml ファイルを編集します。

ステップ 1 で作成したソリューションを開き、ボタンを作成するテーブルを追加します。すべてのテーブルコンポーネントとメタデータを含める必要はありません。
既存の追加>テーブルを選択します。
リストから、連絡先を選択します。
ソリューションを保存し、公開します。
[概要] に移動し、[エクスポート] を選択して、customization.xml ファイルを編集します。
発行していない最近の変更を行った場合は、[ 発行] を選択し、[ 実行 ] を選択して、ソリューションに問題または依存関係があるかどうかを確認してから、[ 次へ] を選択します。
[アンマネージド] オプションを選択した状態で、[エクスポート時にソリューションチェッカーを実行] を選択し、[エクスポート] を選択します。
ソリューションの準備ができたら、[ダウンロード] ボタンを選択してください。
[ ダウンロード ] ダイアログボックスで、[ フォルダーを開く] を選択します。
右クリックして、ダウンロードした圧縮 .zip ファイルを選択し、[ すべて抽出...] を選択します。
ファイルを展開する場所を選択してから、展開を選択します。

customizations.xml ファイルは、編集するファイルです。

ヒント

ボタンは有効または無効にできますが、どちらの場合も、開く際の既定の動作はオーバーライドされます。

customization.xml ファイルを開き、次のコードをコピーして、RibbonDiffXml内のコードを置き換えます。

<RibbonDiffXml>
<CustomActions>
  <CustomAction Id="cr5c1.Mscrm.OpenRecordItem.CustomAction"
    Location="Mscrm.SubGrid.contact.MainTab.Management.Controls._children"
    Sequence="28">
    <CommandUIDefinition>
      <Button Alt="$LocLabels:Mscrm.OpenRecordItem.Alt"
        Command="Mscrm.OpenRecordItem"
        Id="Mscrm.OpenRecordItem"
        LabelText="$LocLabels:Mscrm.OpenRecordItem.LabelText"
        Sequence="28"
        TemplateAlias="o1"
        ToolTipTitle="$LocLabels:Mscrm.OpenRecordItem.ToolTipTitle"
        ToolTipDescription="$LocLabels:Mscrm.OpenRecordItem.ToolTipDescription" />
    </CommandUIDefinition>
  </CustomAction>
</CustomActions>
<Templates>
  <RibbonTemplates Id="Mscrm.Templates" />
</Templates>
<CommandDefinitions>
  <CommandDefinition Id="Mscrm.OpenRecordItem">
    <EnableRules />
    <DisplayRules />
    <Actions>
      <JavaScriptFunction FunctionName="ChangeBehavior"
        Library="$webresource:cr5c1_samplescript" />
    </Actions>
  </CommandDefinition>
</CommandDefinitions>
</RibbonDiffXml>

ヒント

前の XML ファイルの関数名と Web リソースの名前を置き換える必要があります。上記の XML ファイル例を編集して、独自の既定の発行元に置き換えます。

次の使用例は、サブグリッドの連絡先レコードを表示するアカウントフォームのサブグリッドのボタンを変更します。したがって、Location は Location="Mscrm.SubGrid.contact.MainTab.Management.Controls._children" です。別のボタンに適用するには、この値を変更する必要があります。

ステップ 3: XML ファイルをインポートする

customization.xml ファイルを編集したら、含まれているフォルダーを開きます。
ソリューションを展開したときに含まれていたすべてのファイルまたはフォルダーを選択します。選択したファイルを右クリックし、［圧縮先...］ を選択して、次に ［ZIP ファイル］ を選択します。

ヒント

この手順では、圧縮された .zip ファイルを同じフォルダーに作成します。ファイル名は異なりますが、.zip ファイル名拡張子を除き、フォルダー内の他のファイルの 1 つと同じです。
Power Apps にサインインして、左ウィンドウから ソリューション を選択します。
コマンドバーで、[ソリューションの インポート] を選択します。
[ ソリューションのインポート ] ページで、[ 参照 ] を選択して、インポートするソリューションを含む圧縮 .zip ファイルを見つけます。
次へを選択します。
ソリューションに関する情報を表示するページで、インポート を選択します。
インポートが完了するまでしばらく待ちます。結果を表示し、閉じる を選択します。

発行が必要な変更をインポートする場合は、カスタマイズを公開してから使用できるようにする必要があります。

インポートが成功しなかった場合は、キャプチャされたエラーまたは警告を示すレポートが表示されます。インポートが失敗した原因に関する詳細を確認するために、ログファイルのダウンロード を選択します。インポートの失敗の最も一般的な原因は、ソリューションに必要なコンポーネントが含まれていなかったことです。

ログファイルをダウンロードすると、Excelで開いて内容を表示できる XML ファイルが表示されます。

参照

リボンワークベンチ
 リボンのカスタマイズ

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-08-25