<?xml version="1.0" encoding="UTF-8"?>
<rss version="2.0"
	xmlns:content="http://purl.org/rss/1.0/modules/content/"
	xmlns:wfw="http://wellformedweb.org/CommentAPI/"
	xmlns:dc="http://purl.org/dc/elements/1.1/"
	xmlns:atom="http://www.w3.org/2005/Atom"
	xmlns:sy="http://purl.org/rss/1.0/modules/syndication/"
	xmlns:slash="http://purl.org/rss/1.0/modules/slash/"
	>

<channel>
	<title>Marcus Povey &#187; documentation</title>
	<atom:link href="http://www.marcus-povey.co.uk/tag/documentation/feed/" rel="self" type="application/rss+xml" />
	<link>http://www.marcus-povey.co.uk</link>
	<description>Making the world a better place, one byte at a time...</description>
	<lastBuildDate>Fri, 16 Jul 2010 09:00:50 +0000</lastBuildDate>
	<language>en</language>
	<sy:updatePeriod>hourly</sy:updatePeriod>
	<sy:updateFrequency>1</sy:updateFrequency>
	<generator>http://wordpress.org/?v=3.0</generator>
	<atom:link rel='hub' href='http://www.marcus-povey.co.uk/?pushpress=hub'/>
		<item>
		<title>The Export Interface</title>
		<link>http://www.marcus-povey.co.uk/2009/08/24/the-export-interface/</link>
		<comments>http://www.marcus-povey.co.uk/2009/08/24/the-export-interface/#comments</comments>
		<pubDate>Mon, 24 Aug 2009 16:42:21 +0000</pubDate>
		<dc:creator>Marcus Povey</dc:creator>
				<category><![CDATA[elgg]]></category>
		<category><![CDATA[#ue]]></category>
		<category><![CDATA[documentation]]></category>
		<category><![CDATA[export]]></category>
		<category><![CDATA[interface]]></category>

		<guid isPermaLink="false">http://www.marcus-povey.co.uk/?p=263</guid>
		<description><![CDATA[One of the more hidden features of Elgg is the Export interface. In a nutshell this interface provides an export view for Entities, Metadata, Annotations and relationships which can provide a convenient way of accessing data objects in a machine readable form. Endpoints The export url is constructed in different ways for entities, relationships and [...]]]></description>
			<content:encoded><![CDATA[<p><img src="http://www.marcus-povey.co.uk/wp-content/elgg-com-logo.gif" alt="" width="180" align="right" />One of the more hidden features of Elgg is the Export interface.</p>
<p>In a nutshell this interface provides an export view for Entities, Metadata, Annotations and relationships which can provide a convenient way of accessing data objects in a machine readable form.</p>
<h2>Endpoints</h2>
<p>The export url is constructed in different ways for entities, relationships and metadata.</p>
<p>All endpoints begin with:</p>
<blockquote><p><code>http://yoursite.com/export/<strong>[VIEW]</strong>/</code></p></blockquote>
<p>Where [VIEW] is the format you want the data exported in &#8211; e.g. json, opendd, php or default.</p>
<p><strong>Entities</strong><br />
To export a GUID simply add it to the end:</p>
<blockquote><p><code>http://yoursite.com/export/<strong>[VIEW]</strong>/<strong>[GUID]</strong>/</code></p></blockquote>
<p><strong>Annotations &amp; Metadata</strong></p>
<p>Metadata and annotation can be exported by providing the type (&#8216;annotation&#8217; or &#8216;metadata&#8217;) and the appropriate ID.</p>
<blockquote><p><code>http://yoursite.com/export/<strong>[VIEW]</strong>/<strong>[GUID]</strong>/<strong>[annotation|metadata]</strong>/<strong>[annotation_id|metadata_id]</strong>/</code></p></blockquote>
<p><strong>Relationships</strong><br />
Follows the same format as above, but with <strong>[GUID]</strong> being the first guid in the relationship &#8211; in essence the entity to which the relationship &#8220;belongs&#8221;.</p>
<blockquote><p><code>http://yoursite.com/export/<strong>[VIEW]</strong>/<strong>[GUID]</strong>/relationship/<strong>[relationship_id]</strong>/</code></p></blockquote>
<h2>Security</h2>
<p>Some items of data (for example user passwords) are restricted from this export view. Exactly what is output by an output view is governed by <code>$object-&gt;getExportableValues();</code> which returns a list of exportable fields in the entity.</p>
<p>In addition, access permissions on the object are respected &#8211; meaning that if you can&#8217;t see an item in Elgg, you will not be able to see it in the export view either.</p>
]]></content:encoded>
			<wfw:commentRss>http://www.marcus-povey.co.uk/2009/08/24/the-export-interface/feed/</wfw:commentRss>
		<slash:comments>1</slash:comments>
		</item>
	</channel>
</rss>
