Adding a SharePoint Location

Once you have installed the SharePoint Connector plugin as described in Installing the Jive SharePoint Connector Plugin and installed the SharePoint components as described in Installing the Jive SBS SharePoint Connector, then you are ready to configure SharePoint Locations. A SharePoint Location is a reference to a SharePoint site. It allows Jive to be aware of the SharePoint site and all of its sub-sites.

When you add or update a SharePoint Location, the plugin will add or update a corresponding OpenSearch Engine item, which is used to implement the SharePoint Search functionality. Any changes to your search configuration should be performed on the SharePoint Location itself, which will be automatically copied to the OpenSearch Engine item for you.

Once a SharePoint Location is configured, a Jive installation is configured in SharePoint, and socialization is enabled in corporate policies, a SharePoint site administrator can socialize a site to Jive, allowing SharePoint activity to show in Jive and lighting up the SharePoint widgets within Jive.

1. Click Add SharePoint Location. Alternatively, click the Edit button next to an existing SharePoint Location to update.
   Note: You can add as many SharePoint locations as you like, but one external/internal URL cannot start with the entire contents of another. For example, you can have http://sharepoint/sites/projectA and http://sharepoint/sites/projectB as two SharePoint Locations, but you cannot have http://sharepoint and http://sharepoint/sites/projectB as two SharePoint Locations. In the latter case the http://sharepoint/sites/projectB started with the entire contents of http://sharepoint. For this case you can just have one SharePoint Location (http://sharepoint) to handle all of the sites.
2. Complete the following required fields, including a Username and Password.
   • Name: Free form name to use as a reference for the specified SharePoint location.
   • SharePoint Location External URL: URL to a SharePoint site as accessed by users. This is used for links referencing SharePoint provided in the browser to Jive users. This URL must resolve to a page accessible by users. This will allow any SharePoint sites under the referenced site to be accessible by Jive.
   • SharePoint Location Internal URL: URL to a SharePoint site as accessed by Jive. In most cases, this will be identical to the external URL above. However, this allows server-to-server communications to occur through a different handler on the SharePoint server(s) (a different IIS web site through the use of extended web applications). This allows for more flexibility in how security is handled for end users vs. Jive web service requests.
   • External Search URL: URL to a SharePoint search results page. The easiest way to determine the correct value:
     • Log on to your SharePoint site.
     • Find the search box (typically at the top right corner of the page).
     • Type in a search term and press Enter.
     • Cut and paste the URL from the Search Results page into this field.
     • Manually remove everything from a question mark ("?") character to the end of this value.
     • Append ?k={searchTerms} to the URL, to ensure that the search terms you are using will be forwarded to SharePoint.
   • Query Test Term: Enter a test phrase that will return results from SharePoint when a search is performed.
   • Username: SharePoint service account. This must be a valid account with read access to the site designated by the external/internal URLs above. It also must have read access to any sub-site socialized to Jive. Note that this could even be different site collections as discussed in the note further above. Typically this username is in the format of <domain>\<user>.
   • Password: SharePoint user password for related Username.
   • Enabled: Select box to enable SharePoint
   • Search Result Content Type: Atom (only choice currently available).
   Note: For the URL items above, please ensure each URL resolves through DNS. If DNS does not resolve the URL, update the hosts file on the Jive server(s) instead of using an IP address. Using an IP address for SharePoint it is not optimal and may cause issues related to Alternate Access Mappings on the SharePoint server. This will show up in the SharePoint trace log and System event log and may prevent some features of the connector from working properly.
   
   
   
3. Once the SharePoint Location has been saved, you a screen similar to the following screen.
   
   
   Note: You need to see the "SharePoint location tested successfully" message before using the new SharePoint-centric widgets and socialization features.