Use > Service Catalogs > Service Catalog management > Service Catalog connectors

Service Catalog connectors

Service Catalog connectors are the fulfillment mechanisms for creating new records in the database. The following table lists the out-of-box connectors for Service Catalog.

Connector Description
Open a Change Adds a Change record.
Open a Record Using Web Service Adds a record in an external system using web services.
Open a Standard Request in Asset Manager Creates a record in Asset Manager using a web service.
Open a Subscription Change Adds a Change record when a user requests a subscription to a published service.
Open an Incident Adds an Incident record.
Open New Request Adds a Request fulfillment record.

Connector Detail tab

The Connector Detail tab contains information about each of the Service Catalog connectors.

Field Description
Name Contains the name of the service request.
Record Type Contains the type of record to be created for this service request.
Link Record Contains a link record that describes the fields that relate information from one type of record to the other.
Process Contains a process for this service request. This process routes the service to the appropriate Service Manager application.
Wizard Contains the name of the wizard that runs when you add or edit the connector information of a Service Catalog item that uses this connector.
Description Contains a description of the process for this service request.
XML Fields Contains a field name that is used in the process to create the appropriate record in the appropriate Service Manager table.
Field Name Contains the actual database field name that maps to the XML field in the record.
Validity Check Contains an expression to validate the value of the field
Target Files Contains the name of the file where this target field matches with.
Target Fields Contains the name of the field in the target file where the XML field matches with.
XML Caption Contains a field caption for the field that will be used in the process to create the appropriate record in the appropriate Service Manager table.

Expressions tab

The Expressions tab contains information about the JavaScript expressions contained within each of the Service Catalog connectors. It contains an initialization expression that needs to be processed before adding the record.

This is an example of an initialization expression for the Create New Request connector.

if (filename($L.file)="request") then (category in $L.file=jscall("svcCatInterface.getXMLFieldValue", interface.info in $L.item, "category"))
if (filename($L.file)="request") then (subcategory in $L.file=jscall("svcCatInterface.getXMLFieldValue", interface.info in $L.item, "subcategory"))
if (filename($L.file)="request") then (bill.to.dept in $L.file=jscall("svcCatInterface.getXMLFieldValue", interface.info in $L.item, "department"))
if (filename($L.file)="request") then (company in $L.file=jscall("svcCatInterface.getXMLFieldValue", interface.info in $L.item, "company"))
if (filename($L.file)="request") then (model in $L.file=jscall("svcCatInterface.getXMLFieldValue", interface.info in $L.item, "requestModel"))
if (filename($L.file)="request") then (modelname in $L.file=jscall("svcCatInterface.getXMLFieldValue", interface.info in $L.item, "requestModelName"))
if (filename($L.file)="request") then (severity in $L.file=jscall("svcCatInterface.getXMLFieldValue", interface.info in $L.item, "severity"))
if (filename($L.file)="request") then (impact in $L.file=jscall("svcCatInterface.getXMLFieldValue", interface.info in $L.item, "impact"))

if (filename($L.file)="request") then (assigned.group in $L.file=jscall("svcCatInterface.getXMLFieldValue", interface.info in $L.item, "assigngroup"))

if (bundle in $L.cartItem=true and bundle.options in $L.cartItem~=NULL and bundle.options in $L.cartItem~="<bundle></bundle>") then (svc.options in $L.file=bundle.options in $L.cartItem)
if ((bundle in $L.cartItem=false or bundle in $L.cartItem=NULL) and options in $L.cartItem~=NULL and options in $L.cartItem~="</form>") then (svc.options in $L.file=options in $L.cartItem)

Modify an existing Service Catalog connector

  1. Click Service Catalog > Tailoring > Catalog Connectors.
  2. To bring up a record list of all the out-of-box connectors click Search.
  3. Select a connector. For example, click Open a Change.
  4. Add XML Fields for any customized fields you have in your forms.
  5. Change the Link Record to move any additional fields from the interactions record to the change record.
  6. Change Process to include anything that needs to happen to create the record.
  7. Change the wizard messages to include any new fields.
  8. Add, delete, or modify any of the RAD expressions on the Expression tab.
  9. Click Save.
    The connector is modified.