1. Message Scenario Configuration Guide
  2. Setting Properties Using Agent Message Status

Setting Properties Using Agent Message Status

Using functionality similar to the set property method, agents can update properties and perform actions without additional scenario steps. All activity and inventory statuses and the predefined set of activity fields can be updated, and activities can be canceled and unscheduled.

This functionality allows:

  • Updating properties based on processing the result of a PAS scenario message and controlling further scenario flow based on these properties

  • Setting the ICOMS result property directly from the ICOMS agent without additional Set Property scenario steps

  • Canceling an activity based on customer selection

The fields to be assigned and the corresponding values are passed in the data field. The #params? string is used as the delimiter between data itself and the passed parameters. The format of the parameter line is similar to URL. The & character is used as the delimiter between different parameters.
data = OK#params?cconfirmed=1&phone=12345678912
data = #params?icoms_eta_status=1
data = DONE#params?pas_requires_feedback=1
data = #params?action=cancel_activity&notes=Rescheduled
Names and values of the parameters are encoded as the URL parameters. So, if the URL property needs to be assigned to http://localhost/v41/wwwroot/?param1=value1&param2=value2, the resulting data value should be as follows:
data = OK#params?CANCEL_REASON=0&URL=http%3A%2F%2Flocalhost%2Fv41%2Fwwwroot%2F%3Fparam1%3Dvalue1%26param2%3Dvalue2

The encoding requires that all non-ASCII and non-alphanumeric characters (with some exceptions) must be represented as hexadecimal values with leading '%'. Exceptions: the '.', ',', '-', '_' characters should be provided as is, and the ' ' (space) symbol is replaced with the '+' (plus).

The total length of the data field is restricted to 255 characters. If a submitted data value exceeds that limit, it can be processed correctly, but it will be truncated.