Cadastro de Dispositivos

Documentação completa sobre a tela de Dispositivos do Portal EasyPAC: cadastro, listagem, edição e regras de controle de licenças para APPs em aparelhos móveis.

Informação importante: O sistema depende do vínculo do usuário logado com uma empresa e com um cliente (contratante) para funcionar corretamente em algumas operações.

Informação importante: Esta rotina não depende de nenhum módulo opcional do contrato, apenas das permissões de papel e dos vínculos descritos acima.

Observação importante: Um dispositivo recém-incluído é gravado com a situação informada no formulário. Se a situação de destino for Ativo e a quantidade de licenças já foi atingida, o sistema interrompe a operação e exibe: “Quantidade de licenças insuficientes para a ativação desse dispositivo.”

Empresa (filtro da listagem)

Tipo: seleção múltipla com busca (combo)

Obrigatoriedade: opcional

Descrição: permite restringir a listagem de dispositivos às empresas escolhidas pelo usuário.

Comportamento: lista apenas as empresas vinculadas ao usuário logado, com a opção “Todos” no topo. A busca dentro do combo ignora acentuação e diferença entre maiúsculas e minúsculas.

Impacto: o valor escolhido filtra os registros exibidos na grade; fica guardado no navegador durante a sessão e é restaurado ao reabrir a listagem após cancelar ou salvar um cadastro.

Situação (filtro da listagem)

Tipo: seleção múltipla com busca (combo)

Obrigatoriedade: opcional

Descrição: permite restringir a listagem de dispositivos pela situação atual (Ativo, Inativo ou Pendente).

Comportamento: lista as opções Ativo, Inativo e Pendente, com a opção “Todos” no topo. A busca ignora acentuação e diferença entre maiúsculas e minúsculas.

Impacto: filtra os registros exibidos na grade; fica guardado no navegador durante a sessão, com a mesma regra de restauração descrita no campo Empresa (filtro).

Suporte (filtro da listagem)

Tipo: seleção múltipla com busca (combo)

Obrigatoriedade: opcional

Descrição: permite restringir a listagem de dispositivos entre os que são de uso interno (Suporte) e os que não são.

Comportamento: lista as opções Sim e Não, com a opção “Todos” no topo. A busca ignora acentuação e diferença entre maiúsculas e minúsculas.

Impacto: filtra os registros exibidos na grade; fica guardado no navegador durante a sessão, com a mesma regra de restauração descrita no campo Empresa (filtro).

Tipo de Dispositivo (filtro da listagem)

Tipo: seleção múltipla com busca (combo)

Obrigatoriedade: opcional

Descrição: permite restringir a listagem de dispositivos pelo tipo de aplicativo associado.

Comportamento: lista as opções Easypac e Integração, com a opção “Todos” no topo. A busca ignora acentuação e diferença entre maiúsculas e minúsculas. Este filtro não oferece uma opção explícita equivalente ao rótulo “APP Supervisão”, usado apenas na tela de edição; para localizar esses dispositivos, é preciso combinar os filtros de Situação e Suporte, ou usar a busca livre pelo nome ou UID do dispositivo.

Impacto: filtra os registros exibidos na grade; fica guardado no navegador durante a sessão, com a mesma regra de restauração descrita no campo Empresa (filtro).

Campo de busca livre

Tipo: texto

Obrigatoriedade: opcional

Descrição: permite localizar dispositivos digitando livremente parte do Id, do UID, do nome do dispositivo ou do nome da empresa.

Comportamento: a busca só é enviada ao servidor a partir de 3 caracteres digitados, ao apertar Enter, ou ao limpar o campo; as requisições ficam adiadas em 500ms após o usuário parar de digitar. Se o texto digitado for numérico, o sistema busca por Id; caso contrário, busca por UID, Nome do dispositivo ou Nome da empresa que contenham o texto digitado.

Impacto: filtra os registros exibidos na grade de dispositivos.

Id

Tipo: número (somente leitura)

Descrição: identificador único do dispositivo no cadastro. Pode ser usado para ordenar a grade e é a coluna usada como ordenação padrão (decrescente) ao abrir a listagem. Usado internamente para localizar o dispositivo ao editar, ativar ou inativar.

Nome

Tipo: texto (somente leitura na grade; editável no formulário)

Descrição: nome cadastrado para identificar o dispositivo. Recebe o sufixo ” (Suporte)” automaticamente quando o dispositivo está marcado como uso interno. Pode ser usado para ordenar a grade. Aparece também na tela de edição do dispositivo.

Versão do APP

Tipo: texto (somente leitura)

Descrição: versão do aplicativo instalada no dispositivo, informada automaticamente pelo APP. Pode ser usado para ordenar a grade; não pode ser alterado pela tela de cadastro. Nenhuma alteração feita nesta tela reflete neste campo.

Nome da Empresa

Tipo: texto (somente leitura na grade)

Descrição: nome da empresa à qual o dispositivo está vinculado. Pode ser usado para ordenar a grade; também compõe a busca livre. Reflete a empresa selecionada no cadastro do dispositivo.

Status

Tipo: texto calculado (somente leitura)

Descrição: mostra a situação atual do dispositivo. Exibe “Ativo” quando o indicador de situação é 1, “Pendente” quando é -1, e “Inativo” para qualquer outro valor. Esta coluna não pode ser usada para ordenar nem para pesquisar. Reflete diretamente a situação usada nas regras de ativação/inativação e no cálculo do resumo de licenças.

Data de liberação

Tipo: data/hora (somente leitura)

Descrição: data a partir da qual o dispositivo pode ser reativado, quando aplicável. Exibida no formato dia/mês/ano (com hora quando aplicável); fica em branco quando não há valor. Pode ser usada para ordenar a grade. Usada pelo sistema para bloquear uma tentativa de reativação antes do prazo de 7 dias.

Data e usuário de último acesso (EasyPAC, Supervisão)

Descrição: data, hora e usuário do último acesso do dispositivo pelos APPs EasyPAC e Supervisão. Exibidas no formato dia/mês/ano com hora; ficam em branco quando não há valor registrado. Podem ser usadas para ordenar a grade. Impacto: nenhum, além de informativo para acompanhamento de uso do dispositivo.

Ativar

Tipo: botão de ação

Descrição: ativa o dispositivo diretamente pela grade, sem precisar abrir o formulário completo. Visível apenas para usuários com a permissão de editar dispositivos. Ao clicar, a ativação é enviada direto ao servidor, sem exibir uma confirmação antes. Altera a situação do dispositivo para Ativo, sujeita às mesmas validações de licença e de prazo de 7 dias.

Inativar

Tipo: botão de ação

Descrição: inativa o dispositivo diretamente pela grade, sem precisar abrir o formulário completo. Visível apenas para usuários com a permissão de editar dispositivos. Se o dispositivo já estiver inativo, a inativação é enviada direto, sem confirmação. Se estiver Ativo ou Pendente, o sistema exibe uma confirmação avisando que o dispositivo só poderá ser reativado após 7 dias. Altera a situação para Inativo e grava a data de liberação como a data/hora atual mais 7 dias.

Nome

Tipo: texto

Obrigatoriedade: obrigatório

Descrição: nome que identifica o dispositivo na listagem e nas telas do sistema. Se deixado em branco ao tentar salvar, o sistema marca o campo visualmente, mas não impede o envio dos dados ao servidor mesmo assim. Aparece na coluna Nome da grade e na busca livre da listagem.

Empresa

Tipo: seleção (combo)

Obrigatoriedade: obrigatório

Descrição: empresa à qual o dispositivo pertence. Lista apenas as empresas vinculadas ao usuário logado. Se deixado em branco ao tentar salvar, o sistema marca o campo visualmente, mas não impede o envio dos dados ao servidor mesmo assim. Aparece na coluna Nome da Empresa da grade e é usada no filtro de Empresa da listagem.

Situação

Tipo: texto calculado, com botões Ativar/Inativar associados

Descrição: mostra a situação atual do dispositivo como texto: Ativo, Pendente ou Inativo. O botão correspondente à situação atual já aparece desabilitado de acordo com a situação vigente, evitando que o usuário tente repetir a mesma ação. Ao mudar para Inativo, o sistema exibe confirmação de 7 dias. Reflete na coluna Status da grade e no cálculo do resumo de licenças.

Versão do APP

Tipo: texto (somente leitura)

Descrição: versão do aplicativo instalado no dispositivo, informada automaticamente pelo APP. Exibida apenas para consulta; não pode ser alterada por esta tela. Reflete na coluna Versão do APP da grade.

Tipo de Dispositivo

Tipo: texto calculado (somente leitura)

Descrição: identifica se o dispositivo é do tipo APP Supervisão ou APP EasyPAC. Exibido como “APP Supervisão” quando o valor gravado corresponde a esse tipo, e como “APP EasyPAC” para qualquer outro valor. Este rótulo é diferente das opções oferecidas no filtro Tipo de Dispositivo da listagem. Não pode ser alterado por esta tela. Determina qual contagem de licenças é usada nas validações de ativação.

Recuperação de Desastres

Tipo: checkbox

Obrigatoriedade: opcional

Descrição: parâmetro de sincronização consultado pelo APP; a orientação é que só seja marcado sob instrução direta da equipe da Atak. Ao marcar, o sistema exibe um aviso pedindo confirmação; se o usuário cancelar, a opção é desmarcada automaticamente. Ao desmarcar, nenhuma confirmação é exigida. É um dos campos enviados para gravação ao salvar o dispositivo.

Aviso

Tipo: checkbox

Obrigatoriedade: opcional

Descrição: controla se o dispositivo deve usar os parâmetros de Tempo para aviso e Tempo para reaviso. Ao marcar esta opção, os campos Tempo para aviso e Tempo para reaviso ficam visíveis para preenchimento. Ao desmarcar, esses dois campos voltam automaticamente para o valor -1 (desabilitado) e ficam ocultos. Determina se os campos de tempo de aviso/reaviso são considerados pelo APP.

Tempo para aviso

Tipo: número (minutos)

Obrigatoriedade: condicional; só é exibido quando a opção Aviso está marcada

Descrição: quantidade de minutos usada pelo APP para disparar um aviso ao usuário do dispositivo. Valores entre 1 e 9 minutos ou acima de 1440 minutos bloqueiam o salvamento com mensagens específicas. O valor -1 é aceito e representa o campo desabilitado. Consultado pelo APP para definir quando exibir o aviso.

Tempo para reaviso

Tipo: número (minutos)

Obrigatoriedade: condicional; só é exibido quando a opção Aviso está marcada

Descrição: quantidade de minutos usada pelo APP para disparar um novo aviso (reaviso) após o primeiro aviso. Segue as mesmas faixas e validações do campo Tempo para aviso. O valor -1 é aceito e representa o campo desabilitado. Consultado pelo APP para definir quando repetir o aviso.

Data e usuário de último acesso (EasyPAC e Supervisão)

Tipo: texto/data (somente leitura)

Descrição: mostra quando e por quem o dispositivo foi acessado pela última vez através dos APPs EasyPAC e Supervisão. Exibido apenas para consulta ao abrir a edição de um dispositivo existente; não é enviado nem alterado ao salvar. Informativo; reflete os mesmos dados das colunas correspondentes da grade.

Resumo de licenças

Tipo: informativo (somente leitura)

Descrição: mostra a quantidade de licenças contratadas do APP EasyPAC e do APP Supervisão, quantas estão em uso (ativas) e quantas ainda estão disponíveis. Recalculado automaticamente a cada carregamento de página, aplicação de filtro ou atualização da grade; calculado a partir do cliente vinculado ao e-mail do usuário logado. Usado como referência antes de ativar um novo dispositivo; a quantidade “disponível” indica quantos dispositivos ainda podem ser ativados sem exceder o contrato.

Filtros Disponíveis

• Empresa: restringe a listagem às empresas selecionadas, dentre as vinculadas ao usuário logado.
• Situação: restringe a listagem por Ativo, Inativo ou Pendente.
• Suporte: restringe a listagem entre dispositivos de uso interno (Sim) e os demais (Não).
• Tipo de Dispositivo: restringe a listagem entre Easypac e Integração (para APP Supervisão, combine Situação e Suporte, ou use a busca livre).
• Busca livre: permite localizar digitando parte do Id, UID, nome do dispositivo ou nome da empresa. A busca só é enviada a partir de 3 caracteres digitados, ao apertar Enter ou ao limpar o campo.

Dica operacional: Para localizar especificamente dispositivos do tipo APP Supervisão usando filtros, combine os filtros de Situação e Suporte, ou pesquise pelo nome/UID do dispositivo na busca livre.

Restrições na edição de situação:

• Não é possível ativar um dispositivo que foi inativado há menos de 7 dias: “Dispositivo só pode ser ativado depois de 7 dias desativado.”
• Não é possível ativar um dispositivo quando a quantidade de licenças contratadas já foi totalmente utilizada: “Quantidade de licenças insuficientes para a ativação desse dispositivo.”
• Se o e-mail do usuário logado não estiver vinculado a um cliente, a alteração de situação não é aplicada, mesmo que o sistema confirme sucesso na tela; será necessário confirmar o vínculo com o responsável técnico.

Histórico de alterações: Não há menção, na documentação de origem, a uma tela ou seção específica de histórico/log de alterações visível ao cliente final para esta rotina.

Carregamento da Listagem

Ao carregar a listagem, o sistema monta a grade de dispositivos aplicando os filtros de empresa, situação, suporte, tipo de dispositivo e a busca livre, ordena pela coluna solicitada (voltando para a ordenação por Id quando a coluna pedida não é reconhecida) e organiza o resultado em páginas. Em seguida, calcula o resumo de licenças contratadas, ativas e disponíveis a partir do cliente (contratante) vinculado ao e-mail do usuário logado.

Sequência de Operações ao Salvar/Ativar/Inativar

Ao salvar, ativar ou inativar um dispositivo, seja pelo formulário completo, seja pelos botões rápidos Ativar/Inativar da grade, o sistema segue automaticamente esta sequência:

1. Localiza o dispositivo pelo identificador informado; se não encontrar, interrompe a operação e exibe a mensagem de erro correspondente.
2. Localiza o cliente (contratante) vinculado ao e-mail do usuário logado, para conferir a quantidade de licenças contratadas.
3. Se a situação de destino for Ativo, verifica se há licenças disponíveis para o tipo do dispositivo (APP EasyPAC ou APP Supervisão) e se o dispositivo não foi inativado há menos de 7 dias; qualquer uma dessas duas condições, se não atendida, interrompe a operação com a mensagem correspondente.
4. Se a situação de destino for Inativo, grava automaticamente a data de liberação como a data/hora atual mais 7 dias, usada depois para bloquear uma reativação antecipada.
5. Grava os demais campos editáveis (Nome, Empresa, Recuperação de Desastres, Tempo para aviso, Tempo para reaviso) e confirma o sucesso da operação ao Portal.

Comportamento dos botões rápidos: Os botões rápidos Ativar/Inativar da grade não usam um caminho simplificado; internamente, o sistema busca o dispositivo completo, altera apenas o campo de situação, e reaproveita exatamente a mesma sequência de validações do formulário completo, incluindo a verificação de licenças e o prazo de 7 dias para reativação. Ou seja, para o usuário, o resultado final é o mesmo, seja pela grade ou pelo formulário.

Os dispositivos “ativos” do tipo APP EasyPAC são contados como o total de dispositivos desse tipo com situação Ativo, excluindo os marcados como uso interno (Suporte). Já os dispositivos do tipo APP Supervisão são contados separadamente, com licenças próprias, sem excluir os de uso interno. A quantidade de dispositivos disponíveis é calculada como licenças contratadas menos dispositivos ativos, apurada de forma independente para o APP EasyPAC e para o APP Supervisão.

Quando um dispositivo é inativado (a situação muda de Ativo para Inativo), o sistema grava automaticamente a data de liberação como a data/hora atual mais 7 dias. Se o usuário tentar ativar esse mesmo dispositivo antes de decorridos os 7 dias, o sistema bloqueia a ativação e exibe a mensagem “Dispositivo só pode ser ativado depois de 7 dias desativado.”

Se a quantidade de licenças contratadas para o tipo do dispositivo (APP EasyPAC ou APP Supervisão) for diferente de zero, o sistema verifica se a quantidade de dispositivos já ativos daquele tipo atingiu o limite contratado; se atingiu, a ativação é bloqueada com a mensagem “Quantidade de licenças insuficientes para a ativação desse dispositivo.” Se a quantidade contratada for igual a zero, essa checagem não é realizada, e a ativação não é bloqueada por limite de licenças nesse caso específico.

Se o Tempo para aviso e/ou o Tempo para reaviso estiver preenchido com um valor entre 1 e 9 minutos, o sistema bloqueia o salvamento do formulário, exibindo a mensagem de valor mínimo (10 minutos). Se qualquer um dos dois campos for maior que 1440 minutos, o sistema também bloqueia o salvamento, exibindo a mensagem de valor máximo (1440 minutos). Valores iguais a -1 (campo desabilitado, quando a opção Aviso não está marcada) ou entre 10 e 1440 minutos são aceitos normalmente.

Ao editar um dispositivo, apenas Nome, Empresa, Situação, Recuperação de Desastres, Tempo para aviso e Tempo para reaviso são enviados para gravação. Versão do APP, Tipo de Dispositivo e as datas/usuários de último acesso são somente leitura, preenchidos exclusivamente pelo próprio APP, e não podem ser alterados por esta tela.

Toda operação de editar ou de alterar a situação de um dispositivo primeiro localiza o cliente (contratante) vinculado ao e-mail do usuário logado, para conferir a quantidade de licenças contratadas. Se esse cliente não for localizado, a ativação de um dispositivo não é efetivada, mesmo que o Portal exiba a confirmação de sucesso na tela.

A situação do dispositivo é sempre uma destas três: Ativo, Inativo ou Pendente. Essas três situações são usadas de forma consistente na grade, no filtro e no formulário de edição.

Um dispositivo pode ser marcado como de uso interno (Suporte). Dispositivos do tipo APP EasyPAC marcados como Suporte não entram na contagem de dispositivos ativos usada no cálculo do resumo de licenças; já dispositivos do tipo APP Supervisão marcados como Suporte entram normalmente nessa contagem.

O filtro Tipo de Dispositivo da listagem oferece apenas as opções Easypac e Integração, sem uma opção explícita equivalente ao rótulo “APP Supervisão” usado na tela de edição.

Se a grade solicitar a ordenação por uma coluna que o sistema não reconhece como ordenável, o sistema ignora o pedido e ordena os registros por Id de forma crescente.