Troubleshooting Flex Client Issues

Error 102 Connection Refused

When starting Flex desktop app, the following error displays:
ERR_CONNECTION_REFUSED (Code = 102)

This means that the endpoint.json is missing. Do the following:

  1. In the Connection error page, click Configure endpoint.
  2. The Endpoint address page displays.
  3. In SMC, under Websites, select the Flex Client project.
  4. In the Web Applications Details of the Management tab, click Copy URL.
  5. Press Ctrl+V to paste the copied address to the Address field in the Endpoint address page.
  6. Click Save.
  1. The Desigo CC Flex desktop app logon page displays on the screen.

Error 400 Bad Request

When starting Flex desktop app, the following error displays:
Error 400 Bad Request

This might mean, for example, that:

  1. Open Windows Task Manager and stop Flex desktop app.
  2. Go to C:\ProgramData\Siemens-Gms-FlexClient, open the endpoint.json file, set a valid address, and save the changes.
  3. Restart Flex desktop app.

Edit Endpoint Address

If for any reason you need to modify the endpoint address, do the following:

  1. Display the Endpoint address page in one of the following ways:
    • Press CTRL+ALT+SHIFT+E.
    • In the Flex desktop app window, select , and then choose Advanced > Edit endpoint address.
  2. The Endpoint address page displays.
  3. Enter a valid address and select Save.

NOTE: This action is not available for Flex closed mode.

Delete Security Settings

If for any reason you want to allow the possibility to select a client certificate different from the stored one you must first delete the certificate settings as follows:

  1. The client-identification.json is deleted in C:\ProgramData\Siemens-Gms-FlexClient.

Do a Hard Refresh

To manually refresh Flex web/desktop app including cache, proceed as follows:

 

Closed Mode Installation Fails With Error

When trying to set up a closed mode Flex station, the installation fails with the following error:
Cannot be loaded because running scripts is disabled on this system

Do the following:

  1. Run Windows PowerShell as Administrator.
  2. Enter the command: powershell Set-ExecutionPolicy Unrestricted.
  3. Press ENTER.
  4. Run again the executable file Siemens-Gms-FlexClient-Closed-Mode-Installer.exe.

Uninstall Kiosk Mode

If for any reason you need to uninstall Flex closed mode, see the following steps.

  1. You have administrative privileges on the computer where Flex desktop app runs. You want to log on with the Administrator account to access the operating system. For example, for troubleshooting, checking log traces, manually restarting some services, or handling apps.
  1. Switch Windows user:
    • On the keyboard, press Ctrl-Alt-Del.
    • Select the Administrator user and provide the password.
    • Note that you may have to change the language setting to correctly enter the password.
  2. You are logged on to the Flex desktop app with administrator’s credentials.
    NOTE: In case of user’s inactivity, the system automatically starts Flex desktop app.
  3. Open Task Manager, and disconnect the kioskuser.
  4. From Windows Start, select Flex ClosedMode uninstallation.
  5. An elevated command prompt window opens, in which a script runs to uninstall kiosk setup.
  7. When uninstall completes, click Close.
    • If required, you can now proceed to uninstall Flex desktop app.

 

info

By manually removing the provisioning package or the Kiosk user you could still log on to Flex closed mode, but this results in a fatal system error .

Uninstall Flex Desktop App

  1. You have administrative privileges on the computer where Flex desktop app runs.
  2. Flex closed mode has been uninstalled from a computer that runs Flex desktop app.
  1. Open Windows Apps.
  2. From the list of apps found, select Flex Client, click Uninstall, and then follow the instructions in the Uninstall wizard.
  3. To clear the computer completely from any Flex client application files, also delete the Siemens-Gms-FlexClient folders from:
    • C:\Program Files
    • C:\ProgramData

Content with Long URL Not Displaying

Any selection on the Flex client that generates a URL longer than 260 characters may not display in the Flex client due to IIS and Web API character limitations. This can cause links to graphics or trends, for example, to fail, preventing the associated content from being displayed.

Note that some language files may count the characters differently. For example: 14 Chinese (zh_TW or zh_CN) characters are equivalent to 260 characters.

Resolution:

In order to display content from URL links longer than 260 characters, you must manually increase the accepted number of characters in the following: