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

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

Avant de commencer

Rôle requis : admin

Procédure

1. Accédez à la Mobile SDK page sur le ServiceNow Store site Web.
   Pour plus de détails, voir Install a ServiceNow Store application.
2. Sélectionnez Demander l’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 au suivant 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 enregistrement d’application pour l’application qui exploitera le Mobile SDKfichier .
   
   
   
   1. Dans le champ Nom , entrez le nom de votre application qui exploitera le Mobile SDKfichier .
   2. Dans les champs ID d’application Android et ID de bundle Apple , saisissez l’ID de votre application mobile.
      Par exemple, si le Mobile SDK a été ajouté à vos applications Mobile, ces ID seront les ID des applications Mobile.
   3. Dans le champ Paramètres SDK , entrez les propriétés de configuration JSON pour tous les services d’entités que votre application exploitera, définissez la valeur 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 de saisir JSON dans le champ Paramètres du SDK .

      
      
      

      Toute configuration applicable ajoutée dans les paramètres du Kit de développement logiciel (SDK ) est utilisée en conjonction avec la configuration de l’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 messagerie instantanée. Si le module d’extension Agent virtuel est installé, mais que les paramètres du Kit de développement logiciel (SDK ) contiennent chat : enabled = false, votre application n’est pas en mesure d’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 User Experience Analytics, inscrivez-la auprès de l’application User Experience Analytics.
   1. Rouvrez l’enregistrement Paramètres de Mobile SDK votre application.
   2. En bas à gauche de l’écran, sélectionnez S’inscrire à Analytics.
      Un écran similaire au suivant 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. Saisissez les informations suivantes dans les champs spécifiés :
      • Espace de noms : sn_mobile_sdk
      • Nom de l’API : SDK mobile
      • Version de l’API : dernière
   3. Sélectionnez Obtenir les paramètres de l’application Android (GET).
   4. Dans le champ applicationID , saisissez l’ID d’application Android 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 
        } 
      }