NowWebViewServiceDelegate interface - Android

  • Release version: Yokohama
  • Updated January 30, 2025
  • 1 minute to read
  • The NowWebViewServiceDelegate API provides callbacks for notification of issues within the NowWebService processing such as when a flow ends or a navigation fails.

    NowWebViewServiceDelegate - flowEnded(flowName: String?)

    Callback that notifies the host application that the specified flow has ended.

    Table 1. Parameters
    Name Type Description
    flowName String Name of the flow that ended.
    Table 2. Returns
    Type Description
    None

    The following code example shows how to call this function.

    suspend fun getNowWebService(): NowWebService {
      return NowWebSDK.makeWebService(URL("https://instance-name.service-now.com"), object : NowWebViewServiceDelegate {
        override fun flowEnded(activity: Activity, flowName: String?) {
          Log.i("NowWebSdk", "flow ended")
        }
      }).getOrThrow()
    }

    NowWebViewServiceDelegate - navigationFailed(error : String)

    Callback that notifies the host application that navigation has failed with the specified error reason.

    Table 3. Parameters
    Name Type Description
    error String Error that describes why the navigation failed.
    Table 4. Returns
    Type Description
    None

    The following code example shows how to call this function.

    suspend fun getNowWebService(): NowWebService {
      return NowWebSDK.makeWebService(URL("https://instance-name.service-now.com"), object : NowWebViewServiceDelegate {
        override fun navigationFailed(activity: Activity, error: String) {
          Log.i("NebWebSdk", "navigation failed")
        }
      }).getOrThrow()
    }

    NowWebViewServiceDelegate - requestedDismissal()

    Callback that notifies the host application that the screen should be dismissed.

    Table 5. Parameters
    Name Type Description
    None
    Table 6. Returns
    Type Description
    None

    The following code example shows how to call this function.

    suspend fun getNowWebService(): NowWebService {
      return NowWebSDK.makeWebService(URL("https://instance-name.service-now.com"), object : NowWebViewServiceDelegate {
        override fun requestedDismissal(activity: Activity) {
          Log.i("NebWebSdk", "screen should be dismissed")
        }
      }).getOrThrow()
    }

    NowWebViewServiceDelegate - unsupportedUrl(uri: Uri)

    Callback that notifies the host application that the provided URL is unsupported.

    Table 7. Parameters
    Name Type Description
    uri Uri URL that is unsupported.
    Table 8. Returns
    Type Description
    None

    The following code example shows how to call this function.

    suspend fun getNowWebService(): NowWebService {
      return NowWebSDK.makeWebService(URL("https://instance-name.service-now.com"), object : NowWebViewServiceDelegate {
        override fun unsupportedUrl(activity: Activity, uri: Uri) {
          Log.i("NebWebSdk", "URL is unsupported")
        }
      }).getOrThrow()
    }