Calendar Overview


Month View

Week View


Adding a Calendar

Viewing Calendar Properties

Editing Calendar Properties

Deleting a Calendar

Editing the Location of a Calendar

Adding a Calendar Event

Editing Calendar Event Properties

Deleting a Calendar Event

Editing the Location of a Calendar Event

Table of Contents	DocuShare Files	DocuShare URLs

DocuShare also has the ability to create online calendars. They are represented by a icon. You can use a DocuShare online calendar as a personal calendar or as a shared, group calendar. Calendar entries are called Events. Each event is associated with a specific day, or with a specific sequence of days, such as every Monday for six weeks. As with all DocuShare objects, events have a title, description, and the standard set of permission attributes. By default, an event's permissions are inherited from the calendar, but they can be individually modified to create various kinds of public and private events, for example.

Calendars have two view options - one month at a time or one week at a time. One editable property of a calendar is which view to use as the default when the calendar is initially opened. When first opened, a calendar will display either the current month or week, with the current day highlighted.

An example calendar in month view is shown in the following example.

In the month view, a calendar displays all the days in a specified month, with the first three events of each day displayed in an abbreviated manner. The toolbar includes a button that will take you to a week view for that month. If it is the current month, the week view button will display the current week. Otherwise, it will display the first week of the month. Use the highlighted month names to navigate forward or backward in the calendar.

To add an event to or display details about a specific day, click on the day number link. An Event page for the selected day appears, as shown in the following example.

Existing events are listed in a table at the top of the page. You can click on the Services link to display or edit the properties of an existing event. Below that table is a form to add new events for that day. To return to the current calendar view, click the highlighted calendar name link at the top of the Event page.

The figure shows an example calendar in week view. In the week view, a calendar displays all the days in a specific week, starting with Monday and ending with Sunday. Each day contains a complete listing for all of the events in that day, including the events' complete title and description. To display or edit the properties of an existing event, click on its Services link. To add an event to a specific day, select the Add Event button for the desired day.

The toolbar includes a button that will take you to the month view containing the week currently displayed. Use the Previous and Next buttons to move to the previous and next week, respectively. Use the Today button to move to the current week. The current day will be highlighted.

You can add a calendar to any collection in DocuShare to which you have at least Writer access permissions. However, you must be logged in to DocuShare to create a calendar.

1. In the collection where you want to add the calendar, select Calendar from the Add pull-down menu. The Add Calendar page appears.
   
   
2. Fill in the page. Refer to the property descriptions in the table below for descriptions of each field.
   Note: While creating the calendar, if you are unsure of the purpose of a field, you can click on the highlighted field name for a brief Help description of the field.
   
   
3. Click the Apply button.
   
   

The Add Calendar page has the following properties:

Note: There may be additional properties displayed on this page that are not listed here. They are specific to your DocuShare site. See your Site Administrator for details.

The calendar is created in DocuShare and the Services page for the calendar appears.

You can verify that the calendar was created by clicking the Appears In link to move you up one level in the collection hierarchy. The calendar should now be listed with a icon. If you don't see the calendar, click Reload on your browser to refresh the page display.

Note: After creating the calendar, you should adjust the access permissions for the calendar to make sure they provide the desired level of access for other users and groups. See the section Viewing and Editing DocuShare Object Permissions in Chapter 3 for more information on adjusting these permissions.

You can view the properties of a calendar at any time. You do not need to be logged in to view a calendar's properties. However, you must be logged in to DocuShare to perform any editing functions that can be accessed through the Calendar Services page.

To access a calendar's Services page, click on the Services link to the right of the calendar in the collection listing. If you are in an open calendar, select View Properties from the Edit pull-down menu.

Calendar properties include:

• All of the properties listed in the previous section
  
  
• The calendar's identifying object number (handle), the owner who created the calendar and the date and time of creation and last modification
  
  
• The location of this calendar within the collection hierarchy of the DocuShare site (Appears In property). All DocuShare objects may appear in multiple locations.

All of these properties (except the object id, the creation/modification dates/times and calendar location) can be edited or modified by the owner of the calendar or a user with Writer access permissions through the Edit Properties function.

Use the Edit Location function on main calendar toolbar to edit the Appears In property (calendar location).

The Services page provides access to editing functions, using these selections in the pull-down menu:

Permissions - View the access permissions for this calendar.
If you are the owner or have Manager access permissions, you can also edit the access permissions from here.

Edit Location - Change (move) or add locations for this calendar.
You must be the owner of the calendar or have at least Writer access permissions to change calendar locations. See the section Editing the Location of a Calendar in this chapter for more information.

Edit Properties - Edit the properties for this calendar.
You must be the owner of the calendar or have at least Writer access permissions to edit calendar properties.

You can edit the properties of a calendar at any time by selecting Edit Properties from the calendar’s Edit pull-down menu. You must be the owner of the calendar or have Writer access permissions to edit a calendar's properties. You must also be logged in to DocuShare.

1. Click the Services link for the calendar whose properties you want to edit. The Calendar Services page appears.
   
   
2. Select Edit Properties from the Edit pull-down menu. The Edit Calendar page appears.
   
   
3. Edit the calendar properties. Refer to the property descriptions from the table in the previous section for information.
   Note: While editing the calendar properties, if you are unsure of the purpose of a field, you can click on the highlighted field name for a brief Help description of the field.
   
   
4. Click Apply. The Services page for the calendar appears. The calendar properties are updated to reflect your edits.

Note: There may be additional, editable properties displayed on this page that are not listed here. They are specific to your DocuShare site. See your Site Administrator for details.

Only the owner of a calendar or a user with Manager access for that calendar can delete a calendar from DocuShare. You must be logged in to DocuShare to delete a calendar.

1. Open the calendar that you want to delete.
   
   
2. Select Delete from the Edit pull-down menu.
   
   
3. If there are no objects in the calendar, the Confirm Deletion page appears. Select the Delete button to delete the calendar.
   If the calendar contains other objects the Delete page appears. This page lists the number of event objects in the calendar that will be deleted. It also lists the number of objects that will not be deleted because of insufficient access rights or because they appear in other locations.
   
   
   • To delete the calendar and its contents select the Delete Object and Contents button.
     
     
   • To delete just the calendar select the Delete Just this Object button.
     
     
   Note: If you change your mind about deleting this calendar, use the Back button on your browser to close the Delete or Confirm Deletion page.
   
   
4. The Delete Successful page appears. Click the Click here to continue link.

The calendar is now deleted. You may need to Reload the page to see these changes.

The Edit Location command allows a user to move a DocuShare object from one location to another or allows the object to appear in multiple locations within the DocuShare repository. You must have at least Writer access to the object to change its location.

The location of an object is displayed in the Appears In property, which is displayed at the end of each Properties listing for an object. Using the Edit Location command allows you to edit the Appears In property.

This is a helpful command if you have created a calendar (or any other DocuShare object) in the wrong location and want to move it instead of deleting it and then re-creating it. It is also helpful if you would like the same object to appear in one or more additional locations. All DocuShare objects can appear in multiple locations at once. However, there is actually only one physical copy of the object in the DocuShare database; the system simply creates additional pointers or references to the object.

A negative side effect of this command is that if used incorrectly, you can orphan the object. Orphaned objects still exist within the DocuShare repository but are not accessible to users. Only a Site Administrator can recover orphaned objects.

1. Click the Services link for the calendar whose location you want to change. The Calendar Services page appears.
   
   
2. Select Edit Location from the Edit pull-down menu. The Edit Calendar Location page appears.
   
   
3. For the Appears In field, a scrolling list is displayed that contains all DocuShare collections to which you have at least Writer access. The calendar's current location is highlighted.
   
   
   • To move an object, select the collection where you wish to move this object. The previous location will be deselected.
     
     
   • To have an object appear in multiple locations, press the CONTROL key while selecting the additional locations.
     Note: Use the CONTROL key for MS Windows-based Operating Systems only. Substitute the Command (or Apple key) key for the MacOS. UNIX-based systems require no special key for this multiple list item selection.
     
     

   Note: Use caution when deselecting locations. Deselecting improperly can create orphaned files. Be sure that at least one location is selected in the scrolling list before selecting the Update Locations button.
   
   

4. Click the Update Locations button.

The Services page for that calendar now appears and the new location(s) is/are displayed in Appears In property. If you don't see this change reflected on the Services page, click Reload on your browser to refresh the page display.

You can add a calendar event to any calendar in DocuShare to which you have Writer access permission. You must be logged in to DocuShare create a calendar event.

You can also repeat DocuShare calendar events over a series of days/weeks/months. For example, if you have a meeting every two weeks, you can simply specify the meeting as repeating every two weeks, without having to enter each occurrence of the meeting.

1. Open the calendar where you want to add an event. If the calendar is in month view, click the date for the event. If the calendar is in week view, select Add Event for the date you want. The Add Event page appears.
   
   
2. Specify the event information. Refer to the table below for descriptions of each field.
   Note: While creating the calendar event, if you are unsure of the purpose of a field, you can click on the highlighted field name for a brief Help description of the field.
   
   
3. Click the Apply button.

The Add Event page has the following properties:

Note: There may be additional properties displayed on this page that are not listed here. They are specific to your DocuShare site. See your Site Administrator for details.

The event is created in the DocuShare calendar and the Services page for the event appears.

You can verify that the event was created by clicking the Appears In link to move you to the default calendar view. If you don't see the collection, click Reload on your browser to refresh the page display.

Note: After creating the event, you should view the access permissions for the event to make sure they provide the desired level of access for other users and groups. See the section Viewing and Editing DocuShare Object Permissions in Chapter 3 for more information on adjusting these permissions.

You can edit the properties of a calendar event at any time by selecting Edit Properties from the Edit pull-down menu on the calendar event's Services page. For repeating events, you can specify to edit all of the events in the series, or just the selected event.

You must be the owner of the calendar event or have at least Writer access permissions to edit event properties. You must also be logged in to DocuShare.

1. Open the calendar with the event you want to edit.
   
   
2. Click the date for the event. The Add Event page appears.
   
   
3. In the event list table, click the Services link for the event whose properties you want to edit. The Services page appears.
   
   
4. Select Edit Properties from the Edit pull-down menu. The Edit Event page appears.
   
   
5. Edit the information. Refer to the property descriptions in the previous section for information.
   Note: While editing the calendar event, if you are unsure of the purpose of a field, you can click on the highlighted field name for a brief Help description of the field.
   
   
6. Click the Apply button. The Services page for the event appears. The event properties have now been updated to reflect your changes.

Note: There may be additional properties displayed on this page that are not listed here. They are specific to your DocuShare site. See your Site Administrator for details.

Only the owner of a calendar event or a user with Manager permission for the event can delete it from DocuShare. For repeating events, you can specify to delete all of the events in the series, or just the selected event. You must be logged in to DocuShare to delete events.

1. Go to the day on which the event occurs. For example, in month view, click on the relevant day.
   
   
2. Click the Services link for the calendar event you want to delete. The Services page appears.
   
   
3. Select Delete from the Edit pull-down menu.
   
   
4. If this is the only instance of this event, the Confirm Deletion page appears. Select the Delete button to delete the event.
   If this is a repeating event, the Delete page appears. This page lists the number of events that will be deleted.
   
   
   • To delete all repeating events, select Delete All Events in This Series button.
     
     
   • To delete just this event select the Delete Just This Event button.
     
     

   Note: If you change your mind about deleting this collection, use the Back button on your browser to close the Delete or Confirm Deletion page.
   
   

5. The Delete Successful page appears. Click the Click here to continue link.

The collection is now deleted. You may need to Reload the page to see these changes.

Just as in other DocuShare objects, the Edit Location command allows a user to move a DocuShare event from one calendar to another or allows the event to appear in multiple calendars within the DocuShare repository. There is only one physical copy of the event in the DocuShare database; the system simply creates additional pointers or references to it.

You must have at least Writer access to the object to change its location. You must also be logged in to DocuShare.

The location of an object is displayed in the Appears In property, which is displayed at the end of each Properties listing for an object. Using the Edit Location command allows you to edit the Appears In property.

Editing the location of a calendar event enables creating group or shared calendars. You can create an event in your own calendar and then edit its location to appear in your calendar and your workgroup's shared calendar.

A negative side effect of this command is that if used incorrectly, you can orphan the event. Orphaned objects still exist within the DocuShare repository but are not accessible to users. Only a Site Administrator can recover orphaned objects.

1. Go to the day on which the event occurs. For example, in month view, click on the relevant day.
   
   
2. Click the Services link for the calendar event whose location you want to change. The Services page appears.
   
   
3. Select Edit Location from the Edit pull-down menu. The Edit Event Location page appears.
   
   
4. For the Appears In field, a scrolling list is displayed that contains all DocuShare calendars to which you have at least Writer access. The calendar's current location is highlighted.
   
   
• To move an event, select the calendar where you wish to move this event. The previous location will be deselected.
  
  
• To have an event appear in multiple calendars, press the CONTROL key while selecting the additional calendar(s).
  Note: Use the CONTROL key for MS Windows-based Operating Systems only. Substitute the Command (or Apple key) key for the MacOS. UNIX-based systems require no special key for this multiple list item selection.
  
  

Note: Use caution when deselecting locations. Deselecting improperly can create orphaned events. Be sure that at least one location is selected in the scrolling list before selecting the Update Locations button.



5. Click the Update Locations button.

The Services page for that calendar event now appears and the new location(s) is/are displayed in Appears In. If you don't see this change reflected on the Services page, click Reload on your browser to refresh the page display.

Table of Contents	DocuShare Files	DocuShare URLs