Aufbau von Mobile-Deep-Links

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 2 Minuten Lesedauer

    • 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 Anforderung für die App Now Mobile oder Agent fü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_id identifiziert 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 aktivieren
    		 sys_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:
    1. Navigieren zu Alle > Mehrfachanbieter-SSO > Identity Provider.
    2. 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