Soporte para la localización

En este tema se describe el soporte para la localización en la aplicación utilizando i18next.js.

Puede encontrar la aplicación Sterling Store Engagement utilizando i18next.js, que es una biblioteca de terceros JavaScript utilizada para gestionar la conversión de paquetes i18n. Véase http://i18next.github.io/i18next/pages/doc_features.html para conocer las funciones compatibles con i18next.
La aplicación Sterling Store Engagement tiene su propia directiva, proveedor y servicios para gestionar i18n en bloques de código angular:
- Directiva: isc-i18n
- Proveedores: iscI18nProvider y iscL10nCache
- Servicio: iscI18n
Para más información, consulte la documentación de la directiva isci18n y el servicio iscI18n en la documentación JavaScript disponible con la aplicación.

Configuración de i18n para Sterling Store

Puede configurar i18n para la aplicación en <wscdev.war>/ngstore/store/config/i18n.config.js. Consulte el siguiente fragmento de código de configuración:

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
        });
    }]);

Personalización de la configuración de i18n

Altere temporalmente <wscdev.war>/ngstore/store/config/i18n.config.js y colóquelo en <Extn_workspace>/extn/ngstore/store/config/i18n.config.js.
Actualice los datos de configuración según los requisitos de su empresa.

Adición de nuevos archivos de paquete

Añada el archivo extn.nls.json a la carpeta <Extn_workspace>/extn/ngstore/store/views/nls/en para añadir el archivo nls para el módulo de tienda. De forma similar, añada para otros entornos locales según sea necesario.
Altere temporalmente i18n.config.js para añadir una nueva entrada para extn.nls.json en la matriz l10nKit .

Alteración temporal de entradas de paquete existentes

Las entradas de paquetes existentes pueden anularse añadiendo algunas claves adicionales junto con la ruta json en el archivo extn.nls.json . Consulte el siguiente fragmento de código de ejemplo:

Nota: Ponga los pares key:value entre comillas como se muestra en el fragmento de código.


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

Nuevo soporte lingüístico

Complete los siguientes pasos para admitir un nuevo idioma:

Altere temporalmente el archivo i18n.config.js para añadir una nueva entrada para idiomas tal como se muestra en el ejemplo siguiente:
```
lngs:["de", "en", "es", "fr", "it", 
"ja", "ko", "pl", "pt", "ru", "tr", "zh", "zh-tw", <new_locale>],
```
Alterar temporalmente la propiedad wsc.ui.locales en el archivo de alteraciones temporales de cliente como yfs.wsc.ui.locales=de,en,es,fr,it,ja,ko,pl,pt,ru,tr,zh,zh-tw,<new_locale>
Actualice el archivo ngstore.gulp.config.json para el nuevo entorno local que se va a añadir para la minificación.
```
 "l10nLocales":["de","en","es","fr","it",
"ja","ko","pl","pt","ru","tr","zh","zh-tw"<,new_locale>]
```

Personalización del formato de fecha

El filtro de fechas aparece en las pantallas Lista de pedidos y Lista de envíos. Las fechas se formatean como MMM, dd, aaaa sólo para la configuración regional inglesa. Para todas las demás configuraciones regionales, el formato por defecto es aaaa/MM/dd. Este formato de fecha se mantiene igual para las opciones "Desde", "Hasta" y el menú desplegable de filtros de fecha.

Los formatos de fecha pueden personalizarse. Consulte el archivo ngstore\store\config\localedateformat.config.js para obtener más información. Configure sólo los formatos válidos comprendidos por el widget bootstrap Datepicker . Si no se especifica el formato o se especifica un formato no válido para una configuración regional, el formato de fecha por defecto será aaaa/MM/dd.

Personalización del formato de moneda

El archivo ngstore\store\config\currency.config.js se utiliza para configurar la información de formato de moneda para varios códigos de moneda. Los formatos de moneda que se muestran en la interfaz de usuario se configuran en este archivo. Para añadir una nueva moneda aparte del formato de moneda que se proporciona de forma predeterminada, debe ampliar el archivo currency.config.js tal como se muestra en el ejemplo siguiente:

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”: “”
            }
        }
    });
}]);