Zum Inhalt springen

Jitterbit AcuTrack App

Übersicht

Jitterbit stellt die AcuTrack App über den Jitterbit Marketplace zur Verfügung. Sie wurde mit Jitterbit App Builder entwickelt und ist eine mobile-first Asset-Tracking-App zur Verwaltung von physischen Beständen. Teams checken Assets ein und aus, verfolgen deren Standort und Abteilung, planen vorbeugende Wartungen und scannen Asset-Tags mit der Kamera eines mobilen Geräts. Das Datenmodell ist generisch, daher kann die gleiche App IT-Hardware, Werkzeuge, Ausrüstung oder Flottenfahrzeuge verfolgen.

Die App wird als App Builder Release Package (eine .LP-Datei) vom Marketplace heruntergeladen und in die eigene App Builder Instanz installiert, wo sie konfiguriert und erweitert werden kann.

Diese Seite beschreibt wie die App funktioniert, ihre Kernfunktionen und das Datenmodell, sowie die Voraussetzungen, wie man sie herunterlädt und installiert, wie man sie für die eigene Umgebung konfiguriert, wie der Zugriff kontrolliert wird, die Geschäftsregeln, die sie verwendet, und häufige Schritte zur Fehlerbehebung.

Funktionsweise

Auf hoher Ebene richtet ein Administrator den Asset-Katalog ein, Benutzer erfassen Asset-Bewegungen (einschließlich mobiler Scans), und die App aktualisiert jedes Asset und steuert die Tracking-Dashboards:

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

Kernfunktionen

Nach der Installation und Konfiguration von AcuTrack stehen folgende Funktionen zur Verfügung:

  • Asset-Lebenszyklusverwaltung: Administratoren definieren Asset-Kategorien, Abteilungen, Standorte und Betriebsstatus auf einer einzigen Konfigurationsseite.

  • Ein- und Auschecken: Benutzer erfassen Asset-Bewegungen von der Startseite aus. Jede Bewegung verfolgt den Quell- und Zielstandort und die Abteilung, einen Zeitstempel, die Benutzersitzung und optionale Fotoverifizierung beim Auschecken und bei der Rückgabe.

  • Planung vorbeugender Wartung: Jeder Asset-Typ hat ein Wartungsintervall (in Tagen). Die App erstellt einen Wartungskalender aus diesem Intervall und dem letzten Wartungsdatum jedes Assets. Wenn das Intervall eines Asset-Typs auf 0 gesetzt wird, wird die Wartungsplanung für diesen Typ unterdrückt.

  • Mobile QR-Codeerkennung: Auf einem mobilen Gerät nutzt eine dedizierte Scan-Seite die Gerätekamera, um den QR-Code eines Asset-Tags zu lesen und einen Datensatz für eine schnelle Tracking-Aktualisierung vorzubereiten.

  • Dashboards: Das Home-Dashboard zeigt Asset-Gesamtzahlen nach Status, ein Kartenpanel für geografische Verteilung und einen Kalender für anstehende Wartungen. Alle sind nach Standort, Abteilung, Status und Asset-Typ filterbar und unterstützen Drilldown zur zugrunde liegenden Asset-Liste.

Datenmodell

AcuTrack speichert seine Tracking-Daten in eigenen Tabellen, die als App Builder Datenquelle installiert werden. Obwohl die App AcuTrack heißt, trägt diese Datenquelle den Namen Asset Tracking. Die App erfordert keine externe Datenbankverbindung; sie liest die authentifizierten App Builder Benutzer über eine native Verbindung zur App Builder Instanz.

Tabelle Zweck
Asset Masterregister der verfolgten Elemente, einschließlich Tags, Beschreibungen und aktuellem Standort.
AssetType Asset-Kategorien und ihre Wartungsintervalle für vorbeugende Wartung.
AssetMovement Transaktionsprotokoll von Ein- und Auschecks sowie Reparaturen mit Benutzer- und Bildmetadaten.
MovementType Validierte Transaktionstypen (Check-In, Check-Out, Repair).
Status Betriebszustände (z. B. Available, Maintenance) mit Farb- und Aktionsschaltflächenbeschriftungseinstellungen.
Location Standortindex, einschließlich Adressen, Regionsdaten und Kartencodes.
Department Organisationseinheiten für Eigentümerschaft und Berichterstattung.
Scan Temporäre Staging-Tabelle für QR- und Barcode-Payloads der Kamera.
Session Laufzeitzustand pro Benutzer und Dashboard-Filterwerte.
User Benutzerprofil und Identitätsdaten.
VinylAuditLog Unveränderliches Audit-Log von Feldänderungen in der gesamten App.
Parameter Globale Einstellungen, Versionsdaten und Standardwerte.
Loop Numerisches Intervallprogramm zur Steuerung von Hintergrundlogikschleifen.

Die Tabellen Status, MovementType, Location, Department und AssetType werden mit Beispiel-Lookup-Daten ausgeliefert, damit die App unmittelbar nach der Installation funktioniert.

Beziehungen

Die wichtigsten Fremdschlüssel-Beziehungen im Datenmodell sind wie folgt. Alle Fremdschlüssel sind indiziert.

Tabelle Verweise
Asset Status, Location, Department, AssetType
AssetMovement Asset, Location (von und zu), Department (von und zu), User, MovementType
MovementType Status
Scan Asset
Session Location, Department, AssetType, Status

Voraussetzungen

Um AcuTrack zu nutzen, benötigen Sie Folgendes:

  • Eine Jitterbit Harmony-Lizenz mit Zugriff auf App Builder. Dies ermöglicht den Download aus dem Marketplace. Wenn Ihre Organisation nicht für App Builder lizenziert ist, wird die Aktion App herunterladen durch eine Aktion App anfordern ersetzt (siehe Herunterladen und installieren).

  • Eine App Builder-Instanz mit App Builder 4.63, der Version, für die das aktuelle Paket erstellt wurde. Jedes Paket wird nur auf seiner exakten App Builder-Version installiert. Wenn sich Ihre Instanz auf einer anderen Version befindet, wenden Sie sich an den Jitterbit-Support, um ein passendes Paket anzufordern.

  • Eine PostgreSQL-Datenbank für Ihre App Builder-Instanz.

  • Für QR-Scans benötigen Sie ein Mobilgerät mit Kamera und Kamerazugriff, der im mobilen Browser für den App Builder-Host aktiviert ist. Siehe zugehörige Fehlerbehebung.

Herunterladen und installieren

App aus dem Marketplace herunterladen

  1. Melden Sie sich beim Harmony-Portal unter https://login.jitterbit.com an und öffnen Sie Marketplace.

  2. Suchen Sie die App mit dem Namen AcuTrack. Sie können die Suchleiste verwenden oder im Bereich Filter unter Typ die Option App auswählen, um nur Apps anzuzeigen.

  3. Klicken Sie auf die App-Karte, um das Panel Details zu öffnen. Überprüfen Sie die Anforderungen der App (die App Builder-Version und die Datenbank, die sie benötigt).

  4. Klicken Sie auf den Link Zur Dokumentation der App, um diese Dokumentation in einem neuen Tab zu öffnen, und halten Sie ihn zur Referenz offen.

  5. Führen Sie je nach Lizenzierung Ihrer Organisation für App Builder einen der folgenden Schritte aus:

    • App herunterladen: Wenn Ihre Organisation für App Builder lizenziert ist, klicken Sie auf App herunterladen, entweder auf der App-Karte oder im Panel Details. Ihr Browser speichert die .LP-Datei an ihrem Download-Speicherort, und eine Benachrichtigung App Builder-Datei erfolgreich heruntergeladen bestätigt den Download.

    • App anfordern: Wenn Ihre Organisation nicht für App Builder lizenziert ist, wird die Aktion als App anfordern bezeichnet. Das Panel Details zeigt eine Meldung an, dass eine App Builder-Lizenz erforderlich ist, mit einer Schaltfläche Absenden. Klicken Sie auf Absenden, um eine Anfrage zu senden, damit sich ein Vertreter mit Ihnen über App Builder in Verbindung setzt. Eine Benachrichtigung Nachricht erfolgreich gesendet bestätigt dies.

App in App Builder installieren

Installieren Sie die heruntergeladene .LP-Datei in Ihrer App Builder-Instanz:

  1. Melden Sie sich bei App Builder an und gehen Sie zur IDE.

  2. Klicken Sie unter Deploy auf Release installieren.

  3. Klicken Sie auf + Paket, dann auf Durchsuchen und wählen Sie die heruntergeladene .LP-Datei aus.

  4. Klicken Sie auf Speichern. Das Panel Release zeigt die Paketinformationen an und schließt dann das Dialog Paket.

  5. Bestätigen Sie, dass die Details korrekt sind, und klicken Sie auf Installieren.

Um den Inhalt eines Pakets vor der Installation in der Vorschau anzuzeigen, klicken Sie auf die Schaltfläche Manifest.

App in einer Entwicklungsumgebung ändern

Die Datenquelle der App wird versiegelt installiert. Wenn Sie die App in einer Entwicklungsumgebung bereitstellen und beabsichtigen, sie zu ändern, heben Sie die Versiegelung der Datenquelle auf, damit Sie die Objekte der App bearbeiten können. Lassen Sie sie in QA und Produktion versiegelt, um die Äquivalenz zwischen Umgebungen zu bewahren. Siehe Datenquelle versiegeln oder Versiegelung aufheben.

Konfiguration und Setup

Nach der Installation der App in einer neuen Umgebung führen Sie die folgenden Schritte aus, um sie einsatzbereit zu machen:

  1. Benutzer zu Gruppen hinzufügen. Fügen Sie Ihre Benutzer zur entsprechenden Zugriffsgruppe hinzu, entweder AcuTrack Administrator oder AcuTrack User. Siehe Sicherheit und Zugriff.

  2. Benutzerprofile initialisieren. Benutzer werden beim ersten Zugriff automatisch registriert. Weisen Sie auf der Seite Configuration die Abteilung und Kontaktnummer jedes Benutzers zu.

  3. Dashboard-Kartenregion festlegen. Das Kartenpanel zeigt standardmäßig eine Landkreiskarte von Massachusetts. Um in einer anderen Region bereitzustellen, öffnen Sie die Kartenkonfiguration und ersetzen Sie die Kartendatendateien durch die für Ihre Region.

  4. Lookup-Beschriftungen anpassen. Sie können einen Status-Datensatz umbenennen oder seine Beschreibung bearbeiten, um Ihre Terminologie zu entsprechen. Löschen Sie die Status-Datensätze nicht, da die Hintergrundlogik ihre IDs über Enum-Werte referenziert.

  5. Beschriftungen von Aktionsschaltflächen anpassen (optional). Die Tabelle Status hat zwei Spalten, die die Beschriftungen auf den für ein Asset angezeigten Aktionsschaltflächen festlegen: MoveLabel für die Bewegungsschaltfläche (Einchecken und Auschecken) und MaintenanceLabel für die Wartungsschaltfläche (Reparatur und Rückgabe). Wenn ein Status eine dieser Spalten leer lässt, wird die entsprechende Schaltfläche für Assets in diesem Status ausgeblendet. Die Standardbeschriftungen sind:

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

Sicherheit und Zugriff

AcuTrack verwendet App Builder rollenbasierte Sicherheit mit zwei Zugriffsgruppen, AcuTrack Administrator und AcuTrack User. Der Zugriff auf jeden Bereich ist wie folgt:

Bereich AcuTrack Administrator AcuTrack User
Asset- und Bewegungsverfolgung (Startseite) Vollzugriff Erstellen, Aktualisieren und Anzeigen
Analytische Dashboards (Karten und Zeitpläne) Vollzugriff Schreibgeschützt, kann lokale Filter ändern
Aktivitätsprotokoll Vollzugriff Schreibgeschützt
Seite Configuration und Lookups Vollzugriff Kein Zugriff (Menüs ausgeblendet)

Historische Änderungen werden im Audit-Log VinylAuditLog beibehalten, sodass frühere Bewegungen und Bearbeitungen unabhängig vom aktuellen Zugriff eines Benutzers nachverfolgbar bleiben.

Geschäftsregeln

Die Logik von AcuTrack wird als App Builder Geschäftsregeln implementiert. Regelnamen folgen der Konvention Target (Purpose or Subtype) Descriptor von App Builder, sodass das erste Wort die Tabelle identifiziert, auf die die Regel wirkt. Die folgenden Tabellen listen die Regeln nach Funktionsbereich auf, um Sie beim Auffinden und Verstehen zu unterstützen, wenn Sie die App erweitern.

Asset- und Wartungsregeln

Regel Zweck
Asset (Business Object) Masterdatenquelle für Assets.
Asset (List) Asset-Auswahliste, die in Formularen und Gittern verwendet wird.
Asset (Assets Tile) Speist die Mobile-Startseiten-Asset-Kachel.
Assets (By Status) Aggregiert Asset-Anzahlen nach Status für das Dashboard.
Asset (Update) Asset Movement Aktualisiert den aktuellen Standort, die Abteilung und den Status eines Assets, wenn eine Bewegung protokolliert wird.
Asset (Maintenance Calendar) Erstellt wiederkehrende Wartungsereignisse aus dem Intervall des Asset-Typs und dem letzten Wartungsdatum des Assets.
Asset (Maintenance Calendar with Today) Vereinigt Wartungsereignisse mit dem aktuellen Datum, sodass der Kalender auf den aktuellen Monat zentriert ist.
Asset (Calendar) (Upcoming Maintenance) Isoliert bevorstehende oder überfällige Servicefenster.

Bewegungsregeln

Regel Zweck
AssetMovement (Business Object) Datenquelle für das Bewegungsprotokoll.
AssetMovement (Activity Log) Aggregiert Ein-, Aus- und Reparaturereignisse in einen Aktivitätsstrom.
AssetMovement (Default) Field Activity Füllt automatisch Verfolgungswerte, Zeitstempel und die Benutzersitzung beim Ein- und Auschecken aus.
AssetMovement (Default) Maintenance Activity Legt Basiswerte fest, wenn ein Asset in einen Reparaturzyklus eintritt.
AssetMovement (Repair Note Visibility) Macht das Reparaturnotizfeld während der Wartung sichtbar und erforderlich.

Scan-Regeln

Regel Zweck
Scan (Business Object) Datenquelle für die Scan-Stagingtabelle.
Scan (Cram) Fügt einen temporären Scan-Datensatz ein, der an die Benutzersitzung gebunden ist.
Scan (Update) AssetID Ordnet einen gescannten QR-Code dem Asset-Tag zu und gibt die interne Asset-ID zurück.

Sitzungs- und Filterregeln

Regel Zweck
Session (Business Object) Verwaltet den Sitzungsstatus und die Standardwerte des aktiven Benutzers.
Session (Clear Filters) Seitenregel, die die Dashboard-Filter zurückgesetzt.
Session (Update) Clear Filter Löscht die Filter für Standort, Abteilung, Status und Asset-Typ.

Utility-Regeln

Regel Zweck
Parameter (Today) Injiziert das aktuelle Systemdatum für die Kalenderdarstellung.
User (Business Object) Verwaltet Benutzerprofil- und Identitätsdaten.
User (List) Benutzerauswahlliste, die in der gesamten App verwendet wird.

Fehlerbehebung

Die Scan-Seite öffnet die Kamera nicht

  • Symptom: Das Öffnen der mobilen Scan-Seite startet die Kamera nicht, oder der Scan-Bereich bleibt leer.

  • Mögliche Ursache: Der mobile Browser hat den Kamerazugriff für die App Builder-Host-Domain blockiert.

  • Lösung: Suchen Sie in den Standortberechtigungen des mobilen Browsers die App Builder-Host-Domain und setzen Sie den Kamerazugriff auf Zulassen.

Ein neues Asset wird nicht im Wartungskalender angezeigt

  • Symptom: Ein neu hinzugefügtes Asset generiert keine Ereignisse im Wartungskalender für vorbeugende Wartung.

  • Mögliche Ursache: Der Asset-Typ des Assets hat ein Wartungsintervall von 0, das die Planung für diesen Typ unterdrückt.

  • Lösung: Öffnen Sie auf der Seite Konfiguration den Asset-Typ und setzen Sie sein Wartungsintervall auf eine positive Anzahl von Tagen (z. B. 30 für monatliche Wartung).

Die Dashboard-Karte wird nicht gerendert

  • Symptom: Das Dashboard-Kartenpanel wird nicht angezeigt oder gibt einen Datenfehler zurück.

  • Mögliche Ursache: Die Kartencodes in Ihren Location-Datensätzen stimmen nicht mit den Schlüsseln überein, die die Kartendaten erwarten.

  • Lösung: Überprüfen Sie, dass der Kartencode jedes Standorts mit den in den Kartendaten für Ihre Region definierten String-Schlüsseln übereinstimmt.

Weitere Hilfe finden Sie in Ihren App Builder-Protokollen und kontaktieren Sie den Jitterbit-Support.