Skip to main content
Kinetic Community

Console and Administration

Overview

Configuration consoles for the Kapp

Kapp Setup

The primary console for Kapp configuration is Settings within the specific kapp.

Submission Labels are available here but must use fields that are available on every form in the Kapp.

Form Types

Form Types are used to add extra functionality to Kapp Forms. Most "regular " forms are a type of Service. Console and Approval are also common Form types. Using these is based on your bundle.

Categories

Categories allow you to group Forms together. You can do some personalizing of Categories with attributes or within the Bundle code. 

Categories can also have attributes. This makes it easy to add icons, a Sort Order, or other "extra" data for your bundle to use.

Once the Category is created add it to the Form on the Form|Categories console.

kinops Categories

kinops provides a visual option for defining categories. Navigate to the Admin|Services (or the specific kapp you want)|Configuration|Categories Tab and you can add categories here (but not add attributes). The kinops console does provide an option for nesting categories. Drag the category you want to be "below" another and a box appears for it to be placed.

I added Data Center in the Request CE console, and then moved it to be a child of the Information Technology category.

Webhooks

Webhooks are used to connect Request CE to outside applications. A webhook is called when a certain action is detected by Request CE. Below is an example of the submission of a request (probably the most common).

Type determines Events that are available.

Filter is used if there are exceptions to a webhook being called based on the Type and Event. If the Filter resolves to True the filter fires.

Filters are used extensively in kinops to determine when webhooks should fire. There are good examples in the Services kapp.

services_webhooks_request.png

Information is passed to the task engine through the webhook URL. The initial tree determines processing from there. 

In the training VMs, you can override this to have individual trees pre Form.

Here is a sample URL:

https://servername.com/kinetic-task/...attribute:Task Source Name')}/${kapp('slug')}%20%3E%20${form('slug')}/Submitted

This URL assumes you are submitting a Form, but that is a common submission.

You can track the webhooks by opening the Jobs console.

Select either All, Pending, or Failures to display. Then click on the Name to see details:

You can also edit and resend individual jobs from this console. Very handy for retrying submissions without having to submit.

 

Goals

Understand the placement and function of Kapp Setup, Categories, Form Types, and Webhooks.