<?xml version="1.0"?>
<?xml-stylesheet type="text/xsl" href="xmlspec.xsl"?>
<!DOCTYPE spec SYSTEM "xmlspec.dtd" [
<!ENTITY Latest "http://www.w3.org/TR/ws-i18n-req">
<!ENTITY Previous "http://www.w3.org/TR/2003/WD-ws-i18n-req-20031217">
<!ENTITY Current "http://www.w3.org/TR/2003/WD-ws-i18n-req-20031217">
<!ENTITY status "W3C Working Draft">
<!-- <!ENTITY status "Editors' copy $Date: 2003/12/15 22:49:02 $"> -->
<!ENTITY DD "17">
<!ENTITY MM "12">
<!ENTITY month "December">
<!ENTITY year "2003">
]>

<spec w3c-doctype="wd">
<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</affiliation></author>
<!--
<author><name>Martin Dürst</name><affiliation>W3C</affiliation></author>
<author><name>Andrea Vine</name><affiliation>Sun Microsystems</affiliation></author>
<author><name>Michael McKenna</name><affiliation>Haddon Hill</affiliation></author>
<author><name>Tex Texin</name><affiliation>XenCraft</affiliation></author>
<author><name>Takao Suzuki</name><affiliation>Microsoft</affiliation></author>
<author><name>Debasish Banerjee</name><affiliation>IBM</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
<xspecref href="http://www.w3.org/TR/">W3C technical reports index</xspecref>
at http://www.w3.org/TR/.</emph></p>
	  
	  <p>This is a first Working Draft describing requirements for Web services 
     internationalization, for review by W3C members and other
     interested parties.  Although this is a first Working Draft , we think that the requirements described in this document are very close to the final requirements. The final target of the Working Draft is publication as a Note. We intend to use these requirements as input for the next phase of our work.</p><p>This document has been produced by the 
     <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> of 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>, as part of the
     <loc href="http://www.w3.org/International/Activity">W3C Internationalization Activity</loc>.</p>
	  
   <p>Discussion of this document takes place on the public mailing list 
     <loc href="mailto:public-i18n-ws@w3.org">public-i18n-ws@w3.org</loc>.
     To contribute or comment, please subscribe by sending mail to 
     <loc href="mailto:public-i18n-ws-request@w3.org">public-i18n-ws-request@w3.org</loc>
     with <code>subscribe</code> as the subject. The 
     <loc xmlns:xlink="http://www.w3.org/1999/xlink" xlink:type="simple" href="http://lists.w3.org/Archives/Public/public-i18n-ws/" xlink:show="replace" xlink:actuate="onRequest">archive</loc> of this list can be read 
     by the general public.</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>This document is work in progress and does not imply endorsement by, or the consensus of the 
      members of the Web Services Task Force of the W3C Internationalization 
     Working Group. Publication as a Working Draft does not imply endorsement by the W3C Membership. This is a draft document and may be updated, replaced or obsoleted by other documents at any time. It is inappropriate to cite this document as other than work in progress.</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 17 December 2003</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="WSUS"/>.Some of the scenarios in this document
demonstrate that 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><head>R001 SOAP Locale Feature</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 SOAP Feature (see <bibref id="featureref" ref="SOAPpart2"/>,
<xspecref href="http://www.w3.org/TR/2003/REC-soap12-part2-20030624/#soapfeatspec">Section 5</xspecref>)
that provides 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><head>R002 WSDL Locale Feature</head>

<p><emph>Problem Statement:</emph> Service providers need to indicate that the SOAP Feature
described in R001 is available for a specific service or collection of services.</p>

<p><emph>Requirement:</emph> A WSDL feature that describes the international context SOAP
Feature described in R001.</p></div2>

<div2><head>R003 WSDL International Policy Feature</head>

<p><emph>Problem Statement:</emph> Service providers need a way to provide information
about a specific instance of a locale-affected Web service will execute or to differentiate
instances of the same service. For example,  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 WSDL feature that allows 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 the select the service and
binding that most closely matches their needs or to tailor the operation of the service via
header information). This feature 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. It 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><head>R004 SOAP International Policy Feature</head>

<p><emph>Problem Statement:</emph> Given the WSDL feature in R003, services must be able to
indicate which available choice to use when invoking a service (request) or which choice was
applied when the service actually executed (response).</p>

<p><emph>Requirement:</emph> A SOAP Feature that describes the locale preferences the
requester wished 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><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). One possible mechanism would 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.
Some of the items that such an extension would describe include:</p>

<slist>
  <sitem>Locales</sitem>
  <sitem>Timezones</sitem>
  <sitem>Collation Preferences</sitem>
</slist>


</div2>

<div2>

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

<p><emph>Problem Statement:</emph> Automatic discovery of Web services 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> Develop requirements for the discovery of Web services,
including via non-W3C standards such as UDDI.</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-langtags-phillips-davis-01.txt">"Tags for Languages",
Addison Phillips and Mark Davis,
Internet-Draft draft-langtags-phillips-davis-01, work in progress, November 2003.</bibl>
<bibl id="WSUS" key="WSUS" href="http://www.w3.org/TR/ws-i18n-scenarios/">"Web Services Internationalization Usage Scenarios",
Kentaroh Noji, Martin J. Dürst, Addison Phillips, Takao Suzuki, and Tex Texin,
W3C Working Draft, 16 May 2003.</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.</p>
 </inform-div1>
 </back>
 </spec>

