Histórico da Página
01. DADOS GERAIS
| Linha de Produto: | SARA |
|---|---|
| Segmento: | SUPPLY CHAIN | Logística |
| Módulo: | Portaria, Operacional, Coletor de Dados e Consulta |
| Função: | Integração SARA com o aplicativo Meu Checklist da |
| Suíte Logística para o pré-gate de vistoria de Contêiner e geração de termo de contêiner | |
| Requisito/Story/Issue (informe o requisito relacionado) : | DLOGPORTOS-9968 |
|---|
02. SITUAÇÃO/REQUISITO
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
Os 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.
...
| tabs | 1 - Pré-requisitos, 2 - Configuração de Autenticação, 3 - Parametrização e Ativação, 4 - Montagem da Lista de Executores,5 - Procedimento de Utilização |
|---|---|
| ids | passo1,passo2,passo3,passo4,passo5 |
| Totvs custom tabs box items | ||||
|---|---|---|---|---|
| ||||
Para que a integração possa ser ativada no sistema SARA, primeiramente deve possuir a solução do aplicativo Meu Checklist da TOTVS e um roteiro cadastrado no aplicativo que obedeça as seguintes regras:
|
| Totvs custom tabs box items | |||||||||
|---|---|---|---|---|---|---|---|---|---|
| |||||||||
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 no formato "INI" do SARA, utilizado para identificar as configurações de acesso a base de dados, os seguintes novos itens conforme modelo sugerido abaixo:
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 | ||||
|---|---|---|---|---|
| ||||
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:
|
| Totvs custom tabs box items | ||||
|---|---|---|---|---|
| ||||
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:
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.
|
...
| default | no |
|---|---|
| referencia | passo5 |
...
| tabs | 1 - Pontos de Atenção, 2 - Portaria, 3 - Operacional, 4 - Coletor de Dados, 5 - Consulta |
|---|---|
| ids | proc1,proc2,proc3,proc4,proc5 |
...
| 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
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
Informações detalhadas sobre a solução dessa situação podem ser obtidas no documento do processo: Vistoria de contêiner em pré-gate com o aplicativo Meu Checklist integrado ao SARA.
04. DEMAIS INFORMAÇÕES
- Não se aplica.
05. ASSUNTOS RELACIONADOS
- Não se aplica.
...
| default | no |
|---|---|
| referencia | proc2 |
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.
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.
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.
...
| default | no |
|---|---|
| referencia | proc3 |
Fluxo Padrão
No início da OS o SARA verificará 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, senão 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.
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.
...
| default | no |
|---|---|
| referencia | proc4 |
Fluxo Padrão
Assim como no módulo Operacional, no Coletor de Dados, no início da OS o SARA verificará 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, senão 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.
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.
...
| default | no |
|---|---|
| referencia | proc5 |
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.
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. Esta 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.
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.
...
Card documentos Informacao Esta implementação é valida somente para a versão do módulo compilado no DELPHI 10 - TOKYO. Titulo IMPORTANTE!
...
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas