Installieren und konfigurieren Sie die bereichsbezogene Anwendung Mobile SDK.

Bevor Sie eine Anwendung schreiben, die Mobile SDKverwendet, müssen Sie die bereichsbezogene Anwendung Mobile SDK installieren und konfigurieren.

Vorbereitungen

Erforderliche Rolle: admin

Prozedur

1. Navigieren Sie zur Seite Mobile SDK auf der Website ServiceNow Store.
   Details finden Sie unter Install a ServiceNow Store application.
2. Wählen Sie Installation anfordern aus, um die bereichsbezogene Anwendung ServiceNow auf Ihre Instanz Mobile SDK herunterzuladen.
3. Vergewissern Sie sich, dass die bereichsbezogene Anwendung Mobile SDK ordnungsgemäß in Ihrer Instanz ServiceNow installiert wurde.
   1. Öffnen Sie das Plugin-Formular: Systemdefinition > Plugins.
   2. Geben Sie im Suchfeld mobile_sdkein.
      Ein Bildschirm ähnlich dem folgenden sollte angezeigt werden:

      
      
      
   3. Vergewissern Sie sich, dass die Plugin -ID sn_mobile_sdkund die Version die neueste ist.
4. Öffnen Sie die Tabelle Mobile SDK Einstellungen [sn_mobile_sdk], und erstellen Sie einen neuen Anwendungsdatensatz für die Anwendung, die Mobile SDKnutzen wird.
   
   
   
   1. Geben Sie im Feld Name den Namen Ihrer Anwendung ein, die Mobile SDKnutzen wird.
   2. Geben Sie in den Feldern Android-Anwendungs-ID und Apple-Bundle-ID die ID Ihrer Mobile-Anwendung ein.
      Wenn beispielsweise Mobile SDK zu Ihren Mobile-Anwendungen hinzugefügt wurde, wären diese IDs die IDs der Mobile-Anwendungen.
   3. Geben Sie im Feld SDK-Einstellungen JSON-Konfigurationseigenschaften für alle Funktionsservices ein, die Ihre Anwendung nutzen wird, und legen Sie diese auf truefest.
      Beispiel:

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

      Vergewissern Sie sich, dass das Kontrollkästchen Erweitert deaktiviert ist. Dadurch können Sie JSON in das Feld SDK-Einstellungen eingeben.

      
      
      

      Jede zutreffende Konfiguration, die in den SDK-Einstellungen hinzugefügt wird, wird in Verbindung mit der Instanzkonfiguration ServiceNow verwendet.

      Beispiel: Wenn chat: aktiviert = trueist, muss in Ihrer ServiceNow -Instanz das Plugin Virtual Agent installiert sein, um die Chat-Funktionalität nutzen zu können. Wenn das Plugin Virtual Agent installiert ist, die SDK-Einstellungen jedoch chat: aktiviert = falseenthalten, kann Ihre Anwendung die Chat-Schnittstelle nicht nutzen.

   4. Wählen Sie Absenden aus, um Ihre Anwendungseinstellungen zu speichern.
5. Optional. Wenn Sie möchten, dass Ihre Anwendung User Experience Analytics nutzt, registrieren Sie Ihre Anwendung bei der Anwendung User Experience Analytics.
   1. Öffnen Sie den Einstellungsdatensatz Mobile SDK Ihrer Anwendung erneut.
   2. Wählen Sie links unten auf dem Bildschirm Für Analytics registrieren aus.
      Ein Bildschirm ähnlich dem folgenden wird angezeigt:

      
      
      
   3. Wählen Sie Aktualisieren aus, um die Registrierung zu speichern.
6. Überprüfen Sie Ihre SDK-Einstellungen.
   1. Navigieren Sie zum REST-API-Explorer.
   2. Geben Sie Folgendes in die angegebenen Felder ein:
      • Namespace: sn_mobile_sdk
      • API-Name: Mobile SDK
      • API-Version: aktuell
   3. Wählen Sie Einstellungen für Android-App abrufen (GET) aus.
   4. Geben Sie im Feld applicationID die Anwendungs-ID von Android ein, die Sie im zugehörigen Einstellungsdatensatz von Mobile SDK eingegeben haben, und wählen Sie dann Sendenaus.
      Die Antwort sollte in etwa wie folgt aussehen:

      
      
      

      Der JSON- Antworttext sollte in etwa wie folgt aussehen:

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