Yammer Integration

Last modified on 2022/05/28 10:51

About this integration

SAS_IntegrationNotRESTIntroduction

You can integrate third-party systems with Service Apps in many ways. The method you select will depend on business requirements, architectural and security constraints as well as the characteristics specific to each third-party application or service. You can use the REST, CSV, Online CSV data sources and the HTML Script widget.

This document describes a standard integration process that has already been implemented in a customer context.

To find out more about this integration, please do not hesitate to contact your EasyVista contact, or your service provider and integrator.

Integration Summary

Yammer is a microblogging tool that offers companies or communities a free (basic version only) internal social network.
Yammer focuses on the main roles of an enterprise social network which are communication and collaboration.

This easy-to-implement integration enables you to embed a Yammer feed from your domain in an Product name - ev sas.png app using the widget of Yammer which can be integrated in a HTML Script widget. Yammer feeds include Group Feed, Topic Feed, User Feed, My Feed and Open Graph Object Feed.

As such, users of the app can see Yammer feeds, use the Like button, take part in discussions and reply directly via the HTML Script widget. These discussions will appear automatically in your Yammer domain and will be visible to connected users.
 

Integration Data Feed (direction) Authentication Type Integration Connector Options

Product name - ev sas - big.png

Up arrow.png

Logo - Yammer.png

N/A

HTML Script widget   Apps - Widget - Html icon.png

SaaS Version of Third-Party Product

On-premise Version of Third-Party Product

Check icon.png

Not check icon.png

Step-by-step integration process

Note

You can only use the HTML Script widget to embed Yammer feeds. The widgets of Yammer will not run in Secured HTML widgets.

Process 1: How to embed a Yammer feed via a HTML Script widget

     Open url.png  See the Yammer Developer Center:

Using this method, you can embed Yammer in Product name - ev sas.png in three easy steps:


Step 1: Check the list of requirements.

Before you can embed the widgets of Yammer, you must create a Yammer domain for your company with the relevant login and password.


Step 2: Select the Yammer group feed and retrieve the JavaScript code of the corresponding widget of Yammer.

1. Log in to your Yammer domain using your login and password.

2. Retrieve the code of the group feed:
         Yammer integration - Processus 1.png

  • Select the group you want from the list of Yammer groups (1).
  • In the Access Options section (2), click Embed this feed in your site.
  • Copy the JavaScript code displayed (3).


Step 3: Embed the JavaScript code of the widget of Yammer in an Product name - ev sas.png app to display the feed.

1. Go to Product name - ev sas.png and open the app you want.

2. Display the Yammer group feed as described in step 2 using a HTML Script widget:

  • Click Apps - Add widget icon.png in the Objects pane. Open the Basic category and click and drag the HTML Script widget to the Design pane.
  • Rename the widget so you can easily identify it.
  • Paste the JavaScript code obtained in step 2 in the HTML Code field.
  • If required, add a header in Theme > Header.
  • Adjust the height and width of the widget in the Design pane.

3. Click EVApps - GUI - Execute icon.png to switch to preview mode and check the visual layout of the Yammer group feed and that it is working correctly.

Process 2: How to embed a Yammer feed via the configuration wizard of the widget of Yammer

Yammer offers numerous widget configuration possibilities using a Plug & Play configuration wizard for embedding Group Feed, Topic Feed, User Feed, My Feed or Open Graph Object Feed.

Example documentation icon EN.png  In a new discussion, replace the default message, Share something with this group... by a customized message.

Using this method, you can integrate Yammer in Product name - ev sas.png in three easy steps:


Step 1: Check the list of requirements.

Before you can embed the widgets of Yammer, you must create a Yammer domain for your company with the relevant login and password.


Step 2: Configure the widget of Yammer and retrieve the corresponding code.

1. Go to the configuration wizard URL of the widget of Yammer.

2. Configure the URL. To do this, you can use the online help pages below:

3. Retrieve the JavaScript code of the widget of Yammer:
         Yammer integration - Processus 2.png

  • Click [ APPLY CHANGES ] to apply the configuration.
  • Copy the entire code displayed in the Example code box.


Step 3: Embed the JavaScript code of the widget of Yammer in an Product name - ev sas.png app to display the feed.

1. Go to Product name - ev sas.png and open the app you want.

2. Display the Yammer feed as described in step 2 using a HTML Script widget:

  • Click Apps - Add widget icon.png in the Objects pane. Open the Basic category and click and drag the HTML Script widget to the Design pane.
  • Rename the widget so you can easily identify it.
  • Paste the JavaScript code obtained in step 2 in the HTML Code field.
  • Add HTML tags to display the widget.

Note: Unlike integration process 1 which provides the entire code to be inserted in the HTML Script widget, this process enables you to obtain only the JavaScript code. This code must be completed in order to display the HTML Script widget correctly.
To complete this code quickly, you can follow steps 2 and 3 in integration process 1. Next, you should replace the HTML code located between the <script type="text/javascript"></script> tags by the JavaScript code obtained in step 2.
         Example documentation icon EN.png

<div id="embedded-feed" style="height:100%;width:100%;"></div>
<script type="text/javascript" src="https://s0.assets-yammer.com/assets/platform_embed.js"></script>
<script type="text/javascript">

yam.connect.embedFeed({
     "network": "easyvista.com",
     "feedType": "group",
     "feedId": 46XYZ,
     "config": {
         "use_sso": true,
         "header": true,
         "footer": true,
         "showOpenGraphPreview": false,
         "defaultToCanonical": true,
         "hideNetworkName": false,
         "promptText": "Comment Sales Figures Here"
     },
     "container": "#embedded-feed"
});

</script>

  • If required, add a header in Theme > Header.
  • Adjust the height and width of the widget in the Design pane.

3. Click EVApps - GUI - Execute icon.png to switch to preview mode and check the visual layout of the Yammer feed and that it is working correctly.

Best Practice big icon.pngBest practice

  • By default, the width and height of the widget of Yammer are respectively 400 and 800 pixels. If you want the widget of Yammer to occupy the entire width of the HTML Script widget without any vertical scroll bar, you should set the width and height = 100% (HTML Code field).
    Note: Yammer recommends using a widget with a minimum width of 400 pixels.

Use case and integration video

*

This video presents an example of how to embed a Yammer group feed called Sales Dashboard Discussion Group in an Product name - ev sas.png app, including dashboards on corporate sales figures. This feed enables users to comment on sales figures in real time by adding or replying to discussions.

This is an illustration of integration process 1 on: 

  • How to create a discussion group, Sales Dashboard Discussion Group for commenting on dashboards.
  • How to embed a Yammer group feed in a HTML Script widget placed in the app dashboards.
Tags:
Powered by XWiki © EasyVista 2022