Skip to content

Customize the OS Bar with "Provider"

Overview of OS Bar

The OS Bar provides the following information:

  • Company and tenant information
  • Application information
  • MindSphere information

The information varies whether you are looking at the OS Bar from the Launchpad or in the application. In order to view the information, click on respective name in the OS bar. The information is displayed as a drop down menu.

Company and tenant information

You can customize the following company information in Settings:

  • Your company logo
  • Your company name
  • Tenant provider links

You can edit the tenant provider links in different languages.
Furthermore, the following information is displayed:

  • Tenant name
  • Tenant type
  • Tenant location

You can specify this information when ordering the tenant. In Settings this information cannot be edited.
The following graphic shows the company and tenant information displayed in the OS Bar:
Tenant information

Application information

The following information is displayed in the application information:

  • Name of the application
  • Version number

Further information can be provided by the developer via Developer Cockpit, for example:

  • Third-Party Software
  • Documentation

Application information cannot be edited via Settings. You can find more information about how to edit the application information in section MindSphere OS Bar in the developer documentation (https://developer.mindsphere.io/resources/resources-mindsphere-osbar.html). The following graphic shows the application information displayed in the OS Bar:
Settings

MindSphere information

The "powered by MindSphere" displays the following general MindSphere information:

  • Current MindSphere version
  • Link to the Store
  • Link to status page with the latest information on updates and maintenance

Tenant-specific adjustments

With the "Provider" function you can customize your tenant by providing basic information about the company. Furthermore, you can define links that provide custom information. Links to custom pages link to the corporate information or the support page of your company. These links can be seen in the OS Bar on the Launchpad. If you do not create your own specifications, the Siemens default information is displayed. With the "Provider" function, you have the option for every tenant to individually configure the following:

  • Contact information
  • Company information
  • Links to additional information
  • Tenant provider links in different languages
  • Regions which contain several countries (only available within an Operator tenant)
  • Basic tenant information

The company-specific links are only visible to users that do not have the TenantAdmin role. Users with the TenantAdmin role continue to see the default information.

Support of multilingualism

Every tenant is assigned to only one country. Nevertheless, users from other countries can access a tenant. Users from other countries usually have their browsers set to the regional language.
The OS Bar of a tenant displays company-specific links. You can configure these links in different languages in the "Provider" function, to support users from other countries. If the set browser language is not configured, the links are shown in the "default" language. You cannot edit or configure the "default" language.
After the configuration of a new language in the "Provider" function, the user sees the companyspecific links in the language set in the browser.

Create regions

Note

The "create regions" functionality is only supported in Operator tenants.

"Provider information" offers the option to configure your own regions. With "Create regions" you can specify links for a certain region with several countries. A region can be, for example, South America. For this region, you can add the respective countries and configure the language of the links as needed. This case occurs when different regions or countries have different legal requirements for links. For example, a tenant in South America can see different information than a tenant in Europe.

User interface "Provider"

The following graphic shows the "Basic information" area within the "Provider" interface:
Provider information ① Delete the provider information
② Shows a preview of the added information
③ Upload or edit your company logo
④ Add or edit your company name

The following graphic shows the "Tenant provider links" area within the "Provider" user interface:
Tenant provider link ① Shows the default language which is adopted from the set browser language as well as the option to add more languages with "Edit language"
② Creates a new bar to add the link details
③ Shows the link parameters and buttons for adjustments
④ Save or cancel settings

The following table shows a description of the link parameters:

Parameter Description
Type Select the link type: E-mail address, Web link, Telephone number
Name Add an individual name for the link.
Value Add a specific value for the link type: E-mail address, for example contact@mindsphere.io; URL, for example https://www.mindsphere.io; Telephone number

Symbols

The following table shows the buttons of the link parameter area:

Symbol Description
url icon Opens the URL to check if it is correct.
email icon Opens your local e-mail client to check if it works.
telephone Opens a telephone app and asks if number shall be called.
downward icon Moves the link downwards.
upward icon Moves the link upwards.
delete icon Deletes the link.

Edit tenant basic information

Procedure

To create the basic information, proceed as follows:

  1. In the navigation area, click "Provider".
  2. Open the area "Basic information".
  3. Upload your company logo as a png, gif or jpg with file size less than 1 MB.
  4. Enter your company name.
    • The changes are saved automatically.
  5. In order to confirm your changes, click the check or press enter.

Result

The "Basic information" area shows a preview of your company logo and company name in the OS Bar. The following graphic shows the result in the OS Bar:
OS Bar

The following example shows how you can define own provider links in Settings.

Example scenario

The MindEdge Corporation, based in Germany, has a tenant with users from Spain. The links in the OS Bar should be displayed in the regional language Spanish for the Spanish users.

Objective

  • The new language "Spanish (es)" should be set.
  • The defined links should be displayed in the OS Bar in Spanish for Spanish users.

Procedure

In order to create a new link for a new language proceed as follows:

  1. In the navigation area, select "Provider".
    • The "Provider information" interface opens.
  2. To open the "Tenant provider links" area, click on plus icon.
  3. Select "Edit languages".
    • The "Edit languages" dialog box opens.
  4. Select the language that need to be configured for the translation of the links and click forward icon,e.g. "Spanish: Castilian".
  5. To save the selected language and close the dialog, click "Save".
  6. In order to create a new link, select the language and click "Create link".
    • A new row with input boxes appears.
  7. Select the type of the link in the "Type" box, for example "www".
  8. Enter an individual name in the "Name" box, e. g. "Spanish support" .
  9. Enter a valid URL in the "Value" box, e. g. "https://www.mindsphere-support.es" .
  10. To test the link, click url-icon.
  11. To save the settings, click "Save".

Result

The new language "es" is displayed in addition to the default language "default":
Edit languages

The new link for a new language Spanish was created in Settings. Spanish users will now see the Spanish link in their Launchpad and will be redirected to the set URL.

Create new regions

Note

The function "create regions" is only available in Operator tenants.

Procedure

To define a new region, proceed as follows:

  1. In the navigation area, click "Provider".
    • The "Provider information" interface opens
  2. To open the "Tenant provider links" area click on plus-icon.
  3. Click on "Create region".
    • The dialog "Create region" opens.
  4. Add an individual region name.
  5. Select the countries from the list "Available countries" as needed.
  6. To assign the countries click forward icon.
  7. To save the configuration click "Create".

Result

The new region has been created.

Any questions left?

Ask the community


Except where otherwise noted, content on this site is licensed under the MindSphere Development License Agreement.


Last update: April 28, 2022