User Tools
Writing /app/www/public/data/meta/development/applications/footprints/messages.meta failed
development:applications:footprints:messages
Differences
This shows you the differences between two versions of the page.
| Both sides previous revisionPrevious revisionNext revision | Previous revision | ||
| development:applications:footprints:messages [2018/02/23 14:57] – adowling | development:applications:footprints:messages [2021/06/25 10:09] (current) – external edit 127.0.0.1 | ||
|---|---|---|---|
| Line 1: | Line 1: | ||
| + | ====== RabbitMQ, The Ticketer & The Footprints Component Interaction ====== | ||
| + | --- // | ||
| + | |||
| + | ===== Applications & Services ===== | ||
| + | - Ticketer | ||
| + | - RabbitMQ | ||
| + | - Footprints Component | ||
| + | |||
| + | ==== Ticketer ==== | ||
| + | |||
| + | The Ticketer function within this integration reuses the AuditProvider Attribute Value Change(AVC) functionality in order to monitor for the status change events needed to trigger the email in the footprints_component. | ||
| + | As this process has already been documented in relation to the eBonding project, for further details on how this works see the following wiki entry: | ||
| + | [[development: | ||
| + | |||
| + | **Details to Note:** | ||
| + | - The booleans footprints.enabled = true and gormListener.enabled = true need to be set in the TicketerConfig.groovyfile for this process to work. | ||
| + | - RabbitMQ credentials must be set in the TicketerConfig.groovy file in order to connect to rabbitmq and create all queues, exchanges, bindings. | ||
| + | - Update events only are being monitored for AVC's on the Ticket domain: updateDomains = [" | ||
| + | - The trigger statuses for the email generation are FOT Dispatched and FOT Dispatched - Pending parts currently. | ||
| + | - The update which comes back to the Ticketer contains the Footprints Global Ticket Number which gets populated on the Field Technician Dispatch Form on the ticket which sent the audit event. | ||
| + | - The process handles the scenario in which a ticket is apart of a group. In this case the update will only occur on the parent ticket. If the parent is recalculated due to the SLA process i.e. the parent is now a child ticket, then the update will be received on the new parent ticket of that group. | ||
| + | |||
| + | **TicketerConfig.groovy Additions: | ||
| + | < | ||
| + | // footprints | ||
| + | // Parameter to turn on or off the footprints functionality [true | false] | ||
| + | // Default to false to avoid looking for the RabbitMQ and failing to start | ||
| + | footprints.enabled = true | ||
| + | // | ||
| + | auditableEvent { | ||
| + | domains{ | ||
| + | updateDomains = [" | ||
| + | } | ||
| + | } | ||
| + | |||
| + | |||
| + | // | ||
| + | gormListener.enabled = true | ||
| + | |||
| + | // The queues which need to be declared. | ||
| + | rabbitmq { | ||
| + | credentials { | ||
| + | username = ' | ||
| + | password = '# | ||
| + | host = ' | ||
| + | virtualHost = ' | ||
| + | } | ||
| + | queues { | ||
| + | //Incoming Message | ||
| + | ticketerInboundQueue = ' | ||
| + | |||
| + | //Outgoing Message | ||
| + | } | ||
| + | exchanges { | ||
| + | //Incoming Message | ||
| + | |||
| + | //Outgoing Message | ||
| + | ticketerAuditEventExchange=' | ||
| + | } | ||
| + | tags { | ||
| + | //Put the tags used for exchanges here | ||
| + | } | ||
| + | bindings { | ||
| + | //In the Form " | ||
| + | //Incoming Message | ||
| + | //Outgoing Message | ||
| + | } | ||
| + | |||
| + | numberOfTriesBeforeFail=1 | ||
| + | numberOfSecondsBetweeTries=1 | ||
| + | numberOfSecondsToWaitForRabbitReconnect = 30 | ||
| + | } | ||
| + | </ | ||
| + | |||
| + | |||
| + | ==== RabbitMQ ==== | ||
| + | |||
| + | RabbitMQ acts as the message broker for passing messages back and forth between the Ticketer and Footprints Component. This was chosen in order to leverage the AVC development within the Ticketer application | ||
| + | |||
| + | The RabbitMQ setup is handled in the bootstraps of both applications (footprints_component and ticketer). All credentials are available in the resepective grails configuration files for those applications. | ||
| + | |||
| + | * The TicketerConfig.groovy additions for this are detailed above. | ||
| + | * The FootprintsConfig.groovy details are linked here: [[development: | ||
| + | |||
| + | **Details to Note:** | ||
| + | - The Ticketer pushes out the AVC JSON messages onto the following exchange: // | ||
| + | - The Footprints Component consumes the footprintsOutboundQueue: | ||
| + | - This queue binds to the Ticketer Audit Event Exchange (// | ||
| + | - Valid Updates to the Ticketer are published onto the // | ||
| + | |||
| + | ==== Footprints Component ==== | ||
| + | The Footprints Component is used in the context of a MicroService in order to act as a go between for all logic required to connect the Ticketer and the ATC Footprints Application. The goal is to send and receive email via this application in order to create the ETA dispatch ticket and receive updates. | ||
| + | |||
| + | **Details to Note:** | ||
| + | - The email generation process is kicked off once a valid status change event is received from the Ticketer via RabbitMQ. | ||
| + | - We also poll the mailbox for responses from ATC containing a global ticket number mapping to the Footprints ticket and a valid Errigal ticket id in order to update the IDMS ticket. | ||
| + | - This poll generates a TicketUpdate which is formatted and pushed out to RabbitMQ in order for the Ticketer Application to receive and process into a form value update. | ||
Page Tools
