Páginas filhas
  • Manual do Usuário - Compilador

Versões comparadas

Chave

  • Esta linha foi adicionada.
  • Esta linha foi removida.
  • A formatação mudou.

...

Para inserir as variáveis, selecionar o bloco e em seguida clique na variável desejada.

   

Após o clique  a variável será inserida.

         

Para apagar um elemento do código da política, basta selecionar o texto desejado e clicar no botão "Apagar".

        

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.

            

Para gravar a política deverá ser clicado o botão "Grava" ou a opção "Política/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

                   

  • 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

                              

Elementos de uma Política
 

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

      

  • 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.

...

                     

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.

Exemplo:

 

Informações

// TOTVS Software SA

// Data 27/05/2013

// Demonstrando o uso do elemento 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".

Exemplo:

 

Informações
<Variável> := f_somaDiasData ( $Data $Numero )

 

 

  • Função na Politica

                   

SubPolíticas
 

...

  • Crie uma nova variável de Trabalho ou use uma existente.

                    

  • Nova variável de Trabalho

                  

  • Adicione um 'Bloco' que irá receber a variável de Trabalho.

...

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.

...

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

              

...

Validando acessos

                 

  • 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

Após importar o Acesso, ou a qualquer momento após a importação, você pode inspecionar os dados de Envio e Retorno do Acesso.  Ao clicar no botão "Envio", são exibidas as variáveis de entrada do acesso.

                        

  • Ao clicar no botão "Retorno", são exibidas as variáveis de saída do acesso.

                      

 

Nota

No arquivo "XML" do layout do acesso, existe um parâmetro counter para cada conjunto de registros de saída. Caso esse parâmetro possua um valor igual ou superior a 2, então o conjunto de registros de saída gerados, será multiplicado por esse número e cada registro possuirá o numero no final do nome para que seja identificada a sua ocorrência.

                    
Associação entre as variáveis de envio do acesso e as variáveis internas da política (
binding)
 
  • Para cada Acesso importado, será necessário fazer a ligação das variáveis de envio do Acesso com as variáveis Internas do compilador.

  • Uma politica ao chamar um acesso, consegue passar valores para esse acesso através das variáveis internas que estiverem associadas às variaveis de entrada do acesso na tela de envio.

  • Podem ser criadas quantas variáveis internas se desejar no compilador. Algumas variáveis já vem criadas na instalação inicial.

  • 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.

  • 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. 
                
                 
  • 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 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).

               

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.
          

Atualizar os Parâmetros de Envio
 

...

                          

  

     

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.


                          

  • 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".

                                   

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  Observe que já existem as variáveis obrigatórias devolvidas pela Política. Para  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.     
    
Configurando De x Para de Variáveis
 
  • É possível fazer associações De x Para para as variáveis de Entrada/Saída, usando os botões 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

...

Image Added

     

  • 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

...

Image Added

 


  • 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

...

Image Added

               
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

Image Removed

Image Added

                     

  • 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.

...