Agents
An agent is always bound to exactly one event, but you can create multiple agents bound to the same event if necessary. When this event is published to the event topic, the agent(s) bound to this event will be triggered and then executed.
Create agents
Agents are defined using the following master data:
- Type: There is one option available and this is the Event Agent (required)
- Trigger Event: The event to which the agent will be bound (required)
- Local Identifier: This is the identifier (name) of the agent. It is unique within a namespace. Please note that only the characters A-z (without special characters), digits and the special character "_" are permitted for naming agents! Furthermore, names may not begin with a digit and the first character must be uppercase. Furthermore, names may not begin with a digit and the first character must be uppercase (required)
Agents cannot have the same Local Identifier as a command or a service in the same namespace.
Edit agents
You can edit the master data of a agent by clicking the Edit agent details button in the Agent Details section on the agent's instance page. Alternatively, you can use the Edit capability of each table row on the Agents tab of a domain namespace's Overview page. The fields that can be edited are Local Identifier and Trigger Event.
It's not possible to edit the Type of an agent.
Delete agents
You can delete a agent by clicking the Delete agent button in the upper right corner of the agent instance page. Alternatively, you can use the Delete capability of each table row on the Agents tab of a domain namespace's Overview page.
You will need to confirm the action before the selected agent gets permanently deleted.
Known limitations
Domain Service Projects (Java)
Currently it is not possible to retrieve events, if the payload is a parent entity and children entities are sent as playload.