Saltar al contenido

Aplicación AcuTrack de Jitterbit

Descripción general

Jitterbit proporciona la aplicación AcuTrack a través de Jitterbit Marketplace. Construida con Jitterbit App Builder, es una aplicación de seguimiento de activos orientada a dispositivos móviles para gestionar inventarios físicos. Los equipos registran los activos al entrar y salir, rastrean su ubicación y departamento, programan mantenimiento preventivo y escanean etiquetas de activos con la cámara de un dispositivo móvil. El modelo de datos es genérico, por lo que la misma aplicación puede rastrear hardware de TI, herramientas, equipos o vehículos de flota.

Descargas la aplicación como un paquete de lanzamiento de App Builder (un archivo .LP) desde Marketplace e instálala en tu propia instancia de App Builder, donde puedes configurarla y ampliarla para adaptarla a tu proceso.

Esta página describe cómo funciona la aplicación, sus características principales y modelo de datos, y cubre los requisitos previos, cómo descargar e instalar la aplicación, cómo configurarla para tu entorno, cómo se controla el acceso, las reglas de negocio que utiliza y pasos comunes de solución de problemas.

Cómo funciona

A un alto nivel, un administrador configura el catálogo de activos, los usuarios registran los movimientos de activos (incluyendo desde un escaneo móvil), y la aplicación actualiza cada activo y genera los tableros de seguimiento:

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

Características principales

Cuando instalas y configuras AcuTrack, proporciona las siguientes capacidades:

  • Gestión del ciclo de vida de activos: Los administradores definen categorías de activos, departamentos, ubicaciones y estados operativos desde una única página de configuración.

  • Registro de entrada y salida: Los usuarios registran los movimientos de activos desde la página de inicio. Cada movimiento rastrea la ubicación y departamento de origen y destino, una marca de tiempo, la sesión del usuario y verificación fotográfica opcional al momento de la salida y el retorno.

  • Programación de mantenimiento preventivo: Cada tipo de activo tiene un intervalo de mantenimiento (en días). La aplicación construye un calendario de mantenimiento a partir de ese intervalo y la última fecha de mantenimiento de cada activo. Establecer el intervalo de un tipo de activo en 0 suprime la programación de mantenimiento para ese tipo.

  • Escaneo de QR móvil: En un dispositivo móvil, una página de escaneo dedicada utiliza la cámara del dispositivo para leer el código QR de una etiqueta de activo y preparar un registro para una actualización rápida de seguimiento.

  • Tableros: El tablero de inicio muestra los totales de activos por estado, un panel de mapa para la distribución geográfica y un calendario para el mantenimiento próximo. Todos son filtrables por ubicación, departamento, estado y tipo de activo, y soportan la profundización en la lista de activos subyacente.

Modelo de datos

AcuTrack almacena sus datos de seguimiento en sus propias tablas, que se instalan como una fuente de datos de App Builder. Aunque la aplicación se llama AcuTrack, esta fuente de datos se llama Seguimiento de Activos. La aplicación no requiere una conexión a una base de datos externa; lee a sus usuarios autenticados de App Builder a través de una conexión nativa a su instancia de App Builder.

Tabla Propósito
Asset Registro maestro de elementos rastreados, incluyendo etiquetas, descripciones y ubicación actual.
AssetType Categorías de activos y sus intervalos de mantenimiento preventivo.
AssetMovement Libro mayor transaccional de registros de entrada, salida y reparaciones, con metadatos de usuario e imagen.
MovementType Tipos de transacción validados (Check-In, Check-Out, Repair).
Status Estados operativos (por ejemplo, Available, Maintenance), con configuraciones de color y etiqueta de botón de acción.
Location Índice de sitios, incluyendo direcciones, datos de región y códigos de mapa.
Department Unidades organizativas utilizadas para propiedad e informes.
Scan Tabla de preparación temporal para cargas de QR y códigos de barras de la cámara.
Session Estado de ejecución por usuario y valores de filtro del tablero.
User Perfil de usuario y datos de identidad.
VinylAuditLog Registro de auditoría inmutable de cambios de campo en toda la aplicación.
Parameter Configuraciones globales, datos de versión y valores predeterminados.
Loop Utilidad de intervalo numérico utilizada para impulsar bucles de lógica en segundo plano.

Las tablas Status, MovementType, Location, Department y AssetType se envían con datos de búsqueda de muestra para que la aplicación funcione inmediatamente después de la instalación.

Relaciones

Las principales relaciones de clave externa en el modelo de datos son las siguientes. Todas las claves externas están indexadas.

Tabla Referencias
Asset Status, Location, Department, AssetType
AssetMovement Asset, Location (de y a), Department (de y a), User, MovementType
MovementType Status
Scan Asset
Session Location, Department, AssetType, Status

Requisitos previos

Para usar AcuTrack, necesitas lo siguiente:

  • Una licencia de Jitterbit Harmony con acceso a App Builder. Esto habilita la descarga desde el Marketplace; si tu organización no tiene licencia para App Builder, la acción Descargar app se reemplaza por una acción de solicitud Obtener app (ver Descargar e instalar).

  • Una instancia de App Builder ejecutando App Builder 4.63, la versión para la cual se construyó el paquete actual. Cada paquete se instala solo en su versión exacta de App Builder; si tu instancia está en una versión diferente, contacta a soporte de Jitterbit para solicitar un paquete correspondiente.

  • Una base de datos PostgreSQL para tu instancia de App Builder.

  • Para escaneo de QR, un dispositivo móvil con cámara, y acceso a la cámara permitido para el host de App Builder en el navegador móvil. Ver solución de problemas relacionada.

Descargar e instalar

Descargar la app desde Marketplace

  1. Inicia sesión en el portal de Harmony en https://login.jitterbit.com y abre Marketplace.

  2. Localiza la app llamada AcuTrack. Puedes usar la barra de búsqueda o, en el panel de Filtros bajo Tipo, seleccionar App para mostrar solo apps.

  3. Haz clic en la tarjeta de la app para abrir el panel de Detalles. Revisa los Requisitos de la app (la versión de App Builder y la base de datos que necesita).

  4. Haz clic en el enlace Ir a la documentación de la app para abrir esta documentación en una pestaña separada, y mantenla abierta como referencia.

  5. Realiza una de las siguientes acciones, dependiendo de si tu organización tiene licencia para App Builder:

    • Descargar aplicación: Si tu organización tiene licencia para App Builder, haz clic en Descargar aplicación, ya sea en la tarjeta de la aplicación o en el panel de Detalles. Tu navegador guarda el archivo .LP en su ubicación de descargas, y una notificación de Archivo de App Builder descargado con éxito confirma la descarga.

    • Obtener aplicación: Si tu organización no tiene licencia para App Builder, la acción se etiqueta como Obtener aplicación. El panel de Detalles muestra un mensaje que indica que se requiere una licencia de App Builder, con un botón de Enviar. Haz clic en Enviar para enviar una solicitud para que un representante se comunique contigo sobre App Builder; una notificación de Mensaje enviado con éxito lo confirma.

Instalar la aplicación en App Builder

Instala el archivo .LP descargado en tu instancia de App Builder:

  1. Inicia sesión en App Builder y ve a la IDE.

  2. En Desplegar, haz clic en Instalar versión.

  3. Haz clic en + Paquete, luego en Examinar y selecciona el archivo .LP que descargaste.

  4. Haz clic en Guardar. El panel de Versión muestra la información del paquete, luego cierra el diálogo de Paquete.

  5. Confirma que los detalles son correctos, luego haz clic en Instalar.

Para previsualizar el contenido de un paquete antes de instalarlo, haz clic en el botón Manifiesto.

Modificando la aplicación en un entorno de desarrollo

La fuente de datos de la aplicación se instala sellada. Si despliegas la aplicación en un entorno de desarrollo y tienes la intención de modificarla, desella la fuente de datos para que puedas editar los objetos de la aplicación. Déjala sellada en QA y producción para preservar la equivalencia entre entornos. Consulta Sellar o desellar una fuente de datos.

Configuración e instalación

Después de instalar la aplicación en un nuevo entorno, completa los siguientes pasos para prepararla para su uso:

  1. Asignar usuarios a grupos. Agrega a tus usuarios al grupo de acceso apropiado, ya sea Administrador de AcuTrack o Usuario de AcuTrack. Consulta Seguridad y acceso.

  2. Inicializar perfiles de usuario. Los usuarios se registran automáticamente en el primer acceso. En la página de Configuración, asigna el departamento y el número de contacto de cada usuario.

  3. Establecer la región del mapa del panel. El panel del mapa predeterminado es un mapa del condado de Massachusetts. Para implementar en otra región, abre la configuración del mapa y reemplaza los archivos de datos del mapa con los de tu región.

  4. Personalizar las etiquetas de búsqueda. Puedes renombrar un registro de Estado o editar su descripción para que coincida con tu terminología. No elimines los registros de Estado, porque la lógica de fondo hace referencia a sus IDs a través de valores de enumeración.

  5. Personalizar las etiquetas de los botones de acción (opcional). La tabla de Estado tiene dos columnas que establecen las etiquetas en los botones de acción mostrados para un activo: MoveLabel para el botón de movimiento (check-in y check-out) y MaintenanceLabel para el botón de mantenimiento (reparar y devolver). Si un estado deja una de estas columnas en blanco, el botón correspondiente se oculta para los activos en ese estado. Las etiquetas predeterminadas son:

    Estado MoveLabel MaintenanceLabel
    Disponible Check-Out Reparar
    Prestado Check-In —
    Desactivado — —
    Mantenimiento — Devolver

Seguridad y acceso

AcuTrack utiliza la seguridad basada en roles de App Builder con dos grupos de acceso, Administrador de AcuTrack y Usuario de AcuTrack. El acceso a cada área es el siguiente:

Área Administrador de AcuTrack Usuario de AcuTrack
Seguimiento de activos y movimientos (página de inicio) Acceso completo Crear, actualizar y ver
Tableros analíticos (mapas y horarios) Acceso completo Solo lectura, puede cambiar filtros locales
Registro de actividad Acceso completo Solo lectura
Página de Configuración y búsquedas Acceso completo Sin acceso (menús ocultos)

Los cambios históricos se preservan en el registro de auditoría VinylAuditLog, por lo que los movimientos y ediciones pasadas permanecen trazables independientemente del acceso actual de un usuario.

Reglas de negocio

La lógica de AcuTrack se implementa como reglas de negocio en App Builder. Los nombres de las reglas siguen la convención de Descriptor de Objetivo (Propósito o Subtipo) de App Builder, por lo que la palabra inicial identifica la tabla sobre la que actúa la regla. Las tablas a continuación enumeran las reglas por área funcional para ayudarte a localizarlas y comprenderlas al extender la aplicación.

Reglas de activos y mantenimiento

Regla Propósito
Asset (Business Object) Fuente de datos maestra para activos.
Asset (List) Lista de selección de activos utilizada en formularios y cuadrículas.
Asset (Assets Tile) Alimenta el mosaico de activos en la página de inicio móvil.
Assets (By Status) Agrega conteos de activos por estado para el panel de control.
Asset (Update) Asset Movement Actualiza la ubicación actual, departamento y estado de un activo cuando se registra un movimiento.
Asset (Maintenance Calendar) Construye eventos de mantenimiento recurrentes a partir del intervalo del tipo de activo y la última fecha de mantenimiento del activo.
Asset (Maintenance Calendar with Today) Une eventos de mantenimiento con la fecha actual para que el calendario se centre en el mes actual.
Asset (Calendar) (Upcoming Maintenance) Aísla ventanas de servicio próximas o vencidas.

Reglas de movimiento

Regla Propósito
AssetMovement (Business Object) Fuente de datos para el libro mayor de movimientos.
AssetMovement (Activity Log) Agrega eventos de entrada, salida y reparación en un flujo de actividad.
AssetMovement (Default) Field Activity Completa automáticamente los valores de seguimiento, marcas de tiempo y la sesión del usuario en la entrada y salida.
AssetMovement (Default) Maintenance Activity Establece valores base cuando un activo entra en un ciclo de reparación.
AssetMovement (Repair Note Visibility) Hace que el campo de nota de reparación sea visible y obligatorio durante el mantenimiento.

Reglas de escaneo

Regla Propósito
Scan (Business Object) Fuente de datos para la tabla de preparación de escaneo.
Scan (Cram) Inserta un registro de escaneo temporal vinculado a la sesión del usuario.
Scan (Update) AssetID Coincide un código QR escaneado con la etiqueta del activo y devuelve el ID interno del activo.

Reglas de sesión y filtro

Regla Propósito
Session (Business Object) Gestiona el estado de sesión y los valores predeterminados del usuario activo.
Session (Clear Filters) Regla de página que restablece los filtros del panel de control.
Session (Update) Clear Filter Limpia los valores de los filtros de ubicación, departamento, estado y tipo de activo.

Reglas de utilidad

Regla Propósito
Parameter (Today) Inyecta la fecha actual del sistema para la representación del calendario.
User (Business Object) Gestiona el perfil del usuario y los datos de identidad.
User (List) Lista de selección de usuarios utilizada en toda la aplicación.

Solución de problemas

La página de escaneo no abre la cámara

  • Síntoma: Abrir la página de escaneo móvil no inicia la cámara, o el área de escaneo permanece en blanco.

  • Causa posible: El navegador móvil ha bloqueado el acceso a la cámara para el dominio del host de App Builder.

  • Resolución: En los permisos del sitio del navegador móvil, localiza el dominio del host de App Builder y establece el acceso a la cámara en Permitir.

Un nuevo activo no aparece en el calendario de mantenimiento

  • Síntoma: Un activo recién agregado no genera eventos en el calendario de mantenimiento preventivo.

  • Causa posible: El tipo de activo del activo tiene un intervalo de mantenimiento de 0, lo que suprime la programación para ese tipo.

  • Resolución: En la página de Configuración, abre el tipo de activo y establece su intervalo de mantenimiento en un número positivo de días (por ejemplo, 30 para servicio mensual).

El mapa del panel de control no se renderiza

  • Síntoma: El panel del mapa del panel de control no se muestra o devuelve un error de datos.

  • Causa posible: Los códigos de mapa en tus registros de Location no coinciden con las claves esperadas por los datos del mapa.

  • Resolución: Verifica que el código de mapa de cada ubicación coincida con las claves de cadena definidas en los datos del mapa para tu región.

Para obtener más ayuda, revisa los registros de tu App Builder y contacta a soporte de Jitterbit.