M Azure Service Bus

Current version: 3.3

The M Azure Service Bus action allows users to send data to an internal service bus provided by Sitecore Content Hub.

Configuration

When creating an M Azure Service Bus action, the connection string is automatically provided. The users only need to specify the action's name, label and request headers.

M Service Bus 1

Request headers

Azure service bus actions allow users to add headers to their request.

M Service Bus 2

Dynamic request headers

Message headers can have dynamic values pulled from the trigger context. When a create/update is triggered, the context contains the entity's property values and relation identifiers. When a delete is triggered, the context is empty.

The syntax for context variables is the same as for display templates (e.g. placing {Title} in the value field pulls the value of the entity's Title property. When using a relation name, the value will contain the target entity's identifier.

In both cases, when multiple values are available, the | character is used as a separator. When using a self relation, the resolved value has the following format: <parent values separated with '|'>;<child values separated with '|'>.

It is also possible to add message body values. The syntax is the same as for headers and will result in placing the defined values into a property called context inside the message body.

Sample payload for a save action:

RequestResponse
{
  "context": {
      "Title": "asset title"
  },
  "saveEntityMessage": {
    "EventType": "EntityUpdated",
    "IsNew": false,
    "TargetDefinition": "M.Asset",
    "TargetId": 10063,
    "TargetIdentifier": "DCQVyfb87kuL4RwvoYCIrA",
    "TimeStamp": "2019-03-05T14:30:47.9681811Z",
    "UserId": 6,
    "Version": 40,
    "ChangeSet": {
      "PropertyChanges": [
        {
          "Culture": "(Default)",
          "Property": "Title",
          "Type": "System.String",
          "OriginalValue": "sample value",
          "NewValue": "another sample value"
        }
      ],
      "Cultures": [
        "(Default)"
      ],
      "RelationChanges": []
    }
  }
}

Test connection

After configuring the M Azure service bus, users can test their connection via the User Interface by clicking the Test connection button. A HEAD request is sent to check if the endpoint is active.

Do you have some feedback for us?

If you have suggestions for improving this article,