Bosch Building Technologies

    cancel
    Showing results for 
    Search instead for 
    Did you mean: 

    Who rated this article

    How to customize the Kiosk with logo on DIVAR IP?

    Rate this article:
    100% helpful (1/1)

    📚 Table of contents

     

    BVMS Desktop screen (BVMS Kiosk screen) has several customization possibilities for introducing a company logo picture and a custom text, as well as selecting if an application icon will appear on the screen or not. 

    Follow this article to see the guidance on how to make these customizations.

     

    Pre-Requisites

     

    • DIP on BVMS Operation Mode 12.1.0 or later

     

     

    Step-by-step guide

     

    1. Log-in to BVRAdmin account as described in the User manual

    2. Go to C:\Program Files\Bosch\SysMgmService\apps\kiosk-mode\current\

    Central_Support_0-1708599611522.png

     

    You will find the following files:

    • BvmsDesktop.exe
    • BvmsDesktop.exe.config
    • System.Management.Automation.dll
    • install.json
    • manifest.json

     

    3. Backup the current Kiosk Mode Configuration file BvmsDesktop.exe.config

    • Save this backup in some safe place (e.g. Documents)
    • ⚠️  It is strongly recommended to do this backup to recover in case of failures

    Central_Support_2-1708599662022.png

     

    4. Start your customization

    4.1. Copy the Logo and the Disclaimer Text in the path as described in the step 2 

    • Ignore these steps in case you don't have this files to apply in the customization
    • Please be aware of the supported types in the customization options
    Central_Support_3-1708599689052.png

     

    4.2. Edit file BvmsDesktop.exe.config using notepad

    Due to security settings of the device, start notepad as administrator

    Central_Support_1-1709567255931.png

     

    In the file filtering option, select "All files" option

    Central_Support_2-1709567294439.png
    Central_Support_4-1708599717861.png

     

    4.3. Change to possible values to apply your customization on BvmsDesktop.exe.config

    • Follow the customization options details to support
    Central_Support_5-1708599764236.pngCentral_Support_6-1708599782531.png

     

    5. Test your customization

    5.1. Right click on BvmsDesktop.exe, and run as Administrator

    • Kiosk Mode will open and you can see the customization result
    • If a black screen appears, it means that the BvmsDesktop.exe.config is broken. Please follow the instructions on point 6.3. (case of mess up)
    • Notice that an introduced misconfiguration could open the doors of the system to be exploited; please change it carefully.
    Central_Support_3-1709567379935.png
    Central_Support_8-1708599830791.png

     

    5.2. Close BvmsDesktop.exe

    5.2.1. Open Task Manager

    Central_Support_9-1708599871570.png

     

    5.2.2. Search for BVMSDesktop Process

    Central_Support_10-1708599918101.png

     

    5.2.3. Right click over the BVMSDesktop Process to open context menu

    5.2.4. Select the option End Task on the context menu

    Central_Support_11-1708599952641.png

     

    5.3. If you need to change again the customization, please repeat starting on point 5.2.

    If you mess up the Kiosk Mode App (black screen), restore by overwrite the BvmsDesktop.exe.config with the backup from step 4 and start again on point 5.2

    • Notice that a introduced misconfiguration could open the doors of the system to be exploited; please change it carefully.
    Central_Support_12-1708600013181.png

     

    6. Customization completed.

    6.1. Sign out from BVRAdmin

    Central_Support_13-1708600044955.png

     

    6.2. To ensure the new configurations are reloaded in the limited user account, sign out from limited user

    The system will automatically sign-in to the Limited User again and will show the current customized Kiosk Mode

    Central_Support_4-1709567459416.png
    Central_Support_14-1708600067513.png

     

    Customization

     

    In short, in the BvmsDesktop.exe.config file we can customize the following components:

    • Logo
    • Disclaimer Info
    • Primary Menu Options
    • Secondary Menu Options

     

    Customization Options 

     

     

    Custom Image Path

     

    • Key: CustomImagePath
    • Default Value: -
    • Possible Values: Full path to the image file
    • Notes: Supported file types: .jpg, .bmp,.tif, .png, .gif
    • Config:
    • Central_Support_15-1708600164602.png

       

    • Preview:
    Central_Support_17-1708600247967.png

     

    Custom Image Ratio Scale

     

    • Key: CustomImageRatioScale
    • Default Value: Medium
    • Possible Values:
      • Small
      • Medium
      • Large
    • Notes:
      • Small > 110x110

        Medium > 200x200

        Large > 256x256

    • Config:

      • Small:
    • Central_Support_18-1708600320978.png

       

      • Medium:
    • Central_Support_19-1708600354517.png

       

      • Large
    • Central_Support_20-1708600383008.png

       

    • Preview:

      • Small:
    • Central_Support_21-1708600443495.png

      • Medium:
    • Central_Support_22-1708600475197.png 

      • Large:
    • Central_Support_23-1708600499863.png

     

    Disclaimer Info

     

    Disclaimer Text

     

    • Key: DisclaimerText
    • Default Value: -
    • Possible Values: Any Text
    • Notes: In this key you should write the Disclaimer Title
      PS: The title only will appears if the CustomTextFile attribute value is filled
    • Config:
    Central_Support_24-1708600575193.png

     

    • Preview:
    Central_Support_25-1708600617589.png

     

    Disclaimer Scale

     

    • Key: DisclaimerScale
    • Default Value: Medium
    • Possible Values:
      • Medium
      • Large
    • Notes: Here is possible to change the font-size of the Disclaimer Title

      Medium > 20 px

      Large > 25 px

    • Config:

      • Medium
    • Central_Support_26-1708600666857.png

       

      • Large
    • Central_Support_27-1708600692862.png

       

    • Preview:

      • Medium
    • Central_Support_28-1708600747875.png

      • Large
    • Central_Support_29-1708600770728.png

       

    Disclaimer Color

     

    • Key: DisclaimerColor
    • Default Value: FFFFFF
    • Possible Values: Hexadecimal Color Code
    • Notes: Here is possible to change the color of the Disclaimer Title

      Use this site to get the right color information: https://www.color-hex.com/

    • Config:
    Central_Support_30-1708601174102.png

     

    • Preview:
    Central_Support_31-1708601201808.png

     

    Custom Text File

     

    • Key: CustomTextFile
    • Default Value: -
    • Possible Values: Full path to the text file
    • Notes: Supported file types: .txt, .rtf
    • Config:
    Central_Support_32-1708601232623.png

    • Preview:
    Central_Support_33-1708601267997.png

     

    Menu Options

     

    Commands White List

     

    • Key: CommandsWhiteList
    • Default Value: -
    • Possible Values: 
      • ConfigurationWizard
      • OperatorClient
      • ConfigurationClient
      • Manager
    • Notes: By default (value empty) all the four options appears.

      This field is used to filter the options that we want to show to the client.

      Example of test (only show the Operator Client):

      • value="OperatorClient"

      PS: The order of display from the options cannot be changed! The order is the same showed in the possible values field

    • Config:
    Central_Support_34-1708601316908.png

     

    • Preview:
    Central_Support_35-1708601364711.png

     

    Primary Menu Options

     

    Primary Commands List

     

    • Key: PrimaryCommandsList
    • Default Value: -
    • Possible Values: 
      • ConfigurationWizard
      • OperatorClient
      • ConfigurationClient
      • Manager
    • Notes: By default (value empty) all the options available appears as primary.

      If we want to show some of the options on the secondary menu we need to define here which ones we want to show in primary.

      The options available not mentioned here will be display in secondary menu.

      Example (show Configurations options as primary and the operator and System Manager as secondary)

      • value="ConfigurationWizard,ConfigurationClient"

      e.g: ConfigurationWizard,ConfigurationClient

      PS: The order of display from the options cannot be changed! The order is the same showed in the possible values field

    • Config:
    Central_Support_36-1708601431431.png

     

    • Preview:
    Central_Support_37-1708601461860.png
     

     

    Primary Commands Ratio Scale

     

    • Key: PrimaryCommandsRatioScale
    • Default Value: Medium
    • Possible Values: 
      • Small
      • Medium
      • Large
    • Notes:

      Small > 60x60

      Medium > 80x80

      Large > 100x100

    • Config:

      • Small:
    • Central_Support_0-1708606936806.png 
      • Medium:
    • Central_Support_1-1708606959370.png 

      • Large:
    • Central_Support_2-1708606986352.png

       

    • Preview:

      • Small
    • Central_Support_3-1708607053762.png

       

      • Medium
    • Central_Support_4-1708607076741.png

       

      • Large
    • Central_Support_5-1708607092880.png

       

    Secondary Menu Options

     

    Secondary Commands Ratio Scale

     

    • Key: SecondaryCommandsRatioScale
    • Default Value: Small
    • Possible Values:
      • Small
      • Medium
    • Notes:

      Small > 60x60

      Medium > 80x80

    • Config:

      • Small
    • Central_Support_6-1708607813040.png

       

      • Medium
    • Central_Support_7-1708607834307.png

       

    • Preview:

      • Small
    • Central_Support_8-1708607910395.png

       

      • Medium
    • Central_Support_9-1708607956762.png

       

    Secondary Commands Disposition

     

    • Key: SecondaryCommandsDisposition
    • Default Value: Horizontal
    • Possible Values: 
      • Horizontal
      • Vertical
    • Notes: The secondary options are display in the right bottom corner.

      With this option you can choose a display in horizontal (below of the disclaimer info) or a vertical display (side by side to disclaimer info)

    • Config:

      • Horizontal
    • Central_Support_10-1708608011763.png 

      • Vertical
    • Central_Support_11-1708608043050.png

       

    • Preview:

      • Horizontal
    • Central_Support_12-1708608081187.png

       

      • Vertical
    • Central_Support_13-1708608107421.png
    Who rated this article
    Icon--AD-black-48x48Icon--address-consumer-data-black-48x48Icon--appointment-black-48x48Icon--back-left-black-48x48Icon--calendar-black-48x48Icon--center-alignedIcon--Checkbox-checkIcon--clock-black-48x48Icon--close-black-48x48Icon--compare-black-48x48Icon--confirmation-black-48x48Icon--dealer-details-black-48x48Icon--delete-black-48x48Icon--delivery-black-48x48Icon--down-black-48x48Icon--download-black-48x48Ic-OverlayAlertIcon--externallink-black-48x48Icon-Filledforward-right_adjustedIcon--grid-view-black-48x48IC_gd_Check-Circle170821_Icons_Community170823_Bosch_Icons170823_Bosch_Icons170821_Icons_CommunityIC-logout170821_Icons_Community170825_Bosch_Icons170821_Icons_CommunityIC-shopping-cart2170821_Icons_CommunityIC-upIC_UserIcon--imageIcon--info-i-black-48x48Icon--left-alignedIcon--Less-minimize-black-48x48Icon-FilledIcon--List-Check-grennIcon--List-Check-blackIcon--List-Cross-blackIcon--list-view-mobile-black-48x48Icon--list-view-black-48x48Icon--More-Maximize-black-48x48Icon--my-product-black-48x48Icon--newsletter-black-48x48Icon--payment-black-48x48Icon--print-black-48x48Icon--promotion-black-48x48Icon--registration-black-48x48Icon--Reset-black-48x48Icon--right-alignedshare-circle1Icon--share-black-48x48Icon--shopping-bag-black-48x48Icon-shopping-cartIcon--start-play-black-48x48Icon--store-locator-black-48x48Ic-OverlayAlertIcon--summary-black-48x48tumblrIcon-FilledvineIc-OverlayAlertwhishlist