Creating a Substitution

In Customizing for Special Purpose Ledger , choose the activity Maintain Substitution. For more information about creating substitutions, see the Implementation Guide (IMG) under Tools Maintain Validation/Substitution/Rules Maintain Substitution .
The Change Substitution: Overview screen appears. In the Control area on the left, expand the node for the required application area. You can then expand the node for your required callup point.

This node contains both the substitution and the rule list that have been created for this application area and callup point. You can also process the rules from here (create/change/display/delete).
Choose Substitution Create .
The Create Substitution: New Substitution (Header data) screen appears.
Enter the following data:

– Substitution name

– Substitution description

You can also enter an authorization group to limit the number of users that can process this substitution.

To accept these entries, press Enter .

If you want to create a substitution by copying an already existing one, choose the corresponding callup point in Control and mark the substitution you want to use as a reference. Wait until both screen areas of the system are ready for entry, and then choose Start of the navigation path Substitution Next navigation step Copy End of the navigation path . Enter data as described in Step 3 above.

The substitution must have the same Boolean class as the substitution you are creating.

Note Note

If you are creating a matrix substitution, allowing you to validate data for an entire document, you use callup point code 0003 in Financial Accounting (FI), Legal Consolidation (FI-LC), and Consolidation (EC-CS). If you want to create a matrix substitution in the FI application component for callup point 0003, use the SAP note no. 42615 (this function is not included in the standard delivery).

End of the note.

The following table shows example entries for application area/callup point combinations.

Application area	Callup point	Description
CO	0001	Document line item
GL	0001 0002	Document header Document line item
FI	0001 0002 0003 0005	Document header Document line item Total document Cost of sales accounting

Press Enter .

The Create Substitution: <Substitution Name> (Header data) screen appears.

You can use the following additional functions in this screen:

Additional Processing Functions Create Substitution: <Substitution Name> (Header data) Screen Screen

Choose	Function
Substitution Create	Create a substitution
Substitution Select	Select substitution: The system expands the corresponding node down to the selected substitution automatically. A confirmation prompt gives you the opportunity to change your selection.
Substitution Copy	The system creates a new substitution by copying the substitution currently marked.
Substitution Change	Switch to change mode
Substitution Display	Switch to display mode
Substitution Save	Save the substitution
Edit Insert step	Insert new step (empty). If steps already exist, the new step is inserted as the last step.
Extras Flds in Bool.statmnt	Display a list of valid fields that you can use for the substitution. These fields are determined based on the Boolean class of the substitution.
Extras Substitution flds...	Display a list of valid fields that can be changed within a substitution
Extras Rule list	Display a list of rules that you can use for the newly created substitution
Extras Set directory	List sets that have been created in your system. For more information, see Displaying a Set Directory .
Extras Switch on trace	Switch on the tracing function. While posting a document, the system calls the substitution and shows you which data is used. This function allows you to diagnose possible errors in the substitution definition. For further information, see Tracing a Validation/Substitution/Rule .
Extras Switch off trace	Switch off the tracing function
Extras Usage	Display where the substitution is currently used
Environment Maintain rules	Create/change/display rules. Select the node containing the rule list.
Environment Create rule	Create a rule
Environment Select rule	Select a rule

To create a new step for your substitution, choose Edit Insert step or choose the corresponding function from the application tool bar.

A dialog box appears, listing the fields that you can use for substitution for this Boolean class.

Select the field that you want to use for substitution and choose Choose .

For each of the fields you selected a dialog box appears in which you can define the substitution method. You can choose between:

Constant value
Exit
Field-Field assignment

You can then later enter either a constant value, the name of an exit to be carried out at runtime or the name of a field, the content of which is to be used for the substitution.

The Create Substitution: <Substitution Name> - Step <Step Number> - Overview appears.

You can use the following additional functions on this screen:

Edit Insert step	Insert a new step directly before the step currently being processed
Edit Copy step	Insert a new step with the content of the step currently being processed
Edit Delete step	Delete a step
Goto Header	Return to substitution header data

To process an existing substitution step, mark the step <no.> node in Control. You will then see an overview of the prerequisites and substitution entries created for this step. Enter a substitution step description. To edit one of these elements, double-click the appropriate area or navigate by selecting the corresponding node in Control.

Define the Boolean statement used as the prerequisite statement for selecting data for substitution.

If the prerequisite is false, the value is not substituted and the transaction continues with the next substitution step.

The Formula Builder provides an easy-to-use interface for entering logical statements in validations, substitutions, and rules. For more information, see Formula Builder .

For more information about the syntax rules for entering Boolean statements, see Syntax Rules for Boolean Statements .

Note Note

You can also enter a user exit (type 1 or 3) in the prerequisite statement. For further information about user exits, see User Exits in Validations/Substitutions/Rules .

End of the note.

On the Create Substitution: <Substitution Name> - Step <Step Number> - Overview screen you can enter one of the following for each substitution entry, depending on your chosen method:

Constant value
Exit name
Source field of assignment in <structure name> - <field name> format

An input help is available for all three input possibilities.

If the substitution step prerequisite is true at runtime, the system substitutes the contents of the field with a constant value, the contents of the source field or the system carries out an exit.

You use a user-defined exit to create complex substitutions. You use user exits of type 1 or 2 as substitution exits for a normal substitution or exits of type 2 or 3 for a matrix substitution. The substitution entry Exit only , where you can only use exits of type 1 or 3, forms an exception.

You can use the three pushbuttons in the right-hand screen area to insert, delete or move substitution entries:

Select the entries to be deleted and use the pushbutton Delete subst.entry
Select an entry and use the pushbutton Insert subst.entry to insert the new entry before the selected entry
If you want to insert the new entry as the last entry, do not select an entry. Instead, place the cursor on the step description and then use the pushbutton Insert subst.entry .
Select several steps and then use the pushbutton Move subst.entry . A message appears and you can move the steps by placing the cursor on a different entry and pressing Enter . The entries to be moved are inserted in front of the last selected entry.

During processing of a substitution the steps are numbered sequentially by the system automatically. Move steps as follows: Mark the node of the step you wish to move. You can then move the step to the node of a different step. The selected step is inserted after the target step (Drag and Drop method). This is only possible within a substitution.
Once you have finished processing the substitution, choose Substitution Save .