Bundle Air Configuration
Download File | |
---|---|
Bundle | Air |
Agenda
- Bundle Basics
- Bundle Request Air
- Setup
- Bundle Configuration
- Request Configuration
- Request Service Item Configuration
- Custom Login Page Configuration
- Web Developer Tools
- Theming
- Questions
Bundle Basics
Bundle Base Directory
The Bundle has three top level directories
- common
- core
- packages
Bundle Directory Organization
- config
- framework
- interface
- resources
Packages Inside Bundle Air
A Bundle will always contain a package directory where packages are stored. Each package is usually serving a specific purpose. These packages each have a .jsp file inside that is the display page for the package. The following four packages are inside Bundle Air:
- Base
- Catalog
- Submissions
Setup
- Download the Bundle from github.
- Unzip the Bundle and rename it to air.
- Place the bundle under the themes directory on your web server (On the Matrix VM, this directory is found under: /home/kinetic/apps/kinetic_sr/webapps/kinetic/themes).
Request Configuration
In order to take advantage of the Bundle we just downloaded, we must create a catalog in Kinetic Request for our Bundle to communicate with. This catalog will include four very important service items with the type portal, which are merely placeholders for pointing to the display pages inside the packages we want to use for this bundle.
Request Configuration - Create Catalog
- Open your Remedy User Tool.
- Open Kinetic Request-Service Catalog inside the quick links navigation on your left.
- Select "New" inside the Service Catalog box in the upper right corner.
- Enter a name for you Catalog. Can by anything. I.E. XYZ.
- Enter a Description of Catalog. I.E. Bundle lesson Catalog.
- In the status drop down, select Active.
Request Configuration - Create Package Portal Service Items
The Bundle contains four important portal pages inside the catalog and submission packages that we need to point to inside of Request. These pages are catalog.jsp, search.jsp, submissions.jsp, submissionDetails.jsp.
- Select New inside the Service Items box on the upper left side.
- Inside the dialog, enter type Portal and give the service item a name relevant to the display page you wish to serve up. I.E. catalog, submission details.
- Repeat these steps for each of the four portal pages.
After you have four service items with type Portal, we need to setup which display page each one points to, the url-friendly name and authentication.
- Select a service item and select the Advanced tab.
- Enter the relevant display page name for the service item inside Display Page (JSP). It will look like this: /themes/air/packages/catalog/catalog.jsp
- Enter a url friendly name in the Display Name For URL section. This name must be unqiue. It's recommended this name is relevant to the catalog and display page name. I.E. ACME2-Catalog, ACME2-SubmissionDetails.
- Select the Audit tab.
- Check the Require Authentication box and select Authentication Type" as "Default.
- Save all of these modifications by selecting the Save button in the lower left side.
- Repeat
Bundle Configuration
Every Bundle comes with a common directory. The common directory contains resources that are made available accross multiple packages. These resources might include stylesheets, global configuration or fragments like the footer or header, which each package might use. There is a common configuration file (config.jspf) that must be setup to communicate with the catalog we will be creating.
- Open /air/common/config/config.jspf
- Edit bundle.setProperty("catalogName", "ACME2"); by changing ACME2 to the name of the catalog you just created.
Bundle Configuration - Dynamic Links
There are four portal pages you created inside Request. You gave each of these pages a url friendly name under the advance tab. You need to configure these dynamic links inside the Bundle's common/config because these links are dynamically used through the Bundle's navigation point to the portal pages.
- Edit bundle.setProperty("catalogUrl", bundle.applicationPath() + "DisplayPage?name=ACME2_Catalog"); by changing ACME2_Catalog to the url friendly name you used for the Portal service items inside Request.
- Repeat this step for all four of the service items.
Bundle Dry Run
After your Bundle is configured, it's time to take it for a spin.
- Navigate to your Remedy user tool and open Kinetic Request-Service Catalog Console if it's not already open.
- Select your recently created catalog under the Service Catalog drop down naviagtion which is located in the upper left side.
- Select type Portal under your Search Type drop down. This is great solution for filtering these service items.
- Select the Catalog service item you created under the Service Items list on your upper right side.
- Click the Open Anonymous link to the right of Service Item Details.
Your default web browser will open and ask you to login. Use Demo to login.
Request Service Item Configuration
We will implment a Request service item that uses the base package.
Custom Login Page Configuration
We will go over the necessary steps to implement the Bundle's themed login page.
Web Developer Tools
We will cover browser developer tools options that are available and try using Chrome's developer tools.
Theming
We will dicuss and use the common theme directory inside Air to change color and graphic information.
Models
We will discuss and go over the Bundle's core framework of models including implementation inside a package display page.