Configure Here Core

Here Core is available as Beta, and is only qualified for UAT environments. General Availability and access in Production is planned for March 2025.

Because the Here Core connector is only available as Beta, it currently requires a specific version of the Symphony Desktop App (SDA), and is only supported in environments where Here Core has been switched on. The Beta connector also requires specific configuration.

These limitations will be waived as soon as our connector is generally available.

Some of the configuration steps below will not be required anymore once the Here Core connector is released to production (March 2025)

Install the custom SDA version

• Get in touch with us to get access to the installer, and to get Here Core enabled on your UAT Pod.

• Quit SDA if it is running.

• Launch the new installer. It will uninstall your current SDA version, then install the new version.

Configure the connection to Here Core

Locate the Symphony.json config file on your desktop, by right clicking your Symphony desktop icon and selecting Open file location, then opening the config folder.

Backup the Symphony.config file under a different name, then edit the original file.

Quit SDA if it running. If SDA is configured to hide instead of closing, you can quit SDA but selecting the hamburger menu on the top left then selecting Window, then Quit Symphony Messaging.

Add the following properties:

"openfin": {
        "uuid": "symphony-messaging-app",
        "licenseKey": "TO_BE_REPLACED",
        "runtimeVersion": "TO_BE_REPLACED",
        "autoConnect": true,
        "platformUuid": "TO_BE_REPLACED",
        "connectionTimeout": "10000"
    }

Edit the properties below then save the file:

• uuid: The UUID will be the unique identifier of Symphony on Here Core. You can use the default value or change it based on your preferences.

• licenseKey: Your license key on the Here Core platform.

• runtimeVersion: The runtime version of the Here Core platform that Symphony should connect to.

• autoConnect: Keep to true so that the user doesn't have to manually select Here Core in the Interoperability settings of the Symphony Messaging app.

• platformUuid: Set the uuid of the Here Core platform you want Symphony to connect to.

• connectionTimeout: Timeout in seconds when attempting the connection to Here Core.

Configure your Here Core platform for Symphony

Add the following entry in the apps.json file, to describe the intents that Symphony supports. This way, you will be able to open Symphony directly from the Here Core app launcher.

{
	"appId": "symphony-messaging-app",
	"name": "Symphony",
	"title": "Symphony Messaging",
	"description": "Symphony is the most secure and compliance-enabling markets’ infrastructure and technology platform, where solutions are built or integrated to standardize, automate and innovate financial services workflows. It is a vibrant community of over half a million financial professionals with a trusted directory and serves over 1,000 institutions.",
	"manifest": "C:\\Users\\salah.benmoussati\\AppData\\Local\\Programs\\symphony\\Symphony\\Symphony.exe",
	"manifestType": "external",
	"private": true,
	"autostart": false,
	"instanceMode": "single",
	"icons": [
		{
			"src": "https://symphony.com/wp-content/uploads/2022/12/logo-symphony-dark.svg"
		}
	],
	"contactEmail": "[e-mail]",
	"supportEmail": "[e-mail]",
	"publisher": "Symphony Communication Services, LLC",
	"intents": [
                {
                    "name": "ViewInstrument",
                    "displayName": "View Instrument",
                    "contexts": [
                        "fdc3.instrument"
                    ]
                },
                {
                    "name": "StartChat",
                    "displayName": "Start Chat",
                    "contexts": [
                        "fdc3.chat.initSettings"
                    ]
                },
                {
		    "name": "ViewMessages",
		    "displayName": "View Messages",
		    "contexts": [
		        "fdc3.searchCriteria"
		    ]
		},
		{
		    "name": "SendChatMessage",
		    "displayName": "Send Chat Message",
		    "contexts": [
		        "fdc3.chat.message"
		    ]
		},
		{
		    "name": "ViewChat",
		    "displayName": "View Chat",
		    "contexts": [
		        "fdc3.chat.room", "fdc3.contact", "fdc3.contactList"
		    ]
		}
	],
	"images": [],
	"tags": []
}

Edit the following properties:

• Edit the manifest property to target your symphony.exe.

• The appId should match the uuid defined in your SDA config file.

Launch SDA and target your UAT pod

• Launch the Symphony Desktop App.

• Open the developer tools (Ctrl + Shift + i).

• Open the developer console.

• Type the following line (replacing your UAT pod sub domain where appropriate) then press Enter.

location = "https://UATPODSUBDOMAIN.symphony.com"

This will load the Symphony webapp from your UAT environment, where Here Core has been switched on. You can now close the developer console.

If your Here Core platform is running, you should see a toast notification confirming that Symphony successfully connected to Here Core .

If SDA auto update is enabled in your UAT pod, you may get prompts to install a new SDA version. Don't do it, otherwise you will need to reinstall the SDA installer that embeds Here Core.

If you need help, you can have a look at our Troubleshooting guide.