<?xml version="1.0"?>
<!-- $Id: ws-addr-testsuite.xml,v 1.3 2005/09/09 19:18:05 pdowney Exp $ -->
<!DOCTYPE spec PUBLIC "-//W3C//DTD Specification V2.1//EN" "xmlspec.dtd" [
<!ENTITY prefix "ws-addr-testsuite">
<!ENTITY % entities SYSTEM "entities.dtd" >
%entities;
<!ENTITY status SYSTEM "status.xml">
<!ENTITY document.status "Editors' copy $Date: 2005/09/09 19:18:05 $">
<!ENTITY wsa-title "&wsa-testsuite.title;">
<!ENTITY prevloc "">
]>
<?xml-stylesheet type='text/xsl' href='xmlspec-addressing.xsl'?>
<spec w3c-doctype="wd" role="&document.role;">
    <header>
        <title>&wsa-testsuite.title;</title>
        <w3c-designation>&w3c-designation-wsa-testsuite;</w3c-designation>
        <w3c-doctype>&document.status;</w3c-doctype>
        <pubdate>
            <day>&draft.day;</day>
            <month>&draft.month;</month>
            <year>&draft.year;</year>
        </pubdate>
        <publoc>
            <loc href="&w3c-designation-wsa-testsuite;"
            >&w3c-designation-wsa-testsuite;</loc>
        </publoc> &altlocs; <prevlocs>
            <loc href="&prevloc;">&prevloc;</loc>
        </prevlocs>
        <latestloc>
            <loc href="&wsa-testsuite.latest;">&wsa-testsuite.latest;</loc>
        </latestloc>
        <authlist>
            <author>
                <name>Paul Downey</name>
                <affiliation>BT</affiliation>
            </author>
        </authlist>
        <abstract>
            <p>This document describes the Test Suite deliverable for the <loc
                    href="http://www.w3.org/2002/ws/addr/">Web Services Addressing Working
                Group</loc> as defined by the Working Group's <loc
                    href="http://www.w3.org/2004/09/wsa-charter.html">Charter</loc>. </p>
        </abstract> &status; <langusage>
            <language id="en-US">English</language>
        </langusage>
        <revisiondesc>
            <p>Last Modified: $Date: 2005/09/09 19:18:05 $</p>
        </revisiondesc>
    </header>
    <body>
        <div1 id="tocRange">
            <head>Introduction</head>
            <p>One of the deliverables specified in the Charter of the Web Services Addressing
                Working Group is <emph>a test suite intended to promote implementation of the
                    Candidate Recommendation, and to assess interoperability between these
                    implementations.</emph>
            </p>
            <p>The Working Group Charter also states that <emph>the Working Group is expected to
                    demonstrate four interoperable implementations during the Call for
                    Implementations step.</emph> It is anticipated that some, but not all of the
                test cases held within the test suite will be used to practically test
                implementations during an interoperability Workshop and thereby satisfy the entrance
                criteria for the Web Service Addressing specifications to enter the <loc
                    href="http://www.w3.org/Consortium/Process-20010719/tr.html#RecsPR">Proposed
                    Recommendation stage</loc>.</p>
            <p>The test suite will be maintained by the Working Group and remain available for
                regression testing beyond publication of the Web Addressing Recommendation, however
                it is not expected that the test suite will form a part of the Web Addressing
                Recommendation; the status of this document will remain as a Working Group note. </p>
            <div2 id="conformance">
                <head>Conformance Claims</head>
                <p> A Web Services Addressing implementation that passes all of the tests specified
                    in this document may claim conformance to the Web Services Addressing Test Suite
                    $Date: 2005/09/09 19:18:05 $. </p>
                <p> Conformance to the Web services Addressing Test Suite does not by itself enable
                    a party to claim conformance with the Web Services Addressing specification. Not
                    passing an individual test may be used as an indication that an implementation
                    is likely not to conform to the Web Services Addressing specification. </p>
            </div2>
            <div2 id="notation">
                <head>Notational Conventions</head>
                <p>The keywords "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD",
                    "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this document are to be
                    interpreted as described in RFC 2119 [<bibref ref="RFC2119"/>].</p>
                <p>When describing abstract data models, this specification uses the notational
                    convention used by the XML Infoset [<bibref ref="XMLInfoSet"/>]. Specifically,
                    abstract property names always appear in square brackets (e.g., [some
                    property]).</p>
                <p>When describing concrete XML schemas [<bibref ref="XMLSchemaP1"/>, <bibref
                        ref="XMLSchemaP2"/>], this specification uses the notational convention of
                    WS-Security [<bibref ref="WS-Security"/>]. Specifically, each member of an
                    element's [children] or [attributes] property is described using an XPath-like
                    notation (e.g., /x:MyHeader/x:SomeProperty/@value1). The use of {any} indicates
                    the presence of an element wildcard (&lt;xs:any/&gt;). The use of @{any}
                    indicates the presence of an attribute wildcard
                    (&lt;xs:anyAttribute/&gt;).</p>
            </div2>
        </div1>
        <div1 id="testCases">
            <head>Test Cases</head>
            <p>The Test Suite comprises of a collection of <loc href="test-cases/cases/cases.html"
                    >test cases</loc>. Each test case contains the following information:</p>
            <glist>
                <gitem>
                    <label>identifier</label>
                    <def>
                        <p>An unambiguous xml:id value to enable the test case to be referenced
                            within a specific version of the test suite.</p>
                    </def>
                </gitem>
                <gitem>
                    <label>title</label>
                    <def>
                        <p>A friendly name for the test case.</p>
                    </def>
                </gitem>
                <gitem>
                    <label>cr</label>
                    <def>
                        <p>An indication that this test forms part of the Exit Criteria for the
                            Candidate Recommendation phase for one or more Web Service Addressing
                            specifications.</p>
                    </def>
                </gitem>
                <gitem>
                    <label>assertions</label>
                    <def>
                        <p>A list of <loc href="test-cases/assertions/assertions.html"
                            >assertions</loc> document the test case exhibits. The purpose of the
                            assertions being to access the coverage of the Test Suite.</p>
                    </def>
                </gitem>
                <gitem>
                    <label>message exchange</label>
                    <def>
                        <p>The concrete <loc href="test-cases/assertions/message-exchanges.html">message
                                exchange</loc> followed by a successful execution of the test case.</p>
                    </def>
                </gitem>
                <gitem>
                    <label>scenarios</label>
                    <def>
                        <p>A list of the abstract scenarios exhibited by the test case, at most one
                            from each of the categories: <loc
                                href="test-cases/assertions/scenarios.html#MessagePassing">message
                                passing</loc>, <loc
                                href="test-cases/assertions/scenarios.html#Security">security</loc>,
                            etc.</p>
                    </def>
                </gitem>
                <gitem>
                    <label>description</label>
                    <def>
                        <p>A description of the nature and characteristics of the test case to
                            assist reviewers to understand the purpose of a test and provide those
                            executing the test with any additional information that will be helpful
                            should the test fail.</p>
                    </def>
                </gitem>
                <gitem>
                    <label>documents</label>
                    <def>
                        <p>One or more example <loc href="test-cases/documents/documents.html"> test
                            documents</loc>, including WSDL 1.1 and WSDL 2.0 documents as well as
			    SOAP 1.1 and SOAP 1.2 messages  which may be used to build canned test 
			    interactions for some test cases.</p>
                    </def>
                </gitem>
            </glist>
        </div1>
        <div1 id="contributing">
            <head>Contributing Test Materials</head>
            <p>The Test Suite consists entirely of voluntary contributions of tests from interested
                parties. We encourage all members of the community to consider contributing any
                tests they may have developed to the Test Suite.</p>
            <p> Tests may be submitted to the Suite in the form of an Email sent to<loc
                    href="mailto:public-ws-addressing-tests@w3.org"
                    >public-ws-addressing-tests@w3.org</loc> An archive is available at<loc
                    href="http://lists.w3.org/Archives/Public/public-ws-addressing-tests/"
                    >http://lists.w3.org/Archives/Public/public-ws-addressing-tests</loc> Submited
                test cases should be released to the Test Suite by completing the<loc
                    href="http://www.w3.org/2002/09/wbs/1/testgrants2-200409/">Test Case Grant II
                    Form</loc>.</p>
            <p> When contributing materials to the Test Suite, it is helpful if each individual test case
                cites the metadata such as the existing Test Assertions, Scenarios and Message
                Exchanges exhibited. The submission may also include details of any new scenarios
                which the test case exhibits. Providing examples of the messages exchanged and
                metadata such as WSDL 1.1 and WSDL 2.0 in the form of complete XML documents will
                also be of value.</p>
        </div1>
        <div1 id="references">
            <head>References</head>
            <blist>
                <bibl key="WS-Addressing-Core" id="WSADDR-CORE"
                    href="&w3c-designation-wsa-core;">
                    <titleref>&wsa-core.title;</titleref>, M. Gudgin, M. Hadley, Editors.</bibl>
                <bibl key="WS-Addressing-SOAP" id="WSADDR-SOAP"
                    href="&w3c-designation-wsa-soap;">
                    <titleref>&wsa-soap.title;</titleref>, M. Gudgin, M. Hadley, Editors.</bibl>
                <bibl key="WS-Addressing-WSDL" id="WSADDR-WSDL"
                    href="&w3c-designation-wsa-wsdl;">
                    <titleref>&wsa-wsdl.title;</titleref>, M. Gudgin, M. Hadley, Editors.</bibl>
                <bibl key="WSDL 2.0" id="WSDL20" href="http://www.w3.org/TR/2004/WD-wsdl20-20040803">
                    <titleref>Web Services Description Language 2.0</titleref>, R. Chinnici, M.
                    Gudgin, J. J. Moreau, J. Schlimmer, S. Weerawarana, Editors. World Wide Web
                    Consortium, 3 August 2004. This version of the WSDL 2.0 specification is
                    http://www.w3.org/TR/2004/WD-wsdl20-20040803. The <loc
                        href="http://www.w3.org/TR/wsdl20">latest version of WSDL 2.0</loc> is
                    available at http://www.w3.org/TR/wsdl20.</bibl>
                <bibl key="IETF RFC 2119" href="http://www.ietf.org/rfc/rfc2119.txt" id="RFC2119">
                    <titleref>Key words for use in RFCs to Indicate Requirement Levels</titleref>,
                    S. Bradner. Internet Engineering Task Force, June 1999. Available at
                    http://www.ietf.org/rfc/rfc2119.txt. </bibl>
                <bibl id="RFC3987" key="IETF RFC 3987" href="http://www.ietf.org/rfc/rfc3987.txt">
                    M. Duerst, M. Suignard, "Internationalized Resource Identifiers (IRIs)", January
                    2005.</bibl>
                <bibl id="XML10" key="XML 1.0" href="http://www.w3.org/TR/2004/REC-xml-20040204">
                    <titleref>Extensible Markup Language (XML) 1.0 (Third Edition)</titleref>, T.
                    Bray, J. Paoli, C. M. Sperberg-McQueen, and E. Maler, Editors. World Wide Web
                    Consortium, 4 February 2004. This version of the XML 1.0 Recommendation is
                    http://www.w3.org/TR/2004/REC-xml-20040204. The <loc
                        href="http://www.w3.org/TR/REC-xml">latest version of XML 1.0</loc> is
                    available at http://www.w3.org/TR/REC-xml. </bibl>
                <bibl id="XMLNS" key="XML Namespaces"
                    href="http://www.w3.org/TR/1999/REC-xml-names-19990114">
                    <titleref>Namespaces in XML</titleref>, T. Bray, D. Hollander, and A. Layman,
                    Editors. World Wide Web Consortium, 14 January 1999. This version of the XML
                    Information Set Recommendation is
                    http://www.w3.org/TR/1999/REC-xml-names-19990114. The <loc
                        href="http://www.w3.org/TR/REC-xml-names">latest version of Namespaces in
                        XML</loc> is available at http://www.w3.org/TR/REC-xml-names. </bibl>
                <bibl id="XMLInfoSet" key="XML Information Set"
                    href="http://www.w3.org/TR/2001/REC-xml-infoset-20011024">
                    <titleref>XML Information Set</titleref>, J. Cowan and R. Tobin, Editors. World
                    Wide Web Consortium, 24 October 2001. This version of the XML Information Set
                    Recommendation is http://www.w3.org/TR/2001/REC-xml-infoset-20011024. The <loc
                        href="http://www.w3.org/TR/xml-infoset">latest version of XML Information
                        Set</loc> is available at http://www.w3.org/TR/xml-infoset. </bibl>
                <bibl id="XMLSchemaP1" key="XML Schema Structures"
                    href="http://www.w3.org/TR/2004/REC-xmlschema-1-20041028/">
                    <titleref>XML Schema Part 1: Structures Second Edition</titleref>, H. Thompson,
                    D. Beech, M. Maloney, and N. Mendelsohn, Editors. World Wide Web Consortium, 28
                    October 2004. This version of the XML Schema Part 1 Recommendation is
                    http://www.w3.org/TR/2004/REC-xmlschema-1-20041028. The <loc
                        href="http://www.w3.org/TR/xmlschema-1/">latest version of XML Schema Part
                    1</loc> is available at http://www.w3.org/TR/xmlschema-1. </bibl>
                <bibl key="XML Schema Datatypes" id="XMLSchemaP2"
                    href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/">
                    <titleref>XML Schema Part 2: Datatypes Second Edition</titleref>, P. Byron and
                    A. Malhotra, Editors. World Wide Web Consortium, 28 October 2004. This version
                    of the XML Schema Part 2 Recommendation is
                    http://www.w3.org/TR/2004/REC-xmlschema-2-20041028. The <loc
                        href="http://www.w3.org/TR/xmlschema-2/">latest version of XML Schema Part
                    2</loc> is available at http://www.w3.org/TR/xmlschema-2. </bibl>
                <bibl id="SOAP12-PART1" key="SOAP 1.2 Part 1: Messaging Framework"
                    href="http://www.w3.org/TR/2003/REC-soap12-part1-20030624/">
                    <titleref>SOAP Version 1.2 Part 1: Messaging Framework</titleref>, M. Gudgin, M.
                    Hadley, N. Mendelsohn, J-J. Moreau, H. Frystyk Nielsen, Editors. World Wide Web
                    Consortium, 24 June 2003. This version of the "SOAP Version 1.2 Part 1:
                    Messaging Framework" Recommendation is
                    http://www.w3.org/TR/2003/REC-soap12-part1-20030624/. The <loc
                        href="http://www.w3.org/TR/soap12-part1/">latest version of "SOAP Version
                        1.2 Part 1: Messaging Framework"</loc> is available at
                    http://www.w3.org/TR/soap12-part1/. </bibl>
                <bibl id="WS-Security" key="WS-Security"
                    href="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-soap-message-security-1.0.pdf"
                    > OASIS, <titleref>Web Services Security: SOAP Message Security</titleref>,
                    March 2004.</bibl>
            </blist>
        </div1>
    </body>
    <back> &acknowledgements; <inform-div1 id="changelog">
            <head>Change Log</head>
        </inform-div1>
    </back>
</spec>

