2017

Table Of Contents
USING QUARKXPRESS SERVER
A Guide to QuarkXPress Server 2017 | 167
</form>
</body>
</html>
Using administrative request handlers
Administrative request handlers let you change the behavior of QuarkXPress Server.
The built-in administrative request handlers are described in the topics below
You can add your own request handlers. During the
DDSSETUPCBCODE callback,
QuarkXPress Server XTensions software registers itself as a request handler via
AddCustomRequestHandler, using the QuarkXPress Server XTensions API. The
first parameter of this API is a pointer to a request handler function implemented in
QuarkXPress Server XTensions software. The second parameter is a namespace string
that identifies the request. When a user submits a request that has the same
namespace string as a suffix to the request URL, QuarkXPress Server calls the request
handler function with all the user-specified parameters in the
ServerRequest
structure. The request handler function then processes the request and submits the
reply in a
ServerReply structure, which QuarkXPress Server communicates back to
the user agent.
Addfile
Use the addfile request handler to put a document or image file in the document
pool. An
addfile request is always a POST request because it uses binary content.
If you send an addfile request to QuarkXPress Server Manager using HTTP or the
Web services interface while the common doc pool switch is set to off in the
QuarkXPress Server Manager client, the file is uploaded to all registered QuarkXPress
Server instances. If the common doc pool is enabled, the file can be uploaded to any
one registered QuarkXPress server instance.
Namespace addfile
Parameters uploadfile
Binary file or MIME-
type file
Contains the actual
binary content of the
file to be uploaded.
This can be a
QuarkXPress file, a
Word file, a text file, or
a file with a MIME-type
such as EPS, JPEG, PNG,
or PICT.
Response The message “File upload completed.”
Alerts
The file system
document pool is not
enabled.
HTTP Error #404This alert displays if you
attempt to upload a document when the file
system document pool is not enabled. What to
do: Check Enable File System Document Pool in
the Server Configuration dialog box.
Incorrect
administration realm
user name and
password.
HTTP Error #401This alert displays if you specify
an invalid administrator user name and
password.What to do: Use the user name and
password set in theQuarkXPress Server Manager