Manage Customizations

Concepts

The Service Manager Service Portal Administrator can customize various aspects of the Service Manager Service Portal for an organization.

Tasks

The Administrator can perform these tasks in the Customization view:

• View Customizations
• Add a New KeyPair
• Edit KeyPair
• Delete KeyPair

View Customizations

To view all of the customizations for an organization:

1. Click the Identity application in the Launchpad.
2. In the Organization List view, click the organization that contains the customizations you want to view.
3. In the Organization Details view, click Customization.

The Customization view is displayed and all of the organization's KeyPairs and their values are listed.

Add a New KeyPair

To add a new KeyPair to an organization:

1. In the Customization view, click Add KeyPair.
2. In the Create KeyPair dialog, type a descriptive KeyPair Name and a Value. You can also specify the new KeyPair to be publicly accessible.
3. Click Save to finish and save your changes.

The new Service Manager Service Portal KeyPair for the organization is added.

Edit KeyPair

To edit a KeyPair in an organization:

1. In the Customization view, for the KeyPair you want to edit, click the edit icon.
2. In the Edit KeyPair dialog, you can change the Value for the KeyPair. Additionally, you can also specify if the KeyPair is publicly accessible.
3. Click Save to finish and save your changes to the KeyPair.

Delete KeyPair

To delete a KeyPair from an organization:

1. In the Customization view, for the KeyPair you want to delete, click the delete icon.
2. Confirm deletion of the KeyPair.

The Service Manager Service Portal KeyPair for the organization is deleted.

Customization Fields

Application Labeling

KeyPair Value	Description
portalTitle	Type a name that displays on the login screen and header of your organization's portal.
portalWelcomeMsg	Type a welcome message that displays below the Application Name when a user logs into your organization's portal.
portalFooterMsg	Type a footer message that displays below the login screen and header of your organization's portal.
portalLegalNoticeUrl	Type the link to your organization's legal or copyright statement that displays on the login page below the Log In button of your organization's portal.

 

External Organization Links

KeyPair Value	Description
portalLegalNoticeUrl	Type the link to your organization's legal notices statements.
portalShowTermsOfUse	Not applicable.

 

Application Enhancements

KeyPair Value	Description
featuredCategory	Type a featured category to use when displaying service offerings.
portalEndDatePeriod (12 months)	Not applicable.
portalEnforceEndDate	Not applicable.
portalShowConfirmDialog	Not applicable.
portalShowLegalNotice	Enables and disables showing a legal notice (portalLegalNoticeUrl) in the footer of the Identity application. Set to “true” to enable (default) or “false” to disable the feature.
requestOnBehalf	Enables and disables request-on-behalf feature. Set to “true” to enable (default) or “false” to disable the feature.
autoLogin	By default, this parameter is set to "false". When users launch Service Manager Service Portal, the user's organization splash page (with the organization's logo, title, and a Login button) is displayed. If this parameter is set to "true", when users launch Service Manager Service Portal, the organization splash page is bypassed and users are directly directed to a login page that prompts for a username and password. Important Do not set this parameter to "true" when SAML Single Sign-On (SSO) is not enabled for Service Manager Service Portal.
sortDropdownList	Enables and disables alphanumeric sorting in drop-down lists. Set to “true” to enable or “false” (default) to disable the feature.
enableOneRequestPerItem	By default, this parameter is set to "false," when you order multiple identical items, the items will be placed in one single request. For example, you order item A x 1, item B x 2, and item C x 2, if "enableOneRequestPerItem" is set to "false," three requests (PRxxx) in Service Manager Service Portal and one interaction (SDxxx) in Service Manager will be created. When this parameter is changed to "true" and the following three steps are performed on the Service Manager Service Portal host server, a request is created for each item. In the example above, five requests (PRxxx) in Service Portal and three interactions (SDxxx) in Service Manager will be created. Run the following command to edit the adapter.properties file: #vim /opt/hp/propel/sx/WEB-INF/adapter.properties Add the following line to the bottom of the file: adapter.sm.externalApproval.enableOneRequestPerItem=true Run the following commands to restart the services: # service jetty-sx restart # service catalog restart
dropdownTriggerSearch	The Service Portal drop-down lists provide a type ahead feature for searches. By default, after you type three characters in the text box, the system automatically displays the suggested search results. If you want to trigger the search function with one or two characters, enter the characters and press the Tab key. You can also modify the value of this property to change this behavior. For example, change its value to 0 and the system will display the suggested search results right after the first character is entered.

 

Themes

KeyPair Value	Description
themeName	Type the custom theme name to change the appearance of the Launchpad and applications in the Service Manager Service Portal. For details about unique color themes, refer to Service Manager Service Portal Administration.

 

Security Settings

KeyPair Value	Description
securityLevel	Not applicable.
disclaimerText	Not applicable.

Widgets

A default set of Service Manager Service Portal widgets are provided. You can add these widgets to your organization's Launchpad. These widgets include:

• PropelLink (URL)
• Clock

Customize Widgets

Custom widgets are created by changing the KeyPair values, and allow you to add functionality that appears as a tile on the organization's Launchpad.

KeyPair Value	Description
widget:PropelLink	This widget connects your organization to the product website.
widget:Clock	This widget shows date information on the Launchpad, including month, day, and year.
Custom Widgets	Custom Widgets can be configured by clicking the edit icon for the widget KeyPair. Provide an easily readable display name for the KeyPair, and input the properties for the widget in the Value box. Note that only 10,000 characters are allowed in the KeyPair Value box. For the Service Manager Service Portal to recognize a custom widget it must be named with a "widget:" prefix. See the format of default widgets for an example of this convention.

Widgets Best Practices

If you want to delete a widget, click the delete icon for the widget in the Customization view. Please note that this operation is permanent and cannot be undone.

Localizing Content

The following organization attributes can accept localized content:

• portalTitle
• portalWelcomeMsg
• portalFooterMsg
• disclaimerText

Make sure your browser has the desired language activated in settings. Follow the Edit KeyPair process for the attribute you want localized. You will see localized content for these fields the next time you log into the Service Manager Service Portal.

 

Related Topics

• Manage Organizations – Create, revise, and delete organizations.
• Manage Languages – Add, set as default, and delete languages within a Consumer organization.
• Manage Authentications – Set up LDAP authentication or SAML authentication for your new organization. You will set your LDAP attributes and privileges for members, groups, and other basic authentication information for integration with your organization.
• Manage Roles – Associate roles to groups and remove roles from groups.
• Manage Groups – Create, revise, and delete groups within an organization.
• Manage Permissions – Associate groups and permissions to roles and remove groups and permissions from roles.
• Manage Impersonations – For request on behalf, create and delete impersonations.
• Service Manager Service Portal Automation License – Manage Service Manager Service Portal licensing.