Programador de valores¶

La aplicación eYssen Value Scheduler (value_scheduler) cambia el valor de un campo en muchos registros a la vez, a partir de un archivo CSV o Excel de dos columnas, ya sea de inmediato o en una fecha y hora elegidas con antelación. Ejemplos típicos son las etiquetas de lista de precios que deben cambiarse al inicio de una promoción, o los atributos de producto que deben actualizarse para todo un catálogo de proveedor durante la noche.

Cada operación se basa en un preajuste, preparado una sola vez por un administrador, que define el modelo y el campo a actualizar y cómo se encuentran los registros. Los usuarios entonces solo tienen que subir un archivo.

Nota

La aplicación requiere el módulo Price List Validation by Tags (eyssen_product_pricelist_tag), que se instala junto con ella.

Permisos de acceso¶

En los permisos de acceso de un usuario, la categoría Programador de valores tiene dos niveles:

Programador: puede abrir la aplicación, y crear, procesar, programar y cancelar importaciones con los preajustes existentes;
Administrador: además, tiene acceso al menú Desarrollador: el Editor de preajustes y la lista de Todos los cambios programados.

Importar un archivo¶

Abra la aplicación Programador de valores y, en el menú Operaciones, haga clic en la operación que desea realizar (p. ej., Actualización de etiquetas de lista de precios). Se muestra la lista de las importaciones anteriores de esa operación.
Haga clic en Nuevo y suba el archivo en el campo Archivo.
Seleccione el Modo de ejecución:
- Programado: los cambios se aplican en la Fecha programada, que pasa a ser obligatoria;
- Instantáneo: los cambios se aplican en cuanto se procesa el archivo. Este modo está limitado a 25 cambios por importación.
Seleccione el Modo de escritura:
- Sobrescribir: el valor del archivo remplaza el valor actual del campo. En un campo de etiquetas, si la segunda columna está vacía, el campo se vacía;
- Extender: en un campo de etiquetas, los valores del archivo se añaden a los existentes;
- Eliminar: en un campo de etiquetas, los valores del archivo se eliminan de los existentes. Marque Borrar todo para vaciar el campo en su lugar, sin importar el contenido de la segunda columna. Para cualquier otro campo, el campo se vacía.
Haga clic en Procesar. El archivo se lee, se crea un cambio programado por cada fila y el archivo se adjunta al chatter de la importación. Si una fila no se puede interpretar (por ejemplo, un nombre de etiqueta desconocido), se rechaza el archivo completo y el mensaje indica las filas que se deben corregir.

En el modo Programado, la importación y sus cambios pasan al estado Programado. En el modo Instantáneo, los cambios se ejecutan de inmediato y la importación pasa a Hecho.

screenshot: general-value-scheduler-import-form

menu: Value Scheduler ‣ Operations ‣ Pricelist Tag Update ‣ New
shows: A draft import form with the Process button, the uploaded file, Run Mode "Timed" with a scheduled date, and Write Mode "Extend".
highlight: The "Run Mode" and "Write Mode" radio buttons (red frame).
data: File "promo_tags_week40.csv"; scheduled date next Monday 00:00.
module: value_scheduler
notes: English UI, light theme, 1440px width.

Formato del archivo¶

El archivo es un archivo CSV (separador ;, codificación UTF-8 o Latin-1) o un libro de Excel (.xlsx), del que solo se lee la primera hoja. La primera fila es un encabezado y se ignora. Cada fila siguiente tiene dos columnas:

el valor de búsqueda, que se usa para encontrar el o los registros que se deben actualizar. El campo con el que se compara lo define el preajuste (por ejemplo, la referencia interna del producto). Las filas con la primera columna vacía se omiten;
el nuevo valor. Su interpretación depende del preajuste; para el preajuste Actualización de etiquetas de tarifa, es una lista de nombres de etiquetas de tarifa separados por comas (no distingue mayúsculas de minúsculas).

reference;tags
FURN_0096;Promo week 40, Wholesale
FURN_1118;Promo week 40

Advertencia

No use apóstrofos (') en los valores de búsqueda: esas filas no se podrán emparejar.

Seguimiento y cancelación de una importación¶

Los cambios programados se aplican mediante la acción programada Programador de valores: procesar cambios programados, que se ejecuta cada cinco minutos y procesa los cambios pendientes en lotes de 25 hasta que no quede ninguno. Por lo tanto, un cambio se aplica pocos minutos después de su Fecha programada.

En la importación, el botón inteligente Cambios y la pestaña Cambios programados muestran los cambios con su valor de Búsqueda, el Modificador (el valor del archivo) y, una vez ejecutados, el Valor anterior y el Resultado. Haga clic en el icono de una línea para abrir los registros correspondientes. El estado de un cambio es uno de los siguientes:

Borrador: creado, aún no está en cola;
Programado: en espera de su fecha;
Hecho: el valor se cambió;
Sin cambios: los registros ya tenían el valor solicitado;
Fallido: el cambio no se pudo aplicar; el motivo se indica en la pestaña Notas del cambio (por ejemplo, no se encontró ningún registro para el valor de búsqueda).

Una importación está en Hecho cuando todos sus cambios se procesaron sin errores, y en Fallido si al menos uno de ellos falló.

Los siguientes botones están disponibles en la importación:

Cancelar: en una importación Programado de la que aún no se ha ejecutado ningún cambio, mueve la importación a Cancelado; sus cambios vuelven a Borrador y no se aplican;
Restablecer a borrador: hace que la importación regrese a Borrador, junto con sus cambios programados y fallidos, por ejemplo, para modificar la fecha programada;
Programar: en una importación en borrador que ya tiene cambios, los vuelve a poner en cola sin leer el archivo por segunda vez.

Solo se pueden eliminar las importaciones en borrador.

Nota

En el modo Instantáneo, se publica una nota de Programador de valores en el chatter de cada registro actualizado, con el valor anterior, el valor del archivo y el valor resultante. Los cambios aplicados por la acción programada no publican dicha nota, y el seguimiento habitual de campos está deshabilitado en ambos modos: use las columnas Valor anterior y Resultado de la importación como registro de auditoría.

Preajustes¶

Los administradores de la aplicación gestionan los preajustes en Programador de valores ‣ Desarrollador ‣ Editor de preajustes. Un preajuste se define por:

Nombre y Nombre del menú, la etiqueta de su entrada en el menú Operaciones;
Modelo objetivo y Campo objetivo: el modelo y el campo que se van a actualizar;
Campo de búsqueda de dominio: el nombre técnico del campo del modelo objetivo que se compara con la primera columna del archivo;
Código: de forma opcional, código Python que convierte las filas del archivo en cambios, por ejemplo, para convertir nombres de etiquetas en registros e informar de los nombres desconocidos. Sin código, la segunda columna se escribe tal cual, lo que es adecuado para campos de texto y número.

Haga clic en Instalar para crear la entrada del preajuste en el menú Operaciones, y en Desinstalar para eliminarla. El botón inteligente Importaciones muestra las importaciones realizadas con el preajuste.

La aplicación se entrega con un preajuste, Actualización de etiquetas de tarifa, que actualiza las Etiquetas de tarifa de los productos.

Importante

El preajuste Actualización de etiquetas de tarifa se entrega con master_article_number como Campo de búsqueda de dominio. Este campo no forma parte del formulario estándar de producto: antes de instalar el preajuste, remplácelo por el campo que identifica sus productos en el archivo, por ejemplo, default_code (referencia interna) o barcode.
El código de un preajuste se ejecuta en el servidor. Solo se debe otorgar el nivel Administrador a administradores de confianza.

Programador de valores ‣ Desarrollador ‣ Todos los cambios programados muestra los cambios de todas las importaciones, con filtros por estado y agrupación por importación, modelo y fecha programada.

screenshot: general-value-scheduler-preset

menu: Value Scheduler ‣ Developer ‣ Preset Editor ‣ Pricelist Tag Update
shows: The preset form with the Install button, the Configuration group (name, menu name, sequence), the Target group (Target Model "Product", Target Field "Pricelist Tags", Domain Lookup Field) and the Row Processing Code editor.
highlight: The "Domain Lookup Field" (red frame).
data: Domain Lookup Field set to "default_code".
module: value_scheduler
notes: English UI, light theme, 1440px width.

Ver también