Enabling and configuring the enhanced catalog for BMC Digital Workplace

The BMC Digital Workplace enhanced catalog provides rich profiles and categories for catalog items, bundles, and promotional banners. For examples of this dynamic self-service experience, see Enhanced-catalog.

This topic describes how BMC Digital Workplace administrators enable an enhanced catalog and configure a connection to a BMC Digital Workplace Catalog server.

Before you begin

The enhanced catalog is enabled by the additional BMC Digital Workplace Catalog application.

Verify that you have or are planning to install the BMC Digital Workplace Catalog on a separate server or cluster. For more information, see Installing-BMC-Digital-Workplace-Catalog.
So that end users can browse categories and request services through the enhanced catalog, make sure they have a user account of Read license type in the enhanced catalog server database. A system administrator must copy the Remedy IT Service Management user database into the BMC Digital Workplace Catalog user database. For more information, see Copying-users-from-Remedy-ITSM-into-BMC-Digital-Workplace-Catalog.

Verify that you have or can create a BMC Digital Workplace Catalog user with standard user permissions. This account should be used only for running background tasks such as sending notifications to end users when requests are being processed. For instructions about how to create the background process or system notification user, see Setting-up-user-accounts-and-granting-access-to-BMC-Digital-Workplace-Catalog.

Information required for the enhanced catalog configuration

The following information is required to configure a connection between BMC Digital Workplace and BMC Digital Workplace Catalog:

Web address of the catalog source
Tenant domain name
Credentials used by the notification system

Note

If you are using BMC Digital Workplace Catalog, BMC configures the enhanced catalog for you.

If you are running BMC Digital Workplace Advanced on-premises, ask your system administrator to provide the BMC Digital Workplace Catalog configuration information for you to enable the enhanced catalog.

Web address of the catalog source

Example

The web address to the API endpoint includes:

URL segment	Examples	Comment
Context	http (standard) https (SSL-configured)	Identifies whether an SSL connection is required to access the enhanced catalog source.
Server URL	your-myit-service-broker-url.com	Contains the fully qualified domain name or IP address of the server, or the load balancer of the server cluster.
Port number	8008 (standard) 8443 or 443 (SSL-configured)	Specifies the application server port number. Your system administrator can provide the assigned port number, or tell you if your system is configured to not require a port number.
API endpoint	/api/myit-sb	Points to the API endpoint used by the application scripts.

Tenant domain name

A single instance of BMC Digital Workplace can display the enhanced catalog of a single tenant, identified by a domain name.

Parameter	Example	Comment
Domain	calbroservices.com	Tenant domain identifier.

Credentials used by the notification system

These credentials can be used for any valid user account with the Administrator role in BMC Digital Workplace Catalog. Specify a user account that is used only for background services.

Parameter	Example	Comment
User	sys_notification	Do not add the tenant domain in the enhanced catalog configuration.
Password	5Y5_n0tification!	Password for the system notification user.

Enabling an enhanced catalog in BMC Digital Workplace

To enable an enhanced catalog in BMC Digital Workplace, the BMC Digital Workplace administrator must perform the following tasks:

To enable support for the enhanced catalog
To configure a connection between and

To enable support for the enhanced catalog

In the BMC Digital Workplace Admin console, go to Configuration.
Select Application Features, and select Enhanced Catalog to enable the feature.

To configure a connection between BMC Digital Workplace and BMC Digital Workplace Catalog

BMC Digital Workplace can be connected to a single BMC Digital Workplace Catalog server. For information about configuration details required to enable the connection, see Information required for the enhanced catalog configuration.

In the BMC Digital Workplace Admin console, go to Configuration.
Select Enhanced Catalog under Configuration.
Enter the information required for the enhanced catalog configuration:
Click Save.
Self-service users who are currently logged in will see the enhanced catalog the next time they log in.

When the enhanced catalog is enabled and configured, end users with Read license type in the enhanced catalog server database can view and request services and bundles they are entitled to access. For more details about service entitlements, see Entitling-end-users-to-services-bundles-and-banners.

Where to go from here

Setting-up-sections-in-the-Catalog