...
The following are the general attributes for folders. Specific folder subsections clarify usage.
| Attribute | Description | layout/v2uP4.3: api/v4-3/dlm/layout.json field name | Required | Default |
|---|---|---|---|---|
| ID | ID value. By convention folders are "s#" and channels are "n#" where # is a numeric value. The letter designations are arbitrary. The numeric portion must be a unique numeric value (unique among all folders and channels) within the XML file; e.g. you cannot have both an "s1" and an "n1" in the same XML file as the "s" and "n" are not stored to the database. User customizations to a page are represented in the database by "remove ID x" so once a layout is used in production, you must not change the existing ID values or re-use ID values or uPortal will not be able to properly render a user's page that has modified their layout. After modifying a layout with the Admin UI you should export the fragment-layout and store it in your source code repository so you can recreate the layout in other environments with ant initdb or ant initportal. | Y | ||
| hidden | Set to false for folders that are displayed to users. Set to true for folders that are not displayed to users, but are displayed when you do select Manage DLM Fragments in the Admin UI. Certain channels must exist for the fragment owner to edit fragments. These channels include dynamic-respondr-skin (for Respondr them), fragment-admin-exit (allows exiting Manage DLM Fragments user impersonation), and personalization-gallery (allows using Customize to find and add portlets to the page). | Y | ||
| immutable | obsolete parameter from uPortal 2.x days | ? | false | |
| name | Name of the folder. If a folder is a tab, this is the name of the tab. Columns by convention have a name of Column or perhaps Column1, Column2. Users do not see column names. | Y | ||
| type | Type of the folder. Due to historic reasons, this generally indicates the placement of the contents of the folder on the page. Options are:
| Y | ||
| unremovable | Obsolete parameter from earlier uPortal releases. Do not use. | N | false | |
| dlm:addChildAllowed | For a tab folder or column folder, determines whether a user who has permissions to customize their layout can add children (portlets or columns as appropriate) to the folder. | hasColumnAddChildAllowed | N | true |
| dlm:deleteAllowed | For a tab folder or column folder, determines whether a user who has permissions to customize their layout can remove children (portlets or columns as appropriate) to the folder. | deleteAllowed | N | true |
| dlm:editAllowed | For a tab folder, determines whether a user who has permissions to customize their layout can rename the folder | editAllowed | N | true |
| dlm:moveAllowed | For a tab folder or column folder, determines whether a user who has permissions to customize their layout can move the tab or column on the page | moveAllowed | N | true |
...