NowSDK-Architektur

Das NowSDK ist die Entität der obersten Ebene des Klassen-Frameworks Mobile SDK.

Sie enthält zahlreiche Klassen, Schnittstellen und Funktionen, mit denen Sie die bedeutenden Fähigkeiten nutzen können, die von der Instanz Mobile SDK und Ihrer Instanz von ServiceNow ] bereitgestellt werden. Dieses Dokument konzentriert sich auf die Beschreibung der primären Funktionsservices, die in Mobile SDK [] verfügbar gemacht werden und Ihnen die Interaktion mit Ihrer Instanz 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 SDK-Funktionen verwenden können.

NowSDK bietet die folgenden Funktionen:

• SDK-Initialisierung und das Abrufen und Konfigurieren von Einstellungen.
• Nahtlose Autorisierung und Verarbeitung von Anwendersitzungen.
• Protokollierungsschnittstelle. Das NowSDK stellt Protokollierungsservices für alle Funktionsservices bereit. Standardmäßig werden Protokollnachrichten mithilfe plattformspezifischer Funktionen in Systemprotokolle geschrieben. Sie können den Protokollierungsschwellenwert über einen Parameter steuern, der Teil des Aufrufs zur Konfiguration des SDK ist. Es gibt auch eine Option zum Unterdrücken aller vom SDK und seinen Funktionsservices generierten Protokollnachrichten (Protokollebene = Keine). Wenn Sie bereits über eine eigene Protokollierungslösung verfügen, können Sie sie mit Mobile SDK verwenden.
• Erstellen Sie eine Infrastruktur, und geben Sie sie frei.

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 Instanz ServiceNow verfügbar gemacht werden. Die Entwicklung wird optimiert, da das NowDataSDK die vom NowSDK bereitgestellten Authentifizierungs- und Sitzungsverarbeitungsfunktionen verwendet.

  • Primäre APIs:
    • NowAPIService: Diese API bietet Funktionen, die Ihnen die Interaktion mit dem öffentlich verfügbar gemachten REST APIs in Ihrer Instanz von ServiceNow ermöglichen.
    • NowAttachmentService: Diese API bietet Funktionen zum Hochladen und Abfragen von Dateianhängen in Ihrer Instanz ServiceNow innerhalb Ihrer Anwendung Android.
    • NowGraphQLService: Diese API bietet Funktionen, mit denen Sie GraphQL-Abfragen verwenden können, um Daten aus Tabellen in Ihrer Instanz ServiceNow 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 der Instanz ServiceNow ausführen können, die über die REST- Tabellen-APIServiceNow betreut werden.
• NowAnalytics

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

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

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

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

  Ermöglicht Ihnen das Senden nicht angeforderter Nachrichten an Ihre Anwendungen, die die NowChat/-FunktionVirtual Agent 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.
• NowWeb

  Ermöglicht Ihnen das Laden von Webseiten, die auf Ihrer Instanz ServiceNow gehostet werden, in einer nativen Webansicht oder in CABRILLO. Die Anwenderauthentifizierung und das Management von Anwendersitzungen werden automatisch durchgeführt, anstatt dass sich Anwender über eine Anmeldewebseite bei der Instanz anmelden müssen.

  Wenn die Webansicht zum Laden einer Webseite aufgefordert wird, die auf einer Instanz ServiceNow gehostet wird, erstellt sie eine HTTP-Anforderung mit dem entsprechenden Bearer-Header, der das von 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. Wenn der Benutzer mit den Webseiten in der Webansicht interagiert, verwendet die Instanz 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überschreitungsdauer an 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. Der NowWebViewController erkennt die Umleitung und versucht, eine neue Websitzung zu starten, indem er ein aktualisiertes Zugriffstoken vom NowSDK anfordert und mit dem Token eine HTTP-Anforderung (mit Bearer-Header) für die letzte bekannte geladene Seite erstellt.

  • Primäre APIs:

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