PDFQueueManagerAddToQueueAsync Method (ConnectionId, SessionId, DocumentId, CategoryId, NotificationType, PDFNotificationWhen, Boolean, String, Boolean, String, PdfQueueFlags) Content Studio 5.7 SDK
Content Studio Web Content Management System

[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: Int32
A identifier to the PDF queue item just added.
Exceptions

ExceptionCondition
CSExceptionA business rule was violated in the underlying Content Studio database
CSPermissionDeniedExceptionThe caller has no permission to perform the requested action
CSInvalidSessionExceptionThe session is invalid
CSInvalidParameterExceptionA parameter has an invalid value
CSDocumentNotFoundExceptionThe document could not be found
SqlExceptionAn error occurred when executing the command against the Content Studio database
Content Studio permissions

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.
See Also

Reference