Histórico da Página
...
O objetivo deste guia é auxiliar o suporte e desenvolvedores da plataforma a ativar e compreender um novo conjunto de mensagens de log que trazem informações relevantes sobre a solicitação Workflow de processo durante as fases de abertura e movimentação, passando por eventos de processo e Datasets datasets que venham a ser consultados dentro desses eventos.
Os tópicos a seguir irão demostrar demonstrar como ativar essas mensagens e farão uma breve descrição de todos os campos retornados.
Pré-requisitos
...
Para ativar e monitorar as mensagens de log, é importante conhecer o procedimento de Gestão de logs.
Ativando o modo Debug nos pacotes que possuem o novo padrão de mensagem.
| Painel |
|---|
Para ativação das mensagens o analista ou desenvolvedor deverá ter executado previamente os passos do guia Ativar |
...
...
...
| Nota | ||
|---|---|---|
| ||
A ativação do modo Debug pode causar impacto na performance da plataforma, portanto habilite-a apenas quando necessário e desative-a ao concluir a análise. |
Feitos estes passos é necessário cadastrar três categorias de log:
com.datasul.technology.webdesk.customization | DEBUG |
com.datasul.technology.webdesk.dataset | DEBUG |
com.datasul.technology.webdesk.workflow.engine | DEBUG |
Cadastradas as 3 categorias, as mensagens no novo formato irão começar a aparecer no log.
Mensagens de ações em tela tela
...
As mensagens de ações em tela irão começar trazendo o número da solicitação no inicio da mensagem. Supondo que a solicitação que estamos monitorando tenha o número 107 então o começo da linha será formado desta forma:
"[Solicitacao: 107]"
Em seguida seguem Veja a seguir os campos que acompanham a mensagem:
| Campo | Descrição |
|---|---|
| Evento | Acontecimento realizado pelo usuário através da interface do fluig executado dentro do motor de Workflow. São exemplos de eventos:
|
| Atividade Atual | Traz informações sobre a tarefa atual. Geralmente é retornado o código da atividade que pode ser verificado nos modeladores de workflow do fluig. As vezes também é retornado o nome da atividade. |
| Usuário Executor | Usuário que executou a tarefa. ColleagueId do usuário que executou a tarefa. O usuário que executou a tarefa não necessariamente é o usuário responsável. Lembre-se que o gestor e o substituto podem executar tarefas em nome do usuário responsável. |
| Gestor | Retorna se o usuário executor é gestou ou não |
| Substituto | Retorna se o usuário é substituto ou não. |
...
Mensagens exibidas antes e depois da execução de um evento de customização de processo
...
Alem Além do cabeçalho inicial já citado no tópico anterior são impressas as seguintes informações:
Em seguida seguem os campos que acompanham a mensagem :
| Campo | Descrição |
|---|---|
| Processo | Código e descrição do processo. |
| Versão | Versão do processo da onde está sendo executado aquele evento. |
| Atividade | Atividade aonde o evento está sendo executado. |
| Usuário Executor | Usuário que irá executar o evento do processo. |
| Gestor | Retorna se o usuário executor é gestou ou não |
| Substituto | Retorna se o usuário é substituto ou não. |
| Evento | Código do Evento. |
| Mensagem | Mensagem extra que trará informações diferentes de acordo com o evento executado ou retornará a mensagem de erro caso ocorra algum. |
...
Mensagens exibidas na invocação dos métodos de
...
personalização de processo
...
...
Essas mensagens são executadas no exato momento em que o motor de javascript JavaScript será invocado para rodar os scripts passando informações de motor de workflow como parâmetro.
Alem Além do cabeçalho inicial já citado no tópico anterior são impressas as seguintes informações:
Em seguida seguem os campos que acompanham a mensagem :
| Campo | Descrição |
|---|---|
| Processo | Código e descrição do processo. |
| Versão | Versão do processo da onde está sendo executado aquele evento. |
| Atividade | Atividade aonde o evento está sendo executado. |
| Usuário Executor | Usuário que irá executar o evento do processo. |
| Gestor | Retorna se o usuário executor é gestou ou não |
| Substituto | Retorna se o usuário é substituto ou não. |
| Estado atual | Código do estado atual da solicitação workflow. Trará apenas o código e não a descrição da atividade. |
| Estado Destino | Trará o código do estado destino (quando possível). Trará apenas o código e não a descrição da atividade. |
| Evento executado | Retornará o nome do evento que está sendo executado naquele momento. |
| Parâmetros | Trará a lista de parâmetros que estão sendo passados para o evento. Exemplo de lista de parametros passados para o evento BeforeTaskComplete: Parâmetros: [param1=claudia,param2=4,param3=[Andressa]] |
Mensagens exibidas na consulta de datasets
...
Essas mensagens serão exibidas na consulta de qualquer dataset do produto independente da forma e do local aonde em que ela é feita. Consultas realizadas no pelo plugin do fluig Studio, por eventos de processo, por zooms, em chamadas XMLRPC dentro do formulário ou mesmo dentro de eventos do processo.
...
Segue a lista de colunas que serão exibidas ao consultar um dataset no fluig.
| Campo | Valor |
|---|---|
| Executando Dataset |
| Código - Descrição do dataset sendo consultado | |
| Tipo | Tipo do dataset. |
Os datasets podem ser: internos, simples ou avançados. Para conhecer as diferenças sobre esses tipos, acesse a documentação Desenvolvimento de Datasets. | |
| Tipo de acesso a dados | Retorna dois tipos possíveis de acessos a dados:
|
| |
| Campos Solicitados | Lista de campos que foram solicitados para o dataset |
| retornar. |
| Constraints | Lista de |
Constraints que foram passadas para a consulta do dataset. Os campos que uma constraint possuem são:
|
|
...
Para datasets do tipo offline Além , além das informações acima também são trazidos os seguintes campos:
| Campo | Valor |
|---|---|
| Última |
| sincronização | Data e hora da última sincronização desse dataset. |
| Taxa de |
| aderência | Nível de aderência que aquele dataset possui para sincronização com o mobile. |
| Id |
| metalista | Id da metalista |
| onde estão sendo armazenados os valores daquele dataset. |
| Cache |
| mobile | Retorna se, para aquele dataset |
| , está habilitada a opção de uso do cache em dispositivos móveis. |
Filtrando as novas mensagens de log
...
...
Através da Strings "[Solicitacao: Número da solicitação]" e "Executando Dataset=Código do dataset" é possível rastrear o comportamento de uma solicitação workflow ou verificar e replicar todos os tipos de acesso que um dataset teve dentro da plaformar plataforma fluig.
Aconselhamos o uso de ferramentas de log que trabalhem com os conceitos de Filtros e Highlighting (Realce) para facilitar a compreensão do que está acontecendo dentro do ambiente do seu cliente.
Durante o desenvolvimento inicial deste novo padrão de mensagens foi utilizada a ferramenta LogExpert que trabalha com implementa esses conceitos e que trabalha com a Licença MIT, podendo ser utilizado gratuitamente por profissionais dos mais diversos perfis.
Outras ferramentas para análise de log podem ser encontradas no guia Análise de log do dev.fluig.O desenvolvimento de mensagens neste novo padrão está longe de ter terminado. com.
| Informações | ||
|---|---|---|
| ||
Em futuras versões do fluig serão implementadas mais - e melhores - mensagens que irão facilitar o dia a dia |
...
dos desenvolvedores que precisam localizar a causa de |
...
uma inconsistência dentro dos desenvolvimentos sobre a plataforma fluig. |
...
...
Import HTML Content
Visão Geral
Conteúdo das Ferramentas