Skip to main content
Pentaho Documentation

config

pentaho.config

The config namespace contains the types of the Pentaho Configuration API.

Overview

The Configuration API provides a means for types to be configured by third-parties.

Types are known by their string identifier and are, for all other purposes, opaque entities — these may or may not exist as actual classes; these may simply represent an interface type.

Configurations are JavaScript objects that conform to the IRuleSet interface — essentially, a set of configuration rules, IRule. Typically, configurations are provided as the value returned by an AMD/RequireJS module. This module needs to be advertised to the configuration system by registering it with pentaho/service, as a service of type pentaho.config.spec.IRuleSet.

Configuration rules specify the type and the values of any Pentaho environmental variables to which they apply, as well as the actual configuration properties that should be applied.

Configurations can be obtained (and also registered) through the config.IService interface.

The Pentaho Platform's main configuration service instance can be obtained by getting the service of id pentaho.config.IService, i.e., by requiring the AMD/RequireJS module pentaho/service!pentaho.config.IService?single. Example:

require([
  "pentaho/service!pentaho.config.IService?single"
], function(configService) {

  // Get the configuration for 'my.IFoo' components,
  // under the main Pentaho environment:
  var config = configService.select("my.IFoo");
  if(config) {
    // ...
  }
});

Source: doc-js/pentaho/config/_namespace.jsdoc, line 17

Child Namespaces

Name Summary
spec

The specifications sub-namespace of the pentaho.config namespace.

Interfaces

Name Summary
IService

The config.IService interface describes a service that manages configurations, usually of types.