osapi.jive.corev3.extstreams.ExternalStreamInstance

An External Stream Instance represents a configured External Stream Definition that has been attached to a Purposeful Place. It also contains configuration information returned by the configuration UI.

 {
    "id":"1032",
    "displayName":"External Stream",
    "config": {
        "configProp1":"abcd",
        "configProp2":"1234"
    },
    "definition":{
        //External stream definition JSON
       "type":"extStreamDefinition"
    },
    "parent":"http://example.jiveon.com/api/core/v3/places/1037",
    "state":"STAGED",
    "type":"externalStreamInstance",
    "published":"2013-01-25T20:03:08.702+0000",
    "updated":"2013-01-25T20:03:08.702+0000",
    "resources":{
       "self":{
          "allowed":[
             "POST",
             "GET"
          ],
          "ref":"http://example.jiveon.com/api/core/v3/extstreams/1032"
       }
    }
 }

Properties

PropertyTypeMode Description
columnIntegeroptional
The column in which this instance is going to appear in the parent.
configObjectoptional
Configuration of this instance in JSON format. JSON format depends on the needs of each instance. When creating or updating this instance, it is possible to include an extra field forceResendRegistration of type boolean that indicates whether a registration notification should be sent to the external system or not.
definitionExternalStreamDefinitionrequired
The definition type this External Stream Instance belongs to.
displayNameStringoptional

Display name of the External Stream Instance

externalIdStringoptional
An external identifier assigned to this instance. This identifier can be used to access this instance instead of it's id.
followerCountIntegerread-only

Number of people following this object.

Availability:

Will be present only for object types that support being followed.

idStringread-only

Identifier (unique within an object type and Jive instance) of this object. This field is internal to Jive.

isFollowedBooleanread-only

Whether the current user is following this object.

Availability:

Will be present only for object types that support being followed.

lastActivityPostISO 8601 Dateread-only
Date and time of the last time activity was created for this External Stream Instance.
Since: 3.11
lastRegisterISO 8601 Dateread-only
Date and time of the last time a registered notification was sent to the external system that is integrating with Jive.
likeCountIntegerread-only

Number of people who have liked this object.

Availability:

Will be present only for object types that support being liked.

parentStringread-only

URI of the parent place of this instance.

publishedISO 8601 Dateread-only

Date and time this object was originally created.

publishErrorObjectread-only
Information about the error that happened while publishing data or activity into this tile. If no error happened in the last publish activity then this field is not going to be present.
Availability:

Will be present only for community admins.

Since: 3.11
resourcesObjectread-only

Resource links (and related permissions for the requesting person) relevant to this object.

stateStringoptional
State of this instance. Possible values are:
  • STAGED - Not configured yet. Default value.
  • VISIBLE - Configured and ready to be used
statusObjectread-only
Status of this instance when activity was published in JSON format.
tagsString[]optional

Tags associated with this object.

Availability:

Will be present only for object types that support tags

typeStringread-only
typeCodeIntegerread-only
updatedISO 8601 Dateread-only

Date and time this object was most recently updated.

→ Fields used by update and create operations
→ Fields used only by create operations
→ Fields not used by update or create operations

Methods

getPrivateProps()
GET /exstreams/1234/privateprops

Retrieves

Object

Description

Retrieves private properties for this TileInstance

updatePrivateProps(object)
POST /tiles/1234/privateprops

Retrieves

Object

Description

Updates private properties for this TileInstance

Resources

ResourceMethodReturnsDescription
selfGETExternalStreamInstance

Return an updated version of this external stream instance.