NowSDK アーキテクチャ

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

    • NowSDK は、 Mobile SDK クラスフレームワークの最上位エンティティです。

    これには、 Mobile SDK と ServiceNow インスタンスによって提供される重要な機能を活用できるようにする多数のクラス、インターフェイス、および関数が含まれています。このドキュメントでは、ServiceNowインスタンスとやり取りできるようにする、Mobile SDKで公開されている主な機能サービスについて説明します。

    Mobile SDKが提供する機能サービスを使用するには、NowSDK ライブラリをコードに統合する必要があります。SDK 機能を使用する前に、コアライブラリを呼び出して SDK を構成および初期化する必要があります。

    NowSDK には次の機能があります。

    • SDK の初期化と設定の取得と構成。
    • シームレスな認証とユーザーセッション処理。
    • ログ記録インターフェイス。NowSDK は、すべての機能サービスにログ記録サービスを提供します。デフォルトでは、ログメッセージはプラットフォーム固有の機能を使用してシステムログに書き込まれます。SDK を構成する呼び出しの一部であるパラメーターを使用して、ログ記録しきい値を制御できます。SDK とその機能サービスによって生成されたすべてのログメッセージを抑制するオプションもあります (ログレベル = none)。独自のログ記録ソリューションがすでに導入されている場合は、 Mobile SDK でそれを使用できます。
    • インフラストラクチャを構築してリリースします。
    NowSDK は、次の機能サービスと関連 API を提供します。
    • NowDataSDK

      サードパーティアプリケーションが、 ServiceNow インスタンスで公開されているパブリック REST API にアクセスできるようにします。NowDataSDK は NowSDK によって提供される認証およびセッション処理機能を利用するため、開発が合理化されます。

      • プライマリ API:
        • NowAPIService:この API は、ServiceNow インスタンスで公開されている REST API とやり取りできるようにする機能を提供します。
        • NowAttachmentService:この API は、Android アプリケーション内の ServiceNow インスタンスに添付ファイルをアップロードしてクエリを実行する機能を提供します。
        • NowGraphQLService:この API は、GraphQL クエリを使用して、ServiceNow REST GraphQL API を使用して ServiceNow インスタンス内のテーブルからデータを取得できるようにする機能を提供します。
        • NowTableService:この API は、ServiceNow REST Table API を介してサービスを受ける ServiceNow インスタンス内の既存のテーブルに対して、作成、読み取り、更新、および削除 (CRUD) 操作を実行できる機能を提供します。
    • Now アナリティクス

      モバイルアプリケーション内で利用状況分析を収集して追跡できるようにします。

      • プライマリ API:
        • NowAnalytics:このAPIは、ユーザー分析データを収集し、後で分析および追跡するために ServiceNow プラットフォーム内に保存する機能を提供します。
    • Now チャット

      アプリケーションにネイティブ 仮想エージェント チャットウィンドウを埋め込むことができます。このサービスには、UI/UX 機能が含まれています。

      • プライマリ API:
        • NowChatService: この API は、Android アプリケーションに 仮想エージェント および ライブエージェント チャット機能を提供します。アプリケーション内に NowChatService を実装するだけで、ServiceNowプラットフォームが提供するすべてのサービスチャット機能を活用できます。
    • Now プッシュ

      NowChat/仮想エージェント 機能を利用するアプリケーションに未承諾メッセージを送信できるようにします。

      • プライマリ API:
        • NowPushSDK: この API は、要求されていない (プッシュ) 通知をAndroidデバイスに送信できるようにする NowPushService を作成するために必要な関数を提供します。
        • NowPushService:この API は、プッシュ サービスとの対話を可能にする関数を提供します。
    • NowWeb

      ServiceNow インスタンスでホストされている Web ページをネイティブ Web ビューまたは Cabrillo でロードできるようにします。ユーザーにログイン Web ページを介してインスタンスへのログインを強制するのではなく、ユーザー認証とセッション管理を自動的に処理します。

      Web ビューが ServiceNow インスタンスでホストされている Web ページをロードするように要求されると、NowSDK によって提供される OAuth アクセストークンを含む適切なベアラーヘッダーを持つ HTTP 要求が作成されます。インスタンスは、この要求を受信すると、新しいユーザーセッションを開始し、そのセッションに関連する Cookie を返します。ユーザーが Web ビューで Web ページを操作すると、インスタンスは Cookie を使用してセッションがまだ有効であることを検証します。この時点で、ベアラーヘッダーは関連性がなくなり、Cookie のみがセッションの検証に使用されます。ユーザーがタイムアウト期間よりも長く Web サイトの操作を停止すると、Web セッションは期限切れになります。セッションの有効期限が切れた後、ユーザーが Web ページを操作しようとすると、ログインページに自動的にリダイレクトされます。NowWebViewController はリダイレクトを検出し、NowSDK に更新されたアクセストークンを要求し、そのトークンを使用して最後に読み込まれた既知のページの HTTP 要求 (ベアラーヘッダー付き) を作成することで、新しい Web セッションの開始を試みます。

      • プライマリ API:

        NowWebSDK:この API は、 ServiceNow インスタンスの Web ページを Android アプリケーションに表示できるようにする NowWeb サービスオブジェクトを作成する機能を提供します。