Content Studio Web Content Management System
Assembly: CSServer5 (in CSServer5.dll) Version: 5.7.5016.0 (5.7.5016.0)
A identifier to the PDF queue item just added.
The caller must have CREATE permission on the PDF-queue, WRITE permission on the document and CREATE on the destination category in order to succeed.
[This is preliminary documentation and is subject to change.]
Adds a new asynchronous entry to the PDF queue.
The document added must exist and be published but cannot be of the uploaded file type. The destination category must exist and be of the uploaded file type.
Namespace: ContentStudio.PDFServices
Assembly: CSServer5 (in CSServer5.dll) Version: 5.7.5016.0 (5.7.5016.0)
Syntax
public int AddToQueueAsync( ConnectionId connectionId, SessionId sessionId, DocumentId documentId, CategoryId destinationCategoryId, NotificationType notificationType, PDFNotificationWhen notificationWhen, bool autoArchive, string optionsXml, bool traverseTree, string queryStrings, PdfQueueFlags flags )
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 document to transfer into a pdf document. This can also be a root start document if we should traverse the tree of documents. - destinationCategoryId
- Type: ContentStudio.DocumentCategoryId
The category where the generated pdf documents should be created. Ignored if the settings of the category does not allow users to add their own preferences while creating pdfs - notificationType
- Type: ContentStudio.NotificationsNotificationType
The type of notification to send. Ignored if the settings of the category does not allow users to add their own preferences while creating pdfs - notificationWhen
- Type: ContentStudio.PDFServicesPDFNotificationWhen
Indicates when a notification should be sent. Ignored if use default is specified and if the settings of the category does not allow users to add their own preferences while creating pdfs - autoArchive
- Type: SystemBoolean
Reserved, currently not used, pass false - optionsXml
- Type: SystemString
Xml that contains settings. This value cannot exceed MAX_PDF_OPTIONSXML_LENGTH characters in length not included the embedded footer xml element. Ignored if the settings of the category does not allow users to add their own preferences while creating pdfs - traverseTree
- Type: SystemBoolean
Set to true to indicate that the pdf should be generated from the passed in document and all its child documents. Ignored if the settings of the category does not allow users to add their own preferences while creating pdfs - queryStrings
- Type: SystemString
Query strings to pass along to the documents when browsing them. This parameter cannot exceed MAX_PDF_QUERYSTRING_LENGTH characters in length. Ignored if the settings of the category does not allow users to add their own preferences while creating pdfs - flags
- Type: ContentStudio.PDFServicesPdfQueueFlags
Additional flags used by the PDF server. Ignored if the settings of the category does not allow users to add their own preferences while creating pdfs
Return Value
Type: Int32A identifier to the PDF queue item just added.
Exceptions
Exception | Condition |
---|---|
CSException | A business rule was violated in the underlying Content Studio database |
CSPermissionDeniedException | The caller has no permission to perform the requested action |
CSInvalidSessionException | The session is invalid |
CSInvalidParameterException | A parameter has an invalid value |
CSDocumentNotFoundException | The document could not be found |
SqlException | An error occurred when executing the command against the Content Studio database |
Content Studio permissions
See Also