Utilização dos momentos de execução
Na abertura de um chamado, o Qualitor procede da seguinte forma:
1) O usuário clica no botão “Processar” para registrar um chamado;
2) O Qualitor valida os campos preenchidos, parâmetros e regras de negócio necessárias para abrir um chamado;
3) Quando o Qualitor estiver pronto para abrir o chamado:
3.1) O Qualitor verifica a existência da pasta /gtw/modules/hd
3.2) O Qualitor verifica a existência do arquivo GTWNewTicket.class.php
3.3) O Qualitor verifica a existência de uma função dentro do arquivo: checkBeforeNewTicket.
3.4) O Qualitor executa a função e verifica o retorno. Dependendo do retorno, ele prossegue com a abertura do chamado.
Para o Qualitor compreender o retorno de uma função, no momento “Before” de uma operação, é necessário retornar para o Qualitor um dos seguintes valores:
✓OK: Informa ao Qualitor que o mesmo deve exibir uma janela de “Informação” com um botão de “OK” para o usuário clicar e continuar o processo da operação. Pode acompanhar uma mensagem a ser exibida na janela.
✓ERROR: Informa ao Qualitor que o mesmo deve exibir uma janela de “Erro” com um botão de “OK” para o usuário clicar e cancelar o processo da operação. Pode acompanhar uma mensagem a ser exibida.
✓QUESTION: Informa ao Qualitor que o mesmo deve exibir uma janela de “Pergunta”, com um botão de “Sim” e outro botão de “Não”. Se o usuário clicar em “Sim”, irá continuar o processo, se o usuário clicar em “Não”, irá cancelar o processo. Pode acompanhar uma mensagem a ser exibida na janela.
✓CONTINUE: Apenas prossegue com a operação. Não há mensagem.
✓POPUP: Exibe uma POPUP com uma URL especificada, após executar a operação. Por exemplo, quando é necessário abrir uma página para preenchimento de dados adicionais a serem alimentados em outros sistemas, sempre que um chamado for aberto.
Na figura a seguir, temos um exemplo de retorno.
Para visualizá-lo, devemos abrir o arquivo PHP. A seguinte imagem será exibida:
Detendo-se no código:
public function checkBeforeNewTicket ($conn, $arrayData, $arrayInfo, $idContext)
{
return array(‘txt’ => ‘ANTES DE ABRIR O CHAMADO PODE-SE EXIBIR UMA MENSAGEM AO USUÁRIO!!’, ‘flow’ => ‘ok’);
}
É possível destacar que “checkBeforeNewTicket” corresponde à criação da função “Before” para o registro de Chamados.
O código ($conn, $arrayData, $arrayInfo, $idContext), corresponde à área de argumentos, padrão das funções de GTW do Qualitor.
A parte do código que diz respeito à “return”, é um comando que retorna uma informação. Na função, estamos colocando um comando que irá retornar um “Array” (Matriz) contendo as informações necessárias para o Qualitor. O Qualitor espera receber uma Matriz das funções, contendo a seguinte estrutura:
O FLOW contém a identificação do retorno, para o Qualitor, informando qual fluxo ele deve tomar, na sua execução, e o TXT contém a mensagem a ser utilizada junto com este retorno.
O resultado final disso tudo no Qualitor é demonstrado no esquema a seguir:
1) Usuário clica no botão “Processar”.
2) O chamado então, não é aberto.
3) Uma mensagem é exibida, o que prova que o retorno do gateway está ok.
4) Após clicar no botão “Ok”, o chamado continuará a ser aberto.
O gateway para execução após a abertura de chamados é o seguinte:
/qualitor/gtw/modules/hd/GTWNewTicket.class.php
Os dois “momentos” ficam no mesmo arquivo de gateway.
Declaração do gateway para o momento “After” é igual ao momento “Before”.
<?php
class GTWNewTicket
{
function __construct()
{
;
}
public function checkBeforeNewTicket ($conn, $arrayData, $arrayInfo, $idContext)
{
return array(‘txt’ => ‘MENSAGEM A EXIBIR AO USUÁRIO!!’, ‘flow’ => ‘ok’);
}
public function checkAfterNewTicket ($conn, $arrayData, $arrayInfo, $idContext)
{
return array(‘flow’ => ‘popup’, ‘url’ => ‘http://www.google.com’);
}
}
?>
Detendo-se no código:
public function checkAfterNewTicket ($conn, $arrayData, $arrayInfo, $idContext)
{
return array(‘flow’ => ‘popup’, ‘url’ => ‘http://www.google.com’);
}
É possível destacar que “checkAfterNewTicket” corresponde à criação da função “After” para o registro de Chamados.
O código ($conn, $arrayData, $arrayInfo, $idContext), corresponde à área de argumentos, padrão das funções de GTW do Qualitor.
A parte do código que diz respeito à “return”, é um comando que retorna uma informação. Na função, estamos colocando um comando que irá retornar um “Array” (Matriz) contendo as informações necessárias para o Qualitor. O Qualitor espera receber uma Matriz das funções, contendo a seguinte estrutura:
O FLOW contém a identificação do retorno, para o Qualitor, informando qual fluxo ele deve tomar, na sua execução, e o URL contém o link a ser utilizado junto com este retorno.
O resultado final disso tudo no Qualitor é demonstrado no esquema a seguir:
1) Usuário clica no botão “Processar”.
2) O chamado é aberto.
3) O retorno do gateway é a abertura de uma nova janela com o link.
