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

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間：5分

    • ServiceNow インスタンスの clientRefresh モバイルプロパティを使用して、モバイルアプリの自動更新をオンまたはオフにします。clientRefresh プロパティを使用して、モバイルアプリのリフレッシュのスコープを調整することもできます。

    始める前に

    必要なロール：admin

    このタスクについて

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

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

    clientRefresh プロパティは、isEnabled と refreshScope の 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 フォーマッター/バリデーターを使用して、構文に問題がないことを確認します。
      有効 モバイルプロパティをアクティブ化するオプション。このチェックボックスをオフにすると、モバイルプロパティは有効化されません。
      公開

      pre_auth プロパティを API 応答に含めるかどうかを決定します。

      デフォルトでは、このオプションが選択されていません。このプロパティを /pre_auth API 応答に含める場合は、このチェックボックスをオンにします。詳細については、「Adaptive authentication events」を参照してください。

      このチェックボックスが有効になっているモバイルプロパティは、 /user_client API 応答から除外されます。
      モバイルアプリ構成 モバイルプロパティを使用するモバイルアプリ構成。この設定は、モバイルプロパティの動作を、このモバイルアプリ構成にアクセスできるユーザーに制限します。他のユーザーはこのモバイルプロパティにアクセスできず、代わりにデフォルトの動作が発生します。

      値を入力するには、構成名の入力を開始するか、検索アイコンを選択します。検索ダイアログボックスには、選択可能な構成が一覧表示されます。[モバイルアプリ構成] ダイアログボックスで構成を選択します。
      モバイル アプリケーション モバイルプロパティの送信先のモバイルアプリケーション。この設定により、モバイルプロパティの動作がこのモバイルアプリにアクセスできるユーザーに制限されます。他のユーザーはこのモバイルプロパティにアクセスできず、代わりにデフォルトの動作が発生します。

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

    次のタスク

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