SAP trigger

Operation Name

SAP trigger

Function Overview

SAP trigger is the trigger function that executes scripts by outbound processing from SAP system.

About SAP EICS, refer to the document "SAPEICSInstallGuide.pdf" included in the product installer.

Ignition image

Properties

SAP trigger settings

Item name	Content	Remarks
Trigger name	Enter the name of the trigger.
Component	Select a component to be watched.	The integration component list created on SAP EICS is shown.
Event	Select a watch event.	Shows a list of event created on SAP EICS. The same combination of a component and an event cannot be specified in multiple triggers.

Execution content settings

Item name	Content	Remarks
Trigger owner	Select the owner of the trigger to be created.	Can only select users with administrator privileges. (Ordinary users can select themselves only.)
Execution user name	Select the user to run the script specified by [Script].
Password	Type the password associated with the user specified by [Execution user name].
Service	Select a service containing the script to be ran by trigger.	Projects that was registered as a service are listed.
Script	Select the script to be ran by trigger.	Scripts in the service specified at [Service] are listed.
Script arguments	Script input variables which are set in the script specified at [Script] are listed.	Script output variables do not be shown. Refer to "Input variable / Output variable" for how to set script input variables on a script and use them.
Script arguments / Variable name	Script variable name is displayed.	Can not be edited.
Script arguments / Type	Script variable number type is displayed.	Can not be edited.
Script arguments / Value	Enter a script variable value.	Trigger variables can be specified from [Advanced operations] window. XML script input variables is required to be set in the script ot be ran.
Script outputs	Script output variables that is set in script specified in [Script] appears.	The script input variables do not be listed. Refer to "Input variable / Output variable" for how to set script output variables on a script and use them.
Script outputs / Variable name	Script variable name is displayed.	Can not be edited.
Script outputs / Type	Script variable number type is displayed.	Can not be edited.
Script outputs / Value	Enter a script variable value.	Trigger variables can be specified from [Advanced operations] window. XML script output variables is required to be set in the script to be ran.

Execution option settings

For more information about Setting execution option, refer to "Execution option settings".

Trigger Variables

The system can exchange data between a execution script and SAP via Trigger. Data is exchanged with XML type script input/output variables.

Trigger variable name	Value	Content	Remarks
XML input	trigger.standardInput	XML data transfered from SAP to the script.	"${trigger.standardInput}" must be specified at [Script arguments / Value]. Example:${trigger.standardInput}
XML output	trigger.standardOutput	XML data transfered from the script to SAP.	"${trigger.standardOutput}" must be specified at [Script outputs / Value]. Example:${trigger.standardOutput}

Timeout settings

If much time is spent to connect between a SAP trigger and an OpenJMS server, you can set timeout to abort the process.

Key	Allocation	Description	Remarks
trigger.sap.rmi.connection.timeout	$DATASPIDER_HOME/server/plugin/trigger/modules/sap_trigger/META-INF/ sap_trigger.properties	Timeout value of the connection between SAP triggers and OpenJMS servers.	Default value is "3000". The unit is milliseconds.

Specification limit

It cannot exchange data with the script by any script input/output variables of types other than XML type.

Main exceptions

None.

Notes

After registering trigger, if you change the status of the services and scripts that are set to trigger (or add/delete script variables, change service name/script name), those changes are not reflected in the registered trigger.
Open the properties of the trigger, then reselect services and scripts and click [Finish] to re-register.

If you set detailed level to log level, size of file $DATASPIDER_HOME/server/logs/server.error.log may become bigger due to many output log message. In such case, use log level such as WARNING、SEVERE, OFF. For details on log level settings, refer to Here.