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

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

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

    始める前に

    必要なロール：admin

    手順

    1. ServiceNow Store Web サイトの Mobile SDK ページに移動します。
      詳細については、「Install a ServiceNow Store application」を参照してください。
    2. [ Request Install (インストールを要求 )] を選択して、 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 Explorer に移動します。
      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 
  } 
}