2020

Table Of Contents
USING QUARKXPRESS SERVER
The form’s method is POST. The user agent conducts an HTTP post transaction
using the value of the action attribute (the URL), and a message is created according
to the content type specified by the enctype attribute.
When you use a multipart HTTP post request, you can include in the request any
files which are required by the rendering process, including QuarkXPress templates,
picture files, modifier XML, and digital publishing assets. For more information, see
Using the Streaming Document Provider.”
Using HTTP POST with QXP Server Manager
HTTP POST with QuarkXPress Server Manager works the same way as HTTP POST
with QuarkXPress Server (see “Using HTTP POSTwith QXP Server“), except that with
QuarkXPress Server Manager, you must use UTF-8.
Getting started: Web services
The Web services interface is a collection of request classes. You can download the
SDK WSDL class definitions from
http://[server]:[port]/qxpsm/services/RequestService?wsdl (replace
[server] with the QuarkXPress Server Manager computer’s IP address and [port]
with the QuarkXPress Server Manager port number.
These classes can be chained together to form compound QuarkXPress Server
requests. The sample applications (see “Sample Applications“) show how to use these
classes to invoke a QuarkXPress Server command and manipulate the response.
For more information, see “Functions.” In addition to the classes listed there, the
Web services interface includes the following:
RequestService processes QuarkXPress Server requests. This object’s generic
processRequest() method takes a QRequestContext argument and returns a
QContentData object containing the response. For more information, see the
sample applications and “Functions.”
QRequestContext is the argument you pass to RequestService‘s generic
processRequest() method.This object contains settings which must be set
once per request. Set all chained requests inside the request context.
QRequest is the base class for all request objects (such as PDFRenderRequest).
Consequently, all request objects share some common data members.
RequestParameters is a generic class for executing any request and for adding
dynamic properties to a request.
NameValueParam is a generic class for adding dynamic properties to a request.
This class is specifically for requests that take a box’s name and/or ID as the
parameter name and the box’s content as the value.
QContentData is the response returned when a request is executed.
QContentData is a hyperlink that follows the same pattern as the classes above.
QException is the exception class for QuarkXPress Server Manager. Web services
returns a QException object if an error occurs with any Web service method.
You can use try/catch blocks to handle QException objects.
38 | A GUIDE TO QUARKXPRESS SERVER 2020