Installez et configurez l’application incluse dans le Mobile SDK périmètre

  • Rversion finale: Australia
  • Mis à jour 12 mars 2026
  • 3 minutes de lecture

    • 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 page sur le Mobile SDKServiceNow 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 au suivant doit s’afficher :

        Vérifier le module d’extension Mobile SDK
      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.

      Formulaire Paramètres du SDK mobile
      1. Dans le champ Nom , saisissez le nom de l’application qui exploitera le Mobile SDK fichier .
      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éfini 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 Advanced (Avancé ) n’est pas cochée. Cela vous permet d’entrer JSON dans le champ Paramètres du SDK .


        Paramètres SDK

        Toute configuration applicable ajoutée dans les paramètres du 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 chat : enabled = false, 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 Aperçus d'utilisation, enregistrez votre application auprès de l’application Aperçus d'utilisation .
      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 au suivant s’affiche :

        Enregistrer l’analyse
      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 champs suivants dans les champs spécifiés :
        • 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 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 :

        Paramètres du SDK Verigy

        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 
  } 
}