Trigger - Xyna-Factory/xyna GitHub Wiki

Triggers are coded Deployment Items that create events, which may then be transformed into Xyna Orders by Filters.

The Deployment Item (containing JAR file and configuration) of a Trigger is first registered in Xyna Factory, and afterwards a corresponding Trigger Instance is created with Trigger specific Start Parameters. The Trigger Instance can then be enabled or disabled. A Trigger Instance is not actually running and creating events until it is enabled.

Triggers typically abstract network protocols such as HTTP or DHCP. Each event corresponds to a socket or a TCP connection. A Trigger may therefore listen on a server socket for incoming requests and then creates events for each of them. Afterwards, Filters have the task of deciding how to handle these events. Other examples include access to messaging systems (queues) or file system.

Each Trigger has different properties that define how the created Trigger Instances work. For example, a socket based Trigger needs an IP address and a port where the server socket listening at. The implementation of the Trigger defines the Start Parameters, which have to be specified when creating a new Trigger Instance.

Management is mainly done via the CLI:

 # Register a new Trigger or update an existing one
 ./xynafactory.sh '''help''' addtrigger
 
 # List all Triggers and their Start Parameter definitions
 ./xynafactory.sh '''listtriggers''' -v
 
 # Create a Trigger Instance
 ./xynafactory.sh '''help''' deploytrigger
 
 # Enable/Disable a Trigger Instance
 ./xynafactory.sh '''help''' en-/disabletriggerinstance
 
 # Create an [[Java Template|implementation template]]
 ./xynafactory.sh '''help''' buildtriggerproject

Trigger and their Instances can be added to an Application Definition in the Workspaces section of the Xyna Factory Manager. Those, that are contained in an Application can be enanbled and disabled by starting and stopping the Application, respectively.

Refer to the javadoc in the downloaded implementation template.

• HTTP Trigger
• SNMP Trigger
• Oracle AQ Trigger
• Websphere MQ Trigger
• Active MQ Trigger
• SFTP/SCP Trigger
• DHCP(v4/v6) Trigger
• UDP Trigger
• SML Trigger
• Radius Trigger

• Filter