Skip to main content

React to changes in FA data

You can integrate the FA Platform with your external system to receive messages about and react to changes in FA data.

Receive messages about core data type changes

You can receive messages when contacts, portfolios, securities, transactions, or trade orders are inserted, modified, or deleted in FA. The messages are sent to a service bus topic called “data-changes” and are available for up to 7 days. The messages only indicate the data type, the action (create, update, or delete), and the object ID.

You can use this functionality for synchronization, for example, by implementing API calls to fetch the updated information that your external sysem uses. To start using this functionality, contact FA.

The following are example messages:

Data type

Create

Update

Delete

Contact

{"dataType":0,"action":0,"id":10674998}

{"dataType":0,"action":1,"id":10674998}

{"dataType":0,"action":2,"id":10674998}

Portfolio

{"dataType":1,"action":0,"id":10776195}

{"dataType":1,"action":1,"id":10776195}

{"dataType":1,"action":2,"id":10776195}

Security

{"dataType":2,"action":0,"id":10745094}

{"dataType":2,"action":1,"id":10745094}

{"dataType":2,"action":2,"id":10745094}

Transaction

{"dataType":3,"action":0,"id":29803728}

{"dataType":3,"action":1,"id":29803728}

{"dataType":5,"action":2,"id":29803728}

Trade order

{"dataType":4,"action":0,"id":29803729}

{"dataType":4,"action":1,"id":29803729}

{"dataType":5,"action":2,"id":29803729}

Define custom integrations to service bus topics

FA Developer allows you to gain value from the messages you receive about data changes when you define custom integrations to the service bus topics. The following is an example Camel route that prints the content of messages arriving in the “data-changes” topic:

<route id="custom-data-changes-listener">
    <from uri="amqp:topic:data-changes/subscriptions/customlistener"/>
    <log message="Received message: ${body}"/>
</route>

In this example, the messages are simply recorded in connector microservice system logs. To synchronize FA Platform data with your external system, you can use Apache Camel (for example, REST API) to send the message content to your external system.