9.2
Table Of Contents
- Contents
- Overview
- Changes in this version
- Getting started
- Using the Web interface
- Understanding rendering
- Understanding logging
- Understanding render types
- Understanding render modifiers
- Using content modifiers
- Using XML modify
- Using XML deconstruct and construct
- Deconstructing a project
- Constructing a project
- Working with pages and spreads
- Working with layers
- Working with boxes
- Working with groups
- Working with pictures
- Working with text
- Working with tables
- Working with sections
- Working with Composition Zones
- Using XSL transformation
- Working with lists
- Working with anchored boxes
- Working with placeholders
- Working with metadata
- Working with hidden text
- Creating and using hyperlinks
- Using the Streaming Document Provider
- Using administrative request handlers
- Using the QXPSM SDK
- Modifier DTD (annotated)
- Entities (Modifier DTD)
- ADDCELLS (Modifier DTD)
- ALIGNHORSETTINGS (Modifier DTD)
- ALIGNVERSETTINGS (Modifier DTD)
- ALLOWBOXOFFPAGE (Modifier DTD)
- ALLOWBOXONTOPASTEBOARD (Modifier DTD)
- ANCHOREDBOXREF (Modifier DTD)
- ARTICLE (Modifier DTD)
- AUTHOR (Modifier DTD)
- BNSTYLE (Modifier DTD)
- BOTTOM (Modifier DTD)
- BOTTOMGRID (Modifier DTD)
- BOX (Modifier DTD)
- BOXREF (Modifier DTD)
- CALLOUTANCHOR (Modifier DTD)
- CALLOUTBOXREF (Modifier DTD)
- CELL (Modifier DTD)
- CHILDID (Modifier DTD)
- CLIPPING (Modifier DTD)
- COLGROUP (Modifier DTD)
- COLSPEC (Modifier DTD)
- COLUMN (Modifier DTD)
- COMPONENT (Modifier DTD)
- COMPOSITIONZONE (Modifier DTD)
- CONTENT (Modifier DTD)
- CONTENTPH (Modifier DTD)
- CONTINUEDHEADER (Modifier DTD)
- CONTINUEDTROWSTYLE (Modifier DTD)
- CONTOUR (Modifier DTD)
- CONTOURS (Modifier DTD)
- COPYFIT (Modifier DTD)
- COPYRIGHT (Modifier DTD)
- DATAPROVIDER (Modifier DTD)
- DELETECELLS (Modifier DTD)
- DESCRIPTION (Modifier DTD)
- DROPCAP (Modifier DTD)
- EBOOKMETADATA (Modifier DTD)
- ENTRY (Modifier DTD)
- EVENTCOLSTYLE (Modifier DTD)
- EVENTROWSTYLE (Modifier DTD)
- FIRSTTCOLSTYLE (Modifier DTD)
- FIT (Modifier DTD)
- FITTEXT (Modifier DTD)
- FOOTER (Modifier DTD)
- FOOTERTROWSTYLE (Modifier DTD)
- FORMAT (Modifier DTD)
- FRAME (Modifier DTD)
- GEOMETRY (Modifier DTD)
- GRID (Modifier DTD)
- GRIDLINE (Modifier DTD)
- GROUP (Modifier DTD)
- GROUPCHARACTERS (Modifier DTD)
- GROWACROSS (Modifier DTD)
- GROWDOWN (Modifier DTD)
- HEADER (Modifier DTD)
- HEADTROWSTYLE (Modifier DTD)
- HEIGHT(Modifier DTD)
- HIDDEN (Modifier DTD)
- HYPERLINK (Modifier DTD)
- ID (Modifier DTD)
- INLINETABLE (Modifier DTD)
- INSET (Modifier DTD)
- INTERACTIVITY (Modifier DTD)
- ISBN (Modifier DTD)
- KEEPLINESTOGETHER (Modifier DTD)
- KEYWORDS (Modifier DTD)
- LASTTCOLSTYLE (Modifier DTD)
- LAYER (Modifier DTD)
- LAYOUT (Modifier DTD)
- LAYOUTREF (Modifier DTD)
- LEFT (Modifier DTD)
- LEFTCONTROLPOINT (Modifier DTD)
- LEFTGRID (Modifier DTD)
- LINESTYLE (Modifier DTD)
- LINKEDBOX (Modifier DTD)
- LIST (Modifier DTD)
- LOCATION (Modifier DTD)
- LOCKTOGRID (Modifier DTD)
- MAX (Modifier DTD)
- METADATA (Modifier DTD)
- MIN (Modifier DTD)
- MOVEDOWN (Modifier DTD)
- MOVELEFT (Modifier DTD)
- MOVERIGHT (Modifier DTD)
- MOVEUP (Modifier DTD)
- ODDTROWSTYLE (Modifier DTD)
- ODDTCOLSTYLE (Modifier DTD)
- ORIGIN (Modifier DTD)
- OVERMATTER (Modifier DTD)
- PAGE (Modifier DTD)
- PAGEREF (Modifier DTD)
- PARAGRAPH (Modifier DTD)
- PARENTTABLE (Modifier DTD)
- PICTURE (Modifier DTD)
- PLACEHOLDER (Modifier DTD)
- POSITION (Modifier DTD)
- PROJECT (Modifier DTD)
- PUBLICATION (Modifier DTD)
- PUBLICATIONCHANNEL (Modifier DTD)
- PUBLISHER (Modifier DTD)
- RELPOSITION (Modifier DTD)
- RGBCOLOR (Modifier DTD)
- RICHTEXT (Modifier DTD)
- RIGHT (Modifier DTD)
- RIGHTCONTROLPOINT (Modifier DTD)
- RIGHTGRID (Modifier DTD)
- ROW (Modifier DTD)
- RUBI (Modifier DTD)
- RUBITEXT (Modifier DTD)
- RULE (Modifier DTD)
- RUNAROUND (Modifier DTD)
- SAVEAS (Modifier DTD)
- SCALETO (Modifier DTD)
- SECTION (Modifier DTD)
- SHADOW (Modifier DTD)
- SHRINKACROSS (Modifier DTD)
- SHRINKDOWN (Modifier DTD)
- SIZE (Modifier DTD)
- SPINEIMAGE (Modifier DTD)
- SPLINESHAPE (Modifier DTD)
- SPREAD (Modifier DTD)
- STACKINGORDER (Modifier DTD)
- STORY (Modifier DTD)
- SUPPRESSOUTPUT (Modifier DTD)
- TAB (Modifier DTD)
- TABLE (Modifier DTD)
- TABLEBREAK (Modifier DTD)
- TABLESTYLE (Modifier DTD)
- TABSPEC (Modifier DTD)
- TBODY (Modifier DTD)
- TCOL (Modifier DTD)
- TCOLSTYLE (Modifier DTD)
- TCONTINUED (Modifier DTD)
- TEXT (Modifier DTD)
- TEXTNODEPH (Modifier DTD)
- TEXTPH (Modifier DTD)
- TFOOT (Modifier DTD)
- THEAD (Modifier DTD)
- TITLE (Modifier DTD)
- TOP (Modifier DTD)
- TOPGRID (Modifier DTD)
- TROW (Modifier DTD)
- TROWSTYLE (Modifier DTD)
- VALUE (Modifier DTD)
- VERTEX (Modifier DTD)
- VERTEXPOINT (Modifier DTD)
- VERTICES (Modifier DTD)
- WIDTH (Modifier DTD)
- Sample applications
- Contacting Quark
- Legal notices
- Index
(Note that you can also supply assets as part of a multipart HTTP request. For more
information, see "Using HTTP POST with QXP Server.")
•
[DocumentName]: The name of the QuarkXPress project to be processed.
•
[parameter]: Further defines the URL action with attributes and values allowed for the
namespace or general call. Pass parameters in the form attribute=value, with parameters
separated by the "&" character.
For QuarkXPress Server Manager, use a URL like the following:
http://[server]:[port]/qxpsm/request/[namespace]/[directory]/
[DocumentName]?[parameter]=Value
Prior to QuarkXPress Server 9.0, you had to use different URL constructions when sending
requests to an instance of QuarkXPress Server Manager in a QPS installation than you did
when sending requests to a free-standing instance of QuarkXPress Server Manager. In
versions 9.0 and later, both can use /qxpsm/request/ after [port]/ .
You can now use both absolute and relative paths when you modify a project with SDK
objects or classes. Relative paths are almost always relative to the document pool. If you
use multiple QuarkXPress Server instances, you should use a common document pool.
Interpreting the QXP Server Manager response
When QuarkXPress Server Manager successfully processes a request through the HTTP
interface, the response is the same as QuarkXPress Server's response unless the user has
supplied additional parameters to QuarkXPress Manager. For more information, see
"Working with QuarkXPress Server Manager" in A Guide to QuarkXPress Server.
If an error occurs, QuarkXPress Server Manager retries the request, either on the same
QuarkXPress server instance or a different one (depending on the error and global settings
established in the QuarkXPress Server Manager client). If QuarkXPress Server Manager
cannot process the request, it returns an XML response describing the error, plus any
header error codes returned by QuarkXPress Server. For example:
<?xml version="1.0" encoding="UTF-8" ?>
<error>
<httpresponsecode>500</httpresponsecode>
<xpressservererrorcode>-43</xpressservererrorcode>
<xpressservererrormessage>File not found.</xpressservererrormessage>
<xpressserverextendedmessage> <![CDATA[ Error #-43 - File not found. ]]>
</xpressserverextendedmessage>
<xpressservermanagererrorcode>M8000001</xpressservermanagererrorcode>
<xpressservermanagererrormessage>The server could not locate the specified
file.
</xpressservermanagererrormessage>
</error>
HTTP GET and POST Requests
The topics below describe how you can use HTML to interact with QuarkXPress Server.
QuarkXPress Server supports both the GET and POST HTML methods. When you use the
GET method, the browser encodes form data into a URL. When you use the POST method,
form data is passed within the message body. Use the GET method only when the form
QXP SERVER 9.2 WEB INTEGRATION GUIDE | 15
GETTING STARTED