Initializing help system before first use

Application Configuration

An Xpress Insight Python app is implemented as a Python class which contains: meta-data about the app, definition of the data model, as well as definition of the execution modes.

import xpressinsight as xi

@xi.AppConfig(name="My First Insight Python App", version=xi.AppVersion(0, 1, 2))
class MyApp(xi.AppBase):

    # Declare data model here.

    # Define execution modes here.

In the above example, the MyApp class represents the main Insight Python app. Any name may be chosen for the class, but it must extend xpressinsight.AppBase and must be decorated by xpressinsight.AppConfig. Additionally, there must be exactly one such class per app.

The xpressinsight.AppConfig decorator allows the user to specify meta-data about the app such as the name and version. The name and version will appear on the Xpress Insight home page for the app. The version follows the "Semantic Versioning" guidelines of specifying the major, minor, and patch versions as non-negative integers between 0 and 999. In the above example, the version of the app is 0.1.2.

Extending xpressinsight.AppBase provides the primary functionality to interact with the Insight server, for example reading and writing attachment files.

App Configuration Classes

xpressinsight.AppBase

The AppBase class.
Property for the application configuration object of the Insight app.
Initialize entities to their default values (empty string, 0, empty series or dataframe column, etc.).
Property for the application interface of the Insight app.

xpressinsight.AppConfig

Insight application configuration decorator.
Insight AppConfig constructor.
Get the list of all Insight entities of an app or scenario data container.
Get the list of all execution modes of the app.
Get an Insight entity by name.
Get an execution mode object by name.
Get the default name of the app.
Get the result data configuration of the app.
Get the scenario types of the app.
Get the version number of the app.

xpressinsight.AppVersion

Class to represent the version number of an Insight Python app, according to semver (Semantic Versioning) conventions.
Initializes AppVersion with major, minor, and patch version information.
Major version number
Minor version number
Patch version number

xpressinsight.ResultData

Class which specifies how to handle result data within the Insight server.
Initializes ResultData with delete strategy.

xpressinsight.ResultDataDelete

When to delete scenario results data.

xpressinsight.EntitiesConfig

Abstract base class for entity container configuration.
Get the list of all Insight entities of an app or scenario data container.
Get an Insight entity by name.

xpressinsight.EntitiesContainer

Abstract base class used for classes that contain scenario entities (such as AppBase and ScenarioData), providing a standard way to query entity definitions.
Property for the entities configuration for entities stored in this class.

xpressinsight.ExecMode

Insight execution mode decorator.
Constructor for the execution mode decorator for user-defined execution modes.
Invoke the execution mode.
Whether this execution mode clears inputs.
Execution mode description.
Execution mode name.
Preferred execution service for this execution mode.
Whether this execution mode sends progress updates.
Desired thread allocation for this execution mode.

xpressinsight.ExecModeLoad

Decorator class for the built-in LOAD execution mode.
Constructor for the LOAD execution mode decorator.
Invoke the execution mode.
Whether this execution mode clears inputs.
Execution mode description.
Execution mode name.
Preferred execution service for this execution mode.
Whether this execution mode sends progress updates.
Desired thread allocation for this execution mode.

xpressinsight.ExecModeRun

Decorator class for the built-in RUN execution mode.
Constructor for the RUN execution mode decorator.
Invoke the execution mode.
Whether this execution mode clears inputs.
Execution mode description.
Execution mode name.
Preferred execution service for this execution mode.
Whether this execution mode sends progress updates.
Desired thread allocation for this execution mode.

© 2001-2024 Fair Isaac Corporation. All rights reserved. This documentation is the property of Fair Isaac Corporation (“FICO”). Receipt or possession of this documentation does not convey rights to disclose, reproduce, make derivative works, use, or allow others to use it except solely for internal evaluation purposes to determine whether to purchase a license to the software described in this documentation, or as otherwise set forth in a written software license agreement between you and FICO (or a FICO affiliate). Use of this documentation and the software described in it must conform strictly to the foregoing permitted uses, and no other use is permitted.