Set up of the integration interface

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.