Arquitetura de estrutura de estado

Importante

Alguma ou todas as funcionalidades observadas neste tópico estão disponíveis como parte de uma versão preliminar. O conteúdo e a funcionalidade estão sujeitos a alterações.

Este artigo descreve a arquitetura da estrutura de estado no Microsoft Dynamics 365 Intelligent Order Management.

A arquitetura de estrutura de estado é um novo conceito que foi introduzido no Dynamics 365 Intelligent Order Management na versão de outubro de 2022. A estrutura de estado é uma forma de validar as regras do processo de negócios verificando, no tempo de execução, se o estado atual de uma entidade pode se mover para outro estado. Por exemplo, uma transição de Novo a Em andamento terá sucesso se for definida, mas uma transição de Concluído a Em andamento gerará um erro.

Os usuários podem adicionar seus próprios estados, motivos de estado e transições. Contudo, eles não podem personalizar as definições prontas para uso.

Modelo de dados da estrutura de estado

O modelo de dados da estrutura de estado apresenta algumas atualizações e novas adições ao modelo de dados atual.

A ilustração a seguir mostra as tabelas que foram incluídas no modelo de dados da estrutura de estado.

Atualizações no modelo de dados

Colunas Estado da Entidade e Razão do Estado

A estrutura de estado apresenta duas novas colunas para as entidades que fazem parte do Intelligent Order Management. Essas colunas foram adicionadas para oferecer suporte a campos de status localizáveis Estado e Razão do Estado. A estrutura de estado também apresenta um novo campo Somente Leitura que indica que um registro não deve ser editável na interface do usuário (IU).

Campo	descrição
Estado	O estado em que a entidade está, conforme definido pela tabela Definição de Estado.
Razão do Estado	Uma descrição detalhada do motivo pelo qual a entidade está em seu estado atual.
Somente Leitura	Defina o valor como Verdadeiro se o registro não puder ser editado na IU. Caso contrário, defina-a como Falso.

Novas adições ao modelo de dados

Tabela Definição de Estado

A tabela Definição de Estado permite a criação de um conjunto de estados que são permitidos em cada entidade. Esses estados possuem propriedades associadas que contêm metadados para indicar os diferentes comportamentos de cada estado.

Observação

Os estados são usados para determinar transições válidas como parte da jornada de orquestração.

Campo	descrição
Definição de Estado	O identificador global exclusivo (GUID) do estado.
Entidade Associada	A entidade à qual o estado pertence.
Detalhes	O nome do estado.
Propriedades de Definição de Estado	Uma pesquisa de metadados associados.
Readonly	Um valor Verdadeiro marca a entidade como somente leitura.

Tabela Motivo de Definição de Estado

A tabela Motivo de Definição de Estado fornece detalhes extras sobre por que algo está em determinado estado, mas pode não fazer parte da indicação de uma transição de estado válida. Por exemplo, algo pode ter um estado de Em Espera, mas uma razão de estado de Ordem pendente ou Pré-ordem.

Campo	descrição
Motivo de Definição de Estado	O GUID do motivo do estado.
Estado	O estado ao qual o motivo do estado está associado.
Detalhes	O nome/descrição do motivo do estado.

Tabela Propriedades de Definição de Estado

A tabela Propriedades de Definição de Estado contém metadados extras para cada estado.

Campo	descrição
Propriedades de Definição de Estado	O GUID da propriedade.
Posição na Linha do Tempo	A ordem na qual o estado deve ser mostrado no controle Linha do tempo da barra de progresso na interface do usuário. (Esse controle foi introduzido na versão de outubro de 2022.)

Tabela Transição de Estado

A tabela Transição de Estado contém uma lista de transições de estado que ocorrerão quando um evento de negócios for gerado. O evento de negócios definirá o estado somente se o estado atual for um estado permitido.

Campo	descrição
Transição de Estado	O GUID da transição de estado.
Definição de Evento de Negócios	Uma pesquisa na tabela Definição de Evento de Negócios para determinar a qual evento de negócios o registro pertence.
Estado de Origem	O estado de origem permitido para a transição de.
Estado de Destino	O estado de destino a ser definido se o estado estiver em transição de um estado de origem permitido.
Motivo do Estado de Destino	O motivo do estado de destino a ser definido se o estado estiver em transição de um estado de origem permitido.

A tabela a seguir mostra um exemplo de dados nesta tabela.

Definição de Evento de Negócios	Estado de Origem	Estado de Destino	Motivo do Estado de Destino
Verificação de sucesso disponível	Em andamento	Processamento em andamento	Verificação de estoque bem-sucedida
Verificação de sucesso disponível	Em Espera	Processamento em andamento	Verificação de estoque bem-sucedida
Falha na verificação disponível	Em andamento	Em Espera	Bloqueio da ordem pendente

Cenários

Não existe nenhuma transição para o evento de negócios

Caso nenhum registro seja encontrado na tabela Transição de Estado para o evento de negócio que está sendo gerado, a validação será automaticamente bem-sucedida, mas nenhum valor Estado ou Razão do Estado será definido.

Adicionar um novo estado e transição

Para adicionar um novo estado e transição, siga estas etapas:

1. Adicione uma nova definição de estado.

2. Adicione um novo motivo de definição de estado, se necessário.

3. Adicione uma nova transição de estado e siga estas etapas:

   1. Associe a nova transição de estado a um novo evento de negócios.
   2. Defina o campo Fonte como o que é permitido. Adicione uma linha por fonte permitida.
   3. Defina o campo Estado como o estado que deve ser definido quando o evento de negócios for acionado.
   4. Defina o campo Razão do Estado como deseja que seja o motivo quando o evento de negócios for gerado.

4. Adicione quaisquer propriedades (Somente Leitura ou Linha do tempo) necessárias.