Action plugin setting - flattenContainersInSelection

(11) Optional setting

Load container assets and provide a "flat" selection of unique assets in the elvisContext when set to true. Default value is true.

Often used in combination with removeContainersFromSelection, which allows you to remove the container asset from the selection after the selection is flattened.

<action>
    <flattenContainersInSelection>...</flattenContainersInSelection>
</action>

Examples

Assume we have an original selection, which contains:

• Asset A
• Asset B
• Asset C
• Container X, which contains: Asset D, Asset E and Asset B

Do not flatten the selection and keep the containers

The selection is equal to the original selection.

<flattenContainersInSelection>false</flattenContainersInSelection>
<removeContainersFromSelection>false</removeContainersFromSelection>

Flatten the selection and remove the flattened containers

The selection becomes: Asset A, Asset B, Asset C, Asset D, Asset E

<flattenContainersInSelection>true</flattenContainersInSelection>
<removeContainersFromSelection>true</removeContainersFromSelection>

Flatten the selection and keep the flattened containers

The selection becomes: Asset A, Asset B, Asset C, Asset D, Asset E, Container X

<flattenContainersInSelection>true</flattenContainersInSelection>
<removeContainersFromSelection>false</removeContainersFromSelection>