Bosch IoT Insights

White labeling a Bosch IoT Insights project

In Bosch IoT Insights, you can adjust your project in a way that it complies with the corporate design of your company. To do so, we will make some changes in the Admin > Project section.

Prerequisites

  • You are a Manager in your Project.

The content of the White-labeling a Bosch IoT Insights project tutorial is also available as a video here.

images/confluence/download/attachments/2116760111/thumbnail_screencast8-version-1-modificationdate-1672838940000-api-v2.png

This chapter details the following topics:

Basic Settings

In General Settings, you can define the project's label, contact information, the landing page, and upload a logo. For more information, refer to Basic Settings.

Proceed as follows

  1. In the Label field, enter a name for your project.

  2. Click the EN drop-down list and select Add DE: German to add the German equivalent for the label.

  3. In the Contact Link field, enter a link that will be opened when users click the Contact button at the top.

  4. In the Set project landing page drop-down list, select a main menu item that will then always be displayed after you logged in.

  5. Click the Upload Logo button to change the logo displayed at the top left-hand side.

    1. Click the Upload Logo field and select an image.

      The recommended image size is 70px (H) and 100px (W).

      → The image is displayed.

    2. Click the Save button to save the image as logo.
      → The image has been saved as logo.

  6. Click the Save button to save the general project settings.
    → The basic information has been saved.

Footer Settings

In Footer Settings, you can configure and manage the links which are displayed in the footer. For more information, refer to Footer Settings.

Proceed as follows

  1. Click the Add Link button.
    → The Update Link dialog is displayed.

  2. In the Label field, enter a label that will be displayed in the footer.

  3. In the Type drop-down list, select a type.

    • Internal: Enter a URL in the Url field with a relative path to a page within your Bosch IoT Insights project.

    • Dashboard: Select a dashboard that was configured for Views or Overview in the Url drop-down list.

    • Link: Enter a URL to an external website in the Url field.

  4. Click the Save button.
    → The link is immediately added to the footer.

Email Templates

In Email Templates, you can view the existing e-mail templates that are used to communicate with other project members. The e-mail templates can be adjusted by editing the downloaded file and uploading it back to Bosch IoT Insights. For more information, refer to Email Templates.

Proceed as follows

  1. Open the template you want to adjust.
    → The parameters are displayed.

  2. Click the Download button.

  3. Save the file to the desired location.

  4. Edit the file locally by adding and/or removing parameters using your desired editor.

  5. In Admin > Project > Email Templates, click the Upload button to upload the adjusted file.
    → The email template has been updated.

Color Settings

In Styles Settings, you can white-label your project to adjust it to your company's look and feel. For more information, refer to Color Settings.

Proceed as follows

  1. In the Primary Color field, click the hex color code.
    → The color palette is displayed.

  2. Either use the slider to pick a color or enter the hex color code.

  3. Activate the Remove colored strips from header and footer checkbox to remove the supergraphics from the header and the footer.

  4. In the Font drop-down list, select the font for the text elements.

    Keep in mind that in case the user does not have the selected font installed, the browser will fall back to a font family that is available.

  5. In the Chart palette drop-down list, select the color palette for chart elements.

    For the Custom chart palette, enter a comma-separated list of hex color codes, e.g. #899189,#eff7ef,#000, etc.

  6. Click the Save button.
    → The changes to the look and feel of your project have been applied.

Domain

In the domain settings, users can configure a custom domain from which their project is reachable.

Custom domains are exclusively available for paid plans and are subject to billing.

Configuring a custom domain

Follow these steps to configure a custom domain:

  1. Choose between two types of custom domains:

    • Unmanaged: Full SLA monitoring is set up for the given domain to ensure a high SLA.

    • Managed: No monitoring is provided for this domain. No SLA is guaranteed.

  2. Enter Domain Name:

    • Input the domain name without the http prefix (e.g., myowndomain.com).

    • Please ensure the accuracy of the domain name entered to avoid configuration issues.

  3. Save Changes

    • Save the changes to initiate the custom domain configuration process.

    • Once saved, your custom domain request is submitted, and an admin is notified to manually configure your domain.

    • Please note that this process might take a few days.

    • You will be notified once your domain is reachable and configured for your project.

  4. Check Domain Status:

    • The status of your custom domain will be displayed on the domain tab for your reference.

  5. You can now use your custom domain to access your project


Don't forget to configure the custom homepage (next section)


Removing a Custom Domain

If you wish to remove a custom domain from your project, follow these steps:

  1. Press the "Request Deletion" Button:

    • Locate the "Request Deletion" button in the domain settings section.

  2. Confirm Deletion:

    • Upon pressing the "Request Deletion" button, you will be prompted to confirm the deletion action.

    • Confirm your intention to delete the custom domain.

  3. Wait

    • Your domain is now scheduled for deletion. This might take a few days since manual configuration efforts are needed.


Homepage

In the homepage tab, you can configure the landing page that users will see when they access your custom domain.

images/confluence/download/attachments/2116760111/image-2024-2-8_10-16-3-version-1-modificationdate-1707827121000-api-v2.png

Configuration steps

  1. Set Header Text:

    • Define a bold title text that serves as the primary headline visible to users.

  2. Set Description Text:

    • Provide a descriptive text that appears below the header, allowing you to specify what your project is about.

  3. Upload Custom Background Image:

    • Enhance the visual appeal of your landing page by uploading a custom background image. Click the "Upload" button to proceed.

    • Please note that the image size limit is 2MB, and JPEG or WEBP format is recommended.

  4. Save Changes:

    • Press the "Save" button to apply the configured settings to your landing page.


You may also want to customize the project logo and must set your own footer links, to be compliant to legal law.
For these adjustments, please refer to the corresponding sections within this guide.