Arquitectura de marco de estado

Importante

Toda la funcionalidad de la que se habla en este tema, o parte de ella, estará disponible como parte de una versión preliminar. El contenido y la funcionalidad están sujetos a cambios.

En este artículo se describe la arquitectura del marco de estado en Microsoft Dynamics 365 Intelligent Order Management.

La arquitectura del marco de estado es un nuevo concepto que se introdujo en Dynamics 365 Intelligent Order Management en la versión de octubre de 2022. El marco de estado es una forma de validar las reglas del proceso de negocio comprobando, en tiempo de ejecución, si el estado actual de una entidad puede pasar a otro estado. Por ejemplo, una transición de Nuevo a En curso tendrá éxito si se define, pero una transición de Terminado a En curso provocará un error.

Los usuarios pueden agregar sus propios estados, motivos de estado y transiciones. Sin embargo, no pueden personalizar las definiciones listas para usar.

Modelo de datos de marco de estado

El modelo de datos del marco de estado presenta algunas actualizaciones y nuevas incorporaciones al modelo de datos actual.

La siguiente ilustración muestra las tablas que se agregaron en el modelo de datos del marco de estado.

Actualiza el modelo de datos

Columnas Estado de la entidad y Motivo del estado

El marco de estado introduce dos nuevas columnas a las entidades que forman parte de Intelligent Order Management. Estas columnas se agregaron para admitir los campos de estado localizables de Estado y Motivo para el estado. El marco de estado también introduce un nuevo campo ReadOnly que indica que un registro no debe ser editable en la interfaz de usuario (UI).

Campo	Description
Estado	El estado en el que se encuentra la entidad, tal como lo define la tabla Definición de estado.
Motivo del estado	Una descripción detallada de la razón por la cual la entidad se encuentra en su estado actual.
ReadOnly	Establezca el valor en True si el registro no debe ser editable en la interfaz de usuario. De lo contrario, configúrelo en False.

Nuevas adiciones al modelo de datos

Tabla de definición de estado

La tabla Definición de estado permite la creación de un conjunto de estados que están permitidos en cada entidad. Estos estados tienen propiedades asociadas que contienen metadatos para indicar los diferentes comportamientos de cada estado.

Nota

Los estados se utilizan para determinar las transiciones válidas como parte del proceso de orquestación.

Campo	Description
Definición de estado	El identificador único global (GUID) del estado.
Entidad asociada	La entidad a la que pertenece el estado.
Detalles	El nombre del estado.
Propiedades de definición de estado	Una búsqueda de metadatos asociados.
Solo lectura	Un valor True marca la entidad como de solo lectura.

Tabla de razón para la definición de estado

La tabla Razón para la definición de estado proporciona detalles adicionales sobre por qué algo está en un estado determinado, pero podría no ser parte de la indicación de una transición de estado válida. Por ejemplo, algo puede tener un estado de En espera, pero una razón para el estado de Pedido pendiente o Pedido previo.

Campo	Description
Razón para la definición de estado	El GUID de la razón para el estado.
Estado	El estaddo con el que está asociado la razón para el estado.
Detalles	El nombre o la descripción de la razón para el estado.

Tabla de propiedades de definición de estado

La tabla de Propiedades de definición de estado contiene metadatos adicionales para cada estado.

Campo	Description
Propiedades de definición de estado	El GUID de la propiedad.
Posición de escala de tiempo	El orden en que se debe mostrar el estado en el control Escala de tiempo de la barra de progreso en la interfaz de usuario. (Este control se introdujo en la versión de octubre de 2022).

Tabla de transición de estado

La tabla Transición de estado contiene una lista de transiciones de estado que se producirán cuando se genere un evento de negocio. El evento de negocio establecerá el estado solo si el estado actual es un estado permitido.

Campo	Description
Transición de estado	El GUID de la transición de estado.
Definición del evento de negocio	Una búsqueda a la tabla Definición de evento de negocio para determinar a qué evento de negocio pertenece el registro.
Estado de origen	El estado de origen permitido para la transición.
Estado de destino	El estado de destino para establecer si el estado está en transición desde un estado de origen permitido.
Motivo de estado de destino	La razón de estado de destino para establecer si el estado está en transición desde un estado de origen permitido.

En la tabla siguiente se muestra un ejemplo de datos en esta tabla.

Definición del evento de negocio	Estado de origen	Estado de destino	Motivo de estado de destino
Éxito en la comprobación de disponibilidad	En proceso	Proceso de entrega en curso	Éxito en la comprobación de inventario
Éxito en la comprobación de disponibilidad	En espera	Proceso de entrega en curso	Éxito en la comprobación de inventario
Error en la comprobación de disponibilidad	En proceso	En espera	Retención de pedido pendiente

Situaciones

No existe ninguna transición para el evento de negocio.

Si no se encuentra ningún registro en la tabla Transición de estado para el evento de negocio que se está generando, la validación se realizará correctamente automáticamente, pero no se establecerá ningún valor de Estado o Motivo para el estado.

Agregar un nuevo estado y transición

Para agregar un nuevo estado y transición, siga estos pasos.

1. Agregue una nueva definición de estado.

2. Agregue un nuevo motivo de definición de estado, si es necesario.

3. Agregue una nueva transición de estado y, luego, siga estos pasos:

   1. Asocie la transición del nuevo estado con un nuevo evento de negocio.
   2. Seleccione el campo Origen a lo que está permitido. Agregue una fila por origen permitido.
   3. Establezca el campo Estado en el que se debe establecer el estado cuando se genera el evento de negocio.
   4. Establezca el campo Motivo para el estado al motivo que quiere que aparezca cuando se genere el evento de negocio.

4. Agregue cualquier propiedad (ReadOnly o Timeline) que se requiera.