NowSDK アーキテクチャ

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

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

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 プラットフォーム内に保存し、後で分析および追跡する機能を提供します。
• NowChat

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

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

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

  • プライマリ API:
    • NowPushSDK: この API は、Android デバイスへの非請求 (プッシュ) 通知の送信を可能にする NowPushService を作成するために必要な関数を提供します。
    • NowPushService: この API は、プッシュ サービスとのやり取りを可能にする関数を提供します。
• ナウウェブ

  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 サービスオブジェクトを作成する機能を提供します。