ASM Self Service Portal URLs
This section lists the areas of the Self Service Portal that can be accessed using a URL from an external source, such as a website, or from within the Self Service Portal, such as from My Options.
Create links to the Self Service Portal to perform a wide range of actions, such as opening specific submission forms, pre-populating fields, submitting forms, and retrieving data.
This is particularly useful if you want to access functions of the Self Service portal without the need to have users go into the portal.
Example: An organisation has a well established intranet and would like to integrate specific portal functions into it instead of building and subsequently launching a separate portal for users.
Portal URLs have various Form parameters which can be set to a particular portal page; for example, the page for reviewing calls, requests, tasks, or knowledge articles.
All URLs that follow contain the minimum parameters required to achieve the documented goal. Additional optional parameters can be added to the URL.
My Options
When using these URLs in My Options the full address is not required. Include only the portion of the URL that follows <portal.aspx>
For example, the full address for the Self Service Portal Knowledge Search page is http://<server_name>/<virtual_directory>/portal.aspx?&Form=KnowledgeSearchCriteria so you would enter ?&Form=KnowledgeSearchCriteria into the URL field in My Options.
Access the Self Service Portal
Replace "core.aspx" with "portal.aspx" in any URL denotes the Self Service Portal interface.
Description of the URL
Description of Variable Parameters
Use this URL to launch the Self Service Portal
<server_name> = replace with the name, domain name or IP address of the web server
<virtual_directory> = replace with the name of the virtual directory specified in the Server Console
Generic Parameters for Self Service Portal URLs
The following parameters can be added as an extension to the URL used to launch the Self Service Portal:
Parameter
Description
Partition
http://<server_name>/<virtual_directory>/portal.aspx?&Partition=<X>
where <X> is the unique reference number of the partition
http://localhost/test/portal.aspx?& Form=KnowledgeSearchCriteria&Partition=2
If using a partitioned system, you can define portal URLs to refer to a specific partition.
The example launches a knowledge search submission window in the HR partition that has the REF value of 1 in the database.
Partitions are created in System Administration.
The unique reference is found in REF.SU_PARTITIONS in the database.
Specifying a partition in a URL does not bypass normal partition permission behaviors.
Access to partitioned data is controlled by the partition settings configured for the system, and the partition permissions assigned to each person.
Database
http://<server_name>/<virtual_directory>/portal.aspx?&database=<X>
where <X> is the name of the ASM System
http://localhost/test/portal.aspx?& Form=KnowledgeSearchCriteria&Database=test
If multiple systems exist on the server, you can define portal URLs to refer to a specific system.
The example launches a knowledge search submission window in the Test system.
Systems are created in the ASM Core Server Console.
Portal
http://<server_name>/<virtual_directory>/portal.aspx?&portal=<X>
where <X> is the portal system key
http://localhost/test/portal.aspx?& Form=KnowledgeSearchCriteria&portal=NY
If there are multiple portal systems, you can define portal URLs to refer to a specific portal system.
This example launches a knowledge search submission window in the New York portal system.
Self Service Portal Systems are configured in System Administration.
Automatically Log into the Self Service Portal
Description of the URL
Description of Variable Parameters
Use this URL to log on to Self Service Portal automatically. By supplying the login ID, password, and database name in the URL, the login screen can be bypassed.
This URL is only valid if Integrated Security is disabled for the portal.
<server_name> = replace with the name, domain name or IP address of the web server
<virtual_directory> = replace with the name of the virtual directory specified in the Server Console
<user> = replace with the login ID
<pwd> = replace with the password that corresponds to the user_id
Constant Parameter:
BTN_OK=OK is required to simulate the action of selecting the OK button on the login window.
Retrieve a Password
Description of the URL
Description of Variable Parameters
Use this URL to have your password emailed to your email address. A person record must exist with that email address.
<server_name> = replace with the name, domain name or IP address of the web server
<virtual_directory> = replace with the name of the virtual directory specified in the Server Console
<email> = replace with the email address of the person
Constant Parameters:
ForgotPassword is the function to retrieve a password
BTN_OK=OK is required to simulate the action of selecting the OK button on the login window.
Change a Password
Description of the URL
Description of Variable Parameters
Use this URL to change your password.
You will be prompted to log in, do so with your old password. After you have successfully logged in with your old password, a message will appear at the top of the page confirming your password has been successfully changed.
This URL is only valid if Integrated Security is disabled for the portal.
<server_name> = replace with the name, domain name or IP address of the web server
<virtual_directory> = replace with the name of the virtual directory specified in the Server Console
<user> = replace with the login ID
<old> = replace with the password that corresponds to the login ID
<new> = replace with the new password you wish to change to.
Constant Parameters:
ChangePassword is the function to change a password
BTN_OK=OK is required to simulate the action of selecting the OK button on the login window.
Knowledge Bank
Access Knowledge Bank Search
Description of the URL
Description of Variable Parameters
Use this URL to access the Portal Knowledge Search criteria page.
KnowledgeSearchCriteria is not valid for the Catalog Portal. It is only valid for the Self Service Portal.
<server_name> = replace with the name, domain name or IP address of the web server
<virtual_directory> = replace with the name of the virtual directory specified in the Server Console
Constant Parameter:
KnowledgeSearchCriteria is the name of the Knowledge Search page
The Knowledge Search page in the Self Service Portal can be pre-populated by appending parameters to the basic Knowledge Search URL. For a list of parameters available for the search window, refer to Knowledge Search.
View a Knowledge Article
Description of the URL
Description of Variable Parameters
Use this URL to view the details of a Knowledge article.
http://<server_name>/<virtual_directory>/portal.aspx?&TemplateName= LiteKnowledgeSearchResults&BTN_SELECT22=View
The example URL opens the review page for knowledge article 22 in the portal.
<server_name> = replace with the name, domain name or IP address of the web server
<virtual_directory> = replace with the name of the virtual directory specified in the Server Console
<ref> = replace with the unique reference number of the knowledge article
Constant Parameters:
LiteKnowledgeSearchResults is the name of the template for knowledge articles
BTN_SELECT<ref>=View is the function that opens the knowledge article details.
The unique ref of the article must be inserted into this parameter.
Incidents
Access Incident Search
Description of the URL
Description of Variable Parameters
Use this URL to access the Review Past/Current Incidents search criteria page.
<server_name> = replace with the name, domain name or IP address of the web server
<virtual_directory> = replace with the name of the virtual directory specified in the Server Console
Constant Parameters:
CallSearchCriteria is the name of the Incident Search page
The Review Past/Current Incidents window can be pre-populated by appending parameters to the basic Incident search URL. For a list of parameters available for the search window, refer to Incident Search.
Review an Incident
Description of the URL
Description of Variable Parameters
Use this URL to view the details of an Incident.
http://<server_name>/<virtual_directory>/portal.aspx?&Form=Call&Mode=Review&Call_Number=22
The example URL opens the review page for Incident number 22 in the portal.
<server_name> = replace with the name, domain name or IP address of the web server
<virtual_directory> = replace with the name of the virtual directory specified in the Server Console
<ref> = replace with the unique reference of the call (CALL_NUMBER.CL_CALL_LOGGING)
Constant Parameters:
Form=Call is the name of the call page file
Mode=Review is required
Open an Incident Submission Form
Description of the URL
Description of Variable Parameters
Use this URL to open a submission form using a specific call template.
http://<server_name>/<virtual_directory>/portal.aspx?&Form=Call&Mode=New&Template_Ref=99
The example opens the call submission form for the New Starter call template (call_number=99).
<server_name> = replace with the name, domain name or IP address of the web server
<virtual_directory> = replace with the name of the virtual directory specified in the Server Console
<ref> = replace with the unique reference of the call template (CALL_NUMBER.CL_CALL_LOGGING where TEMPLATE_IND=1)
Constant Parameters:
Form=Call is the name of the call page file
Mode=New is required
Log an Incident
Description of the URL
Description of Variable Parameters
Use this URL to log an Incident using a specific call template.
http://<server_name>/<virtual_directory>/portal.aspx?&Form=CallDetails&Mode=New&Template_Ref=99&Ref_Composite=1&BTN_OK=Submit
The example above opens the Logged Incident confirmation page after logging an incident using the New Starter call template (call_number=99), and with a Type value of Unspecified (ref=1).
If the call template has not been assigned to an analyst or group, the Forward_To=<assign_ref> parameter must be appended when logging an incident. <assign_ref> is the unique ref of the analyst or group the call should be forwarded to on submit.
<server_name> = replace with the name, domain name or IP address of the web server
<virtual_directory> = replace with the name of the virtual directory specified in the Server Console
<ref> = replace with the unique reference of the call template (CALL_NUMBER.CL_CALL_LOGGING where TEMPLATE_IND=1)
<type> = replace with the unique reference of the Type (REF.CL_PROBLEM_TYPE).
Constant Parameters: