UNDER CONSTRUCTION
Create a technical user or choose an existing user
You need a technical user on ServiceNow side for communication from SAP Solution Manager to ServiceNow.
Logon to your ServiceNow Instance with the technical user
Please check the logon to your ServiceNow Instance with the technical user created in the step before.
Verify authorizations
Required role: Admin
Go to All → System Security → Users and Groups → Users
Click “New” to create a new user.
Make sure “Internal Integration User” is selected and a password is set.
This users logon will be needed for the definition of the RFC destination on SAP side.
Configuration REST Message
Required Roles: admin or web_service_admin.
Go to All → System Web Services → Outbound → REST Message
Look for CC4_rest and open the record.
Choose under tab Authetification
Authentification type - Basic
Basic auth profile - create a authentification profile with SAP logon user and password
Configuration Customizing
After installing the application, there will be some demo data for the configuration of the payloads (“parameter” set to *_payload)
Required role: x_calmg_cc4.customizing_user
Go to All → CC4 → Customizing
Create new entries:
With “Parameter” you can select what to configure.
Configuration ext_sys_guid
The ext_sys_guid defines the name of the configuration profile on SAP-side.
Choose “ext_sys_guid” for Parameter and enter as Value the name of your SAP-side configuration profile.
This will address the given configuration profile and is the default value for all tickets, unless redefined in specific payload definition (see section 3.3.2)
Configuration URLs
host endpoint and jump url are required to enable the communication to the SAP system and creation of a jump-link to the connected ticket.
Host endpoint
Select host endpoint for Parameter and enter the URL to your SAP instance in Value.
Your URL may look something like https:// <instance name>.sap.<firm name>.com:<port>.
Please use https:// to ensure security.
Jump URL
Select jump url for Parameter and enter the url of your SAP instance in Value.
Your url may look something like https:// <instance name>.sap.<firm name>.com:<port> (most likely will the port differ from the url in “host endpoint”).
1.1.3. Configuration payloads
For parameter ending with _payload you can define fields of the ticket, which you want to send to SolMan.
For the following payload definition Value does not need to be filled.
Payload are name-value pairs, where name is the attribute name on the SolMan side and value the technical field name of the task you want to synchronize or a constant value.
Attributes marked red are mandatory.
1.1.3.1. update_payload
The definition for update is general for every task type you want to synchronize. It is needed to synchronize the changes of state applied to the ticket:
E.g.: “IVEXTID” is the name of the attribute concerning the external ticket ID (from SolMan perspective) and “number” addresses the number of your SNOW ticket.
This configuration is as shown so far complete. But don’t forget to activate (1) your configuration.
1.1.3.2. incident_payload
Here you can define the payload to be sent specifically for incidents:
You can add or delete (1) attributes in the payload description, but don’t change any of the mandatory payload. Optionally you can also add the attribute “IVEXTSYSGUID” to define the ext_sys_guid specifically for this task_type.
In the end don’t forget to activate (2) your configuration.
1.1.3.3. incident_task_payload
Here you can define the payload to be sent specifically for incidents:
You can add or delete (1) attributes in the payload description, but don’t change any of the mandatory payload. Optionally you can also add the attribute “IVEXTSYSGUID” to define the ext_sys_guid specifically for this task_type.
In the end don’t forget to activate (2) your configuration.
1.1.3.4. change_task_payload
Here you can define the payload to be sent specifically for change_tasks:
You can add or delete (1) attributes in the payload description, but don’t change any of the mandatory payload. Optionally you can also add the attribute “IVEXTSYSGUID” to define the ext_sys_guid specifically for this task_type.
In the end don’t forget to activate (2) your configuration.
It is also possible to send custom fields or nested field content.
For example: “IVCUSTOM01” is an attribute that can refer to a customized field on SolMan or Snow side, in this case a custom field on SolMan side. If we define “change_request.number” the Number of the change_request connected to the current change_task will be send.
With “change_request” we reference the field “Change request” and with “.number” we access the ticket number of this Change request.
Register/Refresh HTTPS certificate - Download in ServiceNow
Please access your ServiceNow Instance e.g. by using the URL https://<host>:port/.
Open certificate e.g. in Chrome by clicking the lock next to the URL and select “Connection is secure“ and “Certificate is valid”.
In the “Details”-tab of the certificate-viewer you can export the certificate.
now that you’ve downloaded the certificate, you need to import it into your SAP system.
Goto your SAP system and perform logon.
Call transaction STRUST.
Select node “SSL Client DEFAULT”.
Execute menu action Certificate → Import.
Select certificate file previously saved.
Add imported certificate to certificate list by pressing the related button.
Perform save.
In the “Details”-tab of the certificate-viewer you can export the certificate.
Create RFC Destination to ServiceNow
Open transaction
SM59
and Edit → Create.
Name: <Whatever you want> (Proposal: ServiceNow)
Type: G HTTP Connection to external server
Technical Settings
Host: <Host of ServiceNow Instance>
(You can find host and port of your ServiceNow instance in your URL address bar of your internet browser when logging into or working with ServiceNow)Port: 443
(For HTTPS or 80 for HTTP or whatever is used in your landscape.)Path: Empty
Logon & Security
Authentication: Basic
Username: ServiceNow-technical user with admin roles (or technical user with similiar authorizations)
Password: <the user's password>
Security: SSL with Certificate stored in DEFAULT SSL Client secure store
Please test your connection:
If you receive an HTTP status code 200 the connection is working. If you receive an error message, please verify host, port, username and password. Please ensure that a valid certificate is uploaded to STRUST
.
Check connection
UNDER CONSTRUCTION
Create and maintain a configuration profile
Please refer to page /wiki/spaces/CC4C/pages/6459261061 for details.