Try OpenEdge Now
skip to main content
BP Server Developer's Guide
Process template management : Working with subprocesses : Subprocess alias
 

Subprocess alias

Typically, a subprocess instance name consists of the parent process name, parent process ID, subprocess name, and subprocess ID. In the case of a multi-level subprocess, its name becomes very long. You can control the subprocess name length by using an alias. The format for a subprocess name with alias is as follows:
<alias>#<sub-piid>
You can define an alias for a subprocess along with the subprocess name. The alias is stored as an attribute of the SubProcess tag. This attribute may contain a constant value or a mapped dataslot. If the performer tag of the subprocess workstep contains hard-coded subprocess name, then the alias’ mapped dataslot must be of type CHARACTER. However, if the performer tag contains a mapped dataslot for multiple subprocesses, then the alias must be of type List. By using a LIST dataslot, each index can specify the alias for each of the multiple subprocesses. When an alias is not defined, the default value of the alias is same as the template name.
The different options for a single subprocess and multiple subprocesses are described in Table 12.
Table 12. Alias options for single and multiple subprocesses
Subprocess name
Alias
Single Subprocess
Hard-coded name
Hard-coded alias or Mapped dataslot of type CHARACTER.
Mapped dataslot of type CHARACTER
Hard-coded alias or Mapped dataslot of type CHARACTER.
Hard-coded name or Mapped dataslot of type CHARACTER
If the alias is not provided, then the template name is used.
Multiple Subprocesses
Mapped dataslot of type LIST
Mapped dataslot of type LIST.
Mapped dataslot of type LIST
If the alias is not provided, then the template name is used for all subprocesses.
Mapped dataslot of type LIST, having four entries in the list.
If the alias is a Mapped dataslot of type LIST with two entries, then the first two subprocesses are created with the alias based on the index. The remaining two use the template name as alias. For example, Subprocess LIST has four entries sp1, sp2, sp3 and sp4.
The alias LIST has two entries als1 and als2.
The template name is temp1.
Then the following aliases are used for the four subprocess.
Sp1 – als1
Sp2 – als2
Sp3 – Sp3
Sp4 – Sp4