Content Studio Web Content Management System
Assembly: CSServer5 (in CSServer5.dll) Version: 5.7.5016.0 (5.7.5016.0)
XML containing a list of categories.
Only categories where the user has READ permission are returned.
This method is mostly included in the CS API for backward compatibility reasons.
The method reads all categories in the unit regardless of their level and callers must use
the categoryname xml element to determine the level of a specific category.
The following code sample (error handling omitted) returns all categories from in a certain unit that can contain EPT xml documents.
[This is preliminary documentation and is subject to change.]
Returns a filtered list of categories including subcategories in a unit.
Namespace: ContentStudio.Document
Assembly: CSServer5 (in CSServer5.dll) Version: 5.7.5016.0 (5.7.5016.0)
Syntax
public string GetCategoriesInUnit( ConnectionId connectionId, SessionId sessionId, UnitId unitId, string moduleName )
Parameters
- connectionId
- Type: ContentStudioConnectionId
A value that identifies the web site - sessionId
- Type: ContentStudio.SecuritySessionId
A value that identifies the user's session. This value usually originates from a call to OpenSession(ConnectionId). - unitId
- Type: ContentStudio.DocumentUnitId
An identifier of a unit to list from. This must be an existing unit. - moduleName
- Type: SystemString
A name of a module that specifies the type of categories to list. This parameter can be null (Nothing in Visual Basic) or an Empty to return any type of category.
To return a specfic type of category you can use the moduleName argument to supply a filter. The table below lists the supported value for moduleName which are not case sensitive.ModuleName Description. ActiveScripting The category contains AS-components. Dokument The category contains regular documents, with or without meta data. EditTemplate The category contains Editing templates. Fil The category contains uploaded files Formatmall The category contains templates (for fragments of a page). Helsidesmall The category contains document templates. PresentationTemplate The category contains presentation templates. XMLDocument The category contains EPT documents.
Return Value
Type: StringXML containing a list of categories.
<root> <status>Integer value</status> <statustext>String value</statustext> <categories> <cs_category> <categoryid>Integer value</categoryid> <categoryname>String value</categoryname> <modulename>String value</modulename> <unitname>String value</unitname> <unitid>Integer value</unitid> <edittemplateid>Integer value</edittemplateid> </cs_category> <!-- more cs_category elements can follow --> </categories> </root>
This xml has the following members and meaning
Element | Description | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
root/status | Integer: The outcome of the call. Always 0, success | |||||||||||||||||||||
root/statustext | String: The text representation of outcome of the call. Always OK | |||||||||||||||||||||
root/categories | The root element of the category list | |||||||||||||||||||||
root/categories/cs_category | The root element of a found category. This element occurs once for each found category. | |||||||||||||||||||||
root/categories/cs_category/categoryid | Integer: The category identifier | |||||||||||||||||||||
root/categories/cs_category/categoryname |
The relative path name to the category (e.g. MyUnit/TheCategory).
This relative path is the path in the underlying file system which means that some of the special system folders are different from the path shown in Content Studio. These are i version 5.1:
| |||||||||||||||||||||
root/categories/cs_category/modulename | String: A value that indicates the type of category. This value cannot fully be used to determine the type of a category. Use the GetDocumentType(ConnectionId, SessionId, CategoryId) method to determine the type of document a category can contain. | |||||||||||||||||||||
root/categories/cs_category/unitname | The name of the unit specified in unitId. This value is the same for each category | |||||||||||||||||||||
root/categories/cs_category/unitid | The identifier of the unit specified in unitId. This value is the same for each category. | |||||||||||||||||||||
root/categories/cs_category/edittemplateid | The identifier of the edit template of the category. This value is zero if not an ept document category. |
Content Studio permissions
Remarks
Note |
---|
This API should be avoided; new applications should use the GetCategoryList instead which can read categories per level in a structured way. |
Examples
private string GetCatsUnits() { // The commented code below is for application outside // a Content Studio web site only. This code block // opens a new session but since sessions identifiers and connection identifiers // are already available on the web site there is no need for this. /* const int CS_ConnectionId = 1236; SessionManager sman = new SessionManager(); int CS_UserSessionId = sman.OpenSession(CS_ConnectionId); */ CategoryReader c = new CategoryReader(); return c.GetCategoriesInUnit(CS_ConnectionId, CS_UserSessionId, 2, "XMLDocument"); }
See Also