interopio/finsemble-seed

Finsemble is a smart desktop platform built on Electron. It allows any type of application to integrate visually and logically with other applications. Applications can sync, link, and share information, even if they weren’t originally designed to.

Finsemble Seed 🌱

Note, the finsemble-seed project is intended for developers. If you're looking to get going quickly without any development then contact us to get access to the Finsemble Smart Desktop Designer - a no-code GUI tool for assembling an FDC3 compliant smart desktop. If you are an existing Finsemble client, run yarn sdd to start using the Smart Desktop Designer.

What is the "seed"?

Finsemble is a smart desktop platform. A smart desktop is a desktop based application that is composed from any number of smaller apps, including web, native and Citrix. Finsemble supports the FDC3 1.2 standard for desktop interop.

This repo, the "seed", is an initial empty project for your smart desktop. The seed gives you the ability to launch Finsemble and is the starting point for assembling your smart desktop.

But really, what is it?

• If you're in a hurry, check out our 2 minute intro
• If you're developer and want the nitty-gritty details, check out our talk at CovalenceConf 2020.
• Once you've got the gist, checkout the developer documentation for the full details.

Getting Started

1. 📡 Clone the repository.

   git clone https://github.com/finsemble/finsemble-seed
   

2. 📦 Install npm dependencies

   (Note, we recommend using yarn - it's fast and reliable. But you can also use npm. If using npm you must use a version >= 7.x.x. Lower versions will encounter errors regarding changing folder names with missing permissions)

   cd finsemble-seed
   yarn install
   

3. 🚀 Start Finsemble!

   yarn start
   

Go ahead and take Finsemble for a spin!

When you're ready to go deeper, check out the seed project tutorial, which will walk you through all the basics of building your smart desktop.

What's Inside

The seed project contains configuration and assets that you can customize to create your own smart desktop.

• public - Contains the assets that you will host on your website. These power your smart desktop.

  • assets - CSS and images used to create the smart desktop's look and feel.

  • configs - Configuration for the smart desktop

    • configs/application - Contains all of the base configurations for the Finsemble application.

• project.json - Used to define the development and production server and installer configurations used by the Finsemble application.

The API, please

Everything else there is to know about Finsemble and how to build on it can be found in our developer documentation.

Getting Help

Having trouble? Perhaps we've covered it in the FAQ.

Still having trouble? Shoot us a line at [email protected]! We'll be happy to help.

Prefer the easy-button? Our solutions engineers can integrate your apps together in a POC faster than you can say "Desktop Interop". Schedule a demo!

finsemble-seed's Issues

npm ERR! 404 Not Found: @chartiq/[email protected].*

Since yesterday, this error has been introduced. Occurs when running npm install.

npm ERR! code E404
npm ERR! 404 Not Found: @chartiq/[email protected].*

yarn start failed

When I run yarn start, I found FEA can't be loaded, FEA is undefined and will throw an error when require("finsemble-electron-adapter").

Error in require fea exports: SyntaxError: Unexpected token '.'

I try to delete node_modules and install all packages again, but the issue is still there.

Finsemble 4.1.0 not working when hosted

The latest version doesnt launch when hosted on a server. It works fine when run locally.
Manifest below
{
"devtools_port": 9090,
"startup_app": {
"name": "ChartIQ Local",
"url": "http://qnn:3375/finsemble/services/systemManager/systemManager.html",
"uuid": "Finsemble",
"requireHandshake": true,
"applicationIcon": "http://qnn:3375/assets/img/Finsemble_Taskbar_Icon.png",
"defaultTop": 75,
"defaultLeft": 200,
"defaultHeight": 950,
"defaultWidth": 700,
"showTaskbarIcon": true,
"autoShow": false,
"frame": true,
"resizable": true,
"maximizable": false,
"delay_connection": true,
"contextMenu": true,
"cornerRounding": {
"width": 4,
"height": 4
},
"alwaysOnTop": false
},
"splashScreenImage": "http://qnn:3375/assets/img/pic-icon.png",
"runtime": {
"arguments": "--noerrdialogs --v=4 --no-sandbox --framestrategy=frames --winhttp-proxy-resolver",
"version": "9.61.36.36",
"//": "Add these arguments when diagnosing issues",
"--enable-crash-reporting": "Adding this flag will enable crash reporting to openfin, which has caused memory leaks in some versions.",
"--diagnostics": "Adding this to the runtimeArguments activates verbose logging and crash reporting.",
"--disable-gpu": "This flag disables hardware acceleration. Try this if 'Blank Screen' issues are reported (sometimes on virtual desktops)",
"--winhttp-proxy-resolver": "Chromium v56 contains a bug that in some environments can create a memory leak. The bug is related to the way Chromium handles PAC files."
},
"shortcut": {
"company": "CHartIq",
"description": "ChartIQ Local",
"icon": "http://qnn:3375/assets/img/picss-icon.ico",
"name": "ChartIQ - LOCAL",
"target": [
"desktop",
"start-menu"
],
"force": false,
"startMenuRootFolder": "ChartIQ Local"
},
"dialogSettings": {
"logo": "http://qnn:3375/assets/img/ciq-banner-100x25.png",
"bgColor": 4280109424,
"textColor": 4293521652,
"progressBarBgColor": 4294967295,
"progressBarFillColor": 4282684881,
"progressBarBorderColor": 4293521652
},
"supportInformation": {
"company": "ChartIQ",
"product": "Finsemble Local Demo",
"email": "[email protected]"
},
"fileName": "ChartIQ-local-installer",
"appAssets": [{
"src": "https://assets.finsemble.com/assimilation/assimilation_4.0.0.0.zip",
"version": "4.0.0",
"alias": "assimilation",
"target": "AssimilationMain.exe"
}],
"finsemble": {
"applicationRoot": "http://qnn:3375",
"moduleRoot": "$applicationRoot/finsemble",
"servicesRoot": "$applicationRoot/finsemble/services",
"notificationURL": "$applicationRoot/components/notification/notification.html",
"bootConfig": {
"onErrorMakeSystemManagerVisible": true,
"defaults": {
"startServiceTimeout": 10000,
"startComponentTimeout": 15000,
"startTaskTimeout": 10000
}
},
"importConfig": [
"$applicationRoot/configs/application/config.json"
],
"router": {
"crossDomainTransport": "IPCBus",
"transportSettings": {
"FinsembleTransport": {
"serverAddress": "ws://127.0.0.1:3376"
}
}
}
}
}

What are the tech stacks that are supported by Finsemble Smart Desktop?

Please,

From a quick investigation, it appears that those are the supported UI libraries:

• WEB (SPA, HTML5, anything that runs on a modern Browser)
• Java (JavaFX and Swing, not others)
• .NET (WInforms and WPF

Is that accurate?

What about other systems using C++ + QT for instance? Or Java apps using SWT? Command Line tools?

Any help would be appreciated.

Thanks

Finsemble on Osx is not stable, router and services failing, we had to install parallel and develop on windows.

npm Not Found: @chartiq/finsemble-cli@latest

npm install -g @chartiq/finsemble-cli
npm ERR! code E404
npm ERR! 404 Not Found: @chartiq/finsemble-cli@latest

OSX - npm install fails on finsemble-electron-adapter sub dependency eslint-config-airbnb

The error appears to be due to eslint-config-airbnb's usage of in-publish and eslint-find-rules. On a Mac, we see permission denied when attempting to run these scripts.

I have tried sudo, didn't make a difference. If I get time, I'll look into it further (unless someone fixes before me).

[email protected] prepublish /Users/vivian.farrell/dev/finsemble/finsemble-seed/node_modules/@chartiq/finsemble-electron-adapter/node_modules/@chartiq/eslint-config-chartiq-base/packages/eslint-config-airbnb
(in-install || eslint-find-rules --unused) && (not-in-publish || npm test) && safe-publish-latest

sh: /Users/vivian.farrell/dev/finsemble/finsemble-seed/node_modules/@chartiq/finsemble-electron-adapter/node_modules/@chartiq/eslint-config-chartiq-base/packages/eslint-config-airbnb/node_modules/.bin/in-install: Permission denied
sh: /Users/vivian.farrell/dev/finsemble/finsemble-seed/node_modules/@chartiq/finsemble-electron-adapter/node_modules/@chartiq/eslint-config-chartiq-base/packages/eslint-config-airbnb/node_modules/.bin/eslint-find-rules: Permission denied

fdc3.open should throw AppNotFound when the given app is not in the directory

See: finos/FDC3-conformance-framework#26

The failure occurs because our fdc3.open tests relies on the desktop agent throwing AppNotFound for the given appId. Finsemble throws ErrorOnLaunch instead.

Other than that, great job - 14/15 tests pass 👍

License?

Hi
Trying to find which license Finsamble is released under?
Cheers

global CSS leak in _toolbar.css

https://github.com/ChartIQ/finsemble-seed/blob/4.4.3/assets/css/_toolbar.css#L64

this defines span > svg { } which offsets any such svg icons on the page and interferes with the hosted apps. I know it's deprecated in 5.x but there are still projects tracking 4.x

window.open override causes 404 for font resources

In file nativeOverrides.js > window.open when an underlying application calls window.open within a Finsemble window, the new window is not able to properly load finsemble window font assests:

The fdc3.open function returns a 'error' string rather than an error

If I execute the following:

fdc3.open("NoAppId").catch(e => console.log("type of thrown object", typeof e));

The following is logged:

type of thrown object string

However, the API indicates that:

If opening errors, it returns an Error with a string from the OpenError enumeration.

Notably fd3-electron also has the same issue.

The fdc3 open function throws the wrong error when the application is not found

When executing window.fdc3.open("ThisAppDoesNotExist"), an error should be thrown with the value OpenError.AppNotFound.

However, OpenError.ErrorOnLaunch is thrown instead.

npm install fail

npm ERR! code E404
npm ERR! 404 Not Found: @chartiq/finsemble@alpha