Channels and publish readiness
Canales y aptitud para publicar
A channel is a place where your products are shown: a web shop, a marketplace, a printed catalogue. Here you register your channels, define how product data is adapted for each one, preview the result and see how many products have blockers.
Un canal es un lugar donde se muestran tus productos: una tienda web, un marketplace, un catálogo impreso. Acá registrás tus canales, definís cómo se adaptan los datos para cada uno, ves cómo queda y cuántos productos tienen bloqueos.
Create a channel
Crear un canal
- Go to Products → Publishing → Channels and press New Channel.
- Type the Code (for example WEB_MAIN). It cannot be changed later.
- Type the Name.
- Choose the Channel Type: ECOMMERCE, MARKETPLACE, PRINT, POS or FEED.
- Press Create. The channel is created active.
- Entrá a Productos → Publicación → Canales y tocá el botón para crear un canal (Nuevo Channel).
- Escribí el Código (por ejemplo WEB_MAIN). No se puede cambiar después.
- Escribí el Nombre.
- Elegí el Tipo de canal: ECOMMERCE, MARKETPLACE, PRINT, POS o FEED.
- Tocá Crear. El canal se crea activo.
Edit, in the three-dot menu of the row or on the channel page, lets you change the name and the type, and untick Active to stop using the channel without deleting it. Delete removes it and cannot be undone.
Editar, en el menú de tres puntos de la fila o en la página del canal, te deja cambiar el nombre y el tipo, y destildar Activo para dejar de usar el canal sin borrarlo. Eliminar lo quita y no se puede deshacer.
Adapt the data for a channel
Adaptar los datos para un canal
Each channel may need the data in its own shape: a field with another name, or a value written differently. Open the channel and go to the Transformations tab.
Cada canal puede necesitar los datos con su propia forma: un campo con otro nombre, o un valor escrito de otra manera. Abrí el canal y andá a la pestaña Transformaciones.
- Press Add Rule.
- Choose the Rule Type (see the table below).
- Type the Source Field: the name of the field as the system has it. Run a preview first to read the exact names.
- Type the Target Field when the rule needs it.
- Fill in Configuration JSON when the rule needs it.
- Set the Sort Order. Rules are applied from the lowest number up.
- Press Create.
- Tocá Agregar regla.
- Elegí el Tipo de regla (mirá la tabla de abajo).
- Escribí el Campo de origen: el nombre del campo tal como lo tiene el sistema. Hacé primero una vista previa para leer los nombres exactos.
- Escribí el Campo de destino cuando la regla lo necesita.
- Completá JSON de configuración cuando la regla lo necesita.
- Poné el Orden de clasificación. Las reglas se aplican del número más bajo al más alto.
- Tocá Crear.
| Rule type | What it does | What it needs |
|---|---|---|
| Field Map | Renames a field: the value of the source field is delivered under the name of the target field. | Source field and target field. The configuration is not used. |
| Enum Map | Replaces a value by another one, for example a status code by the word the channel expects. | Source field and a configuration with the pairs, written as {"mappings": {"ACTIVE": "available"}}. |
| Tipo de regla | Qué hace | Qué necesita |
|---|---|---|
| Mapa de campos | Cambia el nombre de un campo: el valor del campo de origen se entrega con el nombre del campo de destino. | Campo de origen y campo de destino. La configuración no se usa. |
| Mapa de ENUM | Reemplaza un valor por otro, por ejemplo un código de estado por la palabra que espera el canal. | Campo de origen y una configuración con los pares, escrita como {"mappings": {"ACTIVE": "available"}}. |
Preview a product in a channel
Ver cómo queda un producto en un canal
- Open the channel and go to the Preview tab.
- Choose a product in Select Product Family. The list offers the first 200 products.
- Press Preview. A message says how many rules were applied, and a table shows each field with its Original value and its Transformed value. The values that changed are highlighted.
- Abrí el canal y andá a la pestaña Vista Previa.
- Elegí un producto en Seleccionar familia de productos. La lista ofrece los primeros 200 productos.
- Tocá Preview. Un mensaje dice cuántas reglas se aplicaron, y una tabla muestra cada campo con su valor Original y su valor Transformado. Los valores que cambiaron quedan resaltados.
The Field column of that table is where you read the field names to use in the rules. Attributes appear with the prefix attr_ followed by the attribute code.
La columna Campo de esa tabla es donde leés los nombres de campo para usar en las reglas. Los atributos aparecen con el prefijo attr_ seguido del código del atributo.
See how many products have blockers
Ver cuántos productos tienen bloqueos
Products → Publishing → Readiness opens Publish Readiness Dashboard. It examines up to 100 products that are not archived and counts how many have a blocker.
Productos → Publicación → Aptitud abre Panel de preparación para publicación. Examina hasta 100 productos que no estén archivados y cuenta cuántos tienen un bloqueo.
| Figure | What it counts |
|---|---|
| Total Products | Products examined. |
| Ready to Publish | Products without blockers, and the percentage they represent. |
| Blocked | Products with at least one blocker. |
| Blocker Breakdown | How many products each blocker affects. |
| Cifra | Qué cuenta |
|---|---|
| Total de productos | Productos examinados. |
| Listos para publicar | Productos sin bloqueos, y el porcentaje que representan. |
| Bloqueados | Productos con al menos un bloqueo. |
| Detalle de bloqueos | A cuántos productos afecta cada bloqueo. |
| Blocker | What it means | How to solve it |
|---|---|---|
| Mandatory Attributes | The category of the product requires attributes that are empty. | Open the product and use Fix in the Mandatory attributes block. |
| LICENSE_EXPIRY | An image or file linked to the product has an expired licence. | Renew the licence of the file, or unlink it from the product. |
| Bloqueo | Qué significa | Cómo se resuelve |
|---|---|---|
| Mandatory Attributes | La categoría del producto exige atributos que están vacíos. | Abrí el producto y usá Resolver en el bloque Atributos obligatorios. |
| LICENSE_EXPIRY | Una imagen o archivo vinculado al producto tiene la licencia vencida. | Renová la licencia del archivo, o desvinculalo del producto. |
What does not send products anywhere yet
Lo que todavía no envía productos a ningún lado
- Publish Jobs: the Trigger Job form does not start a publication. No product data leaves the system from this screen.
- Schedules: a schedule can be saved, paused and deleted, but it is never run.
- Snapshots and Publish Analytics: they stay empty, because they are fed by publish jobs.
- Trabajos de Publicación: el formulario Disparar Job no inicia una publicación. Desde esta pantalla no sale ningún dato de producto del sistema.
- Programaciones: una programación se puede guardar, pausar y eliminar, pero nunca se ejecuta.
- Instantáneas y Analítica de Publicación: quedan vacías, porque se alimentan de los trabajos de publicación.
Common issues
Problemas habituales
- The preview says "No transformation rules applied — product data passes through unchanged."
- The channel has no rules, so the product is delivered as it is. The text appears in English.
- My Field Map rule changed nothing
- The source field name does not match any field of the product, or the target field is empty. Copy the name from the Field column of the preview.
- My Enum Map rule changed nothing
- The configuration has to be valid JSON with the pairs inside "mappings", and the left side has to be exactly the current value of the field, with the same capital letters.
- The product I want is not in the preview list
- The list offers only the first 200 products.
- Readiness shows fewer products than I have
- The panel examines up to 100 products.
- The search box in Channels does nothing
- The search boxes of Channels, Publish Jobs, Schedules and Snapshots do not filter the list yet.
- La vista previa dice «No transformation rules applied — product data passes through unchanged.»
- El canal no tiene reglas, así que el producto se entrega tal cual. El texto aparece en inglés.
- Mi regla de Mapa de campos no cambió nada
- El nombre del campo de origen no coincide con ningún campo del producto, o el campo de destino está vacío. Copiá el nombre de la columna Campo de la vista previa.
- Mi regla de Mapa de ENUM no cambió nada
- La configuración tiene que ser un JSON válido con los pares dentro de "mappings", y el lado izquierdo tiene que ser exactamente el valor actual del campo, con las mismas mayúsculas.
- El producto que quiero no está en la lista de la vista previa
- La lista ofrece solo los primeros 200 productos.
- Aptitud muestra menos productos de los que tengo
- El panel examina hasta 100 productos.
- El buscador de Canales no hace nada
- Los buscadores de Canales, Trabajos de Publicación, Programaciones e Instantáneas todavía no filtran la lista.