Embedding: Javascript API Reference

To use the JavaScript API object specified below, be sure to specify the URL to the JavaScript API file in your web page. For more information, see Embedding with Javascript API or code samples. The JavaScript API file is a library that contains functions for interacting with the JavaScript API. It's a minified file and production-ready to be downloaded by the browser.

This section defines the available options for configuring the Knowi Javascript Class. 

This section defines the available options for configuring the view object from the Knowi class.

menuOptions: {
    logo: true,
    dashboards: true,
    widgets: false,
    queries: true,
    alerts: false,
    reports: false,
    more: false,
    help: false,
    profile: false,
    ml: false,
    agent: true,
    opsdash: false,
    dashSettings: true,
    nlpPrompt:true
}

function onWidget(widget) {
 alert(Widget created with id:" + widget.id + " name:" + widget.name);)
}
Knowi.render('#knowi-div', {
type: 'nlp',
token: "ADD KNOWI SESSION TOKEN HERE",
url: 'http://localhost:9090',
view: {
 nlpOptions: {
  icon: "on",
  css: {
      background: 'transparent',
      width: '80%'
},
placeholder: "Ask a question...",
help: "on",
helpText: "Ability to customize the help text of the question mark",
createWidget: 'onWidget'
}
}
}, function () {
});}

Menu Options

The menu options available are:

• logo - Enables displaying the logo on the dashboard by setting it to true
• dashboards - Enables dashboards by setting them to true
• widgets - Enables widgets on setting it to true
• queries - Enables queries on setting it to true
• alerts - Enables alerts on setting it to true
• reports - Enables reports on setting it to true
• more - Enables the more button on setting it to true
• help - Enables the help option on setting it to be true
• profile  - Enables setting up and maintaining profiles by setting them to true
• ml  - Enables ML on setting it to true
• agent - Enables agent to set it to true
• opsdash - Enables ops dashboards by setting it to true
• dashSettings - Enable or disable the settings icon on the dashboard
• nlpPrompt - Enable or disable the NLP prompt on the dashboard

CSS Customization

You own custom CSS can be injected into the API. Simply specify a comma-separated list of CSS files and their full path during the initialization.

Knowi.render('#cloud9charts', {
    type: 'touchdown',
    username: 'name',
    password: 'pass',
    view: {
      title: true,
      css: ['https://rawgit.com/AntonLapshin/csharp/master/custom1.css', 'https://rawgit.com/AntonLapshin/csharp/master/custom2.css']
    },
}, function() {
    alert("Loaded")
});

See sample JSFiddle.

Filters

To pass in filters:

    Knowi.render('#cloud9charts', {
       type: 'share',
       dashboard: 'CnzzWr6ZGrii4BYsa295HoVWzNB7VaZey6StgO1uFw2kie'
       view: {
         title: true,
         contentFilters: [
            {
               "fieldName":
               "opened",
               "values":[1000],
               "operator":">"
            },
            {
                "fieldName":"message_type",
                "values":["marketing"],
                "operator":"="
            }
         ]
       },
    }, function() {
       alert("Loaded")
    });

Note: Secure URL modes require contentFilters to be encrypted.