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.valdiationStatus が Disallowed に設定されます。
Mentions テストメソッド
これらのメソッドを使用して ConnectApi コードをテストする方法の詳細は、「ConnectApi コードのテスト」を参照してください。
setTestGetMentionCompletions(communityId, q, contextId, result)
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.MentionCompletionPage
- テストデータを含む ConnectApi.MentionCompletionPage オブジェクト。
戻り値
型: Void
setTestGetMentionCompletions(communityId, q, contextId, type, pageParam, pageSize, result)
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.MentionCompletionPage
- テストデータを含む ConnectApi.MentionCompletionPage オブジェクト。
戻り値
型: Void