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

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

Avant de commencer

Rôle requis : administrateur

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 aux suivants 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 SDK.
   
   
   
   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 lot 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 Kit de développement logiciel (SDK ), entrez les propriétés de configuration JSON pour tous les services d’entités que votre application exploitera, définissez 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 à cocher 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 du SDK est utilisée en conjonction avec la configuration d’instance ServiceNow .

      Par exemple, si messagerie instantanée : 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 la messagerie instantanée : 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 tire parti d’Analyse de l’expérience utilisateur, inscrivez-la 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 pour l’analyse.
      Un écran semblable 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. Entrez les informations suivantes dans les champs spécifiés :
      • Espace de noms : sn_mobile_sdk
      • Nom de l’API : Kit de développement logiciel (SDK) mobile
      • Version de l’API : dernière
   3. Sélectionnez Obtenir les paramètres pour 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 
        } 
      }