Criar e gerenciar vocabulários para usar com conjuntos de regras usando o Microsoft Rules Composer (Visualização)
Aplica-se a: Aplicativos Lógicos do Azure (Padrão)
Importante
Esta funcionalidade está em pré-visualização e está sujeita aos Termos de Utilização Suplementares para Pré-visualizações do Microsoft Azure.
Um vocabulário é uma coleção de definições de vocabulário que usam nomes amigáveis para os fatos usados em condições de regras e ações. As definições de vocabulário tornam as regras do seu conjunto de regras mais fáceis de ler, entender e compartilháveis por várias pessoas em um domínio de negócios específico. Por exemplo, os desenvolvedores de ferramentas responsáveis pela integração da criação de regras em aplicativos novos ou existentes podem consumir vocabulários. Os vocabulários preenchem a lacuna entre a semântica do negócio e a implementação.
Este guia mostra como criar e definir vocabulários que são colocados no repositório de regras compartilhadas usando o Microsoft Rules Composer. Você pode selecionar as fontes de dados a serem usadas, criar um novo vocabulário e adicionar definições de vocabulário. Você pode salvar uma versão do seu vocabulário no repositório de regras.
Pré-requisitos
Transfira e instale o Microsoft Rules Composer.
O arquivo XML que contém o repositório de regras onde você deseja adicionar um vocabulário.
Como é que um vocabulário torna as regras mais fáceis de ler e compreender?
Os termos que você usa para definir condições e ações de regras geralmente são expressos usando nomenclatura específica do domínio ou do setor. Por exemplo, um usuário de email escreve regras usando termos como "mensagens recebidas de" e "mensagens recebidas depois". Um analista de negócios de seguros escreve regras usando termos como "fatores de risco" e "valor da cobertura".
Como outro exemplo, uma variável para um status de aprovação pode apontar para um determinado valor em um esquema XML. Em vez de inserir essa representação complexa em uma regra, você pode criar uma definição de vocabulário associada a esse valor de variável e usar "Status" como o nome amigável. Você pode usar "Status" em qualquer número de regras. Os artefatos de tecnologia, como objetos XML e documentos XML, que implementam as condições e ações de regra estão sob essa terminologia específica do domínio. No entanto, o mecanismo de regras pode recuperar os dados correspondentes da tabela que armazena esses dados.
As condições e ações da regra são baseadas em fontes de dados que podem ter informações de vinculação detalhadas e difíceis de ler, que dizem ao usuário pouco ou nada sobre o que as associações fazem referência. O mecanismo de regras permite que você crie vocabulários que simplificam o desenvolvimento de regras, oferecendo terminologia intuitiva e específica do domínio que você pode associar a condições e ações de regras.
Criar um vocabulário
Abra o Microsoft Rules Composer. No menu Repositório de regras, selecione Carregar.
Localize e selecione o arquivo XML que contém o repositório de regras no qual você deseja trabalhar.
Na janela Facts Explorer, selecione a guia Vocabulários.
Na guia Vocabulários, localize a pasta Vocabulários.
Abra o menu de atalho da pasta e selecione Adicionar Novo Vocabulário.
O Microsoft Rules Composer cria um novo vocabulário vazio com uma versão de vocabulário numerada 1.0 como a versão padrão.
Antes de poder usar um vocabulário, o vocabulário precisa ter um carimbo de versão. Este requisito garante que as definições de vocabulário não serão alteradas e preserva a integridade referencial, o que significa que quaisquer conjuntos de regras que usem essa versão específica não falham inesperadamente devido a mudanças no vocabulário subjacente.
A tabela a seguir descreve outros comandos de atalho que você pode usar para trabalhar com vocabulários:
| Comando de atalho | Task |
|---|---|
| Adicionar nova versão | Crie uma nova versão de vocabulário vazio a partir do vocabulário selecionado. Você pode copiar definições de vocabulário de outras versões de vocabulário e colá-las na nova versão. |
| Colar Versão do Vocabulário | No vocabulário selecionado, cole as definições de vocabulário copiadas anteriormente de outra versão do vocabulário como uma nova versão. |
| Eliminar | Elimine o vocabulário selecionado e todas as suas versões. |
A tabela a seguir descreve outros comandos de atalho que você pode usar para trabalhar com versões de vocabulário:
| Comando de atalho | Task |
|---|---|
| Adicionar nova definição | Inicie o Assistente de Definição de Vocabulário para criar uma nova definição na versão de vocabulário selecionada. |
| Guardar | Salve as alterações feitas na versão de vocabulário selecionada e suas definições. |
| Recarregar | Recarregue a versão de vocabulário selecionada e suas definições, incluindo a opção de descartar quaisquer alterações atuais feitas nessa versão e restaurar o conteúdo do repositório de regras. |
A tabela a seguir descreve outros comandos de atalho que você pode usar para trabalhar com versões de vocabulário:
| Comando de atalho | Task |
|---|---|
| Modificar | Inicie o Assistente de Definição de Vocabulário para alterar a definição selecionada. |
| Ir para o facto da fonte | Para a definição de vocabulário selecionada, vá para o fato de origem correspondente em um assembly .NET ou esquema XML. |
| Comando de atalho | Task |
|---|---|
| Selecionar nó raiz | Em um esquema XML que contém vários nós raiz, selecione um nó raiz para carregar. |
As seções a seguir fornecem mais informações sobre essas tarefas.
Copiar uma versão de vocabulário
Quando você quiser fazer alterações em um vocabulário, crie uma nova versão de vocabulário para refletir as mudanças. Você pode criar uma cópia a partir de uma versão de vocabulário existente, mas com um número de versão diferente.
Na janela Facts Explorer, abra o menu de atalho da versão de vocabulário e selecione Copiar.
Abra o menu de atalho do vocabulário e selecione Colar versão do conjunto de regras.
O Microsoft Rules Composer cria uma nova versão de vocabulário com as mesmas definições da versão copiada, mas com um número diferente.
Importante
Quando você cria uma nova versão de vocabulário, as regras construídas usando uma versão de vocabulário anterior ainda fazem referência à versão anterior. Certifique-se de atualizar as referências entre essas regras e a nova versão do vocabulário.
Criar uma versão de vocabulário vazia
Depois de adicionar definições a uma versão de vocabulário, você pode criar uma nova versão de vocabulário vazio com um número diferente e salvar essa versão para trabalhar mais tarde.
Na janela Facts Explorer, selecione a guia Vocabulários.
No separador Vocabulários, encontre o vocabulário a partir do qual criar uma nova versão.
Abra o menu de atalho do vocabulário e selecione Adicionar nova versão.
O Microsoft Rules Composer cria uma nova versão de vocabulário vazio com um número diferente.
Abra o menu de atalho da nova versão de vocabulário e selecione Salvar.
Agora você pode copiar definições de vocabulário de outras versões de vocabulário e colá-las na nova versão.
Renomear um vocabulário
Antes de poder renomear um vocabulário ou um conjunto de regras, você deve salvar tudo, o que significa todas as versões das definições de vocabulário.
Na janela Facts Explorer, selecione a guia Vocabulários.
Na guia Vocabulários, na pasta Vocabulários, encontre o vocabulário que você deseja renomear.
Selecione o vocabulário e, na janela Propriedades , edite o nome.
Criar uma definição de vocabulário
Você pode criar uma definição de vocabulário como um valor constante, um intervalo de valores, um conjunto de valores ou elementos de um assembly .NET ou um documento XML. Para criar uma definição de vocabulário, você pode usar o Assistente de Definição de Vocabulário.
Como alternativa, você pode criar uma nova definição de vocabulário selecionando um fato na guia Classes .NET ou na guia Esquemas XML , como ou um membro de uma classe .NET — arrastando o fato para a guia Vocabulários .
—por exemplo, um nó XML,
Se você selecionar uma variável pública, as opções Obter e Definir ainda estarão disponíveis, assim como no assistente de definição XML.
Adicionar um valor constante como definição de vocabulário
Na guia Vocabulários, na pasta Vocabulários.
Na pasta Vocabulários, abra o menu de atalho para a versão de vocabulário desejada.
No menu de atalho da versão de vocabulário, selecione Adicionar nova definição.
Você também pode arrastar itens da guia Classes .NET e da guia Esquemas XML.
O Assistente de Definição de Vocabulário é iniciado para ajudá-lo a criar a definição.
No assistente, selecione Valor constante, Intervalo de valores ou Conjunto de valores e, em seguida, selecione Avançar.
Forneça as seguintes informações:
Property Description Nome da definição O nome da definição. Descrição A descrição da definição. Tipo de definição Para esta tarefa, selecione Valor constante. Quando estiver pronto, selecione Avançar.
Forneça as seguintes informações:
Property Description Tipo de definição Selecione um tipo de dados do sistema para a definição. Nome a apresentar Insira um nome que não exceda 512 caracteres. Valor Insira um valor para a constante. Quando terminar, selecione Concluir.
Adicionar um intervalo de valores como definição de vocabulário
Na guia Vocabulários, na pasta Vocabulários.
Na pasta Vocabulários, abra o menu de atalho para a versão de vocabulário desejada.
No menu de atalho da versão de vocabulário, selecione Adicionar nova definição.
Você também pode arrastar itens da guia Classes .NET e da guia Esquemas XML.
O Assistente de Definição de Vocabulário é iniciado para ajudá-lo a criar a definição.
No assistente, selecione Valor constante, Intervalo de valores ou Conjunto de valores e, em seguida, selecione Avançar.
Forneça as seguintes informações:
Property Description Nome da definição O nome da definição. Descrição A descrição da definição. Tipo de definição Para esta tarefa, selecione Intervalo de Valores. Quando estiver pronto, selecione Avançar.
Na lista Tipo de definição , selecione um tipo de dados do sistema para a definição.
Em Etapa 1 - Especifique o nome/valor para exibição para Intervalo Baixo e Intervalo Alto, na tabela, selecione Intervalo Baixo e, em seguida, selecione Editar.
Na caixa Definição de parâmetro que é aberta, apenas a opção Usar valor constante está disponível.
Insira um valor constante para especificar o intervalo inferior e selecione OK.
Repita as etapas anteriores para Intervalo Alto, que deve exceder o valor Intervalo Baixo .
Em Etapa 2 - Especifique a cadeia de caracteres de formato de exibição para o intervalo, na propriedade Cadeia de caracteres de formato de exibição, insira a cadeia de caracteres de formato de exibição. Para reverter para a cadeia de caracteres de formato de exibição padrão, selecione Padrão.
Nota
Certifique-se de que sua cadeia de caracteres de formato inclua índices de parâmetros usando chaves curvas, por exemplo, use
{0}e{1}sirva como espaços reservados para os parâmetros de intervalo alto e baixo.O exemplo a seguir mostra uma definição de vocabulário de exemplo para um intervalo de valores:
Quando estiver pronto, selecione Concluir.
Adicionar um conjunto de valores como definição de vocabulário
Na guia Vocabulários, na pasta Vocabulários.
Na pasta Vocabulários, abra o menu de atalho para a versão de vocabulário desejada.
No menu de atalho da versão de vocabulário, selecione Adicionar nova definição.
Você também pode arrastar itens da guia Classes .NET e da guia Esquemas XML.
O Assistente de Definição de Vocabulário é iniciado para ajudá-lo a criar a definição.
No assistente, selecione Valor constante, Intervalo de valores ou Conjunto de valores e, em seguida, selecione Avançar.
Forneça as seguintes informações:
Property Description Nome da definição O nome da definição. Descrição A descrição da definição. Tipo de definição Para esta tarefa, selecione Conjunto de Valores. Quando estiver pronto, selecione Avançar.
Forneça as seguintes informações:
Property Description Tipo de definição Selecione um tipo de dados do sistema para a definição. Nome a apresentar Insira um nome que não exceda 512 caracteres. Em Definir valores, somente a opção Usar valor constante está disponível.
Para adicionar um membro ao conjunto, insira um valor constante e selecione Adicionar.
Repita a etapa anterior para quantos valores quiser incluir no conjunto.
O exemplo a seguir mostra vários valores no conjunto:
Para mover um valor dentro da ordem relativa do conjunto, na caixa Valores, selecione o valor e, em seguida, selecione Para cima ou Para baixo.
Para remover um membro do conjunto, na caixa Valores , selecione o valor e selecione Remover.
Quando concluir o conjunto, selecione Concluir.
Adicionar uma classe .NET ou membro da classe como uma definição de vocabulário
Antes de começar, certifique-se de colocar seus assemblies .NET em um diretório local para o Microsoft Rules Composer. Se você atualizar o assembly .NET, certifique-se de atualizar as referências da versão do conjunto de regras para esse assembly. Para obter mais informações, consulte Atualizar referências de assembly .NET.
Na guia Vocabulários, na pasta Vocabulários.
Na pasta Vocabulários, abra o menu de atalho para a versão de vocabulário desejada.
No menu de atalho da versão de vocabulário, selecione Adicionar nova definição.
Você também pode arrastar uma classe .NET ou membro de classe da guia Classes .NET.
O Assistente de Definição de Vocabulário é iniciado para ajudá-lo a criar a definição.
No assistente, selecione Classe .NET ou Membro da Classe e, em seguida, selecione Avançar.
Forneça as seguintes informações:
Property Description Nome da definição O nome da definição. Descrição A descrição da definição. Na seção Informações do membro da classe, selecione Procurar.
Localize e selecione o assembly desejado e, em seguida, selecione Abrir.
Na caixa Selecionar Ligação, expanda o nó do assembly.
Selecione uma classe ou expanda uma classe e selecione um membro da classe e, em seguida, selecione OK.
Escolha uma das seguintes etapas:
Se você selecionar uma classe, em Nome para exibição, insira um nome que não exceda 512 caracteres e selecione Concluir.
Agora você terminou esta seção.
Se você selecionar um membro da classe que tenha parâmetros, selecione Avançar.
A página Especificar o Nome para Exibição - Classe .NET ou Definição de Membro de Classe é exibida para que você forneça um valor e uma cadeia de caracteres de formato de exibição para cada parâmetro.
Em Etapa 1 - Especifique o nome/valor para exibição para cada parâmetro, na caixa Parâmetros , selecione um parâmetro e selecione Editar.
Para Valor do parâmetro, somente a opção Usar valor constante está disponível, portanto, insira um valor constante.
Em Etapa 2 - Especifique a cadeia de caracteres do formato de exibição, na propriedade Cadeia de caracteres do formato de exibição, insira a cadeia de caracteres do formato de exibição. Para reverter para a cadeia de caracteres de formato de exibição padrão, selecione Padrão.
Nota
Certifique-se de que sua cadeia de caracteres de formato inclua índices de parâmetros usando chaves curvas, por exemplo, use
{0}e{1}sirva como espaços reservados para os parâmetros.Repita as etapas anteriores para cada parâmetro no membro da classe.
O exemplo a seguir mostra vários parâmetros no membro da classe:
Criar uma definição de vocabulário a partir de um assembly .NET
Você pode criar definições de vocabulário de classes ou membros de classe em um assembly .NET para definir predicados, argumentos e ações. Antes de começar, certifique-se de colocar seus assemblies .NET em um diretório local para o Microsoft Rules Composer. Se você atualizar o assembly .NET, certifique-se de atualizar as referências da versão do conjunto de regras para esse assembly. Para obter mais informações, consulte Atualizar referências de assembly .NET.
Na janela Facts Explorer, selecione a guia .NET Classes.
Em Assemblies .NET, arraste uma classe ou membro de classe para uma definição de vocabulário existente, que aparece na guia Vocabulários .
Criar uma definição de vocabulário a partir de um elemento ou atributo de documento XML
Você pode criar definições de vocabulário a partir de elementos e atributos XML navegando por esquemas XSD e arrastando itens para o editor de condições ou editor de ações para definir predicados, argumentos e ações.
Na guia Vocabulários, na pasta Vocabulários.
Na pasta Vocabulários, abra o menu de atalho para a versão de vocabulário desejada.
No menu de atalho da versão de vocabulário, selecione Adicionar nova definição.
O Assistente de Definição de Vocabulário é iniciado para ajudá-lo a criar a definição.
No assistente, selecione Elemento ou Atributo de Documento XML e, em seguida, selecione Avançar.
Forneça as seguintes informações:
Property Description Nome da definição O nome da definição. Descrição A descrição da definição. Na seção Informações do documento XML, selecione Procurar.
Localize e selecione um arquivo de esquema (.xsd) e selecione um elemento ou atributo do documento.
Na lista Tipo , selecione um tipo que seja compatível com o tipo do elemento ou atributo selecionado do esquema.
Nota
O mecanismo não valida a existência do elemento definido e o tipo de documento. Se você afirmar um documento XML que não tem o elemento , você receberá um erro no tempo de execução. Se você afirmar um documento XML com um tipo de documento desconhecido, o mecanismo simplesmente ignorará o documento.
Se o mecanismo não puder executar uma conversão válida entre o tipo especificado e o tipo para o elemento ou atributo de documento selecionado, você receberá um erro em tempo de execução.
Na seção Selecionar operação, selecione o tipo de operação que indica se você planeja obter o valor do elemento ou atributo ou definir o valor.
Se você optar por definir o valor, selecione Avançar e especifique o formato de exibição.
A página Especificar o Nome para Exibição - Elemento ou Atributo do Documento XML é exibida para que você forneça um valor e uma cadeia de caracteres de formato de exibição a ser usada.
Em Etapa 1 - Especifique o nome/valor para exibição para cada parâmetro, na caixa Parâmetros , selecione um parâmetro e selecione Editar.
Para Valor do parâmetro, somente a opção Usar valor constante está disponível, portanto, insira um valor constante.
Em Etapa 2 - Especifique a cadeia de caracteres do formato de exibição, na propriedade Cadeia de caracteres do formato de exibição, insira a cadeia de caracteres do formato de exibição. Para reverter para a cadeia de caracteres de formato de exibição padrão, selecione Padrão.
Nota
Certifique-se de que sua cadeia de caracteres de formato inclua índices de parâmetros usando chaves curvas, por exemplo, use
{0}e{1}sirva como espaços reservados para os parâmetros.
Quando terminar, selecione Concluir.
O exemplo a seguir mostra os detalhes de uma definição de vocabulário com base em um elemento ou atributo de documento XML:
Quando você cria definições de vocabulário para nós XML, as expressões XPath para as associações têm valores padrão semelhantes, com base nas regras descritas anteriormente. No entanto, você pode editar esses valores no Assistente de Definição de Vocabulário. As alterações nas expressões são colocadas na definição de vocabulário e são refletidas em quaisquer argumentos de regra que você construir a partir das definições de vocabulário.
