Common Mistakes

The following is a list of common mistakes when using Descriptors:

Forgetting to specify the required Descriptor parameters.
Not specifying a source URL when calling a relative URL from a Descriptor element.
Changing parameter requirements and not redeploying the Descriptor.
XML syntax problems. Use a tool like xmllint.
XSL syntax problems. Use a command line XSL processor.
Redeploying built in Descriptors and forgetting to redeploy other Descriptors.
If a Descriptor returns something other than XML, you can not use the Descriptor execute Web Service/API which returns a org.w3c.dom element. This attempts to turn the Descriptor result into XML and fails if it is not XML. Use the executeQueryToString Web Service/API instead.