Bundle Base Directory
The Bundle has five top level directories
Bundle Directory Organization
Packages Inside Bundle
A Bundle will always contain a package directory where packages are stored. Each package is a group of files for a specific functionality. These packages each have a .jsp file inside that is the display page for the package. The following package is included:
Each bundle is housed in a git repository and has instructions on it's particular setup. The bundle in this training is the Responsive bundle and is located at the following git repository. Follow the instructions on the main page of the git repository.
Basic Download from github
- Navigate to the Responsive git repository
- Click on the "Clone or Download" button and choose the "Download Zip" link
- Save the zip file to your computer and unzip.
- Locate your kinetic themes directory on your web server (.../apache-tomcat-X.X.XX-sr/webapps/kinetic/themes). If your kinetic directory does not contain a themes directory, create one now.
- Copy or move the request-bundle-responsive folder to the themes directory. You can rename the request-bundle-responsive or leave as is.
In order to start viewing the portal pages in the Bundle, we must first create a catalog in Kinetic Request with the required service items for the catalog to run. We will use KURL to setup the catalog and basic portal page service items for the Bundle.
Request Configuration - Setup KURL to point to your Kinetic Request web server
- Download the latest version of KURL.
- Add the KURL jar to the Setup directory of the downloaded Bundle and rename it to kurl.jar
- Open a command prompt or terminal and navigate to the setup directory.
- Run the setup command, which can be found here.
- Verify that KURL is configured to your server using list catalogs.
Request Configuration - Setup KURL catalog configuration files
- Navigate to setup/kurl/
- Open the config.rb file in a text editor
- Edit the “CATALOG_NAME” variable with the name you want to call your catalog. Use dashes or underscores instead of spaces.
- Edit the “THEMES_BASE” with the path to the bundle directory. The path starts from the kinetic directory (e.g. /themes/request-bundle-responsive)
- Edit the "DISPLAY_NAME_FOR_URL" with the name of your catalog or with a user friendly unique name. This is used in the url to identify pages for your catalog.
- Using Kurl and a command line, execute the following kurl command to start your catalog import by replacing the text, "path-to-kurl-catalog-directory", with the path (from your kurl directory) to your catalog kurl files:
java -jar kurl.jar -action=build_catalog -directory=path-to-kurl-catalog-directory
Tip: If you are executing the kurl.jar from bundle/setup, your path to the kurl directory is kurl/.
When the import is complete, verify that the catalog is visible in the Kinetic authoring tool and the following service items are imported:
- Catalog (home page to browse catalog)
- Service Item Example with Person Lookup
- Site Feedback
Request Configuration - Catalog Attributes
Once you have verified that the catalog is installed and complete, you will need to configure catalog attributes to connect the bundle to the catalog. Add the following attributes to the catalog (it is suggested to use the same values as used in the last section):
Note: If these catalog attributes are not available you will need to add them to your catalog by following the instructions on community and and using the KS_RQT_ServiceCatalog_base for "Parent Form".
- slug (set to the same value as DISPLAY_NAME_FOR_URL with a delimeter such as a dash or underscore - e.g. ACME-)
- catalogName (set to the name of your catalog)
- companyName (set to your company name as you want displayed on the portal)
Bundle Dry Run
After your Bundle is configured, it's time to take it for a spin.
There are two methods to opening your catalog.
- Using the url:
- Navigating from inside Kinetic Request
- 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.