Skip to main content

IMPORTANT - Product End of Life Statement - IMPORTANT

Request RE, Survey, and Calendar 1.5 Support Ending December 31, 2020
Contact Kinetic Data Support with Questions
Kinetic Community

User Manual






































User and Management Guide

Version 1.5.0


July 8, 2011




© 2011, Kinetic Data, Inc.

Kinetic Data, Inc, a BMC Software® Solutions Partner.

Remedy, a BMC Software Company

Remedy, the Remedy logo and all other Remedy product or service names and registered trademarks are trademarks of BMC Software, Inc.





Figure 1: Remedy Open Icon. 10

Figure 2: All Tab on the Object List Dialog. 10

Figure 3: Kinetic Calendar Console. 11

Figure 4: Calendar Properties Dialog. 12

Figure 5: Deleting a Calendar14

Figure 6: Cloning a Calendar15

Figure 7: Resource Permissions Dialog. 16

Figure 8: Selection List Screen. 16

Figure 9: Calendar Event Type Dialog. 18

Figure 10: Source change Confirmation Screen. 18

Figure 11: Choosing "Other Calendar" Source. 19

Figure 12: Menu Options Tab. 20

Figure 13: Display Fields Tab. 22

Figure 14: Notifications Tab. 23

Figure 15: Kinetic Audit Information. 24

Figure 16: Choose Custom.. 26

Figure 17: Sample Source Form Drop-Down Menu. 27

Figure 18: Sample Source Description Field. 28

Figure 19: Filter Fields Tab. 30

Figure 20: Resources Screen. 31

Figure 21: Configuration Manager Hyperlink. 32

Figure 22: Properties Viewer Example (portion)33

Figure 23: Log Viewer Example (portion)33

Figure 24: Readiness Check Example (portion)34

Figure 25: Error Messages Screen. 34

Figure 26: Password Encrypter Screen. 35

Figure 27: Configuration Manager Dialog. 36

Figure 28: Configuration Item Dialog. 36

Figure 29: Menus Tab. 37

Figure 30: Add/Modify Configuration Menus Dialog. 38

Figure 31: Deleting a Menu. 38

Figure 32: Deleted Calendars. 39

Figure 33: Audit Window in Configuration Manager40

Figure 34: View Audit Information. 40

Figure 35: The Web Calendar - Daily View.. 41

Figure 36: Small Calendar - A different day currently being viewed. 42

Figure 37: Selecting a specific Calendar43

Figure 38: Resulting Web Calendar View.. 43

Figure 39: Changing to a different calendar44

Figure 40: Login Screen. 45

Figure 41: Click on “My Calendars”47

Figure 42: “My Calendars” for User – Demo. 48

Figure 43: All Calendars Available to “My Calendar” for user: Demo. 49

Figure 44: Calendar List49

Figure 45: My Calendar50

Figure 46: Different Calendars – Different NamesFigure. 50

Figure 47: Toggle or Click to Different Dates. 51

Figure 48: Add Event for Authenticated. 51

Figure 49: Web Calendar “Add Event” Dialog Screen. 52

Figure 50: Example - Events on a Web Calendar54

Figure 51: Description and Time Change Dialog. 54

Figure 52:  Calendar Audits. 55

Figure 53: Deleting Events Example. 56

Figure 54: Delete Event Confirmation. 56

Chapter 1                             Overview

Kinetic Calendar


Calendar Uses

Use your calendar for these and other purposes:

§  business scheduling

§  coordinate and organize events

§  back-up calendars 

§  change requests

§  IT Infrastructure Library (ITIL) process reviews

Kinetic Calendar is a comprehensive tool to be used for scheduling and organizing all types of information from any BMC Remedy-based application.   


Kinetic Calendar

Calendar allows a simple approach to creating calendars and schedules whether used for personal time management or for an entire organization.  Our goal in creating this software is to make scheduling, planning, coordinating and collaboration easy for everyone.   With this software, you can set up project phases as independent objects, quickly and simply modify dates, coordinate events, manage change requests and create back-up calendars. 



Kinetic Calendar Users








Web Calendar






Kinetic Data and BMC Partnership

As a BMC/Remedy user, you know that Remedy delivers service management software solutions that enable your organization to automate and manage internal and external service and support processes. As a BMC Solutions Partner, Kinetic Data delivers Remedy system enhancements expanding Remedy capabilities and processes that save you time while providing faster results more efficiently.

Kinetic Calendar User and Management Guide


This manual is intended for Kinetic Calendar managers and users.

The Calendar user interface was designed from the start, with a single principle in mind, ease-of-use.  Since even the best features and productivity gains can be overshadowed unless users can easily take advantage of them, Kinetic Calendar was built to be easy-to-use, allowing multiple users to edit calendar information and providing methods for “view only” access. 

This manual provides the ability to see time and day-based data in a calendar form by retrieving Remedy data and inputting it onto a calendar to see and manage.  

Who Should Read this Manual?

To use Kinetic Calendar, you must have user privileges.  See Users and Groups Administration.

The purpose of this chapter is to provide the Kinetic Calendar system administrators with definitions of user groups to apply within the Remedy user setup and security, which allows you to understand how to manage security.

Within Kinetic Calendar there are two groups using two distinct sections of the calendar system.  There are Administrative and Managerial users that go into Remedy and actually create calendars.  Then there are users that interact with the Web Calendar.  Kinetic Calendar offers the ability to create and view both private and public calendars. 

Kinetic Calendar Users and Groups

Kinetic Calendar delivers four user groups for security setup. Please see your Remedy Action Request System documentation for more information on assigning User Groups to users.

The four types of users are Calendar Creator, Calendar Manager, Calendar Event Changer, and Calendar Event Viewer.

Calendar Creator

The main purpose of this role is to create calendars. Once created, they can assign another user the role of calendar manager.  A calendar is setup as private or public.  All customers can view events on a public calendar. Only specific groups, assigned by the calendar creator, can view events on private calendars.  It is important for the calendar creator to have an understanding of Remedy security groups, and which users belong to each group.  Because of this requirement, calendar creators are typically Remedy administrators or department managers.

A calendar creator must belong to either the Administrator group or the KS_CAL and KS_CAL_Creator groups.  Calendar creators also require a Remedy write license.

Calendar creators have all the security privileges as calendar managers, calendar event changers, and calendar event viewers.

Calendar Manager

The calendar manager creates and modifies the definition of a calendar.  This includes giving other Remedy users calendar roles, such as Manager, Event Changer, or Event Viewer. 

The calendar manager also creates the event types for the calendar.  Event types define the structure, or template of events.  This is where the calendar manager can organize events based on some type of criteria, or even display records from a different Remedy form.

A calendar manager must belong to either the Administrator group or the KS_CAL and KS_CAL_Manager groups.  Calendar managers also require Remedy write license.

Calendar Managers also have all the security privileges as calendar event changers and calendar event viewers.

Calendar Event Changer

Calendar users with this role have permission to create and modify events on the calendar they are assigned to.  These users generally will not belong to the KS_CAL_Manager or KS_CAL_Creator groups, so they will not have access to the Kinetic Calendar Manager console.  These users will be creating and modifying events from the calendar web interface.

Depending on your Remedy server settings, calendar event changers may or may not need a write license.  If your server is configured with submitter mode locked, event changers will be able to create and modify their own events with only a read license.  Please see the Remedy user manuals for information regarding this setting.

Calendar Event Viewer

Depending on the security access setup in the calendar, viewers may or may not need this role to view events on a specific calendar.  If the calendar is setup as public, anybody can view this calendar, so no users will need to be assigned the Event Viewer role.  If the calendar is private, users will need to belong to one of the calendar roles to view events.

No Remedy licenses are required for users of public calendars.  Viewers of private calendars are required to authenticate with Remedy before viewing the calendar, therefore, must at least have a read license.

Chapter 3                             Setting-up and Managing Calendar

Calendars and event types are created in the Remedy user tool, but can be accessed with the web interface to create and manage events. 

This chapter provides procedures to create a new calendar. 

To Access the Calendar Manager

1.         Open the Remedy AR System User Tool. From the AR System User toolbar, select the Open icon.


Figure 1: Remedy Open Icon


From the AR System User toolbar, select the File menu and Open.

2.         The All tab of the Object List dialog displays, listing all Remedy forms.


Figure 2: All Tab on the Object List Dialog

3.         From the All tab list of the Object List dialog, highlight the Kinetic Calendar Console entry point and double-click to open it.


Figure 3: Kinetic Calendar Console

The Calendar Manager Console offers a selection of calendars and events created by calendar creators, managers and users.  From the console set-up, access, and monitoring of functions for all types of calendar events is accomplished. 

The top tier of the console lists calendars within the application that a user has permission to access.  Selecting or highlighting a calendar in this area enables a user to update information in the bottom, or second tier, of the console calendar. 

Second tier functions offer tools to assist in better managing details within each calendar, such as:

§Cloning Calendars

§Event Types

§Calendar Manager Console Audit

Because this is a permissions-based system, it must be set-up by a user who belongs to either the Administrator or Calendar Creator group.


From the Permissions Tab, users are assigned to a calendar by a calendar creator or manager, and given a calendar role.  Additional functions in this section are Event Types, and Audit

Calendar Properties Functions

The Calendar Properties Dialog appears after clicking Add or Modify in the top tier of the console.


Figure 4: Calendar Properties Dialog

Within the Calendar Properties Dialog area Names, Groups, and Statuses can be created offering permissions and informative internal sources. 

A unique Web Name can be created that will appear in the Uniform Resource Locator (URL), the address that defines the route to a file on a Web server.    

Creating or Modifying a Calendar

1.         From the Calendar Manager Console, click Add or Modify

2.         Enter a Calendar Name.

3.         Enter a Web Name using alpha/numeric key strokes with no spaces.   

4.         Select the Visibility as either Public or Private

§   Private requires the user to “log-in” before they can see the calendar.  The user must belong to one of the groups specified in the Viewer Group list.

§   Public will allow any users who have access to the specific web application to view the calendar. 

5.         If you choose Private, select a Viewer Group from the drop-down menu.  

6.         Select an Active or Inactive Status.  Only active calendars will be accessible to users through the web client.  Inactive calendars allow managers to configure and setup the calendar, without letting users access the calendar.

Note: Statuses can be toggled from active to inactive, or inactive to active from the Calendar Manager Console screen also by clicking the Toggle Status button. 

7.         The Display Page selection determines which JSP file to render the calendar in.  By default, all calendars will use the ‘calendarView.jsp’ file.  If this value is blank, the default JSP will be used.  Changing the value of this field requires a corresponding file to exist on your web server.

8.         The Default View selection determines what web view the calendar will initially be displayed in.  If this value is blank, the month view will be used by default.  Other valid choices are week, day, and list.

9.         The Encoding selection determines the character set used to send the data to and from the web client.  If this value is blank, UTF-8 will be used by default.

10.       Under Calendar Rules, on the right side of the screen is the option to make the calendar Visible in Web Listing.  By default, a calendar will be displayed in the listing.  Also is the option to enable Manager Notifications, or not.  This setting is global for the calendar, and will override any event type manager notifications if set to ‘Disabled’.

11.       Click Save when finished. 

12.       Click Close to exit the dialog without saving your choices.

Searching For Calendars

The Calendar Manager Console provides a few fields to help filter the result list and narrow down your search for a calendar.  The Status field shows calendars that have either Active or Inactive status.  To view both active and inactive calendars, choose Clear

Note:  The Status for calendars can be viewed and changed from the Calendar Manager Console, as well as from within the Calendar Properties Dialog.   

The Visibility field shows only calendars that have either Public or Private status.  To view all calendars, choose Clear.  

A Calendar Name field also exists to filter the calendar list by name.  This will perform a search on the calendar name field, to display all calendars that meet the search criteria.  Since this is a full text search, the search criteria can match any part of the calendar name.

Clicking the Refresh button will reapply all table qualifications and refresh their results.

Deleting Calendars

Clicking Delete from the Calendar Manager Console will generate the box below as a notice that if “Yes” is clicked, the calendar resources, events and event types will also be deleted for that calendar. 


Figure 5: Deleting a Calendar


Calendars are not deleted immediately; the calendar status field is just set to ‘Delete’.  There is an escalation that runs every 24 hours and checks for calendars that have been marked for deletion for at least 24 hours.  If any are found, they will be automatically deleted at this time.  This gives Remedy administrators at least one day to undo a deleted calendar if it was deleted by mistake.


Cloning Calendars

Kinetic Calendar provides an easy way to copy existing calendars.  We call this process ‘cloning’.  Cloning a calendar will create a copy of the calendar along with all user permissions and event types.  Any events that are specific to the source calendar are not copied.

Clicking Clone from the Calendar Manager Console will display a dialog that includes the name, and web name of the calendar you are trying to clone.  You are expected to change the both values, taking care to ensure the web name has not yet been used. 


Figure 6: Cloning a Calendar


The Permissions tab is where an Administrator or Manager can manage who has access to create/modify view Default events on private calendars. Use Remedy permissions for Custom or Filtered events.

1.         From the Permissions Tab, click Add.  The Resource Permissions dialog opens. 

Important Note


See Chapter 4 – Managing Calanders for information on adding resources to Kinetic Calendar


Figure 7: Resource Permissions Dialog

2.         Type a Name and click the “Lookup Name” button, or alternately, type a Remedy User ID and click the “Lookup ID” button to query from the Selection List.


Manager can Create/Delete/Edit events


Change All Events can Create/Delete/Edit events


View can only view events




Figure 8: Selection List Screen

3.         From the drop-down menu, select a Role.  Choices are Manager, Change All Events or View.  A calendar may have an unlimited number of resources, of any role.

4.         Click Save when finished. 

Click Close to exit the dialog and not save your choices.  


Event Types


Event Types will be applicable to your industry or organization.  For instance, examples might be; Primary, Critical Change, Backup or Manager. 

An Event Type is a way of grouping like events together, similar to a category. The type of event determines where the data comes from, and the options you have for display.

Where your event data comes from is determined by a setting in the event type, called “source”.  The values for this setting are: Default, Custom, Other Calendar, and Filtered.

§   Choosing Default means that your event data is stored in an internal Kinetic Calendar event form and not pulled from one of your own forms.  Default event types allow event changers the ability to create and modify calendar events interactively.

§   Choosing Custom allows you to access data in your own Remedy forms outside of Kinetic Calendar (i.e., Change Management, SLA, or Incident Applications).  Custom offers a user the ability to define what fields from the source form are mapped to specific events.  Custom event types do not allow any user to create or modify events from the calendar web interface.  These events are view only.

§   Choosing Other Calendar lets you show other Event Types within Kinetic Calendar that are configured for other calendars.  This function offers the ability to “layer” calendars on top of each other.  Events linked from other calendars may not be created or edited on the web interface from this calendar.  These events can only be created and edited from their root calendar.

§   Choosing Filtered offers functionality similar to Custom event types, with the added ability to filter the events that are displayed on the web client, and drill down into specific values of fields on the source form.

Important Note:  If you are showing custom events, events from other calendars, or filtered events, those events are READ ONLY. 

By selecting the different sources, Default, Custom, Other Calendar, or Filtered, different tabs or options will be available to further define that event type. 

1.         From the Event Types Tab, click Add to create, or Modify to view the event.  A new event type is created with a “Default” source.

New Event Type




An Event Type name might be “Primary Contact” for your SQL Server On-Call calendar.


Figure 9: Calendar Event Type Dialog


1.         Give the event type a descriptive Name for how it best defines or categorizes the events created under it.  (See example in sidebar.) 

A new event type is shown with the Default source chosen (See above).

2.         Choose Active or Inactive from the Status field.  Only active event types will be displayed on the web client.

3.         Next to the Source field, if you choose Custom, Other Calendar, or Filtered a screen will appear asking if you want to proceed. 


Figure 10: Source change Confirmation Screen

Custom (Source)

Choosing Custom enables a user to access any table within Remedy and show information on the screen.  See Publishing Data to Your Calendar (later in this chapter) for information on completing the fields and how to proceed. 

Other Calendars (Source)

Choosing Other Calendars is an efficient way to aggregate a number of calendars.  It enables a user to access fields from other calendars into an event on a “master calendar.”  For example, use this feature if you would want to list the SQL On-Call people, the Oracle On-Call people, and the DB2 On-Call people all on one calendar.  Other Calendar event types can only link to other Default event types.

Important Note:  If you are showing events from other calendars, those events are READ ONLY.  You cannot change them. 


Figure 11: Choosing "Other Calendar" Source


1.         Using the drop-down menu choose a Source Calendar.

2.         Using the drop-down menu choose a Source Event Type.  If the event type is not selected, all event types for the linked calendar will be shown.

3.          Click Save when finished. 

Click Close to exit the dialog and not save your choices.  

Filtered (Source)

Choosing Filtered enables a user to access any form within Remedy and show information on the screen. See Publishing Data to Your Calendar (later in this chapter) for information on completing the fields and how to proceed. A filtered event type is very similar to a custom event type, but it also has the ability to define fields that the end user can use to filter the events that appear on the web client.

Menu Options Tab

The first tab for a default source is menu options.  Default and Custom event types allow attaching information from another form to the events that belong to these event types.  This can be especially useful to display extra information about a resource, change request, or an incident, or to add a menu of people available for user desk coverage.  These fields are optional, and may be left blank.


Figure 12: Menu Options Tab


Figure 12 above shows this event type will allow one menu item per event.  The menu will have a name of “Contact”, and the menu options will be built from the KS_CAL_Res_ResCal_Join form.  This is a join form containing the resources associated with a calendar. 


The data returned from this form is determined by the specified qualification, and will produce a list of menu options displaying the value in the ‘Name’ field, but using the ‘Request ID’ field as the lookup index.


This particular example will allow one menu.  It is possible to attach multiple menus to an event as well.  This could be useful for displaying information for both a primary contact, and a backup contact.


1.         From the Menu Name field, type an applicable name such as Resource or Contact. 

2.         From the Menu Form field choose the applicable form from the drop-down menu. 


Apply a unique identifier to the Value Field.  Typically, it is a request ID (field 1) or it could be an instance ID (field 179).  This value is used to look up the record in the menu form, so use a field with an index for best performance.




From the Label Field choose an applicable label from the drop-down menu (i.e., first name/last name, e-mail, request ID, etc.)  This is the value that users will see in the event.

4.         From the Value Field choose the true value for that field.  This represents the linkage back to this record in the database where it is stored (See sidebar tip). 

5.         Write a Qualification that describes the data that corresponds to the menu. The calendar workflow uses this qualification to display the proper data in the menu list.  (See sidebar note). 

6.         From the Allow field determine if you want one record to be selected or multiple records using the drop-down menu. 




Keywords will include a “\” to conform to external qualification syntax.  Use Advanced Qualification for keywords. 


In some situations, a user may want multiple people such as a series of approvers for some type of calendar event.  In this case you would select “multiple” to offer several contact choices on the Web Calendar. 


Display Fields Tab

This area offers the opportunity to select additional fields that correspond to the menu item.  You can add fields from the menu form chosen on the “Menu Options” tab to display more information about the selected menu item.

For our event type example, ask yourself what fields do I want to appear beside a primary contact on this event?  You would probably want the contact’s email address and telephone number. For a change request, or an incident, you might want to include the summary, category, type, item, and possibly the requester’s name.



Figure 13: Display Fields Tab

Additional Display Fields

1.         From Output Format, choose the format template used to display this information.

2.         From Select Field, choose a field from the drop-down menu.  A Field Identifier and Field Label appear.  You may modify the field label to suit your needs.  In Figure 13, the “Phone1” field was renamed to read “Work Phone”.

3.         Click the Add button to add the field to the selected fields list.

4.         Continue to add as many fields as desired.

5.         Fields may be removed from the list in the same fashion.  Just click the field you wish to remove from the table, and click the Remove button.

Notifications Tab

Use this screen to setup manager notifications for this event type.  Managers are only sent an email notification if there is a day without a scheduled event for X number of days into the future. 

For instance, this provides an automated way for a manager to ensure there is at least one on-call person scheduled every day for X number of days.

If manager notifications are not needed for this event type, simply disable by selecting the appropriate option. 

Please note, this selection only enables, or disables manager notifications for this event type.  The calendar notifications setting, configured by the calendar creator, takes precedence over this setting.  If the calendar notifications are disabled, then this setting will have no effect.


Figure 14: Notifications Tab

Calendar Manager Console Audit

Additions and modifications for Kinetic Calendar will be performed by managers or administrators.  The Audit tab allows a manager to see changes that have taken place for events and event types for each calendar. 

Audit changes can include:

§   Changes to Events, and Event Types

§   Deletions of calendars, events, or event types

§   Various “field” and “value” changes


Figure 15: Kinetic Audit Information

Daylight savings times rules vary if the software can only retrieve your browser time zone.  

Important Note

In addition to the Application, Audit Type, and Audit Message, the information on the tracked change include:

§   User making the change

§   Date/time of the change

§   Previous value

§   Field Name

§   New Value

§   Time Zone

Note:  A calendar event(s) time zone will be reflected by the “Remedy” time zone (i.e., your user preference is set to a time zone depending on where you are normally logged-in).  The software will retrieve that time zone, first, and then whatever time zone your browser is using.  Finally, if that can’t be retrieved, the software will use the server time zone. 

1.         To view auditing details, from the Audit Tab highlight an audit and click View

2.         When finished, click Close

Publishing Other Data to Your Calendar

Kinetic Calendar provides the ability to display and share data from time-based Remedy solutions, allowing Kinetic Calendar to integrate with your existing data management solution.  The information that comes from another source can then be published into Kinetic Calendar as READ ONLY information. 


1.         From the Event Types tab click Add or Modify




Enter field information for Name in a short and concise manner so it will fit in the “Web Calendar” window. 

Type in an event type Name.  See TIP.

3.         Check Custom.


Figure 16: Choose Custom


The first tab contains the “Source Fields” to use for the external event.  This is a field mapping from another Remedy form, into the Calendar Events form.  Calendar will substitute the fields specified in these fields for the normal event fields of the same name.

4.         From Source Form click the drop-down menu and choose another Remedy form.  This is the form where the data will come from.



Important Note:  User permissions are applicable for a form whether a public or private calendar is being accessed.  If a public calendar is being accessed the “default” web user must have permission for the chosen form.  In accessing private calendars, the logged-in user needs permission for the form and all fields, as well.   


Figure 17: Sample Source Form Drop-Down Menu

5.         Select a field from the drop-down menu for Description Field that corresponds to a description for the event on the source form.  This field can be any length.


Figure 18: Sample Source Description Field

6.         Select a field from the drop-down menu for Event Name Field.   Choose a field that corresponds to the event name on the source form. 



Select a field from the drop-down menu for Time Begin Field.  This must be either a time field, or a date/time field in Remedy (i.e., Create Date).


Qualifications: Part of the qualification criteria is that it only corresponds to a particular month.  Therefore, if the month of March is indicated, the system retrieves only those events for March. 



Select a field from the drop-down menu for Date Begin Field.  This must be either a date field, or a date/time field in Remedy (i.e., Create Date, Modified Date, Assigned Date). 

9.         If applicable, select a Duration Field from the drop-down menu.  Currently, this value must be an integer field, representing the duration in number of minutes. 

If you do not have a value in the Duration field, the application will calculate the difference between the Start Date/Time and End Date/Time. If your End Date/Time and Start Date/Time are the same, the event will be marked as an all day event. If the time of the event goes over midnight, it will be shown as a full day.

10.       Select a field from the drop-down menu for Date End Field.  Again, this must be either a date field, or a date/time field in Remedy. 

11.       Type in or select a field from the drop-down menu for Qualification

Example:  Assume your organization creates “Change Notices” for changes made to an event, but only those events deemed “critical” need to be viewed.  In that case, the qualification would be typed as ‘type’ = “critical”.

If you want to dynamically create calendars, you can put a placeholder value in the qualification, and then use a URL parameter when the calendar is called on the web. To identify the placeholder, enclose the value in double curly brackets . Once you have the placeholder, you can add this to the URL as a parameter.

Example:  You want to dynamically set the server by a value passed in the URL. Your qualification for the event would be ‘Server Name’ LIKE “

UndefinedNameError: reference to undefined name 'sname' (click for details)
    at (Kinetic_Calendar/Documentation/Version_1.5.0/User_Manual), /content/body/div[2]/div[18]/div[3]/p/span, line 1, column 1
%”. Then, your parameter would include a string like this; &sname=myServerName. The & adds a new parameter and the sname links the value after the equals sign to the qualification string for the calendar. You can have multiple parameters passed into the URL.


12.       Click Save when finished. 

13.       Click Close to exit the dialog and not save your choices.  


Filter Fields Tab

For Filtered event types, another tab exists called ‘Filter Fields’.  This area offers the opportunity to select additional fields that end users may filter data on, and drill down into the data based on fields defined in this list.   You can add these fields from the source form chosen on the “Source Fields” tab.

For a change request, or an incident, you might want to include the category, type, item, status, priority, urgency, and possibly the requester’s name or the assignee’s name.

If you prefer to filter the data immediately when the calendar is displayed, the Default Filter Field selection allows you to indicate what field should be used for the initial filter.


Figure 19: Filter Fields Tab


Chapter 4                             Managing Calendar

On the left side of the Calendar Manager Console are helpful links to assist in administering the calendars.  While other areas in which you have been working are applicable to specific calendars and events, these links are global to the Calendar application. 

Not all links will be available to all calendar users. They are dependent on permissions.




In previous versions users had to be listed as a Resource to have access to Private calendars. Kinetic Calendar now uses Remedy authentication and permissions to allow users access to private calendars and the data displayed from Remedy. The only reason to add users as resources is to control the access to Add Events link directly on a calendar using the Default event type.


Figure 20: Resources Screen


The Resources screen displays the users that have been added to the KS_CAL_Resources form.  At the least, make sure you have filled in the User ID (Remedy ID) and the Name fields. These users may be assigned calendar roles, as described in the Permissions section.  Typically workflow is added to automatically populate this form from another data source, like  the User form, the SHR:People form, or some other source.





You must be a Remedy Administrator to access the Configuration Manager dialog

Configuration allows Administrators to build, arrange, organize and shape various aspects of the application. They can manage configuration items including:


§   Configuration Items

§   Add or Modify Menus

§   Delete a Menu

§   View More Details on Audits

On the left side of the Calendar Console are links to help manage or administer Kinetic Calendar.  Clicking each link will open either open a web page with information regarding the Kinetic Calendar application, or another Remedy form with relevant information.  


Figure 21: Configuration Manager Hyperlink


Properties Viewer

The Properties Viewer displays web server properties including the logging level and Remedy server and the environment properties, such as JDK and the class path used by your web server. 



Figure 22: Properties Viewer Example (portion)


Log Viewer

The Log Viewer displays the web server logs.  Information in this log is dependent on what log level is set in the properties.  The entire log is available on your web server in the temp directory on the same level as the KinCal directory.



Figure 23: Log Viewer Example (portion)

Readiness Check

The Readiness Check link is useful for checking that the appropriate jars are in place or that the license is active, etc.  This would most often be used after a new web server is installed. 



Figure 24: Readiness Check Example (portion)


Error Messages

The Error Messages screen allows an Administrator to create and manage error messages that display to a Kinetic Calendar user. 


As an example, an appropriate error message may appear when a user is incorrectly trying to access a certain field or drop-down menu. 



Figure 25: Error Messages Screen


Password Encrypter

The Password Encrypter link opens a web page that will encrypt plain text passwords.  The encrypted password can then be stored in the application properties file (KinCal.xml) instead of a plain text password.


File:Documentation/Kinetic_Calendar/KineticCalendar_UserManual/image033.jpgFigure 26: Password Encrypter Screen


These items set much of the default settings for the Kinetic Calendar application, including default views and license keys.


Figure 27: Configuration Manager Dialog

1.         From the Configurations Item Tab, click Add or Modify.  The Configuration Item Dialog appears. 



Figure 28: Configuration Item Dialog

2.         From the drop-down menu under Configuration Type, choose from the selections offered. 

3.         From the drop-down menu under Config Property, choose either Web Property, Remedy Property or Clear. 

4.         Type a Configuration Value in the window provided.

Example:  A potential scheduling problem exists for the on-call resource calendar: $Calendar_Name$.  Please click the following link to view this calendar: $Web_Name$

5.         Click Save when finished. 

6.         Click Close to exit the dialog and not save your input. 


Figure 29: Menus Tab

1.         From the Menus Tab, click Add or Modify.  The Menus Dialog appears. 


Figure 30: Add/Modify Configuration Menus Dialog

1.         From the Menus Tab, highlight a menu and click Delete.  The following box appears asking if you wish to delete the selected menu item?


Figure 31: Deleting a Menu

2.         Click Yes or No


Deleted Calendars

The Deleted Calendars tab allows a manager to see all calendars that have been marked for deletion, but haven’t actually been deleted yet.  The manager can manually restore the calendar to the system by clicking the ‘Restore’ button, or manually delete the calendar by clicking the ‘Delete’ calendar.


Figure 32: Deleted Calendars

The Audit tab allows a manager to see changes that have taken place for an item.  Changes that are audited include:

§   Event changes, once the status is “Active”.  Changes in “Inactive” status are considered in development and are not audited.

§   Deletions of calendar events

§   Integration changes

The information tracked on the change includes:

§   User

§   Audit Date/Time

§   Previous Value

§   Field Name

§   New Value


Figure 33: Audit Window in Configuration Manager

1.         From the Audit Tab, use the scroll bar or click Next or Previous to locate and highlight an audit item. 

2.         Click View.  The Audit Information table appears. 



Figure 34: View Audit Information

Note:  Audit detail information is not changeable. 

3.         Click Close to exit the screen. 

Chapter 5     Using The Web Calendar

The Web Calendar

Viewing your Remedy data on the web is the overall goal of Kinetic Calendar. Multiple styles and types are available with the web view


Time Zone for current calendar.


Multiple views.


Monthly View



Weekly View




Figure 35: The Web Calendar - Daily View


Calendar works much the same as other standard calendars with easy-to-access Day, Week, Month and List views.  Each view shows the selected month with today’s date highlighted in yellow on the upper left side of the screen.  Using the arrows at the top of the screen, a user has the ability to toggle forward or backward through the different available views or use the Day, Week, Month, or List tabs located at the top right area of the calendar. 


The small calendar (in the upper left corner) shows today’s date highlighted in green.  (If viewing a different day or week from today it will highlight in yellow.) 



Figure 36: Small Calendar - A different day currently being viewed

Accessing Web Calendars

Kinetic Calendar offers four ways to access web calendars.  First, highlight a calendar from the Calendar Manager Console and then click Launch.  This method will access the current day of the calendar “highlighted” on the console. 

A second method is through the “My Calendars” link in the upper right of the screen after you are authenticated and logged in. This method gives each user access to all web calendars they have been given permission to view.  From this view you can select the individual calendars you want to view, or by clicking the individual calendar name you can navigate to see just that calendar.

The third method is to display all public calendars in the system.  Users can simply navigate to the Default Web Server configuration setting (typically get a list of all public calendars.  Clicking the name of the calendar will then forward the user to the monthly calendar view for that calendar.

The last method is direct URL access using the Default Web Server configuration with a specific identifier for the calendar you want. For example:

The text “/KinCal/calendar?CalendarName=” is required by the application and then you replace “”myCalendarWebName with the Web name you setup when the calendar was created.

Options when Viewing Calendars

The example below, shows opening a calendar from the Calendar Manager Console. Following that example are the optional parameters you can add to a Calendar URL. These parameters are useful for targeting the calendar to specific users needs.

The SQL On-Call calendar is highlighted. 


Figure 37: Selecting a specific Calendar

To access the web calendar view of that calendar, click Launch





URL representing web calendar view.




Hyperlink to the Public Calendars listing.


Figure 38: Resulting Web Calendar View


Notice that the URL in the web address,

8080/KinCal/calendar?CalendarName=sql&ForDate=200905&View=month  represents the resulting web calendar view.  From here, a user can add specific parameters and directly access different calendar views and specific dates. 


Specifying a Calendar Name from Web Calendar

1.         Using the mouse, place the cursor at the end of the URL in the web address window.

2.         Carefully backspace to clear data (if necessary) and place the cursor to the right of KinCal/calendar?CalendarName=, leaving the beginning of the URL intact.  

3.         Type-in the “Web Name” (shown on the Calendar Manager Console) which represents the calendar you want to view. 

Examples: KinCal/calendar?CalendarName=sql or KinCal/calendar?CalendarName=oracle

4.         Press Enter.  The new calendar view appears.  


Figure 39: Changing to a different calendar

Requesting a Specific Date View From the URL

In addition to clicking or using the toggle elements to switch dates, a user can request a specific date directly from the URL window. 

1.         Using the mouse, click the cursor in the URL and place the cursor at the end of the designated calendar name. 

2.         Using the example below, type-in “&ForDate”, plus the date you want to view. 

Example: &ForDate=200702

This will display the calendar for February, 2007.

3.         Press Enter.  Depending on whether you were previously logged in or not, a login screen may appear. 


Figure 40: Login Screen

4.         Type in login information. 

5.         Click Submit.  The requested calendar date appears. 



Requesting a Specific Calendar View From the URL

In addition to clicking the Day, Week, Month, and List calendar view links to switch calendar views, a user can request a specific calendar view directly from the URL window. 

1.         Using the mouse, click the cursor in the URL and place the cursor at the end of the designated calendar name. 

2.         Using the example below, type-in “&View”, plus the calendar view you want to see (day, week, month, or list). 

Example: &View=week

This will display the calendar in the week view.

3.         Press Enter.  Depending on whether you were previously logged in or not, a login screen may appear. 


Setting Custom Calendar Title from the URL

If you want to set a custom title for your calendar, it is easily accomplished by adding a parameter to the URL.

1.         Using the mouse, click the cursor in the URL and place the cursor at the end of the designated calendar name.

2.         Using the example below, type-in “&CalendarTitle=”, plus the calendar title you want to see. 

Example: &CalendarTitle=MyCalendarTitle

This will display MyCalendarTitle as the new title of the calendar.

3.         Press Enter.  Depending on whether you were previously logged in or not, a login screen may appear. 


Using Parameters from Your Qualification

If you are using parameters in your Event Type qualifications, they will need to be added into the URL. You can do this by hand in a URL, or with a custom webpage that constructs the URL using a scripting language like javascript.



 ‘serverName LIKE “%

UndefinedNameError: reference to undefined name 'server' (click for details)
    at (Kinetic_Calendar/Documentation/Version_1.5.0/User_Manual), /content/body/div[2]/div[19]/div[8]/div/p[2]/strong/span, line 1, column 1
in the qualification of the Event Type.

Then &server=RemedyProd1 added to the URL will substitute RemedyProd1 into the qualification when the Calendar is displayed.





Viewing “My Calendars” From Web Calendar

Accessed from Web Calendar, the “My Calendars” function offers users quick access to all (permission-based) calendars to view or change in the same manner described above.  In this way a user can efficiently check and recheck, hide or show, all of their calendars, simultaneously. 

To view My Calendars, click in the upper right portion of the screen, as shown in Figure 41: Click on “My Calendars”. 



Figure 41: Click on “My Calendars”



In the example below, My Calendars (in this case, Demo) appears. 


File:Documentation/Kinetic_Calendar/KineticCalendar_UserManual/image059.pngNote:  In the lower, left side panel a color-coded indicator of all calendars in which the current user (logged in as “Demo”) has permission to access. 



Figure 42: “My Calendars” for User – Demo



Note that all day events show up in colored blocks, while events with “time” durations show up in a font color that matches the Calendar to which it is connected.  See illustration in Figure 42: “My Calendars” for User – Demo, above. 


This option makes it easy for one user to see how their (permission-based) calendars overlap, viewed from one image.  Kinetic Calendar also offers the option to view just one or two calendars at a time, if you prefer.  This is accomplished by clicking and un-clicking on the checkbox next to the calendar you wish to show on the Web Calendar. 



Figure 43: All Calendars Available to “My Calendar” for user: Demo


Calendar List – Public and Private Calendars

Once you are logged in to the web console, if you click on the words Kinetic Calendar on the top left, you will get a list of the Calendars you can access.



Figure 44: Calendar List

Date Specific Calendar Requests

While no parameters are required, adding a “&ForDate” parameter in the URL can assist a user in specifying an exact date of My Calendar in the same manner as described above in: Requesting a Specific Date View From the URL. 

1.         Using the mouse, place the cursor at the end of the URL in the web address window.

2.         Carefully backspace to place cursor to the right of CalendarName=

3.         Add (type) “mycalendar”. 

Example: CalendarName=mycalendar


Example: CalendarName=mycalendar&ForDate=200703

4.         Press Enter.  Your “My Calendars” view appears. 


Figure 45: My Calendar

Understanding/Using Web Calendar View

Located at the top center of the web calendar screen, a calendar name is shown.  It changes to reflect whatever calendar is currently being viewed. 










Figure 46: Different Calendars – Different NamesFigure

In addition to specifying a date in the URL field, a user can toggle or click back and forth within a calendar, using the three designated areas as shown in the following figure (indicated by two small arrows and two circles). 


Figure 47: Toggle or Click to Different Dates

Modifying an Event

If a user is authenticated (has permission) to create events, they see the “Add Event” hyperlink located at the top-left of the calendar.



User as a viewer without permissions (non-authenticated). 








Figure 48: Add Event for Authenticated

File:Documentation/Kinetic_Calendar/KineticCalendar_UserManual/image084.pngFile:Documentation/Kinetic_Calendar/KineticCalendar_UserManual/image085.jpgBy clicking the Add Event link, a dialog screen appears giving users the ability to create events on calendars.



Start and end time drop-down menus will not work properly unless a.m. and p.m. are in a logical sequence.


important reminder:


Figure 49: Web Calendar “Add Event” Dialog Screen

Adding An Event from Web Calendar

Adding an event can be accomplished by clicking in the header of the day and the Add Event Dialog screen will appear, or by clicking on the Add Event link in the upper left corner. 



Note:  In a Day or Week View, all-day events appear in the top header.  Time events appear in the calendar, at the noted time. 


Only those event types a user has permission to create or modify will be displayed.

Click the Add Event link. 

2.         From the drop-down menu under Calendar, select a calendar. 

3.         From the drop-down menu under Event Type, select a type. 

Important Note:  “Event Types” are defined when a calendar is created in the Calendar Manager Console screen.  Once an event is created the “Event Type” or its originally associated calendar, cannot be changed. (SeeImportant Note in the sidebar on the following page.) 

4.         Type in a description of the event in the box under Description

5.         If applicable, add a URL address.  (tip: It is a good idea to click GO, to test if the URL works properly.)

6.         Type in a Beginning date to an Ending date.

7.         Check box to left of All Day Event, if applicable. 

8.         If it is not an all day event, type in a Start time and an End time. 

9.         When finished, click Save.  Click Cancel to exit and not save any entered data. 

Changing Event Descriptions and Times from Web Calendar

The Web Calendar monthly view designates All Day Events as a solid colored bar.  Translucent colored bars and a stated time, designate a time-based event (color-coded to match the affiliate calendar) shown below in light taupe and a matching burgundy colored font. 


You cannot change the event type for an event. 

If an event was created for the wrong event type, the event should be deleted, and a new event created with the correct event type.


important note:


Figure 50: Example - Events on a Web Calendar

Event Types” are defined when a calendar is created in the Calendar Manager Console screen.   See Error! Reference source not found..  However, Event Descriptions and Times can be changed easily through a simple dialog.

IMPORTANT NOTE:  Once an event is created, neither the “Event Type” nor the calendar with which it was originally associated can be changed. 

1.         From the Web Calendar place the cursor on the event bar you want to change and left mouse click.  The dialog screen appears.  (In the example below see the all-day event from July 3rd through 6th.) 

Rectangular Callout: Event Type cannot be changed.  File:Documentation/Kinetic_Calendar/KineticCalendar_UserManual/image093.jpgFile:Documentation/Kinetic_Calendar/KineticCalendar_UserManual/image094.jpg

Figure 51: Description and Time Change Dialog

2.         To change the event description, place the cursor inside the window below Description

3.         Type-in a new description. 

4.         To change the date, place cursor inside the window below Date

5.         Type in a new begin and end date. 

Or, if applicable, click in the box to the left of All Day Event

6.         To change the time, use the drop-down menus to select the correct start and end times. 

7.         When finished, click Save.  Click Cancel to exit and not save any entered data. 

Deleting an Event from Web Calendar

While it is a simple procedure to get rid of an event, it is important to note that deleting or changing an event from Web Calendar will be audited on the Remedy side of the software.  See View More Detail on Audit Changes. 


Figure 52:  Calendar Audits

1.         From the Web Calendar place the cursor on the event to be deleted and perform a left mouse click.  The event dialog screen appears.




Figure 53: Deleting Events Example

2.         Click Delete Event


Figure 54: Delete Event Confirmation


3.         Click the OK button to delete the event, or the Cancel button. 

...And Finally


We at Kinetic Data hope you have found this application allows for a simple approach to creating calendars and schedules whether used for your personal time management or for your entire organization. 

Our goal in creating this software is to help you and your company schedule, plan, coordinate and collaborate easily. 

If the Enterprise or Demo (versus Lite) edition was purchased and you need assistance, please call 651-695-8566, or contact us at, and thank you for purchasing Kinetic Calendar