Skip to main content

Sincronización de catálogos generales hacia Alpura One

Este documento describe la arquitectura, estructura de datos y el modelo de sincronización para los catálogos operativos del sistema Alpura 9 en la base de datos Omnicanal, partiendo desde los catálogos generales replicados de Oracle Cloud.


1. Objetivo​

Implementar un mecanismo de sincronización entre los catálogos generales almacenados en Omnicanal, dentro del esquema general_catalogs, y las tablas de catálogos utilizadas por Alpura 9, ubicadas en el esquema alpura_one.

La sincronización permite mantener actualizada la información de los catálogos de Alpura 9 a partir de los datos centralizados en general_catalogs, evitando duplicar procesos de extracción y transformación que ya se encuentran implementados en la arquitectura de réplica de Oracle Cloud hacia Databricks y Omnicanal.

El mecanismo utiliza triggers de PostgreSQL para propagar los cambios en los catálogos de origen hacia sus respectivas tablas destino.

Adicionalmente, se cuenta con un proceso programado mediante pg_cron para actualizar la vigencia de los valores de los catálogos Flexfields, considerando sus fechas de inicio y fin de vigencia.


2. Arquitectura de sincronización​

El flujo inicia a partir de la información previamente cargada en general_catalogs.

Desde este esquema se ejecutan tres mecanismos de sincronización independientes, responsables de mantener actualizados los catálogos correspondientes en alpura_one.

Los procesos contemplados son:

ProcesoEsquema origenEsquema destinoDescripción
Sincronización de almacenesgeneral_catalogsalpura_oneSincroniza los almacenes habilitados para Alpura One.
Sincronización de artículosgeneral_catalogsalpura_oneSincroniza la información de los artículos y sus atributos.
Sincronización de Flexfieldsgeneral_catalogsalpura_oneSincroniza los valores de los catálogos configurados mediante Flexfields.
Información

Cada proceso utiliza mecanismos de PostgreSQL para propagar los cambios hacia las tablas destino correspondientes.


3. Diagrama de Flujo​


4. Sincronizaciones​


4.1. Almacenes​

Origen: general_catalogs.alp_cat_inv_almacenes

Destino: alpura_one.alp_one_cat_almacenes

Este proceso permite sincronizar la información de los almacenes disponibles en el catálogo general hacia la estructura utilizada por Alpura One.

Consideraciones de funcionamiento:

  • Se identifican los almacenes que tienen habilitado el indicador manufacture_flag = 'Y'.
  • Se insertan los nuevos registros que cumplen con la condición establecida.
  • Se actualizan los registros existentes cuando se presentan cambios en la información.
  • Cuando un almacén deja de cumplir con la condición de manufactura, se actualiza su indicador correspondiente en el catálogo destino a N, sin eliminar físicamente el registro.
  • Se conserva la identificación del almacén mediante organization_id, correspondiente al campo org_id en la tabla destino.

La sincronización se implementa mediante la función: general_catalogs.fn_sync_alp_one_cat_almacenes()


4.1.1. Objetos Almacenes​

CampoTipo de datoDescripción
legal_entity_idnumeric(18)Identificador de la entidad legal a la que pertenece el almacén.
business_unit_idnumeric(18)Identificador de la unidad de negocio asociada al almacén.
org_idPK / numeric(18)Identificador único de la organización o almacén. Se utiliza como clave única del registro.
legal_entitytextNombre de la entidad legal asociada.
legal_entity_identifiertextIdentificador o código de la entidad legal.
business_unittextNombre de la unidad de negocio.
org_codetextCódigo de identificación del almacén.
org_nametextNombre descriptivo del almacén.
dn_activoboolIndicador que determina si el almacén se encuentra activo para su utilización en Alpura One.
dn_usuario_creadorvarchar(200)Usuario responsable de la creación del registro.
dd_fecha_creaciontimestamptzFecha y hora de creación del registro.
dn_usuario_modificadorvarchar(200)Usuario responsable de la última modificación del registro.
dd_fecha_modificaciontimestamptzFecha y hora de la última modificación del registro.

4.2. Artículos​

Origen: general_catalogs.alp_cat_inv_items.

Destino: alpura_one.alp_one_cat_articulos

Este proceso permite mantener disponible en Alpura 9 la información general de los artículos, incluyendo sus atributos y unidades de conversión.

Dentro de la transformación de datos se consideran los campos de cantidades y equivalencias que deben manejarse como valores numéricos enteros.

Los atributos de cantidades que requieren conversión contemplan:

  • cantidad_estandar
  • cajas_por_cama
  • cajas_por_tarima
  • camas_por_tarima
  • piezas_por_caja
  • piezas_por_tarima
info

Los valores que no representan cantidades numéricas válidas se normalizan a 0, evitando errores de conversión durante la sincronización.


4.2.1. Objetos Almacenes​

CampoTipo de datoDescripción
item_idPK / numeric(18)Identificador único del artículo en el sistema origen.
org_idPK / numeric(18)Identificador de la organización a la que pertenece el artículo.
item_codetextCódigo del artículo.
item_code_400textCódigo alternativo del artículo de 400 caracteres o formato relacionado.
itemtextDescripción o nombre del artículo.
tipo_de_productotextTipo o clasificación del producto.
vida_de_anaquelnumeric(10)Vida de anaquel del producto.
areatextÁrea asociada al artículo.
primary_uom_codetextCódigo de la unidad de medida principal.
primary_uomtextDescripción de la unidad de medida principal.
cantidad_estandarint4Cantidad estándar definida para el artículo.
cajas_por_camaint4Número de cajas por cama de tarima.
cajas_por_tarimaint4Número de cajas por tarima.
camas_por_tarimaint4Número de camas por tarima.
piezas_por_cajaint4Número de piezas contenidas en una caja.
piezas_por_tarimaint4Número de piezas contenidas en una tarima.
tipo_de_tarimatextTipo de tarima utilizado para el artículo.
skutextSKU del artículo.
sku_cajatextSKU correspondiente a la presentación de caja.
sku_tarimatextSKU correspondiente a la presentación de tarima.
sku_charolatextSKU correspondiente a la presentación de charola.
manufactura_costfloat8Costo de manufactura del artículo.
manufactura_uom_codetextCódigo de la unidad de medida asociada al costo de manufactura.
manufactura_currencytextMoneda en la que se expresa el costo de manufactura.
nombre_estructuratextNombre de la estructura asociada al artículo.
nombre_procesotextNombre del proceso de manufactura asociado al artículo.
dn_activoboolIndica si el registro se encuentra activo.
dn_usuario_creadorvarchar(200)Usuario que creó el registro.
dd_fecha_creaciontimestamptzFecha y hora de creación del registro. Por defecto utiliza CURRENT_TIMESTAMP.
dn_usuario_modificadorvarchar(200)Usuario que realizó la última modificación.
dd_fecha_modificaciontimestamptzFecha y hora de la última modificación.

4.3. Sincronización de catálogos Flexfields​

Origen: general_catalogs.alp_cat_fnd_flex_fields

Destino: Esquema alpura_one, mediante las tablas correspondientes a cada catálogo.

Este proceso permite integrar los valores configurados en Oracle Fusion mediante Flexfields hacia las estructuras de catálogos utilizadas por Alpura One.

La sincronización utiliza una función parametrizada que identifica el catálogo destino y realiza la operación correspondiente.

Función de sincronización: general_catalogs.fn_sync_alp_one_cat_flexs()

note

La función utiliza el parámetro TG_ARGV[0] para identificar la tabla destino y realizar la sincronización de los registros.


4.3.1. Mapeo de catálogos​

Flexfield de origenTabla destino
ALP_AREASalp_one_cat_areas
ALP_MFG_DECISIONalp_one_cat_mfg_decisiones
ALP_MFG_ORIGENalp_one_cat_mfg_origenes
ALP_ORIGENalp_one_cat_origenes
Nombre compuesto de equiposalp_one_cat_equipos
Tipo de ordenalp_one_cat_tipo_orden

4.3.2. Transformación de información​

Durante la sincronización se realiza el mapeo de los atributos del catálogo general hacia la estructura de Alpura One:

Campo origenCampo destinoDescripción
flex_value_ididIdentificador del valor del catálogo.
valuecodigoCódigo del valor del catálogo.
descriptiondescripcionDescripción del valor.
enabled_flag y fechas de vigenciadn_activoIndicador de actividad del registro.
note

El indicador dn_activo se determina considerando que el valor esté habilitado y que la fecha actual se encuentre dentro de su periodo de vigencia.

info

La sincronización contempla operaciones de inserción y actualización mediante la llave de identificación id. No se realiza la eliminación física de registros del catálogo destino.


4.3.3. Objetos Flex Fields​

  • FlexField ALP_AREAS
CampoTipo de datoDescripción
idPK / int8Llave primaria del catálogo.
codigotextCódigo que identifica el área dentro del catálogo.
descripciontextDescripción o nombre del área.
dn_activoboolIndica si el área se encuentra activa (TRUE) o inactiva (FALSE).
  • FlexField ALP_MFG_DECISION
CampoTipo de datoDescripción
idPK / int8Llave primaria del catálogo.
codigotextCódigo que identifica de los MFG decisiones.
descripciontextDescripción o nombre del MFG decisiones.
dn_activoboolIndica si el área se encuentra activa (TRUE) o inactiva (FALSE).
  • FlexField ALP_MFG_ORIGEN
CampoTipo de datoDescripción
idPK / int8Llave primaria del catálogo.
codigotextCódigo que identifica de los MFG origenes.
descripciontextDescripción o nombre de los MFG origenes.
dn_activoboolIndica si el área se encuentra activa (TRUE) o inactiva (FALSE).
  • FlexField ALP_ORIGEN
CampoTipo de datoDescripción
idPK / int8Llave primaria del catálogo.
codigotextCódigo que identifica de los origenes.
descripciontextDescripción o nombre de los origenes.
dn_activoboolIndica si el área se encuentra activa (TRUE) o inactiva (FALSE).
  • FlexField Nombre compuesto de equipos
CampoTipo de datoDescripción
idPK / int8Llave primaria del catálogo.
codigotextCódigo que identifica los nombres compuesto de equipos.
descripciontextDescripción del nombre compuesto de los equipos.
dn_activoboolIndica si el área se encuentra activa (TRUE) o inactiva (FALSE).
  • FlexField Tipo de orden
CampoTipo de datoDescripción
idPK / int8Llave primaria del catálogo.
codigotextCódigo que identificación de los Tipos de Datos.
descripciontextDescripción o nombre de los Tipos de Datos.
dn_activoboolIndica si el área se encuentra activa (TRUE) o inactiva (FALSE).

4.4. Actualización automática de vigencia de catálogos​

Además de la sincronización mediante triggers, se implementa un proceso programado para actualizar el estado de vigencia de los catálogos de Alpura One.

Este mecanismo es necesario porque la vigencia de un registro puede cambiar únicamente por el transcurso del tiempo, sin que exista una inserción o actualización en el catálogo general de origen.

Función ejecutada: alpura_one.fn_actualizar_vigencia_catalogos()

Programación mediante pg_cron:

ParámetroConfiguración
Nombre del Jobalpura-one-vigencia-catalogos
FrecuenciaDiaria
Hora de ejecución12:05
Zona horariaHora de México
Motor de programaciónpg_cron

La función revisa las fechas de vigencia de los registros y actualiza el indicador de actividad (dn_activo) de los catálogos correspondientes.

Con esto se garantiza que los valores de los catálogos reflejen su vigencia actual, incluso cuando no se produzcan cambios en los registros de origen.

5. Consideraciones técnicas​

  • La base de datos omnicanal centraliza tanto los catálogos generales como los catálogos utilizados por Alpura One.
  • El esquema general_catalogs funciona como origen de información para los procesos de sincronización.
  • El esquema alpura_one contiene las estructuras de datos utilizadas directamente por la aplicación.
  • Los triggers permiten propagar los cambios de los catálogos de origen sin requerir una ejecución manual de los procesos.
  • La sincronización contempla inserciones y actualizaciones; no se considera la eliminación física de los registros como mecanismo de depuración.
  • La actualización de vigencia de FlexFields se ejecuta de forma independiente mediante pg_cron.

6. Resultado esperado​

Al finalizar la implementación, Alpura One dispone de catálogos sincronizados a partir de la información centralizada en general_catalogs.

La arquitectura permite mantener separados los procesos de réplica de información desde Oracle Cloud y los procesos de integración interna de Omnicanal, facilitando el mantenimiento, la trazabilidad y la incorporación de nuevos catálogos.

Flujo de integración: general_catalogs → Triggers general_catalogs → alpura_one

Adicionalmente: pg_cron → alpura_one.fn_actualizar_vigencia_catalogos()