questionFieldMap

The questionFieldMap input parameter enables the population of any of the available fields against your request records.

The input is of type xs:string, but the API expects a string representation of a JSON object, with key-value pairs for each field needing updating, where they keys are the database field names and the values are in their native datatypes. The following example, when provided as a string to the questionFieldMap input parameter, would prompt the API to update the h_custom_a, h_custom_p, h_custom_21 and h_custom_26 fields angainst the target request:

{
  "h_custom_a": "A VARCHAR(255) string to be written into h_custom_a",
  "h_custom_p": "A LONGTEXT string to be written into h_custom_p",
  "h_custom_21": "2023-11-01 15:07:42",
  "h_custom_26": 42
}

connectionMap

The connectionMap input parameter enables the association of the request being created with users and contacts in the form of Request Connections.

The input is of type xs:string, but the API expects a string representation of a JSON array of objects, with key-value pairs in each object. The following example, when provided as a string to the connectionMap input parameter, would add two connections to the newly created request:

[
  {
    "connectionType": "connection.impacted",
    "userType": "account",
    "userId": "change",
    "comment": "I am impacted"
  },
  {
    "connectionType": "connection.interested",
    "userType": "contact",
    "userId": "42"
  }
]

The keys available to the connection objects are:

• connectionType - Mandatory - Type: xs:string - The type of connection. Values to use can be found in the requestConnectionType Simple List.
• userType - Mandatory - Type: xs:string - Can be account or contact, depending on whether the user being associated as a connection is a user of the Hornbill platform (basic or full), or an externally-supported organization contact.
• userId - Mandatory - Type: xs:string - The ID of the user.
• comment - Optional - Type: xs:string - A comment to associate to the connection.