Saltar al contenido

Aplicación Jitterbit AcuTrack

Descripción general

Jitterbit proporciona la aplicación AcuTrack a través de Jitterbit Marketplace. Construida con Jitterbit App Builder, es una aplicación móvil de seguimiento de activos para administrar inventario físico. Los equipos registran la entrada y salida de activos, 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, equipo o vehículos de flota.

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

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

Cómo funciona

En general, un administrador configura el catálogo de activos, los usuarios registran movimientos de activos (incluyendo desde un escaneo móvil) y la aplicación actualiza cada activo e impulsa los paneles de seguimiento:

%%{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

Funciones principales

Cuando instalas y configuras AcuTrack, proporciona las siguientes capacidades:

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

  • Registro de entrada y salida: Los usuarios registran 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 en la salida y devolución.

  • 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 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 la etiqueta de un activo y prepara un registro para una actualización de seguimiento rápida.

  • Paneles: El panel de inicio muestra totales de activos por estado, un panel de mapa para distribución geográfica y un calendario para mantenimiento próximo. Todos se pueden filtrar por ubicación, departamento, estado y tipo de activo, y permiten profundizar 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 Asset Tracking. La aplicación no requiere una conexión a una base de datos externa; lee tus usuarios autenticados de App Builder a través de una conexión nativa a tu instancia de App Builder.

Tabla Propósito
Asset Registro maestro de elementos rastreados, incluidas etiquetas, descripciones y ubicación actual.
AssetType Categorías de activos e intervalos de mantenimiento preventivo.
AssetMovement Libro mayor transaccional de entradas, salidas y reparaciones, con metadatos de usuario e imagen.
MovementType Tipos de transacción validados (Check-In, Check-Out, Repair).
Status Estados operacionales (por ejemplo, Available, Maintenance), con configuración de color y etiqueta de botón de acción.
Location Índice de sitio, incluidas direcciones, datos de región y códigos de mapa.
Department Unidades organizacionales utilizadas para propiedad e informes.
Scan Tabla de preparación temporal para cargas útiles de QR y códigos de barras de cámara.
Session Estado de ejecución por usuario y valores de filtro de panel.
User Datos de perfil e identidad del usuario.
VinylAuditLog Registro de auditoría inmutable de cambios de campo en toda la aplicación.
Parameter Configuración global, 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 incluyen datos de búsqueda de ejemplo para que la aplicación funcione inmediatamente después de la instalación.

Relaciones

Las relaciones principales 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 hacia), Department (de y hacia), 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 Marketplace; si tu organización no cuenta con licencia de App Builder, la acción Descargar aplicación se reemplaza por una acción de solicitud Obtener aplicación (consulta Descargar e instalar).

  • Una instancia de App Builder ejecutando App Builder 4.63, la versión para la cual está compilado 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 al soporte de Jitterbit para solicitar un paquete correspondiente.

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

  • Para escanear códigos 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. Consulta la solución de problemas relacionada.

Descargar e instalar

Descargar la aplicación desde Marketplace

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

  2. Localiza la aplicación llamada AcuTrack. Puedes usar la barra de búsqueda o, en el panel Filtros bajo Tipo, selecciona Aplicación para mostrar solo aplicaciones.

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

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

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

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

    • Obtener aplicación: Si tu organización no tiene licencia de App Builder, la acción se etiqueta como Obtener aplicación. El panel Detalles muestra un mensaje indicando que se requiere una licencia de App Builder, con un botón Enviar. Haz clic en Enviar para solicitar que un representante se comunique contigo acerca de App Builder; una notificación de Mensaje enviado correctamente 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 al IDE.

  2. Bajo Implementar, 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 Versión muestra la información del paquete, luego cierra el diálogo Paquete.

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

Para obtener una vista previa del contenido de un paquete antes de instalarlo, haz clic en el botón Manifiesto.

Modificar la aplicación en un entorno de desarrollo

La fuente de datos de la aplicación se instala sellada. Si implementas la aplicación en un entorno de desarrollo e intentas modificarla, desella la fuente de datos para que puedas editar los objetos de la aplicación. Mantenla sellada en QA y producción para preservar la equivalencia entre entornos. Consulta Sellar o dessellar 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 que esté lista para usar:

  1. Asigna usuarios a grupos. Añade tus usuarios al grupo de acceso apropiado, ya sea Administrador de AcuTrack o Usuario de AcuTrack. Consulta Seguridad y acceso.

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

  3. Establece la región del mapa del panel. El panel de mapa utiliza por defecto un mapa del condado de Massachusetts. Para desplegar 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. Personaliza las etiquetas de búsqueda. Puedes renombrar un registro de Status o editar su descripción para que coincida con tu terminología. No elimines los registros de Status, porque la lógica de fondo hace referencia a sus IDs a través de valores enum.

  5. Personaliza las etiquetas de los botones de acción (opcional). La tabla Status tiene dos columnas que establecen las etiquetas en los botones de acción mostrados para un activo: MoveLabel para el botón de movimiento (entrada y salida) y MaintenanceLabel para el botón de mantenimiento (reparación y devolución). Si un estado deja una de estas columnas en blanco, se oculta el botón correspondiente para los activos en ese estado. Las etiquetas predeterminadas son:

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

Seguridad y acceso

AcuTrack utiliza seguridad basada en funciones 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
Paneles analíticos (mapas y cronogramas) Acceso completo Solo lectura, puede cambiar filtros locales
Registro de actividad Acceso completo Solo lectura
Página Configuración y búsquedas Acceso completo Sin acceso (menús ocultos)

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

Reglas de negocio

La lógica de AcuTrack se implementa como reglas de negocio de App Builder. Los nombres de las reglas siguen la convención de App Builder Target (Purpose or Subtype) Descriptor, 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 cuando extiendas la aplicación.

Reglas de activos y mantenimiento

Regla Propósito
Asset (Business Object) Fuente de datos maestros para activos.
Asset (List) Lista del selector de activos utilizada en formularios y cuadrículas.
Asset (Assets Tile) Alimenta el mosaico de activos de la página de inicio móvil.
Assets (By Status) Agrega recuentos de activos por estado para el panel.
Asset (Update) Asset Movement Actualiza la ubicación actual, el departamento y el 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 fecha del último mantenimiento del activo.
Asset (Maintenance Calendar with Today) Combina 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 Rellena automáticamente los valores de seguimiento, las marcas de tiempo y la sesión del usuario en la entrada y salida.
AssetMovement (Default) Maintenance Activity Establece valores de referencia 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 almacenamiento provisional de escaneo.
Scan (Cram) Inserta un registro de escaneo temporal vinculado a la sesión del usuario.
Scan (Update) AssetID Vincula un código QR escaneado a la etiqueta de activo y devuelve el ID de activo interno.

Reglas de sesión y filtro

Regla Propósito
Session (Business Object) Administra el estado de sesión y los valores predeterminados del usuario activo.
Session (Clear Filters) Regla de página que reinicia los filtros del panel.
Session (Update) Clear Filter Borra los valores de filtro 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) Administra los datos del perfil de usuario e identidad.
User (List) Lista de selector de usuario utilizada en toda la aplicación.

Solución de problemas

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

  • Síntoma: Al abrir la página de escaneo móvil, no se 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 host de App Builder.

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

Un activo nuevo 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.

  • Solución: En la página 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 no se representa

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

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

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

Para obtener más ayuda, revisa los registros de App Builder y comunícate con el equipo de soporte de Jitterbit.