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

Mentions クラス

メンションに関する情報にアクセスします。メンションは、ユーザー名またはグループ名の前にある「@」文字で示されます。ユーザーまたはグループは、メンションされると通知を受け取ります。

名前空間

ConnectApi

Mentions のメソッド

Mentions のメソッドは次のとおりです。すべてのメソッドが静的です。

getMentionCompletions(communityId, q, contextId)

フィード項目またはコメントの本文でメンション可能なユーザーおよびグループの最初のページを取得します。

API バージョン

29.0

Chatter が必要かどうか

はい

署名

public static ConnectApi.MentionCompletionPage getMentionCompletions (String communityId, String q, String contextId)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
q
型: String
一致するユーザーおよびグループの名前の検索語。グループの検索には 2 文字以上を指定する必要があります。ユーザーの検索には最小文字数はありません。このパラメーターではワイルドカードは使用できません。
contextId
型: String
検索結果を絞り込むフィード項目 ID (コメント内のメンションの場合) またはフィード件名 ID (フィード項目内のメンションの場合) であり、最も的確な結果が最初に表示されます。顧客がメンションの補完結果に顧客を含めることができるグループのグループ ID を使用します。

使用方法

ユーザーがフィード項目本文またはコメント本文の @ の後に文字を入力すると選択可能になる提案メンションのページを生成するには、このメソッドをコールします。

このメソッドを使用するコードをテストするには、一致する set test メソッドを使用します (メソッド名に setTest をプレフィックスとして付けます)。set test メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、コードで例外が発生します。

getMentionCompletions(communityId, q, contextId, type, pageParam, pageSize)

指定されたタイプで使用できるメンション提案のページを取得します。

API バージョン

29.0

Chatter が必要かどうか

はい

署名

public static ConnectApi.Mentions getMentionCompletions (String communityId, String q, String contextId, ConnectApi.MentionCompletionType type, Integer pageParam, Integer pageSize)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
q
型: String
一致するユーザーおよびグループの名前の検索語。グループの検索には 2 文字以上を指定する必要があります。ユーザーの検索には最小文字数はありません。このパラメーターではワイルドカードは使用できません。
contextId
型: String
検索結果を絞り込むフィード項目 ID (コメント内のメンションの場合) またはフィード件名 ID (フィード項目内のメンションの場合) であり、最も的確な結果が最初に表示されます。顧客がメンションの補完結果に顧客を含めることができるグループのグループ ID を使用します。
type
型: ConnectApi.MentionCompletionType
メンションの補完の種類。
  • All — メンションで参照するレコードタイプに無関係の、すべてのメンションの補完。
  • Group — グループのメンションの補完。
  • User — ユーザーのメンションの補完。
pageParam
型: Integer
返すページの数。0 から開始します。null または 0 を渡すと、最初のページが返されます。
pageSize
型: Integer
ページあたりの項目数を指定します。有効な値は 1 ~ 100 です。null を渡すと、デフォルトサイズの 25 に設定されます。

使用方法

ユーザーがフィード項目本文またはコメント本文の @ の後に文字を入力すると選択可能になる提案メンションのページを生成するには、このメソッドをコールします。

このメソッドを使用するコードをテストするには、一致する set test メソッドを使用します (メソッド名に setTest をプレフィックスとして付けます)。set test メソッドでは、同じパラメーターを使用します。パラメーターが同じでないと、コードで例外が発生します。

getMentionValidations(communityId, parentId, recordIds, visibility)

メンションがコンテキストユーザーに対して有効であるかどうかを示す情報を取得します。

API バージョン

29.0

Chatter が必要かどうか

はい

署名

public static ConnectApi.Mentions getMentionValidations(String communityId, String parentId, List<String> recordIds, ConnectApi.FeedItemVisibilityType visibility)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
parentId
型: String
フィード項目の親 ID。
recordIds
型: List<String>
メンションする ID のカンマ区切りのリスト。最大値は、25 です。
visibility
型: ConnectApi.FeedItemVisibilityType
フィード項目を表示できるユーザーの種別。
  • AllUsers — 表示は内部ユーザーに限定されません。
  • InternalUsers — 表示は内部ユーザーに限定されます。

使用方法

このメソッドをコールして、ConnectApi.Mentions.getMentionCompletions へのコールから返されたレコード ID がコンテキストユーザーに対して有効かどうかを確認します。たとえば、コンテキストユーザーは自分が属していない非公開グループにメンションできません。そのようなグループがメンションの検証のリストに含まれていると、ConnectApi.MentionValidations.hasErrors プロパティは true になり、グループの ConnectApi.MentionValidation.valdiationStatusDisallowed に設定されます。

Mentions テストメソッド

Mentions のテストメソッドを次に示します。すべてのメソッドが静的です。

これらのメソッドを使用して ConnectApi コードをテストする方法の詳細は、「ConnectApi コードのテスト」を参照してください。

setTestGetMentionCompletions(communityId, q, contextId, result)

getMentionCompletions(String, String, String) をテストコンテキストでコールするときに返される ConnectApi.MentionCompletionPage オブジェクトを登録します。

API バージョン

29.0

署名

public static Void setTestGetMentionCompletions (String communityId, String q, String contextId, ConnectApi.MentionCompletionPage result)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
q
型: String
一致するユーザーおよびグループの名前の検索語。グループの検索には 2 文字以上を指定する必要があります。ユーザーの検索には最小文字数はありません。このパラメーターではワイルドカードは使用できません。
contextId
型: String
検索結果を絞り込むフィード項目 ID (コメント内のメンションの場合) またはフィード件名 ID (フィード項目内のメンションの場合) であり、最も的確な結果が最初に表示されます。顧客がメンションの補完結果に顧客を含めることができるグループのグループ ID を使用します。
result
型: ConnectApi.​MentionCompletion​Page
テストデータを含む ConnectApi.MentionCompletionPage オブジェクト。

戻り値

型: Void

setTestGetMentionCompletions(communityId, q, contextId, type, pageParam, pageSize, result)

getMentionCompletions(String, String, String, ConnectApi.MentionCompletionType, Integer, Integer) をテストコンテキストでコールするときに返される ConnectApi.MentionCompletionPage オブジェクトを登録します。

API バージョン

29.0

署名

public static Void setTestGetMentionCompletions (String communityId, String q, String contextId, ConnectApi.MentionCompletionType type, Integer pageParam, Integer pageSize, ConnectApi.MentionCompletionPage result)

パラメーター

communityId
型: String
Experience Cloud サイトの ID、internal、または null
q
型: String
一致するユーザーおよびグループの名前の検索語。グループの検索には 2 文字以上を指定する必要があります。ユーザーの検索には最小文字数はありません。このパラメーターではワイルドカードは使用できません。
contextId
型: String
検索結果を絞り込むフィード項目 ID (コメント内のメンションの場合) またはフィード件名 ID (フィード項目内のメンションの場合) であり、最も的確な結果が最初に表示されます。顧客がメンションの補完結果に顧客を含めることができるグループのグループ ID を使用します。
type
型: ConnectApi.MentionCompletionType
メンションの補完の種類。
  • All — メンションで参照するレコードタイプに無関係の、すべてのメンションの補完。
  • Group — グループのメンションの補完。
  • User — ユーザーのメンションの補完。
pageParam
型: Integer
返すページの数。0 から開始します。null または 0 を渡すと、最初のページが返されます。
pageSize
型: Integer
ページあたりの項目数を指定します。有効な値は 1 ~ 100 です。null を渡すと、デフォルトサイズの 25 に設定されます。
result
型: ConnectApi.​MentionCompletion​Page
テストデータを含む ConnectApi.MentionCompletionPage オブジェクト。

戻り値

型: Void