ContractExport URL
This URL exports a contract to an XML file.
The file generates under the WC_instance_name/xml/trading directory.
URL structure
- http:// host_name/path/
- The fully qualified name of your WebSphere Commerce Server and the configuration path.
Parameter values
- contractId
- Required: The contract ID for the contract you want 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_eardir /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.