External Services

In Menu

To place a link to an external service in the menu, you need to override the settings/ExtraServices.xml file in the XML Manager. There are examples inside the file.

<service authenticate="true" code="report_builder" href="https://whatever/report-builder/init-bs-session">Report Builder</service>
<service authenticate="false" code="weather" href="https://whatever/weather/init-bs-session">Weather</service>
    authenticate(default false): whether the bsauth header will be sent during session initialization
    code: unique code name of the service that will be used in the address bar
    href: absolute path to the service for session initialization

:::note The external service takes on the task of storing the session! :::

UI sends a request to the address specified in the href attribute, then expects a response in the standard format

{
    "status": "ok",
    "timestamp": 1522615252240,
    "data": {
        "redirectTo": "http://whatever..."
    }
}

The service has an iframe at its disposal for the full height of the page