This section provides troubleshooting information about Workbench extensions.
Stop and restart the Endeca Tools Service. Changes to the XML configuration files for extensions and the navigation menu do not go into effect until the service is restarted.
Ensure that you have the required Workbench user permission to access the extension.
Ensure that a menu item for the extension is specified in
ws-mainMenu.xml
and that the id attribute matches the id of the extension as defined inws-extensions.xml
. Defining an extension inws-extensions.xml
does not automatically add a link to the navigation menu in Oracle Commerce Workbench.If you have no applications defined in Oracle Commerce Workbench, the only links that display in the navigation menu are for the EAC Admin Console and EAC Settings. To enable display of the full Workbench menu, you must first provision an application.
There may be a problem with your XML configuration files that prevents Oracle Commerce Workbench from starting up. The error messages in the Oracle Workbench log can help you identify whether one of the following is the case:
One or more of the XML configuration files is missing. The following files must be present in
%ENDECA_TOOLS_CONF%\conf
(on Windows) or$ENDECA_TOOLS_CONF/conf
(on UNIX):The files are created in this location when you install Endeca. By default, the
ws-extensions.xml
file defines no extensions. Thews-mainMenu.xml
file controls the display of the navigation menu and launch page.If you have deleted one of these files, you can restore the default file by copying it from
%ENDECA_TOOLS_ROOT%\workspace_template\conf
(on Windows) or$ENDECA_TOOLS_ROOT/workspace_template/conf
(on UNIX).
One or more of the configuration files contains badly formed or invalid XML.
Ensure that the configuration files contain well-formed XML. In particular, check that any ampersand that is used within an attribute value is specified as the & entity.
Use an XML tool to validate any configuration files that you have edited against the associated schema in
%ENDECA_TOOLS_CONF%\conf
(on Windows) and$ENDECA_TOOLS_CONF/conf
(on UNIX).