West at 03:57, 30 March 2016

2016-03-30T03:57:40Z

West: Created page with "{{Extension |Name=Semantic Internal Objects |Homepage=http://www.mediawiki.org/wiki/Extension:Semantic_Internal_Objects |Description=Setting of internal objects in Semantic Media..."

2016-03-30T03:56:41Z

Created page with "{{Extension |Name=Semantic Internal Objects |Homepage=http://www.mediawiki.org/wiki/Extension:Semantic_Internal_Objects |Description=Setting of internal objects in Semantic Media..."

New page

{{Extension
|Name=Semantic Internal Objects
|Homepage=http://www.mediawiki.org/wiki/Extension:Semantic_Internal_Objects
|Description=Setting of internal objects in Semantic MediaWiki
|Maintainer=Yaron Koren
|First released month=August
|First released year=2009
|Release status=stable
|Development status=active
|Area of usage=Storing additional data
|Associated with=SMW, SB
|Shortcut=SIO
}}
'''Semantic Internal Objects''' (SIO) is an extension to [[Semantic MediaWiki]] (SMW). It provides two parser functions, <code>#set_internal</code> and <code>#set_internal_recurring_event</code>, both of which are used to define so-called "internal objects" (now "subobjects") within the Semantic MediaWiki system. SIO's main contribution to SMW is in the introduction of certain compound types of information, sometimes known as '[[Help:Type Record|n-ary relations]]', which ensures that pages can include more than one group of associated property-value pairs. SIO lets you define a two-dimensional table of information on a single page, with a call to <code>#set_internal</code> or <code>#set_internal_recurring_event</code> being used to store each row.

This functionality has been adopted by SMW so that <code>#set_internal</code> and <code>#set_internal_recurring_event</code> are now broadly equivalent to SMW's own parser functions [[Help:Adding subobjects|<code>#subobject</code>]] (introduced in SMW 1.7) and [[Help:Recurring_events|<code>#set_recurring_event</code>]] (since SMW 1.9) respectively, both of which are used to define "subobjects". Since SIO 0.7, the differences have become even less significant as SIO's parser functions now serve as a wrapper for SMW subobjects, which are called internally with SMWSQLStore3.

==Historical outline==

* The functionality of parser function <code>#set_internal</code> was introduced into SMW core with parser function [[Help:Adding subobjects|<code>#subobject</code>]] in version [[SMW_1.7.0#Native_subobjects|1.7.0]] .
* The functionality of parser function <code>#set_internal_recurring_event</code> was applied to <code>#set_recurring_event</code> in SMW 1.9.
* As of v0.7, SMW subobjects are called when using SMWSQLStore3 (for SMW 1.8+).

== <tt>#set_internal_recurring_event</tt> ==
SIO's <code>#set_internal_recurring_event</code> was created as a solution to a problem with <code>#set_recurring_event</code>: in versions of SMW prior to 1.9, <code>#set_recurring_event</code> allows you to store recurrent events but individual instances of an event can't be (easily) separated from one another. SIO defines a separate "internal object" for each instance of an event, with a different date for each, and so allows for more precise querying and display of only those event instances that fall within a certain date range. As of SMW 1.9, however, SMW's <code>#set_recurring_event</code> adopts a similar approach by defining a separate subobject for each instance of an event. The two parser functions behave alike and they both allow you to separate individual instances of an event.

===Syntax===
The (abridged) syntax for <code>#set_internal_recurring_event</code> is:

<pre>
{{#set_internal_recurring_event:object_to_page_property
...all parameters allowed by #set_recurring_event...
}}
</pre>

===Example===
Here is an example of such a call, on a page that defines a recurring event:
Using <tt>#set_internal_recurring_event</tt>
|<pre>
{{#set_internal_recurring_event:Is instance of
|property=Has date
|start=January 4, 2012
|end=June 8, 2013
|unit=week
|period=1
}}</pre>

You could then display a table of all the events that happened in a certain week, along with their date, with the following call:
Calling for events happening in a certain week
|<pre>{{#ask:[[Has date::>February 1, 2012]][[Has date::<February 7, 2012]]
|mainlabel=-
|?Is instance of
|?Has date
}}</pre>

== Known issues ==
* Having more than one call to <code>#set_internal_recurring_event</code> in the same page sometimes causes duplicate objects to be stored.

{{docinfo
| master page = Semantic Internal Objects
| master rev = {{REVISIONID}}
| master link = internal
| status = effective
| progress = 100
| priority = 4
| category =
| author = Yaron Koren
| editor = {{REVISIONUSER}}
| support = Yaron Koren
| minversion = 1.4.3
| lang = en
| desc =
| return =
| nowarn
}}

Help:Semantic Internal Objects - Revision history

West at 03:57, 30 March 2016

West: Created page with "{{Extension |Name=Semantic Internal Objects |Homepage=http://www.mediawiki.org/wiki/Extension:Semantic_Internal_Objects |Description=Setting of internal objects in Semantic Media..."