Ir para o conteúdo

Aplicativo AcuTrack do Jitterbit

Visão Geral

O Jitterbit fornece o aplicativo AcuTrack através do Jitterbit Marketplace. Construído com o Jitterbit App Builder, é um aplicativo de rastreamento de ativos com foco em dispositivos móveis para gerenciar inventário físico. As equipes registram a entrada e saída de ativos, rastreiam sua localização e departamento, agendam manutenção preventiva e escaneiam etiquetas de ativos com a câmera de um dispositivo móvel. O modelo de dados é genérico, portanto, o mesmo aplicativo pode rastrear hardware de TI, ferramentas, equipamentos ou veículos de frota.

Você baixa o aplicativo como um pacote de lançamento do App Builder (um arquivo .LP) do Marketplace e o instala em sua própria instância do App Builder, onde pode configurá-lo e estendê-lo para se adequar ao seu processo.

Esta página descreve como o aplicativo funciona, suas principais características e modelo de dados, e cobre os pré-requisitos, como baixá-lo e instalá-lo, como configurá-lo para seu ambiente, como o acesso é controlado, as regras de negócios que utiliza e etapas comuns de solução de problemas.

Como funciona

Em um nível alto, um administrador configura o catálogo de ativos, os usuários registram os movimentos dos ativos (incluindo a partir de um escaneamento móvel) e o aplicativo atualiza cada ativo e aciona os painéis de rastreamento:

flowchart TD A["Administrator configures
asset types, locations,
departments, and statuses"] --> B["Add assets
to the registry"] B --> C["User checks an asset
in or out"] B --> F["Scan asset QR code
on mobile"] F --> C C --> D["Movement logged:
location, department,
timestamp, optional photo"] D --> E["Asset status and
location updated"] B --> G["Maintenance interval
schedules service"] G --> H["Maintenance calendar
and repair movements"] E --> I["Dashboard: status totals,
map, and maintenance calendar"] H --> I

Principais características

Quando você instala e configura o AcuTrack, ele fornece as seguintes capacidades:

  • Gerenciamento do ciclo de vida dos ativos: Administradores definem categorias de ativos, departamentos, locais e status operacionais a partir de uma única página de configuração.

  • Check-in e check-out: Os usuários registram os movimentos dos ativos a partir da página inicial. Cada movimento rastreia a localização e o departamento de origem e destino, um carimbo de data/hora, a sessão do usuário e verificação de foto opcional no checkout e na devolução.

  • Agendamento de manutenção preventiva: Cada tipo de ativo tem um intervalo de manutenção (em dias). O aplicativo constrói um calendário de manutenção a partir desse intervalo e da última data de manutenção de cada ativo. Definir o intervalo de um tipo de ativo como 0 suprime o agendamento de manutenção para esse tipo.

  • Escaneamento de QR móvel: Em um dispositivo móvel, uma página de escaneamento dedicada usa a câmera do dispositivo para ler o código QR de uma etiqueta de ativo e preparar um registro para uma atualização rápida de rastreamento.

  • Painéis: O painel inicial mostra totais de ativos por status, um painel de mapa para distribuição geográfica e um calendário para manutenção futura. Todos são filtráveis por localização, departamento, status e tipo de ativo, e suportam detalhamento para a lista de ativos subjacente.

Modelo de dados

O AcuTrack armazena seus dados de rastreamento em suas próprias tabelas, que são instaladas como uma fonte de dados do App Builder. Embora o aplicativo se chame AcuTrack, essa fonte de dados é chamada de Rastreamento de Ativos. O aplicativo não requer uma conexão com um banco de dados externo; ele lê seus usuários autenticados do App Builder por meio de uma conexão nativa com sua instância do App Builder.

Tabela Propósito
Asset Registro mestre de itens rastreados, incluindo etiquetas, descrições e localização atual.
AssetType Categorias de ativos e seus intervalos de manutenção preventiva.
AssetMovement Livro-razão transacional de check-ins, check-outs e reparos, com metadados de usuário e imagem.
MovementType Tipos de transação validados (Check-In, Check-Out, Repair).
Status Estados operacionais (por exemplo, Available, Maintenance), com configurações de cor e rótulo de botão de ação.
Location Índice de locais, incluindo endereços, dados regionais e códigos de mapa.
Department Unidades organizacionais usadas para propriedade e relatórios.
Scan Tabela de preparação temporária para cargas de QR e código de barras da câmera.
Session Estado de execução por usuário e valores de filtro do painel.
User Perfil de usuário e dados de identidade.
VinylAuditLog Registro de auditoria imutável de alterações de campo em todo o aplicativo.
Parameter Configurações globais, dados de versão e padrões.
Loop Utilitário de intervalo numérico usado para acionar loops de lógica em segundo plano.

As tabelas Status, MovementType, Location, Department e AssetType são enviadas com dados de pesquisa de exemplo para que o aplicativo funcione imediatamente após a instalação.

Relacionamentos

As principais relações de chave estrangeira no modelo de dados são as seguintes. Todas as chaves estrangeiras estão indexadas.

Tabela Referências
Asset Status, Location, Department, AssetType
AssetMovement Asset, Location (de e para), Department (de e para), User, MovementType
MovementType Status
Scan Asset
Session Location, Department, AssetType, Status

Pré-requisitos

Para usar o AcuTrack, você precisa do seguinte:

  • Uma licença Jitterbit Harmony com acesso ao App Builder. Isso habilita o download do Marketplace; se sua organização não estiver licenciada para o App Builder, a ação Download app é substituída por uma ação de solicitação Get app (veja Download e instalação).

  • Uma instância do App Builder executando o App Builder 4.63, a versão para a qual o pacote atual foi construído. Cada pacote instala apenas em sua versão exata do App Builder; se sua instância estiver em uma versão diferente, entre em contato com o suporte Jitterbit para solicitar um pacote correspondente.

  • Um banco de dados PostgreSQL para sua instância do App Builder.

  • Para escaneamento de QR, um dispositivo móvel com câmera e acesso à câmera permitido para o host do App Builder no navegador móvel. Veja solução de problemas relacionada.

Download e instalação

Baixar o aplicativo do Marketplace

  1. Faça login no portal Harmony em https://login.jitterbit.com e abra Marketplace.

  2. Localize o aplicativo chamado AcuTrack. Você pode usar a barra de pesquisa ou, no painel Filters sob Type, selecionar App para mostrar apenas aplicativos.

  3. Clique no cartão do aplicativo para abrir o painel Details. Revise os Requisitos do aplicativo (a versão do App Builder e o banco de dados que ele precisa).

  4. Clique no link Go to documentation do aplicativo para abrir esta documentação em uma nova aba e mantenha-a aberta para referência.

  5. Faça uma das seguintes ações, dependendo se sua organização possui licença para o App Builder:

    • Baixar aplicativo: Se sua organização possui licença para o App Builder, clique em Baixar aplicativo, no cartão do aplicativo ou no painel Detalhes. Seu navegador salva o arquivo .LP na sua localização de downloads, e uma notificação Arquivo do App Builder baixado com sucesso confirma o download.

    • Obter aplicativo: Se sua organização não possui licença para o App Builder, a ação é rotulada como Obter aplicativo. O painel Detalhes exibe uma mensagem informando que uma licença do App Builder é necessária, com um botão Enviar. Clique em Enviar para enviar um pedido para que um representante entre em contato com você sobre o App Builder; uma notificação Mensagem enviada com sucesso confirma isso.

Instalar o aplicativo no App Builder

Instale o arquivo .LP baixado na sua instância do App Builder:

  1. Faça login no App Builder e vá para o IDE.

  2. Em Implantar, clique em Instalar Versão.

  3. Clique em + Pacote, depois Procurar e selecione o arquivo .LP que você baixou.

  4. Clique em Salvar. O painel Versão exibe as informações do pacote, então feche o diálogo Pacote.

  5. Confirme se os detalhes estão corretos e clique em Instalar.

Para visualizar o conteúdo de um pacote antes de instalá-lo, clique no botão Manifesto.

Modificando o aplicativo em um ambiente de desenvolvimento

A fonte de dados do aplicativo é instalada selada. Se você implantar o aplicativo em um ambiente de desenvolvimento e pretender modificá-lo, desele a fonte de dados para que você possa editar os objetos do aplicativo. Mantenha-a selada em QA e produção para preservar a equivalência entre os ambientes. Veja Selar ou deselar uma fonte de dados.

Configuração e instalação

Após instalar o aplicativo em um novo ambiente, complete as seguintes etapas para torná-lo pronto para uso:

  1. Atribuir usuários a grupos. Adicione seus usuários ao grupo de acesso apropriado, seja Administrador do AcuTrack ou Usuário do AcuTrack. Veja Segurança e acesso.

  2. Inicializar perfis de usuário. Os usuários são registrados automaticamente no primeiro acesso. Na página de Configuração, atribua o departamento e o número de contato de cada usuário.

  3. Definir a região do mapa do painel. O painel do mapa é padrão para um mapa do condado de Massachusetts. Para implantar em outra região, abra a configuração do mapa e substitua os arquivos de dados do mapa pelos da sua região.

  4. Personalizar rótulos de pesquisa. Você pode renomear um registro de Status ou editar sua descrição para corresponder à sua terminologia. Não exclua os registros de Status, pois a lógica de fundo faz referência aos seus IDs através de valores enum.

  5. Personalizar rótulos de botões de ação (opcional). A tabela de Status possui duas colunas que definem os rótulos nos botões de ação exibidos para um ativo: MoveLabel para o botão de movimentação (check-in e check-out) e MaintenanceLabel para o botão de manutenção (reparar e devolver). Se um status deixar uma dessas colunas em branco, o botão correspondente é ocultado para ativos nesse status. Os rótulos padrão são:

    Status MoveLabel MaintenanceLabel
    Disponível Check-Out Reparar
    Verificado Check-In —
    Desativado — —
    Manutenção — Devolver

Segurança e acesso

AcuTrack utiliza segurança baseada em funções do App Builder role-based security com dois grupos de acesso, Administrador do AcuTrack e Usuário do AcuTrack. O acesso a cada área é o seguinte:

Área Administrador do AcuTrack Usuário do AcuTrack
Rastreamento de ativos e movimentação (página inicial) Acesso total Criar, atualizar e visualizar
Painéis analíticos (mapas e cronogramas) Acesso total Somente leitura, pode alterar filtros locais
Registro de atividades Acesso total Somente leitura
Página de Configuração e pesquisas Acesso total Sem acesso (menus ocultos)

Mudanças históricas são preservadas no log de auditoria VinylAuditLog, portanto, movimentos e edições passadas permanecem rastreáveis, independentemente do acesso atual de um usuário.

Regras de negócios

A lógica do AcuTrack é implementada como regras de negócios do App Builder. Os nomes das regras seguem a convenção Target (Purpose or Subtype) Descriptor do App Builder, de modo que a palavra inicial identifica a tabela sobre a qual a regra atua. As tabelas abaixo listam as regras por área funcional para ajudar você a localizá-las e compreendê-las ao estender o aplicativo.

Regras de ativos e manutenção

Regra Propósito
Asset (Business Object) Fonte de dados mestre para ativos.
Asset (List) Lista de seleção de ativos usada em formulários e grades.
Asset (Assets Tile) Alimenta o bloco de ativos na página inicial móvel.
Assets (By Status) Agrega contagens de ativos por status para o painel.
Asset (Update) Asset Movement Atualiza a localização atual, departamento e status de um ativo quando um movimento é registrado.
Asset (Maintenance Calendar) Cria eventos de manutenção recorrentes a partir do intervalo do tipo de ativo e da última data de manutenção do ativo.
Asset (Maintenance Calendar with Today) Une eventos de manutenção com a data atual para que o calendário se concentre no mês atual.
Asset (Calendar) (Upcoming Maintenance) Isola janelas de serviço futuras ou atrasadas.

Regras de movimento

Regra Propósito
AssetMovement (Business Object) Fonte de dados para o livro razão de movimentos.
AssetMovement (Activity Log) Agrega eventos de check-in, check-out e reparo em um fluxo de atividades.
AssetMovement (Default) Field Activity Preenche automaticamente valores de rastreamento, carimbos de data/hora e a sessão do usuário no check-in e check-out.
AssetMovement (Default) Maintenance Activity Define valores básicos quando um ativo entra em um ciclo de reparo.
AssetMovement (Repair Note Visibility) Torna o campo de nota de reparo visível e obrigatório durante a manutenção.

Regras de digitalização

Regra Propósito
Scan (Business Object) Fonte de dados para a tabela de estágio de digitalização.
Scan (Cram) Insere um registro de digitalização temporário vinculado à sessão do usuário.
Scan (Update) AssetID Combina um código QR digitalizado com a etiqueta do ativo e retorna o ID interno do ativo.

Regras de sessão e filtro

Regra Propósito
Session (Business Object) Gerencia o estado da sessão do usuário ativo e os padrões.
Session (Clear Filters) Regra de página que redefine os filtros do painel.
Session (Update) Clear Filter Limpa os valores dos filtros de localização, departamento, status e tipo de ativo.

Regras de utilidade

Regra Propósito
Parameter (Today) Injeta a data atual do sistema para renderização do calendário.
User (Business Object) Gerencia os dados do perfil e identidade do usuário.
User (List) Lista de seleção de usuários utilizada em todo o aplicativo.

Solução de problemas

A página de digitalização não abre a câmera

  • Sintoma: Abrir a página de digitalização móvel não inicia a câmera, ou a área de digitalização permanece em branco.

  • Causa possível: O navegador móvel bloqueou o acesso à câmera para o domínio do host do App Builder.

  • Solução: Nas permissões do site do navegador móvel, localize o domínio do host do App Builder e defina o acesso à câmera como Permitir.

Um novo ativo não aparece no calendário de manutenção

  • Sintoma: Um ativo recém-adicionado não gera eventos no calendário de manutenção preventiva.

  • Causa possível: O tipo de ativo do ativo tem um intervalo de manutenção de 0, o que suprime o agendamento para esse tipo.

  • Solução: Na página de Configuração, abra o tipo de ativo e defina seu intervalo de manutenção para um número positivo de dias (por exemplo, 30 para serviço mensal).

O mapa do painel não é renderizado

  • Sintoma: O painel do mapa do dashboard não é exibido ou retorna um erro de dados.

  • Causa possível: Os códigos de mapa em seus registros de Location não correspondem às chaves esperadas pelos dados do mapa.

  • Solução: Verifique se o código do mapa de cada localização corresponde às chaves de string definidas nos dados do mapa para sua região.

Para mais ajuda, revise os logs do seu App Builder e entre em contato com o suporte da Jitterbit.