2. Automate Administration with KURL Shayne Koestler

3. 3 Introduction

4. 4 KURL  Kinetic Uniform Request Language  KURL is a domain-specific language (DSL) written in Ruby  DSL?  A language designed to solve a specific set of problems  =MIN(A2:A7)  KURL creates catalogs and service items in Kinetic Request  Hides complexity of forms and relationships

5. 5 KURL History  Previous Names  Shayne-alyzer, Template Generator, Accelerator, etc.  Ruby source to JAR file  Klink to ars models to Remedy Pure Java API  More and more comprehensive

6. 6 KURL Components  KURL Code  Ruby code containing functions made available in KURL  service_item, page, event, etc.  KURL Jar  Commands executed in command prompt with the kurl.jar  build_catalog, retrieve_service_item, etc

7. 7 KURL on Community

8. 8 KURL Components Ruby (.rb) file kurl.jar Request Server API Calls Execute Ruby Print Ruby

9. 9 Uses for KURL  Import/Export format  Human readable  Suitable for version control  Automate service item development  Generate KURL code from other sources (csv, database, etc.)  Generate KURL code from a service item  Catalog provisioning (service providers)

10. 10 Uses for KURL

11. 11 Uses for KURL  Alternative method of service item development  Text editing rather than point-and-click  Reduced duplication  Leverage Ruby features to aid development  Version control  https://github.com/kineticdata/demo-acme

12. 12 Hello World  Ruby file  Command prompt

13. 13 About Ruby  Object oriented  Dynamic typing  Clean syntax  Powerful features  Designed for developer happiness  JRuby  Runs on Java platform

14. 14 Ruby  http://www.ruby-lang.org/

15. 15 JRuby  http://jruby.org/

16. 16 Development with KURL  Goals  Adaptable and maintainable  Simplicity  More efficient development  Track development

17. 17 Development with KURL  Generate a template service item  Look and feel  Common elements  Export template to KURL code  Break into reusable functions  Store reused values as ruby variables

18. 18 Template Service Item

19. 19 Template Service Item

20. 20 Template Service Item

21. 21 KURL Templates  A piece of KURL code wrapped in a function  Reducing duplication of common behavior  Further abstraction of KURL functions  Created 3 reusable code templates  Standard header – configuration items of service item  Standard content page – standard content at top of request  Standard footer – confirmation page

22. 22 KURL Templates

23. 23 KURL Templates  DSL on top of a DSL  The domain is your service items KURL Code Templates Remedy API

24. 24 Using KURL Templates

25. 25 Using KURL Templates

26. 26 Ruby Variables  Store commonly used values as variables  Refer to variables throughout KURL code  Examples  Company name  Web server URL

27. 27 Ruby Variables

28. 28 Ruby Variables  Added variables to our templates file

29. 29 More Ruby  Looping over KURL code  Generate data for portal development  Conditionals to generate dynamic content  Conditionally include templates

30. 30 Version Control Sample

31. 31 Questions?

32. 32 Resources  KURL on Kinetic Community  http://community.kineticdata.com/10_Kinetic_Request/KURL http://community.kineticdata.com/10_Kinetic_Request/KURL  Get Started – downloads and setup  KURL Functions – documents the Ruby code functions in KURL  JAR Commands – documents the commands of the KURL jar file  Demo Catalog  https://github.com/kineticdata/demo-acme