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.Xml description
READ permission on the category is required. CS 5.6 and later; Anonymous access supported
[This is preliminary documentation and is subject to change.]
Returns a list of categories within a unit. Subcontainers below the first level are excluded.
Namespace: ContentStudio.Document
Assembly: CSServer5 (in CSServer5.dll) Version: 5.7.5016.0 (5.7.5016.0)
Syntax
public string GetCategoryList( ConnectionId connectionId, SessionId sessionId, UnitId unitId, FolderReaderFolderSortOrder sortOrder )
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 to a unit whose child categories should be listed. - sortOrder
- Type: ContentStudio.DocumentFolderReaderFolderSortOrder
One of the FolderReaderFolderSortOrder enumeration values that specifies how the list is sorted.
Return Value
Type: StringXML containing a list of categories.
<root> <status>Integer value</status> <statustext>String value</statustext> <recordcount>Integer value</recordcount> <parentid>Integer value</parentid> <module>String value</module> <location>String value</location> <customviewurl>String value</customviewurl> <documenttype>Integer value</documenttype> <documentfilenamingconvention>Integer value</documentfilenamingconvention> <categories> <category> <id>Integer value</id> <name>String value</name> <type>String value</type> <module>String value</module> <description>String value</description> <hasdirectace>Bit value</hasdirectace> <documenttype>String value</documenttype> <documentfilenamingconvention>Integer value</documentfilenamingconvention> <filepath>Integer value</filepath> </category> <!-- more category element can follow --> </categories> </root>
The elements have the following meaning
Element | Description | |||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
root/status | Integer: Indicates the outcome of the call, always 0 which indicates success | |||||||||||||||||||||
root/statustext | String: The textual representation of the status, always OK | |||||||||||||||||||||
root/recordcount | Integer: The number of records returned. | |||||||||||||||||||||
root/parentid | Integer: The identifier of the parent of the container specified in unitId. | |||||||||||||||||||||
root/module | String: Always 'Unit'. | |||||||||||||||||||||
root/location | The relative path name to the unit referenced by unitId (e.g. MyUnit). This relative path is the path in the underlying file system. | |||||||||||||||||||||
root/customviewurl | Always Empty | |||||||||||||||||||||
root/documenttype | Always Empty | |||||||||||||||||||||
root/documentfilenamingconvention | Always Empty | |||||||||||||||||||||
root/categories | Root element for the list of categories | |||||||||||||||||||||
root/categories/category | Root element for a single found category. This element occurs once per found category. | |||||||||||||||||||||
root/categories/category/id | Integer: The identifier of the category. | |||||||||||||||||||||
root/categories/category/name | String: The name of the category. | |||||||||||||||||||||
root/categories/category/type | The type of container. This value is always 'C' | |||||||||||||||||||||
root/categories/category/module | 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 or the root/categories/documenttype element value to determine the type of document a category can contain. | |||||||||||||||||||||
root/categories/category/description | String: A description of the category. | |||||||||||||||||||||
root/categories/category/hasdirectace | Bit: A value that indicates whether the category has any direct ACE (Access control entry) | |||||||||||||||||||||
root/categories/documenttype | The type of document that the category listed can contain. The value of this element is the numeric value of a member of the DocumentTypes enumeration. | |||||||||||||||||||||
root/categories/documentfilenamingconvention | A value that indicates how Content Studio determines the name of documents created in the category listed. The value of this element is the numeric value of a member of the FolderBaseDocumentFileNamingConvention enumeration. | |||||||||||||||||||||
root/categories/category/filepath |
The relative path name to the category.
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:
|
Exceptions
Exception | Condition |
---|---|
CSException | A business rule was violated in the underlying Content Studio database |
SqlException | An error occurred when executing the command against the Content Studio database |
Content Studio permissions
See Also