Run SAP AII XML Command File

Cloud_Business.png

This action executes printing with data from an SAP AII XML-formatted file.

Loftware Automation internally supports XML files with the "SAP AII XML" structure, which are defined by SAP software.

Use this action as a shortcut. it helps you execute SAP AII XML files directly without any need to parse them using XML filter and map values to variables. To be able to use this action, the XML file must conform to SAP AII XML specifications. For more information, see section SAP AII XML Specifications in Loftware Automation user guide.

Use UNC syntax for network resources. For more information, see section Access to Network Shared Resources in Loftware Automation user guide.

[Note] Product level info

Requires Automation Builder.

How to receive a command file in a trigger and execute it

After a trigger receives the command file and you wish to execute it, complete the following steps:

  1. In Automation Builder module, on Variables tab, click the Internal Variable button in the ribbon.

  2. In the drop down list, enable the internal variable named DataFileName. This internal variable provides path and file name of the file that contains the data received by the trigger. In this case, its contents is command file. For more information, see section Internal Variables in the Loftware Automation user guide.

  3. In Actions tab, add the action to execute the command file, such as Run Command File, Run Oracle XML Command File, or Run SAP AII XML Command File.

    For the action Run Command File, select the type of the command file in File type.

  4. Enable the option Variable.

  5. Select the variable named DataFileName from the list of available variables.

About group identifies the selected action.

  • Name: allows you to define a custom action name. This makes actions easily recognizable on the solution's list of actions. By default, the action name is taken from its type.

  • Description: custom information about the action. Enter a description to explain the purpose and role of action in a solution.

  • Action type: read-only information about the selected action type.

File group defines the SAP AII XML command file to be used.

  • File name: selected SAP AII XML command file. It can either be hard-coded or dynamically defined using an existing or a newly created variable.

Optional Parameters group allows defining the label name in case it is not included in the XML file.

  • Label name: the selected label file that should be used in the command file. It can either be hard-coded or dynamically defined using an existing or a newly created variable.

Action Execution and Error Handling

Each action can be set as a conditional action. Conditional actions only run when the defined conditions allow them to be run. To define these conditions, click Show execution and error handling options.

Execution options are:

  • Enabled: specifies if the action is enabled or disabled. Only enabled actions will execute. This functionality may be used while testing a form.

  • Condition: defines one-line programming expression that must provide a Boolean value (true or false). When the result of the expression is true, the action will execute. Condition offers a way to avoid executing actions every time.

Error handling options are:

  • Ignore failure: specifies whether an error should be ignored or not. With Ignore failure option enabled, the execution of actions continues even if the current action fails.

    [Note] Note

    Nested actions that depend on the current action do not execute in case of a failure. The execution of actions continues with the next action on the same level as the current action. The error is logged but does not break the execution of the action.

Example 38. Example

At the end of printing, you might want to send the status update to an external application using HTTP Request action. If the printing action fails, action processing stops. In order to execute the reporting even after the failed print action, the Print Label action must have the option Ignore failure enabled.


  • Save error to variable: allows you to select or create a variable to save the error to. The same cause of the error is also saved to internal variables ActionLastErrorId and ActionLastErrorDesc.