2. Don't run late! Get Calendar and Schedule up and running 'on-time' in 'no-time'.
Let’s get it done fast

3. Agenda Installing and Configuring Creating Calendars
Calendar and Schedule
Creating Calendars
Configuring Parameters
Branding
Click handlers

4. Resources
Download package for “CalendarSchedule Training support files.zip” from:
Training Support File
Expand zip file
These files are already configured for the training
We will install
Kinetic Calendar v2.0.4
Kinetic Schedule v1.2

5. Our environment
Calendar and Schedule are already installed on the matrix VM.
Directory structure on matrix

6. Preparing for Calendar/Schedule Installation
We will uninstall first.
Log into matrix with kin/kinetic
Stop kineticTomcat with command
sudo service tomcatKinetic stop
Password is kinetic
Delete kineticCalendar and kineticSchedule directories
Delete work directories of previous installation.

7. Preparing for Calendar/Schedule Installation
Refer to rsion_2.0/08_Installation
netic_Schedule_1.2/Installation
Copy war files into tomcat/webapps directory
Copy from downloadedKEGfiles/Calendar
Copy from downloadedKEGfiles/Schedule

8. Preparing for Calendar Installation
Copy files for training
Copy downloadedKEGFiles\Calendar\WEB-INF\lib\* into kineticCalendar\WEB-INF\lib
Start tomcatKinetic service
Sudo service tomcatKinetic start
Password is kinetic

9. Preparing for Calendar Installation
Activity 1
Complete actions on slides 6,7,8

10. Configuring Kinetic Calendar
Run URL
Login with admin/admin
By default the installation will come with some configurations
These will show errors in the console, which we will ignore because we are going to provide a new configuration directory
Click on the Properties tab and configure the values based on the package file provide:
downloadedKEGFiles\Calendar\property.txt

11. Configuring Kinetic Calendar
Calendar has now been installed and configured with predefined Calendars

12. Configuring Kinetic Calendar
Activity 2
Complete actions on slides 10, 11

13. Configuring Kinetic Schedule
Kinetic Schedule does not have an AdminConsole
Schedule will now already be installed, but will need configuration.
Copy files downloadKEGfiles\Schedule\properties.xml and license.txt
The properties files will reference the predefined configurations directory for the session.
Restart tomcatKinetic
sudo service tomcatKinetic restart

14. Configuring Kinetic Schedule
Run URL

15. Configuring Kinetic Schedule
Activity 3
Complete actions on slides 13, 14

16. Creating Calendars - Kinetic Calendar
All information can be found on: rsion_2.0
Let’s focus on example calendars that have already been configured.
Asset Information
Oracle Adapter
Firstly Adapters
An adapter is code that is able to communicate to the targeted system.
Each adapter must be installed and configured for the environment.
We are using two examples, Kinetic Matrix a BMC connection to the Matrix, and the Oracle Adapter connecting to the underlying Oracle Database.

17. Creating Calendars - Kinetic Calendar
Adapters are installed as java code either as classes or within jar files.
Each adapater type will have it own code. The adapter class will be registered in the adapters.json.
Eg. /home/kin/apps/configuration/KineticCalendar
BMC Adapter & Oracle Adapter

18. Creating Calendars - Kinetic Calendar
Connections use an adapter
Each Calendar event will refer to a connection
Credentials used in the connection must have valid permission to the targeted data source.

19. Creating Calendars - Kinetic Calendar
The definition of the Calendar itself must be configured as set of json files
These must be located in the configuration directory
Each Calendar will have its own directory
A calendar.json file defines the Calendar
One or more et_XXX.json files define the event types that can be viewed within a Calendar

20. Creating Calendars - Kinetic Calendar
calendar.json

21. Creating Calendars – Kinetic Calendar
et_events.json
connectionName
Indicates configured connection
configuration
Identifies remedy form and qualification
coreMappings
Identifies fields that are used to for specific event
detailMappings
Any fields that you wish to display when a user clicks an event
filterMappings
Fields and values that a user can filter in/out events

22. Creating Calendars - Kinetic Calendar
Let’s have a look at the calendar in action.
Load URL
Click Asset Information

23. Creating Calendars - Kinetic Calendar
Oracle Adapter sample

24. Creating Calendars - Kinetic Calendar
Oracle Adapter et_events.json
All configuration is similar to previous example, except the configuration values are specific for this type of adapter.
Configuration
“Events Query” SQL for events
“Event Query” SQL for specific event details

25. Creating Calendars - Kinetic Calendar
Let’s have a look at the Oracle Adapter example.
Load URL
Click Oracle Adapter

26. Creating Calendars - Kinetic Calendar
Activity 4
Complete actions on slides 22, 25
Nothing to do except run the URLs

27. Creating Calendars – Kinetic Schedule
All information can be found on: netic_Schedule_1.2/Installation
Let’s focus on an example calendar that has already been configured.
Tech Schedule
Adapters
Like Kinetic Calendar, Kinetic Schedule follows the same design architecture
So an adapter is the same concept

28. Creating Calendars – Kinetic Schedule
Adapters are configured in the adapters file

29. Creating Calendars – Kinetic Schedule
Connections are stored in the files but do not have an Admin Console like Calendar yet. Instead the details must be maintained in the files directly.

30. Creating Calendars - Kinetic Schedule
The definition of the Calendar itself must be configured as a set of json files
These must be located in the configuration directory
Each Calendar will have its own directory
A cal_XXX.json file defines the Calendar
A res_XXX.json file defines the Resource
A ds_XXX.json file defines the Events
XXX must be the same name as the directory these files are in

31. Creating Calendars - Kinetic Schedule
cal_techschedule.json

32. Creating Calendars - Kinetic Schedule
res_techschedule.json
Identifies the resources such as people
Source
Name of the form
sourceMapKey
Field id for key
SourceMapCriteria
Qualification for query

33. Creating Calendars - Kinetic Schedule
ds_techschedule.json
Defines the events related to defined resources
Source
Name of the form
sourceMapKey
Field id for key
SourceMapCriteria
Qualification for query

34. Creating Calendars - Kinetic Schedule
Let’s have a look at the calendar in action.
Load URL
Click Tech Schedule

35. Creating Calendars - Kinetic Schedule
Click in an empty slot to schedule a resource to a time.
This will launch a Kinetic Request page, to enter details.
When completed, refresh the calendar to view the scheduled event.

36. Creating Calendars - Kinetic Schedule
There may be a slight delay in processing the Schedule event request

37. Creating Calendars - Kinetic Schedule
Activity 5
Complete actions on slides 35, 36, 37
Nothing to do except play with the calendar

38. Calendar - Passing Parameters
A calendar can be displayed by applying various parameters, in this example we are focusing on a parameter that controls the events query.
Refer to /Version_2.0/12_Adapters/BMC_Remedy_ARS_Adapter
I have pre-configured a copy of the asset_information calendar called asset_information_byowner

39. Calendar - Passing Parameters
A qualification can then be defined to expect a value as a parameter and entered as part of the qualification definition.

40. Calendar - Passing Parameters
Let’s run the calendar using the following URL
on_byowner&parameter[group]=Admin
Try changing the group value to other values
Admin
Network
Desktop

41. Calendar - Passing Parameters
Activity 6
Complete actions on slides 40
Nothing to do except run the calendar and inspect the files

42. Schedule - Passing Parameters
Like Kinetic Calendar, Schedule also allows a calendar to be loaded based on parameters being passed in the URL
I have pre-configured a copy of the techschedule calendar called techschedule_bycity

43. Schedule - Passing Parameters
Parameters can be applied to the Resource data and the Event data
The parameter is encased in the {{}} chars and applied to the qualification
File res_techschedule_bycity.json

44. Schedule - Passing Parameters
Let’s run the URL
ch_schedule_bycity&city=St.%20Paul

45. Schedule - Passing Parameters
Activity 7
Complete actions on slides 44
Nothing to do except run calendar and expect files

46. Calendar Branding
Kinetic Calendar can be branded to adopt your color themes and include your logo. A calendar may also be displayed in another language.
This is accomplished by applying a custom theme, which can be easily based on the supplied default theme.
A pre-defined example has been created called asset_information_fr
This will show some customizations and also show the calendar in French

47. Calendar Branding
Copy the directory downloadKEGfiles\Calendar\themes\french To
/home/kin/apps/tomcatKinetic/webapps/kineticCalendar/themes

48. Calendar Branding Most visual aspects of Calendar can be configured
Too many parts to go through now
I have focused on changing the logo and banner area, to emulate your company branding being applied.
Load URL

49. Calendar Branding Within the new theme directory
Applying the language pack
Refer to the language pack required in file calendar.jsp
Change logo
Set the preferred logo file in file interface/fragments/contentHeader.jspf

50. Calendar Branding Change the header banner color and size
Alter styles in file resources/css/themes.css

51. Calendar Branding Activity 8 Complete actions on slides 48, 49
Inspect files and change values to experiment

52. Schedule Branding
Kinetic Schedule can also be branded to adopt your color themes and include your logo. A calendar may also be displayed in another language.
This is accomplished by applying a custom theme, which can be easily based on the supplied default theme.
A pre-defined example has been created called tech_schedule_de
This will show some customizations and also show the calendar in Danish

53. Schedule Branding
Copy the directory downloadKEGfiles\Schedule\themes\danish To
/home/kin/apps/tomcatKinetic/webapps/kineticSchedule/themes

54. Schedule Branding Most visual aspects of Schedule can be configured
Too many parts to go through now
I have focused on changing the logo and banner area, to emulate your company branding being applied.
Load URL chedule_de

55. Schedule Branding Within the calendar file cal_techschedule_de.json
Refer to the new theme
This tells the calendar to load the correct themed version

56. Schedule Branding Within the new theme directory
Applying the language pack
In file jsp/main_de.jsp
Change logo
Set the preferred logo file in file jsp/viewfragments/_headerBanner.jspf

57. Schedule Branding Activity 9 Complete actions on slides 53, 54
Inspect files and change values to experiment

58. Calendar Click Handlers
Click Handler definition allow you to extend functionality for users of the calendars.
Refer to documentation
_2.0/10_Configuration/20_Configuration_Files/Click_Handlers
There 2 types of handlers, URL and Javascript
We will focus on a javascript example

59. Calendar Click Handlers
Using a clickHandler, the default behavior can be overridden to whatever solution makes sense.
Copy the contents of the file
downloadKEGfiles\Calendar\javascript\event_dump.txt to
/home/kin/apps/configuration/KineticCalendar/calendars/asset_information/et_ events.json
This calls a predefined function within the themes theme.js

60. Calendar Click Handlers
Load URL for the AdminConsole
Click the Reload Configuration button
Now run the URL on

61. Calendar Click Handlers
Click on any event, and a dialog identifying the content of an event will display.

62. Calendar Click Handlers
Activity 10
Complete actions on slides 59, 60

63. Schedule Click Handlers
Refer to documentation
_Schedule_1.2/Configuration/Click_Handlers
The techSchedule calendar already has a URL clickHandler defined

64. Schedule Click Handlers
Let’s configure a click handler against the resources for the techSchedule calendar.
Copy the js directory
downloadKEGfiles/Schedule/clickHandler/js To
/home/kin/apps/tomcatKinetic/webapps/kineticSchedule/themes/default
This file contains a javascript file with a function called test

65. Schedule Click Handlers
Copy file
downloadKEGfiles/Schedule/clickHandler/_main.jspf To
/home/kin/apps/tomcatKinetic/webapps/kineticSchedule/themes/default/jsp/Fragme nts
This changes includes the custom.js file in the calendar

66. Schedule Click Handlers
Copy file
downloadKEGfiles/Schedule/clickHandler/res_techschedule.json To
/home/kin/apps/configuration/KineticSchedule/calendars/techschedule
This change includes the definition of the clickHandler

67. Schedule Click Handlers
Load the URL
chedule
Click on a resource

68. Schedule Click Handlers
Activity 11
Complete actions on slides 64, 65, 66, 67

69. Q & A