Yammer widgets

From SpinetiX Support Wiki

Jump to: navigation, search

This page is related to Elementi 2018 Widgets.

Introduction

The new Elementi Yammer widgets help you enable and nurture an open modern culture through employee dialogue: a true breeding ground for innovation. These widgets can be used to display data provided by Yammer - an online social networking service that enables users to send and read messages called "posts".

"Info"
Security is a fundamental element to consider when giving access to your personal data and we've created our data-driven widgets with that in mind. To ensure secure access and permission control, without exposing any user credentials, Cockpit must authorize any request for third-party data. For that, you need to do the following:
  1. Create a Cockpit account, if you don't have one.
  2. Register your Elementi license into your Cockpit account.
  3. Add your players into your Cockpit account.
  4. Connect your Yammer account to your Cockpit account.

Yammer widgets

Under the "Yammer" folder of Elementi 2017 Widgets, you can find seven ready-to-use widgets that automatically display data extracted from a Yammer data source:

Yammer feed widgets
  • Single Post
    Displays a single post using pre-formatted design. The posts are displayed one after another, with or without a transition effect in between, similarly to a playlist.
    Note that only post with images are displayed with this widget.
  • Multi Post
    Displays a one or more post on the same page using pre-formatted design. The posts are displayed one after another, with or without a transition effect in between, similarly to a playlist.
    Note that all post with some text are displayed by this widget.
  • Text Bar
    Displays text content using a fixed number of lines and applying a bottom-to-top & line-by-line scrolling effect whenever the entire text doesn't fit into the widget area.
  • Text Ticker
    Displays text content using a continuous horizontal scrolling effect. The font size is adjusted automatically for the text to fit into the widget area.
  • Text Roll
    Displays text content using a continuous vertical scrolling effect. The font size is adjusted automatically for the selected number of lines to fit into the predefined area.
  • Slideshow
    Displays slides composed of tweet & media layers, which are automatically filled out with data retrieved from Yammer. The slides are displayed one after another, with or without a transition effect in between, similarly to a playlist.
  • Horizontal Table, Vertical Table, and Table
    Displays slides composed of multiple cells of text & media layers, which are automatically filled out with data retrieved from Yammer. The slides are displayed one after another, with or without a transition effect in between, similarly to a playlist.


Note Notes:
  • These widgets can only be used on a single screen when creating a multiscreen project.
  • Any formatting present within the post is discarded and you can customize how the text appears on the screen within Elementi. If you want to keep the white spaces, simply use [[raw]] data field instead of the default [[text]], which doesn't keep the white spaces.

Configuration

Each of the widgets above can be customized using the options provided under "Properties" tab - for more details go to the dedicated page of each widget type, linked above.

Date Properties Dialog

To edit the properties related to the data source, click on the Data Feed Properties button. This opens the "Data Properties" dialog, which allows changing the following:

  • Account
    Select one of the connected Yammer accounts or click "Connect account..." if none was previously connected.
  • Timeline
    Select the data to be displayed between "Home timeline", "Followed by me", "Posted by me", "Mentions of me", "In Group", "About Topic", "Yammer Search".
  • Max count
    Max number of posts to be retrieved.
  • Refresh
    Enter a number, optionally followed by s (implicit), m or h, to specify the period after which the widget should refresh the feed data (this is useful especially when the widget is running in a loop); the minimum accepted value is 60 seconds. Using "When document opens" will refresh the data only when the document is re-opened.


Note Note:
At any point, the data source configuration can be tested by clicking on the "Test..." button.

Yammer channel connection

Using the Yammer widgets requires having your Yammer account connected with the Cockpit account where your Elementi license is registered. For that, follow these steps:

  1. Select the "Account" option as "Connect account...".
  2. Click the URL displayed within the "Connect Account..." dialog.
  3. Next, the Yammer sign-in page is opened; follow the steps on that page to sign into your Yammer account.
  4. Next, allow the SpinetiX app to access the specified information of your Yammer account.
  5. Return to Elementi and click the "OK" button within the "Connect Account..." dialog.
  6. At this point, your Yammer account appears in the "Account" drop-down box.


Note Note:
The Yammer account can be disconnected at any time from Cockpit from the "Channels" page.

Single Post Properties

The following properties, found under "Properties" tab, can be used to customize the widget:

  • Data
    Click on the Data Feed Properties button (it opens the Data Properties dialog for Yammer source). This let the user select the tweets to be displayed.
  • Slide duration
    Enter the number of seconds each tweet is displayed on the screen.
  • Transition
    Click on the Transition Properties button (it opens the "Transition Properties" dialog) and select a transition effect and its properties.
  • Looping
    Select whether the widget ends after the last tweet or loops to the first one.
  • Call to Action
    • Show
      Select whether the Yammer logo and the call to action text should be displayed or not.
    • Text
      Text to be displayed next to the Yammer logo.

Multi Post Properties

The following properties, found under "Properties" tab, can be used to customize the widget:

  • Data
    Click on the Data Feed Properties button (it opens the Data Properties dialog for Yammer source). This let the user select the tweets to be displayed.
  • Locale
    Select the locale used for displaying dates and numbers.
  • Slide duration
    Enter the number of seconds each slide of tweets is displayed on the screen.
  • Transition
    Click on the Transition Properties button (it opens the "Transition Properties" dialog) and select a transition effect and its properties.
  • Looping
    Select whether the widget ends after the last tweet or loops to the first one.
  • Number of rows
    Enter the number of tweets to display on a single slide.
  • Delay per cell
    Enter the number of seconds to wait before displaying the next cell of the table.
  • Call to Action
    • Show
      Select whether the Yammer logo and the call to action text should be displayed or not.
    • Text
      Text to be displayed next to the Yammer logo.

Troubleshooting

See also

This page was last modified on 27 June 2018, at 19:06.