Histórico da Página
...
Manual prático e objetivo para construção de políticas de decisão usando o Compilador para o TOTVS Intellector.
Tela Inicial
Tela de Apresentação, onde os dados de permissão de uso são verificados; é também possível fazer a troca de senha. Para a primeira execução, use usuário admin e senha tools01. Este usuário e senha devem ser substituídos para evitar acessos indesejáveis.
A tela abaixo somente aparece na primeira execução do aplicativo após a instalação; ela pergunta se existe alguma base legada do SQL AnyWhere para ser migrada para essa nova versão; o arquivo editor.ini aponta para essa base legada. Caso esse arquivo exista e se deseje fazer a migração, nesse momento, escolha a opção Não, para a aplicação não ser iniciada e, copie editor.ini para o diretório da aplicação atual, e reinicie a aplicação. O sistema dessa forma fará a importação sem fazer a pergunta novamente. Se confirmada (botão Sim), escolhendo para NÃO fazer a importação, essa mensagem não aparecerá novamente.
Importação de Base Legada
...
Tela principal da aplicação
Criação de Políticas ou Regras de Decisão
...
- Condições ( SE, ENTÃO, SENÃO e FIM-SE )
- Comparadores ( >, <, =, AND e OR.)
- Conjunções Lógicas ( E, OU )
- Operadores (+ , – , *, ( , ), / )
- Ações ( APROVA, NEGA, MESA DE CREDITO ) – o nome das ações é definido pela natureza do negócio.
Processo de Criação de uma política no TOTVS Intellector Compilador
Acessar o menu Programas/Novo – será aberta a página em branco para a criação de uma nova política.
Nova Política
O Compilador usa drag-and-drop, arrastando as estruturas (Elementos), comparadores ou conjunções que se deseja utilizar.
Elementos
Para inserir variáveis, selecionar o bloco e em seguida clique na variável desejada
Selecionando o bloco
- Após o clique
Variável inserida
- Para apagar um elemento do código da política, basta selecionar o texto desejado e clicar no botão 'apagar'.
Apagar linhas
- Para apagar um bloco da política, marcar a 'Linha Inicial' que deseja apagar e, com a tecla SHIFT pressionada marcar a 'Linha Final' desejada.
Editor
- Para gravar a política deverá ser clicado o botão "grava" ou a opção "Programa/Salvar" no menu principal
- deverá ser informado o nome e tipo da política. Enquanto a política não for publicada no servidor, o tipo poderá ser alterado.
Editor
Editor
- Para alterar o tipo, deverá ser clicado o botão "propriedades" ou a opção "Programa/Propriedades" no menu principal
Editor
Editor
- Para criar uma política a partir de uma política existente deverá ser usada a opção "Programa/Salvar Como" no menu principal.
Editor
Editor
Elementos de uma Política
...
Todo o código é validado na compilação e caso exista algum erro na codificação será criticado e informado o local no código onde ocorreu. |
Tela de elementos
Acessos
- Os Acessos referem-se às consultas disponíveis que podem ser feitas na política. Cada 'Acesso' é um item disponível na janela de Elementos que podem ser usados para obter dados externos.
Tela de Acessos
- Caso um acesso não possua bind de todas as variáveis ou não possua descrição, então ficará inválido e aparecerá com indicação desse status na tela de elementos.
Acesso inválido
Comandos
- Neste item estão disponíveis os Comandos que serão aplicados numa política.
...
Tela de Comandos
Comentário
- É possível inclusão de comentários a respeito da codificação da política.
...
// TOTVS Software SA // Data 27/05/2013 // Demonstrando o uso do elemento Comentário
Tela de Comentário
Funções
- Neste recurso será possível utilizar códigos prontos, os quais retornam resultados de consultas ou cálculos conforme o objetivo da função.
Tela de Funções
- Para Somar um número de dias à uma data e obter uma nova data, pode-se usar a função f_somaDiasData
...
<Variável> := f_somaDiasData ( $Data $Numero )
Função na Politica
SubPolíticas
- Poderão também ser criadas novas 'funções' pelo usuário utilizando todos os recursos disponíveis que são chamados de 'SubPolíticas'.
...
- As 'SubPolíticas' são criadas em casos onde existem a necessidade de repetir o mesmo código em uma Política; com a 'SubPolitica"' criada será possível executá-la sempre que desejado, bastando incluí-la no código da política.
Nomeando SubPolítica
- Criando o Script para a SubPolítica; no menu Elementos/SubPolitica/Abre Script:
Tela de Comentário
- Crie uma nova variável de Trabalho ou use uma existente:
Nova variável de Trabalho
Nova variável de Trabalho
- Adicione um Bloco que irá receber a variável de Trabalho:
Nova variável de Trabalho
- Recebendo a variável escolhida:
Escolhendo variável de Trabalho
- Atribuindo um valor qualquer; nesse caso, um 'Literal'.
...
- Após a atribuição a variável está com o novo valor e estará disponível globalmente.
Atribuindo um valor
- De volta ao script da Política, após a chamada da SubPolitica 'Sub_MinhaSoma', a variavel de trabalho estará com valor que lhe foi atribuido dentro da subpolitica. Uma váriavel de trabalho tem o conceito de variável global. Será visualizada pela politica e todas as suas subpoliticas.
Voltando para a Política
- Abaixo, foi feito pequenas operações usando Bloco, Operadores e Literal (veja abaixo).
Pequenas operações
Literal
- Este recurso é utilizado para a passagem de informações (valores) para variáveis do sistema.
- Ao clicar na opção Literal será aberta a tela abaixo disponibilizando a digitação e a escolha do tipo de literal desejada, neste caso será Integer.
Tela do Literal
- O Literal então será colocado na Política.
Literal na Política
Conjunções Lógicas
- Este é um dos recursos utilizados para comparações na política de crédito, ampliando as possibilidades de desenvolvimento da política.
...
Tela de Conjunções Lógicas
Comparadores
- Recursos para comparações diversas e que serão utilizados nas políticas.
...
- Esta funcionalidade do Compilador é utilizada em árvores de decisão ou na atribuição de valores à variáveis de trabalho do sistema, ou seja, operadores matemáticos.
Operadores
Variáveis
- A variável é a fonte de consulta utilizada pela política para realizar as validações, nelas temos as informações necessárias para identificar qual ação iremos realizar para um determinado cliente.
...
- Interna - São variáveis que foram informadas pelo aplicativo que chamou o 'TOTVS Intellector' (front-end).
- Externa - Variáveis oriundas de Acessos Externos, que podem compor diretamente o layout de saída da política.
- 'De Trabalho' - Variáveis criadas durante a política, utilizadas para cálculos, comparações, etc. Compõem o layout de saída da política junto das variáveis externas, retornando informações para o aplicativo que chamou o 'TOTVS Intellector'.
Variáveis
Ações
- As Ações finalizam a rotina de uma política sempre que desejamos definir o resultado de uma validação feita na política devemos utilizar uma Ação, uma política sem uma ação não terá resultado algum para o processo.
Ações
- Ações ( "APROVA", "NEGA", "MESA DE CREDITO", "AUTORIZA", "LIGA", "DESLIGA" ) - o nome das ações é definido pela natureza do negócio.
- Para incluir uma ação deve-se clicar com o botão direito do mouse no item "ações".
Criando Ação
- Pode-se escolher o icone e a cor da ação exibida nas politicas.
Configurando Icone da Ação
Configurando Cor da Ação
...
- Importando um "XML" de Acesso; acesse no menu Layout/Acessos...
Menu acessos
- Se não existe nenhum Acesso cadastrado, uma tela abre para que seja feito a primeira importação; ou então use o ícone Inclui para incluir novos Acessos.
Menu acessos
- Se existir, um diálogo de advertência é mostrado:
Layout já existe
- Em seguida, no processo de importação, a tela abaixo é exibida, onde somente a descrição do Acesso pode ser editado.
Importando acessos
- Se você tentar validar o Acesso sem fazer as associações entre as variaveis do acesso e as variáveis internas da politica (binding), a seguinte tela será exibida.
Validando acessos
- Enquanto não forem efetuadas as associações entre as variaveis do acesso e as variáveis internas da politica (binding), o Acesso permanece inválido e nenhuma política que faça referência ao acesso será compilada. Veja abaixo um acesso inválido.
...
Ao clicar no botão "Envio, são exibidas as variaveis de entrada do acesso.
Dados de Envio
- Ao clicar no botão Retorno, são exibidas as variáveis de saída do acesso
...
- As variáveis Internas LPT__iRetorno, LPT__sAcao e LPT__sMsgErro' são variáveis fixas (especiais) que SEMPRE estarão presentes numa política e por isso já vem criadas por padrão.
Dados de Retorno
- As variáveis internas não precisam ter o mesmo nome das váriaveis de entrada do acesso. Apenas são permitidas associações de váriaveis do mesmo tipo; A seguir nosso exemplo cria uma nova variavel no compilador utilizando o caminho: Elementos/Variáveis/Internas/Nova Variável.
Incluindo Variáveis Internas
- Digite um Nome e escolha o Tipo; escolha um nome sem espaços ou caracteres especiais pois esse nome será validado.
Incluindo Variáveis Internas
...
Nova Variável Interna- Uma nova variável Interna aparecerá no menu:
...
- Então, volte ao Acesso, verifique que a variável recém-criada aparece na drop-down; faça a ligação da variável do Acesso com a nova variável.
...
Implantação Implantação de Políticas em Produção
- Para que possamos iniciar a utilização das Políticas, devemos implantar esta política na produção, ou seja, disponibilizá-la para utilização do TOTVS Intellector Server (site). A seguir apresentamos a sequência para esta operação.
...
- Para que possamos configurar o layout da política é necessário que antes seja criado o "esqueleto" da política referente ao acesso desejado.
- Na janela de Elementos, clique e arraste o acesso já validado para a área de criação da política.
Configurando Layouts das Políticas
...
Criando Layouts/Politicas
- Clique no botão "envio" para abrir a tela de variáveis de entrada da politica.
- Escolha as variáveis de Entrada da Política, que estarão sendo montadas pelo processo chamador da Política. Para remover, basta selecionar e clicar no botão Exclui.
Encolhendo variáveis de Entrada
- Clique no botão "retorno" para abrir a tela de variaveis de saida da politica.
- Da mesma forma, escolha as variáveis de Saída da Política; elas estarão disponíveis para o processo chamador. Observe que já existem as variáveis obrigatórias devolvidas pela Política. Para remover, basta selecionar e clicar no botãoExclui.
...
Botões disponíveis
- Valide o seu Layout, escolhendo o ícone pertinente (Valida) e, observe o campo Válido, verificando se existe um Sim.
Validando o Layout
- É possivel copiar um layout já existente. Para isso deverá ser usado o botão 'copia'.
...
- É possível fazer associações De x Para para as variáveis de Entrada/Saída, usando os botões Envio/Retorno, não sendo essa operação obrigatória.
- A primeira opção de 'De x Para', é colocar um valor default para um determinado campo; se na execução da política, não for informado um valor, ela assumirá um valor informado no campo Default, senão, será usado um valor nulo.
Campo default
- Entretanto, é possível sofisticar a operação 'De x Para'; veja a explicação do exemplo na tela abaixo: se a variável de entrada vier com o valor 00000000191, ela vai assumir o valor de saída 00000000299; qualquer valor diferente de 00000000191 é o próprio valor informado na entrada que será considerado.
- Se você especificar um valor default, e então, entrou o valor 00000000191, ele irá fazer o De x Para 00000000299, e, qualquer valor diferente de 00000000191 será então assumido o valor default, no caso do exemplo, o valor 12300000000.
Variáveis defaults
- Verificando no canto inferior direito, você verá no campo De x Para, uma string 00000000191?00000000299;12300000000 - simplesmente uma regra de associação!
...
- Após fazer as ligações e validar, o próximo passo é publicar esse acesso no TOTVS Intellector Server, para que fiquem disponíveis para a execução de Políticas. Para tanto, será necessário que os dados do servidor estejam corretos.
- Deverá ser clicado o botão de publicação no menu lateral e será aberta uma janela para informar usuário e senha para publicação.
Publicando Acessos
- Os dados de usuário/senha e tipo de política serão validados no servidor; o usuário/senha NÃO SÃO OS MESMOS do TOTVS Intellector Compilador; você pode ter permissão para montar políticas, mas não necessariamente para publicar o tipo de política no TOTVS Intellector Server. Se não houver permissão, um diálogo informará isso, assim como qualquer erro ocorrido no servidor.
Login inválido
- Se a publicação for efetuada com sucesso, o diálogo abaixo será mostrado.
Envio com sucesso
Compilando a Política
- É prudente que antes da tentativa de compilação seja efetuado um teste de compilação.
- A compilação é a avaliação lógica da política. Isso evitará problemas durante a implantação em produção.
- Ocorrendo erros de compilação os mesmos deverão ser acertados e, após, recompilar.
- Utilize a opção Programa/Compila Tudo do Menu.
...
Erros de compilação na Política
- Caso existam variáveis internas não mapeadas nos layouts de entrada da política, será exibido um warnings (avisos).
- Os warnings não impedem a publicação da politica, são apenas avisos para evitar "esquecimentos" de mapeamento de variáveis nos layouts.
...
Colocando a Política em Produção
- O mesmo processo de validação do usuário que está publicando a Política e tipo da política é feita pelo servidor, se não houver autorização ou outro erro decorrente da compilação, esse será mostrado no diálogo.
Usuário inválido
- A informação sobre a data de publicação da política pode ser visualizada na janela de propriedades.
Tela de propriedades da politica
- Uma política publicada não pode mais ser alterada. Haverá uma mensagem indicativa ao abrir a política e o menu lateral fica desabilitado.
...
- Na tela Principal, no menu "Arquivo/Usuários", pode ser realizada a manutenção de usuários e suas permissões, como visto na tela abaixo; a usabilidade dessa funcionalidade é dada pelo menu lateral esquerdo.
Publicando as políticas
Criação de Repositórios
- Você pode verificar qual Banco de Dados você está conectado no momento; escolha no menu Repositório/Conexão Atual:
Conectado ao Banco...
- Você pode também se conectar a outro Banco de Dados, no menu Repositório/Trocar Repositório.
- Continuando, você poderá criar um Novo repositório; escolha no menu "Reposotório/Novo", então um diálogo pedirá o local para a criação.
Novo repositório
- Se você escolher um diretório onde já exista um repositório, um diálogo será mostrado e não será permitido usar o mesmo local.
Novo repositório
- Após escolher o local, uma tela pedirá para informar quais itens do repositório atual serão copiados para o novo repositório; se você escolher Políticas, alguns itens serão automaticamente selecionados, pois existem dependências.
Selecionando itens
- Outro diálogo perguntará qual repositório, após a criação, você estará conectado.
Selecionando conexão
- Pronto, repositório criado! observe que será informado qual Repositório está sendo usado atualmente pela aplicação.
...
- Uma política pode ser exportada para ser enviada para outro repositório. Para isso deverá ser selecionada a opção "Repositório/Exportar política" do menu principal.
Exportação de politica
- Pode ser escolhido um layout da política, para ser exportado junto com a política. A escolha do layout é opcional
Layout de politica para exportação
- A política é gravada em arquivo texto com extensão ".pla".
Exportação de politica
Exportação de politica
Importação de Politica
- Para importar uma política deve ser selecionada a opção "Repositório/Importar Política" do menu principal. A política será importada com todos os acessos, variáveis, subpoliticas e layout (caso tenha sido selecionado) que não existam no repositório e sejam usadas pela política.
...
Importação de politica
Importação de politica
- Caso a política já exista no repositório, será exibida mensagem informativa na tela.
Importação de politica
Depurador (Debugger)
Introdução
...
Tela principal da aplicação
- Para gerar um arquivo de variáveis deverá ser clicado o botão "novo arquivo".
Tela de parametrização de variáveis
- Por default virá selecionada a opção Variáveis internas / Trabalho que exibe as variáveis internas e de trabalho usadas na política. As variáveis internas que possuirem bind com as variáveis de entrada de acessos usados na políticas também são consideradas variáveis internas da política.
...
Parametrizando variáveis internas/trabalho
- Ao selecionar a opção Variáveis Saida Acessos, serão exibidas todas as variáveis de retorno dos acessos usados na política. Também deverão ser indicados valores para as variáveis desejadas de forma a simular que o acesso tenha retornado esses valores na depuração. O arquivo deverá ser gravado no diretório selecionado e possui a extensão .ext.
...
Parametrizando variáveis de retorno de acessos usados na politica
- Caso sejam informados valores incompatíveis com o tipo ou o formato das variáveis, será exibida mensagem para correção e não será permitida a gravação do arquivo.
Tela de parametrização de variáveis
- A qualquer momento poderão ser alterados arquivos de variáveis internas/trabalho ou de variáveis de saida de acessos já gravados. Para isso deverá ser clicado o botão Edita Arquivo, selecionado o arquivo, efetuar as alterações desejadas e gravar (podendo gravar com outro nome ou sobrescrever o atual).
...
Alterando arquivo de variáveis usadas na politica
Depurar Política
- Para depurar uma política aberta pelo Compilador, abra a tela de depuração pelo menu Depurador/Depurar Politica.
Tela principal da aplicação
- Para entrar no depurador é necessário que exista política aberta no compilador e sem erros de compilação.
...
Tela principal da aplicação
- O funcionamento do depurador é baseado no conceito de workspace (área de trabalho), onde se cria um ambiente de depuração específico da política.
- A workspace é constituída pela política, o arquivo das variáveis internas e de trabalho (*.var), o arquivo das variáveis externas dos acessos (*.ext) e o resultado final da execução da política. Ao entrar no depurador, uma workspace default contendo apenas um caso também default é automaticamente carregada, contendo a política sem arquivos de variáveis.
...
Criando novo caso
Criando novo caso
- O novo caso criado já traz a política aberta no Compilador e podem ser criados vários casos para a política, cada um contendo arquivos com valores diferentes para simular cenários distintos.
Criando novo caso
- Na eventual existência de mais de um caso, para iniciar uma depuração deve-se antes indicar qual dos casos está ativo. Para isso, clique com o botão direito do mouse no ícone do caso, depois em Ativar.
...
Informando arquivos de variáveis
- Existe também a opção de remover os arquivos ou ver suas propriedades através do menu que aparece clicando-se com o botão direito do mouse nos ícones dos arquivos.
...
Abrindo a workspace gravada em disco
- Para iniciar a depuração, clique no menu Depurar/Iniciar ou clique no ícone "iniciar" na barra lateral de atalhos.
Depurando a politica
- É obrigatório informar o arquivo de variáveis internas/trabalho. O arquivo de variáveis de saída dos acessos só é obrigatório caso existam acessos na política.
Tela principal da aplicação
- A política do caso ativo será automaticamente carregada na tela. As variáveis também serão carregadas e poderão ser acessadas e visualizadas pelas tabelas das abas Internas, Externas e de Trabalho.
Depurando a politica
- A tela fica dividida em três partes: uma para visualização das configurações da workspace, uma para apresentação da política e uma para controle do conteúdo das variáveis. Além dessas áreas de controle existe uma barra do lado esquerdo com os atalhos para as principais opções desse ambiente.
- A janela de visualização da política permite apenas acompanhar o processo de depuração, não permitindo qualquer edição do texto apresentado.
Tela do Depurador
- Depois de iniciada a depuração, o usuário pode percorrer a política linha a linha através do menu Depurar/Pular ou utilizar o atalho da barra lateral para esta opção.
Depurando a politica
- Pode-se também percorrer as linhas do conteúdo de uma subpolitica, bastando apenas clicar no menu Depurar/Entrar, com o cursor posicionado na linha da chamada da Subpolitica ou utilizar o atalho na barra lateral.
...
- O valor das variáveis pode ser acompanhado na parte inferior da tela e os valores podem ser alterados em qualquer momento.
Visualizando conteúdo de variáveis
- Para acrescentar variáveis na visualização ou remove-las, clique no menu Depurar/Adicionar Variável ou Remover Variável ou nos respectivos atalhos da barra lateral.
Visualizando variáveis
- A qualquer momento pode ser interrompida a depuração da política, bastando clicar no menu Depurar/Encerrar ou no respectivo atalho da barra lateral.
Encerrando a depuração da politica antes do final
- A política pode ser reiniciada em qualquer momento, basta clicar no menu Depurar/Reiniciar ou no respectivo atalho da barra lateral.
Reiniciando a depuração da politica
- Quando o cursor atingir uma das ações pré-definidas, a ação é exibida no item resultado do caso na workspace.
Resultado final da politica
- Existe também a opção de executar todos os casos da workspace de uma só vez (com um só clique) e visualizar o resultado final de cada caso na workspace.
- Para isso deve ser clicado o menu "Depurar/Executar Todos" ou no respectivo atalho da barra lateral.
...
Executando casos em sequência sem interrupção
- Pode-se acessar a tela de geração de arquivos da política de dentro do depurador. Para isso basta acessar o menu Depurar/Parametrização do debugger.
Tela do Depurador
Tela do Depurador
Saiba mais
- Portal e Novidades sobre o TOTVS Intellector http://www.intellector.com.br
- Instalação do TOTVS Intellector http://www.intellector.com.br/?p=44
- Manual de Utilização do Site do TOTVS Intellector http://www.intellector.com.br/?p=91
- Acessos Externos http://www.intellector.com.br/?p=77
- Intellector Developer API http://wiki.tools.com.br/index.php/Categoria:Produto_Intellector_-_Intellector_Developer_API
- Firebird - The RDBMS that's going where you're going
...