Reference > Shop flow URLs > Trading subsystem URLs > Account and contract URLs
ContractExport URL
This URL exports a contract to an XML file.
URL structure
- http:// host_name/path/
- The fully qualified name of the WebSphere Commerce Server and the configuration path.
name-value pair with the & character. For a detailed description of the parameters and their values, see the list entitled Parameter values." />
Parameter values
- contractId
- Required: The contract ID for the contract to export, as found in the CONTRACT database table.
- fileName
- Required: The name you want the contract XML file to have. If you do not specify the full path name for the XML file, the XML file will be written to the WC_EAR /xml/trading/xml directory.
- langId
- Required: Use this parameter to specify the language of the descriptions in the contract you want exported. Descriptions in languages other than the language specified by this parameter will not be exported to the generated XML file.
- xsdName
- Required: The XSD file name to use for the root element.
- xmlFileEncoding
- Use this parameter to specify the encoding of the generated XML file. If you do not specify this option, the generated XML file will be encoded using UTF-8 encoding. For a list of all supported international encodings that can be specified with this parameter, see the related topic below.
- all
- Specifies whether to include all reference numbers and timestamps when exporting the contract or not. Valid values for this parameter are true and false. Use true to include all reference numbers and timestamps. Use false to omit all reference numbers and timestamps
If this parameter is not specified, a value of true is assumed.
- URL
- Required: The URL to be called when the command completes successfully.
Example
The following example exports contractID 260369 to a UTF-8 encoded XML file in the default directory called contract260369.xml:
https://myhostname/webapp/wcs/stores/servlet/ContractExport? contractId=260369&fileName=contract260369.xml&langId=-1&xsdName=Package.xsd &URL=StoreCatalogDisplay?storeId=512&catalogId=512
Behavior
This URL creates an XML file from the information in the WebSphere Commerce database for the specified contract number.
Exception conditions
- _ERR_CONTRACT_OBJECT_NOT_FOUND will be thrown if a contract with the specified contract ID is not found in the WebSphere Commerce database.
- _ERR_UNSUPPORTED_ENCODING will be thrown if the xmlFileEncoding parameter specified is not supported.
- _ERR_WRONG_CONTRACT_STATE will be thrown if the contract is in the DeploymentInProgress or DeploymentFailed state.