The social and collaboration tools provided by the Social module extend the search application with the ability to store user-generated information on individual documents and document collections, and to share this information among groups of authenticated users. For example, documents can be tagged or bookmarked, and users can save search queries and add comments to individual documents. Features include:
  • Saved searches. Users can save important keyword search queries, apply filters, and retrieve the information later.
  • Saved results. Users can bookmark results, add them to a basket, and search those saved items.
  • Rating. Users can choose to rate or “like” results, giving a social signal to their peers. Rating analytics can be used to influence ranking.
  • Tagging. Users can tag content with keywords, which content owners can use to improve data quality.
  • Annotations. Users can annotate/comment on results and edit or delete their own comments. Users cannot edit or delete the comments of others.
  • Topics. Users can create topics and any captured metadata. For example, saved searches can be associated with a topic.
User-generated content can be stored in a relational database or any other kind of data store, using our pluggable architecture. Authentication and authorization of users is managed via the Security module.

​
Prerequisite

Prior to using social and collaboration tools, you must Enable Social Features.
Prior to using social and collaboration tools, you must configure them in Fusion and in App Studio, and then enable them.

​
Configure Fusion

How to configure Fusion (Fusion Server 4.1 and earlier)
  1. In the fusion-app-name Fusion app, create a fusion-app-name_user_data Fusion collection with 1 shard and 2 replicas.
  2. Update the managed-schema.xml to include the new social fields: 
    <field indexed="true" multiValued="false" name="type" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="user_id" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="full_name" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="anonymous" required="false" stored="true" type="boolean"/>
    <field indexed="true" multiValued="false" name="created" required="false" stored="true" type="pdate"/>
    <field indexed="true" multiValued="false" name="created_epoch" required="false" stored="true" type="plong"/>
    <field indexed="true" multiValued="false" name="name" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="path" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="private" required="false" stored="true" type="boolean"/>
    <field indexed="true" multiValued="false" name="query_url" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="collection" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="target" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="text" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="title" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="description" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="url" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="accessibility" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="namespace" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="creator__anonymous" required="false" stored="true" type="boolean"/>
    <field indexed="true" multiValued="false" name="creator__full_name" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="creator__id" required="false" stored="true" type="plong"/>
    <field indexed="true" multiValued="false" name="creator__user_id" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="topic__id" required="false" stored="true" type="plong"/>
    <field indexed="true" multiValued="false" name="topic__title" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="topic__private" required="false" stored="true" type="boolean"/>
    <field indexed="true" multiValued="false" name="topic__path" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="topic__namespace" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="topic__description" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="topic__accessibility" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="topic__collection" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="topic__created" required="false" stored="true" type="pdate"/>
    <field indexed="true" multiValued="false" name="topic__created_epoch" required="false" stored="true" type="plong"/>
    <field indexed="true" multiValued="false" name="topic__creator__anonymous" required="false" stored="true" type="boolean"/>
    <field indexed="true" multiValued="false" name="topic__creator__full_name" required="false" stored="true" type="string"/>
    <field indexed="true" multiValued="false" name="topic__creator__id" required="false" stored="true" type="plong"/>
    <field indexed="true" multiValued="false" name="topic__creator__user_id" required="false" stored="true" type="string"/>

​
Configure App Studio

Configure App Studio to support social features.

​
Upgrade to the latest version of Appkit

Upgrade to the latest version of Appkit.

​
Enable social features

  1. Create the file social.conf in the conf/social directory and add the following parameter to it: 
    platform: platforms.fusion.social
  2. Create the file social.conf in the conf/platforms/Fusion directory and add the following parameters to it: 
    # Required for query/index pipeline
collection: fusion-app-name_user_data

# Required for query/index profiles
index-profile: fusion-app-name_user_data
query-profile: fusion-app-name_user_data

# Allow Fusion platform to store Social entities
readOnly: false
webservice-enabled: false

​
Terminology

While much of the language used to describe collaborative tools is carefully chosen to be self explanatory, there are several general concepts which are used throughout and are introduced in this section.

​
Annotations

Key to the collaboration enabled by inclusion of this module, there are several types of annotation which can be applied to documents. These include bookmarks, comments, and likes, which are commonly found in many applications and provide a versatile way for users to contribute and save information during their search.

​
Topics

A topic is a general term for a subject that users are intending to collect information about. This module provides facilities for users to create a named group with which they can associate any number of annotated documents. Topics themselves can be created and selected using the Topic Form tag. Many of the collaborative tags included in this module have a topic attribute that links the saved information to a specific topic (which can be picked up from the URL). Topics can be defined by the developer as being ‘namespaced’ so they can be global (available for all users to collaborate on) or local (only viewable by the individual user that created them).

​
Collections

Some annotations can be categorized by collection. This is a mechanism for separating annotations of different types of document. There is a subtle difference between topics and collections, in that collections are usually determined by the categories of information in the data and generally pre-defined by the application developer offering a small number of collections with which to associate annotations. Collections are intended for a finite number of categorical groups whereas any number of topics can be created.

​
Social and Collaboration tags

​
Like Documents

The collaborate:like tag displays controls for the user to “like” a document. It also displays statistics on the number of times a specified target document has been liked.

​
Saving Queries

The Appkit social module lets users save and retrieve their search queries. Use the collaborate:saved-query-list tag to let users save and retrieve their saved search queries. Alternatively, you can enable social features in the search:box to have access to the same form.

​
Bookmarks

The collaborate:bookmark tag displays controls for adding a new bookmark, in addition to statistics on the number of times a specified target document has been bookmarked. This tag is typically used within a Result List tag, to enable the user to bookmark a particular document in the result list. Bookmark List tag The collaborate:bookmark-list tag retrieves and displays all bookmarks that have been created by a particular user, are within a given topic, or are linked to a particular document (or any combination of the three constraints). Alternatively, you can enable social features in the search:box to have access to the same form.

​
Commenting

The Appkit Social module lets users comment on search results and display other users’ comments. This gives users a flexible way to interact and contribute in an application, and can be used to implement features such as feedback, discussion, and reviewing systems. The collaborate:comment-form and collaborate:comment-list tags are used respectively to create and retrieve these annotations.

​
Create Topics

The collaborate:topic-form tag lets users create named topics with which to associate saved information. Topics can be restricted to the user who creates a topic or global to all users. The collaborate:topic-list tag will display these topics.