1. Working Out with KURL! Shayne Koestler Kinetic Data

2. 2 2 Questions Welcome

3. 3 3 KURL

4. 4 4  Kinetic Uniform Request Language  KURL is a domain-specific language (DSL) written in Ruby  DSL Example  =MIN(A2:A7)  DSL Definition  A language designed to solve a specific set of problems  KURL is designed to define service items in Kinetic Request

5. 5 5 KURL Uses  Additional form of development  Text editing rather than point and click  One big save opposed to many small saves  Acts as an export format  Human readable  Easy to keep under version control

6. 6 6 KURL Uses  Automate Service Item Development  KURL code is a serialized format for service items  Service items can be exported into the format  Data from external sources can be converted into this format

7. 7 7 KURL DSL  Set of functions that model Kinetic Request service items  page – defines a page element  event – defines a javascript event  A few more  Functions are made available in specific contexts  question within page  choice within question

8. 8 8 KURL DSL  KURL Guide  On Kinetic Community  Provides a complete list of functions available  Details all options for these functions  Details which functions are available in which contexts

9. 9 9 KURL Files  kurl.jar  Builds service items from KURL code  Retrieves KURL code for service items  YAML config file  Often named config.yml  Configures connection to Remedy server  Can be generated automatically by kurl.jar

10. 10 KURL Files  Library files  Required to make API calls to Remedy .dll (Windows) or.so (Linux)  KURL code files  Contain the KURL code of a service item .rb file extension (Ruby)

11. 11 kurl.jar  Help  Displays usage details of the kurl.jar  Lists functionality provided by the kurl.jar

12. 12 kurl.jar  Version  Lists the version of the kurl.jar  New versions are released to accommodate new versions of Kinetic Request  The latest version is 2.1.1

13. 13 kurl.jar  Setup  Recommended method for configuration  Prompts for configuration values  Generates YAML configuration file  Named config.yml  In current directory

14. 14 kurl.jar  List Catalogs  Lists all catalogs in the Kinetic Request application

15. 15 kurl.jar  List Service Items  Requires a catalog name  Lists all service items in the given catalog

16. 16 kurl.jar  Retrieve Service Item  Requires  Catalog name  Service item name  Output directory  Generates the KURL code that defines the given service item  Saves KURL code to a Ruby file in the given directory

17. 17  Build Service Item  Requires  File name  Builds service item in Kinetic Request from KURL definition kurl.jar

18. 18  Retrieve Catalog  Requires  Catalog name  Output directory  Builds KURL code for each service item in catalog  Builds KURL code for catalog itself kurl.jar

19. 19  Build Catalog  Requires  Directory containing KURL definitions  Builds catalog and service items in Kinetic Request from KURL definitions kurl.jar

20. 20 Problem  Service catalog under development  Standards are well defined  New requirements daily  Additions to service items  New service items

21. 21 Solution  Automate development with KURL  Gather requirements in a spreadsheet  Use spreadsheet data to construct KURL code  Execute KURL code to build service items  Could run this for every new requirements document

22. 22 KURL Automation  General process  Create a service item that defines  Look and feel  Defaults for service item contents  Retrieve KURL code for the service item above  Divide KURL code into small, specific code templates  A piece of KURL code that defines part of the service item

23. 23 KURL Automation  Template Service Item

24. 24 KURL Automation  General process  Create an empty file to store KURL code  For each piece of input data  Append appropriate code template to the KURL code  Build service items with resulting KURL code

25. 25 Header Footer Text Question Date Question List Question Header Footer Text Question Date Question List Question KURL Automation InputOutput (KURL code) Header Footer Text Question List Question Header Footer Text Question Date Question List Question Date Question

26. 26 KURL Automation  HTML Parsing  We have  Form on a website  Catalog of services or products on a website  We want  Generate service items from the HTML data above

27. 27 KURL Automation  HTML Parsing  Solution  Ruby program that parses HTML as input and assembles KURL code  Execute KURL code to build service items

28. 28 KURL Automation  Catalog Provisioning  We have  Catalog template  Suite of pre-defined service items to choose from  We want  Service item that gathers requirements for a new catalog  Task process to automatically build the new catalog

29. 29 Catalog Provisioning  Components  Catalog template  Available service items  Catalog provisioning service item  2 task handlers  Create catalog  Clone service item

30. 30 KURL Automation  Spreadsheet Parsing  We have  Spreadsheet with service item requirements  Service item that defines standards  We want  Generate service items defined in the spreadsheet

31. 31 Spreadsheet Parsing  Components  Spreadsheet with requirements (saved as CSV file)  Adheres to a strict format  Script that parses CSV to generate KURL code  Contains KURL code templates

32. 32 Spreadsheet Parsing  Components

33. 33 Spreadsheet Parsing

34. 34 KURL Automation  Service Item Request  We have  Service item that defines standards  We want  Service item to gather requirements for a new service item  Task process that builds the requested service item

35. 35 Service Item Request  Components  Service item that gathers necessary requirements  Name  Questions  Task handler that assembles and executes KURL code  Contains the KURL code templates

36. 36 Service Item Request

37. 37 Service Item Request

38. 38 Questions?

39. 39 KURL Resources  Files and introduction http://community.kineticdata.com/60_KURL/Documentation/02_Get_Started http://community.kineticdata.com/60_KURL/Documentation/02_Get_Started  KURL guide http://community.kineticdata.com/60_KURL/Documentation/03_Guide http://community.kineticdata.com/60_KURL/Documentation/03_Guide  Help (support for KURL is handled through our support forums) http://support.kineticdata.com/viewforum.php?id=11 http://support.kineticdata.com/viewforum.php?id=11