Project Sheet

Essbase Tool Configuration

Complete reference for all 9 Essbase operation types in InTouch

The Essbase Tool provides 9 comprehensive operation types covering every aspect of Oracle Essbase automation. Each tool below lists all configurable parameters.

1. Calculation Tool

Execute Essbase calculation scripts with dynamic parameter substitution. Run existing server-side calc scripts or define inline calculations.

ParameterDescriptionRequired
ConnectionEssbase connection object (encrypted credentials)Yes
ApplicationEssbase application nameYes
DatabaseEssbase database (cube) nameYes
Calc ScriptCalculation script name on server or inline scriptYes
Script ParametersDynamic substitution variable valuesNo

2. Dimension Build Tool

Build or update Essbase dimensions from file or SQL data sources. Update hierarchies, add members, and restructure outlines automatically.

ParameterDescriptionRequired
ConnectionEssbase connection objectYes
ApplicationEssbase application nameYes
DatabaseEssbase database nameYes
Rules FileDimension build rules file on the Essbase serverYes
Data SourceFile path or SQL connection for source dataYes
Source TypeFile or SQLYes

3. Load Data Tool

Load data into Essbase from files or SQL sources. Supports BSO and ASO storage types with options to clear data before loading.

ParameterDescriptionRequired
ConnectionEssbase connection objectYes
ApplicationEssbase application nameYes
DatabaseEssbase database nameYes
Rules FileLoad rules file (optional for free-form loads)No
Data SourceFile path or SQL connection for source dataYes
Source TypeFile or SQLYes
Clear OptionNone, All Data, or Specific RegionNo
Clear RegionMDX or calc expression defining the region to clearNo
Delete AggregatesRemove aggregated data before loadingNo
Storage TypeBSO or ASO specific loading optionsNo

4. Export Data Tool

Export data from Essbase cubes at various levels of detail. Choose between all data, zero-level (leaf), or input-level exports.

ParameterDescriptionRequired
ConnectionEssbase connection objectYes
ApplicationEssbase application nameYes
DatabaseEssbase database nameYes
Export LevelAll, Zero-Level, or Input-LevelYes
Output FileDestination file path for exported dataYes
Columnar OutputExport in columnar (spreadsheet-like) formatNo (default: no)

5. Report Tool

Execute Essbase report scripts to generate formatted output. Supports dynamic parameter substitution for flexible reporting.

ParameterDescriptionRequired
ConnectionEssbase connection objectYes
ApplicationEssbase application nameYes
DatabaseEssbase database nameYes
Report ScriptReport script name on server or inline scriptYes
Script ParametersDynamic substitution values for the reportNo
Output FileDestination file for report outputYes

6. MaxL Tool

Execute MaxL administration statements against Essbase. InTouch handles login and logout automatically so you can focus on the commands.

ParameterDescriptionRequired
ConnectionEssbase connection objectYes
MaxL StatementMaxL command(s) to executeYes
Auto LoginAutomatically handle login/logout session managementNo (default: yes)

7. Start Application Tool

Start an Essbase application and optionally enable user access. Use in workflows to bring applications online before data loads or calculations.

ParameterDescriptionRequired
ConnectionEssbase connection objectYes
ApplicationEssbase application name to startYes
Enable AccessEnable user access after application startsNo (default: yes)

8. Stop Application Tool

Gracefully stop an Essbase application. Typically used before backup operations or maintenance windows.

ParameterDescriptionRequired
ConnectionEssbase connection objectYes
ApplicationEssbase application name to stopYes
Disable AccessDisable user access before stoppingNo (default: yes)

9. Update Variables Tool

Update Essbase substitution variables programmatically. Automate period rolls, scenario changes, and other variable updates that drive calculations and reports.

ParameterDescriptionRequired
ConnectionEssbase connection objectYes
ApplicationEssbase application nameYes
VariablesList of variable name/value pairs to setYes
ScopeApplication-level or database-level variable scopeNo (default: application)

Common Configuration

Connection Objects

All Essbase tools reference a centralized connection object storing encrypted credentials and server details. Role-based access control determines which users can use each connection.

Error Handling

Every operation captures Essbase error codes and messages. Automatic notifications on failure with detailed logs for troubleshooting.

Mutual Exclusion

Intelligent mutual exclusion prevents conflicting operations. Backups wait for running calculations to complete. Data loads respect application locks.

Continuous Operation

"Chase its tail" mode triggers the next execution immediately when the current one completes — enabling continuous 24/7/365 data processing workflows.

Learn More About the Essbase Tool

View Essbase Tool Product Page