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

管理者は、ユーザーが自分の環境でオンラインモードで モバイルエージェントアクションを実行したときに、関連するレコードをオフラインキャッシュに含めるようにオフラインモードを構成できます。

始める前に

必要なロール：admin

このタスクについて

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

重要:

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

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

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

手順

1. 移動先 すべて > システムモバイル > Mobile App Builder.
   モバイルアプリビルダー が新しいブラウザータブで開き、アプリケーションスコープ選択画面が表示されます。
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. [保存] を選択します。