ODS Facebook Integration Guide

An ODS Instance Administrator may register that Instance as a Facebook Client Application.

Users of the ODS Instance can then link their ODS account with their Facebook account, allowing them to log in to ODS using their Facebook credentials, and/or integrate ODS content and services with Facebook content and services.

Below, we discuss how to enable and use these features.

Setup

First, the ODS Instance Administrator must register the Instance as a Facebook App.

Then, any ODS User may link their ODS account with their Facebook account.

User Interface

  1. Authenticate in ODS using your Facebook account
  2. Once logged in as your Facebook account, will be shown your ODS home page. Click the presented Facebook link.



  3. You should be redirected to the Facebook front page in ODS:



The "Synchronize All" Feature

  1. Click the "Synchronize" link from the "ODS User info" block.
  2. The "Synchronize all" interface should be opened.



  3. Click the "Synchronize All" button.
  4. As result all existing contacts should be updated (using the first contact that matches synchronization criteria) in ODS-AddressBook with default/custom mapping.
  5. The user is able to set a custom mapping for synchronization using the "Set default mapping" block. If the user does not set custom mapping, then the default mapping will be used.

The "All Contacts to Synchronize" Feature

  1. Click the "Show all contacts to synchronize" link.



  2. The user is offered the option to synchronize his/her contacts one-by-one.
    • The UI presents separate blocks for each FB friend.
    • The user is offered all available field value matches for Facebook friends in their ODS-AddressBook contacts.
    • By default, the first match is selected.
    • The user can change the matching criteria for the synchronization.
    • Facebook and ODS-AddressBook contacts are presented with links, so the data for them can be compared, and the right matching pair can be chosen.
  3. There is a choice to use default or manual mapping for contact properties.
    • The Default mapping can be set by clicking the link "Set Default Mapping".
      1. This feature offers the ability to synchronize in groups.
      2. When the Default mapping is set, you can click the "Default" button for contacts and proceed further.
    • Manual mapping can be set by clicking the "Manual" button from the combo button available for each user.
      1. The user will be asked to set mapping, and then contact synchronization is executed.

Related

CategoryODS CategoryOpenSource CategoryVirtuoso CategoryHowTo CategoryOdsAddressBook CategoryAddressBook