SharePoint ソーシャル フィードでの参照スレッドおよびダイジェスト スレッドReference threads and digest threads in SharePoint social feeds

参照スレッドおよびダイジェスト スレッドについて説明します。これらは、SharePoint でソーシャル フィードを構成するスレッドのコレクションに含めることができるスレッドの種類です。Learn about reference threads and digest threads, which are thread types that may be included in the collection of threads that make up a social feed in SharePoint. ソーシャル フィードを取得する場合、SharePoint はフィードを構成する SocialThread オブジェクトのコレクションを含む SocialFeed オブジェクトを返します。When you retrieve a social feed, SharePoint returns a SocialFeed object that contains the collection of SocialThread objects that make up the feed. これらのスレッドは、会話、1 つのミニブログ投稿、およびイベントや参照スレッドを含む通知を表すことができます。These threads can represent conversations, single microblog posts, and notifications, which include events and reference threads. 会話を表すスレッドは、ダイジェスト スレッドとしてサーバーによって返される可能性があります。Threads that represent conversations may be returned by the server as digest threads.

注意

この記事で参照されている API は、.NET クライアント オブジェクト モデルからのものです。The API referenced in this article is from the .NET client object model. ただし、その他の API に対応するオブジェクトが異なる場合があります。However, corresponding objects in other APIs might be different. その他の関連する API へのリンクは、「追加リソース」を参照してください。See Additional resources for links to other related APIs.

SharePoint ソーシャル フィードでの参照スレッドとはWhat are reference threads in SharePoint social feeds?

ユーザーが投稿をお気に入りにする、投稿でユーザーをメンションする、投稿に返信する、または投稿にタグ付けをすると、SharePoint で参照スレッドが生成されます。When a user likes a post, mentions someone in a post, replies to a post, or includes a tag in a post, SharePoint generates a reference thread. 参照スレッドには、参照されているスレッドまたは投稿に関する情報の入手に使用する ThreadTypePostReference の 2 つのプロパティがあります。Reference threads have two properties that you use to get information about the referenced thread or post: ThreadType and PostReference .

ThreadType プロパティは、表 1 に表示される値のいずれかを返すことができるので、参照スレッドを特定することができます。You can identify a reference thread by its ThreadType property, which can return one of the values shown in Table 1.

表 1. 参照スレッドの種類Table 1. Types of reference thread

参照の種類Reference type 説明Description
LikeReference **** LikeReference ****
ユーザーがお気に入りの投稿に対する参照。A reference to a post that a user likes.
MentionReferenceMentionReference
ユーザーに言及している投稿に対する参照。A reference to a post that mentions a user.
ReplyReferenceReplyReference
返信への参照。A reference to a reply.
TagReferenceTagReference
タグを含む投稿への参照。A reference to a post that contains a tag.
NormalNormal
参照スレッドではありません。Not a reference thread.

PostReference プロパティは、イベントをトリガーしたスレッドに関する情報を含む SocialPostReference オブジェクトを返します。このオブジェクトには少なくともソース スレッドの ID が含まれ、スレッドがまだ存在する場合は、この ID を SocialFeedManager.GetFullThread メソッドで使用してスレッドを取得できます。The PostReference property returns a SocialPostReference object that contains information about the thread that triggered the event. At a minimum, it contains the ID of the source thread, which you can then use with the SocialFeedManager.GetFullThread method to retrieve the thread if it still exists.

SocialPostReference には、ソース投稿またはソース スレッドのコピーも含まれる場合があります。これらが含まれるかどうかは、フィードの種類、スレッドの種類、およびセキュリティ トリミングによって決まります。参照に投稿またはスレッドが含まれる場合、これらのオブジェクトはイベントが発生した時点での投稿またはスレッドのスナップショットを表します。SocialPostReference might also contain a copy of the source post or thread. This availability depends on the feed type, thread type, and security trimming. If the reference does contain a post or thread, these objects represent snapshots of the post or thread at the time the event occurred.

フィード関連のアクティビティの中には、参照スレッドとしてフィードに投稿されないものもあります。たとえば、フォロー通知 (他のユーザーがサイトのフォローを開始したときなど) は、参照スレッドではありません。Not all feed-related activities are posted to the feed as reference threads. For example, Following notifications (such as when someone starts following a site) are not reference threads.

注意

SharePoint は、自動生成された投稿と、サイト フィードに送信されるすべての投稿のサイト アクセスのコンテンツについて、自動的にセキュリティ トリミングを行います。SharePoint automatically security trims for content in autogenerated posts and for site access in all posts that are directed to a site feed. ただし、URL を指定することにより、SecurityUris 属性を使用して任意の投稿のセキュリティ トリミングができます。However, you can use the SecurityUris attribute to security trim any post by specifying a URL. URL にアクセスできないユーザーは、投稿を受け取りません。Users who do not have access to the URL do not receive the post.

返信、お気に入り、メンションの参照は、ユーザーの個人用のフィードに無期限に格納されます。Reply, like, and mention references are stored indefinitely in the user's personal feed. タグの参照は分散キャッシュに格納されるので、一時的な格納です。Tag references are stored in the Distributed Cache, so they are stored temporarily. キャッシュの詳細については、「SharePoint のミニブログ機能、フィード、分散キャッシュ サービスの概要」を参照してください。For more information about caching, see Overview of microblog features, feeds, and the Distributed Cache service in SharePoint.

SharePoint ソーシャル フィードでのダイジェスト スレッドとはWhat are digest threads in SharePoint social feeds?

ダイジェスト スレッドはスレッドの簡易版を表し、スレッドのルート投稿と最新の 2 つの返信を含みます。ダイジェスト スレッドは、スレッドの Attributes プロパティで IsDigest 属性が適用されているかどうかを調べることによって識別できます。スレッドに 3 つ以上の返信が含まれるかどうかを知るには、 TotalReplyCount プロパティを調べます。A digest thread represents a compact version of a conversation—it contains the thread's root post and two most recent replies. You can identify a digest thread by checking whether the thread has the IsDigest attribute applied in its Attributes property. To see whether a thread has more than two threads, check the TotalReplyCount property.

パフォーマンスを最適化するため、スレッドに 3 つ以上の返信が含まれるときは、サーバーはダイジェスト スレッドを返します。スレッドのすべての返信を取得する場合は、 SocialFeedManager.GetFullThread メソッドを呼び出してスレッド ID を渡します。To optimize performance, when a thread contains more than two replies, the server returns a digest thread. If you want to get all the replies for a thread, call the SocialFeedManager.GetFullThread method and pass in the thread ID.

関連項目See also