Glue42 Web
2.20.0Glue42 Web allows JavasScript applications to integrate with other applications that are part of the same Glue42 Core project via a set of APIs. With Glue42 Web you can share data with other applications, expose functionality, manage windows and notifications.
Referencing
Glue42 Web is available both as a single JavaScript file, which you can include in your web applications using a <script> tag, and as a Node.js module:
<script type="text/javascript" src="web.umd.js"></script>
Or:
import GlueWeb from "@glue42/web";
When deploying your application in production, it is recommended to always reference a specific minified version:
<script type="text/javascript" src="web.umd.min.js"></script>
Initialization
Glue42 Web attaches a factory function to the global window object at runtime - GlueWeb(). It can be invoked with an optional configuration object to initialize the library and connect to the Glue42 Core environment. The factory function resolves with the glue API object:
const initializeGlue42 = async () => {
// Initializing the Workspaces library.
const initOptions = {
libraries: [GlueWorkspaces]
};
// Use the object returned from the factory function
// to access the Glue42 APIs.
const glue = await GlueWeb(initOptions);
// Here Glue42 Web is initialized and you can access all Glue42 APIs.
};
initializeGlue42().catch(console.error);
APIobject
Properties
| Property | Type | Default | Required | Description |
|---|---|---|---|---|
| agm | API | Interop library. |
||
| appManager | API | |||
| channels | API | |||
| contexts | API | Contexts library. |
||
| info | object | Info object containing versions of all included libraries and Glue42 itself. |
||
| intents | API | |||
| interop | API | Interop library. |
||
| layouts | API | |||
| notifications | API | |||
| search | Glue42Search | |||
| themes | API | |||
| version | string | Glue42 version. |
||
| webPlatform | Glue42Web | |||
| windows | API | |||
| workspaces | API |
Methods
donemethod
Signature
() => Promise<void>
Description
Disposes Glue42 API. This will remove all Interop methods and streams registered by the application.
feedbackmethod
Signature
(info?: FeedbackInfo) => void
Description
Brings up the Glue42 Desktop feedback dialog.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| info | FeedbackInfo |
Configobject
Properties
| Property | Type | Default | Required | Description |
|---|---|---|---|---|
| contexts | ContextsConfig | Enable, disable and configure the Contexts API. Enabled by default |
||
| exposeGlue | boolean | Configures whether the Glue42 Web will share the initialized API object upon request via a custom web event. Defaults to true. |
||
| intents | Config | |||
| libraries | ((glue: API, config?: Config | Glue42) => Promise<void>)[] | A list of glue libraries which will be initiated internally and provide access to specific functionalities |
||
| notifications | Settings | Configure the system logger. Used mostly for during development. |
||
| systemLogger | SystemLogger | Configure the system logger. Used mostly for during development. |
SystemLoggerobject
Properties
| Property | Type | Default | Required | Description |
|---|---|---|---|---|
| callback | (logInfo: any) => void | |||
| level | Glue42Core |
Glue42WebFactoryFunctionfunction
Signature
(config?: Config) => Promise<API | Glue42>
Description
Factory function that creates a new glue instance. If your application is running in Glue42 Enterprise this will return a Glue42.Glue API, which is a super-set of the Glue42Web API.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| config | Config |