NowSDK アーキテクチャ

  • リリースバージョン: Yokohama
  • 更新日 2025年01月30日
  • 所要時間：5分

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

    これには、 モバイル SDK と ServiceNow インスタンスによって提供される重要な機能を活用できるようにする多数のクラス、インターフェイス、および関数が含まれています。このドキュメントでは、ServiceNow インスタンスの操作を可能にする、モバイル SDKで公開されているプライマリ フィーチャ サービスについて説明します。

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

    NowSDK は次の機能を提供します。

    • SDK の初期化と設定の取得と構成。
    • シームレスな認証とユーザーセッション処理。
    • ログ記録インターフェイス。NowSDK は、すべてのフィーチャ サービスにログ サービスを提供します。デフォルトでは、ログメッセージはプラットフォーム固有の機能を使用してシステムログに書き込まれます。SDK を構成する呼び出しの一部であるパラメーターを使用して、ログ記録しきい値を制御できます。SDK とそのフィーチャサービスによって生成されるすべてのログメッセージを非表示にするオプションもあります (ログレベル = なし)。独自のロギングソリューションが既にある場合は、 モバイル 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) 操作を実行できるようにする機能を提供します。
    • NowAnalytics

      モバイルアプリケーション内で使用状況アナリティクスを収集して追跡できます。

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

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

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

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

      • プライマリ API:
        • NowPushSDK: この API は、Android デバイスへの迷惑 (プッシュ) 通知の送信を可能にする NowPushService を作成するために必要な機能を提供します。
        • NowPushService:この API は、プッシュサービスとの対話を可能にする機能を提供します。
    • NowWeb

      ネイティブ Web ビューまたは Cabrillo で ServiceNow インスタンスでホストされている Web ページをロードできます。ログイン 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 サービスオブジェクトを作成する機能を提供します。