Installer et configurer l’application incluse dans le Mobile SDK périmètre

Avant d’écrire une application qui exploite le Mobile SDK, vous devez installer et configurer l’application incluse dans le Mobile SDK périmètre.

Avant de commencer

Rôle requis : admin

Procédure

1. Accédez à la Mobile SDK page du ServiceNow Store site Web.
   Pour plus de détails, voir Install a ServiceNow Store application.
2. Sélectionnez Demander une installation pour télécharger l’application incluse dans le Mobile SDK périmètre sur votre ServiceNow instance.
3. Vérifiez que l’application incluse dans le Mobile SDK périmètre a été correctement installée sur votre ServiceNow instance.
   1. Ouvrez le formulaire du module d’extension : Définition du système > Modules d’extension.
   2. Dans le champ de recherche, saisissez mobile_sdk.
      Un écran similaire à celui-ci devrait s’afficher :

      
      
      
   3. Vérifiez que l’ID du module d’extension est sn_mobile_sdk et que la version est la plus récente.
4. Ouvrez la Mobile SDK table Paramètres [sn_mobile_sdk] et créez un nouvel enregistrement d’application pour l’application qui exploitera le Mobile SDK.
   
   
   
   1. Dans le champ Nom , entrez le nom de votre application qui exploitera le Mobile SDK.
   2. Dans les champs ID de l’application Android et ID du groupe Apple , saisissez l’ID de votre application mobile.
      Par exemple, si le Mobile SDK a été ajouté à vos applications mobiles, ces ID seront les ID des applications mobiles.
   3. Dans le champ Paramètres du SDK , saisissez les propriétés de configuration JSON de tous les services de fonctionnalités que votre application exploitera, définies sur vrai.
      Par exemple :

      {
          "graphql": {
              "enabled" : true,
                      "allowGuestAccess" : true
          },
          "table": {
              "enabled" : true,
                      "allowGuestAccess" : true
          },
          "api": {
              "enabled" : true,
                      "allowGuestAccess" : true
          },
          "attachment": {
              "enabled" : true,
                      "allowGuestAccess" : true
          },
          "chat": {
              "enabled" : true,
                      "allowGuestAccess" : true
          },
          "web": {
              "enabled" : true,
                      "allowGuestAccess" : true
          },
          "push": {
              "enabled" : true
          }
      }

      Assurez-vous que la case Avancé n’est pas cochée. Cela vous permet d’entrer JSON dans le champ Paramètres du SDK .

      
      
      

      Toute configuration applicable ajoutée dans les paramètres SDK est utilisée conjointement avec la configuration d’instance ServiceNow .

      Par exemple, si chat : enabled = true, le module d’extension Agent virtuel doit être installé sur votre ServiceNow instance pour exploiter la fonctionnalité de chat. Si le module d’extension est installé, mais que les paramètres du Agent virtuelSDK contiennent la messagerie instantanée : activé = faux, votre application ne peut pas exploiter l’interface de messagerie instantanée.

   4. Sélectionnez Soumettre pour enregistrer les paramètres de votre application.
5. Facultatif. Si vous souhaitez que votre application exploite Analyse de l’expérience utilisateur, enregistrez votre application auprès de l’application Analyse de l’expérience utilisateur.
   1. Rouvrez l’enregistrement Paramètres de Mobile SDK votre application.
   2. En bas à gauche de l’écran, sélectionnez S’inscrire à l’analyse.
      Un écran similaire à celui-ci s’affiche :

      
      
      
   3. Sélectionnez Mettre à jour pour enregistrer l’inscription.
6. Vérifiez les paramètres de votre SDK.
   1. Accédez à l’explorateur d’API REST.
   2. Renseignez les champs spécifiés comme suit :
      • Espace de noms : sn_mobile_sdk
      • Nom de l’API : SDK mobile
      • Version de l’API : la plus récente
   3. Sélectionnez Obtenir les paramètres de l’application Android (GET).
   4. Dans le champ applicationID , saisissez l’ID Android d’application que vous avez saisi dans l’enregistrement Paramètres associé, Mobile SDK puis sélectionnez Envoyer.
      La réponse doit ressembler à ce qui suit :

      
      
      

      Le corps de la réponse JSON doit ressembler à ce qui suit :

      { 
        "platformVersion": "utah", 
        "enabled": true, 
        "analytics": { 
          "AnalyticsEnabled": true, 
          "AnalyticsEnabledForUnauthenticatedUser": false, 
          "EndpointUrl": "https://my-instance.servicenow.com.com", 
          "InstanceId": "db63a848db9f6091fd3467c8f4879524", 
          "ApiKey": "de742fc9db9f6090e03ad7c8f4961923:af0f36b91bc074109a9054a26032a6bf", 
          "ApiAuth": "11ab4240a6d5459c96d2bfb8e1aa3ddd", 
          "ConsentSettings": null, 
          "AppName": "TestNow App", 
          "AppType": "MobileSDK", 
          "ChannelType": "sdk", 
          "Configuration": {} 
        }, 
        "sdk": { 
          "graphql": { 
            "enabled": true 
          }, 
          "table": { 
            "enabled": true 
          }, 
          "api": { 
            "enabled": true 
          }, 
          "attachment": { 
            "enabled": true 
          }, 
          "chat": { 
            "enabled": true 
          }, 
          "web": { 
            "enabled": true 
          },
          "push": { 
            "enabled": true 
        } 
      }