移動アクションを使用して OmniScript から他のページを開く
OmniScript からさまざまな Salesforce ページ、アプリケーション、リソースを開くには、ナビゲーション要素を使用します。
-
要素パネルから、[ナビゲート] アクション要素をキャンバスにドラッグします。
- 移動アクションがステップで表示される場合、クリック可能なボタンになります。
- [移動アクション] がステップ間にある場合、自動的に起動します。
-
移動アクションがステップで表示される場合は、ボタンスタイルを選択します。
-
SLDS ボタンバリエーションを選択して、ボタンのスタイルを決定します。
SLDS ボタンのバリエーションに加えて、[リンク] を選択してナビゲーションアクションを HTML アンカータグとして表示できます。
-
ボタンに SLDS アイコンを表示します。
たとえば、standard_account アイコンを追加するには、「Standard:Account」と入力します。
-
SLDS ボタンバリエーションを選択して、ボタンのスタイルを決定します。
-
必要に応じて、[置換] プロパティを有効にして、ブラウザー履歴の既存のエントリを置換します。
[置換] プロパティが有効になっている場合、ユーザーは OmniScript に戻ることができません。
メモデフォルトでは、コンソールアプリケーションのナビゲーションアクションでは、新しいサブタブでページ参照種別が開きます。複数のナビゲーションアクションを使用する場合、最初のナビゲーションアクションのみが新しいタブにリダイレクトされます。[置換] プロパティが無効になっていても、タブは後続のナビゲーションアクションに置き換えられます。
ただし、[置換] プロパティが無効になっている場合、ページ参照によってブラウザー履歴の既存のエントリが置換されることはありません。ユーザーは同じタブで OmniScript 間を行き来できます。
移動アクションが完了すると、ステップとそれに続く他の OmniScript 要素が実行されます。ただし、ユーザーが OmniScript から離れると、非同期で呼び出された Integration Procedure の実行が停止します。
-
OmniScriptから個別のLightning Webコンポーネントにメッセージを送信するには、Pub/Subメッセージを使用して、メッセージのキーと値のペアを追加します。
各移動アクションは、必要なすべてのパラメータを後続の Lightning Web コンポーネントに渡す必要があります。たとえば、最初のナビゲーションアクションでは、
c__ContextIdパラメーターを 2 番目の OmniScript にc__ContextId=ContextIdとして渡します。2 番目の OmniScript のナビゲーションアクションは、パラメーターを 3 番目の OmniScript にc__ContextId=%ContextId%として渡します。すべてのナビゲーションアクションは、パラメーターが必要な限り、そのパラメーターを後続の OmniScript に渡す必要があります。 -
ページ参照種別を選択して、ナビゲーションアクションが移動する Salesforce 環境を決定します。
PageReference 型
説明
ToDo ドキュメント
アプリケーション
OmniScript から標準アプリケーション、カスタムアプリケーション、またはアプリケーション内のページにユーザーを転送します。接続アプリケーションはサポートされていません。
コンポーネント
OmniScript から Lightning Web コンポーネントに移動します。
現在のページ
ユーザーが OmniScript を完了した後に現在のページでページ更新をトリガーします。
ナレッジ記事
OmniScript での Knowledge 記事の表示。
ログインまたはログアウト
OmniScript からコミュニティのログインまたはログアウトページにユーザーを転送します。
名前付きページ
OmniScript から [名前付きページ] または [コミュニティ名前付きページ] に移動します。
ナビゲーション項目
OmniScript から、CustomTab にマッピングされたコンテンツを表示するページに移動します。
オブジェクト
OmniScript から標準またはカスタムオブジェクトページに移動します。
OmniScript by pageReference Type (ページ別の OmniScript 参照種別)
ページ参照種別を使用して OmniScript に移動します。
カスタム Lightning Web コンポーネントによる OmniScript
カスタム Lightning Web コンポーネントを使用して、OmniScript に移動します。
レコード
OmniScript からレコードページに移動します。
レコードリレーション
OmniScript から、レコードリレーションを操作するページに移動します。
OmniScript の再起動
OmniScript データをリセットする同じ OmniScript の新しいインスタンスに移動します。
Web ページ
OmniScript から外部 Web ページを開きます。
アプリケーションへの移動
[アプリケーションページ参照種別] を使用して、OmniScript から標準アプリケーション、カスタムアプリケーション、またはアプリケーション内のページにユーザーを転送します。アプリケーションが Salesforce アプリケーションランチャーで使用できることを確認します。
| プロパティ | 説明 |
|---|---|
| ページ参照種別 | アプリケーション |
| アプリケーション名 | appId を入力するか、適切な名前空間を使用して appDeveloperName を入力します。 appId には、AppDefinition オブジェクトの DurableId を使用します。 appDeveloperName には、アプリケーションの名前空間と開発者名を連結したものを使用します。アプリケーションの名前空間が標準、カスタム、または管理パッケージ名前空間である。開発者名はアプリケーションマネージャーに表示されます。appDeveloperName についての詳細は、「PageReference Type」を参照してください。 構文の例: 標準: standard__Account Custom: vlocity_cmt__CustomAccountApp |
| 追加パラメーター | アプリケーションページと追加属性を指定するには、「JSON」と入力します。 管理パッケージのデザイナーで、[Target Parameters (対象パラメーター)] 項目に JSON を入力します。[対象ページ] 項目は、アプリケーションの pageRef プロパティを表します。 |
Experience Cloud ログインまたはログアウトへの移動
OmniScript からコミュニティログインまたはログアウトページにユーザーを転送して認証します。
コミュニティログインを使用して OmniScript をプレビューするには、OmniScript を有効化して Experience Cloud ページに配置します。詳細については、「Add Your Omniscript to a Lightning Page and Add Your Omniscript to an Experience Cloud Page」を参照してください。
| プロパティ | 説明 |
|---|---|
| ページ参照種別 | ログイン |
| アクション | ログインまたはログアウト |
コンポーネントへの移動
コンポーネントページ参照種別を使用して、OmniScript から Lightning Web コンポーネントに移動します。
| プロパティ | 説明 |
|---|---|
| ページ参照種別 | コンポーネント |
| コンポーネント名 | コンポーネント名を namespace__componentName の形式で入力します。ここで、 namespace は標準ランタイムの名前空間です。 OmniStudio の場合、名前空間は omnistudio です。この項目では差し込み項目がサポートされます。 この項目では差し込み項目がサポートされます。 |
| 追加パラメーター | URL クエリ文字列形式を使用して、追加の target パラメーターを渡します。パラメータには c__ プレフィックスが必要です。この項目では差し込み項目がサポートされます。 コンソールアプリケーションのコンポーネントに移動するときに、c__tabIcon および c__tabLabel パラメーターを設定して、[コンソールタブアイコン] と [コンソールタブの表示ラベル] を追加します。c__tabIcon では SLDS アイコン、c__tabLabel ではプレーンテキストを使用できます。たとえば、&c__tabLabel=Custom Label&c__tabIcon=standard:account では、次の例の画像のようにコンソールタブが表示されます。 |
現在のページへの移動
ナビゲーションアクションの [現在のページ] PageRefrence Type を使用して、OmniScript から現在のページを更新および移動します。
| プロパティ | 説明 |
|---|---|
| ページ参照種別 | 現在のページ |
| 追加パラメーター | URL クエリ文字列形式を使用するパラメーターを渡して、現在のページに更新を適用します。 管理パッケージのデザイナーで、[Target Params (対象パラメーター)] 項目にパラメーターを追加します。 パラメータには c__ プレフィックスが必要です。この項目では、差し込み項目がサポートされます。 たとえば、OmniScript に 10 個のステップがあり、ステップ 1 とステップ 2 の間にページ参照種別が Current Page で対象が c__step=Step7 のナビゲーションアクションを挿入したとします。実行時に、ステップ 1 の [次へ] ボタンをクリックすると、ユーザーはステップ 7 に移動します。 |
Knowledge 記事への移動
OmniScript に Knowledge 記事を表示するには、ナビゲーション アクションの [Knowledge Article] ページ参照種別を選択します。
| プロパティ | 説明 |
|---|---|
| ページ参照種別 | ナレッジ記事 |
| 記事の URL | Knowledge Article の urlName を入力します。この項目では差し込み項目がサポートされます。 |
| 記事タイプ | articleType API 参照名を入力します。Knowledge オブジェクトの API 参照名から __kav を削除して、articleType API 参照名を見つけます。 コミュニティは記事タイプを無視します。 |
ページ参照種別を使用した OmniScript への移動
OmniScript ページ参照種別に移動します。Experience Cloud サイトページの OmniScript には、コミュニティ指定ページ参照種別を使用してアクセスする必要があります。
| プロパティ | 説明 |
|---|---|
| ページ参照種別 | Omniscript |
| OmniScript レイアウト | Omnscript のスタイルを選択します。 |
| タイプ サブ種別 言語 |
OmniScript の名前は [種別]、[サブ種別]、および [言語] で定義されているため、開く特定の OmniScript にこれらの値を入力します。 |
| OmniScript を事前入力する項目 | URL クエリ文字列形式を使用してパラメーターを渡します。 パラメータには c__ プレフィックスが必要です。この項目では差し込み項目がサポートされます。 例: |
カスタム Lightning Web コンポーネントを使用した OmniScript への移動
OmniScript をカスタム Lightning Web コンポーネントに組み込んで、OmniScript に移動します。[管理パッケージランタイム] 設定が有効か無効かに関係なく、この方法で OmniScript に移動できます。
- カスタム Lightning Web コンポーネント(LWC)を作成します。
-
このコードをコンポーネントの適切なボタンクリックハンドラーに追加し、種別、サブ種別、言語、コンテキスト ID を値に置き換えます。
pageReference = { type: 'standard__featurePage', attributes: { featureName: 'omnistudio', pageName: 'omniscript' }, state: { omniscript__type: os_type, omniscript__subType: os_subtype, omniscript__language: os_language, omniscript__recordId: contextId } }; this[NavigationMixin.GenerateUrl](pageReference).then(url => { window.open(url, "_blank"); });
指定ページまたはコミュニティ指定ページへの移動
標準ページまたは Experience Cloud ページにユーザーを誘導します。
| プロパティ | 説明 |
|---|---|
| ページ参照種別 | 名前付きページ Experience Cloud ページの場合、[コミュニティ指定ページ] を選択します。 |
| ページ名 | ページ名の API を入力します。カスタムページの API 参照名には、[API 参照名] に __c を含める必要があります。この項目では差し込み項目がサポートされます。 |
ナビゲーション項目への移動
[ナビゲーションアクション] [ナビゲーション項目ページ] 参照種別を使用して、OmniScript からカスタムタブに移動し、対応付けられたコンテンツを表示します。
| プロパティ | 説明 |
|---|---|
| ページ参照種別 | ナビゲーション項目 |
| タブ名 | カスタムタブのタブ名と名前空間プレフィックスを NS__TabName の形式で入力します。NS はタブの名前空間です。 タブについての詳細は、「Lightning ページタブの作成」を参照してください。この項目では差し込み項目がサポートされます。 |
オブジェクトページへの移動
移動アクションのオブジェクトページ参照種別を使用して、OmniScript からオブジェクトページに移動します。
| プロパティ | 説明 |
|---|---|
| ページ参照種別 | オブジェクト |
| オブジェクト API 参照名 | オブジェクトの API 参照名を入力します。この項目では、差し込み項目がサポートされます。 |
| アクション | 呼び出すアクションを選択します。[新規] アクションでモーダルダイアログが開きます。 |
| フィルター名 | [オブジェクト] ページの ID を入力します。この項目では差し込み項目がサポートされます。 |
レコードページへの移動
移動アクションのレコードページ参照種別を使用して、OmniScript からレコードページに移動します。
| プロパティ | 説明 |
|---|---|
| ページ参照種別 | レコード |
| レコード ID | 移動先のレコード ID を入力します。この項目では、差し込み項目がサポートされます。 |
| レコードアクション | 呼び出すレコードアクションを選択します。 コピーおよび編集アクションでは、モーダルダイアログが開きます。 |
| オブジェクト API 参照名 | オブジェクトの API 参照名を入力します。この項目では差し込み項目がサポートされます。 |
レコードリレーションページへの移動
[レコードリレーション] ページ参照種別を使用して、OmniScript からレコードリレーションを操作するページに移動します。
| プロパティ | 説明 |
|---|---|
| ページ参照種別 | レコードリレーション |
| レコード ID | 移動先のレコード ID を入力します。この項目では、差し込み項目がサポートされます。 |
| オブジェクト API 参照名 | リレーションを定義するオブジェクトの API 参照名を入力します。この項目では、差し込み項目がサポートされます。 |
| リレーションオブジェクトの API 参照名 | リレーションの API 参照名を入力します。 |
Web ページへの移動
Web ページ参照種別を使用して、OmniScript から Web ページに移動します。
| プロパティ | 説明 |
|---|---|
| ページ参照種別 | Web ページ |
| URL | Web ページの完全な URL を入力します。 たとえば、Google に移動するには、「https://google.com」と入力します。 OmniScript が含まれる参照元タブが置き換えられます。Web ページを更新するには、ページに移動するか再読み込みします。 |
OmniScript の再起動
同じ OmniScript の新しいインスタンスにユーザーを移動します。このオプションを使用すると、ユーザーはプロセスを最初からやり直すか、繰り返し行うことができます。[移動アクション] をステップ内に配置すると、ボタンとして、またはステップ外に配置すると、自動的または条件付きで実行できます。
| プロパティ | 説明 |
|---|---|
| ページ参照種別 | Web ページ このページ参照種別では、時間追跡とメッセージングフレームワークはサポートされていません。 |
| 条件付きビュー | アクションを条件付きで実行または表示する条件を追加します。「Conditionally Display Omniscript Elements (OmniScript 要素の条件付き表示)」を参照してください。 |
