Content Studio Web Content Management System
Assembly: CSServer5 (in CSServer5.dll) Version: 5.7.5016.0 (5.7.5016.0)
Xml, with the following syntax
[This is preliminary documentation and is subject to change.]
Returns information about a document's workflow status and what actions the caller can perform. The data includes the step xml.
Namespace: ContentStudio.Document.Workflow
Assembly: CSServer5 (in CSServer5.dll) Version: 5.7.5016.0 (5.7.5016.0)
Syntax
public string GetUserAction( ConnectionId connectionId, SessionId sessionId, DocumentId documentId, CategoryId categoryId )
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). - documentId
- Type: ContentStudio.DocumentDocumentId
The id of a document to get user actions for. If the document is about to be create this parameter can be set to zero and the system looks at the CategoryID parameter instead. In that case CategoryID must be supplied. - categoryId
- Type: ContentStudio.DocumentCategoryId
The id of a category that the document that are to be created belongs to. If DocumentID is supplied the system ignores this parameter. In that case DocumentID must be supplied.
Return Value
Type: StringXml, with the following syntax
<root> <usesworkflow>Boolean value</usesworkflow> <status>0</status> <statustext>Success</statustext> <accessmask>Integer value</accessmask> <workflow> <!-- If workflow is in use xml at this point contains the action information --> </workflow> </root>
Element | Meaning |
---|---|
root/usesworkflow | Numeric boolean, 1 if workflow is in use, 0 otherwise. |
root/status | Integer, always 0 which indicates a successful call. |
root/statustext | String, always "Success" which indicates a successful call. |
root/accessmask | Integer flags, a combination of the WorkflowCallerPermissions flag values indicating the permission of the caller. |
root/workflow | This is the root node for the returned workflow definitions xml that can be used to determine the actual actions that can be performed. This element is empty when no workflow is in use. |
Exceptions
Exception | Condition |
---|---|
InvalidOperationException | Both the DocumentID and the CategoryID arguments cannot be zero. |
CSException | A workflow rule was violated. |
XmlException | Invalid xml was supplied internally. |
See Also