Utils: Run Child Job

Component Name and System Landscape

• Name: FCA_SAP_Utils_Child_Run
• Description: SAP - Utils: Run Child Job
• Application: FCA_SAP_Transactions
• Type: RedwoodScript

Brief Description

This component can be used to start a child process in case for example you need tasklist context without starting the process from an actual tasklist (Orchestrator).

Parameter Mapping - Generic Tabs

There are several tabs under this section. Some will be generic, and others are specific to the component. The generic tabs usually are:

• Target: Requires SAP and Client information. You can also hard code the SAP username.
• Infrastructure: Used for Action rules. See the Redwood Finance Automation Reference.
• Recipient parameters: Generally left to default values.
• Job output parameters: Defines the format of the required output. Defaults to RTX and Text. See Porgam Handling for more information.

note

Most of the time these tabs will be shown, but there are components where these differ and either do not appear at all, or they are specific tabs.

Parameter Mapping - Specific Tabs

This guide shows the minimum parameter values required for the component to run. Please refer to the Redwood Automation Engineering Training course for submission and monitoring activities.

Tab	Technical Name	Description	Format	Mandatory Field	Example
Parameters	JD	Transaction to run	Input is process- or chain definition to start. <PARTITION>.<NAMEOFDEFINITION>	Yes	REDWOOD.CUS_TD_EXAMPLE_PROCESS
Parameters	WAIT	Wait for child to finish	In case you want the process to wait for the child process to finish, specify an X.		Only left empty or value X allowed.
Parameters	VALUE_PAIRS	Parameter Value Pairs	You can specify here the values of the parameters of the child process to start. You need to specify at least the mandatory parameters of the child process, otherwise it will fail. <target_parameter>=<value> Multiple parameters can be specified, separating them with a semi-colon.		PARAMT=1=Hello World;PARAMT2=12345
Parameters	PARM_PAIRS	Parameter Mapping pairs	If you are using FCA_SAP_Utils_Child_Run in a chain, you can use parameters from the chain process or processes from the steps to map to target parameters of the child process. <target_parameter>=<reference to source parameter> Multiple parameters can be specified, separating them with a semi-colon.		Mapping from source chain parameter: PARAMT=PARAMCHAIN Mapping from a Step, Process: PARAMT=Step 1, Job 1:PARAMSTEPPROCESS When parameter names are equal between target and source you can leave out the source parameter: PARAMT or PARAMT=Step 1, Job 1
Parameters	OUTPUT_PARAMETER	Output Parameter	You can specify the output parameter from the child process which you want to collect. The value from this parameter will be put in out parameter: _OUTPUT Note: you can only specify one output parameter to be retrieved.		OUT_SOURCEPARAM
Target	SAP_SYSTEMS	SAP System	Should contain a valid SAP System as defined in RunMyFinance. Available SAP Systems are listed. The SAP System, SAP Client and optionally SAP User Name is used to check the amounts format (decimal separator, thousand separator) <PARTITION>:<SAP_SYSTEM_NAME>		REDWOOD:SAP_EC6
Target	CLIENT	SAP Client	Should contain a valid SAP Client as defined in RunMyFinance. Available SAP Clients are listed, based on the chosen SAP System. The SAP System, SAP Client and optionally SAP User Name is used to check the amounts format (decimal separator, thousand separator)	Yes	800
Target	SAP_USER_NAME	SAP User Name	Should contain a valid SAP user. The SAP System, SAP Client and optionally SAP User Name is used to check the amounts format (decimal separator, thousand separator)
Output	LANGUAGE	SAP Language for the Step	If the target process definition contains LANGUAGE parameter(s), the value specified here will be automatically forwarded. SAP Language to be used. Which language will be used to generate the SAP reports.		UK (UK English), DE (German), NL (Dutch), etc

Output Parameters

The Output parameter can be found under section: Parameters There is one output parameter available:

• _OUTPUT: If you have specified an OUT parameter of the child process under parameter: OUTPUT_PARAMETER, the value of the output parameter of the child will be put in this parameter.

Troubleshooting

Parameters Tab

• Issue:
• Resolution: Possible values for the different input parameters can be set dynamically by using REL expressions or Replacements.

When this component is started, the description is set dynamically to: Submit: <description of the child process to start> In case the description field of the child process is empty, you will see the description:Submit: null

See Also

Redwood Finance Automation Reference

financeTopic