Installieren und konfigurieren Sie die bereichsbezogene Anwendung Mobile SDK .

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer
  • Bevor Sie eine Anwendung schreiben, die Mobile SDKnutzt, müssen Sie die bereichsbezogene Anwendung Mobile SDK installieren und konfigurieren.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    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 Mobile SDK auf Ihre Instanz ServiceNow herunterzuladen.
    3. Vergewissern Sie sich, dass die bereichsbezogene Anwendung Mobile SDK ordnungsgemäß in der Instanz ServiceNow installiert wurde.
      1. Öffnen Sie das Formular des Plugins: Systemdefinition > Plugins.
      2. Geben Sie im Suchfeld mobile_sdkein.
        Es sollte ein Bildschirm wie der folgende erscheinen:

        Verify Mobile SDK-Plugin
      3. Vergewissern Sie sich, dass das Plugin die IDsn_mobile_sdk hat und die Version aktuell ist.
    4. Öffnen Sie die Tabelle Mobile SDK Einstellungen [sn_mobile_sdk], und erstellen Sie einen neuen Anwendungsdatensatz für die Anwendung, die Mobile SDKnutzt.

      Formular „Mobile SDK-Einstellungen“.
      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 mobilen Anwendung ein.
        Wenn Ihren mobilen Anwendungen beispielsweise Mobile SDK hinzugefügt wurde, sind diese IDs die IDs der mobilen Anwendungen.
      3. Geben Sie im Feld SDK-Einstellungen JSON-Konfigurationseigenschaften für alle Funktionsservices ein, die Ihre Anwendung nutzen wird, und legen Sie den Wert auf truefest.
        Zum 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
            }
        }

        Stellen Sie sicher, dass das Kontrollkästchen Erweitert deaktiviert ist. Dies ermöglicht Ihnen die Eingabe von JSON im Feld „SDK-Einstellungen“.


        SDK-Einstellungen

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

        Beispiel: Wenn chat: aktiviert = true, muss in Ihrer Instanz ServiceNow das Plugin Virtual Agent installiert sein, um die -Chatfunktion 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 Ihre Anwendung User Experience Analytics nutzen soll, registrieren Sie Ihre Anwendung bei der Anwendung User Experience Analytics.
      1. Öffnen Sie den Einstellungsdatensatz Mobile SDK Ihrer Anwendung erneut.
      2. Wählen Sie unten links im Bildschirm Für Analytics registrierenaus.
        Ein Bildschirm, der dem folgenden ähnelt, wird angezeigt:

        Analytics registrieren
      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 in die angegebenen Felder Folgendes 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 Android Anwendungs-ID ein, die Sie im zugehörigen Einstellungsdatensatz Mobile SDK eingegeben haben, und wählen Sie Sendenaus.
        Die Antwort sollte wie folgt aussehen:

        Verigy SDK-Einstellungen

        Der JSON -Antworttext sollte 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 
          } 
        }