Description
Given a model and configuration name and/or parameters that drive the model, this Interface returns a link to a viewable file for the specified configuration.
For a list of fault codes, see XML Faults.
Interface
|
<interfacename> |
SWGenerateConfigView3D |
Name of the interface |
|---|---|---|
|
<sessionid> |
Id |
Id of the active session |
Parameters
|
<secure> |
Secure |
Security flag. |
|
<model> |
ModelName |
Name of the file to obtain |
|
<enduser> |
Enduser |
Unique string logged in by every download or view request, optional |
|
<config> |
ConfigurationName |
Name of the configuration to use, optional |
|
<param attr="Name"> |
ParamName |
Named parameter in the configuration, optional, use as many as necessary |
|
<operatingsystem> |
OperatingSystemName |
Name of the operating system of the browser sending the request. Currently supports Windows and Unix. If this tag is not found, Windows is assumed. |
Return Values
|
<success> |
Description |
Success description |
|
<returnval> |
Hyperlink |
Link to the necessary output |
Fault Values
|
<faultcode> |
ErrorNumber |
Error code |
|
<faultstring> |
Description |
Description of the error |
Remarks
The ModelName is the full pathname to the model on
the server.
The returned Hyperlink represents the file used to download the model for
viewing.
There is no enforcement of rules for parameter names or values. For example, any invalid parameter names are simply ignored. As long as a configuration was successfully generated from the parameters supplied, that configuration will be returned and will also be cached with the name provided on input. This cached configuration will then be returned on any subsequent SWGetConfigView3D calls that match this configuration name.
Sample SOAP/XML Request
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<interfacename>SWGenerateConfigView3D</interfacename>
<sessionid>0000</sessionid>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<interfaceparameters>
<secure>off</secure>
<model>modelName</model>
<config>configurationName</config>
<param attr="Dim1">configDim1</param>
<param attr="Dim2">configDim2</param>
<param attr="...">configDim...</param>
<param attr="DimX">configDimX</param>
<operatingsystem>unix</operatingsystem>
</interfaceparameters>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Sample SOAP/XML Success Response
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<interfacename>SWGenerateConfigView3D</interfacename>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<sessionid>0000</sessionid>
<returnval>Link to requested output</returnval>
<success>Description</success>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>
Sample SOAP/XML Error Response
<SOAP-ENV:Envelope
xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/"
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<SOAP-ENV:Header>
<interfacename>SWGenerateConfigView3D</interfacename>
</SOAP-ENV:Header>
<SOAP-ENV:Body>
<sessionid>0000</sessionid>
<returnval></returnval>
<success>Description</success>
<faultcode>0000</faultcode>
<faultstring>Description</faultstring>
</SOAP-ENV:Body>
</SOAP-ENV:Envelope>