8.0
Table Of Contents
- Overview
- New and enhanced features
- Getting started
- Functions
- Function overview
- Render types
- Content modifiers
- Render modifiers
- XML modify
- XML deconstruct and construct
- About XML deconstruct/construct
- xml
- construct
- Deconstructing a project
- Constructing a project
- Working with pages and spreads
- Working with layers
- Working with boxes
- Working with pictures
- Working with text
- Working with tables
- Working with Composition Zones
- Using server XSLT
- Working with lists
- Working with anchored boxes
- Working with placeholders
- Working with metadata
- Working with hidden text
- Administrative Request handlers
- The Modifier DTD
- Sample applications
- Contact Quark
- Legal notice
Inserting a picture
Places a new picture in an empty picture box or replaces an existing picture with a new one.
Parameters
<box-name>
string
This parameter replaces the content of
the box named <box-name> with a new
picture file. The new picture file is
specified by the file: indicator. The
picture file must be present in the
document pool.
Response
The QuarkXPress project with a new picture in the picture box.
Alerts
File not found.
HTTP Error #404
QuarkXPress Server Error #-43
This alert is displayed when you attempt to place a picture
into a picture box but the picture does not exist in the
document pool.
What to do
: Check whether the picture you attempted to get exists in the
document pool. If not, then place the picture in the document
pool and then resubmit the request to QuarkXPress Server. If
the picture exists in the document pool, check the picture
name in the request.
QuarkXPress Server also supports relative paths, which can
reduce the number of these alerts if paths are specified
correctly.
This alert is also displayed if the picture is placed in a
subfolder of the document pool. In this case, use the file:
indicator before the picture file path. For example:
http://localhost:8080/sample.qxp?Publisher=file:ABC/Publishe
r.pdf
In this example the Publisher.pdf file located in the ABC
folder in the document pool is placed into the picture box
named Publisher.
The specified file
failed to load in the
picture box.
HTTP Error #500
This alert is displayed when you attempt to place an invalid
picture file in the picture box.
What to do: Enter the correct file name and file type in the
request.
Logs
If the project is successfully rendered, a transaction success message is written to
the QuarkXPress Server Transaction Log file. The transaction entry consists of the
date and time of the request, render type, project name, type of response
produced by the server, size of the response returned in bytes, and client IP
address.
The following is a sample of a transaction entry:
8/3/2005 11:27:42 - jpeg/sample.qxp - Type: image/jpeg - Size: 31715 -
Client: 127.0.0.1
If an alert is displayed, an error message is written to the QuarkXPress Server
Page 83