モバイルディープリンクの構造
モバイルアプリ内の任意の画面タイプでモバイルディープリンクを作成して使用する方法をよく理解してください。
モバイルディープリンクは、基本的に3つのコンポーネントで構成されています。変数の名前、モバイルアプリへの参照、およびモバイルディープリンクをプルするために使用されるパブリックメソッド。次のモバイルディープリンクには、 deepLinkGen という名前の変数があり、指定された画面が モバイルエージェントで開きます。
var deepLinkGen= new global.MobileDeepLinkGenerator('Agent');
return deepLinkGen.getScreenLink('73f3d135532033002d96ddeeff7b1212');- 変数名
- モバイルディープリンクには任意の変数名を付けることができますが、後で参照できるように識別できる必要があります。
- モバイルアプリ呼び出し
- モバイルディープリンクが指すモバイルアプリの 1 つを入力します。Now Mobile アプリの
[要求] または モバイルエージェント アプリの[エージェント] のいずれかを入力できます。たとえば、Now Mobile アプリを指すモバイルディープリンクジェネレーターを使用してリンクを生成するには、次のコードを使用します。MobileDeepLinkGenerator('request'); - パブリックメソッド
- モバイルディープリンクの作成に使用できる公開メソッドのいずれかを使用します。各メソッドの説明と使用理由については、表を参照してください。
方法 (Method) 使用理由 メソッドのパラメーター 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 (シングルサインオン) 事前入力リンクの一般的な用途は、従業員に送信されるメールに埋め込むことです。これらのメールには、モバイルアプリを使用して ServiceNow インスタンスに安全にログインするために使用できるリンクが含まれています。重要:この方法を使用するには、Multi-Provider SSO プラグインをアクティブ化し、アクティブな IdP を持っている必要があります。詳細については、「マルチプロバイダー SSO プラグインのアクティブ化」を参照してくださいsys_id (必須):使用する IdP のsys_idを ID プロバイダー [sso_properties] テーブルから入力します。 IdP のsys_idを取得するには:- 移動先 .
- ID プロバイダーのレコードを右クリックし、[sys_id のコピー] を選択します。
getUniversalLink (url)getUniversalLink は、リスト、フォーム、またはブラウザーへのリンクを生成します。この URL のコンテンツに基づいて画面が生成されます。「モバイル向けユニバーサルリンキング」を参照してください。 url (必須):インスタンス上のリソースへのリンク