Mheiland at 01:53, 27 June 2009

2009-06-27T01:53:13Z

← Older revision		Revision as of 01:53, 27 June 2009
Line 51:		Line 51:


	[[Category:OX6 ~~related~~]]		[[Category:OX6]]

Mheiland at 01:51, 27 June 2009

2009-06-27T01:51:38Z

← Older revision		Revision as of 01:51, 27 June 2009
Line 51:		Line 51:


	[[Category:~~OX EE related]]~~		[[Category:OX6 related]]
	~~[[Category:OX HE related]]~~
	~~[[Category:OX Hyperion~~ related]]

Tierlieb: added categories

2007-06-26T09:56:06Z

added categories

← Older revision		Revision as of 09:56, 26 June 2007
Line 48:		Line 48:

	Yep, this is Spring [http://www.springframework.org/]. Now you know what you need those <code>spring-core.jar</code> and <code>spring-beans.jar</code> thingies for.		Yep, this is Spring [http://www.springframework.org/]. Now you know what you need those <code>spring-core.jar</code> and <code>spring-beans.jar</code> thingies for.



			[[Category:OX EE related]]
			[[Category:OX HE related]]
			[[Category:OX Hyperion related]]

Tierlieb: New page: You want to export a format the current exporters do not offer? Build a new one! There are three steps to complete to write an exporter. * Defining a new format in `com.openexchange....`


2007-03-23T15:20:20Z
New page: You want to export a format the current exporters do not offer? Build a new one!  There are three steps to complete to write an exporter. * Defining a new format in <code>com.openexchange....
New page
You want to export a format the current exporters do not offer? Build a new one!



There are three steps to complete to write an exporter.

* Defining a new format in <code>com.openexchange.groupware.importexport.Format</code>

* Write an exporter by implementing the <code>com.openexchange.groupware.importexport.Exporter</code> interface.

* Plug the exporter into the file <code>/conf/groupware/importerExporter.xml</code>



== A new format ==

Now this should be easy: Open the file, write a new enum with a different identifier and you are done.

In case you want to extend an existing format (CSV comes to mind) to import something different than Contacts (which currently is the only use for it), you do ''not'' need to define a new format.



== Implementing the Exporter interface ==

For the most current information, have a look the JavaDoc for the Importer Interface. Here are just two notes on the main methods:



=== canExport ===

This method is called by the class which selects an appropriate exporter. So make sure to use all your checking here, like

* Is this the format I am responsible for?

* Are the folders I am supposed to export from meant for this kind of data (example: You can only make vCards from Contacts)? This usually means asking the type of the FolderObject and comparing it to the constants (like FolderObject.CONTACT).

* Is this user allowed to read from this folder?



=== exportData ===

These methods do the export itself - one exports only one entry, one all of a folder. I'd recommend that they internally call canExport to be sure the preconditions are met. The main job consists of reading data from the folder and wrapping these objects up nicely in the appropriate format-

 

* The readers for the database usually hide in <code>com.openexchange.api2</code> and are named *SQLInterface for some strange reason.

* The objects resulting from reading the database are found in <code>com.openexchange.groupware.container</code> and end with *Object.



== Plugging the new Exporter in ==

As said, open the file <code>importerExporter.xml</code>. After checking out the projects, this should be in the main project at <code>/conf/groupware</code>, if installed, it ought to be somewhere like <code>/opt/open-xchange/groupware</code>.

The file looks like this, just go to the two comment lines and do like people before you did:



  <beans> 

    <bean id="importerExporter" class="com.openexchange.groupware.importexport.ImporterExporter">

      <property name="exporters">

        <list>

          <ref bean="iCalExporter" />

          <ref bean="vCardExporter" />

          <ref bean="csvContactExporter" />

          &lt;!-- add reference to your class here -->

        </list>

      </property>

    </bean>

  

    <bean id="iCalExporter"       class="com.openexchange.groupware.importexport.exporters.ICalExporter" />

    <bean id="vCardExporter"      class="com.openexchange.groupware.importexport.exporters.VCardExporter" />

    <bean id="csvContactExporter" class="com.openexchange.groupware.importexport.exporters.CSVContactExporter" />

    &lt;!-- add your class here -->

  </beans>



Yep, this is Spring [http://www.springframework.org/]. Now you know what you need those <code>spring-core.jar</code> and <code>spring-beans.jar</code> thingies for.

Building an exporter - Revision history

Mheiland at 01:53, 27 June 2009

Mheiland at 01:51, 27 June 2009

Tierlieb: added categories

Tierlieb: New page: You want to export a format the current exporters do not offer? Build a new one! There are three steps to complete to write an exporter. * Defining a new format in com.openexchange....

Tierlieb: New page: You want to export a format the current exporters do not offer? Build a new one! There are three steps to complete to write an exporter. * Defining a new format in `com.openexchange....`