Google Calendar Tool

From KPE Tools Help

1 Introduction
2 Google calendar export tool
3 Google calendar management part
4 See also

[edit] Introduction

The Google Calendar tool supports export of Tasks and ToDos of a KP-Environment user towards a Google account, more precisely towards the Agenda of the Google account.
Google Calendar list functionalities can be summarized as:

Get existing calendars (that belong to the Google account, or those where the Google account has sufficient rights)
Create a new calendar, modify or delete an existing one
Export an event or a list of events towards the Google calendar.
Share a calendar with other Google accounts

The Google calendar tool can be used in 2 different ways :

in case of the export of one event,
in case of the export of a list of events.

[edit] Google calendar export tool

[edit] Exporting an event towards Google Calendar (1)

If you export a task (see KP-Environment Process View) or a ToDo (see KP-Environment ToDo Tool), the Google Calendar tool will be opened.

Figure 1: Created ToDo Item can be exported to a Google calendar by clicking the Google export button.

Google Calendar tool will be opened (see figure 2) and presented with a dialog box that contains authentification login and password fields (to Google account).

1. Type your Google account login name and password.
2. Select if you want to create a new calendar, or get already existing calendars to be modified.

Figure 2: Google Calendar tool login page.

[edit] Create a new Calendar

Select "Create new calendar" radio button (see figure 2 above). Export Event towards Google Calendar window (see figure 3)will be opened. Type the name of the new calendar, your Google login name and password and press "Create new calendar" button.

Figure 3: Export Event towards Google Calendar.

[edit] Export to already existing Google Calendar

If you want to modify existing calendars, select "Get already existing calendars" and click "Get Calendars" button (see figure 4).

Figure 4: Google Calendar tool login page.

Calendars that the user has rights to modify will be listed (see figure 5). Select a calendar and click "Next" button.

Figure 5: Available Google Calendars listed in Calendar tool.

On the next login page (see figure 6) the name and description of the event you are adding to Google Calendar are asked. Type event information and then press "Export event towards Google!" button.

Figure 6: Event page.

When the event is successfully created, appears a "Event created ok in the Google Calendar" window (see figure 7).

Figure 7: Event created Ok in the Google Calendar.

[edit] Event management page (2_1)

Once the user is logged and in case that the module is called with only one event in parameter, the following page is displayed :

Figure 4: Event management page.

The different information are filled but the current page allows the user to modify any field.

[edit] Event list page (2_2)

Once the user is logged and in case that the module is called with a list of events in parameter, the following page is displayed :

Figure 5: Event list page.

This page allows the user to see the list of events and to sort it.

[edit] Choose the calendar (3)

This following page is the one that allows the user to choose the calendar where the event(s) will be exported to. It also permits to access to the management calendar popup (Create a calendar) through the "Create new calendar" or "Modify the calendar" buttons. In case of a calendar creation, the user just have to click on the Create button. In case of a calendar modification or deletion, the user have to select an existing calendar in the list.

In case of an exportation of only one event, it is displayed as in the Figure 6. Event information selected are summarized at the top of the current page.

Figure 6: Choose the calendar (for one event).

When the Google calendar module has been called with a list of events in parameter, the current page is displayed as in the Figure 7.

Figure 7: Choose the calendar (for a list of events).

[edit] Choose the events (4)

This following page is only displayed in the case that a list of events has been passed in parameter to the Google calendar module. It allows the user to select/unselect the events that he wants to export towards the selected calendar.

Figure 8: Choose the events to export towards the selected calendar.

[edit] Export the event or the list of events (5)

In the case of a single event passed in parameter, this following page is displayed to summarized the information about the export of the event towards the calendar.

Figure 9: Export the only event.

When a list of events has been passed to the module, the current page presents the calendar selected and the list of events choosen in the previous page (Figure 8).

Figure 10: Export the list of events.

For the two solutions, the "Export event towards Google!" button permits to finalize the export.
Once you have clicked on it, a message box shall appear to inform you that the export of the event (or the list of events) has succeed.
In the case of the multiple export, another message box shall appear to ask you if you want to do another export of events to another calendar.

[edit] Google calendar management part

[edit] Access to the calendar management

To create or modify a calendar, the user has to click on the "create" or "modify" button of the page 3 presented on the Figure 7. Then, the pop-up of calendar management is displayed.

[edit] Create a calendar (6)

When the Google calendar module is launched, a list of shared users is passed in parameter. These users depends on the event or the list of events also passed in parameter.

The creation page contains a calendar field where the user can enter the name of the new calendar. This information is required to access to the page 7. It also presents the pre-filled list of shared users. The list already contains the participants passed in parameter to the module, but the user is allowed to add new shared users. Once the user has completed the page, he can click on the "Next" button to access to the page 7 (Set the calendar).

The following screen-shot (Figure 11) presents the calendar creation canvas :

Figure 11: Create a new calendar.

[edit] Modify a calendar (6)

As in the creation case, the same page is presented but the calendar field is pre-filled with the one selected on the page 3 (the selected row in the calendar list). According to the shared user list, it is also pre-filled with the list of participants passed in parameter to the module, but also, with the list of already shared users relative to the calendar selected. These second list of shared users come from the Google Agenda, and their permissions are also recovered to be displayed in the shared user list of the current page.

Once the user has completed the page, he can click on the "Next" button to access to the page 7 (Set the calendar).

The following screen-shot (Figure 12) presents the calendar modification canvas :

Figure 12: Modify a calendar.

[edit] Set the calendar (7)

The following screen-shot shows the final step of the calendar creation/modification :

Figure 13: Summary of the Google calendar.

This presents the summary of the parameters chosen (name of the calendar, name of the Google account where the calendar will be added in the Google Agenda, and the list of Google accounts that the calendar will be shared with. You can go back and add/remove any of these users. When you are done, click on "Set the calendar", will share the calendar with the chosen accounts, a message box will inform you that the operation is successed, the pop-up will be closed and page 3 (Choose the calendar) will be presented again to the user.