Registrieren Sie zugeordnete Datensätze im Offline-Cache

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer

    • Administratoren können den Offline-Modus so konfigurieren, dass zugeordnete Datensätze in den Offline-Cache aufgenommen werden, wenn ein Benutzer im Online-Modus eine Aktion für Mobile Agentausführt.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Warum und wann dieser Vorgang ausgeführt wird

    Wenn für Ihre Instanz ServiceNow der Offline-Modus aktiviert ist, können Sie die Instanz so konfigurieren, dass zusätzliche Datensätze in den Offline-Cache aufgenommen werden. Dann sind diese zusätzlichen Datensätze verfügbar, wenn sich der Endanwender im Offline-Modus befindet.

    Wichtig:
    Diese Funktion wird nur für geskriptete Rückschreibaktionen unterstützt.

    Sie müssen ein Aktionselement konfigurieren, bevor Sie die folgenden Schritte ausführen können, um zugehörige Datensätze im Offline-Cache zu registrieren. Informationen zum Konfigurieren eines Aktionselements finden Sie unter Aktionselemente und Aktionsschritte im Offlinemodus konfigurieren.

    Sie müssen Skripting verwenden, um diese Aufgabe zu konfigurieren, was die Verwendung einer API erfordert.

    Prozedur

    1. Navigieren zu Alle > System Mobile > Mobile App Builder.
      Mobile App Builder wird in einer neuen Browserregisterkarte geöffnet und der Auswahlbildschirm für den Anwendungsbereich wird angezeigt.
    2. Suchen Sie nach dem Anwendungsbereich, in dem Sie arbeiten, und wählen Sie dann den Namen des Anwendungsbereichs aus.
      Der Startbildschirm der Mobile App Builder-Kategorien wird angezeigt.
    3. Wählen Sie im Menü Alle Mobile-Datensätze aus.
    4. Wählen Sie im Feld Datensatztypdie Option Aktionselement [sys_sg_write_back_action_item]aus, und wählen Sie dann das von Ihnen erstellte Aktionselement aus.
    5. Wählen Sie im Feld Typdie Option Skriptaus.
    6. Fügen Sie im Feld Ausführungsskript das Synchronisierungsskript hinzu.
      Beispiel: Das folgende Skript erstellt automatisch eine Arbeitsauftragsaufgabe, wenn ein Arbeitsauftrag erstellt wird, während der Endanwender online ist. Dann ist die Arbeitsauftragsaufgabe für den Endanwender verfügbar, wenn er sich im Offline-Modus befindet:
      (function WriteBackAction(input) {
    //Register additional record for offline mode
    actionResult.addRecordForSync("work-order-task","ef1a8b34df113100dca6a5f59bf26327")
})(input);
      Dabei ist „work-order-task“ die Tabelle, die in den Dokumentdatenabschnitt der Rückschreibantwort aufgenommen werden soll, und „ef1a8b34df113100dca6a5f59bf26327“ die sys_id in der Tabelle.
      Hinweis:
      • Diese API kann mehrmals aufgerufen werden, um mehrere Datensätze in verschiedenen Tabellen oder in derselben Tabelle zu registrieren.
      • Um den Datensatz anzugeben, den Sie in die Offline-Datenbank aufnehmen möchten, verwenden Sie den Tabellennamen (Zeichenfolge) und die sys_id (Zeichenfolge) des Datensatzes.
      • Der von sys_id angegebene Datensatz und die zugehörigen Felder werden im Dokumentdatenabschnitt der Rückschreibantwort angezeigt.
      • Der durch sys_id angegebene Datensatz wird dann mit der Offline-Datenbank synchronisiert.
      • Die Daten, die Sie mit dieser API hinzufügen, müssen im aktualisierten Dokument oder im Zieldokument der Rückschreibantwort gekapselt sein. Um sicherzustellen, dass in Ihrer Rückschreibantwort mindestens ein aktualisiertes Dokument oder ein Zieldokument vorhanden ist, können Sie einen Zielbildschirm auf der Schaltfläche konfigurieren, die diese API aufruft. Wenn Sie einen Zielbildschirm für die Schaltfläche konfigurieren, die diese API aufruft, werden Ihre Daten garantiert in das Zieldokument aufgenommen.
    7. Wählen Sie Speichern.