SAP trigger

Operation Name

SAP trigger

Function Overview

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

Ignition image

Properties

SAP trigger settings
Item name Content Remarks
Trigger name Enter the name of the trigger.  
Connection destination Select a global resource.  
Program ID Enter a unique value for the combination of [Gateway service name] and [Gateway host name].
Input the value specified here to program ID of RFC destination for SAP GUI.
  • When [RFC (including BAPI)] is selected in [Interface], you cannot register triggers which have the same [Business method] and [Program ID].
  • When [IDoc] is selected in [Interface], you cannot register triggers which have the same [Program ID].
Interface Select the format to receive data.
  • [RFC (including BAPI)]: (default)
    Select it when you specify an RFC function module for [Business method].
  • [IDoc]:
    Select it when you specify an IDoc for [Business method].
 
Search keyword Enter a keyword for an RFC function module (including BAPI) or IDoc for a search to be performed and click the [Search business methods] button.
  • A search will be performed on business methods which include the keyword in its name.
Business method Enter the basic type of IDoc or the general purpose module of RFC including BAPI.
  • When [RFC (including BAPI)] is selected in [Interface], you cannot register triggers which have the same [Business method] and [Program ID].
Extension type Enter the extension type of IDoc.
  • Enabled when [IDoc] is selected in [Interface].
Encoding Enter the encoding of IDoc segment data.
  • Enabled when [IDoc] is selected in [Interface].
  • The set value is effective only when the target SAP system is a non-Unicode system.
  • Generally there is no need of setting this property, since the encoding of targeted SAP system is acquired. Set the appropriate encoding when it is not registered properly, such as when IDoc segment data is garbled.
Reply Type Select synchronous execution or asynchronous execution.
  • [Synchronous]:(default)
    Performs synchronous execution. SAP Trigger waits for the executed script to finish and then returns the result data of the script to SAP system.
  • [Asynchronous]:
    Performs asynchronous execution. SAP Trigger does not wait for the executed script to finish, so it does not return the result data of the script to SAP system.
  • Enabled when [RFC (including BAPI)] is selected in [Interface].
Property Action
Item name Content Remarks
Search business methods Business methods will be searched for based on the string specified in [Search keyword].  
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 run by trigger.
  • Projects that was registered as a service are listed.
Script Select the script to be run 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 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 must be set in the script to be run.
Script outputs Script output variables that is set in script specified in [Script] appears.
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 must be set in the script to be run.
Execution option settings
For more information about Setting execution option, refer to "Execution option settings".

Trigger Variables

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

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

Management of TID

SAP trigger checks TID of IDoc sent from SAP system. SAP trigger do not execute script, and return SAP system as normal end when TID sent from SAP system has already been registered as state of success. TID is registered to 100000 TID by default. TID registered first is deleted and new TID is registered when over 100000 TID registration demand is requested.

Specification limit

Main exceptions

None.

Notes