Yammer
Table of contents
Description
Source to access data for a yammer network with dedicated support for writing back comments and likes.
Responsible Person
Status
Status | Ready for Use |
|---|
Possible Values: Ready for Use, In Development, Plannend, Broken
Aggregation Features
Fill | Yes |
|---|---|
Update | Yes |
Enrich | No |
Source Code
Project: https://github.com/soziotech/CommunityMashup/tree/master/sources/YammerSourceService
Tracking
Planned Todos
Bugs
Feature Request
Used Service
Name | Yammer |
|---|---|
Link | |
Developer Portal | |
| Api Documentation | http://developer.yammer.com/api/ |
Authentication | OAuth |
Used Libraries
Name | Version | License | Usage | Link |
|---|---|---|---|---|
Scribe OAuth | 1.3.0 | MIT License | Compiled | |
| Google gson | 2.1 | Apache Licence 2.0 | Compiled | http://code.google.com/p/google-gson/ |
Possible Usage Values: Compiled, Source, Extended Source, Modified Source
Configuration
Key | Description | Possible Values | Default | Required (Yes/No) |
|---|---|---|---|---|
consumerKey | Consumer key for authentication. | Text | empty | Yes |
| consumerSecret | Consumer secret for authentication. | Text | empty | Yes |
| accessToken | Access token of authenticated user. The access token will be generated by yammer for one network. So the provided access token determines the network a source accesses. | Text | empty | Yes |
| accessTokenSecret | Access token secret of authenticated user. | Text | empty | Yes |
| commandLineAuthentication | Switch to turn on a command line authentication with mendeley. This should only be used in development environments. The access token and its secret should be empty in this case. | true/false | false | No |
| messageBodyType | The type of the message body. | plain, parsed, rich | plain | No |
| loadAllUsers | If this property is set to true than all available users will be loaded. | true/false | false | No |
| initialNumberOfMessages | Defines the number of messages that should be loaded initially. | 1..n | 10 | No |
| newestMessageId | Keeps the newest loaded message id, dont set manually. | true/false | false | No |
| writeBackComments | If set to true, then comments will be written back to yammer. | true/false | false | No |
| writeBackLikes | If set to true, then likes will be written back to yammer. | true/false | false | No |
| writeWithAccountOwner | If set to true, then the account owner will be used as user for likes and comments if not author is set. | true/false | false | No |
| waitBetweenAPIRequests | Time to wait between api requests in seconds. Only used if an operation needs more than one api call. | true/false | false | No |
| loadNewestLikes | If set to true, then it will be polled for new likes. | true/false | false | No |
Example:
<sources bundleId="org.sociotech.communitymashup.source.YammerSourceService" name="Yammer">
<configuration>
<properties Key="consumerKey" Value="-"/>
<properties Key="consumerSecret" Value="-"/>
<properties Key="accessToken" Value="-"/>
<properties Key="accessTokenSecret" Value="-"/>
<properties Key="messageBodyType" Value="plain"/>
<properties Key="loadAllUsers" Value="false"/>
<properties Key="initialNumberOfMessages" Value="80"/>
<properties Key="writeBackComments" Value="false"/>
<properties Key="writeBackLikes" Value="false"/>
<properties Key="waitBetweenAPIRequests" Value="3"/>
</configuration>
</sources>
Description | Initially loads the newest 80 messages and creates persons for the authors. It automatically updates and adds all new messages. The overall number of messages is not restricted to 80. Note: access token and secret as well as consumer key and secret must be replaced to run this configuration. |
|---|
Meta-Informations
Type | Description | Value | Items |
|---|---|---|---|
MetaTag | Meta tag for all items of a yammer source | yammer | Items |
| MetaTag | Meta tag for all Organisations created for departments. | department | Organisations |
Transformation
External | CommunityMashup |
|---|---|
Message | Content |
| Shortened message body | Name of content |
| Message creation date | Content creation date |
| Messages type | Meta tag added to Content |
| Hashtags in content, Topics of content | Tags added to Content |
| Replies to message | Subcontents of Content |
| Likes of message | Thumb Up added to Content |
| Liker of message | Ranker of Thumb Up |
| Message author | Person, author of Content |
| Department in author profile | Organisation with Person as participant |
| Author profile image | Image attached to person |
| Job title of author | Tag of person |