Ir para o conteúdo

Jitterbit AcuTrack App

Visão geral

O Jitterbit fornece o app AcuTrack através do Jitterbit Marketplace. Construído com o Jitterbit App Builder, é um app de rastreamento de ativos com prioridade mobile para gerenciar inventário físico. Os times fazem check-in e check-out de ativos, rastreiam sua localização e departamento, agendam manutenção preventiva e fazem leitura de tags de ativos com a câmera de um dispositivo móvel. O modelo de dados é genérico, portanto o mesmo app pode rastrear hardware de TI, ferramentas, equipamentos ou veículos de frota.

Você baixa o app como um pacote de versão 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 conforme seu processo.

Esta página descreve como o app funciona, seus recursos principais e modelo de dados, além de cobrir os pré-requisitos, como baixar e instalar, como configurá-lo para seu ambiente, como o acesso é controlado, as regras de negócio que utiliza e as etapas comuns de resolução de problemas.

Como funciona

Em alto nível, um administrador configura o catálogo de ativos, os usuários registram os movimentos de ativos (incluindo a partir de uma leitura mobile) e o app atualiza cada ativo e impulsiona os painéis de rastreamento:

%%{init: {"themeVariables": {"lineColor": "#6b7280", "edgeLabelBackground": "#f5f5f5"}}}%% 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

Recursos principais

Quando você instala e configura o AcuTrack, ele fornece os seguintes recursos:

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

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

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

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

  • Painéis de controle: 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, além de permitir drill-down 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 app seja nomeado AcuTrack, esta fonte de dados é nomeada Asset Tracking. O app não requer uma conexão de banco de dados externo; ele lê seus usuários autenticados do App Builder através de uma conexão nativa à sua instância do App Builder.

Tabela Propósito
Asset Registro mestre de itens rastreados, incluindo tags, 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 cor e configurações de rótulo de botão de ação.
Location Índice de sites, incluindo endereços, dados de região e códigos de mapa.
Department Unidades organizacionais usadas para propriedade e relatórios.
Scan Tabela de preparo temporário para cargas QR e código de barras da câmera.
Session Estado de runtime por usuário e valores de filtro do painel de controle.
User Dados de perfil e identidade do usuário.
VinylAuditLog Log de auditoria imutável de alterações de campo em todo o app.
Parameter Configurações globais, dados de versão e padrões.
Loop Utilitário de intervalo numérico usado para impulsionar loops de lógica de fundo.

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

Relacionamentos

Os principais relacionamentos de chave estrangeira no modelo de dados são os seguintes. Todas as chaves estrangeiras são indexadas.

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

Pré-requisitos

Para usar o AcuTrack, você precisa do seguinte:

  • Uma licença do Jitterbit Harmony com acesso ao App Builder. Isso permite o download do Marketplace; se sua organização não está licenciada para o App Builder, a ação Download app é substituída por uma ação de solicitação Get app (consulte 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 desenvolvido. Cada pacote é instalado 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 do Jitterbit para solicitar um pacote compatível.

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

  • Para leitura de código QR, um dispositivo móvel com câmera e acesso à câmera permitido para o host do App Builder no navegador móvel. Consulte 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 Filtros em Tipo, selecionar App para exibir apenas aplicativos.

  3. Clique no card do aplicativo para abrir o painel Detalhes. Revise os Requisitos do aplicativo (a versão do App Builder e o banco de dados necessários).

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

  5. Faça um dos seguintes, dependendo de sua organização estar licenciada para o App Builder:

    • Download app: Se sua organização está licenciada para o App Builder, clique em Download app, seja no card do aplicativo ou no painel Detalhes. Seu navegador salva o arquivo .LP em seu local de download, e uma notificação App Builder file downloaded successfully confirma o download.

    • Get app: Se sua organização não está licenciada para o App Builder, a ação é rotulada como Get app. O painel Detalhes exibe uma mensagem indicando que uma licença do App Builder é necessária, com um botão Submit. Clique em Submit para enviar uma solicitação para que um representante entre em contato com você sobre o App Builder; uma notificação Message successfully sent confirma o envio.

Instalar o aplicativo no App Builder

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

  1. Faça login no App Builder e acesse o IDE.

  2. Em Deploy, clique em Install Release.

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

  4. Clique em Save. O painel Release exibe as informações do pacote e, em seguida, fecha a caixa de diálogo Package.

  5. Confirme que os detalhes estão corretos e clique em Install.

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

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, desbloqueie a fonte de dados para poder editar os objetos do aplicativo. Deixe-a bloqueada em QA e produção para manter a equivalência entre ambientes. Consulte Bloquear ou desbloquear uma fonte de dados.

Configuração e setup

Após instalar o app em um novo ambiente, conclua as seguintes etapas para deixá-lo pronto para uso:

  1. Atribua usuários a grupos. Adicione seus usuários ao grupo de acesso apropriado, AcuTrack Administrator ou AcuTrack User. Veja Segurança e acesso.

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

  3. Defina a região do mapa do dashboard. O painel de mapa é padronizado 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. Personalize rótulos de pesquisa. É possível 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 em background referencia seus IDs através de valores enum.

  5. Personalize rótulos de botões de ação (opcional). A tabela Status tem duas colunas que definem os rótulos nos botões de ação mostrados para um ativo: MoveLabel para o botão de movimento (check-in e check-out) e MaintenanceLabel para o botão de manutenção (reparo e devolução). Se um status deixar uma dessas colunas em branco, o botão correspondente fica oculto para ativos nesse status. Os rótulos padrão são:

    Status MoveLabel MaintenanceLabel
    Available Check-Out Repair
    Checked Out Check-In —
    Deactivated — —
    Maintenance — Return

Segurança e acesso

O AcuTrack usa segurança baseada em funções do App Builder com dois grupos de acesso: AcuTrack Administrator e AcuTrack User. O acesso a cada área é o seguinte:

Área AcuTrack Administrator AcuTrack User
Rastreamento de ativos e movimentos (página inicial) Acesso total Criar, atualizar e visualizar
Dashboards analíticos (mapas e agendas) Acesso total Apenas leitura, pode alterar filtros locais
Log de atividades Acesso total Apenas leitura
Página Configuration e pesquisas Acesso total Sem acesso (menus ocultos)

As alterações históricas são preservadas no log de auditoria VinylAuditLog, portanto movimentos e edições anteriores 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, portanto a primeira palavra identifica a tabela na qual a regra atua. As tabelas abaixo listam as regras por área funcional para ajudá-lo a localizá-las e compreendê-las ao estender o app.

Regras de ativos e manutenção

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

Regras de movimento

Regra Finalidade
AssetMovement (Business Object) Fonte de dados do 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 Popula 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 de baseline 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 verificação

Regra Finalidade
Scan (Business Object) Fonte de dados para a tabela de preparo de verificação.
Scan (Cram) Insere um registro de verificação temporário vinculado à sessão do usuário.
Scan (Update) AssetID Faz correspondência entre um código QR verificado e a etiqueta de ativo, retornando a ID de ativo interna.

Regras de sessão e filtro

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

Regras de utilitário

Regra Finalidade
Parameter (Today) Injeta a data atual do sistema para renderização de calendário.
User (Business Object) Gerencia dados de perfil de usuário e identidade.
User (List) Lista de seletor de usuário usada em todo o aplicativo.

Solução de problemas

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

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

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

  • Resolução: Nas permissões de site do navegador móvel, localize o domínio 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.

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

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

O mapa do painel não é renderizado

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

  • Possível causa: Os códigos de mapa nos registros de Location não correspondem às chaves esperadas pelos dados do mapa.

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

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