Defining content folders
A content folder contains a set of content records and other content folders in a hierarchical tree. Each content folder specifies important criteria that define how the system should publish and manage the workflow of content records within the content folder.
Do the following to define content folders:
- Go to RiSE > Page Builder > Manage content.
- Select the root folder in which you want to create the new content folder.
- Do one of the following:
- Go to New > Website Content Folder to create a new content folder.
- Select an existing content folder and click Edit to modify the existing content folder.
- Define the following on the content folder, as necessary:
- Properties
- Workflow management
- Current tags
- Access settings
Note: You can also select an existing content folder and go to Organize > Delete to delete the content folder.
In most cases, content folders are automatically published when you click Save. However, if you define an existing content folder that contains any content records with a Working status, or if you edit a folder that contains no content records, the content folder is not automatically published. You must subsequently click Publish from the toolbar to create an active Published version. You can choose to publish the child content records at the same time, if desired.
You can move content folders into different content folders by dragging and dropping them into a different folder. You can also move content folders by selecting the content folder and then using the toolbar commands Organize > Cut and Organize > Paste.
Note: You cannot drag and drop system folders or folders that have nested system documents.
Note: Content cannot be dragged from the left panel to the right panel (or within the right panel) of the Manage content section.
When you move or copy a content folder into a new content folder, you must republish the moved content folder to ensure that any content inside the folder that was moved is made visible on all iMIS content management websites associated with the new parent content folder. This also ensures the moved content folder is removed from all websites that were associated with the old parent content folder.
When you move or copy a content folder that is workflow-enabled, the content folder's assigned content authority group and content owner remains unchanged.
Tags inherited from ancestors in the content folder hierarchy are recalculated based on the content folder's new position in the hierarchy. Although the new inherited tags are visible immediately within Page Builder, you must republish all descendants of the content folder to ensure that website searches for these tags will find the folder's descendant content records.
Whenever you save or publish a content folder, the previous version of the content folder is saved as an Archived version. Do the following to revert to an older archived version:
- Go to RiSE > Page Builder > Manage content.
- Select a content folder.
- Click Versions.
- Select an archived version and click Revert and then OK.
The version you selected is turned into a new Working version at the top of the list. When you close this window, the version you selected is the version seen in the content folder hierarchy. As with any Working content folder, you can publish this version when you are ready to make it an active Published version.
A content folder that has been deleted is moved to the Recycle Bin at the bottom of the content folder hierarchy.
Do the following to permanently purge specific content folders:
- Go to RiSE > Page Builder > Manage content > Recycle Bin.
- Select the content folders you want to permanently purge in the Recycle Bin. Press Ctrl as you select content folders to select more than one folder.
- Go to Organize > Purge.
Do the following to permanently purge all items in the Recycle Bin:
- Go to RiSE > Page Builder > Manage content.
- Select the Recycle Bin.
- Go to Organize > Empty the Recycle Bin.
Do the following to restore a deleted content folder:
- Go to RiSE > Page Builder > Manage content > Recycle Bin.
- Select the deleted content folder.
- Click Versions.
- In the Document versions window, select the desired Recycled version.
- Click Revert and then OK. The content folder is moved to its original location in the content folder hierarchy and its status is changed to Working. You must republish the content folder to create an active Published version again.
- You must have one or both of the following content authority group permissions in at least one content authority group to which you belong:
- To create new content folders, you must have Folder Creator content authority group permissions. Folder creators can create new content folders, as well as edit or delete existing content folders.
- To modify the properties of a content folder, you must have Folder Editor content authority group permissions.
- To create new content folders, you must have both Read and Edit Document system permissions on each content folder in which you want to create new content folders.
- To edit existing content folders, you must have both Read and Edit Document system permissions on each content folder you want to edit.
- To delete existing content folders, you must have Delete Document system permissions on each content folder you want to delete.
- You must have Select Document system permissions on each content folder to which you assign tags.
- To be the content owner of a content folder, you must have Content Editor content authority group permissions in the content authority group that is assigned to the content folder.
The Document system permissions from the parent content folder are copied into each newly created content folder, but can later be modified.
Note: The iCore content folder and all of its descendant content folders and content records are protected for use by iMIS. The default Document system permissions for these content folders and content records permit editing only by members of the SysAdmin role.
A content folder contains a set of content records and other content folders in a hierarchical tree. Each content folder specifies important criteria that define how the system should publish and manage the workflow of content records within the content folder.
Children content records and content folders inherit the tags from their parent content folder (and therefore also the tags from all ancestor content folders), but no other attributes are inherited. However, some attributes are initially copied from the parent folder at the time of creation:
- The specific Access settings from the parent folder are copied to new content records and content folders at the time of creation, which you can subsequently change as needed.
- The Authority Group value from the parent folder is copied to new content folders at the time of creation, which you can subsequently change as needed.
- The Owner of this content value from the parent folder is copied to new content folders at the time of creation, which you can subsequently change as needed.
- The Content is considered expired n days after last published value is copied to new content records and content folders at the time of creation, which you can subsequently change as needed.
Note: For content folders that have a content authority group (CAG) assigned to them, the Owner of this content value is not copied to new content records that are created inside of it. Instead, content records automatically have this value set to specify the first person who created the content record, which you can subsequently change as needed.
Note: A content record does not have a content owner automatically assigned if it was created by a person who is a member of the SysAdmin role but who does not have Content Editor content authority group permissions in at least one content authority group.
A content layout is a predefined set of content item zones within a content record. Each content item zone can contain one or more content items, and you can drag and drop content items among the zones to rearrange the position in which content is displayed in a rendered content record.
A content owner is related to the content authority group (CAG) that is assigned to a content folder and its children content records. Content owners are specified on the Workflow management tab of the content folder or content record definition.
Only members of the content authority group assigned to a content folder who also have Content Editor permissions within that content authority group are available to be manually assigned as the content owner for the content folder or for content records within that content folder.
When you create a new content folder, it copies the currently designated content owner for the parent content folder. However, when you create a new content record, a different process is followed:
- If the person who created the content record is a person with Content Editor content authority group permissions in at least one content authority group, they are automatically assigned as the content owner for the content record. You can subsequently change this value to any person from the parent folder's content authority group who has Content Editor content authority group permissions.
- If the person who created the content folder does not have Content Editor content authority group permissions in any content authority group (for example, a person who is a member of the SysAdmin role) then no content owner is assigned.
The Owner of this content field serves a different function for content records and content folders:
- For content records, the content owner:
- Receives email notification of pending expiration for the content record.
- Is assigned content change requests for the content record in the Content change requests assigned to you section of their iMIS content management Task list.
- For content folders, the content owner specifies which member of the assigned content authority group should replace the designated content owner of any child content records if the current owner assigned to a content record becomes ineligible for any reason.
A content record is an iMIS definition object, stored in the Document system, which specifies all the information needed to render a web page from an iMIS content management website. Instead of hand-coding the contents of a web page for your website, you define some basic properties and tags for the content record, choose a content layout, add various content items to the content item zones in the layout, and then define the properties for each content item. After the content record has been published to an .aspx file on the website, it is available for viewing by web browsers as a complete web page.
A content item is a web widget in the ASP.NET environment:
- Choose from different types of content items to insert in the various content item zones in the content layout.
- Configure each content item to populate that instance of it with the desired content.
You can easily rearrange the rendered page contents by dragging a content item to a different location within the content item zones. A standard set of system-defined content items are available in iMIS, but staff or consultants who are experienced in ASP.NET development can also easily add new content items for use when authoring content.
- The standard content items supplied with iMIS content management (listed in the Content gallery) all have a corresponding content type, which tells iMIS how to create the corresponding content item within the system, how to edit the content item, how to display the content item, how to publish the content item, and so on.
- New complex content items that you add to your iMIS environment are also listed in the Content gallery and must also have corresponding content types.
- A special ASI-supplied ContentWebUserControl content type is used as a generic default content type for all simple content items, or for ad-hoc web user controls that have been manually added to a content record.
- To see the Communities Content g
- allery, you must have a COMMUNITIES license.
These fields control the properties of content folders that are defined in the system.
Go to RiSE > Page Builder > Manage content and do one of the following:
- Select New > Website Content Folder.
- Select an existing content folder, and then click Edit.
Note: The iCore content folder and all of its descendant content folders and content records are protected for use by iMIS. The default Document system permissions for these content folders and content records permit editing only by members of the SysAdmin role.
Specifies whether this definition object is in a Working, PublishPending, Submitted, Published, Inactive, or Active state. Click the Click to collapse/expand icon to view further details, including who created the record, who modified it last, and dates of these changes.
- Content records in a Working state have been saved within the iMIS database, but the latest changes have not been made active on the associated iMIS content management websites by the associated publishing servers and their corresponding publishing service.
- For all other definition objects, the publishing process is less complex and does not involve content authority group permissions, publishing servers, or the iMIS publishing service. When the object is in a Working state, the latest changes have been saved within the iMIS database, but they have not yet been made active within iMIS. The Publish command makes the latest changes active within iMIS.
- Websites in an Inactive state are offline so that browsers cannot view the website content, and instead see a 503 error (Service Unavailable). Selecting the Is this website active? checkbox in the Status section of the website's definition puts the website in an Active state, enabling browsers to view the website content. Deselecting this checkbox puts the website in an Inactive state.
The Publish command on the toolbar queues the content record to the associated publishing server, during which the content record is in a PublishPending state and can be viewed in the Pending Requests detail. After each publish has successfully processed, the latest changes become visible on the associated websites and become active within iMIS, both of which are denoted by the Published state.
If an iMIS user does not have content authority group (CAG) Content Approver permissions, they will see a Submit command instead of a Publish command. The Submit command queues a publishing request to the Page Builder Task list of all content authority group members who have Content Approver permissions (or, if workflow is enabled for the parent content folder, only those members of the content folder's assigned content authority group who have Content Approver permissions). Only a person with Content Approver permissions in at least one content authority group can actually publish content records.
Specifies a version of the folder Title that meets the requirements for a path segment to the rendered .aspx files for each content record in the folder.
Specifies the website for which searches will always include the content records within this content folder. This value is not inherited by any children content folders, although when you create a new content folder this field will copy the current value from its parent content folder as a default value.
Note: If iMIS returns no search results, be sure to designate some content folders to list the specific website in either of these fields.
Specifies additional websites, other than the one specified in Default Website (for search), for which searches will always include the content records within this content folder. These values are not inherited by any children content folders, although when you create a new content folder this field will copy the current values from its parent content folder as default values.
Note: If you clear the Always display content in default website checkbox, be careful to specify only additional websites whose sitemaps include navigation items that link to all of the content records in this content folder.
Note: If iMIS returns no search results, be sure to designate some content folders to list the specific website in either of these fields.
Displays the rendered version of a content record in this content folder in the context of the website specified in Default Website (for search) regardless of the website on which the search was performed. When this option is cleared, the rendered content record is displayed in the context of the website in which the search was made.
Specifies the publishing servers that should manage the publishing of all content records within this content folder:
In the simplest case (only one publishing server defined in your iMIS content management environment) you should set this value to All for the root content folder (@) and set this value to Inherit on all folders under the root.
Specifies whether content workflow is enabled for this content folder and by default all of this content folder's child content records:
- If an Authority Group is assigned to this folder, the content workflow is enabled. Only the members of that content authority group (CAG) receive workflow notifications in their Page Builder Task list when changes occur to content records in the content folder.
- If no Authority Group is assigned, then any member of any content authority group in the system receives workflow notifications in their task list when changes occur to content records in the content folder.
The following fields appear only when a content authority group is assigned to a content folder:
- Owner of this content – Specifies which member of the assigned content authority group should replace the designated content owner of any child content records or content folders if the current owner assigned to a content record becomes ineligible for any reason. The drop-down list includes only those members of the assigned content authority group who have Content Editor permissions.
- Content is considered expired n days after last published – Specifies the default expiration interval for all content records in this folder. Expired content records are no longer rendered on iMIS content management websites, but the content record remains in the system with no change in status until it is manually deleted by selecting Organize > Delete on the Document system toolbar, or by using the Delete Selected button on a content authority group member's Page Builder Task list.
- Update this value for content in this folder and all subfolders – Automatically applies the setting for Content is considered expired n days after last published to the following when you save your changes to this content folder definition:
- All descendent content records
- Descendant content folders with content workflow set up
Note: This default expiration behavior can be selectively overridden by the Automatically remove expired content? field in the definition of each content record.
Note: For more information on the Content and Navigation Workflow task, which must be enabled through iMIS Process automation, see Creating and editing scheduled tasks.
Manually republishing the content record causes the content record to be displayed again on the iMIS content management websites and resets the expiration interval.
The expiration interval can be effectively overridden for a specific content record in this folder by specifying a value smaller than the expiration interval for the Automatic Publishing Frequency field in the content record definition. This ensures that the expiration interval is never reached for that content record.
Specifies the tags that are currently associated with the current content folder.
Note: Click Modify to display the tag selection tree.
Tags applied to a content folder are inherited by all descendant content records and content folders, not just the immediate children of this content folder. The Tags inherited from parent hierarchy area lists all tags that are being inherited from a content folder higher in the content folder hierarchy.
Only the inherited tags and the additional specific tags that you select here are used by the iMIS content management search engine. If you want search results to also find the descendant content records by descendant tags in the tag hierarchy, you must select the parent tag and also the specific descendant tags.
Although the iMIS content management search engine recognizes tag inheritance and finds descendant content records based on inherited tags, the Items by Tag report does not recognize tag inheritance and does not list the descendant content records and content folders for a tag that the descendant content records inherit.
To choose useful tags for the dynamic handling of descendant content records, it helps to understand how tag-related functionality handles tag inheritance:
- The prefiltered result set of a basic or advanced search includes all published content records that are tagged with any descendant of the tag that is matched by the search keywords.
- The prefiltered result set of a rendered Content Tagged List content item also includes published content records that are tagged with any descendent of a tag that is specified in the configuration of the Content Tagged List.
- The content of the Items by Tag report (Reports > Content Reports) does not list published content records that are tagged with any descendant of each tag in the report.
Note: Tags are always overwritten on import. For example, if you import a content folder from a staging server to a production server, the assigned tags on the production server are overwritten by whatever tags are assigned on the staging server.
Specifies the Document system permissions granted for this definition object to iMIS security roles, security groups, specific iMIS users, iMIS member types, or to all Full and Casual users based on their assigned authorization levels.
- Apply changes to all descendants – Changes to this section, when saved, flow automatically to all descendant definition objects. When this option is cleared, changes to this section apply only to the current definition object. This checkbox usually is displayed only on Document system folder objects.
- Use a preconfigured security set – Specifies a preconfigured security configuration to use for this definition object, which can be much simpler than using the Make this available to option to specify the permissions for definition objects. The specific permissions in the preconfigured security configuration are displayed (read-only) in the Make this available to area.
- Make this available to – Lists the roles, groups, users, member types, or authorization levels that have been enabled to define or view rendered output from this object. This option enables you to specify custom permissions for the definition object if none of the preconfigured security configurations meets your needs. The SysAdmin, Content Administrator, and Everyone roles are default system-defined security roles that are assigned to every definition object used by iMIS content management. The SysAdmin role is assigned in the definition of an iMIS user record, but the Content Administrator role is automatically assigned to every iMIS user who is a member of an iMIS content management content authority group (CAG) that is designated as a Master Admin content authority group.
If you select a preconfigured security configuration and then switch to the Make this available to option, the permissions granted by the preconfigured security configuration are copied. This enables you to use a preconfigured security configuration as a starting point for defining custom permissions.
The permissions that can be assigned to each entry in the list are:
- Full Control – Enables all permissions that follow.
- Read – Enables users to see this object both in iMIS content management definition windows and as rendered output in iMIS content management websites.
- Add – Enables users to create new objects. Users can also paste or import an object into the Document system.
- Edit – Enables users to edit this object's definition.
- Delete – Enables users to delete this object.
- Select – (if displayed) Enables users to assign a tag to content folders and content records.
Note: Users cannot change the object's definition.
Note: Users cannot change delete the object.
The configuration options control the properties of the standard iMIS content items that are defined in the system. By default, these fields are found in the following locations:
- In a content record:
- Select Add content.
- Select and open a gallery folder.
- Choose one of the listed content items and click OK to add the content item to the content record. The content item's configuration options are presented. For an existing content item, select Configure.
- When using Easy Edit, click Configure on top of the appropriate content items in the content records. You must be logged in to the website and have Content Editor permissions in at least one content authority group (CAG).
- To see the Communities Content Gallery, you need a COMMUNITIES license.
When you edit configuration options on a content item directly through Easy Edit, the available Save options are:
- Save – A Working version of the content record is saved. Click Publish Page to publish the content record and make it the active version.
- Save and Publish – This option is available if you have the Content Approver content authority group permission. When you Save and Publish, your changes are immediately visible on any iMIS content management website that uses the content record.
- Save and Submit for Approval – This option is available if you do not have the Content Approver content authority group permission. When you Save and Submit for Approval, your changes are saved, and a content publishing request is submitted to the content folder’s content approver.
When you configure a content item from within a content record, you only have the option to Save or Cancel. You can publish your changes from the content record or the Document system toolbar.
To work with content items that have been added to a content record, select from the following commands:
- Configure – Displays a Configure iPart window that allows you to define the properties of the content item. You can access Configuration Help for most content items.
- Copy To – Allows you to specify another content record to which you want to copy the content item.
- Move To – Allows you to specify another content record to which you want to move the content item.
- Connect – Displays a connection editor that enables staff or consultants to define content item connections. Connections allow one content item to interact with another content item on the same content record. Not all content items support connections; review the Configuration Help to determine a content item’s connection options.
- Click Connect on content item A. A Connect window is displayed.
- Click Create a new connection.
- Select the content item B in the Object Consumer drop-down.
- Click Connect.
- Click the red X to close the Connect window.
- Object
- Atom Object
- Uniform Key
- String
- Minimize – Collapses the content item's preview area, instead displaying the content item's title bar only.
- Restore – Expands a collapsed content item to display its preview area.
- Remove – Removes the content item from the content record.
When creating a new connection, the available connection types are listed. A drop-down list enables you to select from the other content items on the same content record. For example, to configure content item A to act upon content item B:
Each content item can have only one Object Consumer and one Object Provider per connection type. A content item can act as an Object Provider for one other content item only; a content item cannot as an Object Provider for multiple content items.
The connection editor lists all current connection points for the content item and allows you to define new connections. Each content item (Object Consumer and Object Provider) displays the connection once it is defined. For example, if you connect content item A to content item B and review the connections for content item B, you will see the connection to content item A. Connections can also be disconnected from the connection editor.
Currently, connections can be the following types:
The type of connection to use depends on the implementation by the content item’s author. Please refer to the specific content item’s Configuration Help for details.
Note: The content types defined in the system determine the behavior of ASP.NET content item controls within iMIS. Each content item's control must have an associated content type, which tells iMIS how to create the corresponding content item within the system, how to edit the content item, how to display the content item, how to publish the content item, and so on. The system-defined content items in the Content gallery all have a corresponding content type. A special ContentWebUserControl content type is used as the default content type for all custom content items that you add to a content record. You can optionally define entirely new content types to enable more sophisticated system handling of a custom content item that has been added to a content record.
Other tips:
- Modifications to your master pages might be required if content items appear to overflow the boundaries of content item zones in the rendered pages. This requires modifying the template's master page and accompanying CSS files to make the Home page and interior page layouts larger than their default size.
- Custom ASP.NET content items are not described in this section because they are not part of the standard set of content items shipped with iMIS.
- Implementers can add an ad hoc ASP.NET web user control to a content record by entering the relative path to the content item in the Or, enter a path to a web user control field.
Specifies a relative URL from the root (~) of the physical path for the application or website that hosts your iMIS content management websites to a web user control that you want to insert into this content record.
Note: Be sure to use forward slashes (/) for the URL segment delimiters.
These fields determine how the system should process an iMIS content management definition object when you use the Publish command.
Go to RiSE > Site Builder or Page Builder and click Publish on the Document system toolbar for most iMIS content management definition objects.
- When you choose to Save and Publish a content record or content item, no publishing options are displayed. Your changes to the content record or content item are automatically published and immediately visible on all websites that use the modified content.
- Hold Shift or Ctrl while selecting content records to select multiple records. You can publish a group of content records in one operation.
- When you publish a content folder, the publishing process automatically includes all descendants (content records and sub-folders) of that content folder. The publishing option you select is applied to each descendant.
- When you make changes to the definition of a content folder, the system flags only that content folder as now being in a Working state. However, changes made to a content folder can affect the behavior of all descendant content records and content folders; republish descendants of the modified content folder:
- Use Publish All Items to reset the expiration countdown timer for all descendant content records that are controlled by the Content is considered expired n days after last published field.
- Use Publish Working Items, Regenerate Published Items if you do not want to affect the current expiration countdown timer for all descendant content records.
If the selected definition object or folder has children, such as a navigation item in the Manage sitemaps tree or a sub-folder in the Manage websites tree, then all descendants of the definition object or folder are published as well.
Note: This option is displayed for some definition object types only.
Note: This option is not displayed for content folders: the publishing process for a content folder always applies to the content folder's descendants.
Publishes only the selected definition objects that currently have a status of Working. Selected objects that are in any other state are ignored.
Note: This option is displayed for some definition object types only.
Publishes all of the selected definition objects regardless of their status. The Updated on date is reset to the current date. Objects that are currently in a Published state have their Date of publication reset to the current date. However, if the Date of publication was manually overwritten, the date remains unchanged.
Note: This option is displayed for some definition object types only.
Note: If the Date of publication for a content record is blanked out, the publication date is reset to the current date when the content is published.
Publishes all of the selected definition objects regardless of their status. The Date of publication remains unchanged for objects that are currently in a Published state. The Updated on date is reset to the current date.
Note: This option is displayed for some definition object types only.
Prevents the publishing results from being displayed, which can reduce the number of clicks you must make when publishing. This option is saved as a preference until you change it again.