アプリの自動更新をオンまたはオフにする

  • リリースバージョン: Washingtondc
  • 更新日 2024年02月01日
  • 読む5読むのに数分
  • ServiceNow インスタンスの clientRefresh モバイルプロパティを使用して、モバイルアプリの自動更新をオンまたはオフにします。clientRefresh プロパティを使用して、モバイルアプリの更新範囲を調整することもできます。

    始める前に

    必要なロール:admin

    このタスクについて

    clientRefresh モバイルプロパティは、ServiceNow プラットフォームサーバーではデフォルトで有効になっています。San Diego 以降のバージョンのサーバーインスタンスによって管理されるモバイルアプリは、エンドユーザーがレコード内のデータを変更するアクションアイテムを実行すると、自動的に更新されます。データの変更は、ユーザーにすぐに表示されます。ユーザーはモバイルアプリを更新する必要はありません。この機能が有効になっている場合、アプリの更新を促す新しい画像は表示されなくなりました。この機能は、モバイルアプリのパフォーマンスに影響を与えません。モバイルアプリは、以前にアクセスした画面のみを更新します。この動作をオフにする場合は、このタスクで説明されている手順を使用します。

    モバイルプロパティは、ServiceNow プラットフォームサーバーの sys_sg_properties テーブルのレコードとして構成されます。ServiceNow インスタンスは、認証後にモバイルプロパティをモバイルアプリに送信します。次に、プロパティはモバイルアプリの機能をオンまたはオフにします。clientRefresh モバイルプロパティは、JSON スクリプトを使用して構成されます。

    clientRefresh プロパティは、isEnabledrefreshScope の 2 つのキーを持つ JSON オブジェクトで、これらのキーはモバイルプロパティの新しいレコードフォームに記述されています。
    重要:
    ServiceNow サーバーの San Diego リリース以降、動作の更新をオフにするには、新しい clientRefresh JSON オブジェクトを作成し、モバイルプロパティ定義で isEnabled キーを false に設定する必要があります。

    手順

    1. 移動先 すべて > sys_sg_properties.list.
      [モバイルプロパティ] リストが表示されます。
    2. [モバイルプロパティ] リストで、[新規] を選択します。
      [モバイルプロパティ] フォームが表示されます。
    3. フォームのフィールドに入力します。
      表 : 1. [モバイルプロパティ] の新規レコードフォーム
      フィールド 説明
      名前 モバイルプロパティレコードの名前。自動アプリ更新機能を構成可能にするには、「clientRefresh」と入力します。この機能はデフォルトでオンになっていますが、構成するにはこれを作成する必要があります。作成するまでインスタンスには表示されません。
      注:
      レコード名は大文字と小文字を区別するため、「clientRefresh」と入力する必要があります。
      アプリケーション モバイルプロパティが適用されるアプリケーションスコープ。別のアプリケーションスコープを選択するには、インスタンスバナーのグローブアイコン (グローブアイコン) を選択します。次に、[アプリケーションスコープ:application_scope] を選択します。

      アプリケーションスコープがモバイルプロパティに与える影響については、「モバイルのプロパティ」を参照してください。

      説明 モバイルプロパティの説明。プロパティの説明を入力します。たとえば、 モバイルアプリのインスタンスデータの自動更新をオンまたはオフにします。
      タイプ モバイルプロパティレコードのデータタイプ。clientRefresh モバイルプロパティには [JSON] を選択する必要があります。
      この機能を構成する JSON コード。
      • この機能を無効にするには、次のように入力します。
        {"isEnabled":false,"refreshScope":"all_tabs"}
      • この機能を有効にするには、次のように入力します。
        {"isEnabled":true,"refreshScope":"all_tabs"}
      • 更新されるデータのスコープを拡大するには、次のように入力します。
        {"isEnabled":true,"refreshScope":"all_tabs"}

        "all_tabs" を使用すると、レコード内のデータを変更するアクションがモバイルアプリで実行された後に、すべてのナビゲーションバータブのすべての画面が更新されます。

      • 更新されるデータのスコープを制限するには、次のように入力します。
        {"isEnabled":true,"refreshScope":"current_tab"}

        "current_tab" を使用すると、モバイルアプリでアクションが実行された後に、現在のナビゲーションバータブのみが更新されます。

      注:
      JSON フォーマッター/バリデーター (validator) を使用して、構文の問題がないことを確認します。
      有効 モバイルプロパティを有効化するオプション。このチェックボックスをオフにすると、モバイルプロパティは有効化されません。
      モバイルアプリ構成 モバイルプロパティを使用するモバイルアプリの構成。この設定により、モバイルプロパティの動作が、このモバイルアプリ構成にアクセスできるユーザーに制限されます。他のユーザーはこのモバイルプロパティにアクセスできず、代わりにデフォルトの動作が発生します。

      値を入力するには、構成名の入力を開始するか、検索アイコンを選択します。検索ダイアログボックスには、選択可能な構成が一覧表示されます。[モバイルアプリ構成] ダイアログボックスで構成を選択します。

      モバイルアプリケーション モバイルプロパティを送信するモバイルアプリケーション。この設定により、モバイルプロパティの動作がこのモバイルアプリにアクセスできるユーザーに制限されます。他のユーザーはこのモバイルプロパティにアクセスできず、代わりにデフォルトの動作が発生します。

      値を入力するには、アプリケーション名の入力を開始するか、検索アイコンを選択します。[検索] ダイアログボックスには、選択可能なアプリケーションが一覧表示されます。[モバイルアプリケーション] ダイアログボックスでアプリケーションを選択します。

    4. [送信] を選択します。

    次のタスク

    このプロパティを更新した後、エンドユーザーはプルして更新し、最新の機能構成を取得する必要があります。