| Attributes | Values |
|---|
| type
| |
| Date Created
| |
| Date Modified
| |
| label
| |
| maker
| |
| Title
| |
| isDescribedUsing
| |
| has creator
| |
| attachment
| |
| content
| - %VOSWARNING%
%VOSNAV%
---++ ODS Facebook Integration
The [[FacebookAPI][Facebook API as User Defined Type (UDT)]] is the basis of ODS Facebook integration.
---++Administrator's Integration Guide
* <i><b>Note:</b> The steps below must be performed while logged in as the ODS Administrator (e.g., <code>dba</code>); regular users will then be able to use their Facebook data without doing any of this themselves.</i>
1. Create a <nowiki>FaceBook</nowiki> ("FB") account [[http://www.facebook.com][here]].
1. Add a Facebook developer application (from [[http://www.facebook.com/developers/editapp.php?new][this location]]) to the FB account created above, by performing the following steps:
1. Set the "Callback URL" field to:
<verbatim>
http://[host]:[port]/ods
</verbatim>
1. Specify "Canvas Page URL" field value; this is the Facebook URL where the application will be available.
1. Check the "Use iframe" radio-box.
1. After the application is created successfully, copy the generated API key and Secret values shown bellow the FB application. The Key and the Secret values can also be found [[http://www.facebook.com/developers/apps.php][here]].
1. Install the <code><nowiki>ods_framework_dav.vad</nowiki></code> and the <code><nowiki>rdf_mappers_dav.vad</nowiki></code> packages on a running Virtuoso database, using either the Conductor UI or the iSQL tool.
1. Login as the <code>dba</code> user.
1. Click the name of the <code>dba</code> user, shown as a link.
1. Go to "Edit My Profile"-> "Applications and Web Services" tab.
1. Enter the values from above for the <code><nowiki>key={this is the API key from the FB site}</nowiki></code> and <code><nowiki>secret={this is the secret from the FB site}</nowiki></code> values in the Facebook text-area.
1. Press "Save".
1. After successful execution of this list of actions integration setup is complete.
---++User Interface
* <i><b>Note:</b> The steps below can be performed by each ODS user after the <b>Administrator's Integration Guide</b> steps above have been completed by the ODS Administrator (e.g., <code>dba</code>).</i>
1. Login as an ODS user in <code><nowiki>http://[host]:[port]/ods</nowiki></code>
1. Click the ODS icon in the beginning of the ODS Navigation bar.
1. You will be redirected to you ODS Home page (<code><nowiki>myhome.vspx</nowiki></code>). In the second line of the ODS-BAR (header), next to the links "Edit my profile" and "My applications", you should see the link "My Facebook".
%BR%%BR%<img src="%ATTACHURLPATH%/fb1.png" style="wikiautogen"/>%BR%%BR%
<i><b>Note:</b> You may need to make sure your ODS bar is set to full mode (by clicking the arrow shown at the left of the ODS Menu bar).</i>
1. Click the link "My Facebook".
1. You should be redirected to the Facebook front page in ODS with URL:
<verbatim>
http://[host]:[port]/ods/fb_front.vspx
</verbatim>
%BR%%BR%<img src="%ATTACHURLPATH%/fb2.png" style="wikiautogen"/>%BR%%BR%
Note:
* The link "My Facebook" will be shown for all regular users once the ODS Administrator has performed the steps from the <b>Administrator's Integration Guide</b>.
* ODS depends on the "<code>dba</code>" Facebook setting and will ignore any regular user setting when it generates data for <code>fb_front.vspx</code>.
* Data generated on <code>fb_front.vspx</code> corresponds to the user that is logged to Facebook, not to the user that created the development application.
---+++ Functionality of the <code><nowiki>fb_front.vspx</nowiki></code> page:
* If the Facebook and ODS accounts are not associated, or if only one account is registered:
* ODS user is given information about the Facebook user that is currently logged to Facebook (from that same browser)
* ODS user is given information about the Facebook user's friends
* ODS user is given information about status of Facebook to ODS user integration
* ODS user is able create a new ODS user that is automatically associated with the Facebook account.
* ODS user is able to associate their ODS account with the logged-in Facebook account
* If the ODS user has Facebook and ODS accounts which are associated.
* ODS user is able to disassociate the Facebook account from the ODS account
* ODS user is able create <nowiki>ODS-AddressBook</nowiki> and to import Facebook friends as contacts in it.
* ODS user is able to update their <nowiki>ODS-AddressBook</nowiki> (that already exists) contacts based on Facebook friends info.
* Data for Facebook friends of the logged-in user is automatically imported as RDF.
* Information is updated each time user goes to this page.
* After successful RDF data extraction, "rdf" icons - <img src="%ATTACHURLPATH%/rdf.png" style="wikiautogen"/> - alongside Facebook friend names become anchors that will render the RDF data about them which has been imported to Virtuoso RDF store.
---+++ Behavior of the "Synchronize All" page
1. Click the "Synchronize" link in the "ODS User info" block.
1. The "Synchronize all" interface will be opened.
%BR%%BR%<img src="%ATTACHURLPATH%/fb3.png" style="wikiautogen"/>%BR%%BR%
1. Click the "Synchronize All" button.
1. All existing contacts will be updated (using the first contact that matches synchronization criteria) in <nowiki>ODS-AddressBook</nowiki> using default/custom mapping.
1. 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.
---+++ Functionality of the "all contacts to synchronize" page
1. Click the "Show all contacts to synchronize" link.
1. The "all contacts to synchronize" page will be opened.
%BR%%BR%<img src="%ATTACHURLPATH%/fb4.png" style="wikiautogen"/>%BR%%BR%
1. 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 <nowiki>ODS-AddressBook</nowiki> contacts.
* By default, the first match is selected.
* The user can change the matching criteria for the synchronization.
* Facebook and <nowiki>ODS-AddressBook</nowiki> contacts are presented with links, so the data for them can be compared, and the right matching pair can be chosen.
1. There is a choice to use default or manual mapping for contact properties.
* The <b>Default mapping</b> can be set by clicking the link "Set Default Mapping".
1. This feature offers the ability to synchronize in groups.
1. When the Default mapping is set, you can click the "Default" button for contacts and proceed further.
* <b>Manual mapping</b> 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.
CategoryODS CategoryOpenSource CategoryVirtuoso CategoryHowTo CategoryFacebook CategoryOdsAddressBook CategoryAddressBook
%VOSCOPY%
|
| id
| - 753e9c18ee215b648c115b385813cc2c
|
| link
| |
| has container
| |
| http://rdfs.org/si...ices#has_services
| |
| atom:title
| |
| links to
| |
| atom:source
| |
| atom:author
| |
| atom:published
| |
| atom:updated
| |
| topic
| |
| is made
of | |
| is container of
of | |
| is link
of | |
| is http://rdfs.org/si...vices#services_of
of | |
| is links to
of | |
| is creator of
of | |
| is atom:entry
of | |
| is atom:contains
of | |
![[RDF Data]](/fct/images/sw-rdf-blue.png)
![[cxml]](/fct/images/cxml_doc.png)
![[csv]](/fct/images/csv_doc.png)
![[text]](/fct/images/ntriples_doc.png)
![[turtle]](/fct/images/n3turtle_doc.png)
![[ld+json]](/fct/images/jsonld_doc.png)
![[rdf+json]](/fct/images/json_doc.png)
![[rdf+xml]](/fct/images/xml_doc.png)
![[atom+xml]](/fct/images/atom_doc.png)
![[html]](/fct/images/html_doc.png)