8.0

errors. If you encounter an error, address the problem and execute "Server/utilities/stub.sh" or
"Server/utilities/stub.bat" again. If the process succeeds, "managerwebservicestubs.jar" is
generated in the
1.
Server/utilities directory. Use these Java stubs in your Java applications that communicate with
QuarkXPress Server Manager.
2.
2.
If the application you are developing is in Visual Studio .NET, then you need to generate stubs
again. Simply open your solution in Visual Studio, and either refresh the Web service reference
or remove and add the Web service reference again.
Understanding ManagerSDK.xml
"ManagerSDK.xml" is used to generate client SDK classes for QuarkXPress Server requests. Each
element of "ManagerSDK.xml" corresponds to a request handler, a render type, or an element in the
DTD. A client SDK class is generated for each element in XML. Each property in the DTD and each
parameter of the request handler or render type also corresponds to a unique element in the XML. A
class variable is generated for each property. See below for details.
Class: One element for each SDK class generated. The class generated would be derived from
QRequest.
Name: Name of the generated class.
namespace: The namespace recognized by QuarkXPress Server when this request class is translated into
a QuarkXPress Server request.
Description: Description of the class. Unless it has a null value, description forms the header of the
generated class and is included in the generated API docs.
Alias: The alias to be used as an element name if this request class is serialized to XML. For
example,when the Project class is serialized to XML, the element used is
Project.
SerializeAs: Option that decides how the class should be serialized.
NameValue means that all members of the class should be handled as name value pairs in the request to
QuarkXPress Server. This is the default option in, for example, in JPEGRenderRequest and
ModifierStreamRequest.
XML means that the class should be serialized as XML with the class name or alias as the element. All
the fields of the class are serialized as child elements. If the field is a subclass of QRequest, it is
processed recursively. If the field is an array, it is mandatory that it should be an array of
QRequest-derived classes.
Mixed means that the class should be serialized as XML with the class name or alias as the element. All
the primitive fields of the class would be serialized as attributes. If the field is a subclass of QRequest, it
would be serialized as a child element and it is processed recursively. If the field is an array, it is
mandatory that it should be an array of
QRequest-derived classes.
Attribute is valid only if the parent class has provided its serialize option as "XML" or "Mixed." It means
that the class should be serialized as XML with the class name or alias as the element. The class fields
can only be primitive in this case. All such fields should be serialized as attributes of the element. Further,
"value" fields are serialized as values of the element.
Attribute: One element for each class field.
Name: Name of the generated class variable.
Accessor: Unless it has a null value, this is the name of the accessor to get the property. Otherwise, the
name generated would be "get" + CamelCase(name). For example, if the name of the property were
"quality," the default accessor method would be "getQuality." It can be overridden by using this attribute
(e.g., "getJPEGQuality").
mutator: Unless it has a null value, this is the name of the mutator to set the property. Otherwise, the
Page 39