Dashboard

On new accounts, the whole “back office” is meant to be a collection of GoERP apps. The user logs in and arrives at a dashboard that presents these apps as a grid of icons.

Clicking an icon launches the respective app (and installs it if needed).

To switch to another application, the user needs to return to the dashboard. Therefore, apps must have a “Home” icon or a link labeled as “Switch application” that would let them navigate back.

Dashboard URL

GoERP has a special URL for representing the dashboard; navigating to this URL auto-forwards the user to an actual dashboard page.

The special URL is:

/{clientCode}/{isoLanguageCode}/go-to-landing

Example:

/12345/en/go-to-landing

By default, it redirects to

/{clientCode}/{isoLanguageCode}/start-main

“start-main” is a page from the GoERP app “Start page”. This app gets autoinstalled when needed.

Configuring the URL

The default can be overridden with a CAFA setting:

application: "GOERP"
name: "goerp-redirect-landing-url"

Both level=Company and level=User CAFA settings are respected; therefore it is possible to create this config as either a user preference (level=User, level_id=<user's ID>) or an accountwide setting (level=Company).

The value of the CAFA setting must be a string. The following placeholders are supported:

  1. {GOERP_URL} - GoERP server root URL (for example https://template-engine-example.erply.com/)
  2. {ERPLY_BO_URL} - Back office root URL (for example https://example.erply.com)
  3. {CLIENTCODE} - Account number
  4. {ISO_LANG} - Current language, two-letter ISO code (for example en)
  5. {LEGACY_LANG} - Current language, three-letter code (for example eng)

Sample value (GoERP):

{GOERP_URL}/{CLIENTCODE}/{ISO_LANG}/some-page

Resolves to:

https://template-engine-example.erply.com/12345/en/some-page

Sample value (back office):

{ERPLY_BO_URL}/{CLIENTCODE}?lang={LEGACY_LANG}

Resolves to:

https://example.erply.com/12345?lang=eng