Globalisierung

System-API-Aufrufe geben standardmäßig Daten im Format der Standardsprache und des Gebietsschemas Ihrer ClaimCenter Instanz zurück, wie durch die Systemparameter DefaultApplicationLanguage und DefaultApplicationLocale in config.xml angegeben. Wenn Ihre Instanz zusätzliche Sprachen und Gebietsschemata unterstützt, können Sie API-Aufrufe erstellen, um Daten in diesen alternativen Formaten anzufordern.

Aufrufer können im Anforderungs-Header eine bevorzugte Sprache und ein bevorzugtes Gebietsschema angeben. Guidewire bietet zu diesem Zweck zwei Headerfelder: GW-Language und GW-Locale. Das Feld GW-Language akzeptiert einen ISO-639-1-Code, der die Sprache bezeichnet, während das Feld GW-Locale den Sprachcode ISO-639-1 zusammen mit dem Gebietsschemacode ISO-3166-1-Alpha-2, getrennt durch einen Unterstrich, verwendet.

Beispiel: Der Sprachcode ISO 639-1 für Japanisch lautet ja, und der Gebietsschemacode ISO 3166-1 alpha-2 für Japan lautet JP. Der folgende Codeblock zeigt einen Anforderungs-Header an, wobei die Felder GW-Language und GW-Locale auf japanische Sprache bzw. japanisches Gebietsschema festgelegt sind:

GET /pc/rest/account/v1/accounts/pc:102? HTTP/1.1
Host: localhost:8180
GW-Language: ja
GW-Locale: ja_JP
Authorization: Basic c3U6Z3c=

Die Formatierung von Postadressen kann je nach Land variieren. ClaimCenter bietet eine flexible Möglichkeit, Adressen mit der Adressen-Entität zusammen mit den Typenlisten Bundesland/Kanton und Land zu formatieren. In den System-APIs werden diese Adressdaten dem Adressen-Schema zugeordnet, das in der Common-API gefunden wird.

In der folgenden Tabelle sind alle Adressen-Eigenschaften mit dem zugehörigen Guidewire-Adressen-Entitätsfeld aufgeführt:

Adressen-Eigenschaft	GW-Entitätszuordnung	Beschreibung
addressLine1	Address.​AddressLine1	Erste Zeile einer Straßenangabe
addressLine1Kanji	Address.​AddressLine1Kanji	Erste Zeile einer Straßenangabe (auf Japanisch)
addressLine2	Address.​AddressLine2	Zweite Zeile einer Straßenangabe
addressLine2Kanji	Address.​AddressLine2Kanji	Zweite Zeile einer Straßenangabe (auf Japanisch)
addressLine3	Address.​AddressLine3	Dritte Zeile einer Straßenangabe
area	Address.​State	Länderspezifischer Verwaltungsbereich gemäß Definition in der Typenliste Bundesland/Kanton
city	Address.​City	Stadt oder Ort
cityKanji	Address.​CityKanji	Stadt oder Ort (auf Japanisch)
country	Address.​Country	Länderschlüssel gemäß Definition in der Typenliste Land
county	Address.​State	Länderspezifischer Verwaltungsbereich gemäß Definition in der Typenliste Bundesland/Kanton
department	Address.​State	Länderspezifischer Verwaltungsbereich gemäß Definition in der Typenliste Bundesland/Kanton
district	Address.​State	Länderspezifischer Verwaltungsbereich gemäß Definition in der Typenliste Bundesland/Kanton
do_si	Address.​State	Länderspezifischer Verwaltungsbereich gemäß Definition in der Typenliste Bundesland/Kanton
emirate	Address.​State	Länderspezifischer Verwaltungsbereich gemäß Definition in der Typenliste Bundesland/Kanton
island	Address.​State	Länderspezifischer Verwaltungsbereich gemäß Definition in der Typenliste Bundesland/Kanton
oblast	Address.​State	Länderspezifischer Verwaltungsbereich gemäß Definition in der Typenliste Bundesland/Kanton
parish	Address.​State	Länderspezifischer Verwaltungsbereich gemäß Definition in der Typenliste Bundesland/Kanton
postalCode	Address.​PostalCode	Postleitzahl
prefecture	Address.​State	Länderspezifischer Verwaltungsbereich gemäß Definition in der Typenliste Bundesland/Kanton
province	Address.​State	Länderspezifischer Verwaltungsbereich gemäß Definition in der Typenliste Bundesland/Kanton
sortingCode	Address.​CEDEXBureau	Sortiercode (nur Frankreich)
state	Address.​State	Länderspezifischer Verwaltungsbereich gemäß Definition in der Typenliste Bundesland/Kanton

Das Adressen-Schema unterstützt zwar einen breiten Bereich von Eigenschaften für gebietsschemaspezifische administrative Bereiche, aber nur eine solche Eigenschaft kann in einer bestimmten Adresse verwendet werden. Beispielsweise kann eine Adresse nicht sowohl state als auch provinceEigenschaften verwenden. Außerdem ist in einer Adresse nur eine Eigenschaft des Verwaltungsgebiets gültig, und diese wird durch das Land oder Gebiet der Adresse bestimmt. Studio bietet unter configuration/config/Integration/i18n/addresses.i18n.yaml eine Adresskonfigurationsdatei:

countries:
  . . .
  JP:
    name: Japan
    addressFields: addressLine1, addressLine1Kanji, addressLine2, addressLine2Kanji, addressLine3, city, cityKanji, prefecture, postalCode
    addressRequire: addressLine1, city, prefecture, postalCode
  . . .
  US:
    name: United States
    addressFields: addressLine1, addressLine2, addressLine3, city, county, state, postalCode
    addressRequire: addressLine1, city, state, postalCode
  . . .

Das Feld countries enthält eine Eigenschaft für jedes Land oder jede Region, deren Name aus dem entsprechenden ISO 3166-1 Alpha-2-Ländercode abgeleitet wird. Der vorherige Codeblock zeigt für Japan bzw. die USA zwei derartige Eigenschaften an: JP und US. Jede Ländereigenschaft enthält die folgenden Felder und Werte:

• name: Der Name der Region (in der Regel Land oder Gebiet)
• addressFields: Die Adressfelder aus dem Adressen-Schema, die in einer Adresse für das Land oder die Region enthalten sein können
• addressRequire: Die Mindestteilmenge von Adressfeldern, die in einer Adresse für das Land oder die Region enthalten sein müssen

Beim Starten des Servers wird die Datei address.i18n.yaml geladen und die zugehörigen Regeln werden auf die Adressen-Ressourcen angewendet. Das Adressen-Schema enthält einen Code, der diese Funktion aktiviert:

"Address": {
  "type": "object",
  "x-gw-extensions": {
    "discriminatorProperty": "country"
  },
  "properties": {
    . . .
    }
  }
}

Im vorherigen Codeausschnitt ist das Feld x-gw-extensions.discriminatorProperty auf country gesetzt. Infolgedessen sind beim Festlegen der Eigenschaft Land für eine Adressen-Ressource die mit diesem Land verknüpften Adressfelder für diese Ressource gültig, und die nicht mit dem Land verknüpften Felder sind nicht verfügbar.