Configure access to the RESTful services of your ServiceNow instance:
- Create a ServiceNow® user for access from Alfabet to ServiceNow. The information about the user ID and user password must later be entered in the Alfabet integration configuration.
- Assign the following roles for the user:
- admin
- import_admin
- itil
- itil_admin
- oauth_admin
- oauth_user
- personalize_dictionary
- rest_api_explorer
- rest_service
- soap
- soap_query
- Register an application for Alfabet access via RESTful service under System OAuth > Application Registry. The information about the user ID and user password must later be entered in the Alfabet integration configuration.
- Install the Insert Multiple Web Services plugin.
- Create a custom attribute called Alfabet ID for the CI class Business Application using the standard values for attributes.
- Create an inbound web service with a transformation map. To use the pre-configured interface without changes to the configuration in ADIF schemes and XML objects accessible in Alfabet Expand, the following settings must be used in the system web service:
- Label: accelerator_business_application
- Name: u_accelerator_business_application
- Target Table: Business Application [cmdb_ci_business_app ]
- Web Service Fields:
Label Name Length Alfabet ID u_alfabet_id Default (40) Architecture Type u_architecture_type Default (40) Description u_description Extra Large (4000) Development Type u_development_type Default (40) End Date u_end_date Default (40) ImportSysID u_importsysid Default (40) Name u_name Default (40) Number u_number Default (40) Object State u_object_state Default (40) Start Date u_start_date Default (40) - Transform Map settings:
Source field Target Field Coalesce Remark u_alfabet_id u_alfabet_id false This is a custom attribute. The target field might differ in the name given here. u_architecture_type Default (40) false u_description Extra Large (4000) false u_development_type Default (40) false u_end_date Default (40) false The Date format attribute must be set to MM/dd/yyyy in the setting of the source field for this transform field map. Click on the link in the mapping table to access the attributes of the transform field map. u_importsysid Default (40) true This setting is required for mapping of data between Alfabet and ServiceNow. While you can store other values in custom attributes in ServiceNow instead of using the setting described here, it is mandatory to map the ImportSysId to the Sys ID in ServiceNow and to set Coalesce to true for this mapping. u_name Default (40) false u_number Default (40) false u_object_state Default (40) false u_start_date Default (40) false The Date format attribute must be set to MM/dd/yyyy in the setting of the source field for this transform field map. Click on the link in the mapping table to access the attributes of the transform field map.
Data required on Alfabet side to set up the integration interface: Setup of the interface on Alfabet site is done by the Alfabet cloud operations team. You must provide the following variables for the setup.
| Alfabet Variable | Description |
|---|---|
| ServiceNowUserName | The user ID for access to ServiceNow. The user must have the required access permissions granted with the roles listed above. For example, User1. |
| ServiceNowPassword | The user password for access to ServiceNow. For example, Password1 |
| ServiceNowClientID | The Client ID for the OAuth endpoint at ServiceNow. For example, a8386525ebded200eed8ab8e9fc61. |
| ServiceNowClientSecret | The Client Secret for the OAuth endpoint at ServiceNow. For example, secret1. |
| ServiceNowInstanceURL | The URL of the ServiceNow instance. For example, https://instance.service-now.com / |