関連レコードをオフラインキャッシュに登録する

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：3分

    • アドミニストレーターは、ユーザーが モバイルエージェントでオンラインモードでアクションを実行したときに、関連するレコードをオフラインキャッシュに含めるようにオフラインモードを構成できます。

    始める前に

    必要なロール：admin

    このタスクについて

    ServiceNow インスタンスでオフラインモードが有効になっている場合は、オフラインキャッシュに追加のレコードを含めるようにインスタンスを設定できます。これらの追加レコードは、エンドユーザーがオフラインモードのときに使用できるようになります。

    重要:
    この機能は、スクリプト化された書き戻しアクションでのみサポートされています。

    次の手順を使用して関連レコードをオフラインキャッシュに登録する前に、アクションアイテムを設定する必要があります。アクションアイテムの構成については、「 オフラインモードでのアクションアイテムとアクションステップの設定 」を参照してください。

    このタスクを構成するにはスクリプティングを使用する必要があり、そのためには API を使用する必要があります。

    手順

    1. 移動先 すべて > システムモバイル > モバイルアプリビルダー.
      モバイルアプリビルダー が新しいブラウザータブで開き、アプリケーションスコープ選択画面が表示されます。
    2. 作業しているアプリケーションスコープを検索し、アプリケーションスコープの名前を選択します。
      モバイルアプリビルダー カテゴリのホーム画面が表示されます。
    3. メニューから [すべてのモバイルレコード] を選択します。
    4. [レコード タイプ] フィールドから、アクション アイテム [sys_sg_write_back_action_item] を選択し、作成したアクション アイテムを選択します。
    5. [ タイプ ] フィールドで [ スクリプト] を選択します。
    6. [ 実行スクリプト ] フィールドで、同期スクリプトを追加します。
      たとえば、次のスクリプトは、エンドユーザーのオンライン中に作業指示書が作成されると、作業指示書タスクを自動的に作成します。これにより、エンドユーザーがオフラインモードのときに作業指示タスクを使用できるようになります。
      (function WriteBackAction(input) {
    //Register additional record for offline mode
    actionResult.addRecordForSync("work-order-task","ef1a8b34df113100dca6a5f59bf26327")
})(input);
      ここで、 "work-order-task" は書き戻し応答のドキュメント データ セクションに含まれるテーブルで、 "ef1a8b34df113100dca6a5f59bf26327" はテーブルのsys_idです。
      注:
      • この API は複数回呼び出して 異なるテーブルまたは同じテーブルに複数のレコードを登録できます。
      • オフライン データベースに含めるレコードを指定するには、レコードのテーブル名 (文字列) とsys_id (文字列) を使用します。
      • sys_id で指定されたレコードとその関連フィールドが、書き戻し応答のドキュメント データ セクションに表示されます。
      • sys_id で指定されたレコードは、オフラインデータベースと同期されます。
      • この API で追加するデータは、更新されたドキュメントまたは書き戻し応答の宛先ドキュメントにカプセル化する必要があります。少なくとも更新されたドキュメントまたは宛先ドキュメントが書き戻し応答に存在するようにするには、この API を呼び出すボタンに宛先画面を構成できます。この API を呼び出すボタンで宛先画面を構成すると、データが宛先ドキュメントに含まれることが保証されます。
    7. [保存] を選択します。