NowSDK framework - iOS

Le framework NowSDK contient des méthodes qui permettent l’instanciation de divers services de fonctionnalités.

NowSDK : configure(avec configuration : NowSDKConfiguration) lève

Configure NowSDK pour utilisation. Vous devez appeler cette fonction avant d’appeler l’un des services d’entités dans le Mobile SDK.

Remarque :

Si la configuration que vous transmettez n’est pas valide, un NowSDKError est renvoyé.

Tableau 1. Paramètres

Nom	Type	Description
avec configuration	NowSDKConfiguration	NowSDKConfiguration qui contient les informations nécessaires pour initialiser le service.

Tableau 2. Renvoie

Type	Description
Aucun, NowSDKError	NowSDKError est levé si la configuration que vous transmettez n’est pas valide.

L’exemple de code suivant montre comment appeler cette fonction.

guard 
  let jwtUrl = URL(string: "http://13.57.38.237:8080"),
  let instanceUrl = URL(string: "https://mobilecoresdk.service-now.com") else {
    return
  }

// AuthorizationProvider – struct conforming to NowSDKAuthorizationProviding protocol
let authorizationProvider = AuthorizationProvider(userEmail: "[e-mail]", jwtProviderUrl: jwtUrl, clientId: "deb8756b452d201039231ca568f26511")
        
// PermissionProvider – class conforming to DevicePermissionDelegate protocol
let permissionProvider = PermissionProvider()
let config = NowSDKConfiguration(authorizationProvider: authorizationProvider, permissionDelegate: permissionProvider, logLevel: .debug)

do {
  try NowSDK.configure(with: config)
            …
} catch {
   print(“error is \(error.localizedDescription)”)
}

NowSDK : core()

Renvoie une référence au service principal du SDK.

Remarque :

Les applications hôtes n’ont pas besoin d’appeler cette fonction.

Tableau 3. Paramètres

Nom	Type	Description
Aucun

Tableau 4. Renvoie

Type	Description
Objet	L’objet conforme au protocole NowCoreServiceProviding est renvoyé si le Kit de développement logiciel (SDK) a été initialisé en appelant la NowSDK : configure(avec configuration : NowSDKConfiguration) lève méthode ; sinon, nul.

L’exemple de code suivant montre comment appeler cette fonction.

guard let coreService = NowSDK.core() else {
  // Error with NowServiceError.sdkNotConfigured
  return
}

NowSDK : makeServiceConfiguration(for instanceUrl : URL)

Fonction pratique que les services de fonctionnalité peuvent utiliser pour construire un objet NowServiceConfiguration.

Tableau 5. Paramètres

Nom	Type	Description
instanceUrl	URL	URL de l’instance ServiceNow à laquelle le service accédera.

Tableau 6. Renvoie

Type	Description
NowServiceConfiguration	Si l’URL spécifiée passe les contrôles de validité de base et que la configuration du service peut être correctement construite, renvoie l’objet NowServiceConfiguration ; sinon nul.

L’exemple de code suivant montre comment appeler cette fonction.

guard 
  let instanceUrl = URL(string: "https://mobilecoresdk.service-now.com"),
  let serviceConfig = NowSDK.makeServiceConfiguration(for: instanceUrl) else {
    logger.error(message: "Could not create service - service configuration invalid")
    return 
  }