How to Configure CA SDM Data Source
Configure the CA SDM data source for the users to create, review, and update their requests directly within Unified Self-Service, and search knowledge base articles within the CA SDM Knowledge Base. In addition, you can enable Live Chat in the Unified Self-Service interface to allow users to chat with an IT analyst and also allow users to access the CA SDM mobile application.
Follow these steps:
Verify the following prerequisites before configuring the CA SDM data source:
- CA SDM 12.6, 12.7, or 12.9 must be installed and configured with Unified Self-Service.
- Create or use DEFAULT Web Services Access Policy from CA SDM. Ensure that you select the Allow Impersonate check box and you enter the Proxy Contact detail for this policy.
- Generate an authentication certificate for the Access Policy. CA SDM provides a server-side utility that can generate a certificate. Execute the following command from the CA SDM server to generate the certificate for the access policy:pdm_pki -p policy_nameThis command generates an authentication certificate filepolicy_name.p12. Upload this file during the CA SDM data source configuration with Unified Self-Service.
- Ensure that the Unified Self-Service users available in CA SDM have the same User ID and email address for a successful configuration.
- For Unified Self-Service users to use CA SDM live chat, Support Automation must be set up in CA SDM. For more information, see Support Automation.
Customize CA SDM Data Source Property
As an administrator, define the maximum number of CA SDM fields that a user can configure in the Unified Self-Service (USS) console.
Follow these steps:
- Log in to Unified Self-Service server as an administrator.
- Navigate to the OSOP folder and edit the file:portal-ext.properties
- In thesdm.configFields.maxFieldsToShowInConfigOptionsPageproperty, define the maximum number of CA SDM fields that you want to configure on the USS console.The default value is 10.
- (Optional) In a tenanted environment, you can set the maximum number of fields for each tenant using thesomeCompany.com.sdm.configFields.maxFieldsToShowInConfigOptionsPageproperty.
- ReplacesomeCompany.com with theWeb ID of the tenant.You can obtain the Web ID from the Portal Instance in the Control Panel:http(s)://server-name:<port-no>/group/control panel > Portal InstancesFor example,ca.com.sdm.configFields.maxFieldsToShowInConfigOptionsPage=20The value in thesdm.configFields.maxFieldsToShowInConfigOptionsPageproperty is overridden by the tenant specific values.
- Save the file and restart the services.
Configure CA SDM Data Source
Configure CA SDM data source for the users to create, review, and search information from CA SDM directly in Unified Self-Service.
Follow these steps:
- Log in to Unified Self-Service as an administrator.
- In the menu, click Settings, Data Sources.
- Click the arrow for the CA SDM data source and enter the following configuration information:
- NAMESpecifies the name for the CA SDM data source. This name is displayed in the header for search results from the CA SDM Knowledge Base.
- TICKET TYPEIndicates the type of Help desk tickets that are implemented in your organization.
- LABEL FOR TICKET TYPESpecifies the label that you want to associate with the selected ticket type.
- DEFAULT PRIORITYSpecifies the default priority level for new requests.
- URGENT PRIORITYSpecifies the priority level for urgent requests.
- BASE URLSpecifies the CA SDM server URL. To verify this value, enter the URL in a browser. If you see the CA SDM interface, then the value is correct.Format:http://<CA_SDM_Server_Hostname>:<Port_Number>/Example: http://servicedesk.test.com:8080
- WSDL URLSpecifies the relative URL of the web services endpoint on the CA SDM server. By default, this URL is generated for you. For some CA SDM deployment configurations, you may have to override this value with a value provided to you by CA Support.To verify this value, enter the complete URL in a browser, that is, the Base URL plus the WSDL URL. If the value is correct, you see an XML document (the WSDL).Example: http://servicedesk.test.com:8080/axis/services/USD_R11_WebService?wsdl
- SERVER HOST NAMESpecifies the servlet server as defined in CA SDM for Service Desk attachment repository. Since this host name is case-sensitive, run thehostnamecommand from the CA SDM server and enter exactly the same value that is returned from the command.In the advanced availability configuration, if you have used the background server host name for this field and the system administrator performs a scheduled failover, the background server becomes the standby server. You must add the new background server host name to this field after the failover.
- ACCESS POLICYSpecifies the name of the Web Services Access Policy as configured during the CA SDM installation and that is used to generate the authentication certificate. Use the access policy mentioned in the Verify Prerequisites topic.
- ClickUPLOAD CERTIFICATEto upload the authentication certificate that you created in the Verify Prerequisites topic. The certificate file name must match the name of theACCESS POLICY.
- Follow these steps to enable live chat:
- SelectYESto enable Live Chat from the Search, Home, and Request pages.
- (Optional) Customize the Live Chat link text (Default text: Chat with an IT Analyst now!).Users with OOTB Customer access type cannot create tickets (incident or request) or launch live chat from Unified Self-Service. The Customer access type must have Employee as the role in CA SDM to perform these actions. For more information, see Support Automation.
- In theINSTRUCTIONSfield, enter information that should appear at the top of new request forms.
- In theSERVICE DESK REST URL FOR MOBILE APPfield, enter the CA SDM server URL (where REST is installed and configured) to allow users to access the ITSM mobile application.Format:http://<CA_SDM_Server_Host_Name>:<Rest_Port_Number>/Example:http://<CA_SDM_Server_Host_Name>:8050/
- ClickTEST CONNECTION. If it fails, review the data that you entered and correct as necessary.
- When you are ready to enable the data source for your organization, set theSTATUStoEnabled.
- ClickSAVE.Unified Self-Service is integrated with CA SDM and the data source is available for your users. You can now configure the request form to include the fields and information that your organization requires.
Configure Request Form
You can configure the request form that your organization users use to create a CA SDM request. The request form comes prepopulated with some standard fields that cannot be modified. You must add the fields that your implementation of CA SDM requires to create requests. You can also add optional fields to record any other information. The requester can fill these fields, or you can design fields that automatically pass preset information. You can add as many fields as you need to the request form. The number of fields that you can configure is defined in the
portal-ext.propertiesfile. For more information about configuring the maximum number of default or tenant specific fields, see Configure CA SDM Data Source Property.
Note:This task assumes that you are working with a CA SDM administrator. Unified Self-Service cannot discern what fields your CA SDM installation requires to create a valid request.
Follow these steps:
- On the Data Sources page for CA SDM, clickCONFIGURE NOW.The field table listing the fields that are currently in use for request forms appears.
- To add new fields to the request form, do the following steps for each addition:
- Click the drop-down arrow and select the required field to add.
- ClickADD FIELD.
- Set values and properties for the new field as follows:
When you select the ticket type as an Incident, theDISPLAY NAMEandHINT TEXTvalues of the priority (string) field must be changed to an Urgent Incident. As a result, while creating the incident, you can see an Urgent Incident check box instead of an Urgent Request check box.
- DEFAULT VALUESets a default value for the new field.
- DISPLAY NAMEDefines the field name that displays on the request form.
- HINT TEXTDefines the instructional text that appears in the field.
- DISPLAYControls whether the field is visible on the request form.Limit: Five fields.
- REQUIREDIndicates the mandatory fields that you must define before you submit the request.
- (Optional) Drag and drop the new fields into the required order.
- ClickSAVE.Your request form changes are saved and all new requests reflect the new configuration.