NowCoreService class- iOS

The NowCoreService class provides fundamental services to the various SDK feature services. This class should only be instantiated by NowSDK.

Feature services, such as Now Analytics and NowChat, can access a shared core instance through the NowSDK.core property.

Parent Topic:Mobile SDK - iOS

NowCoreService - accessTokenDidFail(for service: NowService)

Notifies the SDK core that the access token used to authorize the API requests to the ServiceNow instance for the specified service is no longer valid.

The SDK core returns a valid access token if it is able to generate one or returns an error.

Note: This method has been deprecated. You should use the async/await implementation of the method instead.

NowSDK.core()?.accessTokenDidFail(for: someService)
  .mapError { YourCustomError.accessTokenFailed($0) }

.flatMap(self.handleFailedAccessToken())
  .eraseToAnyPublisher()

NowCoreService - accessTokenDidFail(for service: NowService) async throws

Notifies the SDK core that the access token used to authorize the API requests to the ServiceNow instance for the specified service is no longer valid.

The SDK core returns a valid access token if it is able to generate one or returns an error.

The following code examples shows how to call this method.

do {
    let accessToken = try await NowSDK.core()?.accessTokenDidFail(for: someService)
} catch {
    self.handleFailedAccessToken(error)
}

NowCoreService - canRequestPermission(_ permission: DevicePermission)

Queries the host application as to whether the service is allowed to request the device permission.

This function does not request the permission, only whether it is allowed to query the device permission. Feature services should call this function to determine if they are allowed to request a desired device permission.

extension AppDelegate: DevicePermissionDelegate {
  func canRequestPermission(_ permission: DevicePermission) -> Bool {
    return true
  }
}

NowCoreService - isGuestUser(for service: NowService) async

Checks whether the current user is a guest user.

The following code example shows how to call this method.

let isGuestUser = await NowSDK.core()?.isGuestUser(for: someService)

NowCoreService - refreshAllSettings()

Refreshes all SDK settings for all services by re-fetching them from the active servers.

To receive updated SDK settings values whenever they're refreshed, subscribe to the publisher provided by the NowCoreService - settingsPublisher(for service: NowService) function.

NowSDK.core()?.refreshAllSettings()

NowCoreService - refreshSettings(for service: NowService)

Refreshes the SDK settings for the specified service by re-fetching them from the server.

Note: This method has been deprecated. You should use the async/await implementation of the method instead.

var subscriptions = Set<AnyCancellable>()
NowSDK.core?.refreshSettings(for: someService)
  .sink(receiveCompletion: { completion in
    if case .failure(let error) = completion {
      print("Refresh failed with error:\ (error)")
    }
  }, receiveValue: { settings in
    print("Received refreshed settings:\ (settings)")
  })
  .store(in: &subscriptions)

NowCoreService - refreshSettings(for service: NowService) async throws

Refreshes the SDK settings for the specified service by re-fetching them from the server.

The following code examples shows how to call this method.

do {
    let settings = try await NowSDK.core()?.refreshSettings(for: someService)
    print("Received refreshed settings: \(settings)")
} catch {
    print("Refresh failed with Settings error: \(error)")
}

NowCoreService - requestAccessToken(for service: NowService)

Acquires an access token for the specified service.

Note: This method has been deprecated. You should use the async/await implementation of the method instead.

NowSDK.core()?.requestAccessToken(for: someService)

NowCoreService - requestAccessToken(for service: NowService) async throws

Acquires an access token for the specified service.

The following code examples shows how to call this method.

do {
    let accessToken = try await NowSDK.core()?.requestAccessToken(for: someService)
} catch {
    self.handleFailedAccessToken(error)
}

NowCoreService - requestNetworkService(for service: NowService)

Returns a reference to a shared network service that you can use to make API requests.

Note: This is a shared service. Altering settings or ending the session can cause issues for other feature services that share this session.

The following code example shows how to call this function.

NowSDK.core()?.settingsPublisher(for: chatService)
.sink(receiveCompletion: { completion in
  if case .failure(let error) = completion {
    // Setting publisher failed with error
  }
}, receiveValue: { updatedSettings in
  // Receive array of SDK settings for chatService
})
.store(in: &subscriptions)

NowCoreService - requestSettings(forservice: NowService)

Returns the SDK settings for the specified feature service.

Note: This method has been deprecated. You should use the async/await implementation of the method instead.

NowSDK.core()?.requestSettings(for: someService)

NowCoreService - requestSettings(for service: NowService) async throws

Returns the SDK settings for the specified feature service.

The following code examples shows how to call this method.

do {
    let settings = try await NowSDK.core()?.requestSettings(for: someService)
    print("Received settings: \(settings)")
} catch {
    print("Refresh saved with Settings error: \(error)")
}

NowCoreService - settingsPublisher(for service: NowService)

Retrieves the settings for the publisher of the specified service.

The following code example shows how to call this function.

NowSDK.core()?.settingsPublisher(for: chatService)
.sink(receiveCompletion: { completion in
  if case .failure(let error) = completion {
    // Setting publisher failed with error
  }
}, receiveValue: { updatedSettings in
  // Receive array of SDK settings for chatService
})
.store(in: &subscriptions)