CategoryReaderGetCategoriesInUnit Method (ConnectionId, SessionId, UnitId) Content Studio 5.7 SDK
Content Studio Web Content Management System

[This is preliminary documentation and is subject to change.]

Returns a list of all categories including subcategories in a unit.

Namespace: ContentStudio.Document
Assembly: CSServer5 (in CSServer5.dll) Version: 5.7.5016.0 (5.7.5016.0)

public string GetCategoriesInUnit(
	ConnectionId connectionId,
	SessionId sessionId,
	UnitId unitId


Type: ContentStudioConnectionId
A value that identifies the web site
Type: ContentStudio.SecuritySessionId
A value that identifies the user's session. This value usually originates from a call to OpenSession(ConnectionId).
Type: ContentStudio.DocumentUnitId
An identifier of a unit to list from.

Return Value

Type: String
XML containing a list of categories.
    <status>Integer value</status>
    <statustext>String value</statustext>
            <categoryid>Integer value</categoryid>
            <categoryname>String value</categoryname>
            <modulename>String value</modulename>
            <unitname>String value</unitname>
            <unitid>Integer value</unitid>
            <edittemplateid>Integer value</edittemplateid>
        <!-- more cs_category elements can follow -->

This xml has the following members and meaning

root/statusInteger: The outcome of the call. Always 0, success
root/statustextString: The text representation of outcome of the call. Always OK
root/categoriesThe root element of the category list
root/categories/cs_categoryThe root element of a found category. This element occurs once for each found category.
root/categories/cs_category/categoryidInteger: 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: Special category mappings
IdFolderMaps to
root/categories/cs_category/modulenameString: 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/unitnameThe name of the unit specified in unitId. This value is the same for each category
root/categories/cs_category/unitidThe identifier of the unit specified in unitId. This value is the same for each category.
root/categories/cs_category/edittemplateidThe identifier of the edit template of the category. This value is zero if not an ept document category.
Content Studio permissions

Only categories where the user has READ permission are returned.
See Also