Context-Sensitive Help allows you to provide end users with quick and convenient access to help via an online performance support system. End users request help from the Server via a direct link in Siebel. To implement and use Context-Sensitive Help for Siebel you will perform three procedures:
- Create a custom help menu in Siebel.
- Record a Siebel document with the application and make this document available for Context-Sensitive Help.
- Request help from Siebel. For information on supported versions of Siebel, refer to the Technical Specifications.
Obtaining the Siebel Custom Menu eScripts
Download the Siebel Custom Menu eScripts from the Intelligence Hub. The following scripts were authored by ANCILE for use only by customers and partners. These scripts contain JavaScript code that redirects Siebel's existing Help link to a help page created with the application.
- uPerform_Service_PreCanInvokeMethod_Server.txt
- uPerform_ServicePreInvokeMethod_Browser.txt
Creating a Custom Menu In Siebel
|
NOTE:
|
We recommend creating a custom menu in the test environment and migrating the changes to the production environment after the changes have been complied and tested.
|
|
NOTE:
|
All actions within this procedure are performed in Siebel using Siebel Tools. For information on supported versions of Siebel, refer to the Technical Specifications.
|
- Create a new project to house changes needed to add a Context-Sensitive Help link from Siebel to the website. Be sure to include a name and description for the project.
- Check out the Context-Sensitive Help project.
- Check out the menu used in the target application.
- Create a new symbolic string for the menu item using the following values:
|
NOTE:
|
A symbolic string must be created for each locale.
|
|
Field
|
Description
|
|
Name
|
Enter a name for the symbolic string.
|
|
Current String Value
|
Enter the string value.
|
|
Project
|
Enter the project name created in Step 1.
|
|
Definition
|
Enter a definition.
|
|
Comment
|
Enter any amplifying information about the string.
|
- Save the string.
- Create a new business service using the following values:
|
Field
|
Description
|
|
Name
|
Enter a name for the service.
|
|
Project
|
Enter the project name created in Step 1.
|
|
Class
|
Enter the class.
|
|
Comment
|
Enter any amplifying information about the service.
|
- Save the service.
- Create a new Business Service Method called Uperform.
- Right-click on the business service you created in Step 6.
- Select Edit Server Scripts.
- Select eScript.
- Paste the provided script into the Service_PreCanInvokeMethod method.
- Save the server script.
- Right-click on the business service you created in Step 6.
- Select Edit Browser Scripts.
- Select eScript.
- Paste the provided script into the Server_PreInvoke method.
- Replace [Server Name] with the URL of the redirect.html page on the website.
- Save the browser script.
- Using Siebel Tools, create a new command using the following values:
|
Field
|
Description
|
|
Name
|
Enter a name for the command.
|
|
Project
|
Enter the project name you created in Step 1.
|
|
Business Service
|
Enter the business service you created in Step 6.
|
|
Display Name
|
Enter a display name for the command.
|
|
Show Pop-up
|
Ensure the Show Pop-up box is selected.
|
- Save the command.
- Create a new menu item for the menu project using the following values:
|
Field
|
Description
|
|
Name
|
Enter a name for the menu item.
|
|
Caption
|
Enter the string reference created in Step 4.
|
|
Command
|
Enter the command created in Step 20.
|
|
Position
|
Select the appropriate position.
|
- Save the menu project.
- Compile, test, and migrate the changes to the production environment.
Publishing the Website
The website must be published to a web server that is accessible by Siebel before authors can record documents. As part of website publishing, you will also generate quick launch pages to enable communication between the website and Siebel.
For information on publishing the website, refer to Publishing the Website.
For information on supported versions of Siebel, refer to the Technical Specifications.
Recording and Publishing a Siebel Document
- Record a Siebel document using the procedures described in Recording Procedural Content.
|
NOTE:
|
The recorder will automatically gather the view names for each screen as the author records the document and hard code the names into the document meta data.
|
- Edit the document using the procedures described in Editing and Formatting: Basics and Editing and Formatting: Procedural Content.
- Publish the document to the website using the procedures described in Building a Website.
- Republish the website using the procedures described in Publishing the Website.
Requesting Help From Siebel
- Log into Siebel as an end user.
- Navigate to the desired screen.
- Select .
- Siebel will open a new browser window displaying the following potential help options:
- If a single help document has been created, the document displays in the new browser window.
- If more than one help document has been created, a list of documents displays in the browser window.
- If no help document has been created, an HTTP 404 (Page Not Found) error displays in the new browser window.
- Choose from the following options:
|
If You Want To
|
Then
|
|
Select a help document
|
Click on the hyperlink for the document you wish to view.
|
|
Access the Siebel Help Center
|
Click Siebel Help in the upper left.
|
|
Return to Siebel
|
Close the browser window.
|