Workspace

APIs for loading and using Settings and Workspace resources

Interfaces

Name Description  
CloudSqliteContainer Base interface for containers backed by CloudSqlite that hold versioned databases (e.g.  
CreateNewSettingsContainerArgs Arguments supplied to createNewCloudContainer to create a new EditableSettingsCloudContainer.  
CreateNewSettingsDbVersionArgs Arguments supplied to createNewSettingsDbVersion.  
CreateNewWorkspaceContainerArgs Arguments supplied to createNewCloudContainer to create a new EditableWorkspaceContainer.  
CreateNewWorkspaceDbVersionArgs Arguments supplied to createNewWorkspaceDbVersion.  
CreateSettingsDbArgs Arguments supplied to createDb to create a new SettingsDb in a container.  
EditableSettingsCloudContainer A CloudSqliteContainer opened for editing settings by a SettingsEditor.  
EditableSettingsDb An editable SettingsDb.  
EditableWorkspaceContainer A WorkspaceContainer opened for editing by a WorkspaceEditor.  
EditableWorkspaceDb An editable WorkspaceDb.  
GetSettingsDbArgs Arguments for obtaining a SettingsDb from a previously-loaded container.  
GetWorkspaceContainerArgs Arguments supplied to getContainer and getContainer.  
GetWorkspaceResourceArgs Arguments supplied to getStringResource and WOrkspace.getBlobResource.  
QueryWorkspaceResourcesArgs Arguments supplied to queryResources defining the query criteria and the list of WorkspaceDbs to query.  
SettingGroupSchema Metadata describing a group of related SettingSchemas.  
Settings The collection of Settings that supply the run-time configuration of a Workspace.  
SettingSchema Metadata describing a single Setting as part of a SettingGroupSchema.  
SettingsContainer An object that defines the values for any number of Settings.  
SettingsDb A CloudSQLite database dedicated to storing settings as key-value pairs.  
SettingsDbManifest Metadata stored inside a SettingsDb describing the database's contents, to help users understand  
SettingsDbProps Properties that specify how to load a SettingsDb within a CloudSqliteContainer.  
SettingsDbVersionResult The result of creating a new version of a SettingsDb.  
SettingsDictionary A named container that supplies values for Settings.  
SettingsDictionaryProps Properties of a SettingsDictionary, defining its name, the WorkspaceDb (if any) from which it originated, and its priority relative to other dictionaries.  
SettingsDictionarySource Uniquely identifies a SettingsDictionary.  
SettingsEditor An object that permits administrators to modify the contents of settings containers.  
SettingsSchemas The registry of metadata describing groups of SettingSchemas available to the current session.  
UpdateSettingArgs Arguments supplied to updateSetting to add or update a single Setting.  
Workspace Settings and resources that customize an application for the current session.  
WorkspaceContainer A CloudSqliteContainer that holds one or more WorkspaceDbs.  
WorkspaceContainerProps Properties describing a WorkspaceContainer for methods like getContainerAsync.  
WorkspaceDb A SQLite database in a Workspace containing named resources that the application is configured to use.  
WorkspaceDbCloudProps Properties describing a WorkspaceDb and the WorkspaceContainer containing it.  
WorkspaceDbLoadError An exception thrown when attempting to load a WorkspaceDb or some of its data; for example, if the WorkspaceDb could not be found or the user  
WorkspaceDbLoadErrors An exception that may occur while opening an IModelDb if any problems are detected while loading its workspace.  
WorkspaceDbManifest Metadata stored inside a WorkspaceDb describing the database's contents, to help users understand the purpose of the WorkspaceDb, who to  
WorkspaceDbProps Properties that specify how to load a WorkspaceDb within a WorkspaceContainer.  
WorkspaceDbQueryResourcesArgs Arguments supplied to queryResources.  
WorkspaceDbSettingsProps Specifies a resource inside a WorkspaceDb that holds a SettingsDictionary to load into settings.  
WorkspaceEditor An object that permits administrators to modify the contents of a Workspace.  
WorkspaceOpts Options supplied to startup via workspace to customize the initialization of appWorkspace.  

Namespaces

Name Description  
Setting  
SettingsEditor  
SettingsPriority  
Workspace  
WorkspaceEditor  
WorkspaceSettingNames The names of various Settings with special meaning to the Workspace system.  

Type Aliases

Name Description  
QueryWorkspaceResourcesCallback A function supplied as part of a QueryWorkspaceResourcesArgs to iterate the resources retrieved by queryResources.  
Setting The value of a single named parameter within a settings that configures some aspect of the applications run-time behavior.  
SettingName The name of a Setting.  
SettingsPriority Defines the precedence of a SettingsDictionary.  
WorkspaceContainerId The unique identifier of a WorkspaceContainer.  
WorkspaceDbFullName The fully-specified name of a WorkspaceDb, combining its WorkspaceDbName and WorkspaceDbVersion in the format "name:version".  
WorkspaceDbName The base name of a WorkspaceDb, without any version information.  
WorkspaceDbNameAndVersion Specifies the name and version of a WorkspaceDb.  
WorkspaceDbQueryResourcesCallback A function supplied as callback to be invoked to process the requested resources.  
WorkspaceDbVersion A semver string describing the version of a WorkspaceDb, e.g., "4.2.11".  
WorkspaceDbVersionRange A semver string describing a range of acceptable WorkspaceDbVersions,  
WorkspaceResourceName The name of a blob, string, or file resource stored in a WorkspaceDb.  

Last Updated: 02 April, 2026