Traducción de ID de objeto object-id-translation
El servicio de imágenes proporciona un mecanismo para traducir los ID de objeto externos a ID de objeto (catálogo) específicos de la configuración regional. La aplicación principal se utiliza para proporcionar contenido específico de la configuración regional y contenido compartido entre varias configuraciones regionales sin que la aplicación cliente necesite conocer los ID de objeto específicos de la configuración regional.
La aplicación se puede escribir utilizando únicamente ID de objeto globales y el servicio de imágenes sustituye automáticamente las imágenes específicas de la configuración regional y otro contenido cuando está disponible.
El locale se ha especificado en las solicitudes del servicio de imágenes con el comando locale=.
Ámbito section-66fcd5bd467c4eeaa1574583cbe9756d
Todas las referencias a entradas en los catálogos de imagen, SVG y contenido estático se tienen en cuenta para las fuentes de traducción y las referencias de perfil ICC no se traducen. Además de object en la ruta de acceso de /is/image y /is/static requests, estos comandos y atributos de catálogo están sujetos a la traducción de id.: src=, mask=, template=, defaultImage=, attribute::DefaultImage y attribute::Watermark.
Mapa de traducción de ID section-9e417b352c314dfe94e831fdd62cddc8
attribute::LocaleMap define las reglas que usa el servidor para determinar el identificador del contenido localizado, dado como entradas el identificador de objeto genérico y el valor locale=.
attribute::LocaleMap consiste en una lista de configuraciones regionales de entrada (que coinciden con los valores especificados con locale=), cada una con ninguno o más sufijos de configuración regional de salida ( *locSuffixes*).
Por ejemplo, attribute::LocaleMap podría tener el siguiente aspecto:
en,_E,|en_us,_E,|en_uk,_E,|fr,_F,|de,_D,|de_at,_D,|de_de,_D,|,_E,
La solicitud /is/image/myCat/myImg?locale=de_de devolvería la imagen asociada con la entrada de catálogo myCat/myImg_D (suponiendo que exista dicha entrada de catálogo).
Consulte la descripción de attribute::LocaleMap para obtener detalles.
El proceso de traducción section-1f64db17e9f644d88e09853670e14a16
Dado el ejemplo anterior, el servidor busca primero el(la) locale " de_de" en el mapa de traducción de ID. Luego se repite el locSuffixes asociado con esta entrada en este caso "_D" y "" (sufijo vacío). Para cada iteración, el sufijo se anexa al ID de imagen y se comprueba la existencia del ID resultante en el catálogo. Si se encuentra, se utiliza esa entrada de catálogo; de lo contrario, se prueba la siguiente. Para este ejemplo, se comprueban estas entradas: myCat/myImg_D y myCat/myImg. Si no se encuentra ninguna coincidencia, el servidor devuelve un error o una imagen predeterminada (si así se ha configurado).
Configuraciones regionales desconocidas section-b2f3c83f2dc845d69b5908107b775537
En el ejemplo anterior, attribute::LocaleMap incluye un elemento locale vacío que define la regla de traducción predeterminada, utilizada para valores locale= desconocidos (es decir, aquellos que no están enumerados explícitamente en el mapa de traducción). Si esta asignación de traducción se aplicara a la solicitud /is/image/myCat/myImg?locale=ja, se resolvería en myCat/myImg_E, si existe, o de otro modo en myCat/myImg.
Si una asignación de traducción no especifica una regla de traducción predeterminada, se devuelve un error para todas las solicitudes con valores locale= desconocidos.
Ejemplos section-cc40bb00ee9248bb8cb23e17d7a5984c
Búsqueda de varios niveles
A menudo es deseable agrupar las configuraciones regionales (por ejemplo, Europa, Oriente Medio y América del Norte) para abordar los estándares regionales. Esto se puede lograr con una búsqueda de varios niveles.
Para este ejemplo, queremos admitir colecciones para uso occidental y de Oriente Medio. Ambas colecciones se basan en la colección de imágenes genéricas y ambas añaden o modifican ciertas imágenes. Ambas colecciones se refinan aún más para configuraciones regionales específicas ( m1, m2 para dos variantes de Oriente medio y w1, w2 y w3 para tres configuraciones regionales occidentales), excepto que las imágenes se comparten para w1 y w3. Las configuraciones regionales desconocidas solo se asignan a la colección genérica y no tienen acceso a imágenes específicas de la configuración regional.
attribute::LocaleMap: w1,-W,|w2,-W2,-W,|w3,-W,|m1,-M1,-M,|m2,-M2,-M,|,
La siguiente tabla muestra qué entradas de catálogo se tienen en cuenta y el orden en que se tienen en cuenta para el identificador de entrada genérico myImg:
Buscar identificadores específicos
Es posible que algunas convenciones de nomenclatura de imágenes no admitan internamente ID de imagen genéricos. Los ID genéricos de la solicitud siempre deben asignarse a un ID específico en el catálogo; a menudo, es posible que no se conozca el ID específico exacto.
Para este ejemplo, las imágenes de todos los idiomas pueden tener los sufijos _1, _2 o _3. Las imágenes específicas de las configuraciones regionales en francés pueden tener _22 o _23 sufijos, y las imágenes específicas de las configuraciones regionales en alemán pueden tener _470 o _480 sufijos.
attribute::LocaleMap: ,_1,_2,_3|fr,_22,_23,_1,_2,_3|de,_470,_480,_1,_2,_3| de_at,_470,_480,_1,_2,_3| de_de,_470,_480,_1,_2,_3
La siguiente tabla muestra qué entradas de catálogo se tienen en cuenta y el orden en que se tienen en cuenta para el identificador de entrada genérico myImg:
Véase también section-05893816c66a406d89f9bfd6ace8d47a
attribute::LocaleMap , attribute::DefaultLocale, locale=, req=xlate