Páginas filhas
  • Intellector 9 - API - Executando Políticas

Versões comparadas

Chave

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

...

advertencia IMPORTANTE! - não usar os caracteres & e < dentro das tags do XML de Entrada; use amp e lt, senão o mesmo não será interpretado, recebendo um simples retorno (-1) do servlet de execução de política.


Um XML de entrada de execução de política montado a para o layout acima:

Bloco de código
languagehtml/xml
linenumberstrue
<programa>P_TST_01</programa>
<layout>Layout_P_TST_01</layout>
<tipo>credito</tipo>
<usuario>admin</usuario>
<senha>tools01</senha>
<CPF>00000000191</CPF>
<?xml version="1.0" encoding="ISO-8859-1"?> 
<raiz>
    <campo>
    <!-- nome  <nom_campo>LPT__iRetorno</nom_campo>
da politica -->
	<programa>P_TST_01</programa>
       <cod_formato></cod_formato>
      <tipo_dado>Integer</tipo_dado> <!-- nome do usuário com permissão pra execucao -->
	<usuario>admin</usuario>
      <val_default></val_default>
    </campo>
    <campo>
      <nom_campo>D100_NOMEdummy</nom_campo>!-- senha do usuario -->
	<senha>senha_admin</senha>
      <cod_formato></cod_formato>
  <!-- tipo de  <tipo_dado>String</tipo_dado>politica -->
	<tipo>credito</tipo>
      <val_default></val_default>
    </campo>
    <campo>
      <nom_campo>DtSistema</nom_campo>
      <cod_formato>1</cod_formato>  <!-- layout para ser usado -->
	<layout>Layout_P_TST_01</layout>
      <tipo_dado>Date</tipo_dado>
  <!-- dados de  <val_default></val_default>
    </campo>
    ...
  </saida>
</programa>

...

entrada para a execução da politica -->
	<CPF>00000000191</CPF>
</raiz>
Dados de Saída
 
Bloco de código
languagehtml/xml
linenumberstrue
<?xml version="1.0" encoding="ISO-8859-1"?> 
<raiz>
        <!-- nome da politica -->
	<programa>politica_dummy</programa>
     O XML de saída é composto pelas variáveis de saída descritas no layout de política utilizado na execução e, pelas seguintes variáveis de controle:
   <!-- nomeUUID do- usuário com permissão pra execucao identificador unico -->
	<usuario>admin</usuario>
        <!-- senha do usuario -->
	<senha>senha_admin</senha>
        <!-- tipo de politica -->
	<tipo>credito</tipo>
        <!-- layout para ser usado -->
	<layout>Layout_politica_dummy</layout>
        <!-- dados de entrada para a execução da politica -->
	<CodCpf>21769796304</CodCpf>
	<DataNascimento>30011966</DataNascimento>
...
</raiz>
Dados de Saída
 
Bloco de código
languagehtml/xml
linenumberstrue
O XML de saída é composto pelas variáveis de saída descritas no layout de política utilizado na execução e, pelas seguintes variáveis de controle:

   <!-- UUID - identificador unico -->
   <LPT__CodExecucao>3176837B-00D1-4B50-8419-126650B0E114</LPT__CodExecucao>
   <LPT__iRetorno>0</LPT__iRetorno>
   <LPT__sAcao>NEGA CREDITO</LPT__sAcao>
   <LPT__sMsgErro></LPT__sMsgErro>

Vamos explicitar cada uma das variáveis de retorno acima, exceto o código de execução.

  1. LPT__iRetorno

        1 = ConfigException - exceção de erro na configuração do acesso

        2 = LayoutException - exceção de erro na configuração do layout

        3 = InfraException - exceção de erro de infraestrutura, como unknown host, certificados errados, autorização, timeout, etc.

        4 = InstantiationException  - exceção ao instanciar o acesso; erro na reflection

        5 = IllegalAccessException  - exceção ao instanciar o acesso; erro na reflection por acesso ilegal

        6 = ClassNotFoundException -  classe do acesso para reflection não encontrada

        7 = Erro na política  - exceto retorno do acesso.

        8 = Erros inesperados, ocorridos durante a execução/tratamento do retorno dos acessos.

        9 = Exceção - durante preenchimento das variáveis de retorno da política

        10 = Exceção durante a execução da politica e não referente a acessos.

  2. T__sAcao - contém a ação que a política retornou; pode ser:

    NEGA CREDITO

    APROVA CREDITO

    ANALISE

    MY_ACTION, YOUR_ACTION,... - uma ação qualquer definida pelo usuário.
     

  3. LPT__sMsgErro - contém uma mensagem de erro explicitada numa string

Controle do post:

Response status code: 200
Response body:

Um XML de retorno de uma execução:

Bloco de código
languagehtml/xml
linenumberstrue
<?xml version="1.0" encoding="ISO-8859-1"?>
<raiz>
   <D200_DATA_1dummy>02/12/2008</D200_DATA_1dummy>
   <INTEGER_VALUEdummy>69</INTEGER_VALUEdummy>
   <D100_MYDIRdummy>/home/jboss/intellector/acessos/dummy//resources/dummyaccess.xml</D100_MYDIRdummy>
   <D100_OUTROdummy>Pode me ver agora</D100_OUTROdummy>
   <D200_TIPO_1dummy>CORRUPTO</D200_TIPO_1dummy>
   <MensagemRetorno>CodCpf = 00000001910;;idade = 30;tem seguro;salario > 1000;variavel double > 5.2;</MensagemRetorno>
   <D200_VALOR_1dummy>171.69</D200_VALOR_1dummy>
   <BOOLEAN_VALUEdummy>true</BOOLEAN_VALUEdummy>
   <STRING_VALUEdummy>DUMMY</STRING_VALUEdummy>
   <DOUBLE_VALUEdummy>9999,99</DOUBLE_VALUEdummy>
   <DATE_VALUEdummy>02/12/2008</DATE_VALUEdummy>
   <D200_HORA_1dummy>23:59:59</D200_HORA_1dummy>
   <D100_NOMEdummy>Claudio dos Anzoes Pereira</D100_NOMEdummy>
   <D200_MOEDA_1dummy>real</D200_MOEDA_1dummy>
   <D100_DTNASCIMENTOdummy>02/12/2008</D100_DTNASCIMENTOdummy>
   <DtSistema>02/12/2008</DtSistema>
   <LPT__sMsgErrodummy></LPT__sMsgErrodummy>
   <LPT__CodExecucao>3176837B-00D1-4B50-8419-126650B0E114</LPT__CodExecucao>
   <LPT__iRetorno>0</LPT__iRetorno>
   <LPT__iRetornodummy>0</LPT__iRetornodummy>
   <LPT__sAcao>NEGA CREDITO</LPT__sAcao>
   <LPT__sMsgErro></LPT__sMsgErro>
</raiz>

Para cada política executada pelo TOTVS Intellector, será gerado um Código de Execução, retornado pela variável:

...

<LPT__CodExecucao>3176837B-00D1-4B50-8419-126650B0E114</LPT__CodExecucao>
   <LPT__iRetorno>0</LPT__iRetorno>
   <LPT__sAcao>APROVA</LPT__sAcao>
   <LPT__sMsgErro></LPT__sMsgErro>

Vamos explicitar cada uma das variáveis de retorno acima, exceto o código de execução.

  1. LPT__iRetorno

        1 = ConfigException - exceção de erro na configuração do acesso

        2 = LayoutException - exceção de erro na configuração do layout

        3 = InfraException - exceção de erro de infraestrutura, como unknown host, certificados errados, autorização, timeout, etc.

        4 = InstantiationException  - exceção ao instanciar o acesso; erro na reflection

        5 = IllegalAccessException  - exceção ao instanciar o acesso; erro na reflection por acesso ilegal

        6 = ClassNotFoundException -  classe do acesso para reflection não encontrada

        7 = Erro na política  - exceto retorno do acesso.

        8 = Erros inesperados, ocorridos durante a execução/tratamento do retorno dos acessos.

        9 = Exceção - durante preenchimento das variáveis de retorno da política

        10 = Exceção durante a execução da politica e não referente a acessos.

  2. T__sAcao - contém a ação que a política retornou; pode ser:

    APROVA

    MY_ACTION, YOUR_ACTION,... - uma ação qualquer definida pelo usuário.
     

  3. LPT__sMsgErro - contém uma mensagem de erro explicitada numa string
  4. LPT__CodExecucao - UUID - identificador único gerado a cada execução de política. Esse código pode ser utilizado posteriormente para consultar a execução da política.
  5. Também são retornadas as variáveis de saída definidas no layout de saída da política. No exemplo foi retornada a variável LIMITE com o valor 200.00.

Um XML de retorno de uma execução:

Bloco de código
languagehtml/xml
linenumberstrue

...

 

...

 

...

<?xml version="1.0" encoding="UTF-8"?>
<raiz>
	<LPT__sAcao>APROVA</LPT__sAcao>
	<LPT__sMsgErro/>
	<MensagemRetorno/>
	<LPT__iRetorno>0</LPT__iRetorno>
	<LPT__CodExecucao>24cf514d-c56b-498b-93a5-f4686cea4484</LPT__CodExecucao>
	<LIMITE>200.0</LIMITE>
</raiz>


Linha de Comando - Executando uma Política no TOTVS Intellector

...