static osapi.jive.corev3.contents

Static class for getting or creating any content type. Specific content types also have their own static classes for manipulating that content type. The more specific classes function similarly, but the "type" field is not required and there might be more functionality specific to that type. For example, discussions is the static class for creating and getting discussions. Content types include:

  • discussion (Discussion) - a discussion, which is the beginning of a conversation.
  • document (Document) - a document in Jive that can be discussed and shared with other people.
  • file (File) - a file in Jive that can be discussed and shared with other people.
  • poll (Poll) - a poll where people can vote to make a decision or express an opinion.
  • post (Post) - an entry in a blog.
  • favorite (Favorite) - a link to content around the web that can be shared and discussed.
  • task (Task) - a task for a person to get things done.
  • update (Update) - a user status update.
Example:
Get a document by URI

You may want to save the URIs of content types for future use. URIs are the handles used to retrieve objects throughout the API. Here is an example of using the URI of a document to retrieve all fields of that document. Note that the "fields" parameter takes a comma-delimited list of fields or the special values "@all" and "@summary".

 //Get all fields of a document by URI
 var documentURI = ...; //A given URI of a document
 <p/>
 var request = osapi.jive.corev3.contents.get({
     "type": "document",
     "uri": documentURI,
     "fields": "@all"
 });
 <p/>
 request.execute(function(data) {
     console.log("Fetched the document!", data);
 });

Methods

create(content,options)
POST /contents

Retrieves

Content

Description

Create a new content object with specified characteristics, and return an entity representing the newly created content object.

The specific JSON varies per type of content. Follow these links to see creation examples for each type of content:

Takes:
  • Content fields describing the new content
Options:
NameTypeRequiredDescription
fieldsStringfalseNames of the fields to be returned
Retrieves:
  • Content describing the newly created content
  • get(options)
    GET /contents

    Retrieves

    Content[]

    Description

    Return a paginated list of content object that match the specified criteria.

    Options:
    NameTypeRequiredDescription
    authorStringfalseURI of a person, limiting results to objects authored by this person
    entityDescriptorStringfalseComma delimited list of object type / object ID values (useful only for the Jive UI). When used other filters are not allowed
    countIntegerfalseMaximum number of objects to return (default is 25)
    fieldsStringfalseComma delimited list of the fields to be returned.
    placeStringfalseURI of a place, limiting results to objects contained in that place
    searchStringfalseOne or more search terms separated by commas, limiting results to objects that match the terms
    startIndexIntegerfalseZero-relative index of the first content object to be returned
    tagStringfalseComma delimited list of tag values, limiting results to objects with one of those tags
    typeStringfalseComma delimited list of content object types, limiting results to objects of those types
    Retrieves:
  • Content[] Paginated list of matching content objects
  • get(options)
    GET /contents/{uri}

    Retrieves

    Content

    Description

    Return a single content object by its URI.

    Options:
    NameTypeRequiredDescription
    uriStringtrueURI of the content object to get
    fieldsStringfalseNames of the fields to be returned
    Retrieves:
  • Content Representation of the requested content object
  • getPopularContent(options)
    GET /contents/popular

    Retrieves

    Content[]

    Description

    Return a list of popular content objects for the authenticated user. Use this service when recommendation is disabled. Use getPropertyMetadata({name:'feature.recommender.enabled'}) to figure out whether recommendation service is enabled or not.

    Options:
    NameTypeRequiredDescription
    fieldsStringfalseNames of the fields to be returned
    Retrieves:
  • Content[] List of matching content objects
  • Since: 3.1
    getRecommendedContent(options)
    GET /contents/recommended

    Retrieves

    Content[]

    Description

    Return a list of recommended content objects for the authenticated user. When recommender service is not enabled in the Jive instance then predefined recommended content is going to be returned instead. Use getPropertyMetadata({name:'feature.recommender.enabled'}) to figure out whether recommendation service is enabled or not.

    Options:
    NameTypeRequiredDescription
    countIntegerfalseMaximum number of objects to return (default is 25)
    fieldsStringfalseNames of the fields to be returned
    Retrieves:
  • Content[] List of matching content objects
  • Since: 3.1
    getTrendingContent(options)
    GET /contents/trending

    Retrieves

    Content[]

    Description

    Return a list of trending content objects that match the specified filter criteria. It's possible for some Jive instances to have recommendation disabled, for these cases use getPopularContent() instead. Use getPropertyMetadata({name:'feature.recommender.enabled'}) to figure out whether recommendation service is enabled or not.

    Options:
    NameTypeRequiredDescription
    countIntegerfalseMaximum number of objects to return (default is 25)
    fieldsStringfalseNames of the fields to be returned
    placeStringfalseURI of a place, limiting results to objects contained in that place
    typeStringfalseComma delimited list of content object types, limiting results to objects of those types
    Retrieves:
  • Content[] List of matching content objects
  • Since: 3.1
    search(options)
    GET /search/contents

    Retrieves

    Object[]

    Description

    Search for and return content objects that match the specified filter criteria.

    Options:
    NameTypeRequiredDescription
    afterStringfalseSelect content objects modified after the specified date/time
    authorStringfalseSelect content objects authored by the specified person. The parameter value must be either a full or partial (starting with "/people/") URI for the desired person
    beforeStringfalseSelect content objects last modified before the specified date/time
    countIntegerfalseMaximum number of results to be returned
    fieldsStringfalseNames of the fields to be returned
    morelikeStringfalseSelect content objects that are similar to the specified content object. The parameter value must be either a full or partial (starting with "/contents/") URI of the specified content object.
    placeStringfalseSelect content objects that are contained in the specified place or places. The parameter value must be one or more (comma separated) either full or partial (starting with "/places/") URI of the specified place(s).
    searchStringtruesearch One or more search terms, separated by commas. You must escape any of the following special characters embedded in the search terms: comma (","), backslash ("\"), left parenthesis ("("), and right parenthesis(")"), by preceding them with a backslash. Wildcards can be used, e.g. to search by substring use "*someSubstring*".
    startIndexIntegerfalseZero relative index of the first search result to be returned
    subjectonlyStringfalseFlag indicating whether or not to limit search results to only content objects whose subject matches the search keywords. Defaults to true.
    typeStringfalseSelect content objects that are of one of the specified types (separated by commas). Defaults to all available content types.
    Retrieves:
  • Contents[] that are decorated with search result specific fields (highlightBody, highlightSubject, highlightTags, parentContent, parentPlace)