Publish&subscribe enables you to easily exchange data between users and different applications. The users are
internal Open-Xchange Server users,
external users without Open-Xchange account.
Applications are
the Open-Xchange Server,
various social networks like LinkedIn.
Goals and features of publish&subscribe:
Data from different social networks can be re-used.
The Open-Xchange Server combines the data from the social networks.
The data format is based on HTML and can be displayed by standard browsers without any further tools. The data format is called OXMF.
Hint: The OXMF data format can vary depending on the Open-Xchange Server version. Thus it is possible that not all data are exchanged between the different versions.
Particular contact data from LinkedIn can be exchanged with external partners in the following way:
By using the
function your LinkedIn contacts can be imported to a contact folder.If needed, use the Open-Xchange Server functions to edit or restructure the contacts.
Create a folder that contains the contacts that should be made available to external partners.
By using the
function the contacts in this folder are made available. The function provides a URL that can be sent to external partners by E-Mail.
You can import the following data in a contact folder by using the
function:XING! contacts
LinkedIn contacts
Facebook contacts
Google Mail contacts
Yahoo.com contacts
MSN contacts
Sun calendar contacts
Hotmail contacts
With the
function you can import the following data in a calendar folder:Appointments from your Google calendars. Note: Exceptions to serial appointments are currently not supported.
With the
function you can import the following data in an InfoStore folder:InfoStore entries using the OXMF InfoStore format.
You can publish the following folders:
Contact folders
InfoStore folders
You have the following possibilities:
Subscribe data to an existing folder
Subscribe data to a new folder
Subscribe to InfoStore data using an E-Mail invitation
Update subscribed data
Remove subscriptions
Select a contacts folder, a calendar folder or an infostore folder in the folder tree.
In the panel select
. A pop-up window with data sources is displayed. Click a data source.Enter the access data for the subscription source i.e., access data, URL. If the source is using an existing authorization select an existing account or create a new by clicking the 8.7.3.1: Authorization with existing account.
button. Further information can be found inIf you want to subscribe to data from additional sources for the selected folder, repeat steps 2-3.
In the panel click
.Tip: You can also subscribe to data by right-clicking on a folder and selecting from the submenu.
Tip: You can also subscribe to data by using the setup wizard. Information can be found in 8.2.12: Using the Setup Wizard.
How to subscribe data to a new folder:Right-click on a folder in the folder tree.
Hover the mouse pointer over
. A submenu with folder types opens.Click on the folder type that corresponds to the source of the subscription wanted. Result: A folder named after the subscription source is created. The overview window displays the tab.
Enter the data needed for the subscription source e.g., credentials, URL. If the source is using an existing account select an existing account or create a new by clicking the 8.7.3.1: Authorization with existing account.
button. Further information can be found inClick on the panel entry
.Another Open-Xchange-Groupware user can invite you to subscribe his published InfoStore folder by sending you an invitation E-Mail. Above its E-Mail header this invitation E-Mail contain a note and the button .
How to subscribe InfoStore data using an invitation E-Mail:Create a new InfoStore folder if needed.
Display the invitation E-Mail in the H Split or V Split view.
Above the E-Mail header, click on the button
.In the pop-up window click an InfoStore folder. You can only select folders where you have appropriate write permission to store your subscription data.
Result: The data are subscribed to the folder.
The data and any references contained in this webpage are shared with you under the assumption that the owner of the data was entitled to make them available to you. Neither Open-Xchange, nor any of its subsidiaries or affiliates shall be liable for its publication or re-publication.
Any unauthorized use or dissemination of this data is prohibited. If you intend to store, process, or pass on this data, please make sure that you have the right to do so.
If you are one of the people listed or responsible for a resource listed on this page and you don't agree with the publication, please send an email containing the URL (the link) to this webpage to the publisher of the data:
Data published by < > on < >
Select a contacts folder, a calendar folder or an infostore folder in the folder tree.
In the panel, select
.Note: This function is only activated if the selected folder contains subscribed data.
How to delete a subscription:Right-click on a folder and select
. The folder properties are displayed in the overview window.Switch to the
tab.Select a subscription under
in the overview window.In the
panel section click . If using the compact panel, click the panel entry .Click
in the confirmation dialog.Some data sources require authorization with an existing account in order to access their data within the groupware. In such cases the following elements are displayed below the name of the data source:
the drop-down box
the
buttonHow to authorize with an existing account:
Click the Add a new account pop-up window opens.
button. TheEnter a name for the new account. Click
. You will be redirected to the data source provider's page.Follow the instructions on the data source provider's page. Usually, you have to enter your credentials for this provider and allow the access by clicking the respective button.
Result: You will be redirected to the groupware. The name you entered will be entered in the drop-down box . The account for this data source can be used multiple times within the groupware.
When using this publish feature, you as the current owner of the data are responsible for being careful with privacy rules and for complying with legal obligations (Copyright, Privacy Laws).
Especially when publishing personal data you are the responsible party according to the Federal Data Protection Act (BDSG, Germany) or other Privacy Acts of your country.
According to European and other national regulations you as the responsible party are in charge of data economy, and must not publish or forward personal data without the person's consent.
Beyond legal obligations, Open-Xchange would like to encourage extreme care when dealing with personal data. Please carefully consider where you store and to whom you forward personal data. Please ensure appropriate access protection, e.g.: by proper password protection.
Select a contacts folder or an infostore folder in the folder tree.
In the panel, select
.Choose the necessary target from the
drop-down field:When publishing a contact folder select
.When publishing an InfoStore folder select
.
Enter a name for the publication (e.g.: your name) in the
input field.To change the layout of the published data, select a suitable template from the drop-down menu 8.7.4.1: Customizing the template.
. Information about how to adjust templates can be found inTo prevent the URL from being guessed by others, activate the
checkbox. By doing so a random character string is added to the URL, i.e.: the URL cannot be guessed.Click on the panel entry
.Result: The folder is published. It will be marked with the published folder icon in the folder tree. Next to , a URL for accessing the published folder is displayed.
Tip: You can also publish data by right-clicking on a folder and selecting in the submenu.
Tip: You can also use the wizard for publishing data. Information can be found in 8.2.12: Using the Setup Wizard.
How to send an E-Mail with the publication URL:Select a publication in the overview window under
.Click the
button.Result: The E-Mail window opens. The E-Mail text contains the URL for accessing the publication.
How to deactivate or activate a publication:In a folder's context menu click on
. The overview window displays the folder properties.Switch to the
tab.In the overview window under
deactivate or activate the checkbox next to a publication.Tip: You can also deactivate or activate a publication by using the overview page. Information can be found in 8.7.5: Managing subscribed and published folders.
How to remove a publication:Right-click on a folder and select
. The folder properties are displayed in the overview window.Switch to the
tab.Select a publication under
in the overview window.In the
panel section click . If using the compact panel, click the panel entry .Click on
in the confirmation dialog.The layout of the web page containing your published data is set by a template. You can customize the web page layout by modifying the template. If you do not modify the template the default template is used.
In order to customize a template the following actions are required:
Entering a template file name when publishing
Downloading the template from the personal InfoStore folder
Customizing the templates with a text editor
Uploading the customized template to the InfoStore
Note: Customizing a template requires knowledge in web design, especially in HTML and CSS. If a faulty template is used, your published data might no longer be displayed.
How to customize a template:
Right-click on a folder and select
. The folder properties are displayed in the overview window.Switch to the
tab.Enter a file name for the template in the
input field.Click on the panel entry
. Result: Your personal InfoStore folder contains the template in the OXMF Templates folder. The template has the name entered by you in step 2. Note: Prior to being able to see the template you have to retrieve the objects from the server by clicking the Refresh button in the title bar.Download the template from the InfoStore. Edit the template with a text editor. Information on the content of the template can be found later in this section.
Upload the modified template as a new, current document version to the InfoStore.
Result: The page with the published data is displayed with the modifications.
Note: In order to view the changes, the page has to be reloaded.
Tip: You can also directly modify the template by using WebDAV.
Information on the template structure: A template is written in HTML. It consists of the following sections:
Macros
Page layout in XHTML format
Layout defined with CSS
HTML contents
In order to get an overview of your subscribed and published data and to manage them you can:
display all subscribed or published folders on one page,
activate or deactivate subscriptions or publications,
display the subscribed or published data of a folder.
How to reach the functions for managing subscribed or published folders:
In the title bar click the .
In the folder tree under
click on or on .Result: The overview window shows the subscriptions or publications available. The left window pane displays the existing subscriptions or publications. The right pane shows the settings of a subscription or a publication.
How to activate or deactivate a subscription or publication:In the
or pane select a subscription or publication.In the right pane activate or deactivate the
checkbox.Click the panel entry
.In the
or pane select a subscription or publication.In the right pane below
or click on a folder.Result: The subscribed or published data of a folder are displayed.