<?xml version="1.0" encoding="utf-8"?>
<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom"><channel><title>Recent changes to wiki</title><link>https://sourceforge.net/p/opengroupware/wiki/</link><description>Recent changes to wiki</description><atom:link href="https://sourceforge.net/p/opengroupware/wiki/feed.rss" rel="self"/><language>en</language><lastBuildDate>Wed, 07 May 2014 13:28:18 -0000</lastBuildDate><atom:link href="https://sourceforge.net/p/opengroupware/wiki/feed.rss" rel="self" type="application/rss+xml"/><item><title>Configuration modified by Sebastian Reitenbach</title><link>https://sourceforge.net/p/opengroupware/wiki/Configuration/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v5
+++ v6
@@ -71,7 +71,7 @@

 ### Configuring Reminder Notification ###

-Reminder e-mails concerning upcoming appointments are sent by the ogoaptnotify utility which is provided by the ogo-tools package.  ogoaptnotify should be scheduled to run every five minutes.  The simples way to accomplish this is to create a cron job with a command of 'su - ogo -c "/usr/local/bin/bin/ogoaptnotify &gt;/dev/null”'.  If this cron job is executed as root su will be able to switch to the ogo user without a password. ogoaptnotify must execute in the same context as the server processes as it writes to log files and requires defaults.
+Reminder e-mails concerning upcoming appointments are sent by the ogoaptnotify utility which is provided by the ogo-tools package.  ogoaptnotify should be scheduled to run every five minutes.  The simples way to accomplish this is to create a cron job with a command of 'su - ogo -c "/usr/local/bin/ogoaptnotify 2&gt;/dev/null”'.  If this cron job is executed as root su will be able to switch to the ogo user without a password. ogoaptnotify must execute in the same context as the server processes as it writes to log files and requires defaults.

 The default configuration of ogoaptnotify contains, besides some others, six important defaults: “AptNotifyFromAddress”, “AptNotifySentResourcesFile”, “AptNotifyOGoPassword”, “AptNotifyOGoUser”, “AptNotifySendmailPath” and “AptNotifyVerbose”. 

&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Sebastian Reitenbach</dc:creator><pubDate>Wed, 07 May 2014 13:28:18 -0000</pubDate><guid isPermaLink="false">https://sourceforge.netac43c2c2f83139783b4ad1334be9de74eeb8c98a</guid></item><item><title>Configuration modified by Sebastian Reitenbach</title><link>https://sourceforge.net/p/opengroupware/wiki/Configuration/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v4
+++ v5
@@ -71,7 +71,7 @@

 ### Configuring Reminder Notification ###

-Reminder e-mails concerning upcoming appointments are sent by the ogoaptnotify utility which is provided by the ogo-tools package.  ogoaptnotify should be scheduled to run every five minutes.  The simples way to accomplish this is to create a cron job with a command of 'su - ogo -c "/usr/local/bin/bin/oogaptnotify &gt;/dev/null”'.  If this cron job is executed as root su will be able to switch to the ogo user without a password. ogoaptnotify must execute in the same context as the server processes as it writes to log files and requires defaults.
+Reminder e-mails concerning upcoming appointments are sent by the ogoaptnotify utility which is provided by the ogo-tools package.  ogoaptnotify should be scheduled to run every five minutes.  The simples way to accomplish this is to create a cron job with a command of 'su - ogo -c "/usr/local/bin/bin/ogoaptnotify &gt;/dev/null”'.  If this cron job is executed as root su will be able to switch to the ogo user without a password. ogoaptnotify must execute in the same context as the server processes as it writes to log files and requires defaults.

 The default configuration of ogoaptnotify contains, besides some others, six important defaults: “AptNotifyFromAddress”, “AptNotifySentResourcesFile”, “AptNotifyOGoPassword”, “AptNotifyOGoUser”, “AptNotifySendmailPath” and “AptNotifyVerbose”. 

&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Sebastian Reitenbach</dc:creator><pubDate>Wed, 07 May 2014 13:25:05 -0000</pubDate><guid isPermaLink="false">https://sourceforge.netf62af8e70f1df90e305e2ca02fb3ece81d016b0c</guid></item><item><title>Configuration modified by Sebastian Reitenbach</title><link>https://sourceforge.net/p/opengroupware/wiki/Configuration/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v3
+++ v4
@@ -71,10 +71,10 @@

 ### Configuring Reminder Notification ###

-Reminder e-mails concerning upcoming appointments are sent by the skyaptnotify utility which is provided by the ogo-tools package.  skyaptnotify should be scheduled to run every five minutes.  The simples way to accomplish this is to create a cron job with a command of 'su - ogo -c "/usr/local/bin/bin/skyaptnotify &gt;/dev/null”'.  If this cron job is executed as root su will be able to switch to the ogo user without a password.  skyaptnotify must execute in the same context as the server processes as it writes to log files and requires defaults.
+Reminder e-mails concerning upcoming appointments are sent by the ogoaptnotify utility which is provided by the ogo-tools package.  ogoaptnotify should be scheduled to run every five minutes.  The simples way to accomplish this is to create a cron job with a command of 'su - ogo -c "/usr/local/bin/bin/oogaptnotify &gt;/dev/null”'.  If this cron job is executed as root su will be able to switch to the ogo user without a password. ogoaptnotify must execute in the same context as the server processes as it writes to log files and requires defaults.

-The default configuration of skyaptnotify contains five defaults: “AptNotifyFromAddress”, “AptNotifySentResourcesFile”, “AptNotifySkyrixPassword”, “AptNotifySkyrixUser”, and “AptNotifyVerbose”. 
+The default configuration of ogoaptnotify contains, besides some others, six important defaults: “AptNotifyFromAddress”, “AptNotifySentResourcesFile”, “AptNotifyOGoPassword”, “AptNotifyOGoUser”, “AptNotifySendmailPath” and “AptNotifyVerbose”. 

-AptNotifySkyrixUser and AptNotifySkyrixPassword must be set to the OpenGroupware administrator's username and password,  this allows the notification utility to see all appointments.  If you change the password of the OpenGroupware administrator remember to update this default accordingly.
+AptNotifyOGoUser and AptNotifyOGoPassword must be set to the OpenGroupware administrator's username and password,  this allows the notification utility to see all appointments.  If you change the password of the OpenGroupware administrator remember to update this default accordingly.

 AptNotifyFromAddress is the address that appears in the “Return-Path” header of notification messages.  Initially this is set to “ogo@local-host-name” which should be changed at least so the domain appears to users as the domain they typically associate with local mail. 
&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Sebastian Reitenbach</dc:creator><pubDate>Wed, 07 May 2014 13:12:26 -0000</pubDate><guid isPermaLink="false">https://sourceforge.net39ab760adf72ff15b607203f0bad93dd4e7dbf1d</guid></item><item><title>General configuration modified by Sebastian Reitenbach</title><link>https://sourceforge.net/p/opengroupware/wiki/General%2520configuration/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v3
+++ v4
@@ -18,7 +18,7 @@
  * LSNewsImagesUrl: The path on the web server, where the images uploaded to the news section will be available
  * LSNewsImagesPath: The corresponding path on the filesystem where the images get stored
  * LSAttachmentPath: the path in the filesystem where OGo will store the users configurations, uploaded documents and more
- * WOMessageUseUTF8, WOParsersUseUTF8, NGUseUTF8AsURLEncoding: those you should just set to YES
+ * WOMessageUseUTF8, WOParsersUseUTF8, NGUseUTF8AsURLEncoding: those you should just set to YES when you have a need to enter Umlauts or accented characters in the web interface or as the login password
  * zip, unzip, tar, zipinfo: if those tools are not found along paths specified in the PATH environment variable, you should give OGo a hint with those defaults where to find them

&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Sebastian Reitenbach</dc:creator><pubDate>Thu, 25 Apr 2013 05:27:40 -0000</pubDate><guid isPermaLink="false">https://sourceforge.netb881e93b2ec9becbdd0f94cb503a1bc5261c0b0a</guid></item><item><title>WikiPage Architecture modified by Sebastian Reitenbach</title><link>https://sourceforge.net/p/opengroupware/wiki/Architecture/</link><description>&lt;div class="markdown_content"&gt;&lt;h1 id="ogo-architecture"&gt;OGo Architecture&lt;/h1&gt;
&lt;p&gt;OpenGroupware is comprised primarily of three services: ZideStore, the web interface1, and the XML-RPC daemon.  Each of these services runs as an independent processes on the server, listening on a unique TCP/IP port. However, clients do not access any of these services directly.  Client's HTTP requests are proxied to the services via the mod_ngobjweb Apache module.  A configuration where any client directly contacts any of the OpenGroupware services is incorrect and incomplete, all traffic must be routed through the Apache web server. &lt;/p&gt;
&lt;p&gt;In turn each of these services provides various functionality utilizing a common underlying layer of known as “Logic”.  In some cases there is an intermediary layer referred to as the “Document API” between the services and Logic.  Logic itself and other core functionality is built upon the SOPE application framework with provides basic services such as database access, LDAP connectivity, mail, and file-system access.&lt;/p&gt;
&lt;h2 id="apache-mod_ngobjweb"&gt;Apache &amp;amp; mod_ngobjweb&lt;/h2&gt;
&lt;h2 id="zidestore"&gt;ZideStore&lt;/h2&gt;
&lt;p&gt;ZideStore is the OpenGroupware integration server and provides access to service functionality via a variety of protocols including CalDAV, GroupDAV, RSS, WebDAV, and XML-RPC.  For detailed information on the ZideStore service see the “ZideStore” chapter of this document and the “ZideStore Product Bundles” section of this chapter.&lt;/p&gt;
&lt;h2 id="web-interface"&gt;Web Interface&lt;/h2&gt;
&lt;h2 id="xml-rpc-service"&gt;XML-RPC Service&lt;/h2&gt;
&lt;p&gt;The XML-RPC service provides an XML-RPC API to access server functionality.  This service is usually mapped to the “/RPC2” URL.  Since the XML-RPC service has existed for some time quite a number of scripts and tools exist for utilizing this API;  however,  this API is currently considered deprecated and new XML-RPC client development should be focused on the XML-RPC services provided by ZideStore and it's product bundles.  The XML-RPC service will be continue to be supported into the forseeable future and some fixes and minor enhancements may be applied,  but it is very unlikely that significant functionality will be added.&lt;/p&gt;
&lt;h2 id="bundles"&gt;Bundles&lt;/h2&gt;
&lt;p&gt;The OpenGroupware services as well as the DocumentAPI and Logic layers are themselves modular and composed of numerous units.  The most important unit of functionality in OpenGroupware is the “bundle”.  The “bundle” architecture is inherited from the GNUStep architecture1 and SOPE.  Each OpenGroupware or GNUStep bundle is a folder in the filesystem,  for instance: “RSS.zsp”, “LSProject.cmd”, and “JobUI.lso” are examples of bundles.  A bundle contains a shared library, bundle information2, and related resources.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;.lso: WebUI Bundle&lt;/li&gt;
&lt;li&gt;.cmd: Logic Command Bundle&lt;/li&gt;
&lt;li&gt;.ds:  DocumentAPI Datasource Bundle&lt;/li&gt;
&lt;li&gt;.model: Database Mapping Model Bundle&lt;/li&gt;
&lt;li&gt;.sax: XML SAX API Driver Bundle&lt;/li&gt;
&lt;li&gt;.sxp: SOPE Product Bundle&lt;/li&gt;
&lt;li&gt;.zsp: ZideStore Product Bundle&lt;/li&gt;
&lt;li&gt;.odr NGObjDom XML Renderer Bundle&lt;/li&gt;
&lt;li&gt;.bundle: Generic Bundle&lt;/li&gt;
&lt;li&gt;.gdladaptor: Database Adaptor Bundle&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;Each service identifies the appropriate bundles and loads them when the service is starts.  The type of bundle can be identified by the filename extension.&lt;/p&gt;
&lt;p&gt;The process of locating and loading bundles is managed by the NGBundleManager class provided by SOPE;  this class is slightly extended via a category for use in OpenGroupware.&lt;/p&gt;
&lt;h2 id="webui-bundles"&gt;WebUI Bundles&lt;/h2&gt;
&lt;h2 id="logic-command-bundles"&gt;Logic Command Bundles&lt;/h2&gt;
&lt;p&gt;The Logic layer of OpenGroupware.org is comprised of a large set of bundles,  each of which provides the necessary commands to manage a given type of entity.  For example the “LSScheduler.cmd” bundle provides the commands for creating, updating, deleting appointments as well as conflict detection and other scheduling related operations.  The “LSPerson.cmd” bundle provides the commands for creating, updating, and deleting contacts.&lt;/p&gt;
&lt;h3 id="commands"&gt;Commands&lt;/h3&gt;
&lt;p&gt;A “command” is the basic unit of functionality in OpenGroupware Logic.  All services, and the DocumentAPI, perform operations by issuing commands.  By loading the common set of Logic bundles the different services, and extensions to those services such as custom WebUI or ZideStore bundles, have a mechanism to provide consistent behavior .  Each bundle provides a set of commands;  for instance the “LSNews.cmd” bundle provides “newsarticle::new”, “newsarticle::set”, “newsarticle::delete”, “newsarticle::get”, “newsarticle::get-related-articles”, and “newsarticle::set-related-articles” commands for creating, updating, deleting, and retrieving news articles.  The services and applications use these commands to perform their various operations and are insulated from the specifics of the underlying backend, be it PostgreSQL, another RDBMS, or the filesystem.&lt;/p&gt;
&lt;p&gt;A command is always comprised of a “domain”, the portion to the left of the double colon, and an “operation”, the portion to the right of the double colon.  In the example “newsarticle::get-related-articles” the domain is “newsarticle” and the operation is “get-related-articles”.&lt;/p&gt;
&lt;p&gt;Each bundle provides the list of commands which it provides and a map which directs each command to an actual class in the compiled code.  For example, to execute the “newsarticle::new” command an instance of the “LSNewNewsArticleCommand” class, which was provided by the bundle, is created, supplied with the command parameters, and a run method is invoked.  The results of the method are returned to the application as the results of the command.&lt;/p&gt;
&lt;p&gt;To investigate what commands are involved in performing a given operation enable the “LSProfileCommands” default in the appropriate domain.&lt;/p&gt;
&lt;p&gt;All command objects descend from LSBaseCommand which implements the LSCommand contract.  Command objects which utilize the database descend from the database command object LSDBObjectBaseCommand which adds methods for accessing the database adapter and model.&lt;/p&gt;
&lt;h2 id="documentapi-datasource-bundles"&gt;DocumentAPI Datasource Bundles&lt;/h2&gt;
&lt;p&gt;DocumentAPI datasource bundles are part of the the Document API;  see the relevant section of this chapter.&lt;/p&gt;
&lt;h2 id="database-mapping-model-bundles"&gt;Database Mapping Model Bundles&lt;/h2&gt;
&lt;p&gt;The OpenGroupware suite contains exactly one model bundle: “OGo.model”.  The model describes the objects represented in the database, such as Appointment, Contact, etc..., thier attributes,and the relationships between entities.  Within the OGo.model bundle are map versions of the model for FrontBase, MySQL v5, and PostgreSQL.&lt;/p&gt;
&lt;p&gt;As an example: the LSCompanyAssignment is used to represent entries in the “company_assignment” table.  In the case of a PostgreSQL database the company_assignment table is created with the following DDL:&lt;/p&gt;
&lt;div class="codehilite"&gt;&lt;pre&gt;&lt;span class="n"&gt;CREATE&lt;/span&gt; &lt;span class="n"&gt;TABLE&lt;/span&gt; &lt;span class="n"&gt;company_assignment&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt; 
  &lt;span class="n"&gt;company_assignment_id&lt;/span&gt; &lt;span class="n"&gt;int&lt;/span&gt; &lt;span class="n"&gt;not&lt;/span&gt; &lt;span class="n"&gt;null&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; 
  &lt;span class="n"&gt;company_id&lt;/span&gt;            &lt;span class="n"&gt;int&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; 
  &lt;span class="n"&gt;sub_company_id&lt;/span&gt;        &lt;span class="n"&gt;int&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; 
  &lt;span class="n"&gt;is_headquarter&lt;/span&gt;        &lt;span class="n"&gt;smallint&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; 
  &lt;span class="n"&gt;is_chief&lt;/span&gt;          &lt;span class="n"&gt;smallint&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; 
&lt;span class="k"&gt;  function&lt;/span&gt;&lt;span class="w"&gt;          &lt;/span&gt;&lt;span class="nf"&gt;varchar&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;255&lt;span class="p"&gt;),&lt;/span&gt; 
  &lt;span class="n"&gt;db_status&lt;/span&gt;         &lt;span class="n"&gt;varchar&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;50&lt;span class="p"&gt;),&lt;/span&gt; 
  &lt;span class="n"&gt;constraint&lt;/span&gt; &lt;span class="n"&gt;pk_company_assignment&lt;/span&gt; &lt;span class="n"&gt;primary&lt;/span&gt; &lt;span class="n"&gt;key&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;company_assignment_id&lt;/span&gt;&lt;span class="p"&gt;));&lt;/span&gt;
&lt;/pre&gt;&lt;/div&gt;


&lt;p&gt;Correspondingly the model definition is:&lt;/p&gt;
&lt;div class="codehilite"&gt;&lt;pre&gt;&lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="o"&gt;//&lt;/span&gt; &lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;entity&lt;/span&gt; &lt;span class="n"&gt;name&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="n"&gt;CompanyAssignment&lt;/span&gt; &lt;span class="n"&gt;table&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&lt;span class="n"&gt;company_assignment&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; 
  &lt;span class="n"&gt;name&lt;/span&gt;                 &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;CompanyAssignment&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
  &lt;span class="n"&gt;externalName&lt;/span&gt;         &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;company_assignment&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
  &lt;span class="n"&gt;className&lt;/span&gt;            &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;LSCompanyAssignment&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
  &lt;span class="n"&gt;primaryKeyAttributes&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;companyAssignmentId&lt;/span&gt;&amp;quot; &lt;span class="p"&gt;);&lt;/span&gt; 
  &lt;span class="n"&gt;attributesUsedForLocking&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt; 
&lt;span class="k"&gt;    function&lt;/span&gt;&lt;span class="err"&gt;, &lt;/span&gt;
    &lt;span class="n"&gt;companyAssignmentId&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; 
    &lt;span class="n"&gt;isHeadquarter&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; 
    &lt;span class="n"&gt;dbStatus&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; 
    &lt;span class="n"&gt;companyId&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; 
    &lt;span class="n"&gt;subCompanyId&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; 
    &lt;span class="n"&gt;isChief&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; 
  &lt;span class="p"&gt;);&lt;/span&gt; 
  &lt;span class="n"&gt;classProperties&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt; 
&lt;span class="k"&gt;    function&lt;/span&gt;&lt;span class="err"&gt;, &lt;/span&gt;
    &lt;span class="n"&gt;companyAssignmentId&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; 
    &lt;span class="n"&gt;isHeadquarter&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; 
    &lt;span class="n"&gt;dbStatus&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; 
    &lt;span class="n"&gt;companyId&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; 
    &lt;span class="n"&gt;subCompanyId&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; 
    &lt;span class="n"&gt;isChief&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; 
    &lt;span class="n"&gt;toEnterprise&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; 
    &lt;span class="n"&gt;toPerson&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; 
    &lt;span class="n"&gt;toTeam&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; 
  &lt;span class="p"&gt;);&lt;/span&gt; 
  &lt;span class="n"&gt;attributes&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt; 
    &lt;span class="p"&gt;{&lt;/span&gt; 
      &lt;span class="n"&gt;name&lt;/span&gt;           &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;companyAssignmentId&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;columnName&lt;/span&gt;     &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;company_assignment_id&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;externalType&lt;/span&gt;   &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;INT&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;valueClassName&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;NSNumber&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;valueType&lt;/span&gt;      &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;i&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;allowsNull&lt;/span&gt;     &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="n"&gt;Y&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
    &lt;span class="p"&gt;},&lt;/span&gt; 
    &lt;span class="p"&gt;{&lt;/span&gt; 
      &lt;span class="n"&gt;name&lt;/span&gt;           &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;companyId&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;columnName&lt;/span&gt;     &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;company_id&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;externalType&lt;/span&gt;   &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;INT&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;valueClassName&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;NSNumber&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;valueType&lt;/span&gt;      &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;i&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;allowsNull&lt;/span&gt;     &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="n"&gt;Y&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
    &lt;span class="p"&gt;},&lt;/span&gt; 
    &lt;span class="p"&gt;{&lt;/span&gt; 
      &lt;span class="n"&gt;name&lt;/span&gt;           &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;dbStatus&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;columnName&lt;/span&gt;     &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;db_status&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;externalType&lt;/span&gt;   &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;VARCHAR&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;50&lt;span class="p"&gt;)&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;valueClassName&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;NSString&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;allowsNull&lt;/span&gt;     &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="n"&gt;Y&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;width&lt;/span&gt;          &lt;span class="p"&gt;=&lt;/span&gt; 50&lt;span class="p"&gt;;&lt;/span&gt; 
    &lt;span class="p"&gt;},&lt;/span&gt; 
    &lt;span class="p"&gt;{&lt;/span&gt; 
      &lt;span class="n"&gt;name&lt;/span&gt;           &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="k"&gt;function&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;columnName&lt;/span&gt;     &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="k"&gt;function&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;externalType&lt;/span&gt;   &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;VARCHAR&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;255&lt;span class="p"&gt;)&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;valueClassName&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;NSString&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;allowsNull&lt;/span&gt;     &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="n"&gt;Y&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;width&lt;/span&gt;          &lt;span class="p"&gt;=&lt;/span&gt; 255&lt;span class="p"&gt;;&lt;/span&gt; 
    &lt;span class="p"&gt;},&lt;/span&gt; 
    &lt;span class="p"&gt;{&lt;/span&gt; 
      &lt;span class="n"&gt;name&lt;/span&gt;           &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;isChief&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;columnName&lt;/span&gt;     &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;is_chief&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;externalType&lt;/span&gt;   &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;INT&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;valueClassName&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;NSNumber&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;valueType&lt;/span&gt;      &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;i&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;allowsNull&lt;/span&gt;     &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="n"&gt;Y&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
    &lt;span class="p"&gt;},&lt;/span&gt; 
    &lt;span class="p"&gt;{&lt;/span&gt; 
      &lt;span class="n"&gt;name&lt;/span&gt;           &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;isHeadquarter&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;columnName&lt;/span&gt;     &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;is_headquarter&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;externalType&lt;/span&gt;   &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;INT&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;valueClassName&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;NSNumber&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;valueType&lt;/span&gt;      &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;i&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;allowsNull&lt;/span&gt;     &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="n"&gt;Y&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
    &lt;span class="p"&gt;},&lt;/span&gt; 
    &lt;span class="p"&gt;{&lt;/span&gt; 
      &lt;span class="n"&gt;name&lt;/span&gt;           &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;subCompanyId&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;columnName&lt;/span&gt;     &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;sub_company_id&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;externalType&lt;/span&gt;   &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;INT&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;valueClassName&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;NSNumber&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;valueType&lt;/span&gt;      &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="nb"&gt;i&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;allowsNull&lt;/span&gt;     &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="n"&gt;Y&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
    &lt;span class="p"&gt;},&lt;/span&gt; 
  &lt;span class="p"&gt;);&lt;/span&gt;

  &lt;span class="n"&gt;relationships&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt; 
    &lt;span class="p"&gt;{&lt;/span&gt; 
      &lt;span class="n"&gt;name&lt;/span&gt;        &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;toEnterprise&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;destination&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;Enterprise&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;joins&lt;/span&gt;       &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; 
        &lt;span class="n"&gt;sourceAttribute&lt;/span&gt;      &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;companyId&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
        &lt;span class="n"&gt;destinationAttribute&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;companyId&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
        &lt;span class="n"&gt;joinSemantic&lt;/span&gt;         &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="n"&gt;EOInnerJoin&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
        &lt;span class="n"&gt;joinOperator&lt;/span&gt;         &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="n"&gt;EOJoinEqualTo&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="p"&gt;});&lt;/span&gt; 
    &lt;span class="p"&gt;},&lt;/span&gt; 
    &lt;span class="p"&gt;{&lt;/span&gt; 
      &lt;span class="n"&gt;name&lt;/span&gt;        &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;toPerson&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;destination&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;Person&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;joins&lt;/span&gt;       &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; 
        &lt;span class="n"&gt;sourceAttribute&lt;/span&gt;      &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;subCompanyId&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
        &lt;span class="n"&gt;destinationAttribute&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;companyId&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
        &lt;span class="n"&gt;joinSemantic&lt;/span&gt;         &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="n"&gt;EOInnerJoin&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
        &lt;span class="n"&gt;joinOperator&lt;/span&gt;         &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="n"&gt;EOJoinEqualTo&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="p"&gt;});&lt;/span&gt; 
    &lt;span class="p"&gt;},&lt;/span&gt; 
    &lt;span class="p"&gt;{&lt;/span&gt; 
      &lt;span class="n"&gt;name&lt;/span&gt;        &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;toTeam&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;destination&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;Team&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="n"&gt;joins&lt;/span&gt;       &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;
        &lt;span class="n"&gt;sourceAttribute&lt;/span&gt;      &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;companyId&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
        &lt;span class="n"&gt;destinationAttribute&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;companyId&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
        &lt;span class="n"&gt;joinSemantic&lt;/span&gt;         &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="n"&gt;EOInnerJoin&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
        &lt;span class="n"&gt;joinOperator&lt;/span&gt;         &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="n"&gt;EOJoinEqualTo&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
      &lt;span class="p"&gt;});&lt;/span&gt; 
    &lt;span class="p"&gt;},&lt;/span&gt; 
  &lt;span class="p"&gt;);&lt;/span&gt; 
&lt;span class="p"&gt;},&lt;/span&gt;
&lt;/pre&gt;&lt;/div&gt;


&lt;p&gt;The header of the model entry defines the name of the entity (“name”) , the table used to represent that entity in the database (“externalName”), the class used in the application to represent entries of this entity type (“className”), and the attribute which defines the unique identifier for each entity (“primaryKeyAttributes”).  Additionally the entity definition contains the following sections: “attributesUsedForLocking”. “classProperties”, “attributes”, and “relationships”.&lt;/p&gt;
&lt;p&gt;The “classProperties” stanza enumerates each of the entity's attributes, including relations.  These attributes and relations are subsequently defined in more detail in the subsequent “attributes” “relationships” stanzas.  Each entry in the “attributes” and “relationships” stanza should be listed in the “classProperties” stanza.&lt;/p&gt;
&lt;p&gt;The attribute named “subCompany” (via “name”) is connected to the database column “sub_company_id” (via “columnName') which has a type of integer (“externalType”) that should be represented at run time by an instance of the “NSNumber” class (“valueClassName”).&lt;br /&gt;
&lt;/p&gt;
&lt;p&gt;Two additional hints are also provided: “allowsNull” and “valueType”.  “allowsNull” indicates if the column in the database permits a null value.  “valueType” hints how to convert the value to an instance of the specified  class1.   Since NSNumber can represent either an integer or a floating-point number the system needs to the hint of “i”, meaning integer, or “d”, meaning floating-point2, in order to correctly instantiate the object. &lt;br /&gt;
&lt;/p&gt;
&lt;p&gt;If this attribute had been a string, as in the case of the “function” attribute of the “CompanyAssignment” entity it would have contained a “width” hint that specifies the maximum length of the string.&lt;/p&gt;
&lt;h3 id="the-eo-objects"&gt;The EO Objects&lt;/h3&gt;
&lt;p&gt;The model is used in the application via a collection of objects provided by the GDL portion of SOPE,  also known as the EOAccess framework.  In the EOAccess framework the model provided to the application is accessed by the EOModel object.&lt;/p&gt;
&lt;h3 id="xml-sax-api-driver-bundle"&gt;XML SAX API Driver Bundle&lt;/h3&gt;
&lt;p&gt;SAX API bundles are provided by SOPE and are not specifically a part of OpenGroupware.  They are however used extensively by the ZideStore service.&lt;/p&gt;
&lt;h3 id="sope-product-bundles"&gt;SOPE Product Bundles&lt;/h3&gt;
&lt;p&gt;SOPE product bundles are provided by SOPE,  and are not specifically a part of OpenGroupware.  However, SOPE is the application framework for OpenGroupware and various services and bundles may in turn utilize SOPE product bundles.&lt;/p&gt;
&lt;h3 id="zidestore-product-bundle"&gt;ZideStore Product Bundle&lt;/h3&gt;
&lt;h3 id="ngobjdom-xml-renderer-bundles"&gt;NGObjDOM XML Renderer Bundles&lt;/h3&gt;
&lt;p&gt;The OpenGroupware suite contains no  NGObjDOM XML Renderer bundles.&lt;/p&gt;
&lt;h3 id="generic-bundles"&gt;Generic Bundles&lt;/h3&gt;
&lt;p&gt;The OpenGroupware suite contains no generic bundles.&lt;/p&gt;
&lt;h3 id="database-adapter-bundles"&gt;Database Adapter Bundles&lt;/h3&gt;
&lt;p&gt;Database adapter bundles are the SOPE equivalent to ODBC or JDBC drivers in C/C++ and Java environments.  The adapter bundle provides the connectivity to a specific database system via the generalized data-access API that the SOPE framework provides to the applications.&lt;br /&gt;
&lt;/p&gt;
&lt;p&gt;In general the All the services of the OpenGroupware suite default to using the PostgreSQL.gdladaptor bundle to connect to the PostgreSQL RDBMS unless an alternative adapter is specified via the LSAdaptor default.  It is the database adapter that uses the contents of the LSConnectionDictionary default as the parameter set for establishing the connection to the backend database;  with different database adapters the appropriate contents for LSConnectionDictionary may change.&lt;/p&gt;
&lt;h2 id="document-api"&gt;Document API&lt;/h2&gt;
&lt;p&gt;The Document API is an abstraction layer built above the OpenGroupware Logic commands with the intent of provided a simplified more object-oriented method for dealing with documents such as contacts, enterprises, projects, etc...  The Document API is used extensively throughout the WebUI and XML-RPC service as well as in certain sections of ZideStore.  However, the Document API is deprecated for a variety of reasons, including performance, and newer development primarily uses the Logic commands directly.&lt;/p&gt;
&lt;p&gt;The Document API provides three types of objects: documents, data sources, and file managers.&lt;/p&gt;
&lt;h2 id="logic"&gt;Logic&lt;/h2&gt;
&lt;p&gt;The Logic layer provides the core functionality of the OpenGroupware.org server.  Every from creating an appointment, to updating a contact's information, to archiving a task is performed by executing one or more Logic commands.  Logic commands are performed within the context of a database transaction so multiple commands can be executed in a sequence and then be rolled back ensuring a consistent data base;  in fact, if the context in which Logic commands are executing abends the rollback is automatic.&lt;/p&gt;
&lt;h2 id="lsfoundation"&gt;LSFoundation&lt;/h2&gt;
&lt;p&gt;The Logic layer itself makes heavy use of the LSFoundation library1 which provides the objects to manage object properties, access, linking, as well as the object used by Logic commands for context information. &lt;/p&gt;
&lt;h2 id="command-context"&gt;Command Context&lt;/h2&gt;
&lt;p&gt;LSFoundation provides a LSCommandContext object that is used pervasively throughout OpenGroupware.  Each request or session has its own context.  From this context commands can be executed (providing access to the PostgreSQL database) as well as acquiring link, property, and type manager objects.&lt;/p&gt;
&lt;h2 id="acls-ogoaccessmanager-ogoaccesshandler"&gt;ACLs, OGoAccessManager, &amp;amp; OGoAccessHandler&lt;/h2&gt;
&lt;p&gt;Logic checks determines access privileges to objects such as contacts, enterprises, appointments, etc... using the OGoAccessManager1 object.  The OGoAccessManager in turn uses OGoAccessHandler objects provided by the appropriate Logic bundles according to the type of entity being checked.  For example, to check permissions on a contact or enterprise the OGoCompanyAccessHandler2 object provided by the LSAddress Logic bundle, whereas checking the permissions on an appointment the OGoAptAccessHandler3 object provided the LSScheduler bundle.&lt;/p&gt;
&lt;p&gt;The access handler object for projects is actually provided by the DocumentAPI bundle which provides the basic project API.  Since the backend to a project is variable, filesystem or database in a default installation, the security model for documents is provided by the project backend.  Since Filesystem projects do not support permissions (all document's are public) no access handler is provided by the filesystem backend.  The database backend for  projects provides the SkyDocumentAccessHandler object.&lt;/p&gt;
&lt;p&gt;When the access manager is requested to perform an access check on an entity which it has not yet encountered,  such as the first time a user searches for contacts, it uses the bundle manager to find out if the bundle providing the entity object contains a “SkyAccessHandlers” key.  The “SkyAccessHandlers” information from the bundle-info connects access control of a specified entity to a specific access handler object. &lt;/p&gt;
&lt;div class="codehilite"&gt;&lt;pre&gt;&lt;span class="n"&gt;SkyAccessHandlers&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; 
    &lt;span class="n"&gt;Person&lt;/span&gt;         &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;OGoCompanyAccessHandler&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
    &lt;span class="n"&gt;Enterprise&lt;/span&gt;     &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;OGoCompanyAccessHandler&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
    &lt;span class="n"&gt;Company&lt;/span&gt;        &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;OGoCompanyAccessHandler&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
    &lt;span class="n"&gt;Team&lt;/span&gt;           &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;OGoCompanyAccessHandler&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
  &lt;span class="p"&gt;};&lt;/span&gt;
&lt;/pre&gt;&lt;/div&gt;


&lt;p&gt;Once a bundle has been identified as providing access handlers it is checked for all the access handlers it provides;  the results of this check are cached for future reference1.  The bundle-info plist of the specified bundle is first checked for a OGoAccessHandlers key.  If no such key is found existence of a SkyAccessHandlers is checked.  If no such key is found in the bundle information then it is assumed that the bundle provides no access handlers.   If an appropriate key is found it is treated as a dictionary where entity names are mapped to class names.&lt;/p&gt;
&lt;p&gt;The actual checking of permissions using the OGoAccessManager can be formed in various ways using the appropriate methods. The “Debugging” chapter contains documentation on the “OGoAccessManagerDebugEnabled” and SkyAccessManagerDebug” defaults that can be used to increase the verbosity of logging related to access control operations, see the “Access Control” section of that chapter.&lt;/p&gt;
&lt;p&gt;Documents such as accounts and resources for which no access handler is provided are generally treated as read-only for all user's, except the OpenGroupware administrative account.&lt;/p&gt;
&lt;p&gt;The command line tool “ogo-acl-list” can be used to invoke the access handler object and test the access levels to specified documents1.  For example, to list the access privileges concerning enterprise 4036510:&lt;/p&gt;
&lt;div class="codehilite"&gt;&lt;pre&gt;$ &lt;span class="n"&gt;ogo&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;acl&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;list&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;login&lt;/span&gt; &lt;span class="n"&gt;adam&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;password&lt;/span&gt; &lt;span class="o"&gt;*******&lt;/span&gt; 4036510
&lt;/pre&gt;&lt;/div&gt;


&lt;h2 id="ogoaptaccesshandler"&gt;OGoAptAccessHandler&lt;/h2&gt;
&lt;p&gt;Permissions for appointment objects are more specialized than those for most other objects. Appointments support for following permissions: delete, edit, list, and view. Most objects, such as Contacts and Enterprises, simply support read and write. For internal uses the appointment permission “view” is mapped to “read” and the permission “edit” is mapped to write.  This mapping allows other objects such as the property manager to consistently determine if a given context has the correct permissions to view or modify the contents of an object regardless of if that object is a Contact, Enterprise, or an Appointment.&lt;/p&gt;
&lt;p&gt;Permission checks on appointments are handled by the  OGoAptAccessHandler object which in turn uses the “appointment::access” Logic command to retrieve a map of the permissions provided to the specified objects.  The “appointment::access” command is documented in the Logic Commands section of the appendix.&lt;/p&gt;
&lt;p&gt;The “view” permission, represented internally as “v”, grants a user the right to see the appointment details such as title, location, comment, and any associated properties.  The related permission of “list”, represented internally as “l”, provides the context with only an outline of an appointment including start, end, and participants.  A user's private appointments, when requested by another user who is not a participant of that appointment, is available under only the “list” permission.&lt;/p&gt;
&lt;p&gt;The owner of an appointment always has all rights to the appointment.&lt;/p&gt;
&lt;h2 id="ogocompanyaccesshandler"&gt;OGoCompanyAccessHandler&lt;/h2&gt;
&lt;p&gt;The company access handler is used for access control of both contact and enterprise. Permissions of contact and enterprise are implemented via ownership, privacy status, and access control lists. Access control lists are stored in the “object_acl” table which is represented in the object model as “ObjectAcl”.&lt;/p&gt;
&lt;h2 id="skydocumentaccesshandler"&gt;SkyDocumentAccessHandler&lt;/h2&gt;
&lt;h2 id="skyprojectaccesshandler"&gt;SkyProjectAccessHandler&lt;/h2&gt;
&lt;h2 id="skytaskaccesshanlder"&gt;SkyTaskAccessHanlder&lt;/h2&gt;
&lt;p&gt;Object links represent directional relationships between objects and are managed by the Object Link Manager object. Applications acquire a reference to a object link  manager object by calling the “linkManager” method of their context object; this object is used to create, delete, and retrieve object links. Object links are never updated or modified; they are only created  or destroyed.&lt;/p&gt;
&lt;p&gt;An object link has eight properties:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;sourceId – Identifies via primary key the object which is the origin of the link.&lt;/li&gt;
&lt;li&gt;targetId – Identitifes via primary key the object which is the target of the link. This value may be null if the object link references an object external to the groupware server; in that case the target is identified via the “target” attribute. Use of external link targets is largely untested.&lt;/li&gt;
&lt;li&gt;sourceType – The entity name of the object which is the origin of the link.&lt;/li&gt;
&lt;li&gt;targetType – If the target of the link is a groupware entity this attribute returns the entity name of that object.&lt;/li&gt;
&lt;li&gt;target – Returns the string identifying the target of the link. If the link targets a groupware entity this value will be the string representation of the value returned by “targetId”.&lt;/li&gt;
&lt;li&gt;label – An arbitrary string used to identify the link; a link label may be up to 255 characters in length.&lt;/li&gt;
&lt;li&gt;linkType – A string which identifies the type of the link. An untyped (known as “generic”) link will have a NULL linkType. Link types are defined via the  OGoObjectLinkTypeMap default as documented in the “Object Linking” section of the “Customization” chapter.&lt;/li&gt;
&lt;li&gt;globalID – The EOGlobalID of the link object itself.&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;In addition to these eight attributes the object link object also provides “sourceGID” and “targetGID” accessors which provided the EOGlobalID values corresponding to the “sourceId” and “targetId” respectively.&lt;/p&gt;
&lt;p&gt;Object link information is stored in the “obj_link” table.  Each object link has a unique id which is stored in the “obj_link_id” field as the primary key of the table and is represented by the “globalID” property of the object link object.&lt;/p&gt;
&lt;p&gt;For information on configuring object link types as well as enabling or disabling the object link viewer tab provided in the WebUI see the “Object Linking” section of the “Customization” chapter.&lt;/p&gt;
&lt;h2 id="property-manager"&gt;Property Manager&lt;/h2&gt;
&lt;p&gt;The Property Manager (SkyObjectPropertyManager) object manages custom attributes and arbitrary data associated with a groupware objects such as an appointment, job, or project. Object properties are stored in the “obj_property” table of the instance's' PostgreSQL database;  all operations on this table are performed by an instance of the property manager object.&lt;/p&gt;
&lt;p&gt;Applications acquire a reference to a property manager object by calling the “propertyManager” method of their context object. From that object they can load all the properties related to an object via the “propertiesForGlobalID” method which must be provided with the object's EOGlobalID and optionally accepts a namespace. If no name-space is specified all the properties for the object are loaded.  Otherwise the “namespace” parameter to the method will restrict the loaded properties to those within the specified namespace. If “namespace” is specified but the value is NULL the property manager will behave as if no name-space was provided.&lt;/p&gt;
&lt;h2 id="type-manager"&gt;Type Manager&lt;/h2&gt;
&lt;p&gt;The Type Manager1 is used to determine the type of groupware object referenced by an id.  For instance an application will ask the Type Manager about the type of object 10,160.  The Type Manager will return that the object is a Contact, Appointment, etc...&lt;br /&gt;
 * - (NSArray &lt;em&gt;)entityNamesForObjects:(NSArray &lt;/em&gt;)_objects; &lt;br /&gt;
 * - (NSArray &lt;em&gt;)entityNamesForGlobalIDs:(NSArray &lt;/em&gt;)_gids; &lt;br /&gt;
 * - (NSString &lt;em&gt;)entityNameForObject:(id)_object; &lt;br /&gt;
 * - (NSString &lt;/em&gt;)entityNameForGlobalID:(EOGlobalID *)_globalId;&lt;/p&gt;&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Sebastian Reitenbach</dc:creator><pubDate>Thu, 10 Jan 2013 18:30:31 -0000</pubDate><guid isPermaLink="false">https://sourceforge.net81528784b5dccf16e7116e9db5c146a290dec0b6</guid></item><item><title>WikiPage FAQ modified by Sebastian Reitenbach</title><link>https://sourceforge.net/p/opengroupware/wiki/FAQ/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v3
+++ v4
@@ -13,3 +13,9 @@
 OpenGroupware.org:
 Could not execute command view for types: &amp;lt;NGMimeType: eo-gid/project&amp;gt;
 This indicates you are missing the appropriate storage backend,  either the filesystem backend or the database backend.  This is most likely a failure of your package manager;  simply install the missing package and the projects of the type producing the error will work normally again.  Most installations should have two packages for project backend: “ogo-docapi-fs-project” &amp; “ogo-docapi-db-project”
+
+If I change a WOD or WOX file do I need to recompile the respective applications?
+---------------------------------------------------------------------------------
+
+No,  changes to a WOD or WOX file are effective as soon as the service is restarted.
+
&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Sebastian Reitenbach</dc:creator><pubDate>Thu, 10 Jan 2013 18:12:45 -0000</pubDate><guid isPermaLink="false">https://sourceforge.netbdc2f776582d88efa957065035b2f91febc46893</guid></item><item><title>WikiPage ZideStore modified by Sebastian Reitenbach</title><link>https://sourceforge.net/p/opengroupware/wiki/ZideStore/</link><description>&lt;div class="markdown_content"&gt;&lt;h1 id="zidestore"&gt;ZideStore&lt;/h1&gt;
&lt;p&gt;ZideStore is OpenGroupware's integration server;  it provides access to the functionality of the groupware server through a variety of protocols.  Protocols are plugged into ZideStore via ZSP bundles which are each a collection of resources and shared libraries.  The purpose of ZideStore is to facilitate interoperability of the server with as wide a variety of clients and other applications as possible.&lt;/p&gt;
&lt;h2 id="protocols"&gt;Protocols&lt;/h2&gt;
&lt;h3 id="caldav"&gt;CalDAV&lt;/h3&gt;
&lt;p&gt;CalDAV is a standard proposed by the IETF to allow interoperability of collaboration systems when dealing with calendar information.  CalDAV builds on top of HTTP, WebDAV, WebDAV ACLs and iCalendar to provide reasonably robust calendaring functionality that can be implemented by a variety of clients and servers.  It is important to distinguish between CalDAV and iCalendar.  CalDAV deals with events and collections of events,  allowing events to be operated upon on a per-event basis.  iCalender the specification used to encode each event.  This differs significantly, but can be confused with, what is often referred to as an “iCalendar Server” (which ZideStore also is),  see the section in this chapter on “iCalendar Limitations” for more information.&lt;/p&gt;
&lt;p&gt;CalDAV is a more sophisticated specification that GroupDAV which adds a collection of operations specifically to meet the needs of calendaring applications.  ZideStore support for the CalDAV specification is not yet complete and provides only partial compatibility with the various CalDAV clients (see the “CalDAV Clients” section of this chapter for details).&lt;/p&gt;
&lt;p&gt;The most notable distinction between CalDAV and WebDAV is that CalDAV expands the protocol to include a set of REPORT operations.  The REPORT operation itself is an extension to the WebDAV protocol1.  The REPORT operation adds to the WebDAV protocol a way for clients to perform more complicated operations upon the servers data (including query operations).   REPORT permits the consolidation of operations that would potentially require multiple round-trips between the client and the server into a single request – essentially moving the complexity of the application from the client to the server.&lt;/p&gt;
&lt;h3 id="caldavcalendar-query"&gt;CALDAV:calendar-query&lt;/h3&gt;
&lt;p&gt;The calendar-query REPORT returns all the calendar objects in the specified collection that match the filter specified in the REPORT request.&lt;/p&gt;
&lt;h3 id="caldavcalendar-multiget"&gt;CALDAV:calendar-multiget&lt;/h3&gt;
&lt;h3 id="caldavfree-busy-query"&gt;CALDAV:free-busy-query&lt;/h3&gt;
&lt;h3 id="freebusy"&gt;Free/Busy&lt;/h3&gt;
&lt;p&gt;Free/Busy is part of the iCalendar specification and is a way of representing the availability of a person or resource for the purposes of detecting conflicts or proposing scheduling.   Free/Busy information can be retrieved from ZideStore via a simple HTTP request.  Retrieval of free/busy information from ZideStore is covered in the Schedular section of this document.&lt;/p&gt;
&lt;h3 id="groupdav"&gt;GroupDAV&lt;/h3&gt;
&lt;p&gt;GroupDAV is a specification that is both a subset of CalDAV and a complement to CalDAV.  One of the focuses of the GroupDAV protocol is to remain as simple as possible while still providing a useful set of functionality;  like CalDAV the main point of GroupDAV is interoperability between a variety of clients, servers, and other applications.  GroupDAV is a complement to CalDAV in that it provides a standard protocol, also built on the HTTP and WebDAV protocols, to access not just events but contacts, tasks, and other types of objects.  It is a subset of CalDAV as it is build upon the same standard foundations and a server that is a GroupDAV server can implement CalDAV as well;  in a sense,  CalDAV on top of GroupDAV, in order to provide access to contacts and tasks as well as events.&lt;/p&gt;
&lt;h3 id="icalendar"&gt;iCalendar&lt;/h3&gt;
&lt;p&gt;iCalendar is actually not a protocol, but a specification for the exchange of calendar and event information.  However iCalendar information is frequently delivered over networks as either e-mail attachments or HTTP;  iCalendar over HTTP is almost a defacto standard simply from the prevalence of its use.  ZideStore will deliver a user or groups calendar information in iCalendar format in response to certain HTTP requests making it possible to use simple iCalendar clients such as Mozilla's SunBird to view a calendar.  However, working with calendars in this manner is a bulk operation making it very difficult to modify a single event – the entire calendar of events available to the client at a given URL is retrieved and save in a single bulk operation;  this severely limits the usefulness of iCalendar over HTTP as a true groupware solution.  iCalendar also has no way of representing access permissions,  such as if a given event is available to a user for viewing but cannot be modified (read-only).&lt;/p&gt;
&lt;h3 id="prefsui"&gt;PrefsUI&lt;/h3&gt;
&lt;p&gt;The PrefsUI is not really so much a protocol as a simple application.  If a user attempts to access the ZideStore server with a web browser they will access the PrefsUI bundle.&lt;/p&gt;
&lt;h3 id="rss"&gt;RSS&lt;/h3&gt;
&lt;p&gt;RSS is either “Really Simple Syndication” (RSS 2.0) or “Rich Site Summary” (RSS 0.91 and RSS 1.0).  RSS is an XML over HTTP protocol used by RSS reader / news aggregator applications to display new or changed content from a feed or collection of feeds.  A given feed may be a news oriented website, a blog, podcast site, or in the context of OpenGroupware a project.&lt;/p&gt;
&lt;h3 id="webdav"&gt;WebDAV&lt;/h3&gt;
&lt;p&gt;WebDAV is the core protocol of the ZideStore server.  Most content stored within the groupware server can be accessed by navigating the ZideStore folder tree with a WebDAV client; with the proper client this content can be modified in much the same fashion as a user would manage files and folders in a traditional filesystem.&lt;/p&gt;
&lt;h3 id="zogi"&gt;zOGI&lt;/h3&gt;
&lt;p&gt;ZOGI is a ZideStore bundle that provides a simple XML-RPC API for utilizing the functionality provided by the OpenGroupware server.&lt;/p&gt;
&lt;h2 id="defaults"&gt;Defaults&lt;/h2&gt;
&lt;h3 id="cache-debugging"&gt;Cache Debugging&lt;/h3&gt;
&lt;p&gt;ZideStore does a significant amount of caching of data in order to improve performance and reduce load on the backend database.  See the entries in this section for “Disk Cache” and “Memory Cache” for information on how to tune or set the caching parameters.  Debugging of the cache can be enabled by setting the “SxDebugCache” to a value of “YES”,  deleting this default will disable logging of cache operatons.  Enabling cache debugging can have a detrimental affect on performance as it can significatly increase the amount of information being sent to the systems' log files.&lt;/p&gt;
&lt;h3 id="calendar-scope"&gt;Calendar Scope&lt;/h3&gt;
&lt;p&gt;The size of responses to event requests can be controlled by specifying the number of months that ZideStore will examine.  Two defaults control, respectively, how many months into the past and months into the future that ZideStore will render in response to calendar requests.  The  span of events in the event collections such a the Calendar and Overview folders are controlled by the SxAptFolder_MonthsIntoPast and SxAptFolder_MonthsIntoFuture defaults.   SxAptFolder_MonthsIntoPast defaults to two months and SxAptFolder_MonthsIntoFuture defaults to 12 months.  Increasing or decreasing the span for which events are rendered can have a significance effect of server performance.&lt;/p&gt;
&lt;h3 id="content-caching"&gt;Content Caching&lt;/h3&gt;
&lt;p&gt;When a client requests the vCard for a contact or enterprise ZideStore caches the generated vCard as a file. This allows it to simply read the file and stream the content to the next client requesting the same vCard provided the contents of the database has not changed. This facilitates a very high throughput when clients syncronize with the server via WebDAV. The penalty is the creation of potentially ten of thousands of vCard files; directories containing very large numbers of files can demonstrate much worse performance for file operations than those with smaller numbers of files.&lt;/p&gt;
&lt;p&gt;The default location for this content cache is the OpenGroupware documents folder1. If the documents folder is located on a SAN or a NAS, which introduce network latency, the throughput benefit of the cache may be diminished. For smaller sites this is unlikely to pose a significant problem; larger sites, or  sites with very large numbers of contacts, should consider relocating the content cache and enable hashing of the cache content. If the documents folder is located on a SAN or a NAS relocating it to local storage is strongly recommended. Backup of cache contents is not a concern as the contents will automatically be regenerated in the event of data loss. Relocation of the content cache is performed by defining an alternative path via the “LSVCFCachePath” default2. The specified path must be accessible by the OpenGroupware user.&lt;/p&gt;
&lt;div class="codehilite"&gt;&lt;pre&gt;&lt;span class="n"&gt;defaults&lt;/span&gt; &lt;span class="n"&gt;write&lt;/span&gt; &lt;span class="n"&gt;NSGlobalDomain&lt;/span&gt; &lt;span class="n"&gt;LSVCFCachePath&lt;/span&gt; &lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;var&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;opengroupware&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;vCard&lt;/span&gt;
&lt;span class="n"&gt;defaults&lt;/span&gt; &lt;span class="n"&gt;write&lt;/span&gt; &lt;span class="n"&gt;NSGlobalDomain&lt;/span&gt; &lt;span class="n"&gt;LSHashVCFCache&lt;/span&gt; &lt;span class="n"&gt;YES&lt;/span&gt;
&lt;/pre&gt;&lt;/div&gt;


&lt;p&gt;Enabling of hashing of cache content is enabled by setting the “LSHashVCFCache” to value of “YES”.  If hashing is not enabled the cache consists of files stored in either the document root or the path defined via “LSVCFCachePath”; this configuration can manifest the large directory problem. If hashing is enabled the last two digits of the object's primary key are used to construct an additional path component where the object's vCard representation will be stored. For example: without hashing version seven of the contact with id 1,675,689 will be stored in the root of the cache path as “1675689.7.vcf”, if hashing is enabled the same vCard would be cached as “vcfdir89/1675689.7.vcf”. With hashing enabled the root of the cache will contain up to one hundred folders each of which will contain the appropriate subset of objects. In either case the filename uniquely identifies the specific version of the contact so that ZideStore can easily determine if it is a valid representation of the database contents.&lt;/p&gt;
&lt;p&gt;Since even very large numbers of vCard files still consume relatively little storage it may be worthwhile for some sites to avoid even the use of local storage and to provision the content cache onto a RAM disk. On LINUX systems this is easily accomplished by the creation of a tmpfs filesystem of sufficient size1. Once the virtual volume has been provisioned and the permissions of the mount point set appropriately use the “LSVCFCachePath” default to relocate the content cache. This provides the advantage of avoiding disk I/O completely.&lt;/p&gt;
&lt;h3 id="group-overview-folders"&gt;Group Overview Folders&lt;/h3&gt;
&lt;p&gt;For each user a “/Overview” folder is provided which contains all the events for which the user is participant.  In some situations it may be useful to provide equivalent folders for teams,  such a folder is called a “Group Overview” folder.  Group Overview folders are disabled by default as they can significantly increase server load and may also contain a very large number of events.  In order to enable group overview folders set the “ZLShowGroupOverviewCalendars” to “YES” in either the appropriate ZideStore domain or the NSGlobalDomain domain.&lt;/p&gt;
&lt;p&gt;The “/public” folder is provided for when a user wishes to access all the appointments they have permission to see, so not Group Overview folder is provided for the “all intranet” team even if you enable Group Overview folders.&lt;/p&gt;
&lt;h3 id="memory-limit"&gt;Memory Limit&lt;/h3&gt;
&lt;p&gt;The ZideStore service maintains a large in memory cache of recently cached objects and other related information.  This results in the memory footprint of the service to be quite large.  The maximum footprint of the service is controlled by SxVMemLimit default which has a default value of 200.  The value of  SxVMemLimit is in megabytes.  This will cause the ZideStore service to reset itself once its footprint reaches 200 megabytes.&lt;/p&gt;
&lt;h2 id="zidestore-urls"&gt;ZideStore URLs&lt;/h2&gt;
&lt;h3 id="collections-vs-object"&gt;Collections vs. Object&lt;/h3&gt;
&lt;p&gt;One important distinction in understating ZideStore URLs is the difference between a URL that references a collection and a URL that references an object.  While HTTP as traditionally used by web browsers only uses URLs to reference objects (pages or images) other protocols which are based on HTTP support the concept of collections.  Collections are very much like folders in a traditional filesystem;  they have no content of their own but serve to provide a namespace within which objects exists as well as additional collections.  The best example of this distinction is the ZideStore URLs for the Overview folder and the Overview ICS file.  The “/zidestore/so/fred/Overview” URL refers to a collection that contains all of the appointments in which user “fred” is a participant.  Protocols such as DAV, GroupDAV, and CalDAV can use this URL to enumerate these appointments.  However the URL “/zidestore/so/fred/Overview/ics” refers to an iCalendar object whose contents is an enumeration of all the appointments in which user “fred” is a participant.  This second URL can be requested by typing the URL into the address bar of your web browser or even using a utility like “curl”.&lt;/p&gt;
&lt;h3 id="freebusy-information"&gt;Free/Busy Information&lt;/h3&gt;
&lt;p&gt;Retrieval of a user's free/busy information is documented in the “Scheduler” chapter.&lt;/p&gt;
&lt;h3 id="folder-hierarchy"&gt;Folder Hierarchy&lt;/h3&gt;
&lt;p&gt;In the  standard configuration a user's root collection will contain nine folders: Calendar, Enterprises, Overview, public, Trash, Contacts, Groups, Projects, and Tasks.  The Calendar, Enterprise, and Contacts folder of the user's root collection contain the corresponding type of entities which are marked as private to the user.&lt;br /&gt;
&lt;/p&gt;
&lt;p&gt;The root Groups folder will contain an object for each of the teams of which the user is a member.  The objects in the Groups folder are both folders and vCard objects; as a folder each group contains a vCard object of each account belonging to the team.  Beneath the root Groups subfolder is a “Calendar” and an “Overview” folder.  The “Calendar” folder contains all the appointments and having the appropriate group specified as the appointment's read access group1.  The “Overview” folder contains all the appointments which have either the appropriate group or a member of that group as a participant2.  Both “Calendar” and “Overview” are additionally constrained within the range defined by the SxAptFolder_MonthsIntoPast and SxAptFolder_MonthsIntoFuture defaults. For example the folder “/Groups/news editors/” contains a vCard for each member of the “news editors” team and the “/Groups/news editors/Calendar/” contains appointments where the read access group is “news editors”.  The root Groups folder itself is read-only,  team membership cannot be modified through ZideStore by putting or deleting vCard entries in a group folder.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;User Folder&lt;/li&gt;
&lt;li&gt;Contacts&lt;/li&gt;
&lt;li&gt;Enterprises&lt;/li&gt;
&lt;li&gt;Tasks&lt;/li&gt;
&lt;li&gt;Calendar&lt;/li&gt;
&lt;li&gt;public&lt;ul&gt;
&lt;li&gt;Contacts&lt;/li&gt;
&lt;li&gt;Enterprises&lt;/li&gt;
&lt;li&gt;Calendar&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;Overview&lt;/li&gt;
&lt;li&gt;Groups&lt;ul&gt;
&lt;li&gt;{Team}&lt;/li&gt;
&lt;li&gt;Overview&lt;/li&gt;
&lt;li&gt;Calendar&lt;/li&gt;
&lt;li&gt;Task&lt;/li&gt;
&lt;/ul&gt;
&lt;/li&gt;
&lt;li&gt;Trash&lt;/li&gt;
&lt;/ul&gt;
&lt;p&gt;The root Overview folder is probably the most useful of the calendar folders,  it contains every appointment where the user is a participant;  this includes any appointment where a team of which the user is a member is a participant.  This is the only selection of calendar events, by default, which is based on participation.  Most collections presented to the client by ZideStore are based on permissions.  The collection of appointments in the root Overview folder should be the same as that presented in the default view of the schedule application in the web UI.&lt;/p&gt;
&lt;p&gt;The Contacts and Enterprises folder in the root user folder contain contacts that are marked as private, owned by the user, and not accounts. Likewise the root Calendar contacts all the appointments of the with the scope defined by SxAptFolder_MonthsIntoPast and SxAptFolder_MonthsIntoFuture defaults and with no read access team;  appointments with no read access team are considered private. The contents of the root Tasks folder consists of non-archived tasks of an unspecified type,  having the current user as the executor.&lt;/p&gt;
&lt;p&gt;The Contacts and Enterprises folders of  public folder display all the contact and enteprise entries, respectively, to which the current user has read access and are not marked as private1.  Qualified objects are then filtered for permissions.  It is important to note that in the OpenGroupware permissions model the application of ACLs trump the permissions applied by the privacy flag on an object;  so a user may be able to view contacts and enterprises in the web interface that are not available via the public folders in ZideStore.  This occurs when ACLs are applied to an object by the privacy flag is unset.&lt;/p&gt;
&lt;p&gt;The public Calendar folder contains all appointments with the “all intranet” team as the read access team and qualified within the range specified by the SxAptFolder_MonthsIntoPast and SxAptFolder_MonthsIntoFuture defaults.&lt;/p&gt;
&lt;h3 id="properties"&gt;Properties&lt;/h3&gt;
&lt;p&gt;Attributes of objects are also exposed as WebDAV properties.  Most objects in ZideLook support the common WebDAV properties of: “davDisplayName”, “davIsCollection”,  “davIsFolder”, “davHasSubFolders”, “davContentLength”, and “davLastModified”&lt;/p&gt;
&lt;p&gt;Tasks provide the following attributes: “sensitivity”, “priority”, “importance”, “actualWorkInMinutes”, “totalWorkInMinutes”, “isTeamTask”, “taskCompletion”, “taskStatus”, “subject”, “textdescription”, “keywords”, “taskCommonStart”, “taskCommonEnd”,  and “taskCompletionDate” provides the task's completion date if the task is complete.  “textdescription” contains the tasks initial comment.  “taskCommonStart” contains the task's start date. “taskCommonEnd” contains the task's end date.  “taskCompletionDate” contains the date the task was completed if the task is currently in a “done” state, otherwise it returns the current date.&lt;/p&gt;
&lt;h3 id="vcard-retrieval"&gt;vCard Retrieval&lt;/h3&gt;
&lt;p&gt;A simple authenticated GET request to an appropriate folder is all that is required to retrieve the vCard representation of an OpenGroupware object.  The primary key of the object is the name of the resource within the collection;  any or no file extension will be ignored (characters beyond the first period).  The contents of each folder can be enumerated via a DAV request (see “Requesting a WebDAV collection“ pg.90). In the results of a folder enumeration either the “href” elements or the “getetag” properties can be used to identity resources that can be retrieved via a GET.&lt;/p&gt;
&lt;p&gt;The rendering of vCards for Contacts and Enterprises is performed via execution of the “company::get-vcard” command.  This command and the exact mapping of OGo object properties to vCard attributes is documented in the Logic Commands appendix's entry for “company::get-vcard”.&lt;/p&gt;
&lt;p&gt;It is not possible to search for contacts or enterprises via simple HTTP,  ZideStore has only very limited support for DASL. The common practice for clients such a Thunderbird, Evolution, or Microsoft Outlook (via ZideOne) is to enumerate a collection and download all objects to a local cache.  Searching and other operations are then performed on the local cache with changes propagated by publishing changed objects back to the server using their &lt;a class="alink" href="modified"&gt;[modified]&lt;/a&gt; vCard representations.&lt;/p&gt;
&lt;h2 id="updating-data-via-http"&gt;Updating Data Via HTTP&lt;/h2&gt;
&lt;h3 id="putting-a-vcard"&gt;Putting A vCard&lt;/h3&gt;
&lt;p&gt;When a vCard is uploaded via an HTTP put operation to a collection (folder) the URL is examined to determine if the PUT is meant to be an update of an existing object or the creation of a new object.  If no id is provided for the object it is assumed to be a request to create a new object.  If the URL contains an id that value will be interpreted as the primary key of the object to update.  For example, a PUT to the URL: “&lt;a href="http://127.0.0.1/zidestore/dav/adam/public/Contacts/"&gt;http://127.0.0.1/zidestore/dav/adam/public/Contacts/&lt;/a&gt;” will create a new contact while a PUT to the URL: ““&lt;a href="http://127.0.0.1/zidestore/dav/adam/public/Contacts/10100.vcf"&gt;http://127.0.0.1/zidestore/dav/adam/public/Contacts/10100.vcf&lt;/a&gt;” will result in an update to contact with the primary key of 10,100.&lt;/p&gt;
&lt;p&gt;In the case of a collection (folder) of either Contact or Enterprise objects the update or creation is performed via the “company::set-vcard” Logic command1 after parsing the uploaded data via the parseVCardsFromSource method of the NGVCard class.  If parsing of the vCard data fails the server will return a HTTP 400 error with the message “The request did not contain a valid vCard”.  If saving the vCard data via the logic command fails the server will return an HTTP 500 error.  The successful creation of a new object will return to the client a location header indicating the URL of the new object.&lt;/p&gt;
&lt;h4 id="mapping-vcard-fields"&gt;Mapping vCard Fields&lt;/h4&gt;
&lt;p&gt;The initial parsing of the vCard file is perfomed by the SAXXML parser provided by SOPE.  The NGVCard class utilizes the SaxXMLReaderFactory class to the transform the vCard data into XML which is then managed via the NGVCardSaxHandler class.  For a complete examination of the mapping of vCard attributes to OpenGroupware object properties see the documentation on the “company::set-vcard” command in the chapter “Logic”.  Some information, including how to manually test vCard translation, is covered in the “iCalendar Parsing” section of the chapter “Debugging”.&lt;/p&gt;
&lt;h4 id="mapping-vcard-address-fields"&gt;Mapping vCard Address Fields&lt;/h4&gt;
&lt;p&gt;The mapping of addresses provided in vCards to those of Contact or Enterprise objects is performed by the “company::set-vcard” Logic command which uses the LSVCard_PersonAddressRevMapping and LSVCard_EnterpriseAddressRevMapping defaults which are built into the LSAddress bundle.&lt;/p&gt;
&lt;h4 id="mapping-vcard-telephone-fields"&gt;Mapping vCard Telephone Fields&lt;/h4&gt;
&lt;h3 id="resolving-participants-in-appointments"&gt;Resolving Participants In Appointments&lt;/h3&gt;
&lt;p&gt;When presented with an event ZideStore processes the participants from the “ATTENDEE” attributes based upon the “MAILTO” value.  In a vCalendar event the attendee attribute will look something like this:&lt;/p&gt;
&lt;div class="codehilite"&gt;&lt;pre&gt;&lt;span class="n"&gt;ATTENDEE&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="n"&gt;CUTYPE&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&amp;quot;&lt;span class="n"&gt;INDIVIDUAL&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="n"&gt;PARTSTAT&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&amp;quot;&lt;span class="n"&gt;NEEDS&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;ACTION&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="n"&gt;ROLE&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&amp;quot;&lt;span class="n"&gt;REQ&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;PARTICIPANT&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="n"&gt;RSVP&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&amp;quot;&lt;span class="n"&gt;FALSE&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="n"&gt;CN&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&amp;quot;&lt;span class="n"&gt;Adam&lt;/span&gt; &lt;span class="n"&gt;Williams&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="n"&gt;MAILTO&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="n"&gt;adam&lt;/span&gt;&lt;span class="p"&gt;@&lt;/span&gt;&lt;span class="n"&gt;example&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;com&lt;/span&gt;
&lt;/pre&gt;&lt;/div&gt;


&lt;p&gt;This single line contains all the information pertaining to the attendee.  ZideStore ignores the “CUTYPE” attribute and relies solely on the “MAILTO” attribute which is compared with the “email1” extended attribute in the PostgreSQL database in order to match the attendee record with a contact or team1.  Only the “email1” attribute will be checked;  for purposes of resolving participants the “email2” and “email3” extended attributes are not considered.  For each attendee attribute ZideStore will attempt four queries to locate the contact:&lt;br /&gt;
 * Non-private contacts that are also accounts&lt;br /&gt;
 * Non-private contacts that are not acocunts&lt;br /&gt;
 * Private contacts (owned by the current user)&lt;br /&gt;
 * Teams&lt;/p&gt;
&lt;p&gt;If all of these checks fail ZideStore will attempt to create a contact record for the participant – when no database match was found ZideStore assumes the participant is an individual (not a group).  For example, an attendee record of:&lt;/p&gt;
&lt;div class="codehilite"&gt;&lt;pre&gt;&lt;span class="n"&gt;ATTENDEE&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="n"&gt;CUTYPE&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&amp;quot;&lt;span class="n"&gt;INDIVIDUAL&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="n"&gt;PARTSTAT&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&amp;quot;&lt;span class="n"&gt;NEEDS&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;ACTION&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="n"&gt;ROLE&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&amp;quot;&lt;span class="n"&gt;REQ&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;PARTICIPANT&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="n"&gt;RSVP&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&amp;quot;&lt;span class="n"&gt;FALSE&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt;&lt;span class="n"&gt;CN&lt;/span&gt;&lt;span class="p"&gt;=&lt;/span&gt;&amp;quot;&lt;span class="n"&gt;Tom&lt;/span&gt; &lt;span class="n"&gt;Bob&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="n"&gt;MAILTO&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="n"&gt;MAILTO&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="n"&gt;tbob&lt;/span&gt;&lt;span class="p"&gt;@&lt;/span&gt;&lt;span class="n"&gt;example&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;com&lt;/span&gt;
&lt;/pre&gt;&lt;/div&gt;


&lt;p&gt;will create a new contact with first name “Tom”, last name “Bob”, and an e-mail address of “tbob@example.com” provided no record with an e-mail address of “tbob@example.com” exists.  This creation of new records prevents data-loss but it is advisable to create contact records previously to using contacts as participants as the record created will have minimal information and be private to the user who created the appointment1.   One result of the privacy is that, while the appointment may be available to user users, the new contact will not.  If the intention of the user was to share the contact they will need to log into the system and change the permissions to appropriate values.&lt;/p&gt;
&lt;h3 id="caldav-clients"&gt;CalDAV Clients&lt;/h3&gt;
&lt;p&gt;CalDAV clients vary significantly in the features of the CalDAV specification that they exercise and how they deal with issues such a timezones.  Therefore CalDAV support needs to be tested rather extensively on a per-client basis.  If the CalDAV client you are attempting to use experiences problems when communicating with ZideStore please report the issue to the OpenGroupware project following the procedures described in “Reporting CalDAV Issues”.&lt;/p&gt;
&lt;h3 id="reporting-caldav-issues"&gt;Reporting CalDAV Issues&lt;/h3&gt;
&lt;p&gt;If a CalDAV client experiences issues communicating with ZideStore is is advised to capture the HTTP request from the client using the “WOHttpAdaptor_LogStream” default as described in the Debugging chapter.  Then emulate the operation using the curl utility.  If the response is not valid or ZideStore reports an error the exchange between the client and the server should be reported to the OpenGroupware buzilla along with the name and version of the client.   It is also helpful if the exchange is captured with the  “SoDebugObjectTraversal”, “SoRendererDebugEnabled”, and “PGDebugEnabled” defaults enabled.&lt;/p&gt;
&lt;h2 id="zidestore-bundles"&gt;ZideStore Bundles&lt;/h2&gt;
&lt;p&gt;ZideStore's core functionality can be extended by ZideStore Bundles.  With a standard installation ZideStore already includes a set of bundles: “Appointments.zsp”, “Contacts.zsp”, “EvoConnect.zsp”, “PrefsUI.zsp”, “Projects.zsp”, “RSS.zsp”, “Tasks.zsp”, “WCAP.zsp”, “zOGI.zsp”, and “ZSCommon.zsp”.  As you can probably guess by looking at this list much of ZideStore's core functionality is actually implemented via bundles.&lt;/p&gt;
&lt;p&gt;ZideStore searches for and loads bundles when it is first started;  the bundles loaded are enumerated in the error file.  Immediately after being started, and before processing any requests, ZideStore will write log entries about that.&lt;/p&gt;
&lt;p&gt;The “ PATHES” entry displays the paths that are searched for bundles, and subsequent entries up until the “vMemSize check enabled” entry enumerates the ZideStore bundles that were found and loaded.&lt;br /&gt;
For general information on bundles see the “Architecture” chapter.&lt;/p&gt;
&lt;h2 id="rss-support"&gt;RSS Support&lt;/h2&gt;
&lt;p&gt;Folders and objects in the ZideStore hierarchy may supply an RSS feed providing additional information about the collection or object.  RSS support is invoked whenever a request is made with a filename suffix of “.rss” or “.xml”. A default RSS feed may be retrieved on a collection by requesting the “rss” object within that collection. Additional RSS feeds intended for specific purposes may be available, these are referred to as “special purpose” RSS feeds.&lt;/p&gt;
&lt;p&gt;Special purpose RSS feeds support at least the “limit” parameter which determines the number of items that will be included in the feed.  The default limit, unless documented otherwise, for a feed is 150 items.&lt;br /&gt;
&lt;/p&gt;
&lt;p&gt;The links provided by the auto-generated RSS must be configured for each site;  if the links are not provided or are not valid some RSS readers will refuse to process or display the content of the feed.  The channel link of RSS feeds generated by the server are set via the “﻿RSSDefaultChannelLinkURL” default.  It is intended that this link point to the OpenGroupware WebUI login page or some portal to groupware content.  The individual link in each individual RSS item is build using the pattern provided by the “﻿RSSDefaultItemLinkURL” default.  With the item link URL the string “$objectId” is replaced by the primary key of the object related to the feed item;  for instance, the id of the task when presenting a task action as an RSS item.  The string “$GUID” is also replaced with the value of items “guid” tag.  Each RSS feed may generate the “guid” for the item in a way specific to the feed.  An important caveat in setting these defaults is that a URL may contain special characters, such as question marks, requiring the value to be properly quoted when writing the value.&lt;/p&gt;
&lt;div class="codehilite"&gt;&lt;pre&gt;&lt;span class="n"&gt;defaults&lt;/span&gt; &lt;span class="n"&gt;write&lt;/span&gt; &lt;span class="n"&gt;NSGlobalDomain&lt;/span&gt; &lt;span class="o"&gt;\&lt;/span&gt;
     &lt;span class="n"&gt;RSSDefaultChannelLinkURL&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;http&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="o"&gt;//&lt;/span&gt;&lt;span class="n"&gt;ogo&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;example&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;com&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&amp;quot;
﻿&lt;span class="n"&gt;defaults&lt;/span&gt; &lt;span class="n"&gt;write&lt;/span&gt; &lt;span class="n"&gt;NSGlobalDomain&lt;/span&gt; &lt;span class="n"&gt;RSSDefaultItemLinkURL&lt;/span&gt; &lt;span class="o"&gt;\&lt;/span&gt;
    &lt;span class="s"&gt;'&amp;quot;http://ogo.example.com/OpenGroupware/wa/LSWViewAction/viewJob?jobId=$objectId&amp;quot;'&lt;/span&gt;
&lt;/pre&gt;&lt;/div&gt;


&lt;h3 id="taks-feeds"&gt;Taks Feeds&lt;/h3&gt;
&lt;p&gt;Task feeds are available in any of the Task folders1.&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;﻿delegated-actions-rss – Includes actions performed upon tasks of which the user was the creator.&lt;/li&gt;
&lt;li&gt;﻿project-actions-rss – Includes actions performed on tasks attached to projects to which the user is assigned.&lt;/li&gt;
&lt;li&gt;﻿todo-actions-rss – Includes actions performed on tasks for which the user is the executor or belongs to a team which is the executor.&lt;/li&gt;
&lt;/ul&gt;
&lt;h2 id="developing-zidestore-bundles"&gt;Developing ZideStore Bundles&lt;/h2&gt;
&lt;p&gt;Developing a ZideStore bundle is quite simple;  all that is required is basic knowledge of Objective-C and the foundational classes.  By developing custom bundles a site can add functionality to the server that can be accessed by a variety of clients;  adding functionality directly on the server provides centralization and efficiency.&lt;/p&gt;
&lt;p&gt;A bundle must contain a GNU make file, a product.plist describing the bundle, and one or more class files. &lt;/p&gt;
&lt;h3 id="zaddition"&gt;zAddition&lt;/h3&gt;
&lt;p&gt;zAddition is an example ZideStore bundle that provides an XML-RPC method which accepts two arguments and returns the sum if both arguments are integers.  In this case the method can be executed in any folder,  and the location of the folder is irrelevant to the result.  For example,  if ZideStore is running on the local host and the user's name is “adam” this method can be executed at “&lt;a href="http://localhost/zidestore/so/adam/public"&gt;http://localhost/zidestore/so/adam/public&lt;/a&gt;” or “&lt;a href="http://localhost/zidestore/so/adam/Contacts/"&gt;http://localhost/zidestore/so/adam/Contacts/&lt;/a&gt;” or any other valid folder.&lt;/p&gt;
&lt;div class="codehilite"&gt;&lt;pre&gt;&lt;span class="p"&gt;{&lt;/span&gt; 
  &lt;span class="n"&gt;requires&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt; &lt;span class="n"&gt;ZSCommon&lt;/span&gt; &lt;span class="p"&gt;);&lt;/span&gt; 
  &lt;span class="n"&gt;publicResources&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt; &lt;span class="p"&gt;);&lt;/span&gt; 
  &lt;span class="n"&gt;factories&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="p"&gt;};&lt;/span&gt; 
  &lt;span class="n"&gt;classes&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="p"&gt;};&lt;/span&gt; 
  &lt;span class="n"&gt;categories&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; 
    &lt;span class="n"&gt;SxFolder&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; 
      &lt;span class="k"&gt;methods&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; 
          &amp;quot;&lt;span class="n"&gt;demo&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;add&lt;/span&gt;&amp;quot; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; 
            &lt;span class="n"&gt;protectedBy&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;View&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
            &lt;span class="n"&gt;actionClass&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;zAddition&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
            &lt;span class="n"&gt;actionName&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;addIt&lt;/span&gt;&amp;quot;&lt;span class="p"&gt;;&lt;/span&gt; 
            &lt;span class="n"&gt;arguments&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;{&lt;/span&gt; &lt;span class="n"&gt;positionalKeys&lt;/span&gt; &lt;span class="p"&gt;=&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt; &lt;span class="n"&gt;Fred&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;George&lt;/span&gt; &lt;span class="p"&gt;);&lt;/span&gt; &lt;span class="p"&gt;};&lt;/span&gt; 
       &lt;span class="p"&gt;};&lt;/span&gt; 
      &lt;span class="p"&gt;};&lt;/span&gt; 
    &lt;span class="p"&gt;};&lt;/span&gt; 
  &lt;span class="p"&gt;};&lt;/span&gt; 
&lt;span class="p"&gt;}&lt;/span&gt;
&lt;/pre&gt;&lt;/div&gt;


&lt;p&gt;The first step is to define a product.plist file which defines the the XML-RPC method the bundle is to provide and to map that method to a method of a class provided by the bundle.  In the case of an XML-RPC method the arguments for the method must also be specified because the arguments to an XML-RPC method are positional.&lt;/p&gt;
&lt;p&gt;The product.plist for zAddition specifies a method called “demo.add” that invokes the “addItAction” method of the “zAddition” class.  Before the method is invoked the values of two arguments will be set in the object via key-value-coding.   One important note is that although the value of “actionName” is “addIt” it is the “addItAction” method that the service will attempt to invoke.  This is part of the SOPE naming convention.&lt;/p&gt;
&lt;p&gt;If no method matching the one defined by “actionName” can be found the function will return a null value and the error will be recorded in the log file:&lt;/p&gt;
&lt;div class="codehilite"&gt;&lt;pre&gt;&lt;span class="n"&gt;Oct&lt;/span&gt; 20 03&lt;span class="p"&gt;:&lt;/span&gt;51&lt;span class="p"&gt;:&lt;/span&gt;57 &lt;span class="n"&gt;ogo&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;zidestore&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;1&lt;span class="p"&gt;.&lt;/span&gt;5 &lt;span class="p"&gt;[&lt;/span&gt;11247&lt;span class="p"&gt;]:&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="n"&gt;zAddition&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;DirectAction&lt;/span&gt; &lt;span class="n"&gt;class&lt;/span&gt; &lt;span class="n"&gt;zAddition&lt;/span&gt; &lt;span class="n"&gt;cannot&lt;/span&gt; &lt;span class="n"&gt;handle&lt;/span&gt; &lt;span class="n"&gt;action&lt;/span&gt; &lt;span class="n"&gt;addItAction&lt;/span&gt;
&lt;/pre&gt;&lt;/div&gt;


&lt;p&gt;The method being assigned to the “SxFolder” category and protected by “View” controls access to the function.  In this case the protection has no substantial meaning since every user will have at least one folder in which they have view access.  In other circumstances where the operation is bound to a more specific folder or entity the protection will be more relevant.&lt;/p&gt;
&lt;p&gt;The next step after defining the product description is to code the actual objects.  In the case of this example the object is trivially simple.  The “setFred” and “setGeorge” accessors are automatically invoked via key-value-coding in order to pass the values of the parameters to the object1.  once the parameters have each been passed to the object via the setter the action method, in this case “addItAction”, is invoked.  The result of the method is automatically appropriately encoded, here as an XML-RPC response, and returned as the response to the client's request.&lt;/p&gt;
&lt;p&gt;The make process will compile the classes and prepare the bundle for installation.  The “GNUmakefile” includes a “config.make” file that specifies the paths and directives relating to the GNUSTEP environment.  If you have built OpenGroupware from source you can simply steal a “config.make” file out of the build tree, otherwise adjust the example “config.make” provided to match your environment.   The makefle itself specifies the files to compile, in the traditional role of a makefile,  but the GNU makefiles also specify the bundle configuration.  With a properly constructed GNU makefile simply executing “make” will build the bundle which is then ready to install1.  The resulting bundle will be “zAddition.zsp” which is a combination o the “BUNDLE_NAME” and “BUNDLE_EXTENSION” parameters.  Once the bundles has been named by setting the “BUNDLE_NAME” the source files, principle class, and resource files are specified by the “zAddition_OBJC_FILE”, “zAddition_PRINCIPLE_CLASS”, and “zAddition_RESOURCE_FILES” respectively.&lt;/p&gt;
&lt;div class="codehilite"&gt;&lt;pre&gt;&lt;span class="n"&gt;Oct&lt;/span&gt; 20 03&lt;span class="p"&gt;:&lt;/span&gt;58&lt;span class="p"&gt;:&lt;/span&gt;08 &lt;span class="n"&gt;ogo&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;zidestore&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;1&lt;span class="p"&gt;.&lt;/span&gt;5 &lt;span class="p"&gt;[&lt;/span&gt;12622&lt;span class="p"&gt;]:&lt;/span&gt; &lt;span class="o"&gt;|&lt;/span&gt;&lt;span class="n"&gt;ogo&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;zidestore&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;1&lt;span class="o"&gt;|&lt;/span&gt; &lt;span class="n"&gt;register&lt;/span&gt; &lt;span class="n"&gt;ZideStore&lt;/span&gt; &lt;span class="n"&gt;product&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;zAddition&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;zsp&lt;/span&gt;
&lt;/pre&gt;&lt;/div&gt;


&lt;p&gt;After compiling out bundle and placing it in the ZideStore bundle path simply restart ZideStore and the new bundle should be discovered and loaded.   If it is successful a message like the following will appear in the log:&lt;/p&gt;
&lt;table class="codehilitetable"&gt;&lt;tr&gt;&lt;td class="linenos"&gt;&lt;div class="linenodiv"&gt;&lt;pre&gt;1
2
3
4&lt;/pre&gt;&lt;/div&gt;&lt;/td&gt;&lt;td class="code"&gt;&lt;div class="codehilite"&gt;&lt;pre&gt;&lt;span class="c"&gt;#!/usr/bin/env python &lt;/span&gt;
&lt;span class="kn"&gt;import&lt;/span&gt; &lt;span class="nn"&gt;xmlrpclib&lt;/span&gt; 
&lt;span class="n"&gt;server&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="n"&gt;xmlrpclib&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;Server&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="s"&gt;'http://adam:fred@localhost/zidestore/so/adam/Contacts/'&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt; 
&lt;span class="k"&gt;print&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;server&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;demo&lt;/span&gt;&lt;span class="o"&gt;.&lt;/span&gt;&lt;span class="n"&gt;add&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="mi"&gt;4&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="mi"&gt;2&lt;/span&gt;&lt;span class="p"&gt;))&lt;/span&gt;
&lt;/pre&gt;&lt;/div&gt;
&lt;/td&gt;&lt;/tr&gt;&lt;/table&gt;

&lt;p&gt;If the bundle is loaded invoking the method via any language which supports XML-RPC should be trivial.  The Python script like the one in “Text 16: zAddition product.plist“ can be used to ask ZideStore to sum four and two and to output the result to the display.&lt;/p&gt;
&lt;p&gt;When the method is invoked the passing of the parameters to the object can be seen in the ZideStore error log due to the “logWithFormat” statements in the “SetFred” and “setGeorge” setters.&lt;/p&gt;
&lt;div class="codehilite"&gt;&lt;pre&gt;&lt;span class="n"&gt;Oct&lt;/span&gt; 22 01&lt;span class="p"&gt;:&lt;/span&gt;58&lt;span class="p"&gt;:&lt;/span&gt;38 &lt;span class="n"&gt;ogo&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;zidestore&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;1&lt;span class="p"&gt;.&lt;/span&gt;5 &lt;span class="p"&gt;[&lt;/span&gt;12931&lt;span class="p"&gt;]:&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="n"&gt;zAddition&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;setFred&lt;/span&gt; &lt;span class="n"&gt;assigned&lt;/span&gt; &lt;span class="n"&gt;with&lt;/span&gt; 4 
&lt;span class="n"&gt;Oct&lt;/span&gt; 22 01&lt;span class="p"&gt;:&lt;/span&gt;58&lt;span class="p"&gt;:&lt;/span&gt;38 &lt;span class="n"&gt;ogo&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;zidestore&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;1&lt;span class="p"&gt;.&lt;/span&gt;5 &lt;span class="p"&gt;[&lt;/span&gt;12931&lt;span class="p"&gt;]:&lt;/span&gt; &lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&lt;span class="n"&gt;zAddition&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt; &lt;span class="n"&gt;setGeorge&lt;/span&gt; &lt;span class="n"&gt;assigned&lt;/span&gt; &lt;span class="n"&gt;with&lt;/span&gt; 2
&lt;/pre&gt;&lt;/div&gt;


&lt;p&gt;The zAddition.h:&lt;/p&gt;
&lt;div class="codehilite"&gt;&lt;pre&gt;&lt;span class="cm"&gt;/* &lt;/span&gt;
&lt;span class="cm"&gt;  Copyright (C) 2006-2007 Whitemice Consulting &lt;/span&gt;
&lt;span class="cm"&gt;*/&lt;/span&gt;

&lt;span class="cp"&gt;#ifndef __zAddition_H__ &lt;/span&gt;
&lt;span class="cp"&gt;#define __zAddition_H__&lt;/span&gt;

&lt;span class="cp"&gt;#include &amp;lt;Foundation/Foundation.h&amp;gt; &lt;/span&gt;
&lt;span class="cp"&gt;#include &amp;lt;LSFoundation/LSCommandContext.h&amp;gt; &lt;/span&gt;
&lt;span class="cp"&gt;#include &amp;lt;NGObjWeb/NSException+HTTP.h&amp;gt; &lt;/span&gt;
&lt;span class="cp"&gt;#include &amp;lt;NGObjWeb/WODirectAction.h&amp;gt; &lt;/span&gt;
&lt;span class="cp"&gt;#include &amp;quot;zAddition.h&amp;quot;&lt;/span&gt;

&lt;span class="k"&gt;@interface&lt;/span&gt; &lt;span class="nc"&gt;zAddition&lt;/span&gt; : &lt;span class="nc"&gt;WODirectAction&lt;/span&gt; 
&lt;span class="p"&gt;{&lt;/span&gt; 
  &lt;span class="kt"&gt;id&lt;/span&gt;                   &lt;span class="n"&gt;arg1&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;arg2&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
  &lt;span class="n"&gt;LSCommandContext&lt;/span&gt;    &lt;span class="o"&gt;*&lt;/span&gt;&lt;span class="n"&gt;ctx&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="cm"&gt;/* accessors */&lt;/span&gt;

&lt;span class="o"&gt;-&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;void&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="nl"&gt;setFred:&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="n"&gt;_arg&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
&lt;span class="k"&gt;-&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;void&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="nf"&gt;setGeorge:&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="nv"&gt;_arg&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
&lt;span class="k"&gt;-&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="nf"&gt;arg1&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
&lt;span class="k"&gt;-&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="nf"&gt;arg2&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="cm"&gt;/* methods */&lt;/span&gt;

&lt;span class="k"&gt;-&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="nf"&gt;defaultAction&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
&lt;span class="k"&gt;-&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="nf"&gt;addItAction&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt;

&lt;span class="k"&gt;@end&lt;/span&gt; &lt;span class="cm"&gt;/* zAddtion */&lt;/span&gt;

&lt;span class="cp"&gt;#endif &lt;/span&gt;&lt;span class="cm"&gt;/* __zAddition_H__ */&lt;/span&gt;&lt;span class="cp"&gt;&lt;/span&gt;
&lt;/pre&gt;&lt;/div&gt;


&lt;p&gt;The zAddition.m:&lt;/p&gt;
&lt;div class="codehilite"&gt;&lt;pre&gt;&lt;span class="cm"&gt;/* &lt;/span&gt;
&lt;span class="cm"&gt;  Copyright (C) 2006-2007 Whitemice Consulting &lt;/span&gt;
&lt;span class="cm"&gt;*/&lt;/span&gt;

&lt;span class="cp"&gt;#include &amp;quot;zAddition.h&amp;quot;&lt;/span&gt;

&lt;span class="k"&gt;@implementation&lt;/span&gt; &lt;span class="nc"&gt;zAddition&lt;/span&gt;

&lt;span class="k"&gt;-&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="nf"&gt;init&lt;/span&gt; 
&lt;span class="p"&gt;{&lt;/span&gt; 
  &lt;span class="n"&gt;self&lt;/span&gt; &lt;span class="o"&gt;=&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;super&lt;/span&gt; &lt;span class="n"&gt;init&lt;/span&gt;&lt;span class="p"&gt;];&lt;/span&gt; 
  &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;self&lt;/span&gt; &lt;span class="nl"&gt;logWithFormat:&lt;/span&gt;&lt;span class="s"&gt;@&amp;quot;zAddition object initialized&amp;quot;&lt;/span&gt;&lt;span class="p"&gt;];&lt;/span&gt; 
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;self&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="k"&gt;-&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;void&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="nf"&gt;dealloc&lt;/span&gt; 
&lt;span class="p"&gt;{&lt;/span&gt; 
  &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;self&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="n"&gt;arg1&lt;/span&gt; &lt;span class="n"&gt;release&lt;/span&gt;&lt;span class="p"&gt;];&lt;/span&gt; 
  &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;self&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="n"&gt;arg2&lt;/span&gt; &lt;span class="n"&gt;release&lt;/span&gt;&lt;span class="p"&gt;];&lt;/span&gt; 
  &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;super&lt;/span&gt; &lt;span class="n"&gt;dealloc&lt;/span&gt;&lt;span class="p"&gt;];&lt;/span&gt; 
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="cm"&gt;/* accessors */&lt;/span&gt;

&lt;span class="k"&gt;-&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;void&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="nf"&gt;setFred:&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="nv"&gt;_arg&lt;/span&gt; 
&lt;span class="p"&gt;{&lt;/span&gt; 
  &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;self&lt;/span&gt; &lt;span class="nl"&gt;logWithFormat:&lt;/span&gt;&lt;span class="s"&gt;@&amp;quot;setFred assigned with %@&amp;quot;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;_arg&lt;/span&gt;&lt;span class="p"&gt;];&lt;/span&gt; 
  &lt;span class="n"&gt;ASSIGN&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;self&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="n"&gt;arg1&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;_arg&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt; 
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="k"&gt;-&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="nf"&gt;arg1&lt;/span&gt; 
&lt;span class="p"&gt;{&lt;/span&gt; 
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;self&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="n"&gt;arg1&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="k"&gt;-&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;void&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="nf"&gt;setGeorge:&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="nv"&gt;_arg&lt;/span&gt; 
&lt;span class="p"&gt;{&lt;/span&gt; 
  &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;self&lt;/span&gt; &lt;span class="nl"&gt;logWithFormat:&lt;/span&gt;&lt;span class="s"&gt;@&amp;quot;setGeorge assigned with %@&amp;quot;&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;_arg&lt;/span&gt;&lt;span class="p"&gt;];&lt;/span&gt; 
  &lt;span class="n"&gt;ASSIGN&lt;/span&gt;&lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="n"&gt;self&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="n"&gt;arg2&lt;/span&gt;&lt;span class="p"&gt;,&lt;/span&gt; &lt;span class="n"&gt;_arg&lt;/span&gt;&lt;span class="p"&gt;);&lt;/span&gt; 
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="k"&gt;-&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="nf"&gt;arg2&lt;/span&gt; 
&lt;span class="p"&gt;{&lt;/span&gt; 
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="n"&gt;self&lt;/span&gt;&lt;span class="o"&gt;-&amp;gt;&lt;/span&gt;&lt;span class="n"&gt;arg2&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="k"&gt;-&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="nf"&gt;defaultAction&lt;/span&gt; 
&lt;span class="p"&gt;{&lt;/span&gt; 
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="nb"&gt;nil&lt;/span&gt;&lt;span class="p"&gt;;&lt;/span&gt; 
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="k"&gt;-&lt;/span&gt; &lt;span class="p"&gt;(&lt;/span&gt;&lt;span class="kt"&gt;id&lt;/span&gt;&lt;span class="p"&gt;)&lt;/span&gt;&lt;span class="nf"&gt;addItAction&lt;/span&gt; 
&lt;span class="p"&gt;{&lt;/span&gt; 
  &lt;span class="k"&gt;if&lt;/span&gt; &lt;span class="p"&gt;(([&lt;/span&gt;&lt;span class="n"&gt;arg1&lt;/span&gt; &lt;span class="nl"&gt;isKindOfClass:&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;NSNumber&lt;/span&gt; &lt;span class="n"&gt;class&lt;/span&gt;&lt;span class="p"&gt;]])&lt;/span&gt; &lt;span class="o"&gt;&amp;amp;&amp;amp;&lt;/span&gt; 
      &lt;span class="p"&gt;([&lt;/span&gt;&lt;span class="n"&gt;arg2&lt;/span&gt; &lt;span class="nl"&gt;isKindOfClass:&lt;/span&gt;&lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;NSNumber&lt;/span&gt; &lt;span class="n"&gt;class&lt;/span&gt;&lt;span class="p"&gt;]]))&lt;/span&gt; 
    &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;NSNumber&lt;/span&gt; &lt;span class="nl"&gt;numberWithInt:&lt;/span&gt;&lt;span class="p"&gt;([&lt;/span&gt;&lt;span class="n"&gt;arg1&lt;/span&gt; &lt;span class="n"&gt;intValue&lt;/span&gt;&lt;span class="p"&gt;]&lt;/span&gt; &lt;span class="o"&gt;+&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;arg2&lt;/span&gt; &lt;span class="n"&gt;intValue&lt;/span&gt;&lt;span class="p"&gt;])];&lt;/span&gt; 
  &lt;span class="k"&gt;return&lt;/span&gt; &lt;span class="p"&gt;[&lt;/span&gt;&lt;span class="n"&gt;NSException&lt;/span&gt; &lt;span class="nl"&gt;exceptionWithHTTPStatus:&lt;/span&gt;&lt;span class="mi"&gt;500&lt;/span&gt; 
            &lt;span class="nl"&gt;reason:&lt;/span&gt;&lt;span class="s"&gt;@&amp;quot;Cannot add things that aren't numbers.&amp;quot;&lt;/span&gt;&lt;span class="p"&gt;];&lt;/span&gt; 
&lt;span class="p"&gt;}&lt;/span&gt;

&lt;span class="k"&gt;@end&lt;/span&gt; &lt;span class="cm"&gt;/* zAddition */&lt;/span&gt;
&lt;/pre&gt;&lt;/div&gt;


&lt;h2 id="interacting-with-zidestore-via-curl"&gt;Interacting with ZideStore via “curl”&lt;/h2&gt;
&lt;p&gt;Curl is a simple command line tool provided with most UNIX and LINUX distributions used to interact with HTTP and FTP servers.  Curl can be used as a simple ZideStore client.&lt;/p&gt;
&lt;h3 id="requesting-a-webdav-collection"&gt;Requesting a WebDAV collection&lt;/h3&gt;
&lt;p&gt;The “-X” parameter of curl is used to set the request method;  if no method is specified curl defaults to GET.  The “-X” parameter and the “--request” parameter are interchangable.  If multiple request methods are specified the last value will be used.   In WebDAV a collection is enumerated using a “BPROPFIND” request.  For example, the Overview calendar for the user “adam” using the following command:&lt;/p&gt;
&lt;div class="codehilite"&gt;&lt;pre&gt;&lt;span class="n"&gt;curl&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;d&lt;/span&gt; &amp;quot;&lt;span class="o"&gt;&amp;lt;&lt;/span&gt;&lt;span class="n"&gt;xml&lt;/span&gt;&lt;span class="o"&gt;&amp;gt;&lt;/span&gt;&amp;quot; &lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;H&lt;/span&gt; &amp;quot;&lt;span class="n"&gt;Content&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;Type&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt; &lt;span class="n"&gt;text&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;xml&lt;/span&gt;&amp;quot; &lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;u&lt;/span&gt; &lt;span class="n"&gt;adam&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="o"&gt;*******&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;X&lt;/span&gt; &lt;span class="n"&gt;PROPFIND&lt;/span&gt; &lt;span class="o"&gt;\&lt;/span&gt;
  &lt;span class="n"&gt;http&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="o"&gt;//&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;serverName&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;zidestore&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;dav&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;adam&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;Overview&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;
&lt;/pre&gt;&lt;/div&gt;


&lt;p&gt;The response to the BPROPFIND request should be XML.  Within the outer “DAV:multistatus” elements are a series of “DAV:response” elements.  Each “DAV:response” element contains a “DAV:href” element – the content of the “DAV:href” element is the URL of the item within the collection.  This URL can be retrieved with a simple GET request:&lt;/p&gt;
&lt;div class="codehilite"&gt;&lt;pre&gt;curl -u adam:******** http://gourd-amber/zidestore/dav/adam/Overview/10444446.ics

&lt;span class="cp"&gt;&amp;lt;?xml version=&amp;quot;1.0&amp;quot; encoding=&amp;quot;utf-8&amp;quot;?&amp;gt;&lt;/span&gt; 
&lt;span class="nt"&gt;&amp;lt;D:multistatus&lt;/span&gt; &lt;span class="na"&gt;xmlns:D=&lt;/span&gt;&lt;span class="s"&gt;&amp;quot;DAV:&amp;quot;&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt; 
  &lt;span class="nt"&gt;&amp;lt;D:response&amp;gt;&lt;/span&gt; 
    &lt;span class="nt"&gt;&amp;lt;D:href&amp;gt;&lt;/span&gt;/zidestore/dav/adam/Overview/10444446.ics&lt;span class="nt"&gt;&amp;lt;/D:href&amp;gt;&lt;/span&gt; 
    &lt;span class="nt"&gt;&amp;lt;D:propstat&amp;gt;&lt;/span&gt; 
      &lt;span class="nt"&gt;&amp;lt;D:status&amp;gt;&lt;/span&gt;HTTP/1.1 200 OK&lt;span class="nt"&gt;&amp;lt;/D:status&amp;gt;&lt;/span&gt; 
      &lt;span class="nt"&gt;&amp;lt;D:prop&amp;gt;&amp;lt;/D:prop&amp;gt;&lt;/span&gt; 
    &lt;span class="nt"&gt;&amp;lt;/D:propstat&amp;gt;&lt;/span&gt; 
  &lt;span class="nt"&gt;&amp;lt;/D:response&amp;gt;&lt;/span&gt; 
  .... 
&lt;span class="nt"&gt;&amp;lt;/D:multistatus&amp;gt;&lt;/span&gt;
&lt;/pre&gt;&lt;/div&gt;


&lt;p&gt;This request should produce a vCalendar representations of the appointment.  By enumerating the appropriate collection and requesting the objects a client application or script can interrogate the contents of the groupware server.  Performing a GET request with curl is equivalent to performing a “get” or “cat” command from within the cadaver WebDAV client.&lt;/p&gt;
&lt;h3 id="posting-an-object"&gt;Posting an object&lt;/h3&gt;
&lt;p&gt;In order to put an event or contact to the ZideStore service you need to perform a PUT operation.  With curl this is simply an upload file operation;  performed by providing the eponymously named “--upload-file” option with the name of the file containing the object to upload to the server.  This file must be a value vCalendar (.vcf) if uploading to a calendar collection or a value vCard if uploading to a Contact collection.  Team folders are read-only.&lt;br /&gt;
&lt;/p&gt;
&lt;div class="codehilite"&gt;&lt;pre&gt;&lt;span class="n"&gt;curl&lt;/span&gt; &lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;u&lt;/span&gt; &lt;span class="n"&gt;adam&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="o"&gt;*****&lt;/span&gt; &lt;span class="o"&gt;--&lt;/span&gt;&lt;span class="n"&gt;upload&lt;/span&gt;&lt;span class="o"&gt;-&lt;/span&gt;&lt;span class="n"&gt;file&lt;/span&gt; &lt;span class="n"&gt;test&lt;/span&gt;&lt;span class="p"&gt;.&lt;/span&gt;&lt;span class="n"&gt;vcf&lt;/span&gt; &lt;span class="n"&gt;http&lt;/span&gt;&lt;span class="p"&gt;:&lt;/span&gt;&lt;span class="o"&gt;//&lt;/span&gt;&lt;span class="p"&gt;{&lt;/span&gt;&lt;span class="n"&gt;serverName&lt;/span&gt;&lt;span class="p"&gt;}&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;zidestore&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;dav&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;adam&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;&lt;span class="n"&gt;Calendar&lt;/span&gt;&lt;span class="o"&gt;/&lt;/span&gt;
&lt;/pre&gt;&lt;/div&gt;


&lt;p&gt;Remember that in order for ZideStore to identify appointment participants the participants must exist in the database with and “email1” attribute matching that of the “MAILTO” value of the “ATTENDEE” attribute.&lt;/p&gt;
&lt;p&gt;When no filename is provided the object is created as a new object.  Depending on the structure of the vCard or vCalendar file some keys may be lost.  Lost keys will be noted in the ZideStore error log with a message like “Note: loosing keys: creator”.&lt;/p&gt;
&lt;h3 id="deleting-an-object"&gt;Deleting An Object&lt;/h3&gt;
&lt;h3 id="performing-a-caldav-report"&gt;Performing A CalDAV REPORT&lt;/h3&gt;
&lt;p&gt;By specifying a request method of “REPORT” (via the -X parameter) curl can be used to make CalDAV requests to ZideStore.  This allows both “calendar-query” and “calendar-multiget” operations to be tested.    The body of the request for any REPORT operation must be valid XML and declared as either “application/xml” or “text/xml” via a “Content-Type” header1.  CalDAV REPORT operations are only supported within the context of a collection of events, such as either a “/Calendar” or “/Overview” folder.&lt;/p&gt;
&lt;div class="codehilite"&gt;&lt;pre&gt;curl -d '&lt;span class="nt"&gt;&amp;lt;C:calendar-query&lt;/span&gt; &lt;span class="na"&gt;xmlns:C=&lt;/span&gt;&lt;span class="s"&gt;&amp;quot;urn:ietf:params:xml:ns:caldav&amp;quot;&lt;/span&gt; &lt;span class="na"&gt;xmlns:D=&lt;/span&gt;&lt;span class="s"&gt;&amp;quot;DAV&amp;quot;&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&amp;lt;D:p&lt;/span&gt;&lt;span class="err"&gt;&amp;lt;/D:prop&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&amp;lt;C:filter&amp;gt;&amp;lt;C:comp-filter&lt;/span&gt; &lt;span class="na"&gt;name=&lt;/span&gt;&lt;span class="s"&gt;&amp;quot;VCALENDAR&amp;quot;&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&amp;lt;C:comp-filter&lt;/span&gt; &lt;span class="na"&gt;name=&lt;/span&gt;&lt;span class="s"&gt;&amp;quot;VEVENT&amp;quot;&lt;/span&gt;&lt;span class="nt"&gt;/&amp;gt;&amp;lt;/C:comp-filter&amp;gt;&amp;lt;/C:filter&amp;gt;&amp;lt;/C:calendar-query&amp;gt;&lt;/span&gt;' -H &amp;quot;Content-Type: application/xml&amp;quot; -u adam:fred123 -X REPORT http://localhost/zidestore/dav/adam/Overview/

curl -d '&lt;span class="nt"&gt;&amp;lt;C:calendar-multiget&lt;/span&gt; &lt;span class="na"&gt;xmlns:C=&lt;/span&gt;&lt;span class="s"&gt;&amp;quot;urn:ietf:params:xml:ns:caldav&amp;quot;&lt;/span&gt; &lt;span class="na"&gt;xmlns:D=&lt;/span&gt;&lt;span class="s"&gt;&amp;quot;DAV:&amp;quot;&lt;/span&gt;&lt;span class="nt"&gt;&amp;gt;&lt;/span&gt;ag/&amp;gt;&lt;span class="nt"&gt;&amp;lt;D:getcontenttype/&amp;gt;&amp;lt;C:calendar-data/&amp;gt;&amp;lt;/D:prop&amp;gt;&amp;lt;D:href&amp;gt;&lt;/span&gt;/zidestore/dav/adam/Overview/12767410.ics&lt;span class="nt"&gt;&amp;lt;/D:href&amp;gt;&amp;lt;D:href&amp;gt;&lt;/span&gt;/zidestore/dav/adam/Overview/12768751.ics&lt;span class="nt"&gt;&amp;lt;/D:href&amp;gt;&amp;lt;/C:calendar-multiget&amp;gt;&lt;/span&gt;' -H &amp;quot;Content-Type: application/xml&amp;quot; -u adam:fred123 -X REPORT http://localhost/zidestore/dav/adam/Overview/
&lt;/pre&gt;&lt;/div&gt;

&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Sebastian Reitenbach</dc:creator><pubDate>Thu, 10 Jan 2013 18:06:40 -0000</pubDate><guid isPermaLink="false">https://sourceforge.nete45978b2ea53a4e4af5e51052413b37e3eef07a9</guid></item><item><title>WikiPage Mail configuration modified by Sebastian Reitenbach</title><link>https://sourceforge.net/p/opengroupware/wiki/Mail%2520configuration/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v3
+++ v4
@@ -79,13 +79,13 @@
  * ShowVacationPanel
  * DisableMailQuotaInformation
  * MaxMailAttachmentsSize
-UseMailingListManager
-mail_editor_type “internal” / “external”
-mail_send_type “plain”
-cyrus_sieve_port
-cyrus_sieve_temp_path
-DisableEpozEditor
-mail_simplesearch_include_teams (NO)
-mail_simplesearch_include_email1 (NO)
-mail_search_for_atstrings (NO)
-mail_printviewer_headers (subject, from, to, date )
+ * UseMailingListManager
+ * mail_editor_type “internal” / “external”
+ * mail_send_type “plain”
+ * cyrus_sieve_port
+ * cyrus_sieve_temp_path
+ * DisableEpozEditor
+ * mail_simplesearch_include_teams (NO)
+ * mail_simplesearch_include_email1 (NO)
+ * mail_search_for_atstrings (NO)
+ * mail_printviewer_headers (subject, from, to, date )
&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Sebastian Reitenbach</dc:creator><pubDate>Thu, 10 Jan 2013 17:29:42 -0000</pubDate><guid isPermaLink="false">https://sourceforge.netd9cac667a4ec06d667da40b26e91f2650c6e23f5</guid></item><item><title>WikiPage Mail configuration modified by Sebastian Reitenbach</title><link>https://sourceforge.net/p/opengroupware/wiki/Mail%2520configuration/</link><description>&lt;div class="markdown_content"&gt;&lt;pre&gt;--- v2
+++ v3
@@ -58,3 +58,34 @@

+Web Interface 
+=============
+
+Customization
+-------------
+
+### SkyMailCheckInterval ###
+
+SkyMailCheckInterval determines how frequently the web mail interface will check for new mail.  The value is in seconds with a default of 120 (2 minutes).  Very busy sites, or sites with a remote IMAP server, may wish to increase this value.
+
+ * DeleteImapFolderImmediately (NO)
+ * MailEditor_TextFieldSize (80)
+ * UseCCForMultipleAddressSearch
+ * BodyStructureInViewerBoundary (5000)
+ * ShowBodySize(100000)
+ * CreateMailDownloadFileNamesDisable
+ * EnableSieveFilter / DisableSieveFilter
+ * EnableSieveVacation / DisableSieveVacation
+ * ShowVacationPanel
+ * DisableMailQuotaInformation
+ * MaxMailAttachmentsSize
+UseMailingListManager
+mail_editor_type “internal” / “external”
+mail_send_type “plain”
+cyrus_sieve_port
+cyrus_sieve_temp_path
+DisableEpozEditor
+mail_simplesearch_include_teams (NO)
+mail_simplesearch_include_email1 (NO)
+mail_search_for_atstrings (NO)
+mail_printviewer_headers (subject, from, to, date )
&lt;/pre&gt;
&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Sebastian Reitenbach</dc:creator><pubDate>Thu, 10 Jan 2013 17:29:17 -0000</pubDate><guid isPermaLink="false">https://sourceforge.nete404c089a8913d5062d0e7a0967943ae7c7c03e3</guid></item><item><title>WikiPage User Manager modified by Sebastian Reitenbach</title><link>https://sourceforge.net/p/opengroupware/wiki/User%2520Manager/</link><description>&lt;div class="markdown_content"&gt;&lt;h1 id="user-manager"&gt;User Manager&lt;/h1&gt;
&lt;h2 id="accounts-teams"&gt;Accounts &amp;amp; Teams&lt;/h2&gt;
&lt;h3 id="accounts"&gt;Accounts&lt;/h3&gt;
&lt;h3 id="teams"&gt;Teams&lt;/h3&gt;
&lt;h3 id="all-intranet"&gt;All Intranet&lt;/h3&gt;
&lt;p&gt;The “all intranet” team is intended to be a team of all users.  If OpenGroupware creates an account by a new user logging into the web interface that account will automatically be added to the “all intranet” team.&lt;/p&gt;
&lt;h3 id="news-editors"&gt;News Editors&lt;/h3&gt;
&lt;p&gt;Members of the “news editors” team are permitted to modify and create articles in the news application.&lt;/p&gt;
&lt;h3 id="team-creators"&gt;Team Creators&lt;/h3&gt;
&lt;p&gt;The “team creators”.  This is a role OGoTeamCreatorRoleName&lt;/p&gt;
&lt;h2 id="user-manager_1"&gt;User Manager&lt;/h2&gt;
&lt;p&gt;The User Manager application is only available to the OpenGroupware administrative account.&lt;/p&gt;
&lt;h3 id="customization"&gt;Customization&lt;/h3&gt;
&lt;h3 id="number-of-users-per-page"&gt;Number of users per page&lt;/h3&gt;
&lt;p&gt;The number of users displayed per page by the User Manager application can be adjusted via the “usermanager_blocksize” default.  The value of this default must be a positive integer;  the specified number of accounts will then be displayed on each page.  This default should be created in the ogo-webui domain appropriate to the version of your software.&lt;/p&gt;&lt;/div&gt;</description><dc:creator xmlns:dc="http://purl.org/dc/elements/1.1/">Sebastian Reitenbach</dc:creator><pubDate>Thu, 10 Jan 2013 16:04:59 -0000</pubDate><guid isPermaLink="false">https://sourceforge.net9bf8aa0f74883d584c6be0898239716c4ba6807b</guid></item></channel></rss>