Web SDK documentation
  1. Classes
  2. ApplicationOptions

File

core/common/ApplicationOptions.ts

Implements

AppOptions

Index

Properties

Properties

Optional alarmsRefreshType
Type : "interval" | "realtime"

Defines the type of refresh mechanism used for alarms in the application.

  • 'realtime': Utilizes a realtime mechanism for updating alarms.
  • 'interval': Utilizes HTTP polling at regular intervals to refresh the alarms.

This setting allows to switch between realtime and interval-based refresh methods.
Optional brandingCssVars
Type : BrandingCssVars

Object with properties that will be converted to CSS custom variables.
Optional brandingEntry
Add your global styles via the angular.json file.

Path to the branding entry file. (Set it to false to disable any styling. You can handle the styling then on your own e.g. in an angular.json file using ng-cli)
Optional brandingPreview
Type : boolean

Enables the branding preview mode. If set to true, the dynamicOptionsUrl will be polled regularly for changes. In case the lastUpdated field of the dynamic options changes, the page is reloaded in order to apply the new branding.
Optional brandingUrl
Type : string

URL to *.css file which will replace default branding.
Optional breadcrumbs
Type : boolean

Enable or disable breadcrumbs in the header for groups and devices (default: false).
Optional companyName
Type : string

Name of company handling support requests from app users (displayed in notification message).
Optional contentSecurityPolicy
Type : string

CSP string to be applied to index.html by replacing default values.
Optional contextHelp
Type : boolean | string

Allows to enable or disable context help, or to override the default base URL used to load its contents. By default, the context help uses the same base URL as defined in the docsBaseUrl option (if this option is undefined, then the following value will be used: https://cumulocity.com/guides/{{version}}). Alternatively, if a string is provided here, it'll be used as the base URL and any {{ version }} placeholder will be replaced with the relevant docs version.
contextPath
Type : string
Optional cookieBanner
Type : CookieBannerConfiguration

Cookie Banner configuration
Optional cookiePreferences
Type : CookiePreferencesConfiguration

Cookie preferences configuration. Here you can enable or disable cookie categories
Optional copy
Type : []

Additional assets to copy to the build output. See https://github.com/webpack-contrib/copy-webpack-plugin for more information about the patterns to add here.
Optional disableOnlyRootsQuery
Type : boolean

By default, cockpit and devicemanagement use the onlyRoots query to resolve root nodes. This could lead to performance issues, if a customer has a lot of root nodes. Therefore you can disable the use of this query with this flag.
Optional disableTracking
Type : boolean

Disable user tracking
Optional docs
Type : Docs

Documentation links settings.
Optional docsBaseUrl
Type : string

Base URL for documentation links (include {{ version }} placeholder, if you want versioned links).
Optional dynamicOptionsUrl
Type : string | boolean

URL to dynamically fetched options. If set to true or left undefined, an URL will be used based on the applications contextPath. If set to false, no dynamic options will be fetched.
Optional enableAllBetaFeatures
Type : boolean

Enables all preview features in the application UI.

Note: This only affects features on the frontend. If a preview feature also requires backend support it must be enabled separately on the backend.
Optional entryModule
Type : string

Entry module for Angular compiler (only used with lazy loaded routes), e.g. 'app.module.ts#AppModule'.
Optional exports
Type : PluginsExports[]

NgModule export for plugins.
Optional extraCss
Type : string

Stylesheet (CSS) that will be added at runtime. The string should actually contain the CSS not a path or URL to it.
Optional extraCssUrls
Type : string[]

Array of URLs to additional *.css files to be loaded at runtime.
Optional faviconUrl
Type : string

URL to favicon.
Optional forceSetup
Type : boolean

Allows to force showing the setup wizard.
Optional forceUrlRemotes
Type : boolean

If set to true, only remotes defined in the remotes query parameter will be loaded.
Optional gainsightKey
Type : string

A key for the product experience software Gainsight.
Optional globalTitle
Type : string

HTML page title.
Optional guideHrefTemplate
Type : string

URL template for documentation links (default: '${docsBaseUrl}${partialUrl}').
Optional hideBetaPreview
Type : boolean

Hides the beta preview section in the right drawer.
Optional hideHeader
Type : boolean

Hides the header bar
Optional hideNavigator
Type : boolean

Collapse navigator on initial load.
Optional hidePlatformInformation
Type : boolean

Hides the "Platform information" in the right drawer, will overrule the "hidePowered" option
Optional hidePowered
Type : boolean

Hide "powered by" and version info at the bottom of the navigator and in the right drawer.
Optional hideTypeDashboardForAssets
Type : boolean

Hides possibility to create typed dashboards for assets (and groups). If true, typed dashboards can be created only for devices. It is true by default.
Optional i18nExtra
Type : I18nExtra

Allows to add custom translations. It is an optional property.

Its keys are language codes (https://cumulocity.com/guides/users-guide/getting-started/#a-name-languages-a-available-languages) and its values are objects with key-value pairs, where the key is the original string in English and the value - its translation.

  • Home: "Startseite"

For example you can add the translation of your custom cookie banner configured in the branding settings:

Example :
"i18nExtra": {
  "de": {
    "About cookies on Cumulocity IoT": "Informationen zu Cookies in Cumulocity IoT",
    "Click Agree and Proceed to accept cookies and go directly to the platform or click on Privacy Policy to see detailed descriptions of the used cookies.": "Klicken Sie auf Zustimmen und fortfahren, um Cookies zu akzeptieren und direkt zur Plattform zu gelangen, oder klicken Sie auf Datenschutzrichtlinie, um detaillierte Beschreibungen der verwendeten Cookies anzuzeigen."
  }
}
Optional icon
Type : Icon

Application icon to be displayed in app switcher and header bar.
Optional importMap
Type : literal type

A map of import paths to their corresponding URLs. This is used to resolve module paths when loading remote modules (e.g. in the HTML-Widget). The keys are the import paths and the values are the URLs.

You can also add a js file but need to copy it. Or you can add a node module name but this need to have a single entry point. Otherwise you need to copy the files. A url can also be used but you need to ensure that the CSP rules are not blocking the loading of the file.

Example :

{ 'my-widget': 'https://example.com/path/to/widget.js', 'node-module': '@scope/my-node-module', 'local-js': './my-local-file.js' }

Example :
Optional indexTemplate
Type : string

Path to custom index.html (otherwise default one will be used).
Optional isSetup
Type : boolean

Indicates if the application needs to show the setup wizard.
key
Type : string
Optional label
Type : string

Is used for plugins to indicate their owner. Cumulocity plugins are marked with OFFICIAL label. You can use the special "ARCHIVED" label to mark them as archived.
Optional languages
Type : Languages

Allows for adding or overriding languages available in the application.

Its keys are language codes and its values are objects with the following properties:

  • name: English name of the language,
  • nativeName: native name of the language,
  • url: full URL to JSON file with compiled translations; if not defined, translations will be loaded from ${localePath}/${langCode}.json.

Example:

Example :
"languages": {
  "de": {
    "name": "German",
    "nativeName": "Deutsch",
    "url": "/apps/public/ui-assets/de.json"
  }
}
Optional localePath
Type : string

Path to the folder from which *.po files will be loaded.
Optional loginExtraLink
Type : LoginExtraLink | LoginExtraLink[]

Additional link(s) to display on login screen.
Optional loginRedirectPath
Type : string

Defines to which path the user will be redirected in case he is not logged in yet.

This needs to be used for e.g. people who embed the application in an iframe in order to redirect to a none index.html file.
Optional mapConfig
Type : MapDefaultConfig

Allows to set default configurations on the maps.
Optional mapLayers
Type : MapTileLayer[]

Allows to set the map layers. If not set, defaults to open street map layer.
Optional mapNominatimUrl
Type : string

The URL used to lookup geo coordinates for a user provided address via nominatim API. Can be set to empty to disable the find address feature on the location tab. Uses: https://nominatim.openstreetmap.org/search?format=json&q={searchTerm} if not set.
Optional mapWidgetHideMaxDeviceOnMapHint
Type : boolean

Allows to hide the hint that there are more devices with geo coordinates then displayed on the map widget and maps in general.
Optional mapWidgetPageSize
Type : number

Allows to adjust the default pagesize of 100 items of the map widget and maps in general.
Optional mapWidgetRealtimeDisabled
Type : boolean

Disables realtime updates on the map widget and maps in general.
Optional messageBanner
Type : MessageBannerConfiguration

Message Banner configuration
name
Type : string
Optional newsletter
Type : boolean

Show or hide a newsletter subscription checkbox in edit user modal.
Optional noAppSwitcher
Type : boolean

Hide application in app switcher (saved to the server).
Optional noLogin
Type : boolean

By default a WebSDK app requires the user to be logged in. In case you would like to develop just a static application, that does not require any kind of access to the backend, you can use this flag to disable the login screen. NOTE: not all WebSDK components support this, some might require the user to be logged in and won't work.
Optional noPlugins
Type : boolean

Allows to opt out of supporting/loading plugins for this application.
Optional noVersionWarning
Type : boolean

Allows to opt out of the version warning which is shown in the dev tools.
Optional remotes
Type : RemotePlugins

List of imported remote plugins.
Optional rightDrawer
Type : boolean

Enable or disable the right drawer.
Optional rootNodeModulesPath
Type : string

Path to the root node_modules dir (useful when working in monorepo setup, e.g. yarn workspaces).
Optional rootTagName
Type : string

The name of the root element. By default c8y-bootstrap.
Optional sensorPhone
Type : boolean

Enables cloud sensor wizard
Optional source
Type : string | number | IApplication

The package source a application origins from as IApplication or simply the id of the source
Optional storageLimitationFeatureEnabled
Type : boolean

Enable or disable storage limitation feature.
Optional supportUrl
Type : boolean | string

URL to support page (set to false to hide the link).
Optional supportUserString
Type : string

Replacement string for user field in audit logs for actions performed by a support user (available placeholders: {{support_user}}, {{supported_user}}).
Optional tabsHorizontal
Type : boolean

Show tabs horizontally or vertically.
Optional tsConfigPath
Type : string

Path to tsccnfig.json file if TypeScript is used (default: ./tsconfig.json).
Optional upgrade
Type : boolean

Set to true if the application is hybrid and uses Angular and AngularJS simultaneously.
version
Type : string
Optional versioningMatrix
Type : VersioningMatrix

A matrix of versions indicating which versions of the application (key) are dependent on which version of a cumulocity component (API version and Web SDK version of the shell application currently supported, indicated by the value). The versions of the dependent components can be indicated by a semver range.

Example :
```json
{
 "1.0.0": {
   "sdk": ">=1016.0.0 <1017.0.0",
   "api": ">=1016.0.0 <1017.0.0"
 },
 "2.0.0": {
   "sdk": "~1017.0.0",
   "api": "~1017.0.0"
 },
 "3.0.0": {
   "sdk": ">=1018.0.0",
   "api": ">=1018.0.0"
 },
}
Example :
Optional webSdkVersion
Type : string

results matching ""

    No results matching ""