Trigger Events

Grafeo integrates the Action Triggers framework into the service in order to enable automation whenever a new piece of information is added to the platform. This allows, for example, to trigger automatic data enrichment of added information or to receive notifications about new information of interest. For this purpose two trigger events are generated, one when a new Fact is added to the platform and one when an existing Fact is retracted (see details below). Consult the Action Triggers documentation here for more information about the framework and its usage, and also look at the example configurations in the executable/examples folder to learn how the generated trigger events could be used for automation.

FactAdded

The FactAdded trigger event is generated whenever a new Fact is added to the platform through the REST API. It contains the following information used during evaluation of trigger rules:

• service: GrafeoService
• event: FactAdded
• organization: Organization of the added Fact.
• accessMode: Access mode of the added Fact.
• contextParameters:
  • AddedFact: Added Fact as returned from the REST API.

FactRetracted

The FactRetracted trigger event is generated whenever an existing Fact is retracted through the REST API which will add a new retraction Fact to the platform. It contains the following information used during evaluation of trigger rules:

• service: GrafeoService
• event: FactRetracted
• organization: Organization of the retraction Fact.
• accessMode: Access mode of the retraction Fact.
• contextParameters:
  • RetractionFact: Added retraction Fact as returned from the REST API.
  • RetractedFact: Existing Fact which was retracted as returned from the REST API.