Automate Administration with KURL Shayne Koestler

3 Introduction

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 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 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 KURL on Community

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

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 Uses for KURL

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 

12 Hello World  Ruby file  Command prompt

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

14 Ruby 

15 JRuby 

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

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 Template Service Item

19 Template Service Item

20 Template Service Item

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 KURL Templates

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

24 Using KURL Templates

25 Using KURL Templates

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

27 Ruby Variables

28 Ruby Variables  Added variables to our templates file

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

30 Version Control Sample

31 Questions?

32 Resources  KURL on Kinetic Community   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 