Documentation Center

Folder 2.5 CreateReferenceFolder

Creates a folder in the Content Manager repository under the given parent folder. A folder in the Content Manager repository can only contain document components of the one Content Manager object type. A folder can be assigned to a user group. When a user group is assigned to a folder, only users having write access for this user group can create and change objects in the folder.


Parameters

NameTypeDirectionDescription
psAuthContextStringInOutDeprecated proprietary authentication context only used by .ASMX web services based on internal username/password authentication. Claims based security standards drive all the WCF .SVC web services making this parameter redundant.
plParentFolderRefLongInIdentifier of the parent folder.
psFolderNameStringInName for the new folder
psOwnedByStringInName of the user group or department that will be the owner of the folder that is created. When an empty string is provided all users of all user groups or departments have write access to document components stored inside the folder.
pasReadAccessStringArrayInString array with the user groups that have read access to this folder. When the string array is empty, all users have read access to the folder.
plOutNewFolderRefLongOutIdentifier of the folder that has been created

Requirements are:
  • The user must have write access in the parent folder.
Some typical scenarios are:
  • When a folder with the same name already exists as subfolder of the given parent folder, you receive an error (FolderAlreadyExists ,-160).
  • When the user is not a member of the owner's usergroup of the given parent folder, you receive an error (ObjectNotPartOfUserGroup, -117).
  • When the user has no read access on the usergroup of the created folder, you receive an error.
  • When the read access of the to be created folder violates the read access of the parent folder, you receive an error (SecurityRuleViolatedInParentFolder, -225).
  • When the owner is not part of the read access setting, you receive an error (SecurityRuleViolatedOnOwnerAccess, -264).
Note that:
  • Regarding read access, the Content Manager web site by default submits the same read access settings as the parent folder.