Mobile SDKスコープ対象のアプリケーションのインストールと構成

  • リリースバージョン: Zurich
  • 更新日 2025年07月31日
  • 所要時間：5分

    • Mobile SDKを活用するアプリケーションを作成する前に、Mobile SDKスコープ対象のアプリケーションをインストールして構成する必要があります。

    始める前に

    必要なロール：admin

    手順

    1. ServiceNow Store Web サイトのMobile SDKページに移動します。
      詳細については、「Install a ServiceNow Store application」を参照してください。
    2. [ インストールを要求 ] を選択して、 Mobile SDK スコープ対象のアプリケーションを ServiceNow インスタンスにダウンロードします。
    3. Mobile SDKスコープ対象のアプリケーションが ServiceNow インスタンスに正しくインストールされたことを確認します。
      1. プラグインのフォーム [ システム定義 ] > [プラグイン] を開きます。
      2. 検索フィールドに「 mobile_sdk」と入力します。
        次のような画面が表示されます。

        Mobile SDK プラグインの検証
      3. プラグイン ID が sn_mobile_sdk であり、バージョンが最新であることを確認します。
    4. Mobile SDK設定 [sn_mobile_sdk] テーブルを開き、Mobile SDKを利用するアプリケーションの新しいアプリケーションレコードを作成します。

      [Mobile SDK 設定] フォーム
      1. [ 名前 ] フィールドに、 Mobile SDKを活用するアプリケーションの名前を入力します。
      2. [Android アプリケーション ID] フィールドと [Apple バンドル ID] フィールドに、モバイルアプリケーションの ID を入力します。
        たとえば、 Mobile SDK がモバイルアプリケーションに追加された場合、これらの ID はモバイルアプリケーションの ID になります。
      3. [SDK 設定] フィールドに、アプリケーションが利用するすべての機能サービスの JSON 構成プロパティを入力し、true に設定します。
        たとえば、次のようになります。
        {
    "graphql": {
        "enabled" : true,
                "allowGuestAccess" : true
    },
    "table": {
        "enabled" : true,
                "allowGuestAccess" : true
    },
    "api": {
        "enabled" : true,
                "allowGuestAccess" : true
    },
    "attachment": {
        "enabled" : true,
                "allowGuestAccess" : true
    },
    "chat": {
        "enabled" : true,
                "allowGuestAccess" : true
    },
    "web": {
        "enabled" : true,
                "allowGuestAccess" : true
    },
    "push": {
        "enabled" : true
    }
}

        [詳細] チェックボックスがオフになっていることを確認します。これにより、[ SDK 設定 ] フィールドに JSON を入力できます。


        SDK 設定

        SDK設定で追加された適用可能な構成は、ServiceNowインスタンス構成と組み合わせて使用されます。

        たとえば、 chat: enabled = true の場合、チャット機能を利用するには、 ServiceNow インスタンスに 仮想エージェント プラグインがインストールされている必要があります。仮想エージェント プラグインがインストールされていても、SDK 設定に chat: enabled = false が含まれている場合、アプリケーションはチャットインターフェイスを利用できません。

      4. [ 送信] を選択して、アプリケーション設定を保存します。
    5. オプション。アプリケーションでユーザーエクスペリエンスアナリティクスを活用する場合は、アプリケーションをユーザーエクスペリエンスアナリティクスアプリケーションに登録します。
      1. アプリケーションの Mobile SDK 設定レコードを再度開きます。
      2. 画面の左下にある [ アナリティクスに登録] を選択します。
        次のような画面が表示されます。

        アナリティクスの登録
      3. [更新] を選択して登録を保存します。
    6. SDK 設定を確認します。
      1. REST API エクスプローラーに移動します。
      2. 指定されたフィールドに次のように入力します。
        • 名前空間: sn_mobile_sdk
        • API 参照名: Mobile SDK
        • API バージョン: 最新
      3. [Android アプリの設定を取得 (GET)] を選択します。
      4. applicationID フィールドに、関連付けられた Mobile SDK 設定 レコードに入力したAndroidアプリケーション ID を入力し、送信 を選択します。
        応答は次のようになります。

        Verigy SDK 設定

        JSON 応答本文 は次のようになります。

        { 
  "platformVersion": "utah", 
  "enabled": true, 
  "analytics": { 
    "AnalyticsEnabled": true, 
    "AnalyticsEnabledForUnauthenticatedUser": false, 
    "EndpointUrl": "https://my-instance.servicenow.com.com", 
    "InstanceId": "db63a848db9f6091fd3467c8f4879524", 
    "ApiKey": "de742fc9db9f6090e03ad7c8f4961923:af0f36b91bc074109a9054a26032a6bf", 
    "ApiAuth": "11ab4240a6d5459c96d2bfb8e1aa3ddd", 
    "ConsentSettings": null, 
    "AppName": "TestNow App", 
    "AppType": "MobileSDK", 
    "ChannelType": "sdk", 
    "Configuration": {} 
  }, 
  "sdk": { 
    "graphql": { 
      "enabled": true 
    }, 
    "table": { 
      "enabled": true 
    }, 
    "api": { 
      "enabled": true 
    }, 
    "attachment": { 
      "enabled": true 
    }, 
    "chat": { 
      "enabled": true 
    }, 
    "web": { 
      "enabled": true 
    },
    "push": { 
      "enabled": true 
  } 
}