---
sourceDocument: Yokohama-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/yokohama/api-reference

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Zeigen Sie Webseiten an, die auf Ihrem gehostet werden ServiceNowInstanz

# Zeigen Sie Webseiten an, die auf Ihrem gehostet werden ServiceNowInstanz {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 Minuten Lesedauer

Sie können Webseiten anzeigen, die in gehostet werden ServiceNowInstanz in Ihrer nativen iOS-Anwendung.
Die Mobile SDKBietet eine nahtlose Verarbeitung der erforderlichen Authentifizierung und Sitzungsverwaltung, während [Jetzt Webservice](https://servicenow-prod.fluidtopics.net/hgTMRw1lKxiaB7dzsLg6gw#NowWebServiceiOSAPI "Die Jetzt Webservice Die Klasse bietet Funktionen, die das Durchsuchen von Webseiten auf einem ermöglichen ServiceNowInstanz.")Die API bietet die Funktionalität, die für die Verarbeitung von Seiten erforderlich ist, die sich auf Ihrem befinden ServiceNowInstanz. Diese Webseiten verfügen über alle dynamischen Interaktionen, die auf möglich sind ServiceNowPlattform.

Wenn die Webansicht angefordert wird, eine Webseite zu laden, die auf einem gehostet wird ServiceNowInstanz erstellt sie eine HTTP-Anforderung mit dem entsprechenden Bearer-Header, der das vom NowSDK bereitgestellte OAuth-Zugriffstoken enthält. Wenn die Instanz diese Anforderung erhält, startet sie eine neue Anwendersitzung und gibt Cookies im Zusammenhang mit dieser Sitzung zurück. Während der Anwender mit den Webseiten in der Webansicht interagiert, verwendet die Instanz die Cookies, um zu überprüfen, ob die Sitzung noch gültig ist. Zu diesem Zeitpunkt ist der Bearer-Header nicht mehr relevant, nur die Cookies werden für die Sitzungsvalidierung verwendet. Die Websitzung läuft ab, wenn der Anwender die Interaktion mit der Website länger als die Zeitüberschreitung beendet. Wenn der Anwender nach Ablauf der Sitzung versucht, mit der Webseite zu interagieren, wird er automatisch zur Anmeldeseite weitergeleitet. Der NowWebViewController erkennt die Umleitung und versucht, eine neue Websitzung zu starten, indem er ein aktualisiertes Zugriffstoken vom NowSDK anfordert und das Token verwendet, um eine HTTP-Anforderung (mit Bearer-Header) für die letzte bekannte geladene Seite zu erstellen.

Um diese Funktionen zu verwenden, müssen Sie zuerst eine Instanz von erstellen Jetzt Webservice . Dazu müssen Sie anrufen MakeWebservice() Methode und geben Sie die URL an ServiceNowInstanz und bereits initialisiert `Now SDK `. Außerdem müssen Sie importiert haben `Now Web `In Ihrer Anwendung. Sie sollten einen Verweis auf enthalten Jetzt Webservice Solange Sie verwenden `Now Web `Service.

Das folgende Beispiel zeigt, wie ein Now WebService-Objekt mit asynchron/warten erstellt wird:  

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

Das folgende Beispiel zeigt, wie ein Now WebService-Objekt mit einem Abschlusshandler erstellt wird:

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

## Laden Sie Seiten vorab, um die Now Web-Ladezeit zu verbessern

Sie können Seiten mit zwischenspeicherbaren Ressourcen im Hintergrund vorab laden, um die anfängliche Verbesserung zu verbessern Now Web Ladezeiten. Das folgende Beispiel zeigt, wie verwendet wird Webservice.preloadWebCache() Funktion zum Vorladen angegebener Seiten.

    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)
      }
    }

## Erstellen Sie Ansichten, um Webinhalte anzuzeigen {#mobsdk-ios-display-web-pages__section_k5l_c11_kqb}

Sobald Sie eine Instanz von Now WebService instanziiert haben, können Sie sie verwenden, um Ansichten zum Anzeigen von Webseiten zu erstellen, die auf Ihrem gehostet werden ServiceNowInstanz.

Das folgende Beispiel zeigt, wie ein erstellt wird [Jetzt WebViewController](https://servicenow-prod.fluidtopics.net/ObKaWWOzEiWI1vj~MSjsGA#NWebViewControlleriOSAPI "Die Jetzt WebViewController Die Klasse bietet Funktionen, mit denen Sie einen Web Viewer verwalten können.")Ansicht:  

    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)") 
    }

In diesem Beispiel urlIst die URL der ersten Seite, die in der Ansicht geladen werden soll. Diese URL muss auf eine Seite verweisen, die auf der angegebenen gehostet wird ServiceNowInstanz. Relative URLs funktionieren auch und sind relativ zu ServiceNowInstanz, die vom Now WebService angestrebt wird.

Nach der Erstellung können Sie den NowWebViewController auf einen vorhandenen Navigations-Stapel verschieben. Die Anfangsseite wird erst geladen, wenn Sie aufrufen [Ladeseite()](https://servicenow-prod.fluidtopics.net/ObKaWWOzEiWI1vj~MSjsGA#NWVC-loadPage "Wenn die Anforderung authentifiziert ist, beginnt mit dem Laden der anfänglichen URL, die während der Instanziierung mit angegeben wurde MakeWebViewController() Methode.")Methode.

## Design der Webanwenderoberfläche {#mobsdk-ios-display-web-pages__section_mvp_5c1_kqb}

Sie können die Farben der Web-UI anpassen, indem Sie ein Designobjekt in übergeben MakeWebViewController() Rufen Sie an. Eine Liste aller Elemente, die Sie anpassen können, finden Sie unter [Now WebColoring-Protokoll -- iOS](https://servicenow-prod.fluidtopics.net/9iElgbEtqiWkC2XrxEf12w "Die Jetzt Webfarbe das protokoll stellt Standardwerte für die Farben bereit, die auf Webseiten verwendet werden, die auf gehostet werden ServiceNowInstanz in einer nativen Webansicht."). Standardmäßig verwendet die Web-UI das NowUIColor-Design für alle NowSDK-UI-Elemente. Weitere Informationen finden Sie unter [Now WebThemeable-Protokoll -- iOS](https://servicenow-prod.fluidtopics.net/rN2x52Xrhwy5d93crxWdBw "Die Jetzt WebThemeable das protokoll bietet Eigenschaften, mit denen Sie die Farben überschreiben können, die auf Webseiten verwendet werden, die auf gehostet werden ServiceNowInstanz in einer nativen Webansicht.")Für Beispielcode-Fragmente, in denen beschrieben wird, wie ein Design auf Ihre Web-UI angewendet wird.

