if your implementation makes use of the Business Control Center (BCC), you can enable single sign-on and add a Workbench extension that adds a link to the BCC within Workbench, facilitating navigation between the two tools.
The steps below assume that you have a BCC instance configured and running.
To integrate Workbench with the Business Control Center:
Run the CIM and select [W] Workbench configuration – OPTIONAL, configuring the fields as described in the Oracle Commerce Platform Installation and Configuration Guide.
Copy the
workbench
directory generated by the CIM from your BCC host machine to the machine hosting your Workbench installation.Configure Workbench with the new BCC Home and BCC Access Control extensions.
If you have not added any custom extensions of your own, you can overwrite the
ws-mainMenu.xml
andws-extensions.xml
files with the versions in the copiedworkbench
directory. Otherwise:Open the
ToolsAndFrameworks\<version>\server\workspace\conf\ws-mainMenu.xml
file in a text editor.Create a menu item for the BCC by adding a top-level
<menuitem>
element with anid
attribute ofbcc-home
:<menuitem id="xmgr"/> <menuitem id="bcc-home"/> ...
Create a menu item for BCC Access Control by adding a
<menuitem>
element with anid
attribute ofbcc-access-control
within theuser-access
node:<menuitem id="xmgr"/> <menuitem id="bcc-home"/> <menunode id="user-access"> <menuitem id="user-management"/> <menuitem id="bcc-access-control"/> </menunode> ...
Open the
ToolsAndFrameworks\<version>\server\workspace\conf\ws-extensions.xml
file in a texte editor.Define the
bcc-home
andbcc-access-control
extensions by adding the following elements:<extension id="bcc-home" defaultName="BCC" defaultDescription ="BCC" url="http://myBCCHost.myBCCDomain.com:<bcc port>/atg/bcc" externalURL="true"/> <extension id="bcc-access-control" defaultName="BCC Access Control" defaultDescription="BCC Access Control" role="admin" url="http://myBCCHost.myBCCDomain.com:<bcc port>/ControlCenter/application/ accesscontrol" externalURL="true"/>
Where the
url
attribute provides links to the BCC and to the Access Control Panel, respectively.
Merge the localized Strings in the copied
workbench\locales
directory with those inToolsAndFrameworks\<version>\server\workspace\conf\locales
:Copy in the following properties, with values corresponding to the text you wish to use:
Property
Description
atg_flags
ATG flags indicating localization or internationalization.
tool.bcc-home.name
The name of the BCC Home link.
tool.bcc-home.description
The description for the BCC Home link.
tool.bcc-home.icon
The path to the icon file for the BCC Home link.
tool.bcc-access-control.name
The name of the BCC Access Control link.
menu.user-access.name
The name of the User Access menu.
menu.user-access.description
The description for the User Access menu.
menu.user-access.icon
The path to the icon file for the User Access menu.
For example:
# These resources should be localized. atg_flags=i18n,l10n # BCC extension tool.bcc-home.name = Business Control Center tool.bcc-home.description = Create, preview, and deploy site content and product catalogs. # @i18n:begin:trans(false) tool.bcc-home.icon = http://myserver.example.com:8080/atg/images/ BCC_home/icon_wb_bcc.png # @i18n:end:trans # BCC Access Control extension tool.bcc-access-control.name = BCC Access Control # User Access menu menu.user-access.name = User Access menu.user-access.description = Add and remove Oracle Commerce Workbench and Business Control Center Users and modify their tool access and content permissions. # @i18n:begin:trans(false) menu.user-access.icon = /ifcr/apps/endeca/workbench-assets/images/home/icon_user.png # @i18n:end:trans
Repeat the above steps for each language in your Workbench implementation.
To configure single sign-on with the BCC and Workbench, you can use Oracle Access Management or the Commerce Single Sign-On solution. See Integrating Workbench with Oracle Access Management Single Sign-On or Integrating Workbench with Oracle Commerce Single Sign-On for details.