リボンカスタマイズのサンプル

カスタマイズする際、リボンのタブ、グループ、ボタンなどのidはRibbon Browserで確認します。

1.非表示

1-1.ボタンの非表示
取引先企業サブグリッドリボンの「新規」ボタン
<HideCustomAction HideActionId = "Mscrm.SubGrid.account.NewRecord" Location = "Mscrm.SubGrid.account.NewRecord" />

1-2.グループの非表示
取引先企業グリッドリボンの「レコード」グループ
<HideCustomAction HideActionId = "Mscrm.HomepageGrid.account.MainTab.Management" Location = "Mscrm.HomepageGrid.account.MainTab.Management" />

1-3.タブの非表示
取引先企業フォームリボンのカスタマイズタブ
<HideCustomAction HideActionId = "Mscrm.Form.account.Developer" Location = "Mscrm.Form.account.Developer" />

1-4.リボンの非表示
この処理はできません。

1-5.ファイルメニュの非表示
一覧画面またはフォーム画面のリボンの一番左側にある青色のタブです。
このタブを丸ごと非表示することはできませんが、タブの中身を非表示することができます。
「活動」を非表示にするサンプル
<HideCustomAction HideActionId = "Mscrm.Jewel.NewMenu.NewActivity" Location = "Mscrm.Jewel.NewMenu.NewActivity" />

2.ボタンの追加
取引先企業のグリッドリボンのレコードグループに、詳細ボタンを追加
<CustomAction Id = "Mscrm.HomepageGrid.account.MainTab.Management.AddControl_Shosai" Location = "Mscrm.HomepageGrid.account.MainTab.Management.Controls._children"><CommandUIDefinition><Button Alt = "詳細" Command = "Mscrm.Torihikisaki.Shosai.Command" CommandType = "General" Id = "Mscrm.HomepageGrid.account.Shosai_Button" Image16by16 = "/WebResources/new_shosai_16" Image32by32 = "/WebResources/new_shosai_32" LabelText = "詳細" Sequence = "59" TemplateAlias = "o1" ToolTipDescription = "取引先企業の詳細を表示します。" ToolTipTitle = "詳細" /></CommandUIDefinition></CustomAction>

青文字の3箇所が重要です。
・._childre：追加という意味で、ボタンだけでなく、グループの追加も「._childre」を使います。
・Sequence：追加されたボタンを表示する箇所を決めます。
・TemplateAlias：この場合、「o1」という値が設定され、ボタンは大きいサイズで表示されます。小さいサイズで表示する場合は「o2」と設定します。

3.ボタン順序の変更
既存ボタンを上書きして、設定を変更することができません。
ボタンの順序を変更する場合は、既存ボタンを非表示にしてから、新しいボタンを追加することになります。

4.グループの追加
以前書いたカスタムリボンの表示制御に、グループを追加するサンプルがあります。
グループ追加の一部として、ボタンもあわせて設定する必要があります。この際、Template属性をうまく設定しないと、ボタンが表示されないことがしばしばあります。

ボタン数にあわせて、テンプレートを設定する必要がありそうです。
ボタン二つ → "Mscrm.Templates.3”
ボタン三つ、四つ → "Mscrm.Templates.FourOverflow"
とすれば、うまくいきます。

グループを追加する際、原因不明な現象に遭遇しています。
ソリューションエクスポート→XMLファイル修正→ソリューションインポート→公開
といった方式で修正した場合に、なぜか追加されたグループのボタンは全部Disableになっています。幸いに、Ribbon Editorで公開すれば直ります。

5.リボンの活性化制御

5-1.行の選択によるボタンの性化制御
取引先企業を1つから3つまで選択したときだけ、マージボタンを活性化にします。
<EnableRule Id= " Mscrm.Torihikisaki.Merge.EnableRule.Select"><SelectionCountRule Default = "false" InvertResult="false" AppliesTo="SelectedEntity" Minimum = "1" Maximum = "3" /></EnableRule>

5-2.新規登録フォームの新規ボタンを非活性にする
<EnableRule Id = "Mscrm.Torihikisaki.form.NotNew.EnableRule"><FormStateRule State = "Create" InvertResult = "true" /></EnableRule>

6.ボタンの表示制御
取引先企業エンティティの削除権限があれば、「TestButton」を表示する
<DisplayRule Id = "Mscrm.TestButton"><EntityPrivilegeRule Default = "false" InvertResult = "false" EntityName = "account" PrivilegeDepth = "Global" PrivilegeType = "Delete"/></DisplayRule>

以上