<docbook><section><title>ODSSWATOTutorial</title><title> SWAT0 in terms of ODS functionality Tutorial</title> SWAT0 in terms of ODS functionality Tutorial
<bridgehead class="http://www.w3.org/1999/xhtml:h2">Actors</bridgehead>
 <orderedlist spacing="compact"><listitem>Demo (a Person) owns a Personal Data Space that includes data spaces for structured Profile and Weblog oriented data.
</listitem>
<listitem>John (a Person) owns a Personal Data Space that primarily includes structured profile data.
</listitem>
<listitem>Mary (a Person) owns a Personal Data Space that primarily includes Feed subscriptions to Demo&#39;s Weblog.</listitem>
</orderedlist><para>This tutorial demonstrates the use of ODS functionality to deliver on the SWAT0 open social web usecase where the following activities occur:</para>
<orderedlist spacing="compact"><listitem>Demo creates a blog entry that mentions John.
</listitem>
<listitem>John receives notification about the blog entry.
</listitem>
<listitem>Mary receives notification via her subscription to Demo&#39;s weblog.</listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h2">ODS functionality in use</bridgehead>
<itemizedlist mark="bullet" spacing="compact"><listitem>Content Creation (Blog Post).
</listitem>
<listitem>Mobile Blogging (use of Email messaging to create content e.g.
 Photos captured on a mobile phone which are emailed to Weblog data space).
</listitem>
<listitem>Notifications (via Semantic Pingback mechanism).</listitem>
</itemizedlist><bridgehead class="http://www.w3.org/1999/xhtml:h2">ODS Setup Steps</bridgehead>
<bridgehead class="http://www.w3.org/1999/xhtml:h3"> Prerequisites</bridgehead>
<orderedlist spacing="compact"><listitem>Make sure the following packages are installed: <itemizedlist mark="bullet" spacing="compact"><listitem><ulink url="https://virtuoso.openlinksw.com/download/">ods_framework_dav.vad</ulink> </listitem>
<listitem><ulink url="https://virtuoso.openlinksw.com/download/">ods_blog_dav.vad</ulink> </listitem>
<listitem><ulink url="https://virtuoso.openlinksw.com/download/">ods_feedmanager_dav.vad</ulink> </listitem>
</itemizedlist></listitem>
<listitem>Also make sure your virtuoso.ini file has the following settings: <programlisting>...
[HTTPServer]
DefaultMailServer           = mail.openlinksw.com:25
</programlisting><itemizedlist mark="bullet" spacing="compact"><listitem>Note: you can also follow <ulink url="OdsMailInstallGuide">these</ulink> steps.
</listitem>
</itemizedlist></listitem>
<listitem>Go to <ulink url="http://cname/ods">http://cname/ods</ulink> and register a user with the name <emphasis>demo</emphasis>.
<figure><graphic fileref="ODSSWATOTutorial/sw19.png" /></figure> </listitem>
<listitem>Go to <ulink url="http://cname/ods">http://cname/ods</ulink> and register a user with name <emphasis>john</emphasis>.
<figure><graphic fileref="ODSSWATOTutorial/sw18.png" /></figure> </listitem>
<listitem>Go to <ulink url="http://cname/ods">http://cname/ods</ulink> and register a user with name <emphasis>mary</emphasis>.
<figure><graphic fileref="ODSSWATOTutorial/sw17.png" /></figure> <itemizedlist mark="bullet" spacing="compact"><listitem>Note: all e-mails should be valid, as they are going to be used later in this tutorial.</listitem>
</itemizedlist></listitem>
</orderedlist><para> </para>
<bridgehead class="http://www.w3.org/1999/xhtml:h3"> Demo&#39;s Activities</bridgehead>
<orderedlist spacing="compact"><listitem>Go to <ulink url="http://cname/ods">http://cname/ods</ulink> and log in as user <emphasis>demo</emphasis>.
</listitem>
<listitem>Click &quot;Weblog&quot; from the left vertical navigation, which will result in a Weblog instance being created.
</listitem>
<listitem>Go to Application Settings -&gt; Application Management.
<figure><graphic fileref="ODSSWATOTutorial/sw1.png" /></figure> </listitem>
<listitem>Click &quot;Edit&quot; for user demo&#39;s Weblog instance.
<figure><graphic fileref="ODSSWATOTutorial/sw2.png" /></figure> </listitem>
<listitem>In the form displayed change: <itemizedlist mark="bullet" spacing="compact"><listitem>Member model: to &quot;Open&quot;; </listitem>
<listitem>Hatch the &quot;Visible to public&quot; check-box <figure><graphic fileref="ODSSWATOTutorial/sw3.png" /></figure> </listitem>
</itemizedlist></listitem>
<listitem>Click &quot;Save&quot;.
</listitem>
<listitem>Go to Application Settings -&gt; Semantic Pingback.
<figure><graphic fileref="ODSSWATOTutorial/sw4.png" /></figure> </listitem>
<listitem>In the form displayed: <itemizedlist mark="bullet" spacing="compact"><listitem>Select for &quot;Application name&quot; the name of the created from above demo&#39;s Weblog instance; </listitem>
<listitem>Enter a valid e-mail address for notification: <figure><graphic fileref="ODSSWATOTutorial/sw5.png" /></figure> </listitem>
</itemizedlist></listitem>
<listitem>Click &quot;Add&quot;.
<figure><graphic fileref="ODSSWATOTutorial/sw6.png" /></figure> </listitem>
<listitem>Go to Application Settings -&gt; Content Hyperlinking.
<figure><graphic fileref="ODSSWATOTutorial/sw7.png" /></figure> </listitem>
<listitem>In the form displayed: <itemizedlist mark="bullet" spacing="compact"><listitem>Enter for &quot;Phrase&quot;: &#39;@john&#39;; </listitem>
<listitem>Enter for &quot;URI&quot;: <ulink url="http://cname/dataspace/person/john#this">http://cname/dataspace/person/john#this</ulink>  . i.e.
 here we setup automated hyperlinking to user &#39;john&#39; by his profile IRI.
<figure><graphic fileref="ODSSWATOTutorial/sw8.png" /></figure> </listitem>
</itemizedlist></listitem>
<listitem>Click &quot;Add &quot;; <figure><graphic fileref="ODSSWATOTutorial/sw9.png" /></figure> </listitem>
<listitem>Go to Weblog -&gt; Settings -&gt; Moblog Settings.
<figure><graphic fileref="ODSSWATOTutorial/sw10.png" /></figure> <figure><graphic fileref="ODSSWATOTutorial/sw10a.png" /></figure> </listitem>
<listitem>In the form displayed: <itemizedlist mark="bullet" spacing="compact"><listitem>Enter your external POP3 account&#39; Server Settings; </listitem>
<listitem>Hatch &quot;Automatic Moblogging enabled&quot;; </listitem>
<listitem>Set &quot;Allowed MIME Types (comma separated list)&quot; for images and text: <figure><graphic fileref="ODSSWATOTutorial/sw11.png" /></figure> <figure><graphic fileref="ODSSWATOTutorial/sw11a.png" /></figure> </listitem>
</itemizedlist></listitem>
<listitem>Click &quot;Save&quot;.</listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h3"> John&#39;s Activities</bridgehead>
 <orderedlist spacing="compact"><listitem>Go to <ulink url="http://cname/ods">http://cname/ods</ulink> and log in as user <emphasis>john</emphasis>.
</listitem>
<listitem>Go to Application Settings -&gt; Semantic Pingback.
</listitem>
<listitem>In the form displayed: <itemizedlist mark="bullet" spacing="compact"><listitem>Select for &quot;Application name&quot; - &quot;Personal Profile Manager&quot;, i.e.
 john in this way will configure Semantic Pingback for his Profile Space with the email option enabled.
</listitem>
<listitem>Enter a valid e-mail address for notification: <figure><graphic fileref="ODSSWATOTutorial/sw12.png" /></figure> </listitem>
</itemizedlist></listitem>
<listitem>Click &quot;Add&quot;.
<figure><graphic fileref="ODSSWATOTutorial/sw13.png" /></figure></listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h3"> Demo&#39;s Activities</bridgehead>
<bridgehead class="http://www.w3.org/1999/xhtml:h4">Content Creation</bridgehead>
 <orderedlist spacing="compact"><listitem>Take a photo with camera phone and email to the dedicated email account associated with the Moblogging service associated with Weblog.
 The body of the mail (actual blog post content) should refer to John by reference using &#39;@john&#39; (which triggers automatic hyperlinking within blog post content).
<itemizedlist mark="bullet" spacing="compact"><listitem>Note: you can also simply send an email from an email client to the Moblogging account with the picture attached too.</listitem>
</itemizedlist></listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h4">Content Persistence To Weblog</bridgehead>
 <orderedlist spacing="compact"><listitem>Enter Personal Data Space (using Digest, <ulink url="OpenID">OpenID</ulink>, Webfinger, or <ulink url="WebID">WebID</ulink>).
</listitem>
<listitem>Go to Weblog -&gt; New Post -&gt; Moblog Messages.
<figure><graphic fileref="ODSSWATOTutorial/sw14.png" /></figure> </listitem>
<listitem>Click &quot;Fetch&quot; to retrieve and persist content to Weblog . <figure><graphic fileref="ODSSWATOTutorial/sw15.png" /></figure> </listitem>
<listitem>At this point a notice is automatically sent to John (referenced by URI reference in the Weblog entry) via Semantic Pingback: <programlisting>From: Mail Admin
Subject: Semantic Pingback Notification
Date: September 29, 2010 9:29:02 PM GMT+03:00
To: John Smith

The Data Space Entity: http://localhost:8994/dataspace/demo/weblog/demo%27s%20Weblog/22 has been updated with a new relation http://rdfs.org/sioc/ns#links_to that references http://localhost:8994/dataspace/person/john#this. You may also wish to make a reciprocal entry in your Data Space.

Note: you are receiving this mail because you enabled Semantic Pingback notification (with email as notice mechanism) for your Personal Profile Management Data Space for WebID: http://localhost:8994/dataspace/person/john#this. You do not need to respond to this automated email.
</programlisting></listitem>
</orderedlist><bridgehead class="http://www.w3.org/1999/xhtml:h3"> Mary&#39;s Activities</bridgehead>
<orderedlist spacing="compact"><listitem>Go to <ulink url="http://cname/ods">http://cname/ods</ulink> and log in as user <emphasis>mary</emphasis>.
</listitem>
<listitem>Enter Personal Data Space (using Digest, <ulink url="OpenID">OpenID</ulink>, Webfinger, or <ulink url="WebID">WebID</ulink>).
</listitem>
<listitem>Go to Weblog -&gt; Feed Manager -&gt; Administration-&gt; Subscribe.
<figure><graphic fileref="ODSSWATOTutorial/sw20.png" /></figure> </listitem>
<listitem>Click &quot;Next&quot; </listitem>
<listitem>In the form displayed: <orderedlist spacing="compact"><listitem>Enter in &quot;From URL (RSS/Atom/OPML/OCS/SIOC ...)&quot; the demo&#39;s Weblog RSS URL, for ex: <programlisting>http://cname/weblog/demo/demo-blog-0/gems/rss.xml
</programlisting><figure><graphic fileref="ODSSWATOTutorial/sw21.png" /></figure> </listitem>
<listitem>Click &quot;Subscribe&quot;.
</listitem>
</orderedlist></listitem>
<listitem>In the next form displayed: <orderedlist spacing="compact"><listitem>Optionally you can specify the &quot;Feed folder&quot; to which the Weblog content should be retrieved: <figure><graphic fileref="ODSSWATOTutorial/sw22.png" /></figure> </listitem>
<listitem>Click &quot;Subscribe&quot;.
<figure><graphic fileref="ODSSWATOTutorial/sw23.png" /></figure> </listitem>
</orderedlist></listitem>
<listitem>As result <emphasis>mary</emphasis> will also become aware of the Weblog entry based on her subscription to Demo&#39;s Weblog: <orderedlist spacing="compact"><listitem>Go to Read-&gt;Feeds-&gt;(demoWeblog folder).
</listitem>
<listitem>The retrieved Weblog entry should be dislayed.
<figure><graphic fileref="ODSSWATOTutorial/sw24.png" /></figure> <figure><graphic fileref="ODSSWATOTutorial/sw25.png" /></figure> </listitem>
</orderedlist></listitem>
<listitem>Go to demo&#39;s Weblog, for ex: <programlisting>http://cname/weblog/demo/demo-blog-0/
</programlisting><figure><graphic fileref="ODSSWATOTutorial/sw26.png" /></figure> </listitem>
<listitem>Click &quot;Comments&quot; in order for <emphasis>mary</emphasis> to post a comment to the Weblog post.
<figure><graphic fileref="ODSSWATOTutorial/sw27.png" /></figure> </listitem>
<listitem>User <emphasis>mary</emphasis> authenticates with her <ulink url="OpenID">OpenID</ulink> to this post: <orderedlist spacing="compact"><listitem>Enter <emphasis>mary</emphasis>&#39;s <ulink url="OpenID">OpenID</ulink>, for ex: <programlisting> http://id.myopenlink.net/dataspace/person/mary
</programlisting><figure><graphic fileref="ODSSWATOTutorial/sw27a.png" /></figure> </listitem>
<listitem>Click &quot;Verify&quot;.
</listitem>
<listitem>Enter user <emphasis>mary</emphasis>&#39;s credentials.
<figure><graphic fileref="ODSSWATOTutorial/sw27b.png" /></figure> </listitem>
<listitem>Click &quot;Login&quot;.
</listitem>
</orderedlist></listitem>
<listitem>This results in a redirection back to demo&#39;s Weblog post comment form with Verified <ulink url="OpenID">OpenID</ulink>.
</listitem>
<listitem>Enter text some text: <figure><graphic fileref="ODSSWATOTutorial/sw28.png" /></figure> </listitem>
<listitem>Click &quot;Post&quot; <figure><graphic fileref="ODSSWATOTutorial/sw29.png" /></figure> </listitem>
<listitem>At this point a notice is automatically sent to John and Demo users (referenced by URI reference in the Weblog entry) via Semantic Pingback: <programlisting>-- the notice sent to John:
From: Mail Admin
Subject: Semantic Pingback Notification
Date: September 29, 2010 9:29:02 PM GMT+03:00
To: John Smith

The Data Space Entity: http://localhost:8994/dataspace/demo/weblog/demo%27s%20Weblog/22 has been updated with a new relation http://rdfs.org/sioc/ns#links_to that references http://localhost:8994/dataspace/person/john#this. You may also wish to make a reciprocal entry in your Data Space.

Note: you are receiving this mail because you enabled Semantic Pingback notification (with email as notice mechanism) for your Personal Profile Management Data Space for WebID: http://localhost:8994/dataspace/person/john#this. You do not need to respond to this automated email.
</programlisting><programlisting>-- the notice sent to Demo
From: Mail Admin
Subject: Semantic Pingback Notification
Date: September 29, 2010 9:29:02 PM GMT+03:00
To: Demo User

The Data Space Entity: http://localhost:8994/dataspace/demo/weblog/demo%27s%20Weblog/22 has been updated with a new relation http://rdfs.org/sioc/ns#links_to that references http://localhost:8994/dataspace/person/demo#this. You may also wish to make a reciprocal entry in your Data Space.

Note: you are receiving this mail because you enabled Semantic Pingback notification (with email as notice mechanism) for your Personal Profile Management Data Space for WebID: http://localhost:8994/dataspace/person/demo#this. You do not need to respond to this automated email.
</programlisting></listitem>
</orderedlist><para> </para>
<bridgehead class="http://www.w3.org/1999/xhtml:h2">Related</bridgehead>
<itemizedlist mark="bullet" spacing="compact"><listitem><ulink url="http://federatedsocialweb.net/wiki/">SWAT0 Federated Social Web Usecase</ulink> </listitem>
<listitem><ulink url="http://federatedsocialweb.net/wiki/SWAT0">Social Web Acid Test - Level 0</ulink> </listitem>
<listitem><ulink url="http://www.flickr.com/photos/factoryjoe/4884073970/">SWAT0 Flow</ulink></listitem>
</itemizedlist></section></docbook>