To active the /wiki/spaces/EN/pages/98897520 on your app, all the configuration steps described below must completed.
Table of Contents | ||||
---|---|---|---|---|
|
1. Configuring MnoHub!
The app must be connected to a KPI enabled tenant. A KPI enabled tenant with the following metadata attribute:
Code Block language ruby tenant[:metadata][:kpi_enabled] = true
2. Configuring Connec!
A Connec! Webhook needs to be created, this can be done by /wiki/spaces/DEV/pages/90439768 or by directly creating one via the Rails Console (the object name is 'Entity::Webhook'). It
It is important that the Webhook object is configured with the correct tenant / master tenant credentials (as api_key & api_secret)
and the relevant Impac! API endpoint
.
The Webhook must be subscribed to receive
"Journals", but currently the recommended entity subscriptions are "Accounts", "Journals", "Company", "Invoices", "Contacts".
- Setting the Webhook period to 0 will make webhooks run in real-time, which can be handy for development so you don't have to wait 60 seconds for notifications to batch, and be sent.
3. Configuring Impac!
Update your Bolt with the relevant subscribed_entities
Code Block b = Bolt.find(an_id) b.subscribed_entities = ["accounts", "journals", "companies", "invoices", "contacts"]
Pusher (websockets service) & Sparkpost (email delivery service) keys are configured in Impac! API (
config/application.yml
):Code Block SPARKPOST_API_KEY: 'CHANGEME' PUSHER_APP_ID: 'CHANGEME' PUSHER_KEY: 'CHANGEME' PUSHER_SECRET: 'CHANGEME'
Add Maestrano Master Tenant (
SystemIdentity
) credentials to Impac! API (config/application.yml
). This is used as the basic authentication when Impac! queries MnoHub to retrieve KPIs.Code Block ROOT_KEY: YOUR_ROOT_KEY ROOT_SECRET: YOUR_ROOT_SECRET
4. Configuring the Frontend (Express / MnoEnterprise Angular)
- Impac! Angular needs to be provided with a Pusher Key to connect to the Pusher websockets service from the client. There are 2 ways to do this:
MnoEnterprise Angular now provides this automatically to Impac! Angular by passing an environment variable configured in Nex! or the MnoEnterprise Express application.
Code Block language ruby impac_pusher_key: PUSHER_KEY
Manually by configuring the Impac! Angular
ImpacLinkingSvc
Code Block language js // Link required and optional data in on sweep. ImpacLinkingSvc.linkData({ user: ..., organizations: ..., pusher_key: 'KEY' }) // OR: ImpacLinkingSvc.linkOptionalData({pusher_key: 'KEY'})
Configured Impac! Angular's Theming Provider, enabling the feature.
Code Block language js options = { dhbKpisConfig: enableKpis: true alertsConfig: enableAlerts: true } ImpacTheming.configure(options)