A large part of Item ribbon tab configuration often centers around custom tabs. However, there is also support for simply adding custom ribbon groups and/or buttons to the pre-defined Items tab. 



This article provides configuration examples of configuration on the Items tab. 


Prerequisites


Adding Custom Ribbon Groups

Additional ribbon groups can be added to the Items tab. This is done by setting the caption for the <ItemTab> to "Items", and then adding one <RibbonGroup> per menu group. All custom groups will be placed to the right of the standard ribbon groups. 


Example Configuration

In this example, there are 3 custom ribbon groups: "Process", "Review", and "Help". Each contain links to various views.

<ItemRibbonTabConfig>
    <ItemTabs>
        <ItemTab caption="Items">
            <RibbonGroups>       
            
                <RibbonGroup caption="Process" merge="true">
                    <MergeButton caption="Process Report" image="20" hideIfDisabled="true">
                        <ItemView name="Report" configItem="SI0239:ProcessReportProcess"/>
                        <ItemView name="Report" configItem="SI0248:ProcessReportRole"/>
                        <ItemView name="Report" configItem="XITE:ProcessReportItemType"/>
                    </MergeButton>
                    <MultiButton caption="Process" hideIfDisabled="true">
                        <ItemView name="XXXGraph" configItem="SI0239:Process"/>
                        <SecondaryItemView name="Report" configItem="SI0239:ProcessReportProcess"/>
                    </MultiButton>
                </RibbonGroup>

                <RibbonGroup caption="Review" merge="true">
                    <ItemView name="SWExtension.ReviewSupport.Views.ReviewSetupViewContent" visibility="Dynamic" configId="RSetup_2"/>
                    <ItemView name="SWExtension.ReviewSupport.Views.ReviewSupportViewContent" visibility="Dynamic" configId="RSupport_2"/>
                    <ItemView name="Grid" configItem="I:ReviewGrid"/>
                    <ItemView name="Chart" configItem="I:ReviewOverview"/>
                    <ItemView name="Report" configItem="I:ReviewReport"/>
                </RibbonGroup>

                <RibbonGroup caption="Help" merge="true">
                    <ItemView name="Report" configItem="I:ProcessHelp"/>
                    <ItemView name="XXXGraph" configItem="4BAS:ModelFlow" hideIfDisabled="true"/>
                </RibbonGroup>

            </RibbonGroups>
        </ItemTab>
    </ItemTabs>
</ItemRibbonTabConfig>


Example Result


Adding Menu Options to Standard Ribbon Groups

Links to views or items can be added to any of the standard ribbon groups. This is done by setting the caption for the <RibbonGroup> to the pre-defined name of the group, e.g., Items, Edit, CM, etc. 


Given the prime location, this would only recommended if the shortcut can be used for all item types and/or in a work process that applies to most domains. 


Example Configuration

In this example, a link to the standard "Attachments" view has been added to the standard "Edit" ribbon group.

<ItemRibbonTabConfig>
    <ItemTabs>
        <ItemTab caption="Items">
            <RibbonGroups>
                <RibbonGroup caption="Edit">
                    <ItemView name="Attachments"/>
                </RibbonGroup>
            </RibbonGroups>
        </ItemTab>
    </ItemTabs>
</ItemRibbonTabConfig>


Example Result