Matching parameter contexts to shared parameter groups during draft creation

If the source flow definition contains more than one parameter context attached to the root process group, the Flow Designer tries to match those contexts to shared parameter groups that are assigned to the project where the draft is created.

Depending on the structure of the source flow definition, parameter matching may or may not be a separate step during draft creation:

• If the flow definition has a single parameter context attached to its root process group, the draft is created without the parameter matching step.
• If the source flow definition has parameter contexts attached to different process groups, the flow definition cannot be converted into a flow draft within Flow Designer, subsequently parameter matching does not happen.
• If the source flow definition has several parameter contexts atttached to its root process group, parameter matching

The figure Parameter matching scenarios illustrates these cases.

Parameter matching happens by matching parameter context names to shared parameter group names, and you are provided with a table of the results on the Map Parameter Contexts page.

In this step, you can examine the mapping of parameter contexts to parameter groups and make modifications to this mapping as necessary.

1. Parameters attached to the source flow definition's root process group are added to the root process group of the flow draft as draft parameters and remain editable within Flow Designer.
   1. The green pill with a number, 3 in this example, displayed on the right shows the number of parameters attached to the root process group of the source flow definition added to the root process group of the flow draft as draft parameters.

   You can click on the icon to view the draft parameters added to te flow draft. Draft parameters can be edited within the Flow Designer.

2. There is a one-to-one match between the source parameter context and the suggested shared parameter group. This means that Flow Designer found a shared parameter group where both the name and the contents match with the given rparameter context.
   1. The green pill with a number, 3 in this example, displayed on the right shows the number of parameters in the parameter context replaced by parameters in the shared parameter group.

   Click on the icon to view the parameters within the shared group. Parameters in a shared group cannot be modified in the Flow Designer, only through the Workspace Resources page.

3. There is a partial match. A partial match means that there is a shared parameter group with a name that matches the name of the given parameter context, but their contents are not identical.
   1. The green pill marks the number of matching parameters. These parameters are part of the suggested shared parameter group and can only be modified through the Workspace Resources page.
   2. The orange pill marks the number of parameters in the parameter context that were not matched in the shared parameter group. These parameters are added to the root process group of the flow draft as draft parameters.

   Click on the icon to view the parameter matching details. Parameters in a shared group cannot be modified in this view, only through the Workspace Resources page. You can select a different Shared parameter group from the drop-down, e.g.: if you know there is a shared group under a different name, with the required parameters.

Modifying the results of parameter matching

Click on the icon to view the parameter matching details.

In this view you can:

1. You can Create New Shared Parameter Group that includes all the parameters in the parameter context of the source flow definition.
2. Select a Shared Parameter Group from the drop-down, for example, if you know there is a shared group under a different name, which actually matches the parameter context in the source flow definition better. In the example on the figure, the shared paramete group data_transform was selected by Flow Designer based on name matching however, datatransform is a better match, as it contains all two parameters present in the source parameter context.
3. Add all parameters to the root process group of the flow draft as draft parameters by selecting Select a Shared Parameter Group > Add all parameters to draft parameters.

Outcome of parameter matching

Precedence

• Draft parameters always take precedence over shared parameters.

• In case of shared parameter groups, their order defines precedence. By changing the order of parameter groups, you can redefine precedence. As a result of this, if a parameter is present in several shared parameter groups, the value of the one in the topmost group takes precedence.

Value retention

• Values of both non-sensitive and sensitive parameters that were matched with a shared parameter group take the values from the shared parameter group.
• Non-sensitive parameters that were added to draft parameters retain the values they had in the source flow definition.
• Sensitive parameters that were added to draft parameters lose their original values.