Ampliación de la localización

Puede ampliar el soporte de localización en Sterling Store Engagement para que admita varias configuraciones regionales, añadir idiomas distintos de los admitidos por defecto, añadir formatos de fecha personalizados, etc.

Sterling Store Engagement es compatible con todos los requisitos generales de localización, incluidos el tratamiento de divisas, el formato de fechas, el formato de números, etc.

Sin embargo, primero debe configurar las configuraciones regionales y asociarlas a organizaciones y usuarios mediante el Administrador de aplicaciones. Para más información, consulte Definición de locales.

Adición de soporte para un nuevo entorno local

Cree entradas de paquete para todo el texto utilizado en toda la aplicación en su archivo <language>.json respectivo.
Cree archivos <language>.json independientes para todos los módulos bajo la carpeta <WORKSPACE>/store-frontend/src/assets/store-frontend/i18n/<module> .
Cree la siguiente estructura de carpetas en SCREEN_EXTENSIONS_HOME, si no está ya presente:SCREEN_EXTENSIONS_HOME/app/config
Copie el archivo i18n.config.ts de la carpeta <WORKSPACE>/store-frontend/src/app/config en la carpeta SCREEN_EXTENSIONS_HOME/app/config .

Actualice un comentario mágico de webpack webpackInclude con el nuevo código de entorno local tal como se muestra en el ejemplo siguiente:

public static loadLocale(localeId: string): Promise<any> {
                     localeId = `${localeId}-${AppContextService.getFromContext('countryCode')}`;
        const locale = I18nConfig.localeMap[localeId] || localeId;

        return import(
            /* webpackChunkName: "[request]" */
            /* webpackInclude: /[/\\](en|de|es|fr|fr-CA|it|ja|pt|zh-Hans|zh-Hant)\.js$/ */
            /* webpackExclude: /[/\\]global|extra/ */
            `@angular/common/locales/${locale}.js`
        ).then(m => registerLocaleData(m.default));
    }

Debe asegurarse de que sólo utiliza los códigos de entorno local a los que Angular da soporte como nuevo código de entorno local.

Sin embargo, si el código de entorno local no coincide con los que admite Angular, puede soportarlo actualizando los detalles de localeMap del código de entorno local Angular correspondiente.

Por ejemplo, Angular no da soporte a pt-Br como código de entorno local válido. Pero puede añadir pt-Br como un entorno local enlazando con pt tal como se muestra en el ejemplo siguiente:

public static localeMap: { [locale: string]: string } = {
        'pt-BR': 'pt',
};

Actualización de un nuevo idioma de reserva

Cree la siguiente estructura de carpetas en SCREEN_EXTENSIONS_HOME, si no está ya presente:SCREEN_EXTENSIONS_HOME/app/config
Copie el archivo i18n.config.ts de la carpeta <WORKSPACE>/store-frontend/src/app/config en SCREEN_EXTENSIONS_HOME/app/config.
Actualice la variable fallbackLanguage con el nuevo código de entorno local.
```
public static fallbackLanguage = 'en';
```

Adición y actualización de formatos de fecha personalizados

Puede actualizar un formato de fecha existente, así como añadir un nuevo formato de fecha.

Cree la siguiente estructura de carpetas en SCREEN_EXTENSIONS_HOME, si no está ya presente:SCREEN_EXTENSIONS_HOME/app/config
Copie el archivo date-format.config.ts de la carpeta <WORKSPACE>/store-frontend/src/app/config en SCREEN_EXTENSIONS_HOME/app/config.

Añada un nuevo objeto con el código de entorno local como clave y los formatos de fecha como valor.

export const DateFormatConfig: any = {
    'en': {
        'isfMedium': 'd MMM YYYY, h:mm a',
        'isfFull': 'EEEE, d MMMM yyyy, h:mm a',
        'isfMediumDate': 'd MMM yyyy',
        'isfFullDate': 'EEEE, d MMMM yyyy',
        'isfShortTime': 'h:mm a'
    }
}

Formatos de fecha soportados

Sterling Store Engagement utiliza una tubería de fecha personalizada, dateFormat, para el formato de fecha, que soporta todas las características soportadas por DatePipe en Angular.

El archivo date-format.config se utiliza para personalizar el formato de fecha en toda la aplicación para distintos entornos locales.

Por defecto, Sterling Store Engagement admite los siguientes formatos de fecha:

isfMedium - d MMM YYYY, h:mm a
isfFull - EEEE, d MMMM yyyy, h:mm a
isfMediumDate - d MMM yyyy
isfFullDate - EEEE, d MMMM yyyy
isfShortTime - h:mm a

El formato de fecha predeterminado es isfMediumDate.