Configuration Reference
The following config items have been deprecated and may be removed in a future release.
manifest.appAssets.appAssets[].version
(string)AppAsset versions are deprecated and will likely go away in the future. If supplied, FEA will only download an asset if it has not already downloaded a copy of the asset with the specified version number and src properties. If omitted, FEA relies on ETag response headers to determine a caching strategy.
manifest.devtools_port
Replace with: the remote-debugging-port chromium flag within project.json.
(number9090)This property is no longer supported and will likely go away in the future.
manifest.disableWMICalls
(booleantrue)When set to true, Finsemble will not make calls that require Windows Management Instrumentation Command-line (WMIC). This option fills GPU information for the getHostSpecs method and will be removed in a future version.
finsemble.accessibleLinker
(booleantrue)finsemble.appd
Replace with: finsemble.apps
(object)Contains Finsemble's app configurations aligning with FDC3 1.2. App config is the primary way that Finsemble learns about apps. Finsemble uses this to create its launcher menus and for driving data integration (interop). This property is deprecated and will likely go away in the future.
- appdfinsemble.appd(object)Contains Finsemble's app configurations aligning with FDC3 1.2. App config is the primary way that Finsemble learns about apps. Finsemble uses this to create its launcher menus and for driving data integration (interop). This property is deprecated and will likely go away in the future.
- appd[]finsemble.appd[](object)AppD entries that describe apps. This format follows the FDC3 AppD specification. It is deprecated and will likely go away in the future.
- appIdfinsemble.appd[].appId(string)(required)A unique identifier for the app that is used programmatically. It must follow the AppD specification for fully qualified naming: https://fdc3.finos.org/docs/app-directory/overview#application-identifiers.
- contactEmailfinsemble.appd[].contactEmail(string)Email address to contact for information about the app. Used when apps are picked out of a third party app catalog.
- descriptionfinsemble.appd[].description(string)Textual description of the app.
- iconsfinsemble.appd[].icons(array)Set of icons for the app. Finsemble tries to pick the best matching icon but the best practice is to use a single png size 64x64 with a transparent background.
- icons[]finsemble.appd[].icons[](object)
- iconfinsemble.appd[].icons[].icon(string)FDC3 1.0 - 1.2 version of 'src' field.
- sizesfinsemble.appd[].icons[].sizes(string)The size of the icon in the form 32x32. You can have multiple sizes for different image types. This follows the Web Manifest specification.
- srcfinsemble.appd[].icons[].src(string)The url path for the icon image.
- typefinsemble.appd[].icons[].type(string)Image or icon expected MIME type, such as 'image/png'.
- imagesfinsemble.appd[].images(array)Set of "screenshots" that describe the app. Used when picking apps out of an app catalog.
- intentsfinsemble.appd[].intents(array)The set of intents that this app is listening for. See Interop.
- intents[]finsemble.appd[].intents[](object)An intent (following the FDC3 format)
- contextsfinsemble.appd[].intents[].contexts(array)(required)A filter stating that this app handles only intents for *these* context types. Note that intents can have one or more context types.)
- displayNamefinsemble.appd[].intents[].displayName(string)Friendly printable name for the intent. Whenever there is more than one possible resolution, this name appears in the FDC3 Intent Resolver when an end user is asked to decide which app to send the intent to.
- namefinsemble.appd[].intents[].name(string)(required)The official name of the intent. This name is referenced in interop config.
- interopfinsemble.appd[].interop(object)Metadata that describes how the application uses FDC3 APIs. This metadata serves multiple purposes:
- It supports intent resolution by a desktop agent, by declaring what intents an app listens for.
- It can be used, for example in an app catalog UI, to find apps that 'interoperate with' other apps.
- It provides a standard location to document how the app interacts with user channels, app channels, and intents, for use by other app developers and desktop assemblers.
- appChannelsfinsemble.appd[].interop.appChannels(array)Describes the application's use of App Channels.
This metadata is not currently used by the desktop agent, but is provided to help find apps that will interoperate with this app and to document API interactions for use by other app developers.- appChannels[]finsemble.appd[].interop.appChannels[](object)
- broadcastsfinsemble.appd[].interop.appChannels[].broadcasts(array)An array that contains the names of context types that the app broadcasts on the channel.
- descriptionfinsemble.appd[].interop.appChannels[].description(string)A description of how the channel is used.
- idfinsemble.appd[].interop.appChannels[].id(string)The ID of the App Channel.
- listensForfinsemble.appd[].interop.appChannels[].listensFor(array)An array that contains the names of context types that the application listens for on the channel.
- intentsfinsemble.appd[].interop.intents(object)Describes the app's interactions with intents.
- listensForfinsemble.appd[].interop.intents.listensFor(object)A mapping of Intents names that an app listens for via
fdc3.addIntentListener()to their configuration.
Used to support intent resolution by desktop agents. Replaces theintentselement used in appD records prior to FDC3 2.0.- listensFor[]finsemble.appd[].interop.intents.listensFor[](object)
- contextsfinsemble.appd[].interop.intents.listensFor[].contexts(array)A filter stating that this app handles only intents for *these* context types. Note that intents can have one or more context types.
- displayNamefinsemble.appd[].interop.intents.listensFor[].displayName(string)Optional friendly printable name for the intent. To be deprecated in FDC3 2.1 as it is problematic for apps to configure different display names for the same Intent.
- resultTypefinsemble.appd[].interop.intents.listensFor[].resultType(string)An optional type for output returned by the application, if any, when resolving this intent. Might indicate a context type by type name (e.g.
"fdc3.instrument"), a channel (e.g."channel") or a combination that indicates a channel that returns a particular context type (e.g."channel<fdc3.instrument>").
- raisesfinsemble.appd[].interop.intents.raises(object)A mapping of Intent names that an app raises (via
fdc3.raiseIntent) to an array of context type names that it can be raised with.
Use the intent name"any"to represent use of thefdc3.raiseIntentForContextandfdc3.findIntentForContextfunctions, which allow the user to select from intents available for a specified context type.
This metadata is not currently used by the desktop agent, but is provided to help find apps that will interoperate with this app and to document API interactions for use by other app developers.
- userChannelsfinsemble.appd[].interop.userChannelsDescribes the application's use of context types on User Channels.
This metadata is not currently used by the desktop agent, but is provided to help find apps that will interoperate with this app and to document API interactions for use by other app developers.
- langfinsemble.appd[].lang(string)A language tag that specifies the primary language of both the application and its AppD entry, as defined by IETF RFC 5646. For example, "fr" for French or "en-CA" for Canadian English.
- manifestfinsemble.appd[].manifest(object)(required)The name of the component you are configuring.
- //finsemble.appd[].manifest.//(string)Optional comment describing the component.
- appServicefinsemble.appd[].manifest.appService(booleanfalse)When true, the app is treated as an app service.
- bootParamsfinsemble.appd[].manifest.bootParams(object)Boot parameter properties
- autoStartfinsemble.appd[].manifest.bootParams.autoStart(booleantrue)Specifies whether to automatically start during the system manager's startup phase.
- checkpointsfinsemble.appd[].manifest.bootParams.checkpoints(object)
- customFailureMessagefinsemble.appd[].manifest.bootParams.customFailureMessage(string)The custom message to output to the system log if the app fails to start.
- dependenciesfinsemble.appd[].manifest.bootParams.dependencies(array)Specifies other services this service relies on.
- stagefinsemble.appd[].manifest.bootParams.stage(string)Specifies at which stage the app is launched.
"microkernel"
"kernel"
"pre-authentication"
"authentication"
"appd-retrieval"
"system-preuser"
"preuser"
"preuser2"
"preuser3"
"preuser4"
"system-earlyuser"
"earlyuser"
"user" - stopOnFailurefinsemble.appd[].manifest.bootParams.stopOnFailure(booleantrue)Specifies whether the app should stop if one or more of its dependencies fail to start. Only relevant to apps with dependencies. Set to false if you want the app to continue startup even if its dependencies fail.
- timeoutfinsemble.appd[].manifest.bootParams.timeout(number)The maximum time, in milliseconds, that the app can take to start up. If the startup doesn't complete in this time, it's marked as a failure. If you don't specify this property, Finsemble uses the default timeout value under the manifest's 'bootConfig.startComponentTimeout' property.
- childWindowOptionsfinsemble.appd[].manifest.childWindowOptions(object)Configuration for all child windows created via window.open for this app. Child windows can't join workspaces, group, tab, or tile. childWindowOptions supports the same properties as component...
- componentfinsemble.appd[].manifest.component(object)Properties associated with how Finsemble manages this application.
- advertiseReceiversfinsemble.appd[].manifest.component.advertiseReceivers(array,string)
- allowQuickComponentfinsemble.appd[].manifest.component.allowQuickComponent(string)
- canMaximizefinsemble.appd[].manifest.component.canMaximize(boolean)
- canMinimizefinsemble.appd[].manifest.component.canMinimize(boolean)
- categoryfinsemble.appd[].manifest.component.category(string)During dynamic configuration, Finsemble can overwrite components already in the configuration. To prevent this from happening, set this value to "system". This setting is used, for example, to prevent system UI components from being dropped out of the config.
- centralLoggerNamePrefixfinsemble.appd[].manifest.component.centralLoggerNamePrefix(string)Prefixes the windowDisplayName for the entry in the Central logger.
- customfinsemble.appd[].manifest.component.custom
- displayNamefinsemble.appd[].manifest.component.displayName(string)Changes the applications's name in the launcher and its label in the pinned item section.
- enableGrpcfinsemble.appd[].manifest.component.enableGrpc(boolean)Enables GRPC. Can be used from BrowserView based applications. grpc is a global variable available at window.grpc or at fin.grpc. Note: Sandbox is disabled for these applications.
- maxReloadAttemptsfinsemble.appd[].manifest.component.maxReloadAttempts(number0)Number of maximum reload attempts that should be executed if the component's WebContents fails to load.
- minimum: 0
- maximum: 60
- modefinsemble.appd[].manifest.component.mode(string)
- neededClientsfinsemble.appd[].manifest.component.neededClients(array)Clients no longer need to be specified for initialization.
- preloadfinsemble.appd[].manifest.component.preload(boolean,string,array)A preload is a JavaScript file that is inserted into browser page and runs before any other content. Specify a full path for your preloads. You can specify a list of files to be included. Learn more about preloads in Integrating HTML Applications.
- reloadTimeoutfinsemble.appd[].manifest.component.reloadTimeout(number60000)Reload timeout for the component's WebContents.
- minimum: 0
- maximum: 999999
- showDevConsoleOnVisiblefinsemble.appd[].manifest.component.showDevConsoleOnVisible(booleanfalse)If set to
true, a Chrome developer console spawns along with the application to assist with debugging. - singletonfinsemble.appd[].manifest.component.singleton(booleanfalse)If set to
true, the application behaves as a singleton; only a single instance can be launched. If the application has already been launched, if a user tries to launch it again, Finsemble brings it to front instead. - spawnOnAllMonitorsfinsemble.appd[].manifest.component.spawnOnAllMonitors(boolean)
- spawnOnHotkeyfinsemble.appd[].manifest.component.spawnOnHotkey(array)The application is launched when the user activates this global hotkey combination. Example: ["ctrl","alt","a"]
- spawnOnStartupfinsemble.appd[].manifest.component.spawnOnStartup(booleanfalse)When true, Finsemble automatically launches this application when the application starts.
- useAppCatalogfinsemble.appd[].manifest.component.useAppCatalog(boolean)
- customfinsemble.appd[].manifest.custom(object)This area is free-form and can support any custom elements associated with the app.
- foreignfinsemble.appd[].manifest.foreign(object)This section contains configurations that other applications and services read when they interact with this component.
- agentLabelfinsemble.appd[].manifest.foreign.agentLabel(string)
- componentsfinsemble.appd[].manifest.foreign.components(object)Configurations specific to other applications that wish to interact with this app.
- App Launcherfinsemble.appd[].manifest.foreign.components.App Launcher(object)App launcher is a drop down menu that launches other application.
- Toolbarfinsemble.appd[].manifest.foreign.components.Toolbar(object)Configurations related to the global toolbar (at the top of the monitor).
- iconClassfinsemble.appd[].manifest.foreign.components.Toolbar.iconClass(string)A CSS class character to display when this application is pinned in the toolbar. See "fin-font" or use font-awesome or similar. This setting will override AppD icons.
{
"iconClass": "ff-ungrid"
} - iconURLfinsemble.appd[].manifest.foreign.components.Toolbar.iconURL(string)
{
"iconURL": "$applicationRoot/assets/img/Finsemble_Taskbar_Icon.png"
}
- Window Managerfinsemble.appd[].manifest.foreign.components.Window Manager(object)Configurations specific to an app's window title bar.
- alwaysOnTopIconfinsemble.appd[].manifest.foreign.components.Window Manager.alwaysOnTopIcon(booleanfalse)When set to
true, all windows can be pinned so that they are always on top (like a sticky note). You can override this setting for specific components in their configs. - cloneIconfinsemble.appd[].manifest.foreign.components.Window Manager.cloneIcon(booleanfalse)When set to
true, a clone icon will be added to the window titlebar that can be used to clone the window. - componentCloseTimeoutfinsemble.appd[].manifest.foreign.components.Window Manager.componentCloseTimeout(number5000)Time, in milliseconds, to wait for the component to close. If the component hasn't closed within this limit, it will be force closed.
- deliveryMechanismfinsemble.appd[].manifest.foreign.components.Window Manager.deliveryMechanism(stringinjection)Specify the delivery method to use for scripts (e.g., FSBL, title bar, etc.) - Valid values are: "injection" - Injects the code into the window.
"injection"
"preload" - disableBrowserViewfinsemble.appd[].manifest.foreign.components.Window Manager.disableBrowserView(booleanfalse)This property is no longer supported and will likely go away in the future. When set to
true, the window titlebar is injected directly into the window's content pane, rather than separated out into a separate browserview within the window. - floatingTitlebarComponentfinsemble.appd[].manifest.foreign.components.Window Manager.floatingTitlebarComponent(string)This config sets which component Finsemble will use as a title bar for native application components. By default, the only value is "FloatingTitlebar." This config allows you to customize this behavior with a customized title bar component and created a configuration for it in appd.json
- FSBLHeaderfinsemble.appd[].manifest.foreign.components.Window Manager.FSBLHeader(boolean,objecttrue)This config controls the Finsemble window title bar UI component. FSBLHeader can be true, false or an object. If true then the window title bar will be injected into the component and the maximize, minimize, and close buttons will be displayed. If false, the title bar will not be displayed. If an object, you can tweak several details as to whether buttons are shown or how content is loaded under the title bar.
- adjustContentHeightsfinsemble.appd[].manifest.foreign.components.Window Manager.FSBLHeader.adjustContentHeights(booleantrue)When set to true, the height of content sized to fit the window is adjusted to fit within the adjusted bounds of the window when the Finsemble window title bar is injected into the DOM.
- bumpElementsfinsemble.appd[].manifest.foreign.components.Window Manager.FSBLHeader.bumpElements(object)Optional settings that adjust the height and position of absolute/fixed positioned elements when the window title bar is injected. Use it to mitigate rare display issues that can occur due to the injected title bar. Set this field to
falseto bypass all bumping logic.- absolutefinsemble.appd[].manifest.foreign.components.Window Manager.FSBLHeader.bumpElements.absoluteEither none, "all" or "0Positioned". If all, all fixed elements are moved. 0Positioned only moves elements that have top 0. Only applies to children of the document.body.
"none"
"all"
"0Positioned" - bumpByfinsemble.appd[].manifest.foreign.components.Window Manager.FSBLHeader.bumpElements.bumpBy(string)Sets the amount to bump elements by (e.g. "25px").
- fixedfinsemble.appd[].manifest.foreign.components.Window Manager.FSBLHeader.bumpElements.fixedEither none, "all" or "0Positioned". If all, all fixed elements are moved. 0Positioned only moves elements that have top 0.
"none"
"all"
"0Positioned" - monitorFixedAdditionsfinsemble.appd[].manifest.foreign.components.Window Manager.FSBLHeader.bumpElements.monitorFixedAdditions(boolean)When set to true, mutations to the DOM are observed and fixed positioned elements with a top style of '0px' are bumped by the title bar height. Setting this to false disables the MutationObserver that is otherwise turned on for pages with injected title bars.
- hackScrollbarfinsemble.appd[].manifest.foreign.components.Window Manager.FSBLHeader.hackScrollbar(booleanfalse)When set to true, a window's vertical scrollbar is positioned underneath the Finsemble window title bar using html{ overflow-y: none} and body{ overflow-y: auto}
- hideClosefinsemble.appd[].manifest.foreign.components.Window Manager.FSBLHeader.hideClose(booleanfalse)Value indicating whether the Close button is hidden in the component title bar.
- hideMaximizefinsemble.appd[].manifest.foreign.components.Window Manager.FSBLHeader.hideMaximize(booleanfalse)When set to true, the Maximize icon is hidden from the component's title bar.
- hideMinimizefinsemble.appd[].manifest.foreign.components.Window Manager.FSBLHeader.hideMinimize(booleanfalse)When set to true, the Minimize icon will be hidden from the component's title bar.
- titlefinsemble.appd[].manifest.foreign.components.Window Manager.FSBLHeader.title(booleanfalse)Sets the title in the window title bar. This property is no longer supported and will likely go away in the future.
- zoomDefaultfinsemble.appd[].manifest.foreign.components.Window Manager.FSBLHeader.zoomDefault(number)Default zoom level to set for the component when using the zoom.js sample preload.
- titlefinsemble.appd[].manifest.foreign.components.Window Manager.title(string)Sets the title in the window title bar.
- titlebarTypefinsemble.appd[].manifest.foreign.components.Window Manager.titlebarType(stringbrowserview)Determines how the window title bar is added to web windows. The default 'browserview' separates the title bar and content pane into separate browserviews and can resolve rare display issues with the injected title bar, at the cost of disabling process grouping via affinity for the content pane. Setting 'injected' causes the title bar and its styles to be inserted directly into your web page's DOM and its layout to be lightly adjusted to accommodate.
"browserview"
"injected" - zoomfinsemble.appd[].manifest.foreign.components.Window Manager.zoom(object)Configuration for the zoom.js preload.
- ignoreSelectorfinsemble.appd[].manifest.foreign.components.Window Manager.zoom.ignoreSelector(string)A css selector instructing the zoom.js preload which elements should not be zoomed
"#element-id" - maxfinsemble.appd[].manifest.foreign.components.Window Manager.zoom.max(number5)The maximum allowed zoom level.
- minfinsemble.appd[].manifest.foreign.components.Window Manager.zoom.min(number0.2)The minimum allowed zoom level.
- stepfinsemble.appd[].manifest.foreign.components.Window Manager.zoom.step(number0.1)How much the zoom increases or decreases when zooming in or out.
- timeoutfinsemble.appd[].manifest.foreign.components.Window Manager.zoom.timeout(number3000)Time, in milliseconds, to display the zoom pop up before hiding it.
- zoomSelectorfinsemble.appd[].manifest.foreign.components.Window Manager.zoom.zoomSelector(string)A css selector instructing the zoom.js preload which additional elements should get zoomed. The zoom preload will automatically attempt to detect which elements should get zoom.
"#my-element, .my-class"
- customfinsemble.appd[].manifest.foreign.custom
- servicesfinsemble.appd[].manifest.foreign.services(object)Configurations for services that will interact with this application.
- windowServicefinsemble.appd[].manifest.foreign.services.windowService(object)Configurations that the window service will apply to this app.
- allowAutoArrangefinsemble.appd[].manifest.foreign.services.windowService.allowAutoArrange(booleantrue)If
true, the window can be auto arranged. Iffalse, will disable the window's ability to be auto arranged by the Window Service. - allowGroupingfinsemble.appd[].manifest.foreign.services.windowService.allowGrouping(booleantrue)If
true, the window can form groups with other windows. Iffalse, this window cannot be placed into a group. Note: Grouping windows by manually dragging can be difficult or impossible if allowSnapping is disabled. - allowMaximizefinsemble.appd[].manifest.foreign.services.windowService.allowMaximize(booleantrue)If
true, the window can be maximized. Iffalse, the window cannot be maximized. - allowMinimizefinsemble.appd[].manifest.foreign.services.windowService.allowMinimize(booleantrue)If
true, the window can be minimized to the taskbar. Iffalse, the window cannot be minimized. - allowSnappingfinsemble.appd[].manifest.foreign.services.windowService.allowSnapping(booleantrue)If
true, this window can be snapped. Iffalse, this window cannot benefit from snapping. - allowTabbingfinsemble.appd[].manifest.foreign.services.windowService.allowTabbing(booleanfalse)If
true, the window's titlebar will include a tab header that can be dragged or have other tabs dropped onto it. Iffalse, tabbing will be disabled for this window. - allowTilingfinsemble.appd[].manifest.foreign.services.windowService.allowTiling(booleanfalse)If
true, the window can be tiled on by other windows by dragging tab headers onto its body (below the titlebar). Iffalse, tiling is disabled for this window. Tiling is not possible if a window is not resizable or if tabbing is disabled. - globalfinsemble.appd[].manifest.foreign.services.windowService.global(boolean)
- isArrangablefinsemble.appd[].manifest.foreign.services.windowService.isArrangable(boolean)Deprecated as of 3.6
- manageWindowMovementfinsemble.appd[].manifest.foreign.services.windowService.manageWindowMovement(booleantrue)If
true, the Window Service manages the window's movement. Unless otherwise specified by the following params, this means the Window Service can perform actions on this window: move, group, snap, minimize, maximize, etc. When this parameter isfalseit could be overwritten byallowSnapping,allowGrouping,allowAutoArrange,allowTabbing,allowTiling,allowMinimize,allowMaximize,window.dockable,FSBLHeaderif any from them istrue - shouldRegisterfinsemble.appd[].manifest.foreign.services.windowService.shouldRegister(boolean)
- workspaceServicefinsemble.appd[].manifest.foreign.services.workspaceService(object)Configurations related to the workspace service.
- persistArgumentsfinsemble.appd[].manifest.foreign.services.workspaceService.persistArguments(booleantrue)When false, the application does not automatically persist its arguments through restarts and workspace reloads, even when the arguments change in the config. Arguments are used for "native" (aka "assimilation") windows.
- persistPathfinsemble.appd[].manifest.foreign.services.workspaceService.persistPath(booleanfalse)When true, the application automatically persists its path through restarts and workspace reloads, even when the path changes in the config. Path is used for "native" (aka "assimilation") windows.
- persistURLfinsemble.appd[].manifest.foreign.services.workspaceService.persistURL(booleanfalse)A config that specifies whether Finsemble should persist the application URL. When true, the app or component automatically saves its last URL instead of using the one in the config. The application config overrides the global config.
- interopfinsemble.appd[].manifest.interop(object)Interop (data integration) related config for this app
- autoConnectfinsemble.appd[].manifest.interop.autoConnect(booleanfalse)If set to true, the app automatically connects to the Interop service. In most cases, this causes the linker to display. If set to false (the default), the app connects on the first call to any
fdcfunction. - fdc3_1_2_compatibilityfinsemble.appd[].manifest.interop.fdc3_1_2_compatibility(boolean)If true, Finsemble desktop agent conforms to FDC3 1.2 (as opposed to 2.0).
- joinMultipleChannelsfinsemble.appd[].manifest.interop.joinMultipleChannels(boolean)If explicitly set to false, an app cannot join multiple user channels. So when an app that is already on a channel joins another channel, it automatically leaves the channel it was on.
- launchablefinsemble.appd[].manifest.interop.launchable(boolean)If explicitly set to false, an app is not launchable from the FDC3 UI resolver for handling an intent. This property is independent from the launchableByUser property affecting the App Launcher menu.
- selectConnectfinsemble.appd[].manifest.interop.selectConnect(array)Interop messaging rules to support no-code integration of modules. It allows you to specify precisely which modules can communicate and in what way.
- selectConnect[]finsemble.appd[].manifest.interop.selectConnect[](object)A specific selectConnect rule that consists of one or more properties.
- authorizefinsemble.appd[].manifest.interop.selectConnect[].authorize(array)
- autoAssociatefinsemble.appd[].manifest.interop.selectConnect[].autoAssociate(object)Define app’s autoAssociate property
- allChildrenfinsemble.appd[].manifest.interop.selectConnect[].autoAssociate.allChildren(boolean)if true, all apps spawned or opened by this app are automatically associated (i.e. auto-joined to common channel).
- selectChildrenfinsemble.appd[].manifest.interop.selectConnect[].autoAssociate.selectChildren(array)Any app in this list when spawned or opened by this app is automatically associated.
- usingConnectIdfinsemble.appd[].manifest.interop.selectConnect[].autoAssociate.usingConnectId(string)Specifies a fixed association (as opposed to dynamic) using the specified connectId -- all apps with this connectId are automatically associated.
- ccfinsemble.appd[].manifest.interop.selectConnect[].cc(string)The name of a valid selectConnect module. When cc is set, that module receives a copy of the message. cc works on both outgoing and incoming traffic.
- contextTypefinsemble.appd[].manifest.interop.selectConnect[].contextType(string)Apply this rule only to this specific context type. (Optional).
- fromfinsemble.appd[].manifest.interop.selectConnect[].from(array)
- fwdfinsemble.appd[].manifest.interop.selectConnect[].fwd(string)The name of a valid selectConnect module. When you set fwd, that module receives the message *instead* of the original description. fwd is intended primarily for outgoing traffic but also works on incoming traffic.
- tofinsemble.appd[].manifest.interop.selectConnect[].to(array)
- showWhenIntentReceivedfinsemble.appd[].manifest.interop.showWhenIntentReceived(boolean)If explicitly set to
false, do not automatically show (i.e. bring to front or restore) an app instance receiving an FDC3 intent. If explicitly set totrue, then always try to show it. Otherwise, the default is to show the application when an intent is received if the app window is normally shown (i.e. itsautoShowproperty istrue). - useLinkerfinsemble.appd[].manifest.interop.useLinker(boolean)The linker is turned on by default for any app that uses FDC3. Set this flag to false if you want to turn off the linker for this app, for example, if your app only uses App Channels (i.e. 'well known' named channels).
- signatureKeyfinsemble.appd[].manifest.signatureKey(object)Public authentication key to decrypt static AuthenticationTokens within interopService. Necessary config for Freestanding applications connecting to Finsemble from outside.
- signatureKeyURLfinsemble.appd[].manifest.signatureKeyURL(stringfalse)URL specifying the location of the signature key - an alternative to providing the
signatureKeywith the Finsemble configuration. - uiComponentfinsemble.appd[].manifest.uiComponent(booleanfalse)
- waitForInitializationfinsemble.appd[].manifest.waitForInitialization(booleanfalse)When true, startup waits for the app to explicitly signal it is ready.
- windowfinsemble.appd[].manifest.window(object)Configurations that manage placement of the application's window on the screen. Configuration settings in this section can also be passed as parameters to
LauncherClient.spawn().- addToWorkspacefinsemble.appd[].manifest.window.addToWorkspace(booleanfalse)Specifies whether to add the new component to the workspace. The value set in the component manifest takes priority over any value passed as a parameter to
LauncherClient.spawnor related functions. Set it tofalseto prevent tabbing and grouping for the component. - affinityfinsemble.appd[].manifest.window.affinity(string,boolean)Process affinity allows you to control how render processes for web windows, served from the same 'site' (registered domain and protocol) are grouped together, reducing their memory footprint, at the cost of increasing CPU resource contention (because a render thread can only process one window at a time). As most user interface components are only active while the user is interacting with them, process grouping via affinity is an effective way to reduce memory footprint. Conversely, you might want to disable or customize the affinity setting for CPU intensive applications that are driven by outside events (for example a ticking blotter or chart driven by an external data source). In this way, you can strike a balance between performance and memory footprint. Group applications together thoughtfully by setting them to the same string value or disable render process group by setting affinity to false. See the Process Management tutorial for more information.
- aliasfinsemble.appd[].manifest.window.alias(string)Used with native applications (that is, when windowType is "native" or "assimilation") instead of
path. Specifies the alias of a bundled asset to launch. - alwaysOnTopfinsemble.appd[].manifest.window.alwaysOnTop(boolean)
- argumentsfinsemble.appd[].manifest.window.arguments(string)Specifies the arguments to be sent to a native application (that is, when windowType is "native" or "assimilation") on launch. Separate the arguments by spaces:
--arg1 foo --arg2 barexcept whenparams.argumentsAsQueryStringis true, in which case set this parameter to be single string in URI format:arg=1&arg=2. - argumentsAsQueryStringfinsemble.appd[].manifest.window.argumentsAsQueryString(boolean)For native applications (i.e. when windowType is "native" or "assimilation"), causes the generated arguments (the automatically generated arguments and any supplied as the "arguments" parameter) to be encoded as a query string and appended to the URI. Useful for applications launched via a protocol handler or online ClickOnce deployment, where the path parameter is a URI.
- autoShowfinsemble.appd[].manifest.window.autoShow(boolean)
- bottomfinsemble.appd[].manifest.window.bottom(string,number,null)A pixel value that represents the distance from the bottom edge of the viewport as defined by "position". For non-absolute positions, you can also use the percentage value, which represents the percentage distance from the bottom edge of the viewport relative to the viewport's height.
- canGroupfinsemble.appd[].manifest.window.canGroup(boolean)
- claimMonitorSpacefinsemble.appd[].manifest.window.claimMonitorSpace(boolean)For use with permanent toolbars. The available space for other components is reduced by the amount of space covered by the newly spawned component. Users can't move windows to a position that covers the claimed space.
- closeComponentsTogetherfinsemble.appd[].manifest.window.closeComponentsTogether(booleanfalse)Whether to close all components within a launchGroup at the same time.
- componentfinsemble.appd[].manifest.window.componentType of component to spawn.
- datafinsemble.appd[].manifest.window.data(array,boolean,integer,null,number,object,string)Optional data to pass to the opening window. If set, then the spawned window can use WindowClient.getSpawnData to retrieve the data.
- defaultHeightfinsemble.appd[].manifest.window.defaultHeight(number)
- dockablefinsemble.appd[].manifest.window.dockable(array,boolean)Parts of the monitor that the component can dock to. Valid values are
topandbottom. The[]value is equalfalse. Thetruevalue is equal['top', 'bottom'].true
false
[]
["top"]
["bottom"]
["top","bottom"] - dockedfinsemble.appd[].manifest.window.docked(string)Specifies the part of the monitor that the component docks to on spawn. Only valid if combined with the
dockableproperty."top"
"bottom" - dockedHeightfinsemble.appd[].manifest.window.dockedHeight(number)
- dockOnSpawnfinsemble.appd[].manifest.window.dockOnSpawn(boolean)If true, automatically docks the window with the "relative" window (dock to the parent window unless specified in params.relativeWindow). Note that you must also position the window in a valid position for docking, for example, by setting the "left" or "top" parameters to "adjacent".
- envfinsemble.appd[].manifest.window.envSets environment variables for a spawned native application. Create a map (JSON) object of names to values. This is only available when running Assimilation.
- ephemeralfinsemble.appd[].manifest.window.ephemeral(boolean)Indicates that this window is ephemeral. An ephemeral window is a dialog, menu, or other window that is temporarily displayed but usually hidden. Ephemeral windows automatically have these settings assigned: resizable: false, showTaskbarIcon: false, alwaysOnTop: true. Use
options:{autoShow: false}to prevent an ephemeral window from showing automatically. - forceOntoMonitorfinsemble.appd[].manifest.window.forceOntoMonitor(boolean,string)If true, tries to make the window have no edges outside the monitor boundary.
true
false
"availableRect"
"monitorRect" - framefinsemble.appd[].manifest.window.frame(boolean)
- groupOnSpawnfinsemble.appd[].manifest.window.groupOnSpawn(boolean)Groups the window to the
relativeWindowbased on their adjacent position. - heightfinsemble.appd[].manifest.window.height(number,string)A pixel or percentage value.
- idfinsemble.appd[].manifest.window.id(string)
- leftfinsemble.appd[].manifest.window.left(string,number,null)A pixel value representing the distance from the left edge of the viewport as defined by "position". For non-absolute positions, you can also use the percentage value, which represents the percentage distance from the left edge of the viewport relative to the viewport's width.
"adjacent" will snap to the right edge of the spawning or relative window.
"center" will center the window. If neither left nor right are provided, then the default will be to stagger the window based on the last spawned window. - maxHeightfinsemble.appd[].manifest.window.maxHeight(number,boolean,null)Maximum height window can be resized to.
- maxWidthfinsemble.appd[].manifest.window.maxWidth(number,boolean,null)Maximum width window can be resized to.
- minHeightfinsemble.appd[].manifest.window.minHeight(number,boolean,null)Minimum height window can be resized to.
- minWidthfinsemble.appd[].manifest.window.minWidth(number,boolean,null)Minimum width window can be resized to.
- monitorfinsemble.appd[].manifest.window.monitor(number,string)Specifies on which monitor to place the new window.
"mine" - Place the window on the same monitor as the calling window.
Integer value from 0-n (0 being the primary monitor).
"primary" indicates the user's primary monitor.
"all" - Put a copy of the component on all monitors. - namefinsemble.appd[].manifest.window.name(string)Window name to apply to the application. The name is not normally specified, allowing Finsemble to generate a random one from the component type. If specified in the configuration, only a single copy of the component can exist at a time.
- optionsfinsemble.appd[].manifest.window.options(object)Low level window behavior options. Note that you can't pass
optionsas arguments toLauncherClient.spawnand related API calls- allowedNavigationUrlsfinsemble.appd[].manifest.window.options.allowedNavigationUrls(array)Controls whether the app can navigate to other urls. If unspecified, the default is to allow all urls. This will change in a future version to allowing only same-origin urls, those with the same domain, protocol, and port as the window itself. An empty array indicates no navigation is allowed, even to the origin domain. To allow specific domains, add those domains to the array. The origin domain must also be added.
- allowedWindowOpenUrlsfinsemble.appd[].manifest.window.options.allowedWindowOpenUrls(array)Controls whether the app can programmatically open a window with
window.open()based on the url. If unspecified, the default is to allow all urls. This will change in a future version to allowing only same-origin urls, those with the same domain, protocol, and port as the window itself. An empty array indicates no navigation is allowed, even to the origin domain. To allow specific domains, add those domains to the array. The origin domain must also be added. - alwaysOnTopfinsemble.appd[].manifest.window.options.alwaysOnTop(booleanfalse)When set to true, the window is always on top (like a sticky note) of any window with alwaysOnTop set to false.
- autoShowfinsemble.appd[].manifest.window.options.autoShow(booleantrue)When set to true, the window is visible when it is spawned. When set to false, the window is spawned to be invisible.
- backgroundThrottlingfinsemble.appd[].manifest.window.options.backgroundThrottling(boolean)Specifies whether to throttle animations and timers when the page becomes backgrounded. This also affects the Page Visibility API. Defaults to true
- Content-Security-Policyfinsemble.appd[].manifest.window.options.Content-Security-Policy(array,string)Custom content security policy (CSP) that overrides the manifest CSP and the CSP received from this app's HTTP server. This can be a string or an array of strings. See MDN docs on CSP
[
"script-src *;"
] - contextMenufinsemble.appd[].manifest.window.options.contextMenu(booleantrue)A flag to show the context menu when right-clicking on a window. Gives access to the Developer Console for the Window.
- cornerRoundingfinsemble.appd[].manifest.window.options.cornerRounding(boolean,objecttrue)Specifies corner rounding for a window.
- isEvergreenfinsemble.appd[].manifest.window.options.isEvergreen(booleanfalse)When set to true, the window hides and shows when switching between workspaces rather than opening and closing. The same singleton instance of the window is used across multiple workspaces. Note: Tabbing and tiling is set to false for Evergreen components. If you're using set/getComponentState, the state is different per workspace. Listen for the 'component-state-changed' event on the window to update your application accordingly. Or fetch the new state in the Workspace 'load-complete' event in the case of a native application.
- maximizablefinsemble.appd[].manifest.window.options.maximizable(boolean)
- opacityfinsemble.appd[].manifest.window.options.opacity(number1)Sets the opacity of the window.
- openLinksInExternalBrowserfinsemble.appd[].manifest.window.options.openLinksInExternalBrowser(booleanfalse)When set to true, links (anchor tags) will be open in the OS default browser. See 'navigation' property for restricting navigation.
- permissionsfinsemble.appd[].manifest.window.options.permissions(object)Change an application's individual permissions to be different than from those in its security policy by adding configs under this config. See the Security Policies tutorial for more information.
- resizablefinsemble.appd[].manifest.window.options.resizable(booleantrue)When set to false, the user can't resize the window's edges and won't the window participate in Windows Aero Snap.
- securityPolicyfinsemble.appd[].manifest.window.options.securityPolicy(string)Set an application's security policy by name, for example to the default "trusted" or "untrusted" policies or to a custom policy. See the Security Policies tutorial for more information.
- showTaskbarIconfinsemble.appd[].manifest.window.options.showTaskbarIcon(boolean)Specifies whether the application should be displayed in the Windows taskbar.
- smallWindowfinsemble.appd[].manifest.window.options.smallWindow(boolean)
- transparentfinsemble.appd[].manifest.window.options.transparent(boolean)When set to true, the window is transparent. This works only if you haven't set any background color on the window, including through css tags. Dynamically removing background color styles does _not_ work on Mac (there must be no initial css styles for background or background-color).
- userAgentStringfinsemble.appd[].manifest.window.options.userAgentString(string)Sets the userAgent for a web window, allowing for spoofing the of the userAgent.
- windowSpawnTimeoutfinsemble.appd[].manifest.window.options.windowSpawnTimeout(number30)Number of seconds before a native application component spawn times out.
- windowTitleBarUrlfinsemble.appd[].manifest.window.options.windowTitleBarUrl(string)When specified, overrides the default Finsemble window titlebar. See finsemble.windowTitleBarUrl for more info.
- pathfinsemble.appd[].manifest.window.path(string)Specifies the path to a native application (i.e. when windowType is "native" or "assimilation"). The path can be:
- The name of an exe that is on the system path (e.g., notepad.exe).
- The full path to an executable on the user's machine (e.g., C:\Program Files\app.exe).
- A system installed URI (e.g., myuri://advancedapplauncher).
- uuid - A generated UUID that uniquely identifies this window.
- left - The x coordinate of the new window
- top - The y coordinate of the new window
- width - The width of the new window
- height - The height of the new window
- finsembleWindowName - The name of the window in the Finsemble config
- componentType - The component type in the Finsemble config
- appName - The name of the application in the Finsemble appd.
- positionfinsemble.appd[].manifest.window.position(string)Defines a "viewport" for the spawn, with one of the Position Types:
- available - Positioned according to the coordinates available on the monitor itself, less space claimed by the operating system (such as the windows toolbar). For example,
bottom:0places the new component with its bottom flush against the windows toolbar. - monitor - Positioned according to the absolute size of the monitor. For example,
top:0places the component overlapping the toolbar. - relative - Positioned relative to the relativeWindow. For example,
left:0;top:0joins the top left corner of the new component with the top left corner of the relative window. - virtual - Deprecated. Positioned against coordinates on the virtual screen. The virtual screen is the full viewing area of all monitors combined into a single theoretical monitor.
- absolute - Positioned using native operating system coordinates. Absolute positions require numeric top/right/left/bottom arguments.
"available"
"monitor"
"relative"
"virtual"
"absolute" - available - Positioned according to the coordinates available on the monitor itself, less space claimed by the operating system (such as the windows toolbar). For example,
- relativeWindowfinsemble.appd[].manifest.window.relativeWindowThe window to use when calculating any relative launches. If not set, the window from which spawn() was called. Primarily used as an argument to
LauncherClient.spawn()and related functions. - resizablefinsemble.appd[].manifest.window.resizable(boolean)
- rightfinsemble.appd[].manifest.window.right(string,number,null)A pixel value representing the distance from the right edge of the viewport as defined by "position". For non-absolute positions, you can also use the percentage value, which represents the percentage distance from the right edge of the viewport relative to the viewport's width.
- setBoundsOnlyfinsemble.appd[].manifest.window.setBoundsOnly(boolean)If true, visibility of window is not changed. In other words, a hidden window won't be made visible. Primarily used as an argument to
LauncherClient.showWindow()and related functions. - showfinsemble.appd[].manifest.window.show(boolean)
- showTaskbarIconfinsemble.appd[].manifest.window.showTaskbarIcon(boolean)
- slavefinsemble.appd[].manifest.window.slave(boolean)If true, the new window acts as a slave to the relativeWindow (or the launching window if relativeWindow is not specified). Slave windows automatically close when their parent windows close.
- staggerPixelsfinsemble.appd[].manifest.window.staggerPixels(number)Number of pixels to stagger (default when neither left, right, top or bottom are set).
- topfinsemble.appd[].manifest.window.top(string,number,null)A pixel value that represents the distance from the bottom edge of the viewport as defined by "position". For non-absolute positions, you can also use the percentage value, which represents the percentage distance from the top edge of the viewport relative to the viewport's height.
- toSpawnfinsemble.appd[].manifest.window.toSpawn(array)An array of objects defining the components to spawn. Each entry can either represent a single component in the form
{componentType, spawnOptions}or a tabbed window of components in the form{components, spawnOptions}, wherecomponentsis an array of single component definitions (again in the form{componentType, spawnOptions}). Most arguments that are normally passed toLauncherClient.spawnare supported, although positioning is interpreted as relative to the group's coordinates and dimensions for single components and ignored for tabbed components (as these use the position specified in the group's spawnOptions). Note - This param is taken into account only if the "windowType" param is "launchGroup".[
{
"componentType": "Welcome Component",
"spawnOptions": {
"top": 0,
"left": 0,
"height": 250,
"width": 600,
"data": {}
}
},
{
"components": [
{
"componentType": "Welcome Component",
"spawnOptions": {
"data": {}
}
},
{
"componentType": "ProcessMonitor",
"spawnOptions": {
"data": {}
}
}
],
"spawnOptions": {
"top": 250,
"left": 0,
"height": 250,
"width": 600
}
},
{
"componentType": "Welcome Component",
"spawnOptions": {
"top": 500,
"left": 0,
"height": 200,
"width": 600,
"data": {}
}
},
{
"componentType": "ProcessMonitor",
"spawnOptions": {
"top": 0,
"left": 600,
"height": 700,
"width": 300,
"data": {}
}
}
]- toSpawn[]finsemble.appd[].manifest.window.toSpawn[](object)
- componentsfinsemble.appd[].manifest.window.toSpawn[].components(array)An array of components to spawn as a tabbed group within the launchGroup.
- componentTypefinsemble.appd[].manifest.window.toSpawn[].componentType(string)The name of a component to spawn
- spawnOptionsfinsemble.appd[].manifest.window.toSpawn[].spawnOptions(object)Minimal definition for component spawn options
- datafinsemble.appd[].manifest.window.toSpawn[].spawnOptions.data(object)
- heightfinsemble.appd[].manifest.window.toSpawn[].spawnOptions.height(number,string)
- leftfinsemble.appd[].manifest.window.toSpawn[].spawnOptions.left(number,string)
- topfinsemble.appd[].manifest.window.toSpawn[].spawnOptions.top(number,string)
- widthfinsemble.appd[].manifest.window.toSpawn[].spawnOptions.width(number,string)
- urlfinsemble.appd[].manifest.window.url(string)The URL to load for a web application (i.e. when
windowTypeisundefined, 'WebWindow' or 'application'). - widthfinsemble.appd[].manifest.window.width(number,string)A pixel or percentage value.
- windowTitleBlackListfinsemble.appd[].manifest.window.windowTitleBlackList(string,null)A regular expression-based string specifying window title to exclude from integration, such as splash screens or transient dialogs. Is used only for assimilation window type.
"Opening.*" - windowTitleWhiteListfinsemble.appd[].manifest.window.windowTitleWhiteList(string,null)A regular expression-based string specifying window title to include (finsemblize) in the integration. Is used only for assimilation window type.
".*(Outlook|Today).*" - windowTypefinsemble.appd[].manifest.window.windowType(string)Describes which type of component to spawn.
- WebWindow - A normal HTML window. Requires "url" to be specified.
- assimilation - A window that is managed by the Finsemble assimilation process (usually a native window without source code access). Requires "path" or "alias" to be specified.
- native - A native window that has implemented finsemble.dll. Requires "path" or "alias" to be specified.
- WebApplication - (DEPRECATED) Use WebWindow instead. Requires "url" to be specified.
- launchGroup - A component made of other components, usually grouped together. See toSpawn property.
- Citrix - (EXPERIMENTAL) A virtual app available in your Citrix Workspace app launcher. Requires "alias" to be specified.
"WebWindow"
"assimilation"
"native"
"WebApplication"
"launchGroup"
"Citrix"
"external"
component
foreign
interop
window
- manifestTypefinsemble.appd[].manifestType(string)The type of manifest. This is always equivalent to "finsemble" and can be omitted.
- namefinsemble.appd[].name(string)(required)The name of the app.
- publisherfinsemble.appd[].publisher(string)The name of the organization that publishes the app. Used when picking apps out of third party catalogs.
- releaseNotesfinsemble.appd[].releaseNotes(string)Release notes for this version of the app.
- supportEmailfinsemble.appd[].supportEmail(string)An email address to contact for support with this app.
- tagsfinsemble.appd[].tags(array)A set of searchable tags. Used when picking apps out of an app catalog.
- titlefinsemble.appd[].title(string)A human-readable name that describes the app. The app appears in the launcher menu under this title.
- versionfinsemble.appd[].version(string)The version of the app. This should follow semantic versioning rules.
manifest
finsemble.apps.apps[].hostManifests.Finsemble.component.canMaximize
Replace with: foreign.services.windowService.allowMaximize
(boolean)finsemble.apps.apps[].hostManifests.Finsemble.component.canMinimize
Replace with: foreign.services.windowService.allowMinimize
(boolean)finsemble.apps.apps[].hostManifests.Finsemble.component.enableGrpc
(boolean)Enables GRPC. Can be used from BrowserView based applications. grpc is a global variable available at window.grpc or at fin.grpc. Note: Sandbox is disabled for these applications.
finsemble.apps.apps[].hostManifests.Finsemble.component.neededClients
(array)Clients no longer need to be specified for initialization.
finsemble.apps.apps[].hostManifests.Finsemble.foreign.components.Toolbar.iconURL
Replace with: the 'icons' array at the top level of the AppD entry.
(string)finsemble.apps.apps[].hostManifests.Finsemble.foreign.components.Window Manager.disableBrowserView
Replace with: titlebarType
(booleanfalse)This property is no longer supported and will likely go away in the future. When set to true, the window titlebar is injected directly into the window's content pane, rather than separated out into a separate browserview within the window.
finsemble.apps.apps[].hostManifests.Finsemble.foreign.components.Window Manager.FSBLHeader.title
Replace with: finsemble.componentName.manifest.foreign.components.WindowManager.title or set the title in your HTML and Finsemble will pick it up.
(booleanfalse)Sets the title in the window title bar. This property is no longer supported and will likely go away in the future.
finsemble.apps.apps[].hostManifests.Finsemble.foreign.services.windowService.isArrangable
(boolean)Deprecated as of 3.6
finsemble.apps.apps[].hostManifests.Finsemble.window.alwaysOnTop
(boolean)finsemble.apps.apps[].hostManifests.Finsemble.window.autoShow
(boolean)finsemble.apps.apps[].hostManifests.Finsemble.window.canGroup
Replace with: foreign.services.windowService.allowGrouping
(boolean)finsemble.apps.apps[].hostManifests.Finsemble.window.dockOnSpawn
Replace with: groupOnSpawn
(boolean)If true, automatically docks the window with the "relative" window (dock to the parent window unless specified in params.relativeWindow). Note that you must also position the window in a valid position for docking, for example, by setting the "left" or "top" parameters to "adjacent".
finsemble.apps.apps[].hostManifests.Finsemble.window.options.maximizable
(boolean)finsemble.apps.apps[].hostManifests.Finsemble.window.options.smallWindow
(boolean)finsemble.apps.apps[].hostManifests.Finsemble.window.resizable
(boolean)finsemble.apps.apps[].hostManifests.Finsemble.window.showTaskbarIcon
(boolean)finsemble.apps.apps[].interop.intents.listensFor.listensFor[].displayName
(string)Optional friendly printable name for the intent. To be deprecated in FDC3 2.1 as it is problematic for apps to configure different display names for the same Intent.
finsemble.components.components[].component.canMaximize
Replace with: foreign.services.windowService.allowMaximize
(boolean)finsemble.components.components[].component.canMinimize
Replace with: foreign.services.windowService.allowMinimize
(boolean)finsemble.components.components[].component.enableGrpc
(boolean)Enables GRPC. Can be used from BrowserView based applications. grpc is a global variable available at window.grpc or at fin.grpc. Note: Sandbox is disabled for these applications.
finsemble.components.components[].component.neededClients
(array)Clients no longer need to be specified for initialization.
finsemble.components.components[].foreign.components.Toolbar.iconURL
Replace with: the 'icons' array at the top level of the AppD entry.
(string)finsemble.components.components[].foreign.components.Window Manager.disableBrowserView
Replace with: titlebarType
(booleanfalse)This property is no longer supported and will likely go away in the future. When set to true, the window titlebar is injected directly into the window's content pane, rather than separated out into a separate browserview within the window.
finsemble.components.components[].foreign.components.Window Manager.FSBLHeader.title
Replace with: finsemble.componentName.manifest.foreign.components.WindowManager.title or set the title in your HTML and Finsemble will pick it up.
(booleanfalse)Sets the title in the window title bar. This property is no longer supported and will likely go away in the future.
finsemble.components.components[].foreign.services.windowService.isArrangable
(boolean)Deprecated as of 3.6
finsemble.components.components[].window.alwaysOnTop
(boolean)finsemble.components.components[].window.autoShow
(boolean)finsemble.components.components[].window.canGroup
Replace with: foreign.services.windowService.allowGrouping
(boolean)finsemble.components.components[].window.dockOnSpawn
Replace with: groupOnSpawn
(boolean)If true, automatically docks the window with the "relative" window (dock to the parent window unless specified in params.relativeWindow). Note that you must also position the window in a valid position for docking, for example, by setting the "left" or "top" parameters to "adjacent".
finsemble.components.components[].window.options.maximizable
(boolean)finsemble.components.components[].window.options.smallWindow
(boolean)finsemble.components.components[].window.resizable
(boolean)finsemble.components.components[].window.showTaskbarIcon
(boolean)finsemble.logger.logToDiskLevels
Replace with: finsemble-electron-adapter.logger.logToDiskLevels
()finsemble.notificationURL
(string)The notificationURL is no longer used by toasts or UserNotification. It will likely go away in the future.
finsemble.preferences
Replace with: finsemble.servicesConfig
(object)Configurations used as user preferences can be found in the finsemble.servicesConfig section. This property is no longer supported and will likely go away in the future.
finsemble.router.promptBeforeAllowingExternalApps
(booleanfalse)We deprecated this capability to support freestanding apps.
finsemble.servicesConfig.docking.tabbing.allowEditing
Replace with: servicesConfig.window.allowWindowTitleRenaming
(booleantrue)finsemble.servicesConfig.launcher.defaultPreloads
Replace with: finsemble.extensions.preloads
(object)- defaultPreloadsfinsemble.servicesConfig.launcher.defaultPreloads(object)
- allComponentsfinsemble.servicesConfig.launcher.defaultPreloads.allComponents(array)An array of URLs to preload into all components.
- launchableComponentsfinsemble.servicesConfig.launcher.defaultPreloads.launchableComponents(array)An array of URLs to preload into components that are launchable by the user.
finsemble.servicesConfig.notifications.userPreferences
(object)finsemble-electron-adapter.useDOMBasedMovement
(boolean)Set to false to use native window movement with Electron - which is deprecated due to issues it causes with window Aero Shake and mouse events in draggable regions of windows.
manifest.splashScreenTimeout
(number)Amount of time, in milliseconds, to show the splash screen. The default value 0 causes the splash screen to hide in the user stage. This is after the UI Components have loaded and the same time that Workspace components start loading. If you set it to a negative number, you must call FSBL.System.hideSplashScreen() in a component when you want to hide the splash screen.