Usted está aquí:
Sintaxis de URL de las Reglas de URL
Puede definir cómo las URL de su escaparate se ven en B2C Commerce mediante tres tipos de sintaxis de URL: sintaxis de URL estándar de B2C Commerce, sintaxis de URL de SEO o sintaxis de URL útil para la búsqueda en desuso. La sintaxis que usa depende del módulo en que le habilitaron Business Manager.
- Si no especifica la sintaxis de URL, se usa la sintaxis de URL estándar de B2C Commerce.
- Si habilita el módulo Reglas de URL, se usa la sintaxis configurada para el módulo Reglas de URL. Consulte Configuración de las preferencias de URL de Storefront.
- Si habilita el módulo Soporte de SEO en desuso (al anular la selección de la preferencia de las Reglas de URL), se usa la sintaxis configurada para el módulo Soporte de SEO. Consulte Habilitación de URL útiles para búsqueda.
En esta página se describe la sintaxis de las Reglas de URL y se ilustran cómo difiere de la sintaxis estándar y el estándar de SEO.
Formato de URL del sitio
El formato de URL del sitio se define de la siguiente forma:
Con B2C Commerce, puede configurar y personalizar el punto de conexión de una URL.
URL de instancia de Producción (Production)
En las instancias de Producción (Production), las URL de B2C Commerce tienen la siguiente apariencia:
URL de instancias de Entorno aislado de pruebas (Sandbox), Presentación (Staging) y Desarrollo (Development)
Puede definir un alias (your.instance.hostname.example.com) o una instancia de Staging, Development o Sandbox. Las URL tienen your.instance.hostname.example.com como el nombre de host, seguido del prefijo /s, seguido del nombre del sitio. El punto de conexión real es idéntico al de la instancia de Producción (Production). Esto permite a los vendedores minoristas de múltiples sitios ver los puntos de conexión configurados para cada uno de sus sitios.
Si se usa un nombre de host personalizado como example.com en el archivo de alias, las URL no necesitan el patrón con la /s e identificación del sitio en la ruta y se crea una URL corta, como example.com/cart.
Consejos de sintaxis generales
Para comprender cómo se evalúan y resuelven las URL solicitantes, consulte Evaluación y resolución de URL.
Las URL se puede resolver incluso si existen diferencias de casos en la URL.
Las URL se pueden resolver si los siguientes caracteres no codificados se encuentran en la URL porque B2C Commerce los codifica automáticamente:
, @ ) ! $ ' ( ~El uso de los espacios en una regla de URL es solo para fines de lectura. La ausencia de los espacios alrededor de los elementos no hace la diferencia si la regla de la URL se verifica. Sin embargo, las comas son importantes porque separan los elementos. La ausencia de una coma puede determinar si se verifica su regla.
Al definir las reglas de URL, tenga en cuenta el contexto cuando especifica la fuente de los atributos. Para una regla de categoría, la fuente es una categoría, de manera que puede usar una regla tal como la siguiente:
[ [ constant, const ], /, [ category-path, [ attribute, ID ], - ]]En esta regla, está definiendo una constante y la ruta de la categoría a usar en cada URL. El atributo en esta regla es un atributo de la categoría y así, la identificación (ID) de la categoría.
Sin embargo, en una regla del producto, la fuente es un producto, por lo que debe declarar la categoría como fuente para la categoría-ruta, como en la siguiente regla:
[ [ constant, const ], /, [ category, [ category-path, [ attribute, ID ], - ] ]]Si define la siguiente regla del producto, la constante const111 se aplica como una constante y la categoría se aplica como especificó en la regla de categoría.
[ [ constant, const111 ], /, [ category] ]Debe tener cuidado al definir la regla del producto, porque cualquier uso de la categoría es como lo definido en la regla de la categoría. Por ejemplo, si especifica la regla de la categoría para resultar en /const222/electrónica/ y luego, use [ [ constante, const111 ], /, [ categoría] ] para definir una regla del producto, los resultados son los siguientes:
/const111/const222/electronics/008884303996.html Atributos de múltiples valores
Al configurar las reglas de SEO para generar las URL para productos, contenido, categorías y carpetas, puede especificar los atributos de múltiples valores usando los tipos Enum-of-String y Set-of-String en forma tal que sea similar a los atributos simple-valor. En el siguiente ejemplo, color es un atributo de producto enum-of-string.
[ [ category, [ attribute, displayName ] ], /, [ attribute, custom.color], /, [ attribute, name ] ] Todos los valores del atributo múltiple-valor se incluyen en la URL. Los valores se concatenan por un espacio en blanco o el carácter de reemplazo definido en blanco (por ejemplo, «-»). El valor para mostrar localizado se usa para los valores Enum, a menos que no se defina el valor para mostrar, en dicho caso se usa el valor.
Una URL de ejemplo, generada sobre la base de la regla anterior, es de la siguiente forma:
/mens-shoes/black-yellow/spring-sneaker/12345.html URL de categoría
Las URL del sitio de las Reglas de URL se pueden habilitar por páginas de categoría y los comerciantes pueden configurar los puntos de conexión de la URL de categoría en la pestaña URL de los catálogos de la página Reglas de URL.
Una URL de categoría estándar de B2C Commerce con todos los módulos de SEO deshabilitados tiene el siguiente formato:
www.sitegenesis.com/on/demandware.store/Sites-SiteGenesis-Site/default/Search-Show?cgid=mens-clothing-shorts.
Una URL de categoría con el módulo de Soporte de SEO en desuso habilitado sigue el siguiente formato:
www.sitegenesis.com/mens-clothing-shorts,default,sc.html Una URL de categoría con el módulo de Reglas de URL habilitado sigue el siguiente formato:
[ category-path, [ attribute, displayName ], - ] Esta regla muestra la ruta de la categoría y el nombre de visualización para la categoría, con un guion para el delimitador para los espacios en el nombre de la categoría:
www.sitegenesis.com/mens-clothing-shortsPara definir el contenido de una URL de categoría, puede combinar múltiples elementos y especificar los delimitadores entre los elementos.
[ [attribute_1], del , [attribute2], del , [attribute_3] ]La regla puede contener hasta cinco elementos. Los elementos de la categoría tienen cuatro tipos: atributos, constante, categoría-ruta, categoría-superior. (Consulte a continuación para obtener una especificación de cada uno de dichos tipos de elementos).
Ejemplos:
[ [constant, shop], / , [category-path, [attribute, ID], -] ]www.sitegenesis.com/shop/mens-clothing-shorts/ Si quisiera excluir determinadas categorías o carpetas de las URL, puede usar la sintaxis de categoría de exclusiones de rutas.
Una sintaxis simple de:
[ category-path, [attribute, displayName], /, [3,4]]tomará un árbol de categoría de marca > venta > hombres > zapatos > cuero y mostrará la URL como:
www.sitegenesis.com/brand/sale/leatherLa sintaxis está disponible para la configuración para los siguientes atributos de reglas de la URL:
- category-path
- category-path-with-offline
- folder-path
- folder-path-with-offline
Las siguientes opciones de configuración están disponibles para definir las URL de categoría:
Se proporciona una configuración para adjuntar opcionalmente una barra diagonal a las URL de categoría en la pestaña URL de los catálogos de la página Reglas de URL.
www.sitegenesis.com/mens-shorts (trailing slash off)www.sitegenesis.com/mens-shorts/ (trailing slash on) Si un sitio está localizado, existe una URL separada para cada configuración local del sitio, por ejemplo:
www.sitegenesis.com/en/mens-clothing-shortswww.sitegenesis.com/de/herren-kleidung-shortsPuede controlar cómo se especifica la configuración local para la URL en la pestaña Configuración de la página Reglas de URL. Puede establecer si sus sitios están localizados usando la página Configuraciones locales de preferencias globales.
El comportamiento de la generación de URL para las reglas usando una ruta de categoría generalmente saltea las categorías fuera de línea, que pueden tener como resultado categorías indicadas como en conflicto, incluso cuando realmente no lo están. Esto puede suceder cuando un comerciante necesita mantener las categorías fuera de línea hasta un evento específico. Generalmente, usan una estructura estándar para los nombres de las subcategorías dentro de cada categoría relacionada con el evento; por ejemplo, DíadelaMadre/venta, DíadeSanValentín/venta, Pascuas/venta.
Por ejemplo:
- La categoría A (fuera de línea) tiene una subcategoría
a-ventacon el nombre de visualizaciónVENTA. Cuando A cambia a en línea, la categoría a-venta tiene la URLa/venta. - La categoría B (fuera de línea) tiene una subcategoría
b-ventacon el nombre de visualizaciónVENTA. Cuando B cambia a en línea, la categoría b-venta tiene la URLb/venta.
Debido a que tanto A como B están fuera de línea, a-venta y b-venta tendrán la misma URL venta. Esto contamina el registro de conflictos de la URL con conflictos identificados incorrectamente, lo que hace difícil identificar los conflictos de URL genuinos.
Puede definir reglas que obtengan información de las categorías/carpetas fuera de línea, como se muestran en estos ejemplos.
[ category-path-with-offline, [ attribute, displayName ], / ]
[ category-parent-with-offline, [ attribute, displayName ], / ]
[ folder-path-with-offline, [ attribute, displayName ], / ]
[ folder-parent-with-offline, [ attribute, displayName ], / ]Por ejemplo la categoría venta está fuera de línea y esta es la taxonomía de la categoría:
host.com/sale/mens
host.com/mensCuando se reconocen las categorías fuera de línea, los resultados no están en conflicto: no se requiere una resolución de conflictos de la URL.
host.com/sale/mens
host.com/mensCuando no se reconocen las categorías fuera de línea, se producen conflictos, que se pueden manejar mediante la resolución de conflictos de la URL.
host.com/mens-1
host.com/mens-2 Sobre la base de la regla de la URL de categoría, B2C Commerce genera automáticamente URL de categoría. También puede definir el punto de conexión de la URL para cualquier categoría.
Por ejemplo, la siguiente regla:
[ attribute, displayName ]lleva a un conflicto para la categoría Venta en y y el generador de URL automáticamente adjunta un número de índice a las URL generadas: Puede anular las URL generadas para o . El atributo PageURL para la categoría se usa como el punto de conexión, en lugar del punto de conexión generado por la regla.
- URL generada de :
www.sitegenesis.com/ventas-1 - URL generada de :
www.sitegenesis.com/ventas-2
Ejemplo 1: Ventas de productos para hombres
Suponga que la URL generada de es:
www.sitegenesis.com/sales-1 Sin embargo, si establece el atributo PageURL de la categoría a hombres-ventas, la URL real de es:
www.sitegenesis.com/mens-sales Ejemplo 2: Ventas de productos para mujeres
Suponga que la URL generada de es:
www.sitegenesis.com/sales-2 Sin embargo, si completa el atributo PageURL para la categoría con mujeres-ventas, la URL real de es:
www.sitegenesis.com/womens-salesURL de los productos
Las URL se pueden habilitar para las páginas de productos. Los puntos de conexión de la URL de producto se configuran sobre la base de una sintaxis de regla simple.
Las URL de producto se habilitan usando una preferencia en Business Manager y se configuran en la pestaña URL de los catálogos de la página Reglas de URL. En el siguiente ejemplo, una URL de producto contiene su categoría, nombre e Identificación del producto. La Identificación del producto es obligatoria y se adjunta a cada URL de producto, junto con la extensión .html.
Regla de URL:
[ [category, /, [ attribute, name ] ]Ejemplo de URL:
www.sitegenesis.com/mens-clothing-shorts/straight-fit-shorts/8353682.html Puede configurar si el delimitador delante de la identificación del producto es «/» o «-». Si el delimitador es «-», pero el nombre de un producto contiene «-», B2C Commerce automáticamente usa el delimitador «/» para la URL de este producto. www.sitegenesis.com/crowne-shorts-marrón/83536828.html en lugar de www.sitegenesis.com/crowne-shorts-marrón-83536828.html
Para definir el contenido de una URL de producto, puede combinar múltiples elementos y especificar los delimitadores entre los elementos.
[ [attribute_1], del , [attribute2], del , [attribute_3] ] La regla puede contener hasta cinco elementos. Los elementos tienen dos tipos: atributos y categoría.
Las siguientes opciones de configuración están disponibles para definir los puntos de conexión de la URL de producto:
| Opción | Definición |
|---|---|
| categoría | Ejemplos: Para la siguiente regla, seleccione la casilla de verificación Usar «-» como separador de la Identificación del producto en lugar de «/». Si la casilla de verificación no está seleccionada, verá lo siguiente: |
| atributo | Este elemento se usa para incluir información de la categoría. Ejemplos: la URL de categoría según lo generado por el generador de URL de categoría (consulte la sección anterior). Esta regla se debe usar cuando se supone que la URL «muestre el producto en el contexto de la categoría». El nombre de visualización de la categoría. El nombre de la URL de la categoría y un atributo personalizado adicional de la categoría. |
| constante | Este elemento se usa para incluir un elemento de texto arbitrario. También puede usar la categoría con el elemento de la constante. |
B2C Commerce determina la categoría en la URL usando la siguiente lógica:
- Use la categoría principal del producto en el catálogo del storefront.
Si el producto no tiene una categoría principal asignada o la categoría principal no existe en el catálogo del storefront, pase al siguiente paso.
- Use la categoría de clasificación del producto en el catálogo del storefront.
Si el producto no tiene una categoría de clasificación asignada o la categoría de clasificación no existe en el catálogo del storefront, pase al siguiente paso.
- Use la primera categoría en el catálogo del storefront asignada al producto. El producto se debe asignar al menos a una categoría en el catálogo del storefront para estar disponible en el sitio.
Similar a las URL de categoría, puede anular las URL de producto generadas por el generador de URL al usar el atributo PageURL.
URL generada de producto: www.sitegenesis.com/deportes-zapato-rojo/1234.html
Atributo PageURL de producto: mckenzie-deportes-zapato
URL real de : www.sitegenesis.com/mckenzie-deportes-zapato/1234.html
URL de carpeta y contenido
La generación/definición de URL para carpetas y elementos de contenido funciona de la misma forma que las categorías y los productos. Consulte la página Reglas de URL, la página URL de contenidos en Business Manager para ver los ejemplos de la regla de URL de contenido.
Alias del pipeline
Todas las URL de la página, excepto páginas de productos, categorías y contenidos, muestran un pipeline en la URL. Para las páginas de pipeline, puede crear URL que no contengan /on/demandware.store al mapear un nombre de pipeline a un alias en Business Manager. Las URL de página de pipeline tienen un aspecto similar a:
www.sitegenesis.com/on/demandware.store/Sites-SiteGenesis-Site/default/Account-Showwww.sitegenesis.com/on/demandware.store/Sites-SiteGenesis-Site/default/Search-Show?q=shoesEn Business Manager, puede definir mapeos para cualquiera de sus pipelines.
| URL | Pipeline |
|---|---|
| cuenta | Cuenta-Mostrar |
| buscar | Buscar-Mostrar |
| lista de deseos | Wishlist-Show |
Si se activan las nuevas URL y se ha definido un mapeo para un pipeline, la URL cambia al siguiente formato:
www.sitegenesis.com/account
www.sitegenesis.com/search?q=shoesConfiguración regional
Controla si y cómo los identificadores de configuración local/idioma se presentan en todas las URL de Storefront, al seleccionar una opción de configuración local: Ninguno, Nombre de host, Parámetro de la URL o Ruta.
La opción Ninguno se usa si el sitio solo tiene un idioma de presentación. Las URL entrantes no son examinadas por el identificador de cualquier idioma. Todas las páginas se entregan en la configuración local por defecto del sitio. B2C Commerce supone que existe solo una configuración local del sitio permitida, pero si hay múltiples, se usa la que es por defecto. Las URL generadas no contendrán cualquier identificador de configuración local.
www.example.com/mens Para el Nombre de host, el idioma de presentación está determinado por el examen del nombre de host de la URL entrante. Debe configurar un mapeo entre los nombres de host y las configuraciones locales del sitio, por ejemplo, de.ejemplo.com - de_DE, www.ejemplo.com - en_US, es.ejemplo.com - es_US. Los nombres de host múltiples se pueden mapear a una configuración local. Si no existe un mapeo para un nombre de host, la página se entrega en la configuración local del sitio predeterminada.
www.example.com/mensde.example.com/mensPara el Parámetro de la URL, el idioma de presentación está determinado por el examen del parámetro de la URL estándar de la URL entrante. El nombre del parámetro por defecto es «configuración local», ?locale=en-US, y puede especificar otro nombre de parámetro de la cadena de consulta, como «idiom». Puede configurar un mapeo de un código de idioma para cualquier cadena personalizada para una configuración local de un sitio, por ejemplo, por defecto <> en_US, es <> es_US. Si no existe un mapeo, se supone que se especifica la identificación (ID) de la configuración local. Si la identificación de la configuración local no coincide con ninguna de las configuraciones locales del sitio permitidas, la página se entrega en la configuración local del sitio por defecto. Las URL generadas contienen el mismo parámetro de la URL como la URL entrante si el prefijo era válido o el prefijo definido para la configuración local por defecto del sitio si el prefijo no era válido. Puede definir el nombre del parámetro de la URL.
www.example.com/mens?locale=en-USde.example.com/mens?lang=enwww.example.com/mens?lang=spanishPara Ruta de acceso, el idioma de presentación está determinado por el examen del primer elemento en la ruta de la URL. Puede configurar un mapeo del código de idioma de la URL para una configuración local; por ejemplo, por defecto-> en_US, en -> en_US. Si no existe un mapeo, se supone que se especifica la identificación (ID) de la configuración local en la URL. Si la identificación de la configuración local no coincide con ninguna de las configuraciones locales del sitio permitidas, la página se entrega en la configuración local del sitio por defecto.
www.example.com/de/menswww.example.com/en/mens Defina una configuración local de ruta doble al especificar el primer valor, el carácter «/» y luego, el segundo valor. Por ejemplo, en/US o de/DE, lo que tiene como resultado lo siguiente:
www.example.com/en/US/menswww.example.com/de/DE/mens