Zum Inhalt springen

Jitterbit AcuTrack App

Übersicht

Jitterbit stellt die AcuTrack App über den Jitterbit Marketplace bereit. Sie wurde mit Jitterbit App Builder entwickelt und ist eine mobile-first Anwendung zur Verwaltung physischer Bestände. Teams können Assets ein- und auschecken, ihren Standort und ihre Abteilung verfolgen, präventive Wartungen planen und Asset-Tags mit der Kamera eines Mobilgeräts scannen. Das Datenmodell ist generisch, sodass die gleiche App IT-Hardware, Werkzeuge, Ausrüstung oder Flottenfahrzeuge verfolgen kann.

Man lädt die App als App Builder Release Package (eine .LP Datei) vom Marketplace herunter und installiert sie in einer eigenen App Builder Instanz, wo man sie für den eigenen Prozess konfigurieren und erweitern kann.

Diese Seite beschreibt wie die App funktioniert, ihre Kernfunktionen und Datenmodell, und behandelt 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 Problemlösung.

Funktionsweise

Auf hoher Ebene richtet ein Administrator den Asset-Katalog ein, Benutzer erfassen Asset-Bewegungen (einschließlich durch mobiles Scannen), und die App aktualisiert alle Assets und betreibt die Tracking-Dashboards:

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

Kernfunktionen

Bei der Installation und Konfiguration von AcuTrack stellt die App folgende Funktionen bereit:

  • Asset-Lebenszyklus-Verwaltung: Administratoren definieren Asset-Kategorien, Abteilungen, Standorte und Betriebsstatus auf einer einzelnen Konfigurationsseite.

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

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

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

  • Dashboards: Das Home-Dashboard zeigt Asset-Gesamtzahlen nach Status, ein Kartenpanel für geografische Verteilung und einen Kalender für anstehende Wartungen. Alle lassen sich nach Standort, Abteilung, Status und Asset-Typ filtern und ermöglichen ein 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, wird diese Datenquelle Asset Tracking genannt. Die App benötigt keine externe Datenbankverbindung, sondern liest authentifizierte App Builder Benutzer über eine native Verbindung zur App Builder Instanz.

Tabelle Zweck
Asset Hauptregister verfolgter Elemente, einschließlich Tags, Beschreibungen und aktuellem Standort.
AssetType Asset-Kategorien und ihre Wartungsintervalle für präventive Wartung.
AssetMovement Transaktionsjournal von Ein- und Auscheckvorgängen sowie Reparaturen mit Benutzer- und Bild-Metadaten.
MovementType Validierte Transaktionstypen (Check-In, Check-Out, Repair).
Status Betriebszustände (zum Beispiel Available, Maintenance) mit Farb- und Schaltflächenbeschriftungseinstellungen.
Location Standortindex mit Adressen, Regionsdaten und Kartencodes.
Department Organisationseinheiten für Zuständigkeit und Berichterstattung.
Scan Temporäre Staging-Tabelle für Kamera-QR- und Barcode-Payloads.
Session Laufzeit-Status 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 Intervall-Hilfsprogramm für Hintergrund-Logik-Schleifen.

Die Tabellen Status, MovementType, Location, Department und AssetType enthalten Beispiel-Suchdaten, damit die App sofort nach der Installation funktioniert.

Beziehungen

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

Tabelle Referenziert
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. Ist Ihre Organisation nicht für App Builder lizenziert, 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 genauen App Builder-Version installiert. Falls Ihre Instanz eine andere Version hat, wenden Sie sich an den Jitterbit-Support, um ein entsprechendes Paket anzufordern.

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

  • Für QR-Scans ein Mobilgerät mit Kamera und aktiviertem Kamerazugriff für den App Builder-Host im mobilen Browser. 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 nutzen oder im Bereich Filter unter Typ die Option App auswählen, um nur Apps anzuzeigen.

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

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

  5. Führen Sie einen der folgenden Schritte aus, je nachdem, ob Ihre Organisation für App Builder lizenziert ist:

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

    • App anfordern: Falls Ihre Organisation nicht für App Builder lizenziert ist, wird die Aktion als App anfordern bezeichnet. Das Bedienfeld 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 Meldung 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 Bereitstellen auf Version installieren.

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

  4. Klicken Sie auf Speichern. Das Bedienfeld Version zeigt die Paketinformationen an und schließt dann das Dialogfeld 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, brechen 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 Entsprechung 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 durch, um sie einsatzbereit zu machen:

  1. Benutzer Gruppen zuweisen. Fügen Sie Ihre Benutzer der 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. Kartenkarte des Dashboards festlegen. Die Kartenkarte wird standardmäßig als Bezirkskarte von Massachusetts angezeigt. 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 sie an Ihre Terminologie anzupassen. Löschen Sie nicht die Status-Datensätze, 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 Aktionsschaltflächen festlegen, die für ein Asset angezeigt werden: MoveLabel für die Bewegungsschaltfläche (Auscheckung und Eincheckung) 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 mit 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 die einzelnen Bereiche 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, lokale Filter können geändert werden
Aktivitätsprotokoll Vollzugriff Schreibgeschützt
Seite Configuration und Lookups Vollzugriff Kein Zugriff (Menüs ausgeblendet)

Historische Änderungen werden im Audit-Log VinylAuditLog gespeichert, 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 führende Wort die Tabelle identifiziert, auf die sich die Regel auswirkt. Die folgenden Tabellen listen die Regeln nach Funktionsbereichen auf, um Sie beim Lokalisieren und Verstehen dieser Regeln bei der Erweiterung der App zu unterstützen.

Asset- und Wartungsregeln

Regel Zweck
Asset (Business Object) Masterdatenquelle für Assets.
Asset (List) Asset-Auswahliste, die in Formularen und Rastern verwendet wird.
Asset (Assets Tile) Speist die Kachel mit den mobilen Assets auf der Startseite.
Assets (By Status) Aggregiert Asset-Zähler 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 Bewegungshauptbuch.
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 Einchecken und Auschecken aus.
AssetMovement (Default) Maintenance Activity Legt Grundwerte fest, wenn ein Asset in einen Reparaturzyklus eintritt.
AssetMovement (Repair Note Visibility) Macht das Feld für Reparaturnotizen während der Wartung sichtbar und erforderlich.

Scanregeln

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 Standardeinstellungen 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-Domäne blockiert.

  • Lösung: Suchen Sie in den Websiteberechtigungen des mobilen Browsers die App-Builder-Host-Domäne und stellen Sie den Kamerazugriff auf Zulassen.

Ein neues Asset wird nicht im Wartungskalender angezeigt

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

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

  • Lösung: Öffnen Sie auf der Seite Konfiguration den Asset-Typ und stellen Sie sein Wartungsintervall auf eine positive Anzahl von Tagen ein (zum Beispiel 30 für monatlichen Service).

Die Dashboard-Karte wird nicht gerendert

  • Symptom: Das Dashboard-Kartenfenster 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 erhalten Sie in Ihren App-Builder-Logs. Kontaktieren Sie Jitterbit-Support.