Integrating Workbench with the Business Control Center

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:

  1. Run the CIM and select [W] Workbench configuration – OPTIONAL, configuring the fields as described in the Oracle Commerce Platform Installation and Configuration Guide.

  2. Copy the workbench directory generated by the CIM from your BCC host machine to the machine hosting your Workbench installation.

  3. On your Workbench host, stop the Endeca Tools Service.

  4. 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 and ws-extensions.xml files with the versions in the copied workbench directory. Otherwise:

    1. Open the ToolsAndFrameworks\<version>\server\workspace\conf\ws-mainMenu.xml file in a text editor.

    2. Create a menu item for the BCC by adding a top-level <menuitem> element with an id attribute of bcc-home: 

      <menuitem id="xmgr"/>
<menuitem id="bcc-home"/>
...

    3. Create a menu item for BCC Access Control by adding a <menuitem> element with an id attribute of bcc-access-control within the user-access node: 

      <menuitem id="xmgr"/>
<menuitem id="bcc-home"/>
<menunode id="user-access">
  <menuitem id="user-management"/>
  <menuitem id="bcc-access-control"/>
</menunode>
...

    4. Save and close the file.

    5. Open the ToolsAndFrameworks\<version>\server\workspace\conf\ws-extensions.xml file in a texte editor.

    6. Define the bcc-home and bcc-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.

    7. Save and close the file.

  5. Merge the localized Strings in the copied workbench\locales directory with those in ToolsAndFrameworks\<version>\server\workspace\conf\locales:

    1. Open the Resources_<language> file you wish to modify.

    2. 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

    3. Save and close the file.

    4. Repeat the above steps for each language in your Workbench implementation.

  6. Start the Endeca Tools Service.

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.

Copyright © Legal Notices