C Part 1 Change Log (Non-Normative)

Team-Fly    

 
XML, Web Services, and the Data Revolution
By Frank  P.  Coyle
Table of Contents
Appendix  B.   SOAP Version 1.2 Part 1: Messaging Framework


SOAP Specification Changes

Table C.1.
Date Author Description
20011213 MJH Updated namespace URIs, fixed spelling error.
20011211 MJH Added section headings for faultcode, faultstring, faultactor and detail elements.
20011211 MJH Fixed a number of spelling errors and grammatical problems throughout the document. Applied some limited rewording to improve readability.
20011211 MJH Removed duplicate description of "must happen" extension from section 2.
20011206 MJH Removed more mentions of body blocks.
20011206 MJH Limited rewording and removal of duplication from section 2. In particular, removed namespace definition for mU and actor (this is in section 4) and massaged text in processing model to remove duplication and improve readability.
20011206 MJH Incorporated Chris Ferris suggested changes to glossary and section 2.
20011206 MJH General editorial work on new sections. Added references and other tagging as required.
20011206 MJH Incorporated agreed changes to URIs in SOAP section (remove duplication with XML base and cite XML base more strongly).
20011206 MJH Incorporated issue 155 resolution.
20011205 JJM Elevated the header removal step to a processing model step.
20011204 MJH Added bibref to Use of URIs section and tidied up the language in that section.
20011204 MJH Modified soapEncoding descriptive text ”Issues 159 and 166.
20011204 JJM Added text to section 2.2, second paragraph, to indicate none blocks may carry data for processing of other blocks.
20011204 JJM Section 2.2, four paragraph, added "anonymous actor" to the list.
20011204 JJM Section 2.3, remove text for SOAP body blocks.
20011204 JJM Section 2.3, replace "has assumed the role of the anonymous actor" by "is the ultimate receiver".
20011204 JJM Section 2.4, incorporated 2 paragraph previously in section 2.
20011204 JJM Added section 2.5 (text from Noah).
20011204 JJM Added an extra step to the processing model (now section 2.6).
20011204 JJM Simplified step 3, and moved the previous text further below in the same section (2.6).
20011204 JJM Section 2.6, incorporated text from section 4.
20011204 JJM Section 4.2.2, removed explanation of next and none roles.
20011204 JJM Section 4.2.2, added text to indicate the meaning of an empty actor attribute.
20011204 JJM Trimmed section 4.2.3, as the text is now in section 2.
20011204 JJM Removed section 4.3.1, since body processing is now in section 2.6.
20011204 JJM Added ednote to flag the definition for SOAP block is out of date.
20011204 JJM Reformated section 5 (Binding Framework).
20011204 JJM Reformated section 6 (Use of URIs in SOAP). Removed non ASCII characters .
20011204 JJM Added missing "att" and " attval " around elements and attributes in section 6.
20011204 JJM Fixed a number of lax references in section 6.
20011201 HFN Added SOAP Protocol Binding Framework.
20011201 HFN Added section on URIs and XML Base.
2001129 MJG Incorporated resolution text for Issue 146 into Section 2.3.
2001129 MJG Changed "Client" and "Server" fault codes to be "Sender" and "Receiver" respectively as resolution of Issue 143.
2001129 MJG Removed dot notation from spec. Added "DTDNotSupported" fault code to fault code table.
20011122 MJH Incorporated resolution to issue 172 (criteria for generating version mismatch fault into 4.1.2 Envelope Versioning Model . Removed duplication of versioning error text and associated ednote from 3 Relation to XML .
20011029 MJH Changed "default actor" to "anonymous actor".
20011029 MJH Amended relation to XML section (Issue 135).
20011029 MJH Amended section 2.5 (Issue 157).
20011029 MJH Removed citation of ABNF ”not used in part 1.
20011029 MJH Amended section 1.3 (Issue 150).
20011029 MJH Amended section 1.1 (Issue 149).
20011029 MJH Amended introductory text (Issue 148).
20011029 MJH Amended introductory text (Issue 147).
20011029 MJH Amended abstract (Issue 147).
20011026 MJG Amended text in Section 2.5 bullet 2 (Issue 158).
20011026 MJG Amended text in Section 2.4 para 2 (Issue 156).
20011026 MJG Amended text in Section 2.1 para 2 (Issue 152).
20011026 MJG Amended prose related to DTDs and PIs (Issue 4).
20011026 MJG Added text to state that SOAP is no longer an acronym (Issue 125).
20011026 MJG Amended description of Upgrade extension in Appendix A to be Infoset based.
20011026 MJG Added an example of returning multiple versions in the VersionMismatch header to Appendix A (Issue 119).
20011026 MJG Added definition of SOAP Application to glossary (Issue 139).
20011026 MJG Added xml declaration to all XML examples with a root of env:Envelope or xs:schema (Issue 10).
20011025 MJG Changed MAY to MUST regarding namespace qualification of SOAP body blocks (Issue 141).
20011011 MJG Added para to section 2.2 on criteria (or lack thereof) for determining whether a SOAP node acts as a particular actor.
20010926 MJG Updated member list.
20010926 MJG Removed extra double quotes around certain URLs.
20010921 MJG Changed targetNamespace attribute of faults schema to http://www.w3.org/2001/09/soap-faults.
20010921 MJG Changed targetNamespace attribute of upgrade schema to http://www.w3.org/2001/09/soap-upgrade.
20010921 MJG Changed targetNamespace attribute of envelope schema to http://www.w3.org/2001/09/soap-envelope.
20010921 MJG Modified content model of Envelope complex type in envelope schema to disallow content after the Body element.
20010920 JJM Included MarkN's text regarding issue 11 and 13 as amended by Stuart in the specification and expand the ednote appropriately.
20010920 JJM Change the namespace of the envelope to http://www.w3.org/2001/09/...
20010918 JJM Incorporated several editorial comments from Stuart Williams.
20010918 JJM Removed reference to trailer from the "SOAP Envelope" section.
20010914 JJM Fixed issues 124, 126, 127, 128 and 132.
20010914 JJM Used the rewrite from Mark Nottingham for section "SOAPAction attribute".
20010914 JJM Incoporated text from Mark Nottingham clarifying the role of none blocks.
20010914 JJM Reference the XML InfoSet Proposed Recommandation instead of the Candidate Recommandation.
20010911 JJM Changed XML Information Set into a normative reference. Changed XML Protocol Comments Archive, Discussion Archive and Charter into non-normative references. Removed "as illustrated above" from section 2. Added missing parantheses in sections 2.5 and 4.1.1.
20010905 MJH Wordsmithed abstract and introduction to better reflect split into parts 1 and 2. Rationalised list of references so only cited works appear. Removed encoding schema changes. Added bibref entries for cross references to Part 2, fixed links so they target the HTML instead of XML version of the doc.
20010831 JJM Added a close paragraph tag before starting a new olist or ulist.
20010831 JJM Properly declared the language for the spec, so that we can generate valid HTML.
20010830 MJG Added an element declaration for a Fault element of type Fault to the envelope schema.
20010830 JJM Removed terminology not relevant for part1.
20010830 JJM Moved some introductory examples to part2.
20010830 JJM Moved SOAP example appendix to part2.
20010830 JJM Added a paragraph to section 1 pointing to part2 for encoding, rpc and http binding.
20010829 JJM Added a placeholder for the forthcoming Transport Binding Framework section.
20010829 JJM Updated the spec's title.
20010829 JJM Replaced specref with xspecref for references to Part2 items.
20010829 JJM Added bibliography entry for SOAP 1.2 Part 2.
20010829 JJM Removed former sections 5, 6, 7 and 8.
20010829 JJM Did split the spec into two parts.
20010829 JJM Refered to the proper DTD and stylesheet.
20010829 JJM Updated the list of WG members : one person per line in the XML file, for easier updating.
20010816 MJH Replaced a mustUnderstand="1" with mustUnderstand="true". Slight rewording in mu description.
20010810 MJH Merged in RPC fault rules text from Jacek. Added new DataEncodingUnknown fault code to SOAP Fault Codes section. Added editorial notes about introduction of new fault code namespace for RPC.
20010809 MJH Merged in "mustHappen" descriptive text from Glen and Noah.
20010809 MJH Fixed language around "default" values of attributes.
20010809 MJH Removed HTTP extension framework, added editorial note to describe why.
20010808 MJH Added Infoset "specified" property text from Chris.
20010808 MJH Removed assumption 4 from version transition appendix.
20010808 MJH Added reference to SOAP 1.1 specification to references section, removed SOAP 1.1 author list from acknowledgments section.
20010807 MJH Converted specification from HTML to XML conforming to W3C XMLSpec DTD. Numerous resulting formatting changes.
20010720 MJG Applied Infoset terminology to sections 1, 2, 3 and 4.
20010629 MJG Amended description of routing and intermediaries in Section 2.1.
20010629 JJM Changed "latest version" URI to end with soap12.
20010629 JJM Remove "previous version" URI.
20010629 JJM Removed "Editor copy" in <title>.
20010629 JJM Removed "Editor copy" in the title.
20010629 JJM Added "Previous version" to either point to SOAP/1.1, or explicitly mention there was no prior draft.
20010629 JJM Pre-filed publication URIs.
20010629 JJM Incorporated David's suggested changes for the examples in section 4.1.1 to 4.4.2.
20010629 JJM Fixed some remaining typos.
20010629 MJH Fixed a couple of typos.
20010628 MJG Made various formatting, spelling and grammatical fixes.
20010628 MJG Moved soap:encodingStyle from soap:Envelope to children of soap:Header/soap:Body in examples 1, 2, 47, 48, 49 and 50.
20010628 MJG Changed text in Section 2.1 from 'it is both a SOAP sender or a SOAP receiver' to 'it is both a SOAP sender and a SOAP receiver'.
20010628 MJG Fixed caption on Example 24.
20010628 MJH Fixed a couple of capitalisation errors where the letter A appeared as a capital in the middle of a sentence .
20010628 MJH Updated figure 1, removed ednote to do so.
20010622 HFN Removed the introductory text in terminology section 1.4.3 as it talks about model stuff that is covered in section 2. It was left over from original glossary which also explained the SOAP model.
20010622 HFN Moved the definition of block to encapsulation section in terminology.
20010622 HFN Removed introductory section in 1.4.1 as this overlaps with the model description in section 2 and doesn't belong in a terminology section.
20010622 HFN Removed reference to "Web Characterization Terminology & Definitions Sheet" in terminology section as this is not an active WD.
20010622 HFN Added revised glossary.
20010622 HFN Added example 0 to section 1.3 and slightly modified text for example 1 and 2 to make it clear that HTTP is used as a protocol binding.
20010622 MJG Added http://example.com/...to list of application/context specific URIs in section 1.2.
20010622 MJG Updated examples in section 4.1.1 to be encodingStyle attributes rather than just the values of attributes.
20010622 MJG Added table.norm, td.normitem and td.normtext styles to stylesheet. Used said styles for table of fault code values in section 4.4.1.
20010622 MJG In Appendix C, changed upgrade element to Upgrade and env to envelope. Made envelope unqualified. Updated schema document to match.
20010622 MJG Moved MisunderstoodHeader from envelope schema into seperate faults schema. Removed entry in envelope schema change table in Appendix D.2 that refered to additon of said element. Modified example in section 4.4.2 to match. Added reference to schema document to section 4.4.2.
20010622 MJH Added binding as a component of SOAP in introduction. Fixed a couple of typos and updated a couple of example captions.
20010622 MJG Made BNF in section 6.1.1 into a table.
20010622 MJG Made BNFs in section 5.1 clause 8 into tables. Added associated 'bnf' style for table and td elements to stylesheet.
20010622 MJG Amended text regarding namespace prefix mappings in section 1.2.
20010622 MJG Added link to schema for the http://www.w3.org/2001/06/soap-upgrade namespace to Appendix C. Updated associated ednote.
20010622 MJG Added reference numbers for XML Schema Recommendation to text prior to schema change tables in Appendix D.2 and linked said numbers to local references in this document.
20010622 MJG Reordered entries in schema change classification table in Appendix D.2.
20010622 MJG Changed type of mustUnderstand and root attributes to standard boolean and updated schema change tables in Appendix D.2 accordingly .
20010622 JJM Manually numbered all the examples (53 in total!).
20010622 JJM Added caption text to all the examples.
20010622 JJM Replaced remaining occurrences of SOAP/1.2 with SOAP Version 1.2 (including <title>).
20010621 HFN Added ednote to section 4.2.2 and 4.2.3 that we know they have to be incorporated with section 2.
20010621 HFN Added version transition appendix C.
20010621 HFN Applied new styles to examples.
20010621 HFN Changed term "transport" to "underlying protocol.
20010621 HFN Changed example URNs to URLs of the style http://example.org/...
20010621 MJH Updated the Acknowledgements section.
20010621 JJM Added new style sheet definitions (from XML Schema) for examples, and used them for example 1 and 2.
20010621 JJM Incorporated David Fallside's comments on section Status and Intro sections.
20010620 HFN Changed the status section.
20010620 HFN Changed title to SOAP Version 1.2 and used that first time in abstract and in body.
20010620 HFN Removed question from section 2.4 as this is an issue and is to be listed in the issues list.
20010620 HFN Moved change log to appendix.
20010615 JJM Renamed default actor to anonymous actor for now (to be consistent).
20010615 JJM Fixed typos in section 2.
20010614 JJM Updated section 2 to adopt the terminology used elsewhere in the spec.
20010613 MJH Updated mustUnderstand fault text with additions from Martin Gudgin.
20010613 MJH Added schema changes appendix from Martin Gudgin.
20010613 MJH Added mustUnderstand fault text from Glen Daniels.
20010612 MJH Fixed document <title>.
20010612 MJH Moved terminology subsection from message exchange model section to introduction section.
20010612 MJH Fixed capitalisation errors by replacing "...A SOAP..." with "...a SOAP..." where appropriate.
20010612 MJH Removed trailing "/" from encoding namespace URI.
20010612 MJH Fixed links under namespace URIs to point to W3C space instead of schemas.xmlsoap.org.
20010612 MJH Removed some odd additional links with text of "/" pointing to the encoding schema following the text of the encoding namespace URI in several places.
20010611 MJH Incorporated new text for section 2.
20010611 JJM Changed remaining namespaces, in particular next.
20010609 JJM Changed the spec name from XMLP/SOAP to SOAP.
20010609 JJM Changed the version number from 1.1 to 1.2.
20010609 JJM Changed the namespaces from http://schemas.xmlsoap.org/soap/ to http://www.w3.org/2001/06/soap-.
20010609 JJM Replaced the remaining XS and XE prefixes to env and enc, respectively.
20010601 MJH Updated the examples in section 1, 6 and appendix A with text suggested by Martin Gudgin to comply with XML Schema Recommendation.
20010601 JJM Updated the examples in section 4 and 5 with text suggested by Martin Gudgin, to comply with XML Schema Recommendation.
20010531 HFN Removed appendices C and D and added links to live issues list and separate schema files.
20010531 MJH Added this change log and updated schemas in appendix C to comply with XML Schema Recommendation.

C.2 XML Schema Changes

The envelope schema has been updated to be compliant with the XML Schema Recomendation[4][5]. The table below shows the categories of change.

Class Meaning
Addition New constructs have been added to the schema
Clarification The meaning of the schema has been changed to more accurately match the specification
Deletion Constructs have been removed from the schema
Name The schema has been changed due to a datatype name change in the XML Schema specification
Namespace A namespace name has been changed
Semantic The meaning of the schema has been changed
Style Style changes have been made to the schema
Syntax The syntax of the schema has been updated due to changes in the XML Schema specification

The table below lists the changes to the envelope schema.

Class Description
Namespace Updated to use the http://www.w3.org/2001/XMLSchema namespace
Namespace Value of targetNamespace attribute changed to http://www.w3.org/2001/06/soap-envelope
Clarification Changed element and attribute wildcards in Envelope complex type to namespace="##other"
Clarification Changed element and attribute wildcards in Header complex type to namespace="##other"
Class Description
Clarification Added explicit namespace="##any" to element and attribute wildcards in Body complex type
Clarification Added explicit namespace="##any" to element and attribute wildcards in detail complex type
Clarification Added an element wildcard with namespace="##other" to the Fault complex type
Name Changed item type of encodingStyle from uri-reference to anyURI
Name Changed type of actor attribute from uri-reference to anyURI
Name Changed type of faultactor attribute from uri-reference to anyURI
Semantic Added processContents="lax" to all element and attribute wildcards
Semantic Changed type of the mustUnderstand attribute from restriction of boolean that only allowed 0 or 1 as lexical values to the standard boolean in the http://www.w3.org/2001/XMLSchema namespace. The lexical forms 0, 1, false, true are now allowed.
Style Where possible comments have been changed into annotations
Syntax Changed all occurences of maxOccurs="*" to maxOccurs="unbounded"
Syntax Added <xs:sequence> to all complex type definitions derived implicitly from the ur-type
Syntax Added <xs:sequence> to all named model group definitions

In addition several changes occured in the names of datatypes in the XML Schema specification and some datatypes were removed. The following table lists those changes.

Datatype Class Description
timeDuration Renamed New name is duration
timeInstant Renamed New name is dateTime
recurringDuration Removed The recurringDuration datatype no longer exists.
recurringInstant Removed The recurringInstant datatype no longer exists.
binary Removed The binary datatype has been replaced by the hexBinary and base64Binary datatypes.
month Renamed New name is gYearMonth
timePeriod Removed The timePeriod datatype no longer exists
year Renamed New name is gYear
century Removed The century datatype no longer exists
recurringDate Renamed New name is gMonthDay
recurringDay Renamed New name is gDay

THIS DOCUMENT IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, NON-INFRINGEMENT, OR TITLE; THAT THE CONTENTS OF THE DOCUMENT ARE SUITABLE FOR ANY PURPOSE; NOR THAT THE IMPLEMENTATION OF SUCH CONTENTS WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.

COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE DOCUMENT OR THE PERFORMANCE OR IMPLEMENTATION OF THE CONTENTS THEREOF.


Team-Fly    
Top


XML, Web Services, and the Data Revolution
XML, Web Services, and the Data Revolution
ISBN: 0201776413
EAN: 2147483647
Year: 2002
Pages: 106
Authors: Frank Coyle

flylib.com © 2008-2017.
If you may any questions please contact us: flylib@qtcs.net