SOA-EERP Business Rating of Service Version 1.0
Committee Specification 01
25 November 2010
Specification URIs:
This Version:
http://docs.oasis-open.org/soa-eerp/rt/v1.0/SOA-EERP-bRating-Spec-cs01.html
http://docs.oasis-open.org/soa-eerp/rt/v1.0/SOA-EERP-bRating-Spec-cs01.doc
http://docs.oasis-open.org/soa-eerp/rt/v1.0/SOA-EERP-bRating-Spec-cs01.pdf (Authoritative)
Previous Version:
http://docs.oasis-open.org/soa-eerp/rt/v1.0/SOA-EERP-Rating-Spec-cd03.html
http://docs.oasis-open.org/soa-eerp/rt/v1.0/SOA-EERP-Rating-Spec-cd03.doc
http://docs.oasis-open.org/soa-eerp/rt/v1.0/SOA-EERP-Rating-Spec-cd03.pdf
Latest Version:
http://docs.oasis-open.org/soa-eerp/rt/v1.0/SOA-EERP-Rating-Specification.html
http://docs.oasis-open.org/soa-eerp/rt/v1.0/SOA-EERP-Rating-Specification.doc
http://docs.oasis-open.org/soa-eerp/rt/v1.0/SOA-EERP-Rating-Specification.pdf
OASIS Service-Oriented Architecture End-to-End Resource Planning (SOA-EERP) TC
Chair(s):
William Cox
Andy Lee, Changfeng Open Standards Platform Software Alliance
Editor(s):
Szu Chang, Changfeng Open Standards Platform Software Alliance
Related work:
This specification is related to:
· SOA-EERP Business Service Level Agreement specification, Version 1.0, http://docs.oasis-open.org/soa-eerp/sla/v1.0/SOA-EERP-BSLA-Specification.pdf
This document is one of three closely related specifications, SOA-EERP Business Quality of Service (bQoS), SOA-EERP Business Rating (bRating) and SOA-EERP Business Service Level Agreement (bSLA) which need to be understood in combination.
Declared XML Namespace(s):
http://docs.oasis-open.org/ns/soa-eerp/rt/200903
Abstract:
This document specifies the XML vocabulary for business rating, one of three Specifications for end-to-end resource planning (EERP). Business rating describes the business-related rating and credentials for a service.
Status:
This document was last revised or approved by the SOA-EERP TC on the above date. The level of approval is also listed above. Check the “Latest Version” or “Latest Approved Version” location noted above for possible later revisions of this document.
Technical Committee members should send comments on this specification to the Technical Committee’s email list. Others should send comments to the Technical Committee by using the “Send A Comment” button on the Technical Committee’s web page at http://www.oasis-open.org/committees/soa-eerp/.
For information on whether any patents have been disclosed that may be essential to implementing this specification, and any offers of patent licensing terms, please refer to the Intellectual Property Rights section of the Technical Committee web page (http://www.oasis-open.org/committees/soa-eerp/ipr.php).
The non-normative errata page for this specification is located at http://www.oasis-open.org/committees/soa-eerp/.
Notices
Copyright © OASIS® 2010. All Rights Reserved.
All capitalized terms in the following text have the meanings assigned to them in the OASIS Intellectual Property Rights Policy (the "OASIS IPR Policy"). The full Policy may be found at the OASIS website.
This document and translations of it may be copied and furnished to others, and derivative works that comment on or otherwise explain it or assist in its implementation may be prepared, copied, published, and distributed, in whole or in part, without restriction of any kind, provided that the above copyright notice and this section are included on all such copies and derivative works. However, this document itself may not be modified in any way, including by removing the copyright notice or references to OASIS, except as needed for the purpose of developing any document or deliverable produced by an OASIS Technical Committee (in which case the rules applicable to copyrights, as set forth in the OASIS IPR Policy, must be followed) or as required to translate it into languages other than English.
The limited permissions granted above are perpetual and will not be revoked by OASIS or its successors or assigns.
This document and the information contained herein is provided on an "AS IS" basis and OASIS DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTY THAT THE USE OF THE INFORMATION HEREIN WILL NOT INFRINGE ANY OWNERSHIP RIGHTS OR ANY IMPLIED WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
OASIS requests that any OASIS Party or any other party that believes it has patent claims that would necessarily be infringed by implementations of this OASIS Committee Specification or OASIS Standard, to notify OASIS TC Administrator and provide an indication of its willingness to grant patent licenses to such patent claims in a manner consistent with the IPR Mode of the OASIS Technical Committee that produced this specification.
OASIS invites any party to contact the OASIS TC Administrator if it is aware of a claim of ownership of any patent claims that would necessarily be infringed by implementations of this specification by a patent holder that is not willing to provide a license to such patent claims in a manner consistent with the IPR Mode of the OASIS Technical Committee that produced this specification. OASIS may include such claims on its website, but disclaims any obligation to do so.
OASIS takes no position regarding the validity or scope of any intellectual property or other rights that might be claimed to pertain to the implementation or use of the technology described in this document or the extent to which any license under such rights might or might not be available; neither does it represent that it has made any effort to identify any such rights. Information on OASIS' procedures with respect to rights in any document or deliverable produced by an OASIS Technical Committee can be found on the OASIS website. Copies of claims of rights made available for publication and any assurances of licenses to be made available, or the result of an attempt made to obtain a general license or permission for the use of such proprietary rights by implementers or users of this OASIS Committee Specification or OASIS Standard, can be obtained from the OASIS TC Administrator. OASIS makes no representation that any information or list of intellectual property rights will at any time be complete, or that any claims in such list are, in fact, Essential Claims.
The names "OASIS", “SOA-EERP”, “EERP-bRating”, and “bRating” are trademarks of OASIS, the owner and developer of this specification, and should be used only to refer to the organization and its official outputs. OASIS welcomes reference to, and implementation and use of, specifications, while reserving the right to enforce its marks against misleading uses. Please see http://www.oasis-open.org/who/trademark.php for above guidance.
Table of Contents
2.3 Rating Measurement Indicators
5.1 Service Rating for an Engineering Service
5.2 Service Rating for Gas-Meters Product
This document is the specification for Business Rating (bRating) for End-to-End Resource Planning (EERP), an XML vocabulary for information exchange on business credibility, reliability and reputation of the service providers.
According to OASIS Reference Model for Service Oriented Architecture [SOA-RM], the Service Oriented Architecture (SOA) is a paradigm for organizing and utilizing distributed capabilities that may be under the control of different ownership domains. The service within SOA is a mechanism to enable access to one or more capabilities, where the access is provided using a prescribed interface and is exercised consistent with constraints and policies as specified by the service description. This specification further defines the bRating for the services within the EERP technology. The applications of this specification are any kind of business services, and they are not limited to only Web Services.
EERP applies the well-known technique for service discovery and optimization in a novel way to improve business results. It models the business process and the range of potential services, and then guides the selection and deployment of services based on the end-to-end business value.
The credibility, reliability and reputation of the service need to be understood for estimating the overall business quality of the process that uses those services. The business rating characteristics of the service defined in this bRating specification will enable EERP to determine the varieties of optimization to be supported, and to select optimal end-to-end solution.
The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”, “SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in [RFC2119].
This specification uses the following syntax to define outlines for detailed elements:
Elements and Attributes defined by this specification are referred to in the text of this document using XPath 1.0 expressions. Extensibility points are referred to using an extended version of this syntax:
· An element extensibility point is referred to using {any} in place of the element name. This indicates that any element name can be used, from any namespace other than the namespace of this specification.
· An attribute extensibility point is referred to using @{any} in place of the attribute name. This indicates that any attribute name can be used, from any namespace other than the namespace of this specification.
Extensibility points in the exemplar may not be described in the corresponding text.
[RFC2119] S. Bradner, Key words for use in RFCs to Indicate Requirement Levels, http://www.ietf.org/rfc/rfc2119.txt, IETF RFC 2119, March 1997.
http://www.w3.org/TR/2003/REC-soap12-part1-20030624/
[SOAP] W3C Note, "SOAP: Simple Object Access Protocol 1.1", 08 May 2000.
http://www.w3.org/TR/2000/NOTE-SOAP-20000508/
[SOAP12] W3C Recommendation, "SOAP 1.2 Part 1: Messaging Framework", 24 June 2003.
http://www.w3.org/TR/2003/REC-soap12-part1-20030624/
[URI] T. Berners-Lee, R. Fielding, L. Masinter, "Uniform Resource Identifiers (URI): Generic Syntax", RFC 3986, MIT/LCS, Day Software, Adobe Systems, January 2005.
http://www.ietf.org/rfc/rfc3986.txt
[UBL-20] OASIS Standard, “Universal Business Language (UBL) v2.0”, 12 December 2006
http://docs.oasis-open.org/ubl/os-UBL-2.0/UBL-2.0.pdf
[UBL-20-cbc] Universal Business Language (UBL) v2.0, Common Basic Components, October 2006.
http://docs.oasis-open.org/ubl/os-UBL-2.0/xsd/common/UBL-CommonBasicComponents-2.0.xsd
[UBL-20-udt] Universal Business Language (UBL) v2.0. Unqualified Data Type, February 2005.
http://docs.oasis-open.org/ubl/os-UBL-2.0/xsd/common/UnqualifiedDataTypeSchemaModule-2.0.xsd
[XML-Schema1] W3C Recommendation, "XML Schema Part 1: Structures Second Edition", 28 October 2004.
http://www.w3.org/TR/2004/REC-xmlschema-1-20041028/
[XML-Schema2] W3C Recommendation, "XML Schema Part 2: Datatypes Second Edition", 28 October 2004.
http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/
[CEFACT] CEFACT – Core components specifications Recommendation 9, January
1996.
http://www.unece.org/cefact/recommendations/rec09/rec09_ecetrd203.pdf
In this document reference is made to some basic elements and data types in UBL 2.0, in the following schema:
· UBL 2.0 Common Basic Components (UBL-20-cbc), UBL-CommonBasicComponents-2.0.xsd
· UBL 2.0 Unqualified Data Type (UBL-20-udt), UnqualifiedDataTypeSchemaModule-2.0.xsd
This specification is designed to work with the general Web Services framework including WSDL service descriptions, and SOAP message structure and message processing model. The XML vocabulary defined in this specification should be applicable to any version of SOAP.
None.
The XML vocabulary for Business Rating is defined in XML Schema for this specification with several specific rating measurement indicators.
The XML namespace URI that MUST be used by implementations of this specification is:
http://docs.oasis-open.org/ns/soa-eerp/rt/200903
Table 1 lists XML namespaces that are used in this specification. The choice of any namespace prefix is arbitrary and not semantically significant.
Table 1: Prefixes and XML Namespaces used in this specification.
Prefix |
Namespace |
Specification(s) |
S |
http://schemas.xmlsoap.org/soap/envelope/ |
[SOAP] |
S12 |
http://www.w3.org/2003/05/soap-envelope |
[SOAP12] |
xsd |
http://www.w3.org/2001/XMLSchema |
[XML-Schema1], [XML-Schema2] |
cbc |
urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2 |
|
udt |
urn:un:unece:uncefact:data:specification:UnqualifiedDataTypesSchemaModule:2 |
|
ccts |
urn:un:unece:uncefact:documentation:2 |
[UBL-20] |
rt |
http://docs.oasis-open.org/ns/soa-eerp/rt/200903 |
This specification |
A normative copy of the XML Schema [XML-Schema1, XML-Schema2] description for this specification can be retrieved from the following address:
http://docs.oasis-open.org/soa-eerp/rt/v1.0/EERP-bRating-cd04.xsd
The BRating is the root element of Business Rating for EERP which is for business reliability and reputation of the service and its services provider. It can have one or more of the following elements:
· ListOfRating element is for the rating aspect of service which is provided by rating provider and measured in terms of rates for the service. Each Rating element in the ListOfRating element is issued by a rating provider, a third party rating organization, that has either an aggregated numeric number or an aggregated classification description to represent the rating measurement of the given business service.
· Credentials element is for the rating aspect of service which is measured in terms of credentials for the service that the service provider owns or holds. Credentials are issued by organizations regulating the service, such as licenses, permissions, certifications, associations, affiliations, etc. Each credential element in the Credentials element is a non-aggregated indicator for the rating measurement of the given business service, and it does not provide an aggregated value for the measurement.
· Any additional elements for the rating aspect of service. For example, this could be one or more elements of Performance:QualityAssertionEvaluation that will provide a mechanism for Service Rating Entities to render their evaluation for how well the provider fulfills the Quality Assertion(s) of its service.
Both the ListOfRating and Credentials elements describe information about the given business service. They are not related however. The Rating element inside the ListOfRating must be issued by a third-party rating organization. The service provider cannot issue a Rating for itself, but can claim what kind of credentials it owns or holds in the Credential elements. The Rating element and Credential element cannot be mixed. A bRating document/message, with a root element of <rt:BRating>, can have either ListOfRating element or Credentials element, or both elements.
Syntax
<rt:BRating
xmlns:rt="..." ...>
<rt:ListOfRating ...>rt:ListOfRatingType</rt:ListOfRating>
?
<rt:Credentials ...>rt:CredentialsType</rt:Credentials> ?
...
</rt:BRating >
The following describes the attributes and elements listed in the schema outlined above:
/rt:BRating
The root element of Rating for EERP
/rt:BRating/@{any}
This is an extensibility mechanism to allow additional attributes, based on schemas, to be added to the element in the future. Unrecognized attributes MAY cause a fault or be silently ignored.
/rt:BRating/rt:ListOfRating
List of Rating, rating aspect of the service in BRating element, is to hold those Rating elements. It is an optional element and has one or many Rating elements, see Section 3 for more details.
/rt:BRating/rt:ListOfRating/@{any}
This is an extensibility mechanism to allow additional attributes, based on schemas, to be added to the ListOfRating element in the future. Unrecognized attributes MAY cause a fault or be silently ignored.
/rt:BRating/rt:Credentials
Credentials element is for credential aspect of the service in which the service provider has such as license, certification, affiliations, associations, etc. It is optional element and has one or many Credential elements, see Section 4 for more details.
/rt:BRating/rt:Credentials/@{any}
This is an extensibility mechanism to allow additional attributes, based on schemas, to be added to the Credentials element in the future. Unrecognized attributes MAY cause a fault or be silently ignored.
/rt:BRating/rt:BRatingExtension
BRatingExtension element is an optional element that keeps different (extensible) elements to be specified in the future.
/rt:BRating/rt:BRatingExtension/{any}
This is an extensibility mechanism to allow different (extensible) elements to be specified in the future. Unrecognized elements MAY cause a fault or be silently ignored. This can be one or more elements of /rt:BRaing/rt:BRatingExtension/Performance/QualityAssertionEvaluation for third-party Service Rating Entities to provide their evaluation for how well the provider fulfill the Quality Assertion(s) of this service.
The ListOfRating element contains the list of Rating issued by a Rating Provider. The Rating Provider is a party unaffiliated with either the requester or the target of the rating request, such as a third party rating organization, given a reference to a particular business service and provider, issues either a number or a classification description for rating. Each Rating element in the ListOfRating has one of the following two elements to represent the rating measurement of the given business service:
· An aggregated number, in <rt:RatingNumeric> element
· An aggregated classification description, in <rt:RatingDescription> element
There SHOULD be zero or one ListOfRating element present in the rating of service.
Syntax
<rt:ListOfRating
xmlns:rt="..." ...>
<rt:Rating Type="..." ... >rt:QualityRatingType
<rt:RatingIssuer ...>rt:IssuerType
<rt:IssuerName languageID="...">rt:IssuerNameType</rt:IssuerName> ?
<rt:IssuerUri ...>rt:RatingUriType</rt:IssuerUri>
...
</rt:RatingIssuer>
<rt:RatingDescription languageID="..." ... >
rt:RatingDescriptionType</rt:RatingDescription> ?
<rt:RatingNumeric ...>rt:RatingNumericType</rt:RatingNumeric> ?
<rt:RatingDate ...>rt:RatingDateType</rt:RatingDate> ?
<rt:RatingReferenceUri ...>rt:RatingUriType</rt:RatingReferenceUri> ?
...
</rt:Rating> +
</rt:ListOfRating>
The following describes the attributes and elements listed in the schema outlined above:
/rt:BRating/rt:ListOfRating
List of ratings for a service that has one or more Rating elements.
/rt:BRating/rt:ListOfRating/rt:Rating
The Rating element represents a rating measurement of the given business service. The rating measurement is issued by a third party rating organization. This is a required element for the ListOfRating element.
/rt:BRating/rt:ListOfRating/rt:Rating/@Type
Type is an optional attribute of Simple Type to identify what kind of Rating element it is.
/rt:BRating/rt:ListOfRating/rt:Rating/@{any}
This is an extensibility mechanism to allow additional attributes, based on schemas, to be added to the ListOfRating element in the future. Unrecognized attributes MAY cause a fault or be silently ignored.
/rt:BRating/rt:ListOfRating/rt:Rating/rt:RatingIssuer
Issuing organization for this rating includes the issuer name and the URI in the Element. This element is to represent the rating issuer organization. It is a required element for Rating.
/rt:BRating/rt:ListOfRating/rt:Rating/rt:RatingIssuer/rt:IssuerName
IssuerName element, Name for the issuing organization for this rating, is an optional element for RatingIssuer.
/rt:BRating/rt:ListOfRating/rt:Rating/rt:RatingIssuer/rt:IssuerName/@languageID
Language ID is a required attribute in the IssuerName element, using xsd:language type. The value can be those defined in urn:un:unece:uncefact:codelist:specification:5639:1988.
/rt:BRating/rt:ListOfRating/rt:Rating/rt:RatingIssuer/rt:IssuerUri
It is the URI that represent the issuer organization. It is a required element for RatingIssuer.
/rt:BRating/rt:ListOfRating/rt:Rating/rt:RatingIssuer/rt:IssuerUri/@{any}
This is an extensibility mechanism to allow additional attributes, based on schemas, to be added to the IssuerUri element in the future. Unrecognized attributes MAY cause a fault or be silently ignored.
/rt:BRating/rt:ListOfRating/rt:Rating/rt:RatingDescription
Rating description for the rating where the rating can be represented in String format, such as Good, Fair, Average, etc. It is an optional element for Rating.
/rt:BRating/rt:ListOfRating/rt:Rating/rt:RatingDescription/@languageID
Language ID is a required attribute in the RatingDescription element, using xsd:language type. The value can be found on defined in urn:un:unece:uncefact:codelist:specification:5639:1988.
/rt:BRating/rt:ListOfRating/rt:Rating/rt:RatingDescription/@{any}
This is an extensibility mechanism to allow additional attributes, based on schemas, to be added to the RatingDescription element in the future. Unrecognized attributes MAY cause a fault or be silently ignored.
/rt:BRating/rt:ListOfRating/rt:Rating/rt:RatingNumeric
RatingNumeric element, Numeric value for the rating, is an optional element for Rating.
/rt:BRating/rt:ListOfRating/rt:Rating/rt:RatingNumeric/@{any}
This is an extensibility mechanism to allow additional attributes, based on schemas, to be added to the RatingNumeric element in the future. Unrecognized attributes MAY cause a fault or be silently ignored.
/rt:BRating/rt:ListOfRating/rt:Rating/rt:RatingDate
RatingDate is the date when this Rating is obtained. It is an optional element for Rating.
/rt:BRating/rt:ListOfRating/rt:Rating/rt:RatingDate/@Expired
Expired is an optional attribute to indicate this Rating is expired or not. The value of this Expired attribute is set to true means this Rating has been expired as of the RatingDate.
/rt:BRating/rt:ListOfRating/rt:Rating/rt:RatingDate/@{any}
This is an extensibility mechanism to allow additional attributes, based on schemas, to be added to the RatingDate element in the future. Unrecognized attributes MAY cause a fault or be silently ignored.
/rt:BRating/rt:ListOfRating/rt:Rating/rt:RatingReferenceUri
RatingReferenceUri, Web page URL or other URI for this rating to reference to, is an optional element for the Rating element.
/rt:BRating/rt:ListOfRating/rt:Rating/rt:RatingReferenceUri/@{any}
This is an extensibility mechanism to allow additional attributes, based on schemas, to be added to the Rating element in the future. Unrecognized attributes MAY cause a fault or be silently ignored.
Examples
The following non-normative example illustrates the use of List of Rating element. It describes a Rating element that is issued by Better Business Bureau:
(001) <?xml version="1.0" encoding="utf-8"?>
(002) <ListOfRating xmlns="..." ...>
(003) <Rating Type="BBB">
(004) <RatingIssuer>
(005) <IssuerName languageID="EN">Better Business Bureau, Inc. </IssuerName>
(006) <IssuerUri>http://www.bbb.org/business-reviews/ratings/ </IssuerUri>
(007) </RatingIssuer>
(008) <RatingDescription languageID="EN">A+</RatingDescription>
(009) <RatingDate>2009-03-08</RatingDate>
(010) <RatingReferenceUri>http://goldengate.bbb.org/WWWRoot/Report.aspx?site=99&bbb=1116&firm=34825#bbbrating</RatingReferenceUri>
(011) </Rating>
(012) </ListOfRating>
The following non-normative example illustrates the use of List of Rating element. It describes a Rating element that is issued by 51Honest.org in China:
(001) <?xml version="1.0" encoding="UTF-8"?>
(002) <BRating xmlns="..." ...>
(003) <ListOfRating>
(004) <Rating Type="51honest">
(005) <RatingIssuer>
(006) <IssuerName languageID="zh-CN">农博网</IssuerName>
(007) <IssuerUri >www.51honet.org</IssuerUri>
(008) </RatingIssuer>
(009) <RatingDescription languageID="zh-CN">信星计划</RatingDescription>
(010) <RatingNumeric>175</RatingNumeric>
(011) <RatingDate>2009-03-06</RatingDate>
(012) <RatingReferenceUri >http://www.51honest.org/index.jsp?url=detail.credit%3faction=hywzMemberInfo%26credcode=300001000036803
(013) </RatingReferenceUri>
(014) </Rating>
(015) </ListOfRating>
(016) </BRating>
The Rating Credentials element for EERP-Rating, describes the credentials held by the service provider with respect to a specific service.
Credentials, such as licenses, permissions, certifications, awards, associations, and affiliations, are issued with respect to a service provider and its services by organizations that regulate the service. They are different from the credentials for authentication in the security term. Credentials demonstrate the credibility of a given service offered by a service provider.
Unlike the Rating element inside the ListOfRating, each credential element in the Credentials element is an independent, non-aggregated indicator for the rating measurement of the given business service.
There MAY be zero or one Credentials element present in the rating of service.
Syntax
<rt:Credentials
xmlns:bqos="..." ...>
<rt:Credential>rt:CredentialType
<rt:CredentialIssuer ...>rt:IssuerType
<rt:IssuerName languageID="..." >rt:IssuerNameType</rt:IssuerName> ?
<rt:IssuerUri ...>rt:RatingUriType</rt:IssuerUri>
...
</rt:CredentialIssuer>
<rt:CredentialClass languageID="..." ...>
rt:CredentialClassType</rt:CredentialClass> ?
<rt:License languageID="..." ...>rt:LisenseType</rt:License> ?
<rt:CredentialDate ...>rt:CredentialDateType
<rt:DateIssued ...>rt:DateIssuedType</rt:DateIssued> ?
<rt:ExpirationDate ...>rt:ExpirationDateType</rt:ExpirationDate> ?
</rt:CredentialDate> ?
<rt:CredentialReferenceUri ...>
rt:RatingUriType</rt:CredentialReferenceUri> ?
...
</rt:Credential> +
</rt:Credentials>
The following describes the attributes and elements listed in the schema outlined above:
/rt:BRating/rt:Credentials
Credential aspect of the service which the service provider has, including certification, affiliations and associations. It has a list of credential for Credentials.
/rt:BRating/rt:Credentials/rt:Credential
The Credential element is for each credential, certification, affiliation or association that the service provider has for the service. This is a required element for the Credentials element.
/rt:BRating/rt:Credentials/rt:Credential/@Type
Type of the credential, an optional attribute in the Credential element, using enumeration type, and the value SHOULD be one of the following:
Affiliation, Association, Award, Certification, License, Membership, Permission, Others
/rt:BRating/rt:Credentials/rt:Credential/@{any}
This is an extensibility mechanism to allow additional attributes, based on schemas, to be added to the Credential element in the future. Unrecognized attributes MAY cause a fault or be silently ignored.
/rt:BRating/rt:Credentials/rt:Credential/rt:CredentialIssuer
CredentialIssuer element is for issuing organization for this credential, such as the issuer of certification, association, affiliation or Credential. For example, the Issuer can be AAA, BBB, or State of California, etc. This element is a required element for Credential, which includes the issuer name and the URI that represent this rating issuer organization.
/rt:BRating/rt:Credentials/rt:Credential/rt:CredentialIssuer/rt:IssuerName
IssuerName element, Issuer’s name for the issuing organization for this rating or credential, is an optional element for CredentialIssuer.
/rt:BRating/rt:Credentials/rt:Credential/rt:CredentialIssuer/rt:IssuerName/@languageID
Language ID is a required attribute in the IssuerName element, using xsd:language type. The value can be those defined in urn:un:unece:uncefact:codelist:specification:5639:1988.
/rt:BRating/rt:Credentials/rt:Credential/rt:CredentialIssuer/rt:IssuerUri
It is the URI that represent the issuer organization. It is a required element for CredentialIssuer.
/rt:BRating/rt:Credentials/rt:Credential/rt:CredentialIssuer/rt:IssuerUri/@{any}
This is an extensibility mechanism to allow additional attributes, based on schemas, to be added to the IssuerUri element in the future. Unrecognized attributes MAY cause a fault or be silently ignored.
/rt:BRating/rt:Credentials/rt:Credential/rt:CredentialIssuer/{any}
This is an extensibility mechanism to allow different (extensible) property or attribute elements to be specified in the future. Unrecognized elements MAY cause a fault or be silently ignored.
/rt:BRating/rt:Credentials/rt:Credential/rt:CredentialClass
CredentialClass element is the classification of the credential such as five-stars, or golden member. It is an optional element for the Credential. It is an optional element for the Credential.
/rt:BRating/rt:Credentials/rt:Credential/rt:CredentialClass/@languageID
Language ID is a required attribute in the CredentialClass element, using xsd:language type. The value can be those defined in urn:un:unece:uncefact:codelist:specification:5639:1988.
/rt:BRating/rt:Credentials/rt:Credential/rt:CredentialClass/@{any}
This is an extensibility mechanism to allow additional attributes, based on schemas, to be added to the CredentialClass element in the future. Unrecognized attributes MAY cause a fault or be silently ignored.
/rt:BRating/rt:Credentials/rt:Credential/rt:License
License element, the license number or membership number of the credential, is an optional element for the Credential element.
/rt:BRating/rt:Credentials/rt:Credential/rt:License/@languageID
Language ID is a required attribute in the License element, using xsd:language type. The value can be those defined in urn:un:unece:uncefact:codelist:specification:5639:1988.
/rt:BRating/rt:Credentials/rt:Credential/rt:License/@{any}
This is an extensibility mechanism to allow additional attributes, based on schemas, to be added to the License element in the future. Unrecognized attributes MAY cause a fault or be silently ignored.
/rt:BRating/rt:Credentials/rt:Credential/rt:CredentialDate
CredentialDate element is the date on this credential, including date when this credential, license or certificate is issued and the expiration date for this license or membership. It is an optional element for the Credential element.
/rt:BRating/rt:Credentials/rt:Credential/rt:CredentialDate/@{any}
This is an extensibility mechanism to allow additional attributes, based on schemas, to be added to the CredentialDate element in the future. Unrecognized attributes MAY cause a fault or be silently ignored.
/rt:BRating/rt:Credentials/rt:Credential/rt:CredentialDate/rt:DateIssued
DateIssued element is the date when this credential, license or certificate is issued. It is an optional element for the CredentialDate element.
/rt:BRating/rt:Credentials/rt:Credential/rt:CredentialDate/rt:DateIssued/@{any}
This is an extensibility mechanism to allow additional attributes, based on schemas, to be added to the DateIssued element in the future. Unrecognized attributes MAY cause a fault or be silently ignored.
/rt:BRating/rt:Credentials/rt:Credential/rt:CredentialDate/rt:ExpirationDate
ExpirationDate element, Expiration date for this license or membership, is an optional element for the CredentialDate element.
/rt:BRating/rt:Credentials/rt:Credential/rt:CredentialDate/rt:ExpirationDate/@{any}
This is an extensibility mechanism to allow additional attributes, based on schemas, to be added to the ExpirationDate element in the future. Unrecognized attributes MAY cause a fault or be silently ignored.
/rt:BRating/rt:Credentials/rt:Credential/rt:CredentialReferenceUri
CredentialReferenceUri element, Web page URL or other URI for this credential reference, is an optional element for Credential.
/rt:BRating/rt:Credentials/rt:Credential/rt:CredentialReferenceUri/@{any}
This is an extensibility mechanism to allow additional attributes, based on schemas, to be added to the CredentialReferenceUri element in the future. Unrecognized attributes MAY cause a fault or be silently ignored.
/rt:BRating/rt:Credentials/rt:Credential/{any}
This is an extensibility mechanism to allow different (extensible) property or attribute elements to be specified in the future. Unrecognized elements MAY cause a fault or be silently ignored.
Examples
The following non-normative example illustrates the use of rating Credentials element. It describes the credential of professional license issued by California Board For Professional Engineers And Land Surveyors:
(001) <?xml version="1.0" encoding="utf-8"?>
(002) <Credentials xmlns="..." ...>
(003) <Credential Type="License">
(004) <CredentialIssuer>
(005) <IssuerName languageID="EN">California Board For Professional Engineers And Land Surveyors </IssuerName>
(006) <IssuerUri>http://www.pels.ca.gov/</IssuerUri>
(007) </CredentialIssuer>
(008) <CredentialClass languageID="EN">CIVIL ENGINEER</CredentialClass>
(009) <License languageID="EN">42456</License>
(010) <CredentialDate>
(011) <ExpirationDate>2010-03-31</ExpirationDate>
(012) </CredentialDate>
(013) <CredentialReferenceUri>http://www2.dca.ca.gov/pls/wllpub/WLLQRYNA$LCEV2.QueryView?P_LICENSE_NUMBER=42456&P_LTE_ID=741</CredentialReferenceUri>
(014) </Credential>
(015) </Credentials>
The following non-normative example illustrates the use of rating Credentials element. It describes the credential of member of ASCE:
(001) <?xml version="1.0" encoding="utf-8"?>
(002) <Credentials xmlns="..." ...>
(003) <Credential Type="Membership">
(004) <CredentialIssuer>
(005) <IssuerName languageID="EN">American Society of Civil Engineers </IssuerName>
(006) <IssuerUri>http://www.asce.org/</IssuerUri>
(007) </CredentialIssuer>
(008) <CredentialClass languageID="EN">Member</CredentialClass>
(009) <CredentialDate>
(010) <DateIssued>1987-08-13</DateIssued>
(011) <ExpirationDate>2010-12-31</ExpirationDate>
(012) </CredentialDate>
(013) </Credential>
(014) </Credentials>
The following non-normative example illustrates the use of rating Credentials element. It describes the credential of Association type issued by Better Business Bureau, Inc.:
(001) <?xml version="1.0" encoding="utf-8"?>
(002) <Credentials xmlns="..." ...>
(003) <Credential Type="Association">
(004) <CredentialIssuer>
(005) <IssuerName languageID="EN">Better Business Bureau, Inc. </IssuerName>
(006) <IssuerUri>http://goldengate.bbb.org/</IssuerUri>
(007) </CredentialIssuer>
(008) <CredentialClass languageID="EN">3</CredentialClass>
(009) <CredentialReferenceUri>http://www.res99.com/hotel/10021453-10200802O.html?ses=1e65c27bad81e82b07a39070fed04d87</CredentialReferenceUri>
(010) </Credential>
(011) </Credentials>
The examples in this section are non-normative.
The following example illustrates a Business Rating result of a civil engineering service. The service provider has the following rating and credentials for a service:
The service is classified as A+ by BBB (Better Business Bureau, Inc.), as of May 8th, 2009.
The service provider holds a civil engineer’s professional license as one of credentials, which is issued by California Board for Professional Engineers and Land Surveyors. This license expiration date is December 31st, 2010.
In additional, the service provider is a member of ASCE (American Society of Civil Engineers since August 13th, 1987. This membership expiration date is December 31st, 2010.
The following example illustrates the whole Rating document for above ratings:
(1) <?xml version="1.0" encoding="UTF-8"?>
(2) <BRating xmlns="..." ... >
(3) <ListOfRating>
(4) <Rating Type="BBB">
(5) <RatingIssuer>
(6) <IssuerName languageID="EN">Better Business Bureau, Inc. </IssuerName>
(7) <IssuerUri>http://www.bbb.org/business-reviews/ratings/ </IssuerUri>
(8) </RatingIssuer>
(9) <RatingDescription languageID="EN">A+</RatingDescription>
(10) <RatingDate>2009-05-08</RatingDate>
(11) <RatingReferenceUri>
(12) http://goldengate.bbb.org/WWWRoot/Report.aspx?site=99&bbb=1116&firm=34825#bbbrating</RatingReferenceUri>
(13) </Rating>
(14) </ListOfRating>
(15) <Credentials>
(16) <Credential Type="License">
(17) <CredentialIssuer>
(18) <IssuerName languageID="EN">
(19) California Board For Professional Engineers And Land Surveyors
(20) </IssuerName>
(21) <IssuerUri>http://www.pels.ca.gov/</IssuerUri>
(22) </CredentialIssuer>
(23) <CredentialClass languageID="EN">CIVIL ENGINEER</CredentialClass>
(24) <License languageID="EN">42456</License>
(25) <CredentialDate>
(26) <ExpirationDate>2010-12-31</ExpirationDate>
(27) </CredentialDate>
(28) <CredentialReferenceUri>
(29) http://www2.dca.ca.gov/pls/wllpub/WLLQRYNA$LCEV2.QueryView?P_LICENSE_NUMBER=42456&P_LTE_ID=741</CredentialReferenceUri>
(30) </Credential>
(31) <Credential Type="Membership">
(32) <CredentialIssuer>
(33) <IssuerName languageID="EN">
(34) American Society of Civil Engineers</IssuerName>
(35) <IssuerUri>http://www.asce.org/</IssuerUri>
(36) </CredentialIssuer>
(37) <CredentialClass languageID="EN">Member</CredentialClass>
(38) <CredentialDate>
(39) <DateIssued>1987-08-13</DateIssued>
(40) <ExpirationDate>2010-12-31</ExpirationDate>
(41) </CredentialDate>
(42) </Credential>
(43) </Credentials>
(44) </BRating>
This Rating example illustrates the ratings and credentials for gas-meters produced by a fictitious Hangzhou Innover Technology Co. Ltd.
The Rating message has the following contents:
1) Credit rating on this provider is 980.1, rated by 51Honest.org (http://www.51Honest.org ), a third-party organization in China
2) License on gas-meter production is issued in December, 1997, by a department in government that is Zhejiang Bureau of Quality and Technical Supervision in the China (http://www.zjbts.gov.cn/ ).
3) Certificate on gas-meter product is certificated as the first Dual-Explosion-Proof Certificate in November 1997, Certificate is issued by a third-party organization, National Supervision and Inspection Center for Explosion Protection and Safety of Instrumentation (NEPSI) in Shanghai, China (http://www.sipai.com/sitiias/nepsi.asp )
(1) <?xml version="1.0" encoding="UTF-8"?>
(2) <BRating xmlns="...">
(3) <ListOfRating>
(4) <Rating Type="Credit">
(5) <RatingIssuer>
(6) <IssuerName languageID="zh-CN">信星计划51Honest.org</IssuerName>
(7) <IssuerUri>http://www.51Honest.org</IssuerUri>
(8) </RatingIssuer>
(9) <RatingNumeric>980.1</RatingNumeric>
(10) <RatingDate>2009-04-31</RatingDate>
(11) <RatingReferenceUri/>
(12) </Rating>
(13) </ListOfRating>
(14) <Credentials>
(15) <Credential Type="License">
(16) <CredentialIssuer>
(17) <IssuerName languageID="zh-CN">浙江省质量技术监督局</IssuerName>
(18) <IssuerUri>http://www.zjbts.gov.cn/</IssuerUri>
(19) </CredentialIssuer>
(20) <CredentialClass languageID="zh-CN">中华人民共和国计量器具生产制造许可证</CredentialClass>
(21) <License languageID="en-us">ZJJHJDJ-JL1997120001</License>
(22) <CredentialDate>
(23) <DateIssued>1997-12-01</DateIssued>
(24) </CredentialDate>
(25) </Credential>
(26) <Credential Type="Certification">
(27) <CredentialIssuer>
(28) <IssuerName languageID="en">National Supervision and Inspection Center for Explosion Protection and Safety of Instrumentation in Shanghai</IssuerName>
(29) <IssuerUri>http://www.sipai.com/sitiias/nepsi.asp</IssuerUri>
(30) </CredentialIssuer>
(31) <CredentialClass languageID="en">The first Dual-Explosion-Proof Certificate</CredentialClass>
(32) <License languageID="en-us">NEPSI-FB1997110001</License>
(33) <CredentialDate>
(34) <DateIssued>1997-11-01</DateIssued>
(35) </CredentialDate>
(36) </Credential>
(37) </Credentials>
(38) </BRating>
An implementation conforms to this specification if it satisfies all of the MUST or REQUIRED level requirements defined within this specification. A SOAP Node MUST NOT use the XML namespace identifier for this specification (listed in Section 1.1) within SOAP Envelopes unless it is compliant with this specification.
This specification references a number of other specifications (listed in Section 1.4.2). In order to comply with this specification, an implementation MUST implement the portions of referenced specifications necessary to comply with the required provisions of this specification. Additionally, the implementation of the portions of the referenced specifications that are specifically cited in this specification MUST comply with the rules for those portions as established in the referenced specification.
Normative text within this specification takes precedence over normative outlines (as described in section 1.4.1), which in turn take precedence over the XML Schema [XML Schema Part 1, Part 2] and WSDL [WSDL 1.1] descriptions. That is, the normative text in this specification further constrains the schemas and/or WSDL that are part of this specification; and this specification contains further constraints on the elements defined in referenced schemas.
The minimum set of information exchange for Business Rating that would allow conforming applications to exchange information and satisfy the conformance should have either /rt:BRating/rt:ListOfRating/rt:Rating/rt:RatingIssuer/rt:IssuerUri element or /rt:BRating/rt:Credentials/rt:Credential/rt:CredentialIssuer/rt:IssuerUri element, like this:
(001) <?xml version="1.0" encoding="utf-8"?>
(002) <BRating xmlns="http://docs.oasis-open.org/ns/soa-eerp/rt/200903">
(003) <ListOfRating>
(004) <Rating>
(005) <RatingIssuer>
(006) <IssuerUri>http://www.sample-rating-issuer.org</IssuerUri>
(007) </RatingIssuer>
(008) . . .
(009) </Rating>
(010) </ListOfRating>
(011) </BRating>
Or like this:
(001) <?xml version="1.0" encoding="utf-8"?>
(002) <BRating xmlns="http://docs.oasis-open.org/ns/soa-eerp/rt/200903">
(003) <Credentials>
(004) <Credential>
(005) <CredentialIssuer>
(006) <IssuerUri>httphttp://www.sample-cred-issuer.com</IssuerUri>
(007) </CredentialIssuer>
(008) . . .
(009) </Credential>
(010) </Credentials>
(011) </BRating>
The following nearly empty artifacts do not conform to this specification:
(001) <?xml version="1.0" encoding="utf-8"?>
(002) <BRating xmlns="http://docs.oasis-open.org/ns/soa-eerp/rt/200903">
(003) <ListOfRating/>
(004) </BRating>
The following nearly empty artifacts do not conform to this specification, either:
(001) <?xml version="1.0" encoding="utf-8"?>
(002) <BRating xmlns="http://docs.oasis-open.org/ns/soa-eerp/rt/200903">
(003) <Credentials/>
(004) </BRating>
This specification defines a number of extensions; compliant services are NOT REQUIRED to implement those extensions defined in this specification. However, if a service implements an aspect of the specification, it MUST comply with the requirements specified (e.g. related "MUST" statements). If an implementation silently ignores unrecognized attributes where any attribute is allowed, or silently ignores unrecognized elements where any element is allowed, should be considered as an interoperable implementation.
The following individuals have participated in the creation of this specification and are gratefully acknowledged:
Participants:
Rex Brooks Individual
Szu Chang Changfeng Open Standards Platform Software Alliance
William Cox Individua
Andy Lee Changfeng Open Standards Platform Software Alliance
Carl Mattocks Individua
Yulin Xu Changfeng Open Standards Platform Software Alliance
Paul Yang Changfeng Open Standards Platform Software Alliance
James Zhili Zhang TIBCO Software Inc.
Hong Zhou Changfeng Open Standards Platform Software Alliance
Note: The separate machine readable schema document, listed on Section 2.2, is normative. The text included here is non-normative.
<?xml version="1.0" encoding="UTF-8"?>
<!--
Document Type: EERP-Rating CD04
Create On: 09/12/2010
-->
<!-- ===== xsd:schema Element With Namespaces Declarations ===== -->
<!-- ===== Copyright Notice ===== -->
<!--
OASIS takes no position regarding the validity or scope of any
intellectual property or other rights that might be claimed to pertain
to the implementation or use of the technology described in this
document or the extent to which any license under such rights
might or might not be available; neither does it represent that it has
made any effort to identify any such rights. Information on OASIS's
procedures with respect to rights in OASIS specifications can be
found at the OASIS website. Copies of claims of rights made
available for publication and any assurances of licenses to be made
available, or the result of an attempt made to obtain a general
license or permission for the use of such proprietary rights by
implementors or users of this specification, can be obtained from
the OASIS Executive Director.
OASIS invites any interested party to bring to its attention any
copyrights, patents or patent applications, or other proprietary
rights which may cover technology that may be required to
implement this specification. Please address the information to the
OASIS Executive Director.
Copyright (C) OASIS Open 2008-2010. All Rights Reserved.
This document and translations of it may be copied and furnished to
others, and derivative works that comment on or otherwise explain
it or assist in its implementation may be prepared, copied,
published and distributed, in whole or in part, without restriction of
any kind, provided that the above copyright notice and this
paragraph are included on all such copies and derivative works.
However, this document itself may not be modified in any way,
such as by removing the copyright notice or references to OASIS,
except as needed for the purpose of developing OASIS
specifications, in which case the procedures for copyrights defined
in the OASIS Intellectual Property Rights document must be
followed, or as required to translate it into languages other than
English.
The limited permissions granted above are perpetual and will not be
revoked by OASIS or its successors or assigns.
This document and the information contained herein is provided on
an "AS IS" basis and OASIS DISCLAIMS ALL WARRANTIES,
EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY
WARRANTY THAT THE USE OF THE INFORMATION HEREIN
WILL NOT INFRINGE ANY RIGHTS OR ANY IMPLIED
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A
PARTICULAR PURPOSE.
-->
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://docs.oasis-open.org/ns/soa-eerp/rt/200903" xmlns:eerp="http://docs.oasis-open.org/ns/soa-eerp/rt/200903" xmlns:cbc="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2" xmlns:udt="urn:un:unece:uncefact:data:specification:UnqualifiedDataTypesSchemaModule:2" xmlns:xs="http://www.w3.org/2001/XMLSchema" xmlns:rt="http://docs.oasis-open.org/ns/soa-eerp/rt/200903" targetNamespace="http://docs.oasis-open.org/ns/soa-eerp/rt/200903" elementFormDefault="qualified" attributeFormDefault="unqualified" version="1.0">
<!-- ===== Imports ===== -->
<xsd:import namespace="urn:oasis:names:specification:ubl:schema:xsd:CommonBasicComponents-2" schemaLocation="http://docs.oasis-open.org/ubl/os-UBL-2.0/xsd/common/UBL-CommonBasicComponents-2.0.xsd"/>
<xsd:import namespace="urn:un:unece:uncefact:data:specification:UnqualifiedDataTypesSchemaModule:2" schemaLocation="http://docs.oasis-open.org/ubl/os-UBL-2.0/xsd/common/UnqualifiedDataTypeSchemaModule-2.0.xsd"/>
<!-- ===== Root Element ===== -->
<xsd:element name="BRating" type="BRatingType">
<xsd:annotation>
<xsd:documentation>The BRating is the root element of Business Rating for EERP which is for business reliability and reputation of the service and its services provider. It has both ListOfRating and Credentials elements which are indicators to represent for business reliability and reputation of the service and its services provider. </xsd:documentation>
</xsd:annotation>
</xsd:element>
<!-- ===== Element Declarations ===== -->
<xsd:element name="Credential" type="CredentialType">
<xsd:annotation>
<xsd:documentation>The Credential element is for each credential, certification, affiliation or association that the service provider has for the service. </xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="CredentialClass" type="CredentialClassType">
<xsd:annotation>
<xsd:documentation>CredentialClass element is the classification of the credential such as five-stars, or golden member. </xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="CredentialDate" type="CredentialDateType">
<xsd:annotation>
<xsd:documentation>CredentialDate element is the date on this credential, including date when this credential, license or certificate is issued and the expiration date for this license or membership. </xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="CredentialIssuer" type="IssuerType">
<xsd:annotation>
<xsd:documentation>Name of affiliations or associations</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Credentials" type="CredentialsType">
<xsd:annotation>
<xsd:documentation>The Rating Credentials element for EERP-Rating, describes the credentials held by the service provider with respect to a specific service.
Credentials may be issued with respect to a service provider and service by third-party organizations, such as licenses, permissions, certifications, awards, associations, and affiliations.
</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="DateIssued" type="DateIssuedType">
<xsd:annotation>
<xsd:documentation>The date when this credential, license or certificate was issued</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ExpirationDate" type="ExpirationDateType">
<xsd:annotation>
<xsd:documentation>Expiration date for this license or membership</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="IssuerName" type="IssuerNameType">
<xsd:annotation>
<xsd:documentation>Name for the issuing organization for the rating or credential</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="IssuerUri" type="RatingUriType">
<xsd:annotation>
<xsd:documentation>the URI that represent the issuer organization. </xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="License" type="LicenseType">
<xsd:annotation>
<xsd:documentation>License number </xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="ListOfRating" type="ListOfRatingType">
<xsd:annotation>
<xsd:documentation>The ListOfRating element contains the list of Rating issued by a third party rating organization. Each Rating element in the ListOfRating has one of the two elements to represent the rating measurement of the given business service: 1) - an aggregated number, in RatingNumeric element. 2) - an aggregated classification description, in RatingDescription element </xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="Rating" type="RatingType">
<xsd:annotation>
<xsd:documentation>The Rating element represents a rating measurement of the given business service. The rating measurement is issued by a third party rating organization. </xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="RatingDescription" type="RatingDescriptionType">
<xsd:annotation>
<xsd:documentation>Rating description for the rating where the rating can be represented in String format, such as Good, Fair, Average, etc.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="RatingDate" type="RatingDateType">
<xsd:annotation>
<xsd:documentation>Date when this Rating is obtained</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="RatingIssuer" type="IssuerType">
<xsd:annotation>
<xsd:documentation>Issuing organization for this quality/rating, including the issuer name and the URI that represent this rating issuer organization </xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="RatingNumeric" type="RatingNumericType">
<xsd:annotation>
<xsd:documentation>Rating numeric number</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element name="RatingReferenceUri" type="RatingUriType">
<xsd:annotation>
<xsd:documentation>Web page URL or other URI for this rating to reference to.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<!-- Extension -->
<xsd:element name="BRaingExtension">
<xsd:complexType mixed="true">
<xsd:choice minOccurs="0" maxOccurs="unbounded">
<xsd:any processContents="skip" minOccurs="0" maxOccurs="unbounded"/>
</xsd:choice>
<xsd:attribute name="optional" type="xsd:boolean" use="optional" default="true"/>
</xsd:complexType>
</xsd:element>
<!-- ===== Type Definitions ===== -->
<xsd:complexType name="CredentialClassType">
<xsd:annotation>
<xsd:documentation>Complex type for membership classification </xsd:documentation>
</xsd:annotation>
<xsd:simpleContent>
<xsd:extension base="cbc:NameType">
<xsd:anyAttribute namespace="##any" processContents="lax"/>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
<xsd:complexType name="CredentialDateType">
<xsd:annotation>
<xsd:documentation>Complex type for the date on this credential </xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element ref="DateIssued" minOccurs="0">
<xsd:annotation>
<xsd:documentation>The date wen this credential, license or certificate is issued</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element ref="ExpirationDate" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Expiration date for this Rating, license or membership</xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
<xsd:anyAttribute namespace="##any" processContents="lax"/>
</xsd:complexType>
<xsd:complexType name="CredentialsType">
<xsd:annotation>
<xsd:documentation>Complex type for Credentials and association</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element ref="Credential" maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>The Credential element is for each credential, certification, affiliation or association that the service provider has for the service. This is a required element for the Credentials element. </xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
<xsd:anyAttribute namespace="##any" processContents="lax"/>
</xsd:complexType>
<xsd:complexType name="CredentialType">
<xsd:annotation>
<xsd:documentation>Complex type for one credential or association</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element ref="CredentialIssuer">
<xsd:annotation>
<xsd:documentation>Issuing organization for this credential, such as the name of certification, association, affiliation or credential, such as AAA, BBB, or State of California, including the issuer name and the URI that represent this rating issuer organization. </xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element ref="CredentialClass" minOccurs="0">
<xsd:annotation>
<xsd:documentation>CredentialClass element is the classification of the credential such as five-stars, or golden member. It is an optional element for the Credential.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element ref="License" minOccurs="0">
<xsd:annotation>
<xsd:documentation>License element, the license number or membership number of the credential, is an optional element for the Credential element.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element ref="CredentialDate" minOccurs="0"/>
<xsd:element name="CredentialReferenceUri" type="RatingUriType" minOccurs="0">
<xsd:annotation>
<xsd:documentation>CredentialReferenceUri element, Web page URL or other URI for this credential reference, is an optional element for Credential. </xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
</xsd:sequence>
<xsd:attribute name="Type" type="CrendtialTypeEnum" use="optional"/>
<xsd:anyAttribute namespace="##any" processContents="lax"/>
</xsd:complexType>
<xsd:complexType name="DateIssuedType">
<xsd:annotation>
<xsd:documentation>Complex type of the date when this certificate or license is issued</xsd:documentation>
</xsd:annotation>
<xsd:simpleContent>
<xsd:extension base="cbc:StartDateType">
<xsd:anyAttribute namespace="##any" processContents="lax"/>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
<xsd:complexType name="BRatingType">
<xsd:annotation>
<xsd:documentation>Complex type for the EERP-Rating</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element ref="ListOfRating" minOccurs="0">
<xsd:annotation>
<xsd:documentation>ListOfRating element is for the rating aspect of service which is provided by third party and measured in terms of rates for the service. Each Rating element in the ListOfRating element is issued by a rating organization that has either an aggregated numeric number or an aggregated classification description to represent the rating measurement of the given business service.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element ref="Credentials" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Credentials element is for the rating aspect of service which is measured in terms of credentials for the service that the service provider owns or holds. Credentials are issued by organizations for the service, such as licenses, permissions, certifications, associations, affiliations, etc. Each credential element in the Credentials element is a non-aggregated indicator for the rating measurement of the given business service, and it does not provide an aggregated value for the measurement.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element ref="BRaingExtension" minOccurs="0" maxOccurs="unbounded"/>
</xsd:sequence>
<xsd:anyAttribute namespace="##any" processContents="lax"/>
</xsd:complexType>
<xsd:complexType name="ExpirationDateType">
<xsd:annotation>
<xsd:documentation>Complex type of expiration date</xsd:documentation>
</xsd:annotation>
<xsd:simpleContent>
<xsd:extension base="cbc:ExpiryDateType">
<xsd:anyAttribute namespace="##any" processContents="lax"/>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
<xsd:complexType name="IssuerNameType">
<xsd:annotation>
<xsd:documentation>Complex type for the Rating issuer name</xsd:documentation>
</xsd:annotation>
<xsd:simpleContent>
<xsd:extension base="cbc:NameType"/>
</xsd:simpleContent>
</xsd:complexType>
<xsd:complexType name="IssuerType">
<xsd:annotation>
<xsd:documentation>Complex type for issuing organization, including the issuer name and the URI that represent this rating issuer organization. </xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element ref="IssuerName" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Name for the issuing organization for this rating or credential</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element ref="IssuerUri">
<xsd:annotation>
<xsd:documentation>The URI that represent the issuer organization. </xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
</xsd:sequence>
<xsd:anyAttribute namespace="##any" processContents="lax"/>
</xsd:complexType>
<xsd:complexType name="LicenseType">
<xsd:annotation>
<xsd:documentation>Complex type for the license number or membership number</xsd:documentation>
</xsd:annotation>
<xsd:simpleContent>
<xsd:extension base="cbc:NameType">
<xsd:anyAttribute namespace="##any" processContents="lax"/>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
<xsd:complexType name="ListOfRatingType">
<xsd:annotation>
<xsd:documentation>Complex type for ListOfRating </xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element ref="Rating" maxOccurs="unbounded">
<xsd:annotation>
<xsd:documentation>The Rating element represents a rating measurement of the given business service. The rating measurement is issued by a third party rating organization. </xsd:documentation>
</xsd:annotation>
</xsd:element>
</xsd:sequence>
<xsd:anyAttribute namespace="##any" processContents="lax"/>
</xsd:complexType>
<xsd:complexType name="RatingDescriptionType">
<xsd:annotation>
<xsd:documentation>Complex type for the description of the Rating</xsd:documentation>
</xsd:annotation>
<xsd:simpleContent>
<xsd:extension base="cbc:NameType">
<xsd:anyAttribute namespace="##any" processContents="lax"/>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
<xsd:complexType name="RatingDateType">
<xsd:annotation>
<xsd:documentation>Complex type of the date when this Rating is obtained</xsd:documentation>
</xsd:annotation>
<xsd:simpleContent>
<xsd:extension base="cbc:ExpiryDateType">
<xsd:attribute name="Expired" type="xsd:boolean" use="optional" default="false"/>
<xsd:anyAttribute namespace="##any" processContents="lax"/>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
<xsd:complexType name="RatingNumericType">
<xsd:annotation>
<xsd:documentation>Complex type of Rating's value number</xsd:documentation>
</xsd:annotation>
<xsd:simpleContent>
<xsd:extension base="udt:NumericType">
<xsd:anyAttribute namespace="##any" processContents="lax"/>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
<xsd:complexType name="RatingType">
<xsd:annotation>
<xsd:documentation>Complex type for Rating for EERP Rating</xsd:documentation>
</xsd:annotation>
<xsd:sequence>
<xsd:element ref="RatingIssuer">
<xsd:annotation>
<xsd:documentation>Issuing organization for this rating, including the issuer name and the URI that represent this rating issuer organization. </xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element ref="RatingDescription" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Rating description for the rating where the rating can be represented in String format, such as Good, Fair, Average, etc. It is an optional element for Rating.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element ref="RatingNumeric" minOccurs="0">
<xsd:annotation>
<xsd:documentation>RatingNumeric element, Numeric value for the rating, is an optional element for Rating.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element ref="RatingDate" minOccurs="0">
<xsd:annotation>
<xsd:documentation>Date when this Rating is obtained. It is an optional element for Rating.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:element ref="RatingReferenceUri" minOccurs="0">
<xsd:annotation>
<xsd:documentation>RatingReferenceUri, Web page URL or other URI for this rating to reference to, is an optional element for the Rating element.</xsd:documentation>
</xsd:annotation>
</xsd:element>
<xsd:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
</xsd:sequence>
<xsd:attribute name="Type" type="xs:anySimpleType" use="optional"/>
<xsd:anyAttribute namespace="##any" processContents="lax"/>
</xsd:complexType>
<xsd:complexType name="RatingUriType">
<xsd:annotation>
<xsd:documentation>Complex type for the rating reference URI or Web page URL</xsd:documentation>
</xsd:annotation>
<xsd:simpleContent>
<xsd:extension base="xsd:anyURI">
<xsd:anyAttribute namespace="##any" processContents="lax"/>
</xsd:extension>
</xsd:simpleContent>
</xsd:complexType>
<xsd:simpleType name="CrendtialTypeEnum">
<xsd:annotation>
<xsd:documentation>Crendtial Type enumeration</xsd:documentation>
</xsd:annotation>
<xsd:restriction base="xsd:string">
<xsd:enumeration value="Affiliation"/>
<xsd:enumeration value="Association"/>
<xsd:enumeration value="Award"/>
<xsd:enumeration value="Certification"/>
<xsd:enumeration value="License"/>
<xsd:enumeration value="Membership"/>
<xsd:enumeration value="Permission"/>
<xsd:enumeration value="Others"/>
</xsd:restriction>
</xsd:simpleType>
</xsd:schema>
None
Revision |
Date |
Editor |
Changes Made |
0.9 |
03/17/2009 |
Szu Chang |
Initial draft |
WD01 |
04/23/2009 |
Szu Chang |
Renamed draft 0.9 to working draft 01 (WD01) |
WD02 |
05/09/2009 |
Szu Chang |
Fixed Issue #I007, I008 and I009, and get ready for Committee Draft CD01 |
WD03 |
05/17/2009 |
Szu Chang |
Added conformance section |
WD04 |
06/08/2009 |
Szu Chang |
Fixed Issue #I018 |
WD05 |
06/12/2009 |
Szu Chang |
Fixed Issue #I018 that changed BusinessRating to BRating |
WD06 |
06/24/2009 |
Szu Chang |
Fixed Issue #I027, I030, I034, I037, I040, I046, and I057. |
WD07 |
07/03/2009 |
Szu Chang |
Fixed Issue #I027, I034, I050, and I054. |
CD02 |
07/11/2009 |
Szu Chang |
Changed WD07 to CD02 after approved by TC |
CD03 |
01/06/2010 |
Szu Chang |
Changed NS and fixed URIs from CD02 to CD03 |
WD08 |
05/10/2010 |
Szu Chang |
Changed after the public review comments |
WD09 |
06/23/2010 |
Szu Chang |
Changed after the first round of review PR comments |
CD04 |
09/12/2010 |
Szu Chang |
TC approved, changed from WS09 to CD04 |