• Created by Unknown User (adrianc@hlmksw.com), last modified on Jun 24, 2009

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

OFBiz work efforts can be accessed with third-party calendar programs that support the iCalendar file format. This is a convenient way to manage events and tasks.

To use the iCalendar feature, you need to perform three steps:

  1. Create a publish point
  2. Link work efforts, parties, and fixed assets to the publish point
  3. Configure your calendar client to access the published calendar

Create A Publish Point

An iCalendar publish point is a work effort that contains properties the iCalendar feature uses to publish your calendar. Create a new work effort and set its Type to Publish Properties. Set the Status to Cancelled so it won't show up in normal work effort searches.

You can control the calendar's visibility with the Scope setting:

  1. Private - only the calendar owner can use the calendar
  2. Confidential - only the calendar owner and parties assigned to it in the role of Delegate can use the calendar
  3. Public - anyone can use the calendar

You can control when the calendar is published by using the Actual Start Date and Actual Completion Date fields. When these fields are set, the calender will only be visible within their date range.

Save the publish point work effort and make a note of the work effort's ID - it will be used in the iCalendar URL.

Link Work Efforts, Parties, And Fixed Assets To The Publish Point

You can control which work efforts are visible by assigning child work efforts, parties, and fixed assets to the publish point:

  1. All child work efforts are visible
  2. All Public work efforts of all assigned parties are visible
  3. All Public work efforts of all assigned fixed assets are visible

OFBiz will automatically assign you as calendar owner of the publish point work effort - which means all of your Public work efforts will appear in the calendar. If you don't want that to happen, then expire your assignment to the work effort.

Configure Your Calendar Client

Configure your calendar client to use the published calendar. The calendar's URL is the OFBiz server's HTTPS URI, plus "/iCalendar/", plus the publish point's work effort ID. For example: https://myofbiz.com/iCalendar/10010. Some calendar clients might need a file name: https://myofbiz.com/iCalendar/10010/MyCalendar.ics. If you want write access to the calendar, then you'll need to include authentication parameters: https://myofbiz.com/iCalendar/10010/MyCalendar.ics?USERNAME=me&PASSWORD=mypassword.

Using The Calendar

If you set up write access in your calendar client, you will be able to update existing work efforts. There are some restrictions imposed by the iCalendar format - for example, only the event or task organizer can update the event or task. Any new events or tasks you create in your calendar client will be stored by OFBiz, but they won't create new work efforts.

  • No labels