<?xml version="1.0" encoding="UTF-8"?> <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en"> <head> <title>Nepomuk.Thing</title> <meta http-equiv="Content-Type" content="text/html; charset=utf-8" /> <meta http-equiv="Content-Style-Type" content="text/css" /> <link rel="stylesheet" type="text/css" href="../common/doxygen.css" /> <link rel="stylesheet" media="screen" type="text/css" title="KDE Colors" href="../common/kde.css" /> </head> <body> <div id="container"> <div id="header"> <div id="header_top"> <div> <div> <img alt ="" src="../common/top-kde.jpg"/> KDE 4.9 PyKDE API Reference </div> </div> </div> <div id="header_bottom"> <div id="location"> <ul> <li>KDE's Python API</li> </ul> </div> <div id="menu"> <ul> <li><a href="../modules.html">Overview</a></li> <li><a href="http://techbase.kde.org/Development/Languages/Python">PyKDE Home</a></li> <li><a href="http://kde.org/family/">Sitemap</a></li> <li><a href="http://kde.org/contact/">Contact Us</a></li> </ul> </div> </div> </div> <div id="body_wrapper"> <div id="body"> <div id="right"> <div class="content"> <div id="main"> <div class="clearer"> </div> <h1>Thing Class Reference</h1> <code>from PyKDE4.nepomuk import *</code> <p> Inherits: <a href="../nepomuk/Nepomuk.Resource.html">Nepomuk.Resource</a><br /> Namespace: <a href="../nepomuk/Nepomuk.html">Nepomuk</a><br /> <h2>Detailed Description</h2> <p>\class Thing thing.h Nepomuk/Thing </p> <p> A Nepomuk PIMO Thing resource. </p> <p> A Thing represents a unique abstract concept/idea or real-world entity which can have multiple representations or occurrences. </p> <p> A typical example for a Thing is a unique person resource which identifies the person itself, not any representation such as an addressbook entry. </p> <p> Things are typically grounded via application resources, i.e. those resources that are created or handled by applications. Again the typical example is the addressbook entry. </p> <p> In general it is recommended to alway use the Thing instead of the grounding resource to annotate, i.e. to add tags, or relate to other resources. The advantage is its uniqueness. While there can be many occurrences of one concept there is only one Thing, identifying uniquely. </p> <p> <dl class="author" compact><dt><b>Author:</b></dt><dd> Sebastian Trueg <trueg@kde.org> </dd></dl> </p> <p> <dl class="since" compact><dt><b>Since:</b></dt><dd> 4.2 </dd></dl> </p> <table border="0" cellpadding="0" cellspacing="0"><tr><td colspan="2"><br><h2>Methods</h2></td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#Thing">__init__</a> (self, QUrl uri=QUrl(), QUrl pimoType=QUrl())</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#Thing">__init__</a> (self, QUrl uri, QUrl pimoType, <a href="../nepomuk/Nepomuk.ResourceManager.html">Nepomuk.ResourceManager</a> manager)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#Thing">__init__</a> (self, QString uriOrName, QUrl pimoType=QUrl())</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#Thing">__init__</a> (self, QString uriOrName, QUrl pimoType, <a href="../nepomuk/Nepomuk.ResourceManager.html">Nepomuk.ResourceManager</a> manager)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#Thing">__init__</a> (self, <a href="../nepomuk/Nepomuk.Thing.html">Nepomuk.Thing</a> other)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#Thing">__init__</a> (self, <a href="../nepomuk/Nepomuk.Resource.html">Nepomuk.Resource</a> other)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top"> </td><td class="memItemRight" valign="bottom"><a class="el" href="#addGroundingOccurrence">addGroundingOccurrence</a> (self, <a href="../nepomuk/Nepomuk.Resource.html">Nepomuk.Resource</a> res)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">[<a href="../nepomuk/Nepomuk.Resource.html">Nepomuk.Resource</a>] </td><td class="memItemRight" valign="bottom"><a class="el" href="#groundingOccurrences">groundingOccurrences</a> (self)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">[<a href="../nepomuk/Nepomuk.Resource.html">Nepomuk.Resource</a>] </td><td class="memItemRight" valign="bottom"><a class="el" href="#occurrences">occurrences</a> (self)</td></tr> <tr><td class="memItemLeft" nowrap align="right" valign="top">[<a href="../nepomuk/Nepomuk.Resource.html">Nepomuk.Resource</a>] </td><td class="memItemRight" valign="bottom"><a class="el" href="#referencingOccurrences">referencingOccurrences</a> (self)</td></tr> </table> <hr><h2>Method Documentation</h2><a class="anchor" name="Thing"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname">__init__</td> <td>(</td> <td class="paramtype"> <em>self</em>, </td> <td class="paramname"></td> </tr><tr> <td class="memname"></td> <td></td> <td class="paramtype">QUrl </td> <td class="paramname"><em>uri=QUrl()</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">QUrl </td> <td class="paramname"><em>pimoType=QUrl()</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"><p>Create a Thing object with URI <b>uri.</b> If the Thing does not exist in the Nepomuk storage yet, it will be created once a writing method is called (such as Resource.setProperty). </p> <p> </p><dl compact><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td></td><td valign="top"><em>uri</em> </td><td> The URI of the Thing. If empty, a new random one will be created. </td></tr> </table></dl> <p> </p><dl compact><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td></td><td valign="top"><em>pimoType</em> </td><td> The type of this Thing. Needs to be a subtype of pimo:Thing. If empty defaults to pimo:Thing. </td></tr> </table></dl> <p> </p></div></div><a class="anchor" name="Thing"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname">__init__</td> <td>(</td> <td class="paramtype"> <em>self</em>, </td> <td class="paramname"></td> </tr><tr> <td class="memname"></td> <td></td> <td class="paramtype">QUrl </td> <td class="paramname"><em>uri</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">QUrl </td> <td class="paramname"><em>pimoType</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype"><a href="../nepomuk/Nepomuk.ResourceManager.html">Nepomuk.ResourceManager</a> </td> <td class="paramname"><em>manager</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"><p> </p><dl compact><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td></td><td valign="top"><em>manager</em> </td><td> The resource manager to use. This allows to mix resources from different managers and, thus, different models. </td></tr> </table></dl> <p> <dl class="since" compact><dt><b>Since:</b></dt><dd> 4.3 </dd></dl> </p></div></div><a class="anchor" name="Thing"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname">__init__</td> <td>(</td> <td class="paramtype"> <em>self</em>, </td> <td class="paramname"></td> </tr><tr> <td class="memname"></td> <td></td> <td class="paramtype">QString </td> <td class="paramname"><em>uriOrName</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">QUrl </td> <td class="paramname"><em>pimoType=QUrl()</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"><p>Create a new Thing with label or URI <b>uriOrName</b> </p> <p> </p><dl compact><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td></td><td valign="top"><em>uriOrName</em> </td><td> The URI or the label of the Thing. The constructor tries hard to find the Thing associated. If it is not found, a new Thing will be created. </td></tr> </table></dl> <p> </p><dl compact><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td></td><td valign="top"><em>pimoType</em> </td><td> The type of this Thing. Needs to be a subtype of pimo:Thing. If empty defaults to pimo:Thing. </td></tr> </table></dl> <p> Be aware that using the other constructor is always faster in case the URI of the Thing is known. </p></div></div><a class="anchor" name="Thing"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname">__init__</td> <td>(</td> <td class="paramtype"> <em>self</em>, </td> <td class="paramname"></td> </tr><tr> <td class="memname"></td> <td></td> <td class="paramtype">QString </td> <td class="paramname"><em>uriOrName</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype">QUrl </td> <td class="paramname"><em>pimoType</em>, </td> </tr> <tr> <td class="memname"></td> <td></td> <td class="paramtype"><a href="../nepomuk/Nepomuk.ResourceManager.html">Nepomuk.ResourceManager</a> </td> <td class="paramname"><em>manager</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"><p> </p><dl compact><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td></td><td valign="top"><em>manager</em> </td><td> The resource manager to use. This allows to mix resources from different managers and, thus, different models. </td></tr> </table></dl> <p> <dl class="since" compact><dt><b>Since:</b></dt><dd> 4.3 </dd></dl> </p></div></div><a class="anchor" name="Thing"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname">__init__</td> <td>(</td> <td class="paramtype"> <em>self</em>, </td> <td class="paramname"></td> </tr><tr> <td class="memname"></td> <td></td> <td class="paramtype"><a href="../nepomuk/Nepomuk.Thing.html">Nepomuk.Thing</a> </td> <td class="paramname"><em>other</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"><p>Copy constructor. </p> <p> </p><dl compact><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td></td><td valign="top"><em>other</em> </td><td> the resoruce to construct the Thing from. </td></tr> </table></dl> <p> </p></div></div><a class="anchor" name="Thing"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname">__init__</td> <td>(</td> <td class="paramtype"> <em>self</em>, </td> <td class="paramname"></td> </tr><tr> <td class="memname"></td> <td></td> <td class="paramtype"><a href="../nepomuk/Nepomuk.Resource.html">Nepomuk.Resource</a> </td> <td class="paramname"><em>other</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"><p>Copy constructor. </p> <p> </p><dl compact><dt><b>Parameters:</b></dt><dd> <table border="0" cellspacing="2" cellpadding="0"> <tr><td></td><td valign="top"><em>other</em> </td><td> the resoruce to construct the Thing from. </td></tr> </table></dl> <p> </p></div></div><a class="anchor" name="addGroundingOccurrence"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname"> addGroundingOccurrence</td> <td>(</td> <td class="paramtype"> <em>self</em>, </td> <td class="paramname"></td> </tr><tr> <td class="memname"></td> <td></td> <td class="paramtype"><a href="../nepomuk/Nepomuk.Resource.html">Nepomuk.Resource</a> </td> <td class="paramname"><em>res</em></td> </tr> <tr> <td></td> <td>)</td> <td></td> <td></td> <td width="100%"> </td> </tr></table> </div> <div class="memdoc"><p>Add a grounding occurrence for this Thing. Grounding resources are physical representations of the Thing. </p> <p> An example is an mp3 file which represents an audio track or a website which represents a company or a person. Or the addressbook entry for an abstract person thing. </p> <p> \sa pimo:groundingResource </p></div></div><a class="anchor" name="groundingOccurrences"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname">[<a href="../nepomuk/Nepomuk.Resource.html">Nepomuk.Resource</a>] groundingOccurrences</td> <td>(</td> <td class="paramtype"> </td> <td class="paramname"><em>self</em> )</td> <td width="100%"> </td> </tr> </table> </div> <div class="memdoc"><p>Get the grounding occurrences for this Thing. Grounding resources are physical representations of the Thing. </p> <p> An example is an mp3 file which represents an audio track or a website which represents a company or a person. Or the addressbook entry for an abstract person thing. </p> <p> \sa pimo:groundingResource </p></div></div><a class="anchor" name="occurrences"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname">[<a href="../nepomuk/Nepomuk.Resource.html">Nepomuk.Resource</a>] occurrences</td> <td>(</td> <td class="paramtype"> </td> <td class="paramname"><em>self</em> )</td> <td width="100%"> </td> </tr> </table> </div> <div class="memdoc"></div></div><a class="anchor" name="referencingOccurrences"></a> <div class="memitem"> <div class="memproto"> <table class="memname"><tr> <td class="memname">[<a href="../nepomuk/Nepomuk.Resource.html">Nepomuk.Resource</a>] referencingOccurrences</td> <td>(</td> <td class="paramtype"> </td> <td class="paramname"><em>self</em> )</td> <td width="100%"> </td> </tr> </table> </div> <div class="memdoc"></div></div> </div> </div> </div> <div id="left"> <div class="menu_box"> <div class="nav_list"> <ul> <li><a href="../allclasses.html">Full Index</a></li> </ul> </div> <a name="cp-menu" /><div class="menutitle"><div> <h2 id="cp-menu-project">Modules</h2> </div></div> <div class="nav_list"> <ul><li><a href="../akonadi/index.html">akonadi</a></li> <li><a href="../dnssd/index.html">dnssd</a></li> <li><a href="../kdecore/index.html">kdecore</a></li> <li><a href="../kdeui/index.html">kdeui</a></li> <li><a href="../khtml/index.html">khtml</a></li> <li><a href="../kio/index.html">kio</a></li> <li><a href="../knewstuff/index.html">knewstuff</a></li> <li><a href="../kparts/index.html">kparts</a></li> <li><a href="../kutils/index.html">kutils</a></li> <li><a href="../nepomuk/index.html">nepomuk</a></li> <li><a href="../phonon/index.html">phonon</a></li> <li><a href="../plasma/index.html">plasma</a></li> <li><a href="../polkitqt/index.html">polkitqt</a></li> <li><a href="../solid/index.html">solid</a></li> <li><a href="../soprano/index.html">soprano</a></li> </ul></div></div> </div> </div> <div class="clearer"/> </div> <div id="end_body"></div> </div> <div id="footer"><div id="footer_text"> This documentation is maintained by <a href="mailto:simon@simonzone.com">Simon Edwards</a>.<br /> KDE<sup>®</sup> and <a href="../images/kde_gear_black.png">the K Desktop Environment<sup>®</sup> logo</a> are registered trademarks of <a href="http://ev.kde.org/" title="Homepage of the KDE non-profit Organization">KDE e.V.</a> | <a href="http://www.kde.org/contact/impressum.php">Legal</a> </div></div> </body> </html>