URL Click Handler

Overview

A URL click handler will open a browser to the configured URL, passing in all defined user parameters and values. An example configuration of a URL click handler is shown below:

"clickHandler": {
    "type": "url",
    "target": "_blank",
    "callback": "http://changes.kineticdata.com",
    "parameters": {
        "id": "{{id}}",
        "name": "{{name}}",
        "start": "{{startGMT}}",
        "end": "{{endGMT}}",
        "category": "{{filterFields['Category']}}"
    }
}

URL click handler properties:

Property NameRequired?Description
typeYesDefines the type of click handler so Kinetic Calendar knows how to process it. Must be "url" for URL click handlers.
callbackYesThe URL the browser window opens to.
targetNoDetermines where the browser window opens the URL:
_blank - opens the URL in a new window or tab. This is the default.
_self - opens the URL in the same frame as it was clicked.
_parent - opens the URL in the parent frame.
_top - opens the URL in the full body of the window.
* framename - opens the URL in the a named frame
parametersNoA list of query parameter names and values that should be appended to the URL. These query parameters provide additional event details to the target system. Parameter values can be hard-coded (static) strings, values from event properties, or a combination of both.

For a list of available Event properties that can be used in parameter values, please see Event Properties.

URL Query Parameters

Query parameters contain specific event information that is passed on to the target system. In the click handler code listing example above, the resulting URL will result in:

http://changes.kineticdata.com?id={{id}}&name={{name}}&start={{startGMT}}&end={endGMT}}&category={{filterFields['Category']}}

The special mustache notation (double braces) surrounding some of the parameter values indicates that these values should be substituted with real event data that corresponds to the provided property name.

After Kinetic Calendar parses and encodes all the properties, the URL contains very useful pieces of information that the target system can use. In the example, the URL becomes:

http://changes.kineticdata.com?id=CHG000000000278&name=Outage&start=2012-09-13T13%3A00%3A00&end=2012-09-13T15%3A00%3A00&category=Network&20Systems

Example of a mixed-content URL parameter that uses both event properties and static text:

"parameters": {
"summary": "{{name}} starts at {{start}}, ends at {{end}}"
}

In this example, the "summary" parameter is built up as a concatenation of the name, start, and end properties for the event, along with some static text to give the parameter value more of a human readable syntax.