モバイルディープリンクの構造

  • リリースバージョン: Xanadu
  • 更新日 2024年08月01日
  • 所要時間：5分

    • モバイルアプリ内のあらゆる画面タイプでモバイルディープリンクを構築して使用する方法をよく理解してください。

    モバイルディープリンクは、基本的に 3 つのコンポーネントで構成されています。変数の名前、モバイルアプリへの参照、およびモバイルディープリンクをプルするために使用されるパブリックメソッドです。次のモバイルディープリンクには deepLinkGen という名前の変数があり、指定された画面が モバイルエージェントで開きます。

    var deepLinkGen= new global.MobileDeepLinkGenerator('Agent');
 return deepLinkGen.getScreenLink('73f3d135532033002d96ddeeff7b1212');
    変数名
    モバイルディープリンクには任意の変数名を付けることができますが、将来の参照のために識別可能にする必要があります。
    モバイルアプリの呼び出し
    モバイルディープリンクが指すモバイルアプリの 1 つを入力します。Now Mobile アプリの場合は「要求」、モバイルエージェント アプリの場合は「エージェント」のいずれかを入力できます。たとえば、Now Mobile アプリを指すモバイルディープリンクジェネレーターを使用してリンクを生成するには、次のコードを使用します。 new global。MobileDeepLinkGenerator('request');
    パブリックメソッド
    モバイルディープリンクの作成に使用できるパブリックメソッドのいずれかを使用します。各メソッドの説明とそれを使用する理由については、次の表を参照してください。
    手法 使用する理由 メソッドのパラメーター
    getButtonLink(buttonId, tableName, recordSysId) getButtonLink は、任意の入力フォーム画面にリンクするために使用されます。 buttonId (必須):入力フォーム画面を起動するボタンのsys_id

    tableName (オプション):現在のコンテキストのテーブルの名前

    recordSysId (オプション):現在のコンテキストレコードのsys_id
    getFormScreenLink(formScreenId, tableName, recordSysId) getFormScreenLink は、パラメーター化されていない任意のフォーム画面にリンクするのに使用されます。 formScreenId (必須):必要なフォーム画面のsys_id

    tableName (必須):必要なフォーム画面のテーブル名

    recordSysId (必須):レコードのsys_id元 tableName
    getLauncherScreenLink(launcherScreenId) getLauncherScreenLink は、任意のランチャー画面にリンクするために使用されます。 launcherScreenId (必須):必要なランチャー画面のsys_id。
    getPrefillLink(forceLocalLogin) getPrefillLink は、ServiceNow モバイルの初めてのユーザーに役立ちます。このリンク形式には、モバイルアプリにまだインスタンスを追加していないユーザーのインスタンスリンクが事前入力されます。このメソッドは、デフォルトの認証エクスペリエンスです。

    このメソッドは、特定の画面へのリンクを生成しません。

    		 forceLocalLogin (必須):

    true を入力すると、ユーザーのインスタンスへのログインの詳細が事前入力されます。

    ユーザーがログインの詳細を手動で入力する場合は、false を入力します。
    getScreenLink(documentId, uiParams) getScreenLink は、パラメーター化されたタイプとパラメーター化されていないタイプの両方を含む、任意のリスト画面にリンクするために使用されます。パラメーター化されていない画面タイプにも使用できます。オプションの UI パラメーターをこのメソッドに渡すことができます。 documentId (必須):目的の画面sys_id

    uiParams (オプション):データ項目のパラメーター
    getSSOPrefillLink(sys_id) getSSOPrefillLink は、sys_id パラメーターで識別される ID プロバイダー (IdP) を使用するリンクを生成します。このリンクは、異なる IdP を使用するエンドユーザーを認証するのに使用できます。たとえば、雇用前は Microsoft Azure を IdP として使用し、就業後の従業員は Okta を IdP として使用する場合があります。これらの SSO (Single Sign-on) の事前入力されたリンクの一般的な使用法は、従業員に送信するメールにこの情報を埋め込むことです。これらのメールには、モバイルアプリを使用して ServiceNow インスタンスに安全にログインするために使用できるリンクが含まれています。
    重要:
    このメソッドを使用するには、Multi-Provider SSO プラグインをアクティブ化し、アクティブな IdP を保有している必要があります。詳細については、「マルチプロバイダー SSO プラグインのアクティブ化」を参照してください
    		 sys_id (必須):使用する IdP の sys_id を ID プロバイダー [sso_properties] テーブルから入力します。
    IdP の sys_id を取得するには：
    1. 移動先 すべて > 複数プロバイダー SSO > ID プロバイダー.
    2. ID プロバイダーのレコードを右クリックし、[sys_id のコピー] を選択します。
    getUniversalLink(url) getUniversalLink は、リスト、フォーム、またはブラウザーへのリンクを生成します。この URL のコンテンツに基づいて画面が生成されます。「モバイル向けユニバーサルリンキング」を参照してください。 url (必須):インスタンス上のリソースへのリンク