...
The <dlm:fragment> element has four possible attributes and can contain , one optional nested <dlm:role> element (see Roles Defined), and zero to many nested <dlm:audience> elements or comments. The audience elements indicate to whom the fragment will go. See Audiences Defined for more detail.
...
| Anchor | ||||
|---|---|---|---|---|
|
Roles Defined
There roles element determines to what group a fragment owner will belong. The fragment owner is defined by the ownerID attribute of the fragment and represents the user account whose layout is used as the layout for the fragment. When modifying the layout channels can be added. Channels are themselves granted only to certain groups of users. As such there is the potential for a fragment owner to have one role or group membership and the users of that fragment to have other disjoint group memberships. In such cases channels added to the surface of that layout and them merged into the user's layouts will show up as broken and indicate that the user does not have access to that channel.
The role element is a step toward resolving such problems. Upon loading dlm.xml the infrastructure looks to see what groups the fragment owner is a member and removes them from all groups except the one indicated by the role element. Additionally, if they are not a member of this group then they are made a member of that group.
New features slated to be added as part of the ALM Convergence effort will render this element unnecessary. The goal is for the fragment editing UI to indicate which channels added to the fragment may not be available to all users of the fragment as defined by the set to whom the fragment is published for pushed fragments or who can subscribe to the fragment for pulled fragments.
| Anchor | ||||
|---|---|---|---|---|
|
Audiences Defined
...