semi合集-English.pdf - 第3394页

SEMI E132.1-0305 © SEMI 2005 21 8.2.10.1.2 .1 The service req uest is mapped to the XML Schema element GetACLRequest which is of type GetACLRequestType. The re are no input param eters for th is operation, thus the XML t…

100%1 / 7923
SEMI E132.1-0305 © SEMI 2005 20
8.2.9.1.5.1 Errors for this operation are mapped to the XML Schema element Error of type
GetDefinedPrivilegesErrorType. Figure 14 shows the XML Schema diagram for the error type. As shown, any
error returned must contain the common error element as described in ¶8.2.6.1. In addition, if the error is an
Operation not authorized error, the UnauthorizedOperationError must also be included providing additional context
information as defined in SEMI E132. The mapping for the UnauthorizedOperationError class is as described in
¶8.2.6.2.
Figure 14
GetDefinedPrivilegesErrorType XML Schema Type
8.2.9.2 WSDL Message(s)
8.2.9.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”, “GetDefinedPrivilegesRequest
Message”, and “GetDefinedPrivilegesResponseMessage” in E132-SecurityAdmin-PortType.wsdl. Key information
is shown for convenience in Table 18.
Table 18 GetDefinedPrivileges Messages
Message Name
Schema
Element Name
E132HeaderMessage auth:E132Header
GetDefinedPrivilegesRequestMessage auth:GetDefinedPrivilegesRequest
GetDefinedPrivilegesResponseMessage auth:GetDefinedPrivilegesResponse
8.2.9.3 WSDL Operation
8.2.9.3.1 See the portType operation definition for “GetDefinedPrivileges” in E132-SecurityAdmin-PortType.wsdl.
Key information is shown for convenience in Table 19.
Table 19 GetDefinedPrivileges PortType Operation
Input Message Name
GetDefinedPrivilegesRequestMessage
Output Message Name GetDefinedPrivilegesResponseMessage
8.2.9.4 WSDL Operation Binding
8.2.9.4.1 See the operation binding for “GetDefinedPrivileges” in E132-SecurityAdmin-Binding.wsdl. Key
information is shown for convenience in Table 20.
Table 20 GetDefinedPrivileges Operation Binding
SOAPAction
urn:semi-org:ws.E132-1.V0305.secAdmin-binding:GetDefinedPrivileges
Input Headers (WSDL Message, Required) E132HeaderMessage, required
Output Headers (WSDL Message, Required) E132HeaderMessage, required
8.2.10 GetACL Operation
8.2.10.1 XML Schema Types
8.2.10.1.1 This section describes the XML mappings for the classes defined in SEMI E132 for the GetACL
operation. See GetDefinedPrivileges operation regarding schema conventions used.
8.2.10.1.2 GetACL Request
SEMI E132.1-0305 © SEMI 2005 21
8.2.10.1.2.1 The service request is mapped to the XML Schema element GetACLRequest which is of type
GetACLRequestType. There are no input parameters for this operation, thus the XML type is just an empty
construct.
Figure 15
GetACLRequest XML Schema Element
8.2.10.1.3 GetACL Response
8.2.10.1.3.1 The service response is mapped to the XML Schema element GetACLResponse of type
GetACLResponseType. Table 21 shows how the output parameters are mapped to XML. The XML Schema
diagram for GetACLResponse is shown in Figure 16. The ACL is defined as a sequence of one or more elements of
type ACLEntrySelectorType corresponding to the SEMI E132 UML class ACLEntry. Mapping for ACLEntry class
is as described ¶8.2.10.1.4. Errors for this operation are returned using the XML Schema element Error of type
GetACLErrorType. The error type is the same as that defined for the GetDefinedPrivileges operation described in
¶8.2.9.1.5.
Table 21 Translation Table for GetACL Output Parameters
Argument Name Format XML Element or Attribute XML Name/Type
ACL Unordered list Element ACL: ACLEntrySelectorType (one or
more)
error Structured data Element Error: GetACLErrorType
Figure 16
GetACLResponse XML Schema Element
8.2.10.1.4 ACLEntry Class
8.2.10.1.4.1 The ACLEntry class is mapped to the XML Schema type ACLEntryType. ACLEntry is an abstract
base class and there are no attributes or roles defined for this base class, the XML Schema type for ACLEntry is just
a empty sequence. Since there are only two derived classes of ACLEntry defined in SEMI E132, and this
specification prohibits unrecognized extensions of the class, an ACLEntrySelector XML Schema type is defined
which uses choice to select between the XML Schema types for the only 2 derived classes, PrivilegeAssignment and
RoleAssignment. The XML Schema diagram for ACLEntrySelectorType is shown in Figure 17. Schema type
mappings for PrivilegeAssignment and RoleAssignment classes are further described in subsequent sections.
SEMI E132.1-0305 © SEMI 2005 22
Figure 17
ACLEntrySelectorType XML Schema Type
8.2.10.1.5 PrivilegeAssignment Class
8.2.10.1.5.1 The PrivilegeAssignment class is mapped to the XML PrivilegeAssignmentType. Table 22 shows how
the attributes and associations of PrivilegeAssignment class are mapped to XML. As with the XML definition for
the ACLEntry class, the XML SubjectSelectorType provides a choice between the XML types of the only 2 allowed
derived classes of the Subject class, Principal and Role. The XML mapping of Principal and Role classes are
described further by the RoleAssignment class. The XML Schema diagram for PrivilegeAssigmentType is shown in
Figure 18. PrivilegeAssignmentType extends ACLEntryType.
Table 22 Translation Table for PrivilegeAssignment Class
Attribute or Role Name UML Name/Type XML Element or Attribute XML Name/Type
subject Association Element Subject: SubjectSelectorType
privileges Association Element Privilege: PrivilegeType (one or more)
Figure 18
PrivilegeAssignment XML Schema Type
8.2.10.1.6 RoleAssignment Class
8.2.10.1.6.1 The RoleAssignment class is mapped to the XML RoleAssignmentType. Table 23 shows how the
attributes and associations of RoleAssignment class are mapped to XML. The XML Schema diagram for
RoleAssigmentType is shown in Figure 19. RoleAssignmentType extends ACLEntryType.