semi合集-English.pdf - 第3409页

SEMI E132.1-0305 © SEMI 2005 36 the XML Schema element Error of type EstablishSessionErrorT ype. The error type is the sam e as that defined for the GetDefinedPrivileges operation described in ¶8.2.9.1.5. Table 61 Transl…

100%1 / 7923
SEMI E132.1-0305 © SEMI 2005 35
specification. Users are responsible for defining the mechanisms by which clients locate E132 equipment services
in the factory. A sample SessionManager service definition is provided in Figure 32 for reference only.
<?xml version="1.0" encoding="UTF-8"?>
<wsdl:definitions name="SessionManager"
xmlns="urn:semi-org:ws.E132-1.V0305.sessMgr-session"
targetNamespace="urn:semi-org:ws.E132-1.V0305.sessMgr-session"
xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"
xmlns:wsdl="http://schemas.xmlsoap.org/wsdl/"
xmlns:SMBind="urn:semi-org:ws.E132-1.V0305.sessMgr-binding">
<wsdl:import namespace="urn:semi-org:ws.E132-1.V0305.sessMgr-binding"
location="E132-1-V0305-SessionManager-Binding.wsdl"/>
<wsdl:service name="SessionManager">
<wsdl:port name="SessionManagerPort"
binding="SMBind:SessionManagerBinding">
<soap:address location="https://www.someplace/SessionManager"/>
</wsdl:port>
</wsdl:service>
</wsdl:definitions>
Figure 32
Sample SessionManager WSDL Service Definition
8.3.6 EstablishSession Operation
8.3.6.1 XML Schema Types
8.3.6.1.1 This section describes the XML mappings for the classes defined in SEMI E132 for the EstablishSession
operation. See GetDefinedPrivileges operation regarding schema conventions used. The session identifier SOAP
header is not used for this operation.
8.3.6.1.2 EstablishSession Request
8.3.6.1.2.1 The service request is mapped to the XML Schema element EstablishSessionRequest of type
EstablishSessionRequestType. Table 60 shows how the input parameters are mapped to XML.
EndPointSelectorType is as described in ¶8.2.13.1.5, XML description for the EndPoint class.
Table 60 Translation Table for EstablishSession Input Parameters
Argument Name Format XML Element or Attribute XML Name/Type
endpoint Structured type Element EndPoint: EndPointSelectorType
Figure 33
EstablishSessionRequest XML Schema Element
8.3.6.1.3 EstablishSession Response
8.3.6.1.3.1 The service response is mapped to the XML Schema element EstablishSessionResponse of type
EstablishSessionResponseType. Table 61 shows how the output parameters are mapped to XML. The XML
schema diagram for EstablishSessionResponse is shown in Figure 34. Errors for this operation are returned using
SEMI E132.1-0305 © SEMI 2005 36
the XML Schema element Error of type EstablishSessionErrorType. The error type is the same as that defined for
the GetDefinedPrivileges operation described in ¶8.2.9.1.5.
Table 61 Translation Table for EstablishSession Output Parameters
Argument Name Format XML Element or Attribute XML Name/Type
sessionId Text Element SessionID: xsd:string
error Structured data Element Error: EstablishSessionErrorType
Figure 34
EstablishSessionResponse XML Schema Element
8.3.6.2 WSDL Message(s)
8.3.6.2.1 Three messages are defined for this operation corresponding to the Request and Response messages. The
SOAP header message for session identifier is not used for this operation. See the message definitions for
“EstablishSessionRequestMessage”, and “EstablishSessionResponseMessage” in E132-SessionManager-
PortType.wsdl. Key information is shown for convenience in Table 62.
Table 62 EstablishSession Messages
Message Name
Schema
Element Name
EstablishSessionRequestMessage auth:EstablishSessionRequest
EstablishSessionResponseMessage auth:EstablishSessionResponse
8.3.6.3 WSDL Operation
8.3.6.3.1 See the portType operation definition for “EstablishSession” in E132-1-V0305-SessionManager-
PortType.wsdl. Key information is shown for convenience in Table 63.
Table 63 EstablishSession PortType Operation
Input Message Name
EstablishSessionRequestMessage
Output Message Name EstablishSessionResponseMessage
8.3.6.4 WSDL Operation Binding
8.3.6.4.1 See the operation binding for “EstablishSession” in E132-1-V0305-SessionManager-Binding.wsdl. Key
information is shown for convenience in Table 64. Note that the E132Header is still required, though the equipment
shall ignore the session ID provided in the request as this will be generated by the equipment following session
establishment. If SSL is enabled, equipment shall always use the ID from the client’s certificate for authorization
verifications, otherwise if SSL is disabled, the client can be identified using the FROM field of the E132Header.
See ¶7.3 for more information on and impact of disabling SSL.
Table 64 EstablishSession Operation Binding
SOAPAction
urn:semi-org:ws.E132-1.V0305.SessionManagerBinding:EstablishSession
Input Headers (WSDL Message, Required) E132HeaderMessage, required
Output Headers (WSDL Message, Required) E132HeaderMessage, required
SEMI E132.1-0305 © SEMI 2005 37
8.3.7 PersistSession Operation
8.3.7.1 XML Schema Types
8.3.7.1.1 This section describes the XML mappings for the classes defined in SEMI E132 for the PersistSession
operation. See GetDefinedPrivileges operation regarding schema conventions used.
8.3.7.1.2 PersistSession Request
8.3.7.1.2.1 The service request is mapped to the XML Schema element PersistSessionRequest of type
PersistSessionRequestType. Table 65 shows how the input parameters are mapped to XML.
Table 65 Translation Table for PersistSession Input Parameters
Argument Name Format XML Element or Attribute XML Name/Type
persist Boolean Element Persist: xsd:boolean
Figure 35
PersistSessionRequest XML Schema Element
8.3.7.1.3 PersistSession Response
8.3.7.1.3.1 The service response is mapped to the XML Schema element PersistSessionResponse of type
PersistSessionResponseType. Table 66 shows how the output parameters are mapped to XML, the error type is just
the common error described in ¶8.2.6.1. The XML Schema diagram for PersistSessionResponse is shown in Figure
36.
Table 66 Translation Table for PersistSession Output Parameters
Argument Name Format XML Element or Attribute XML Name/Type
error Structured data, of type
Error, defined in SEMI
E138
Element Error: ErrorType
Figure 36
PersistSessionResponse XML Schema Element
8.3.7.2 WSDL Message(s)
8.3.7.2.1 Three messages are defined for this operation corresponding to the SEMI E132 Header, Request and
Response messages. See the message definitions for “E132HeaderMessage”, “PersistSessionRequestMessage”, and
“PersistSessionResponseMessage” in E132-1-V0305-SessionManager-PortType.wsdl. Key information is shown
for convenience in Table 67.