NowSDK-Architektur

Das NowSDK ist die oberste Entität des Mobile SDK -Klassen-Frameworks.

Sie enthält zahlreiche Klassen, Schnittstellen und Funktionen, mit denen Sie die wichtigen Fähigkeiten von Mobile SDK und Ihrer ServiceNow -Instanz nutzen können. Dieses Dokument konzentriert sich auf die Beschreibung der primären Funktionsservices, die in Mobile SDK [] verfügbar gemacht werden und die Interaktion mit Ihrer Instanz von ServiceNow ermöglichen .

Um einen der von Mobile SDKbereitgestellten Funktionsservices zu verwenden, müssen Sie die NowSDK-Bibliothek in Ihren Code integrieren. Sie müssen die Kernbibliothek aufrufen, um das SDK zu konfigurieren und zu initialisieren, bevor Sie eine SDK-Funktionalität verwenden können.

NowSDK bietet die folgenden Funktionen:

• SDK-Initialisierung und -Einstellungen – Abrufen und Konfiguration.
• Unterbrechungsfreie Autorisierung und Verarbeitung von Benutzersitzungen.
• Protokollierungsschnittstelle. Das NowSDK stellt Protokollierungsservices für alle Funktionsservices bereit. Standardmäßig werden Protokollnachrichten mit plattformspezifischen Funktionen in Systemprotokolle geschrieben. Sie können den Protokollierungsschwellenwert über einen Parameter steuern, der Teil des Aufrufs zum Konfigurieren des SDK ist. Es gibt auch eine Option zum Unterdrücken aller vom SDK und seinen Funktionsservices generierten Protokollnachrichten (Protokollebene = keine). Wenn Sie bereits eine eigene Protokollierungslösung haben, können Sie sie mit Mobile SDK verwenden.
• Infrastruktur erstellen und veröffentlichen

NowSDK bietet die folgenden Funktionsservices und zugehörigen APIs:

• NowDataSDK

  Ermöglicht Anwendungen von Drittparteien den Zugriff auf die öffentlichen REST APIs, die von Ihrer ServiceNow -Instanz verfügbar gemacht werden. Die Entwicklung wird optimiert, da NowDataSDK die vom NowSDK bereitgestellten Authentifizierungs- und Sitzungsverarbeitungsfunktionen verwendet.

  • Primäre APIs:
    • NowAPIService: Diese API bietet Funktionen, mit denen Sie mit dem öffentlich verfügbar gemachten REST APIs in Ihrer Instanz ServiceNow ] interagieren können.
    • NowAttachmentService: Diese API bietet Funktionen zum Hochladen und Abfragen von Dateianhängen in Ihrer Instanz ServiceNow in Ihrer Anwendung Android.
    • NowGraphQLService: Diese API bietet Funktionen, mit denen Sie GraphQL-Abfragen verwenden können, um Daten aus Tabellen in Ihrer ServiceNow -Instanz mithilfe der ServiceNow REST GraphQL-API abzurufen.
    • NowTableService: Diese API bietet Funktionen, mit denen Sie CRUD-Vorgänge (Create, Read, Update, Delete) für vorhandene Tabellen in Ihrer Instanz von ServiceNow ausführen können, die über die REST- Tabellen-APIvon ServiceNow bedient werden.
• NowAnalytics

  Ermöglicht das Sammeln und Nachverfolgen von Nutzungsanalysen in Ihren Mobile-Anwendungen.

  • Primäre APIs:
    • NowAnalytics: Diese API bietet Funktionen zum Sammeln von Benutzeranalysedaten und zum Speichern dieser Daten auf der ServiceNow -Plattform zur späteren Analyse und Nachverfolgung.
• NowChat

  Ermöglicht das Einbetten eines nativen Virtual Agent -Chatfensters in Ihre Anwendungen. Dieser Service umfasst UI/UX-Funktionen.

  • Primäre APIs:
    • NowChatService: Diese API bietet Virtual Agent - und Service Desk-Mitarbeiter -Chatfunktionen für Ihre Android-Anwendungen. Nutzen Sie die vollständigen Service-Chat-Fähigkeiten der Plattform ServiceNow, indem Sie NowChatService einfach in Ihre Anwendung implementieren.
• NowPush

  Ermöglicht das Senden unaufgeforderter Nachrichten an Ihre Anwendungen, die die NowChat/Virtual Agent - Funktionalität nutzen.

  • Primäre APIs:
    • NowPushSDK: Diese API bietet die erforderliche Funktion zum Erstellen eines NowPushService, der das Senden von nicht angeforderten (Push-)Benachrichtigungen an Android -Geräte ermöglicht.
    • NowPushService: Diese API bietet Funktionen, die die Interaktion mit dem Push-Service ermöglichen.
• Now Web

  Ermöglicht das Laden von Webseiten, die in Ihrer Instanz ServiceNow gehostet werden, in einer nativen Webansicht oder in Cabrillo. Die Benutzerauthentifizierung und Sitzungsverwaltung wird automatisch verarbeitet, anstatt Benutzer zu zwingen, sich über eine Anmeldewebseite bei der Instanz anzumelden.

  Wenn die Webansicht angefordert wird, eine Webseite zu laden, die auf einer ServiceNow -Instanz gehostet wird, wird eine HTTP-Anforderung mit dem entsprechenden Bearer-Header erstellt, der das vom NowSDK bereitgestellte OAuth-Zugriffstoken enthält. Wenn die Instanz diese Anforderung erhält, startet sie eine neue Benutzersitzung und gibt Cookies zurück, die sich auf diese Sitzung beziehen. Während der Benutzer mit den Webseiten in der Webansicht interagiert, verwendet die Instanz die Cookies, um zu überprüfen, ob die Sitzung noch gültig ist. Zu diesem Zeitpunkt ist der Bearer-Header nicht mehr relevant, nur die Cookies werden für die Sitzungsvalidierung verwendet. Die Websitzung läuft ab, wenn der Benutzer länger als die Zeitüberschreitungsperiode nicht mehr mit der Website interagiert. Wenn der Benutzer nach Ablauf der Sitzung versucht, mit der Webseite zu interagieren, wird er automatisch zur Anmeldeseite weitergeleitet. NowWebViewController erkennt die Umleitung und versucht, eine neue Websitzung zu starten, indem ein aktualisiertes Zugriffstoken vom NowSDK angefordert und mit dem Token eine HTTP-Anforderung (mit Bearer-Header) für die letzte bekannte geladene Seite erstellt wird.

  • Primäre APIs:

    NowWebSDK: Diese API bietet Funktionen zum Erstellen eines NowWeb-Serviceobjekts, mit dem Webseiten aus Ihrer ServiceNow -Instanz in Ihrer Android-Anwendung angezeigt werden können.