Setting Up the Office 365 Integration Add-On

If you are a Jive Admin, you can install the SP-Online & 365 add-on in Jive so SharePoint Online receives information from Jive using webparts.

Once you install the SP-Online & 365 add-on, the SharePoint Site Collection Admin can refer to Installing Jive Webparts App to a Site Collection so they can install the webparts app.

You need to perform the following steps in Jive to install and configure the SP-Online & 365 add-on.

  1. As Jive admin, select your avatar > Add-ons.
  2. Look for the Jive for Office 365 Integration add-on under the Installed tab. If it isn't in that tab, it hasn't been installed yet. Look for it in the Available tab and click Install if it is there. If it isn't visible, you may need to contact Support to obtain and upload the package files.
  3. Navigate to Storage Management > Add Integration.
  4. Choose Office 365 Storage Integration.
  5. Provide a name for the integration. This is the name of the external storage users will select when they create a group and choose to connect it to a specific SharePoint site collection.
  6. Click Add.
  7. The Edit Instance Settings dialog opens, but if it doesn't, click Edit Settings.
  8. Provide the information Jive will use to connect with SharePoint Online:
    1. In the SharePoint's tenant root URL field, type the URL of the SharePoint server. You can find this URL by navigating to one of the sites in SharePoint you're planning to link to Jive, and copy the path up to the first forward slash. For example, if your site is located at https://mytenant.sharepoint.com/sites/site1/, type https://mytenant.sharepoint.com.
    2. In the Jive Connect token for this SharePoint tenant field, provide the access token that was created using the Jive-Office integration app you installed on the SharePoint side. You can see the token by clicking on the app from the site collection page in SharePoint Online that was created to contain the Jive-linked sites.
      Warning: The app inherits the permissions of any user who clicks on the app. Do not click the app unless you are logged into SharePoint online as the Jive-SharePoint integration user as described in Setting Up the SharePoint Side.
    3. (Optional) In the SharePoint "everyone" user group field, type the name of the Everyone permissions group in SharePoint. If you specify this group, the users included will have read-write access to all content created in an Open group in Jive, even if they have not been added to the Jive group. This saves admins the work of having to add members to Open group content to grant access on the SharePoint side. (Secret, Private, and Members-Only groups restrict content on both sides of the integration according to the Jive-side group settings, regardless of whether you supply Everyone information here.) See Jive and SharePoint Permissions for more information.
    4. (Optional) In the SharePoint "full control (admins)" user group field, type the name of the Full Control admins permissions group in SharePoint. This group will have access to all SharePoint-connected groups in Jive. The best practice is to create a restricted group of admins in this principal who will be able to access all the Jive places and Jive-linked site collections. See Jive and SharePoint Permissions for more information.
    5. If you want users creating a place to be restricted to specific site collections, click the + sign under Site collections list available for creating places and type the location of a site collection. You can add more site collections by clicking + again. Users can choose from the list of site collections when creating a group. Note that as the user configuring the add-on, you must have access to these site collections, or you won't be able to complete the configuration and will see a configuration error.
      CAUTION:
      Specifying at least one site collection is the best practice, because it limits the SharePoint locations where place creators can create sites, and also prevents errors in specifying a URL. If you specify one or more locations, users are not prompted to supply the URL of a site collection.
  9. Click Validate Authorization.
  10. Your storage instance is now connected. Click Save Changes.
    When users create new groups in your community, they will now be able to select the integration you just created as the external storage location. For each connected group, Jive creates a new site under the site collection URL you specified.