Histórico da Página
...
Importação de Base Legada
Tela Principal da Aplicaçã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
...
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
- Para alterar o tipo, deverá ser clicado o botão "Propriedades" ou a opção "Política/Propriedades" no menu principal.
- Para criar uma política a partir de uma política existente deverá ser usada a opção "Política/Salvar Como" no menu principal.
- Editor
...
Os elementos de uma política de crédito são os recursos disponíveis para o desenvolvimento da lógica da política, sendo sua composição: Acessos, Comandos, Comentário, Funções, Subpoliticas, Literal, Conjunções Lógicas, Comparadores, Operadores, Variáveis Internas, Externas e de Trabalho e Ações.
Aviso |
---|
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
...
É possível inclusão de comentários a respeito da codificação da política.
Exemplo:
Informações |
---|
// TOTVS Software SA // Data 27/05/2013 // Demonstrando o uso do elemento Comentário |
...
Informações |
---|
<Variável> := f_somaDiasData ( $Data $Numero ) |
- Função na Politica
...
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.
- Crie uma nova variável Nova Variável de Trabalho trabalho ou use uma existente.
- Nova variável Variável de Trabalhotrabalho
- Adicione um 'Bloco' que irá receber a variável de Trabalhotrabalho.
Nova variável de Trabalho
- Recebendo a variável escolhida.
- 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 global.
- De volta ao script da Políticapolítica, após a chamada da SubPolítica a 'Sub_MinhaSoma', a variável de trabalho estará com valor que lhe foi atribuído dentro da subpolítica. Uma variável de trabalho tem o conceito de variável global. Será visualizada pela política e todas as suas subpolíticasubpolíticas.
- Abaixo, foi feito pequenas operações usando Bloco, Operadores e Literal (veja abaixo).
...
- 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á será "Integer".
- O Literal então será colocado na Política.política
Conjunções Lógicas
...
- Outro exemplo abaixo na tela de Conjunções Lógicas.
...
- Recursos para comparações diversas e que serão utilizados nas políticas.
Informações |
---|
Caso sejam feitas comparações de dados de tipos diferentes, na compilação o sistema fará a crítica e informará o local do problema. |
Operadores
- 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.
...
- 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.
Informações |
---|
Temos 3 tipos de 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, uma política sem uma ação não terá resultado algum para o processo.
...
- As Ações ( APROVA, NEGA, MESA DE CREDITO, AUTORIZA, LIGA, DESLIGA ), tem o nome 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".
- Pode-se escolher o ícone e a cor da ação exibida nas politicas.
- Configurando a Cor da Ação.
Importando e configurando Acessos
Para que um acesso fique disponível, um "XML" seguindo as regras do Intellector-API, precisa ser importado para o TOTVS Intellector Compilador. Veja aqui o exemplo de um "XML" de um acesso.
Nota |
---|
Sugerimos imprimir uma cópia do XML do Acesso ou deixar de fácil acesso, pois será necessário verificar os tipos de dados de cada variável. |
Importando um Acesso
Importando um "XML" de Acesso, acesse no menu Layout/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 os novos Acessos.
- Se existir um diálogo de advertência, será informado a mensagem na tela.
Layout já existe
...
- Se você tentar validar o Acesso sem fazer as associações entre as variáveis do acesso e as variáveis internas da politica (binding), a seguinte tela será exibida.
Validando acessosacessos
Enquanto não forem efetuadas as associações entre as variáveis 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.
Inspecionando o Acesso importado
...
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.
Não é possível informar as variáveis LPT__iRetorno, LPT__sAcao e LPT__sMsgErro como variáveis de bind para os acessos. Essas são variáveis de controle interno do Intellector.
As variáveis internas não precisam ter o mesmo nome das váriaveis de entrada do 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.
...
- Então, volte ao Acesso, verifique que a variável recém-criada aparece na drop-down e faça a ligação da variável do Acesso com a nova variável.
Aviso |
---|
IMPORTANTE! - Enquanto todas as variáveis não tiverem suas ligações efetuadas, o Acesso continuará INVÁLIDO! |
...
Ao terminar a ligação das variáveis, faça a validação do Acesso (clicando no botão de validação no menu lateral), senão ele continuará INVÁLIDO! Após a validação do acesso a tela pode ser fechada porque o acesso estará pronto para ser usado nas politicas.
Aviso |
---|
'IMPORTANTE!' - Caso existam políticas já publicadas utilizando um acesso, e houver alteração no bind de qualquer variável do acesso, as políticas deverão ser republicadas (com novo nome) porque a nova variável de bind não será visualizada pela política. Isso ocorre porque a política só conhece as variáveis internas de bind dos acessos que estejam configuradas no momento da sua publicação (modificações posteriores não são visualizadas porque a política já está no servidor). |
...
Nota |
---|
Normalmente o SendRequest.ini fica localizado no diretório da instalação do Compilador. Não altere esse arquivo manualmente! |
...
Escolha a opção no menu Layouts/Políticas.
- Criando um Layout para uma política, escolha o ícone Inclui e entre com um nome para o Layout.
...
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".
...
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ão "Exclui".
Aviso |
---|
IMPORTANTE! - Não será possível remover as variáveis especiais 'LPT__sAcao', 'LPT__sMsgErro' e 'LPT__iRetorno'. |
Nota |
---|
Observe os Botões à esquerda, passe o mouse por cima, onde um label mostrará sua utilidade. |
Valide o seu Layout, escolhendo o ícone pertinente (Valida) e, observe o campo Válido, verificando se existe um "Sim".
É possivel copiar um Layout já existente. Para isso deverá ser usado o botão "Copia".
Aviso |
---|
IMPORTANTE! - Ao copiar um layout, só serão mantidas as variáveis usadas na política. As variáveis específicas da política do layout de origem serão automaticamente apagadas. |
...
- É 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!
Regra de associação
Publicando Layouts das Políticas
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, uma mensagem será exibida, assim como qualquer erro ocorrido no servidor.
Login inválido
- Se a publicação for efetuada com sucesso, a mensagem abaixo será mostrada.
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 Política/Compila Tudo do Menumenu.
- 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.
- Erros de compilação na política.
As políticas necessitam ser publicadas. Uma política não pode ser publicada mais de uma vez com o mesmo nome / tipo. Caso necessite fazer uma alteração numa política já publicada, a mesma deverá ser renomeada e republicada
.Publicando as Políticas
- Escolha no menu a opção Política/Coloca em Produção.
Colocando a Política em Produção
- Colocar a política em produção é aplicá-la no conjunto de políticas disponíveis no TOTVS Intellector. Para que a mesma seja utilizada, faz-se necessário ainda relacioná-la a um dos momentos de entrada no Portal de Crédito se for esse o processo chamador, não que, necessariamente o seja.
- Por segurança, uma política implantada não pode ser excluída, mesmo que não utilizada.
- 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.
- A informação sobre a data de publicação da política pode ser visualizada na janela de propriedades.
- 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.
...
Aviso |
---|
IMPORTANTE! - Caso precise alterar uma política, ela deverá ser gravada com outro nome(usar o menu "salvar como" ) e publicada. |
...
Associando a Política ao Evento de Entrada
Finalmente, após implantada nossa política em produção, ela estará pronta para ser utilizada, lembrando que a URL ("servlet") disponível deve ser algo como 'http://hostname:8080/intellector/runpolicy'.
- O Portal de Crédito CredPortal oferecido pela 'Tools Software TOTVS S/A' tem mecanismos simples para implementar e configurar chamadas de políticas.
...
- 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.
...
Criação de Repositórios
- As políticas e todos os demais elementos para a construção de políticas ficam armazenados em um arquivo de banco de dados local, com extensão FDB. Esse banco de dados não tem que necessariamente ter o nome “INTELLECTOR.FDB”, pode ter qualquer nome desde que tenha a extensão “.FDB”.
Exemplos de nomes de banco de dados do Intellector Client:
- POLITICAS_CREDITO.FDB
- CREDITO.FDB
- LIMITE_CARTAO.FDB
Obs.: Caso seja informado um FDB que não contenha a estrutura de tabelas do Intellector Client, o sistema emitirá uma mensagem informando que o banco de dados não está disponível.
- Você pode verificar qual Banco de Dados você está conectado no momento escolha no menu Repositório/Conexão Atual.
...
- Continuando, você poderá criar um Novo novo repositório; escolha no menu "Reposotório/Novo", então um diálogo pedirá o local para a criação.
- Se você escolher um diretório onde já exista um repositório com o nome escolhido, um diálogo será mostrado e não será permitido usar o mesmo local com o nome escolhido.
- 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.
- Outro diálogo perguntará qual repositório, após a criação, você estará conectado.
- Pronto, repositório criado! observe que será informado qual Repositório está sendo usado atualmente pela aplicação.
Exportação de Politica
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.
- Pode ser escolhido um layout da política, para ser exportado junto com a política. A escolha do layout é opcional.
- A política é gravada em arquivo texto com extensão ".pla".
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, sub-politicas e layout (caso tenha sido selecionado) que não existam no repositório e sejam usadas pela política.
...
Importação de politica
...
A criação de uma política requer um intenso esforço para simular e analisar todos os possíveis resultados e situações. Mais do que isso, determinadas situações de erro que venham a acontecer, até o presente momento, teriam um elevado grau de dificuldade para encontrar a exata localização do erro e a sua solução. Visando permitir uma maior flexibilidade por parte dos usuários, o presente sistema fornece uma interface amigável, onde o usuário terá controle completo e poderá acompanhar todos os passos e o conteúdo de todas as variáveis utilizadas em uma política. O depurador possui completa integração com o ambiente do Compilador e a possibilidade de alteração dos dados analisados durante o processo de depuração de uma política. Uma completa independência do ambiente convencional é obtida através da utilização de arquivos textuais como forma de alimentação do ambiente integrado de depuração. Ou seja, as políticas podem ser depuradas sem a necessidade de conexão direta com um servidor web, bastando para isso que a exportação dos dados seja realizada antes.
Conceitos
Para o completo entendimento da aplicação, torna-se necessária a definição de alguns conceitos relacionados à operação do ambiente de depuração.
...
Indica a ação final da política baseada nos valores das variáveis.
- A tela de depuração sempre abrirá com um workspace default contendo apenas um caso também default com a política atualmente aberta no Compilador. Para abrir a tela de depuração deverá existir uma política compilada sem erros na tela principal. Os casos de depuração serão sempre relativos á política da tela principal. O arquivo de variáveis e os arquivos de acessos deverão ser informados e poderão ser gerados na opção de Parametrização de Variáveis que será detalhada abaixo. Na tela de depuração, o usuário também possui autonomia para alterar os arquivos, inserir outros casos e salvar o workspace utilizado.
Parametrização de Variáveis
...
- Para gerar um arquivo de variáveis deverá ser clicado o botão "novo arquivoNovo Arquivo".
Tela de parametrização de variáveis
...
- Por default virá selecionada a opção 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 possuírem bind com as variáveis de entrada de acessos usados na políticas também são consideradas variáveis internas da política.
- Poderão ser informados valores para as variáveis (que simulam valores enviados para a política) e em seguida o arquivo deverá ser gravado no diretório selecionado. O arquivo possui a extensão .var.
- Parametrizando variáveis internas/trabalho
- Ao selecionar a opção opção "Variáveis Saida Saída 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 possuir a extensão extensão (.ext).
Parametrizando variáveis de retorno de acessos usados na politica
...
Parametrizando variáveis de retorno de acessos usados na politica
...
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 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
Alterando arquivo de variáveis usadas na politica
...
Alterando arquivo de variáveis usadas na politica
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 Depuradorpelo 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
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.
Tela do Depurador
...
Criando uma Workspace
O usuário pode criar uma workspace ou reconfigurar a workspace atual, inserindo outros casos e inserindo ou alterando os arquivos utilizados.
Para criar uma nova workspace clique no
menumenu "Workspace/Novo".
Criando a workspace
...
Definindo um novo caso
Clique com o botão direito do mouse no ícone de workspace. Clique
emem "Novo Caso". Dê um nome e uma descrição para o caso e clique em "OK".
Um caso é o conjunto da política, seus arquivos de variáveis e resultado final da execução.
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".
Ativando caso
...
Atribuindo os arquivos de depuração
- Caso a política possua variáves variáveis internas ou variáveis de trabalho ou acessos, então, deverão ser informados os arquivos contendo essas variáveis.
- Deverá ser clicado o botão direito do mouse no ícone do tipo de arquivo, depois em em "Adicionar".
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.
Removendo arquivos de variáveis
...
Salvando a Workspace
- Para salvar a workspace clique no menu menu "Workspace/Salvar". Dê um nome e clique em salvar"Salvar".
- O arquivo da workspace possui a extensão ".ini".
Gravando a workspace em arquivo
Gravando a workspace em arquivo
...
Abrindo uma workspace existente
- Para abrir uma workspace clique no menu menu "Workspace/Abrir" ou clique no ícone "abre workspaceAbrir Workspace" na barra lateral de atalhos. Selecione um arquivo e clique em "Abrir".
Abrindo a workspace gravada em disco
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 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 menu "Depurar/Entrar", com o cursor posicionado na linha da chamada da Subpolitica Subpolítica ou utilizar o atalho na barra lateral.
Depurando a politica
Depurando a politicapolítica
Nota |
---|
Para facilitar o uso destas funcionalidades foram criadas as seguintes teclas de atalho: F5 - Iniciar Depuração |
- 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 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 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
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 menu "Depurar/Parametrização do debuggerDebugger".
Tela do Depurador
Tela do Depurador
...
Nota |
---|
Saiba mais
|
...
|
...
...
...
|
...
...
...
|
...
...
...
|
...
...
...
|
...