この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

PromptVersion

アプリケーション内ガイダンスプロンプトまたはウォークスルーを表します。API バージョン 46.0 以降で利用できます。

プロンプトとウォークスルーを使用すれば、アプリケーション内でユーザにお知らせ、トレーニング、またはニュースを表示できます。任意の URL にリンクするアクションボタンまたはリンクの追加を選択します。表示、アクションボタンのクリック、ウォークスルーの完了を追跡します。

サポートされているコール

create()delete()describeSObjects()query()retrieve()update()upsert()

特別なアクセスルール

システム管理者は、プロンプトとウォークスルーを追加または編集できます。システム管理者以外のユーザについては、「プロンプトを管理」および「メタデータ API 関数を使用したメタデータを変更」ユーザ権限を割り当てます。すべてのユーザがアプリケーション内ガイダンスの設定ページを表示できます。ユーザにウォークスルーを表示するには、「ウォークスルーを参照」ユーザ権限を使用します。これは「ウォークスルー」権限セットライセンスに含まれています。myTrailhead サブスクリプションにこの機能が含まれています。価格設定についての詳細は、Salesforce アカウントエグゼクティブにお問い合わせください。ただし、ウォークスルーを作成、プレビュー、またはパッケージ化するためにトライアルを開始したり、ライ���ンスを購入したりする必要はありません。「プロンプトとウォークスルーのパッケージ化」セクションで作成するウォークスルーのユーザ表示に関する制限に注意してください。

プロンプトとウォークスルーのパッケージ化

詳細は、Salesforce ヘルプの「Creating Managed Packages (管理パッケージの作成)」を参照してください。

プロンプトパッケージのインストールと管理、およびパッケージからインストールしたプロンプトの編集とコピーについての詳細は、「Lightning Experience でのプロンプトに関する考慮事項」を参照してください。

Salesforce 組織に含まれていないカスタムプロファイルまたは権限がパッケージに含まれている場合、アプリケーション内ガイダンスはインストールされますが、それらのカスタム項目は含まれません。たとえば、組織にない複数のカスタムプロファイルを含むプロンプトを組織でインストールした場合、プロンプトはそれらのカスタムプロファイルなしでインストールされます。

Salesforce 組織にない標準アプリケーションがパッケージに含まれている場合、アプリケーション内ガイダンスはインストールされますが、それを使用することはできません。

未管理パッケージには名前空間プレフィックスを含める必要があります。詳細は、Salesforce ヘルプの「名前空間プレフィックスの登録」および「パッケージをインストールすると自分の名前空間プレフィックスはどうなりますか?」を参照してください。

ウォークスルーパッケージの場合:
  • 管理パッケージまたは未管理パッケージに標準アプリケーションのウォークスルーが含まれる場合、ウォークスルーがインストールされます。ただし、myTrailhead に登録していないユーザ、または 30 日間のトライアルを開始していないユーザには表示されません。
  • セキュリティレビューに合格した第一世代管理パッケージにカスタムアプリケーション内のページに 1 つ以上のステップがあるウォークスルーが含まれている場合、ユーザは myTrailhead またはトライアルに登録しなくてもユーザにウォークスルーを表示できます。

組織でパッケージからアプリケーション内ガイダンスをインストールすると、アプリケーション内ガイダンスでは IsPublished 項目に示されている公開状態が維持されます。たとえば、パッケージプロンプトが有効な場合、組織によるインストールでも有効になります。

項目

項目 詳細
ActionButtonLabel
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
アクションボタンの表示ラベル。最大 25 文字です。ウォークスルーの場合、この項目は最後のステップでのみ指定できます。
ActionButtonLink
url
プロパティ
Create、Filter、Nillable、Sort、Update
説明
アクションボタンの URL。最大 1,000 文字です。この項目に対する SOQL クエリでは、GROUP BY オプションを使用できません。ウォークスルーの場合、この項目は最後のステップでのみ指定できます。
Body
textarea
プロパティ
Create、Update
説明
本文コンテンツ。フロート表示プロンプトの場合、最大で 240 文字です。ドッキングプロンプトの場合、最大で 4000 文字です。ただし、ドッキングプロンプトではリッチテキストエディタを使用するため、最大文字数は人間が読めるテキストではなく、HTML マークアップの文字数を指します。
DelayDays
int
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
表示間の日数。ウォークスルーの場合、この項目は最初のステップでのみ指定できます。
Description
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
アプリケーション内ガイダンスの説明。最大 255 文字です。
DismissButtonLabel
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
フロート表示プロンプトの破棄ボタンの表示ラベル。最大 15 文字です。
DisplayPosition
種別
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
ページのフロート表示プロンプトの位置を示します。有効な値は、次のとおりです。
  • TopLeft
  • TopCenter
  • TopRight
  • BottomLeft
  • BottomCenter
  • BottomRight
DisplayType
picklist
プロパティ
Create、Filter、Group、Restricted picklist、Sort、Update
説明
プロンプトの種別を示します。有効な値は、次のとおりです。
  • DockedComposer (ドッキングプロンプト)
  • FloatingPanel (フロート表示プロンプト)
EndDate
date
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
アプリケーション内ガイダンスの表示を停止する日付を示します。ウォークスルーの場合、この項目は最初のステップでのみ指定できます。
Header
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
ドッキングプロンプトのヘッダーの表示ラベル。この表示ラベルは、ウィンドウのブラウザバーに表示されます。最大 36 文字です。
IndexWithIsPublished
string
プロパティ
Filter、idLookup、Nillable、Sort
説明
クエリを効率的にするために Salesforce が使用します。
IndexWithoutIsPublished
string
プロパティ
Filter、idLookup、Nillable、Sort
説明
クエリを効率的にするために Salesforce が使用します。
IsPublished
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
アプリケーション内ガイダンスが有効であるか (yes)、否か (no) を示します。
MasterLabel
string
プロパティ
Create、Filter、Group、Sort、Update
説明
マスタ表示ラベル。最大 80 文字です。
ParentId
reference
プロパティ
Create、Filter、Group、Sort
説明
アプリケーション内ガイダンスの ID。
PublishedByUserId
reference
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
アプリケーション内ガイダンスを有効化したユーザの ID。アプリケーション内ガイダンスがパッケージの一部である場合、これはパッケージをインストールしたユーザです。
PublishedDate
date
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
アプリケーション内ガイダンスが有効化された日付を示します。アプリケーション内ガイダンスがパッケージの一部である場合、これはパッケージがインストールされた日付です。ウォークスルーの場合、この項目は最初のステップでのみ指定できます。
ShouldDisplayActionButton
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
アプリケーション内ガイダンスにアクションボタンまたはリンクが含まれているか (yes)、否か (no) を示します。
ShouldIgnoreGlobalDelay
boolean
プロパティ
Create、Defaulted on create、Filter、Group、Sort、Update
説明
アプリケーション内ガイダンス間のグローバル時間の遅延をプロンプトで無視し、代わりにページの読み込み時にプロンプトを表示するか (yes)、否か (no) を示します。デフォルトは no です。
StartDate
date
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
表示を開始する日付を示します。ウォークスルーの場合、この項目は最初のステップでのみ指定できます。
StepNumber
int
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
ウォークスルーでユーザが表示または操作した最後のステップの番号を示します。最大値は 10 です。
TargetAppDeveloperName
string
プロパティ
Create、Filter、Group、Sort、Update
説明
アプリケーション内ガイダンスを表示するアプリケーションの開発者名。
TargetAppNamespacePrefix
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
アプリケーション内ガイダンスを表示するアプリケーションの名前空間プレフィックス。パッケージのインストール先の組織にある対象アプリケーションの NamespacePrefix に一致する必要があります。最大 15 文字です。
TargetPageKey1
string
プロパティ
Create、Filter、Group、Sort、Update
説明
Salesforce でページの場所を特定するために targetPageKey2 および targetPageType と共に使用されます。
TargetPageKey2
string
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
Salesforce でページの場所を特定するために targetPageKey1 および targetPageType と共に使用されます。
TargetPageType
string
プロパティ
Create、Filter、Group、Sort、Update
説明
アプリケーション内ガイダンスが表示されるページの種別。
ThemeColor
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
アプリケーション内ガイダンスに適用するカスタムテーマ色を示します。themeSaturation が指定されている場合は必須です。ウォークスルーの最初のステップで指定して、ウォークスルー全体に適用します。有効な値は、次のとおりです。
  • Theme1: 現在のブランドの色から派生
  • Theme2: 現在のページ背景の色から派生
  • Theme3: 現在のグローバルヘッダーの色から派生
  • Theme4: 現在のアプリケーションテーマの色から派生
ThemeSaturation
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
カスタムテーマ色が適用されたアプリケーション内ガイダンスに適用する色の値 (彩度) を示します。themeColor が指定されている場合は必須です。ウォークスルーの最初のステップで指定して、ウォークスルー全体に適用します。有効な値は、次のとおりです。
  • Dark
  • Light
TimesToDisplay
int
プロパティ
Create、Filter、Group、Nillable、Sort、Update
説明
アプリケーション内ガイダンスを表示する回数 (つまり出現数) の最大数。ユーザによるアプリケーション内ガイダンスの操作 (または無視) が検出され、アプリケーション内ガイダンスを再度表示するか、スケジュールされた繰り返しをキャンセルするかが決定されます。これは、スケジュールされた表示数に反して実行される可能性があります。最大値は 30 です。ウォークスルーの場合、この項目は最初のステップでのみ指定できます。
Title
string
プロパティ
Create、Filter、Group、Sort、Update
説明
アプリケーション内ガイダンスのタイトルの表示ラベル。最大 36 文字です。
UserAccess
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
アプリケーション内ガイダンスが表示される権限を示します。有効な値は、次のとおりです。
  • Everyone (表示できるユーザに制限がないことを示す)
  • SpecificPermissions (指定された特定のユーザ権限を持つユーザのみがアプリケーション内ガイダンスを表示できることを示す)
UserProfileAccess
picklist
プロパティ
Create、Filter、Group、Nillable、Restricted picklist、Sort、Update
説明
アプリケーション内ガイダンスが表示されるプロファイルを示します。有効な値は、次のとおりです。
  • Everyone (表示できるユーザに権限の制限がないことを示す)
  • SpecificProfiles (指定された特定のユーザプロファイルを持つユーザがアプリケーション内ガイダンスを表示できることを示す)
VersionNumber
int
プロパティ
Create、Filter、Group、Sort、Update
説明
複数のバージョンが組織で保存されないため、数値は 1 のままです。
VideoLink
url
プロパティ
Create、Filter、Nillable、Sort、Update
説明

ドッキングプロンプトでの動画の URL。最大 1,000 文字です。

動画の埋め込みコードを探すには、動画ホスト Web サイトからの手順に従います。通常、これらの手順は、Web サイトの名前と「埋め込み動画」を検索すると見つかります。たとえば YouTube の場合、埋め込み動画コードは次のようになります。

<iframe width="560" height="315" src="https://www.youtube.com/embed/Ko-gcObzTVo" frameborder="0" allow="accelerometer; autoplay; encrypted-media; gyroscope; picture-in-picture" allowfullscreen></iframe>

次に、src 属性に含まれている URL を入力します。上記の例では、「https://www.youtube.com/embed/Ko-gcObzTVo」を入力します。