Platform Service Standardization
Service will interact with the message bus through three topics.
Request - The service agent will listen to incoming requests on this topic
Response - The service agent will respond on this topic
Error - The service will “throw” errors on this topic
Agents which are using these services agents should publish to the above Request topic and listen on the Reponse and Error topics. Response and Errors will retain the header that was sent into the request.
Headers
Request Headers
Common Header Formats
type - Unique type of request for the service agent to handle (If an agent handles more than one request type on a specific topic)
requesterID - Name of the requesting agent
Header List
type - Unique type of request for the service agent to handle (If an agent handles more than one request type on a specific topic)
priority - HIGH, LOW, LOW_PREEMPT (Found in Scheduler and Activator)
taskId - Unique task among scheduled tasks.
window - Seconds remaining in timeslot (actuator agent)
SourceName - used as name to publish to in smap for archiver agent.
FROM - Same as requestor id (volttron.messaging.headers.FROM)
CONTENT_TYPE - volttron.messaging.headers.CONTENT_TYPE.JSON, volttron.messaging.headers.CONTENT_TYPE.PLAIN_TEXT Datalogger location is specified in the message itself.
Multibuilding
Cookie
Request Formats (Content-Types)
volttron.messaging.headers.CONTENT_TYPE.JSON
volttron.messaging.headers.CONTENT_TYPE.PLAIN_TEXT
Topic List
Platform Topics
platform/shutdown
agent/[agent]/shutdown