Prise en charge de la localisation

Cette rubrique décrit la prise en charge de la localisation dans l'application à l'aide de i18next.js.

Vous pouvez trouver l'application Sterling Store Engagement en utilisant i18next.js, qui est une bibliothèque tierce JavaScript utilisée pour gérer la conversion du paquet i18n. Voir http://i18next.github.io/i18next/pages/doc_features.html pour connaître les fonctionnalités prises en charge par i18next.
L'application Sterling Store Engagement dispose de sa propre directive, de son propre fournisseur et de ses propres services pour gérer i18n dans les blocs de code angulaires :
- Directive : isc-i18n
- Fournisseurs: iscI18nProvider et iscL10nCache
- Service : iscI18n
Pour plus d'informations, voir la documentation de la directive isci18n et du service iscI18n dans la documentation JavaScript disponible avec l'application.

Configuration d' i18n pour Sterling Store

Vous pouvez configurer i18n pour l'application dans <wscdev.war>/ngstore/store/config/i18n.config.js. Voir l'extrait de code de configuration suivant :

angular.module('store').config(['iscI18nProvider',function(iscI18nProvider){
        iscI18nProvider.initExtn({
            lngs:["de", "en"], //Comma separated locale codes
            fallbackLng: 'en', // default locale, if none of the locale codes are specified
            l10nKit:[
                {url:'./shared/nls/__lng__/shared.nls.json',ns:'app'},
                {url:'./store/nls/__lng__/login.nls.json',ns:'app'},
                {url:'./store/nls/__lng__/app.nls.json',ns:'app'},
                {url:'./store/nls/__lng__/extn.nls.json',ns:'app'}
            ] 
// array of nls files to be loaded, __lng__ is variable which will be substituted in runtime
        });
    }]);

Personnalisation de la configuration i18n

Remplacez le fichier <wscdev.war>/ngstore/store/config/i18n.config.js et placez-le dans le fichier <Extn_workspace>/extn/ngstore/store/config/i18n.config.js.
Mettre à jour les données de configuration en fonction des besoins de l'entreprise.

Ajout de nouveaux fichiers de bundle

Ajoutez le fichier extn.nls.json au dossier <Extn_workspace>/extn/ngstore/store/views/nls/en pour ajouter le fichier nls au module de magasin. De la même manière, ajoutez des paramètres régionaux pour les autres environnements locaux, selon les besoins.
Remplacez i18n.config.js pour ajouter une nouvelle entrée pour extn.nls.json dans le tableau l10nKit .

Remplacement des entrées de bundle existantes

Les entrées de paquet existantes peuvent être remplacées en ajoutant quelques clés supplémentaires ainsi que le chemin d'accès à json dans le fichier extn.nls.json . Reportez-vous à l'exemple de fragment de code suivant:

Note : Mettez les paires key:value entre guillemets comme indiqué dans l'extrait de code.


    {
        "TITLE_Product":"IBM Sterling Store",
        "order":{
            "LABEL_Order_no":"Order #"        
        }    
    }

Nouveau support linguistique

Suivez les étapes suivantes pour prendre en charge une nouvelle langue :

Remplacez le fichier i18n.config.js pour ajouter une nouvelle entrée pour les langues, comme illustré dans l'exemple suivant:
```
lngs:["de", "en", "es", "fr", "it", 
"ja", "ko", "pl", "pt", "ru", "tr", "zh", "zh-tw", <new_locale>],
```
Remplacez la propriété wsc.ui.locales dans le fichier de substitutions client par yfs.wsc.ui.locales=de,en,es,fr,it,ja,ko,pl,pt,ru,tr,zh,zh-tw,<new_locale>
Mettez à jour le fichier ngstore.gulp.config.json pour le nouvel environnement local à ajouter pour la minimisation.
```
 "l10nLocales":["de","en","es","fr","it",
"ja","ko","pl","pt","ru","tr","zh","zh-tw"<,new_locale>]
```

Personnalisation du format de date

Le filtre de date apparaît dans les écrans Liste des commandes et Liste des envois. Les dates sont formatées sous la forme MMM, dd, yyyy pour la langue anglaise uniquement. Pour toutes les autres locales, le format par défaut est aaaa/MM/jj. Ce format de date reste identique pour les options « Date de début », « Date de fin » et le menu déroulant « Options de filtre de date ».

Les formats de date peuvent être personnalisés. Pour en savoir plus, consultez le fichier ngstore\store\config\localedateformat.config.js . Ne configurer que les formats valides compris par le widget bootstrap Datepicker . Si le format n'est pas spécifié ou si un format non valide est spécifié pour une locale, le format de la date est par défaut aaaa/MM/jj.

Personnalisation du format de devise

Le fichier ngstore\store\config\currency.config.js permet de configurer les informations de formatage de devise pour différents codes de devise. Les formats de devises affichés dans l'interface utilisateur sont configurés dans ce fichier. Pour ajouter une nouvelle devise en dehors du format de devise fourni par défaut, vous devez étendre le fichier currency.config.js comme illustré dans l'exemple suivant:

angular.module(‘store’).config([‘iscCurrencyFormatProvider’,function(iscCurrencyFormatProvider){
    iscCurrencyFormatProvider.addCurrencyFormat({
        “currencyCode” : “USD”,
        “currencyDescription” : “US Dollar”,
        “NUMBER_FORMATS” : {
            “CURRENCY_SYM”: “$”,
            “DECIMAL_SEP”: “.”,
            “GROUP_SEP”: “,”,
            “PATTERNS”:
            {
                “gSize”: 3,
                “lgSize”: 3,
                “maxFrac”: 2,
                “minFrac”: 2,
                “minInt”: 1,
                “negPre”: “-\u00a4”,
                “negSuf”: “”,
                “posPre”: “\u00a4”,
                “posSuf”: “”
            }
        }
    });
}]);