Cadre de travail NowSDK : iOS

Le cadre de travail NowSDK contient des méthodes qui permettent l’instanciation de divers services d’entités.

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

Configure le Kit de développement logiciel (SDK) Now en vue de son utilisation. Vous devez appeler cette fonction avant d’appeler l’un des services d’entités dans le Mobile SDKfichier .

Remarque :

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

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 Kit de développement logiciel (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 : configurer (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 de commodité que les services de fonctionnalité peuvent utiliser pour construire n objet NowServiceConfiguration.

Tableau 5. Paramètres

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

Tableau 6. Renvoie

Type	Description
Configuration Now ServiceConfiguration	Si l’URL spécifiée réussit les vérifications de validité de base et que la configuration de service peut être correctement construite, renvoie l’objet NowServiceConfiguration ; sinon néant.

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 
  }