...
Desenvolver solução para integração do SARA com o aplicativo Meu Checklist da Suíte logística. O aplicativo será utilizado como uma solução para realizar a vistoria de contêineres em pré-gate, ou seja, realizar a vistoria do estado do contêiner antes da entrada deste na unidade. Nesta vistoria, caso sejam identificados avarias, será registrado no aplicativo meu checklist pelo executor e, posteriormente o caminhão será liberado ou não para a entrada no terminal. As vistorias realizadas no aplicativo que possuírem avarias deverão ser registradas no SARA como um termo de avarias de contêiner de forma automatizada, permitindo inclusive no módulo Consulta do SARA, visualizar as fotos registradas durante a vistoria com o aplicativo meu checklist.
03. SOLUÇÃO
as prefeituras de São Paulo e Campinas diretamente através de Web Service, substituindo o processo manual de geração de arquivo texto e upload na página da prefeitura.
03. SOLUÇÃO
Para a unidade de Campinas foi realizado a substituição da Rotina de integração que utilizava a DLL LoteNFSE.dll, pois a mesma utilizava outra dll, NFSE_Util.dll para realizar a assinatura, que por usa vez trazia em uma mensagem em caixa alta solicitando a seleção do certificado. Portanto foi realizado a substituição de toda a rotina por outra que monta o arquivo XML, realiza a assinatura e realiza a integração com a prefeitura via Web Service.
Para a unidade de SP, onde só existia a geração de arquivo texto, foi substituído a rotina por outra que monta o arquivo XML, realiza a assinatura e realiza a integração com a prefeitura via Web ServiceOs clientes que adquirem a solução do aplicativo Meu Checklist, para a realização de vistoria de contêineres em pré-gate, passam a contar com a integração entre o sistema SARA e o aplicativo. A integração irá permitir o processo de registrar pendência de checklist para um contêiner que entrará na unidade, gerar o termo de contêiner de forma automática com os dados registrados no aplicativo e a consulta do termo com visualização das fotos registradas no aplicativo.
Totvs custom tabs box |
---|
tabs | 2 - Configuração de Autenticação, 3 - Parametrização e Ativação, 4 - Montagem da Lista de Executores,5 - Procedimento de Utilização |
---|
ids | passo2,passo3,passo4,passo5 |
---|
|
Totvs custom tabs box items |
---|
default | yes |
---|
referencia | passo2 |
---|
| O sistema SARA só será capaz de se comunicar com o serviço do aplicativo Meu Checklist possuindo os dados para autenticação e acesso ao cliente. Desse modo, deverá ser configurado no arquivo formato "INI" do SARA, utilizado para identificar as configurações de acesso a base de dados. Os seguintes novos itens devem ser configurados conforme modelo sugerido abaixo: Bloco de código |
---|
language | text |
---|
theme | Eclipse |
---|
title | Modelo de configuração |
---|
| [MEU_CHECKLIST_CONFIG]
encrypted=0
clientid=identificação fornecida pelos responsáveis do aplicativo meu checklist
clientsecret=senha fornecida pelos responsáveis do aplicativo meu checklist
tenant=identificação fornecida pelos responsáveis do aplicativo meu checklist sem adicionar a instrução "tenant:"
username=usuario fornecido pelos responsáveis do aplicativo meu checklist
password=senha de usuário fornecido pelos responsáveis do aplicativo meu checklist |
A instrução encrypted com o valor 0 indica ao sistema SARA que os dados cadastrados não estão criptografados. Após a primeira utilização da integração no sistema SARA o valor será alterado automaticamente para 1 e todos os demais itens serão criptografados. Caso seja necessário alterar a configuração para autenticação, o valor deste parâmetro deverá ser retornado para 0 e todos os itens deverão ser alterados novamente, permitindo novo processo de criptografia na utilização do sistema SARA. Caso este item não seja tomado com atenção, a autenticação com o serviço do aplicativo meu checklist não ocorrerá. |
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo3 |
---|
| Para a ativação da integração do aplicativo Meu Checklist, para vistoria de contêiner em pré-gate, deverão ser cadastrados os seguintes parâmetros no módulo sistema do SARA na tela de Parâmetros: - SL_MEUCHECKLIST_ATIVA_INTEGRACAO_PRE_GATE_CNT: define a ativação da integração com o aplicativo Meu Checklist para vistoria de contêiner em pré-gate. Valor S ativa a integração e valor N desativa. Valor padrão N;
- SL_MEUCHECKLIST_EXECUTOR_IS_CONFERENTE_TERMO: define se o conferente do termo de contêiner no SARA será o executor do checklist no aplicativo. Valor S define que o executor do checklist será o conferente no termo. Quando o valor for N o conferente será o mesmo do início da OS. Valor padrão N;
- SL_MEUCHECKLIST_ID_LOCALIDADE_PRE_GATE_CNT: define o código da localidade padrão para a execução do checklist de vistoria de contêiner no pré-gate. Valor padrão em branco, mas deverá obrigatoriamente ser configurado com um valor registrado no aplicativo Meu Checklist;
- SL_MEUCHECKLIST_ID_ROTEIRO_PRE_GATE_CNT: define o código do roteiro de vistoria em pré-gate que será utilizado para o envio da pendência ao aplicativo Meu Checklist. Valor padrão em branco, mas deverá obrigatoriamente ser configurado com um código de roteiro de vistoria de contêiner registrado no aplicativo.
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo4 |
---|
| Os executores de checklist no aplicativo podem envolver executores que não pertencem ao grupo que realiza vistoria de contêiner no pré-gate. Por esse motivo, no SARA será necessário montar a lista de executores de checklist que farão parte do grupo que realiza a vistoria de contêiner no pré-gate. Para fazer isso, deverá ser acessado no SARA a tela de "De-para" disponível no menu Cadastro / De → Para no módulo Sistema e seguir os seguintes passos: - Obter a lista de executores com seus respectivos identificadores com os responsáveis pelo aplicativo Meu Checklist;
- Registrar um novo de-para para cada executor escolhido para pertencer ao grupo de executores de checklist de vistoria de contêiner em pré-gate;
- Cada novo registro deverá:
- ser selecionado no Nome do sistema o item descrito como "SL - Meu Checklist";
- escolher o Tipo de tabela como "Físico";
- apontar no campo Tabela SARA a tabela "TAB_USUARIOS";
- escolher o Tipo campo como "Físico";
- apontar no campo Campo SARA o campo "USU_ID";
- apontar no campo Valor SARA o código de identificação de usuário no SARA (exemplo: C05902953901). O código de identificação deverá ser um código existente de usuário no SARA;
- apontar no campo Valor sistema o código de identificação de executor no aplicativo meu checklist (exemplo: C23D7F1A-89B2-4838-85FF-EAC49057C433). O código de identificação informado deverá pertencer a lista de executores do aplicativo Meu Checklist; e, por fim;
- apontar no campo Descrição o nome do executor do checklist de vistoria de contêiner em pré-gate.
Sem a devida configuração da lista de executores, o SARA não será capaz de gerar uma pendência de checklist para um executor na vistoria de contêiner em pré-gate. A imagem abaixo ilustra o registro de um executor de checklist de vistoria de contêiner em pré-gate no SARA. ![](/download/attachments/545634416/image2020-1-30_13-59-5.png?version=1&modificationDate=1586290354453&api=v2)
|
Totvs custom tabs box items |
---|
default | no |
---|
referencia | passo5 |
---|
| Totvs custom tabs box |
---|
tabs | 1 - Pontos de Atenção, 2 - Portaria, 3 - Operacional, 4 - Coletor de Dados, 5 - Consulta |
---|
ids | proc1,proc2,proc3,proc4,proc5 |
---|
| Totvs custom tabs box items |
---|
default | yes |
---|
referencia | proc1 |
---|
| Em situações em que o terminal encontrar-se sem conexão com a internet para acesso ao serviço do aplicativo do Meu Checklist, o sistema SARA pode identificar a ausência de conexão e solicitar a escolha do usuário se deseja prosseguir sem a integração com o aplicativo temporariamente. O SARA adotou esta abordagem para não travar a operação de entrada dos veículos no terminal e nem a barragem da execução das ordens de serviço em caso de problemas técnicos no terminal. Entretanto, ao permitir prosseguir sem a integração, por falta de conexão com a internet, causará a perda da integração até que a conexão com a internet e comunicação com o serviço do aplicativo Meu Checklist seja restabelecido. Por esse motivo, este item deve ser abordado com uma devida atenção na utilização no sistema. Na tela do CESV, caso escolha desativar a integração, a tela do executor do checklist não será mais solicitada. Se a conexão com a internet for restabelecida, feche a tela de registro do CESV e abra novamente para efetuar nova autenticação com o servidor do aplicativo e voltar a escolher o executor do checklist. A imagem abaixo ilustra uma situação no início de uma OS com o sistema sem conexão com a internet ![](/download/attachments/545634416/image2020-1-30_14-53-42.png?version=1&modificationDate=1586290354557&api=v2)
Mesmo sem a integração para a geração do termo de contêiner ter sido executado automático por falta de conexão com a internet, caso o checklist de vistoria de contêiner tenha ocorrido no aplicativo Meu Checklist, ao gerar o termo manualmente no SARA, e quando a conexão estiver restabelecida, o módulo consulta será capaz de recuperar as fotos tiradas no aplicativo para as partes do contêiner registradas com avaria, desde que as partes do contêiner registradas manualmente no termo do SARA sejam as mesmas registradas na vistoria de contêiner pelo checklist.
Módulos que permitem desativar a integração temporariamente quando iniciado sem conexão com a internet - Portaria
- Operacional
- Coletor de Dados
|
Totvs custom tabs box items |
---|
| Fluxo Padrão No registro de CESV, ao gravar, o sistema irá identificar se possui contêiner na operação e, caso exista, irá exibir tela solicitando o executor para o checklist de vistoria de contêiner em pré-gate. Ao selecionar o executor e acionar OK, o sistema irá gerar uma pendência de checklist de vistoria de contêiner para o executor escolhido. ![](/download/attachments/545634416/image2020-1-30_17-25-48.png?version=1&modificationDate=1586290354597&api=v2)
Fluxo Alternativo No registro do CESV, se for necessário remover um contêiner já adicionado e integrado com o aplicativo Meu Checklist, o SARA fará uma verificação se a OS (ordem de serviço) do CESV já foi executado e o termo de contêiner já gerado. Caso não tenha termo de contêiner, ou termo cancelado, o sistema permitirá excluir o contêiner no CESV e irá cancelar o checklist de vistoria de contêiner no aplicativo Meu Checklist. Caso possua termo, irá exibir mensagem conforme imagem abaixo bloqueando a remoção do contêiner da OS. ![](/download/attachments/545634416/image2020-1-30_17-34-41.png?version=1&modificationDate=1586290354633&api=v2)
Se for necessário adicionar um novo contêiner ao CESV com contêiner já integrado, o sistema irá gerar a nova pendência de checklist. Entretanto, se a OS vinculada ao CESV já estiver iniciada, o sistema não gerará nova pendência de checklist para o contêiner adicionado, pois o SARA entende que o contêiner já encontra-se dentro da unidade e não está disponível no pré-gate para vistoria. A imagem abaixo ilustra uma situação em que um contêiner foi adicionado posteriormente ao CESV e início da OS. ![](/download/attachments/545634416/image2020-1-30_18-21-38.png?version=1&modificationDate=1586290354670&api=v2)
|
Totvs custom tabs box items |
---|
| Fluxo Padrão No início da OS, o SARA fará a verificação se todos os checklists dos contêineres relacionados à OS estão finalizados no serviço do aplicativo Meu Checklist. Caso estejam finalizados, o sistema automaticamente irá gerar o termo de contêiner com base nos dados coletados no aplicativo. O conferente do termo será associado automaticamente, mas, se o parâmetro SL_MEUCHECKLIST_EXECUTOR_IS_CONFERENTE_TERMO estiver configurado como S o conferente será o executor no aplicativo Meu Checklist, caso contrário, será o conferente apontado para a OS. O termo gerado após o início da OS poderá ser conferido já na tela de avarias da OS conforme ilustra imagem abaixo selecionando o conferente correspondente. ![](/download/attachments/545634416/image2020-2-4_14-1-0.png?version=1&modificationDate=1586290354810&api=v2)
Caso nenhuma avaria seja apontada para nenhuma parte do contêiner no aplicativo, nenhum termo será gerado.
Fluxo Alternativo Se no início da OS o SARA identificar que algum contêiner relacionado a OS não está com o checklist finalizado no serviço do aplicativo Meu Checklist, o início da OS será bloqueado. Após todos os checklists relacionados serem concluídos e sincronizados com o serviço do aplicativo Meu Checklist, o SARA irá iniciar a OS normalmente e gerar os termos de contêiner automaticamente. A imagem abaixo ilustra um momento em que no início da OS o checklist ainda não está concluído e sincronizado com o serviço do aplicativo Meu Checklist. ![](/download/attachments/545634416/image2020-2-4_12-8-19.png?version=1&modificationDate=1586290354757&api=v2)
|
Totvs custom tabs box items |
---|
| Fluxo Padrão Assim como no módulo Operacional, no Coletor de Dados, no início da OS o SARA fará verificação se todos os checklists dos contêineres relacionados à OS estão finalizados no serviço do aplicativo Meu Checklist. Caso estejam finalizados, o sistema automaticamente irá gerar o termo de contêiner com base nos dados coletados no aplicativo. O conferente do termo será associado automaticamente, mas, se o parâmetro SL_MEUCHECKLIST_EXECUTOR_IS_CONFERENTE_TERMO estiver configurado como S o conferente será o executor no aplicativo Meu Checklist, caso contrário, será o conferente apontado para a OS. O termo gerado após o início da OS poderá ser conferido já na tela de avarias da OS conforme ilustra imagem abaixo. ![](/download/thumbnails/545634416/image2020-2-4_15-45-49.png?version=1&modificationDate=1586290354893&api=v2)
Caso nenhuma avaria seja apontada para nenhuma parte do contêiner no aplicativo, nenhum termo será gerado.
Fluxo Alternativo Idêntico ao módulo Operacional, no Coletor de Dados, se no início da OS o SARA identificar que algum contêiner relacionado a OS não está com o checklist finalizado no serviço do aplicativo Meu Checklist, o início da OS será bloqueado. Após todos os checklists relacionados serem concluídos e sincronizados com o serviço do aplicativo Meu Checklist, o SARA irá iniciar a OS normalmente e gerar os termos de contêiner automaticamente. A imagem abaixo ilustra um momento em que no início da OS o checklist ainda não está concluído e sincronizado com o serviço do aplicativo Meu Checklist. ![](/download/thumbnails/545634416/image2020-2-4_15-48-49.png?version=1&modificationDate=1586290354937&api=v2)
|
Totvs custom tabs box items |
---|
| Fluxo Padrão No módulo consulta, em consulta genérica por TFA/TFE e em consulta genérica por contêiner, será possível visualizar o termo integrado com o Meu Checklist e visualizar as fotos das partes dos contêineres tiradas durante o procedimento de vistoria do contêiner no pré-gate. Nessas duas consultas, na listagem das partes do contêiner estará disponível a coluna Fotos, e quando a parte do contêiner possuir foto tirada no aplicativo Meu Checklist, aparecerá na linha correspondente um botão Visualizar com a quantidade de fotos tiradas para aquela parte do contêiner. As imagens abaixo ilustram a tela de TFA/TFE e Consulta por Contêiner com as mudanças na visualização do termo com a coluna de fotos e os botões de visualizar. ![](/download/attachments/545634416/image2020-2-4_16-30-57.png?version=1&modificationDate=1586290355017&api=v2)
Caso uma parte do contêiner não possuir fotos tiradas no aplicativo, esta parte não terá o botão Visualizar na coluna Fotos. Ao acionar com o mouse um botão para visualizar foto, o SARA abrirá uma tela de visualização das fotos consultando diretamente no servidor do aplicativo Meu Checklist. Essa tela permitirá salvar a imagem que está selecionada ou salvar todas as imagens listadas em um diretório de livre escolha do usuário. A imagem abaixo ilustra a tela de visualização de fotos de uma determinada parte de contêiner registrada no aplicativo. ![](/download/attachments/545634416/image2020-2-4_16-35-22.png?version=1&modificationDate=1586290355057&api=v2)
Fluxo Alternativo Se ao abrir uma das consultas mencionadas no fluxo padrão e a conexão com a internet não estiver disponível, o SARA exibirá mensagem informando problemas com a conexão e não apresentará a coluna Fotos para visualização, na listagem das partes do contêiner. A imagem abaixo ilustra uma situação em que a conexão com a internet não está disponível. ![](/download/attachments/545634416/image2020-2-4_16-41-55.png?version=1&modificationDate=1586290355103&api=v2)
|
|
|
|
...