---
sourceDocument: オーストラリア API リファレンス
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/ja-JP/api-reference

 Release :

    - australia

ft:locale :

    - ja-JP

ft:publication_title :

    - オーストラリア API リファレンス

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# ServiceNow インスタンスでホストされている Web ページを表示します

# ServiceNow インスタンスでホストされている Web ページを表示します {#ariaid-title1}

* リリースバージョン: Australia
* 
* 更新日 2026年03月12日
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 所要時間：5分

ネイティブ iOS アプリケーションの ServiceNow インスタンス内でホストされている Web ページを表示できます。
Mobile SDK は必要な認証とセッション管理をシームレスに処理し、[NowWebService](https://servicenow-prod.fluidtopics.net/_P260ZZIsxsZ1DVLr9Cl3w#NowWebServiceiOSAPI "NowWebService クラスは、ServiceNow インスタンス上の Web ページの参照を可能にする関数を提供します。") API は ServiceNow インスタンスに存在するページを処理するために必要な機能を提供します。これらの Web ページには、 ServiceNow プラットフォームで可能なすべての動的なインタラクションがあります。

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

これらの機能を使用するには、まず NowWebService のインスタンスを作成する必要があります。これを行うには、 makeWebService() メソッドを呼び出し、 ServiceNow インスタンスへの URL と既に初期化されている `NowSDK` を指定する必要があります。さらに、アプリケーション内に `NowWeb` をインポートしておく必要があります。`NowWeb` サービスを使用している間は、NowWebService への参照を保持する必要があります。

async/await を使用して NowWebService オブジェクトを作成する方法の例を次に示します。  

    do {
        let service = try await NowWeb.makeWebService(instanceUrl: instanceUrl)
        self.webService = service
    } catch {
        debugPrint("Web Service creation failed with error: \(error.localizedDescription)") 
    }

補完ハンドラーを使用して NowWebService オブジェクトを作成する方法の例を次に示します。

    import Combine
    import NowWeb
    import UIKit
    ...
    public func makeWebService(instanceUrl: URL, 
      completion: @escaping ((Result<NowWeb.NowWebService, NowSDK.NowServiceError>) -> Void)) 

## ページをプリロードして NowWeb の読み込み時間を短縮する

バックグラウンドでキャッシュ可能なリソースを含むページをプリロードして、 NowWeb の初期ロード時間を短縮できます。次の例は、 webService.preloadWebCache() 関数を使用して、指定されたページをプリロードする方法を示しています。

    private func preloadURLs(urls: [URL]) {
      guard let webService = webService else {
        debugPrint("Web service not initialized")
        return
      }
      do {
           try webService.preloadWebCache(urls: urls) {
             debugPrint("URLs did complete preloading")
           }
                
      } catch {
          debugPrint(error.localizedDescription)
      }
    }

## Web コンテンツを表示するビューの作成 {#mobsdk-ios-display-web-pages__section_k5l_c11_kqb}

NowWeb サービスのインスタンスを作成したら、それを使用して、 ServiceNow インスタンスでホストされている Web ページを表示するビューを作成できます。

次の例は、 [NowWebViewController](https://servicenow-prod.fluidtopics.net/1rplrNWqxIlQCSoZwGzhKg#NWebViewControlleriOSAPI "NowWebViewController クラスは、Web ビューアを管理できるようにする関数を提供します。") ビューを作成する方法を示しています。  

    let result = webService.makeWebViewController(for: url, 
      delegate: self, theme: MyWebTheme(nowUITheme: MyUITheme()))
    switch result { 
    case .success(let viewController): 
      return viewController 
    case .failure(let error): 
      debugPrint("Web view creation failed with error: \(error.localizedDescription)") 
    }

この例では、ビュー内でロードする最初のページの URL が url です。この URL は、指定された ServiceNow インスタンスでホストされているページを指す必要があります。相対 URL も機能し、NowWebService のターゲットとなる ServiceNow インスタンスを基準にした相対 URL です。

作成後、NowWebViewController を既存のナビゲーションスタックにプッシュできます。最初のページは、 [loadPage()](https://servicenow-prod.fluidtopics.net/1rplrNWqxIlQCSoZwGzhKg#NWVC-loadPage "要求が認証されると、 makeWebViewController() メソッドを使用して、インスタンス化中に提供された初期 URL のロードを開始します。") メソッドを呼び出すまでロードされません。

## Web ユーザーインターフェイスのテーマ設定 {#mobsdk-ios-display-web-pages__section_mvp_5c1_kqb}

makeWebViewController() 呼び出しでテーマオブジェクトを渡すことで、Web UI の色をカスタマイズできます。カスタマイズできるすべての要素のリストについては、「 [NowWebColoring プロトコル : iOS](https://servicenow-prod.fluidtopics.net/TkY25fhglfLRshnXL3g3AA "NowWebColoring プロトコルは、ネイティブ Web ビューの ServiceNow インスタンスでホストされている Web ページ内で使用される色のデフォルト値を提供します。")」を参照してください。デフォルトでは、Web UI はすべての NowSDK UI 要素に NowUIColor テーマを使用します。Web UI にテーマを適用する方法に関するサンプルコードスニペットについては、 [NowWebThemeable プロトコル : iOS](https://servicenow-prod.fluidtopics.net/gKIEWFPbu9aj9Gvc17yCpQ "NowWebThemeable プロトコルには、ネイティブ Web ビューの ServiceNow インスタンスでホストされている Web ページ内で使用される色を上書きできるプロパティが用意されています。") を参照してください。