Documentation Center

Folder Objects

The Folder Object is designed to organize a user’s assignments (their Projects). The Containment Rules for the Folder are; can be created by:

  • Folder
  • Desktop
  • Workpool
  • ProjMan
  • Inbox
  • Sysadmin

The Selected Objects list contains only the Objects to which a Project Object can be forwarded—that is, to a:

  • Users Desktop—Desktop, ProjMan, SysAdmin
  • Inbox
  • WorkPool

So the only valid Containment Rules for the Folder Object are those listed under the Selected Objects field.

You can remove Objects from the Selected Objects list but you should not add Objects to the Selected Objects list. Note that the Objects in the Available Objects list are data Objects or Objects that are part of a hierarchy that contain data Objects. These Objects are typically in the hierarchy under the Configuration Object and are not Objects to which you can forward a project. If you add any of the Available Objects to the Selected Objects list, when you use the Folder Object in the hierarchy under the Configuration then try to create a Project Object you will encounter errors.

Example

If you added the Document Object to the Selected Objects list you would be allowing a Folder Object to be created within the data hierarchy—that is, somewhere under a Configuration Object. This falls outside the intended use of the Folder Object—once again, it is supposed to be used to organize Projects on a User’s Desktop, Inbox or Workpool. However, let’s assume that you allowed the Folder to be created in the hierarchy under the Configuration, that is under a Document Object.

The Project Object’s Containment Rules allows it to exist under a Folder. But you should know that this is only under certain conditions which are not being adhered to in this scenario.

If you attempted to create a Project in the Folder, The following error appears:

To decipher this error message, remember that the Folder Object is a custom Object derived from a Group Object, and note that the Containment Rules for Group and Folder are one set. So, although you were trying to create the Project in a Folder, the error reports on the Project being created in a Group:

An Object of type Project cannot be placed in a Group

The message is referring to the Folder using the name of the Object on which it is based, that is the Group Object—and it is reporting on the Containment Rules of the Group.

The Containment Rules of the Group Object are different than the typical Containment Rules because the Group Containment Rules are inherited from its parent Object. Again, although you were trying to create the Project in a Folder, the second error in this window reports that the Project cannot be created in a Document. This is because the application recognizes the Folder as a Group and the parent of this Group is a Document; thus the error: An Object of type Project cannot be placed in a Document

See Group Objects to continue deciphering the error message.