Both the Assess and Interview Services allow the language to be used for the assessment/interview to b e specified by the requestor. This is done by adding the optional international element to the SOAP Header element of the request. This complies with the Web Services Internationalization standard – WS-I18n (http://www.w3.org/TR/ws-i18n/).
Note: Specifying the language to use for a particular interview or assessment only affects the attribute text for attributes, entities and relationships (in decision reports or on screens) and screen items such as captions. It does not affect the input or output format for attribute values.
The list of languages supported by a particular rulebase is listed in the response for the ListRulebases operation in the Server Service, under the ‘available-languages’ element of the rulebase. For example:
<typ:rulebase name="Complete">
<typ:available-languages>
<typ:language>en_US</typ:language>
<typ:language>fr_BE</typ:language>
</typ:available-languages>
<typ:available-services>
<typ:service name="odsInterviewService">http://localhost:8080/det-server-102/interview/soap/Complete?wsdl</typ:service>
<typ:service name="odsInterviewService102">http://localhost:8080/det-server-
102/interview/soap/10.2/Complete?wsdl</typ:service>
<typ:service name="odsAssessServiceSpecific">http://localhost:8080/det-server-
102/assess/soap/specific/Complete?wsdl</typ:service>
<typ:service name="odsAssessServiceGeneric">http://localhost:8080/det-server-
102/assess/soap/generic/Complete?wsdl</typ:service>
<typ:service name="odsAssessServiceSpecific102">http://localhost:8080/det-server-
102/assess/soap/specific/10.2/Complete?wsdl</typ:service>
<typ:service name="odsAssessServiceGeneric102">http://localhost:8080/det-server-
102/assess/soap/generic/10.2/Complete?wsdl</typ:service>
<typ:service name="odsAssessServiceSpecific10">http://localhost:8080/det-server-
102/assess/soap/specific/10.0/Complete?wsdl</typ:service>
<typ:service name="odsAssessServiceGeneric10">http://localhost:8080/det-server-
102/assess/soap/generic/10.0/Complete?wsdl</typ:service>
</typ:available-services>
</typ:rulebase>
this section of the response indicates that the rulebase Complete has two available languages, American English (en_US) or Belgian French (fr_BE).
As mentioned above, the locale can be specified in any request to the Determinations Server, by adding the international element to the SOAP Header element, and adding the locale sub-element. The locale’s value will be in the form of a two letter ISO 693-1 language code followed by the two letter ISO 3166-1 country code separated by an underscore (‘_’), that is:
< international xmlns="http://www.w3.org/2005/09/ws-i18n">
<locale>language-locale</i18n:locale>
</international>
Specifying the WS-i18n locale element in the request of an assess operation will cause any attribute, relationship and entity text returned in a decision report to be in the specified language. A locale may also be specified in a ListGoals request which would affect the text of the goals returned. If no locale is specified for each of these requests, the default language for the rulebase will be used.
The language used for an interview session can be configured by specifying the locale in the OpenSession operation. If no locale is specified, the session will be created using the default language for the rulebase.
For all other operations, if the locale is specified it must match the locale used to open the session or an error is returned. If no locale is specified, the language used will be that of the session.