Using the XML/SOAP Wrapper in Command-line Mode


Command-line Options

See Using EntireX in the Designer Command-line Mode for the general command-line syntax. The table below shows the command-line options for the XML/SOAP Wrapper.

Task Command Option Description
Create SOAP-conformant XML mapping for all programs. -map:soap    
-map:soap1.1   Supported for compatibility with older versions.
Create attribute-preferred XML mapping for all programs. -map:xmlattributes    
Create element-preferred XML mapping for all programs. -map:xmlelements    
Create element-preferred XML mapping with XML Schema for all programs -map:xmlwithxsd -namespace If namespace is specified, the namespace URI for the program node. XML Schema uses this namespace URI as the target namespace.
Create sample XML documents for all programs. -xml:sample    

Example

<workbench> -map:soap /Demo/example.idl

where <workbench> is a placeholder for the actual EntireX design-time starter as described under Using EntireX in the Designer Command-line Mode.

The name of the IDL file includes the project name. In the example, the project Demo is used. If the IDL file name describes a file inside the Eclipse workspace, the name is case-sensitive.

If the first part of the IDL file name is not a project name in the current workspace, the IDL file name is used as a relative (based on the IDL file) or absolute file name in the file system. Thus, the IDL files do not need to be part of an Eclipse project.

Status and processing messages are written to standard output (stdout), which is normally set to the executing shell window.

Further Examples

Windows Example 1

<workbench> -map:soap C:\Temp\example.idl

Uses the IDL file C:\Temp\example.idl and generates the XML mapping file example.xmm in parallel to the IDL. Slashes and backslashes are permitted in the file name. Output to standard output:

Using workspace file: C:\myWorkspace\.
Processing IDL file: C:\Temp\example.idl
Store XML mapping file: C:\Temp\example.xmm
Exit value: 0

Windows Example 2

<workbench> -map:soap /Demo/example.idl

Generates XML mapping files for all IDL files in project /Demo.

Linux Example 1

<workbench> -map:soap /Demo/example.idl

If the project Demo exists in the workspace and example.idl exists in this project, this file is used. Otherwise, /Demo/example.idl is used from file system.

Linux Example 2

<workbench> -map:soap /Demo/example.idl

Generates XML mapping files for all IDL files in project Demo (or in folder /Demo if the project does not exist).