<?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" href="xmlspec.xsl"?>
<!DOCTYPE spec SYSTEM "xmlspec.dtd" [
<!ENTITY Current "http://www.w3.org/TR/2004/NOTE-ws-i18n-req-20041116">
<!ENTITY DD "16">
<!ENTITY Latest "http://www.w3.org/TR/ws-i18n-req">
<!ENTITY MM "11">
<!ENTITY Previous "http://www.w3.org/TR/2003/WD-ws-i18n-req-20031217">
<!ENTITY month "November">
<!ENTITY status "W3C Working Group Note">
<!ENTITY year "2004">
]>

<!-- <!ENTITY status "Editors' copy $Date: 2004/11/15 07:34:30 $"> -->
<!-- <!ENTITY Current "http://www.w3.org/International/ws/ws-i18n-requirements-edit"> -->

<!-- <spec w3c-doctype="wd" status="int-review" role="editors-copy"> -->
<spec w3c-doctype="wgnote">
<header>
<title>Requirements for the Internationalization of Web Services</title>

<w3c-designation>ws-i18n-req-&year;&MM;&DD;</w3c-designation>

<w3c-doctype>&status;</w3c-doctype>

<pubdate><day>&DD;</day><month>&month;</month><year>&year;</year></pubdate>

<publoc>
    <loc href="&Current;/">&Current;</loc>
  </publoc>

  <altlocs>
    <loc role="available-format" href="Overview.xml">XML</loc>
<!--    
    <loc role="available-format" href="Overview.html">XHTML</loc>
 -->
  </altlocs>
  <prevlocs>
     <loc href="&Previous;/">&Previous;</loc>
  </prevlocs>
  <latestloc>
    <loc href="&Latest;/">&Latest;</loc>
  </latestloc>


<authlist>
   <author>
      <name>Addison P. Phillips</name>
      <affiliation>webMethods, Inc.</affiliation>
   </author>
</authlist>

<status>
  <p><emph>This section describes the status of this document at the time of its
     publication. Other documents may supersede this document. A list of current
	  W3C publications and the latest revision of this technical report can be found
	  in the <loc href="http://www.w3.org/TR/">W3C technical reports index</loc>
     at http://www.w3.org/TR/.</emph></p>
       
     <p>This document is a
     <loc href="http://www.w3.org/2004/02/Process-20040205/tr.html#WGNote">W3C Working Group Note</loc>, made available by the
     <loc xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" href="http://www.w3.org/International/" xlink:show="replace" xlink:actuate="onRequest">W3C Internationalization Working Group</loc>
	  (<loc xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" href="http://www.w3.org/International/ws/" xlink:show="replace" xlink:actuate="onRequest">Web Services Internationalization Task Force</loc>)
	  as part of the
	  <loc href="http://www.w3.org/International/Activity">W3C Internationalization Activity</loc>.
	  It describes requirements for the internationalization of Web services
	  and is intended for review by W3C Members and other interested parties.
	  It is also intended to serve as a basis for future work on Web service
	  internationalization.</p>
	  
	  <p>There were only very few changes since the last publication. The main
	  change is the addition of requirement <loc href="#R007">R007</loc>
	  about integration with the overall Web services architecture and existing
	  technologies. The wording of the other requirements was changed to not favor
	  solutions that are still under discussion. Text has been streamlined and
	  references have been updated.</p>
	  
	  <p>The Internationalization Working Group
	  (Web Services Internationalization Task Force) thinks that this document has
	  reached a sufficient level of maturity to be published as a Working Group Note,
	  and does not intend to issue new versions in the near future.
	  This does not exclude that the document may be updated at a later stage, after
	  more experience has been gained with the internationalization of Web services.</p>
	  
	  <p>The Internationalization Working Group or its successor will keep track of
	  any further comments and discussion relating to this document, and invites any
	  such comments or discussion. Please send comments on this document to the
	  <loc href="mailto:www-i18n-comments@w3.org">www-i18n-comments@w3.org</loc>
	  mailing list (<loc href="http://lists.w3.org/">public archive</loc>).
	  Please use [Web Services] or [WSReq] in the subject.</p>
 
    <p>At the time of publication, the Working Group believed there were no
    patent disclosures relevant to this specification. A current list of
    patent disclosures relevant to this specification may be found on the
    <loc href="http://www.w3.org/International/2002/Disclosures">Working Group's patent disclosure page</loc>.</p>

  <p>Publication as a Working Group Note does not imply endorsement by the W3C,
     including the Team and Membership.</p>
</status>

<abstract>
   <p>This document describes requirements for internationalizing Web services.</p>
</abstract>

<langusage><language id="EN">English</language></langusage>

<revisiondesc><p>Last Modified 10 October 2004</p></revisiondesc>

</header>

<body>

<div1>

<head>Introduction</head>

<p>A Web Service is a software application identified by a URI <bibref id="RFC2396ref" ref="RFC2396"/>,
whose interfaces and binding are capable of being defined, described and discovered by XML
artifacts, and which supports direct interactions with other software applications using XML-based
messages via Internet-based protocols. The full range of application functionality can be
exposed in a Web service. </p>

<p>The W3C Internationalization Working Group, Web Services Task Force,
was chartered to examine Web Services for internationalization issues.
The result of this work is the Web Services Internationalization Usage Scenarios document
<bibref id="WSUSref" ref="WSIUS"/>. Some of the scenarios in that document
demonstrate that, in order to achieve worldwide usability, internationalization
options must be exposed in a consistent way in the definitions, descriptions,
messages, and discovery mechanisms that make up Web services.</p>

<p>The following is a list of the requirements to address these issues.</p>

</div1>

<div1>

<head>Requirements</head>



<div2 id="R007"><head>R007 Integrate Internationalization with Web Services Standards</head>

<p><emph>Problem Statement:</emph> Internationalization should be integrated with
the architecture and general evolution of Web services and should not represent
a departure in design from existing solutions. </p>

<p><emph>Requirement:</emph> Specifications and formats developed for the
internationalization of Web services should be composable with other
quality-of-service type standards, such as those related to security,
reliable messaging, or addressing.</p></div2>

<div2 id="R001"><head>R001 Locale Information in SOAP</head>

<p><emph>Problem Statement:</emph> Service providers and services need information
about the locale, language preference, time zone, or other international preferences
(such as currency, collation, etc.) of the requester.</p>

<p><emph>Requirement:</emph>
A Specification or Specifications for a SOAP header or data structure (possibly a SOAP Feature, see <bibref id="featureref" ref="SOAPpart2"/>,
<xspecref href="http://www.w3.org/TR/2003/REC-soap12-part2-20030624/#soapfeatspec">Section 5: A Convention for Describing Features and Bindings</xspecref>)
to send the Web service provider international context information
(such as locale, language, or other culturally linked preferences)
about the requester and which the provider can use to tailor the language, invocation,
or operation of services or the operation of the provider
(such as language selection in the generation of Faults and so forth).</p>

</div2>

<div2 id="R002"><head>R002 Locale Information in WSDL</head>

<p><emph>Problem Statement:</emph> Service providers need to indicate that the SOAP headers or data structures
described in R001 are available for a specific service or collection of services. The specific "international preference" information of use to the service or aspects of the service must be described so that properly formatted data can be interchanged, enabling internationalized operation.</p>

<p><emph>Requirement:</emph> A specification or specifications for WSDL data structures that can be use in Web service descriptions to indicate  that the headers or data structures described in R001 are available for a particular service and describe the binding and invocation requirements related to this.</p></div2>

<div2 id="R003"><head>R003 International Policies in WSDL</head>

<p><emph>Problem Statement:</emph> Service providers need a way to provide information
about how a specific instance of a locale-affected Web service will execute or to differentiate
instances of the same service. </p><p><emph>Examples:</emph>   For service 'Z', binding 'A' executes in French, binding 'B' executes
in Japanese, and binding 'C' attempts to match the user's preferences.</p>

<p><emph>Requirement:</emph> A specification or specifications for WSDL data structures that allow a service to describe a "locale
execution policy" for a service or a binding of a service, including any additional derived
information of interest to users of the service (allowing users to select the service and
binding that most closely matches their needs or to tailor the operation of the service via
header information). The specification(s) must allow services to describe one or more languages or
locales available for a specific service and allow for a runtime user choice (language/locale
negotiation) when that is appropriate. They must also provide a way to indicate that a specific
service always executes using specific international settings or returns data in a specific
language.</p></div2>

<div2 id="R004"><head>R004 International Policies in SOAP</head>

<p><emph>Problem Statement:</emph> Given the WSDL features in R003, requesters must be able to
indicate their preferences (when choices exist) when invoking a service and providers must be able to indicate which choice was
applied when the service actually executed (as in a response).</p>

<p><emph>Requirement:</emph> A specification or specifications for SOAP headers or data structures  that describe the locale preferences the
requester wishes to have applied to a service (in a request) or which were actually
applied to a service by the provider (in a response) as described in the Web service
description defined in R003. This mechanism may be the same as in R001.</p>

</div2>

<div2 id="R005"><head>R005 Locale Identifiers</head>

<p><emph>Problem Statement:</emph> Although there exist standards for identifying languages
and language preferences on the Web, there are no standards for identifying locales or certain
other international preferences. These data structures are of interest in enabling Web services
and other Web applications for multi-lingual or global operation.</p>

<p><emph>Requirement:</emph> A standard for identifying platform neutral international
preferences (that is, locale identifiers). This should include the protocol for matching requests with actual values (locale negotiation), along with guidelines for implementation. Possible mechanisms for this might be a standard
extension to the proposed extension <bibref id="idref" ref="ID-langtags"/> of
RFC 3066 <bibref id="rfc3066aref" ref="RFC3066"/> that describes international preferences or the use of URIs to refer to locale data or identifiers on the Web.</p>




</div2>

<div2 id="R006">

<head>R006 Multi-Lingual Service Discovery Requirements</head>

<p><emph>Problem Statement:</emph> Web service discovery needs to allow
users to find the same service in multiple languages and to find services that will meet
their specific language or locale requirements.</p>

<p><emph>Requirement:</emph> Document best practices and approaches  for the discovery of Web services,
including via non-W3C standards such as UDDI.</p><p><emph>Requirement:</emph> Liaise with appropriate standards organizations working on Web service discovery.</p>

</div2>

</div1>

</body>

<back>
<inform-div1>
<head>References</head>
<blist><bibl id="RFC3066" key="RFC3066" href="http://www.ietf.org/rfc/rfc3066.txt">"Tags for the Identification of Languages",
Harald Alvestrand,
January 2001.</bibl>
<bibl id="ID-langtags" key="ID-langtags" href="http://www.ietf.org/internet-drafts/draft-phillips-langtags-07.txt">"Tags for the Identification of Languages",
Addison Phillips and Mark Davis,
Internet-Draft draft-phillips-langtags-08, 9 November 2004, work in progress (this document is intended as a replacement for RFC3066).</bibl>
<bibl id="WSIUS" key="WSIUS" href="http://www.w3.org/TR/ws-i18n-scenarios/">"Web Services Internationalization Usage Scenarios",
    Debasish Banerjee, Martin J. Dürst,
    Mike McKenna, Addison Phillips, Takao Suzuki, Tex Texin, Mary Trumble, Andrea Vine, Kentaroh Noji, W3C Working Group Note, 30 July 2004.</bibl>
<bibl id="RFC2396" key="RFC2396" href="http://www.ietf.org/rfc/rfc2396.txt">"Uniform Resource Identifiers (URI): Generic Syntax",
Tim Berners-Lee, Roy Fielding, and Larry Masinter,
August 1998.</bibl>
<bibl href="http://www.w3.org/TR/2003/REC-soap12-part2-20030624/#soapfeatspec" id="SOAPpart2" key="SOAP-Feature">"SOAP Version 1.2, Part 2 (Adjuncts)",
Martin Gudgin, Marc Hadley, Noah Mendelsohn, Jean-Jacques Moreau, and Henrik Frystyk Nielsen,
W3C Recommendation 24 June 2003.</bibl>
</blist>
</inform-div1>

<inform-div1>
<head>Acknowledgements</head>
<p>This document is the work of the Web Services Task Force
 of the W3C Internationalization Working Group. The participants in this task force contributing to the development of these requirements and the content of this document are: Debasish Banerjee (IBM), Martin Dürst (W3C), Mike McKenna (University of California), Takao Suzuki (Microsoft), Tex Texin (Xencraft), Mary Trumble (IBM), Andrea Vine (Sun Microsystems)</p>
 </inform-div1>
 </back>
 </spec>

