Aufbau von Mobile-Deep-Links
Machen Sie sich mit der Erstellung und Verwendung von mobilen Deeplinks in jedem Bildschirmtyp in einer mobilen App vertraut.
Mobile-Deep-Links bestehen im Wesentlichen aus drei Komponenten: der Name der Variablen, ein Verweis auf eine Mobile-App und die öffentliche Methode zum Abrufen des Mobile-Deep-Links. Der folgende Mobile-Deep-Link hat eine Variable mit dem Namen deepLinkGen, mit der ein bestimmter Bildschirm in Mobile Agent geöffnet wird.
var deepLinkGen= new global.MobileDeepLinkGenerator('Agent');
return deepLinkGen.getScreenLink('73f3d135532033002d96ddeeff7b1212');- Variablenname
- Sie können für den Mobile-Deep-Link jeden beliebigen Variablennamen angeben, im Hinblick auf die zukünftige Verwendung empfiehlt sich jedoch ein aussagekräftiger Name.
- Aufruf einer Mobile-App
- Geben Sie eine der mobilen Apps ein, auf die der mobile Deeplink verweist. Sie können entweder
Anforderungfür die App Now Mobile oderAgentfür die App Mobile Agent eingeben. Um beispielsweise mit dem mobilen Deeplink-Generator einen Link zu generieren, der auf die App Now Mobile verweist, verwenden Sie den folgenden Code:new global.MobileDeepLinkGenerator('Request'); - Öffentliche Methode
- Es gibt verschiedene öffentliche Methoden zum Erstellen eines Mobile-Deep-Links. In der Tabelle finden Sie zu jeder Methode eine Erklärung und den Grund für ihre Verwendung.
Methode Grund für die Verwendung Parameter der Methode getButtonLink(buttonId, tableName, recordSysId)getButtonLink wird verwendet, um eine Verknüpfung mit einem beliebigen Eingabeformularbildschirm herzustellen. buttonId (erforderlich): sys_id der Schaltfläche, über die Sie den Eingabeformular-Bildschirm starten möchten tableName (optional): Name der Tabelle für den aktuellen Kontext
recordSysId (optional): sys_id des aktuellen Kontextdatensatzes
getFormScreenLink (formScreenId, tableName, recordSysId)getFormScreenLink dient dazu, eine Verknüpfung zu einem beliebigen nichtparametrisierten Formularbildschirm herzustellen. formScreenId (erforderlich): sys_id des erforderlichen Formularbildschirms tableName (erforderlich): Tabellenname des erforderlichen Formularbildschirms
recordSysId (erforderlich): sys_id des Datensatzes von tableName
abrufenLauncherScreenLink(launcherScreenId)getLauncherScreenLink wird verwendet, um eine Verknüpfung mit einem beliebigen Startprogramm-Bildschirm herzustellen. launcherScreenId (erforderlich): sys_id des erforderlichen Startprogramm-Bildschirms. getPrefillLink(forceLocalLogin)getPrefillLink ist nützlich für Erstbenutzer von ServiceNow Mobile. Dieses Linkformat trägt den Instanzlink für Benutzer vorab ein, die ihrer Mobile-App noch keine Instanz hinzugefügt haben. Diese Methode ist die Standardauthentifizierung. Diese Methode generiert keinen Link zu einem bestimmten Bildschirm.
forceLocalLogin (erforderlich): Geben Sie true ein, wenn das System die Anmeldeinformationen der Instanz des Benutzers vorab eintragen soll.
Geben Sie false ein, wenn der Benutzer die Anmeldeinformationen manuell eingeben soll.
getScreenLink(documentId, uiParams)getScreenLink wird verwendet, um eine Verknüpfung zu allen Listenbildschirmen herzustellen, inklusive aller parametrisierten und nichtparametrisierten Typen. Die Methode kann jedoch auch für alle nichtparametrisierten Bildschirmtypen verwendet werden. An diese Methode kann ein optionaler UI-Parameter übergeben werden. documentId (erforderlich): sys_id des gewünschten Bildschirms uiParams (optional): Parameter eines Datenelements
getSSOPrefillLink(sys_id)getSSOPrefillLink generiert einen Link, der den Identitätsanbieter (IdP) verwendet, der durch den Parameter sys_ididentifiziert wird. Dieser Link kann zur Authentifizierung von Endbenutzern verwendet werden, die verschiedene IdPs verwenden. Beispielsweise können Beschäftigte in der Probezeit Microsoft Azure als IdP verwenden und Festangestellte Okta als IdP nutzen. Eine häufige Verwendung dieser vorgefüllten SSO-Links (Single Sign-on) ist die Einbettung in E-Mails, die an Mitarbeiter gesendet werden. Diese E-Mails enthalten einen Link, mit dem Sie sich mit ihren Mobile-Apps sicher bei einer Instanz von ServiceNow anmelden können.Wichtig:Um diese Methode zu verwenden, müssen Sie das Plugin „Multi-Provider SSO“ aktivieren und über einen aktiven IdP verfügen. Weitere Informationen finden Sie unter Plugin für Mehrfachanbieter-SSO aktivierensys_id (erforderlich): Geben Sie die sys_id des zu verwendenden IdP aus der Tabelle „Identitätsanbieter“ [sso_properties] ein. So rufen Sie die sys_id des IdP ab:- Navigieren zu .
- Klicken Sie mit der rechten Maustaste auf den Datensatz eines Identitätsanbieters und wählen Sie sys_id kopieren.
getUniversalLink(url)getUniversalLink generiert einen Link zu einer Liste, einem Formular oder einem Browser. Anhand des Inhalts dieser URL wird ein Bildschirm generiert. Weitere Informationen finden Sie unter Universelle Links für Mobile. url (erforderlich): Ein Link zu einer Ressource in einer Instanz