Set up schema files for XML in Visual Studio

Description

When editing the Mobile WMS configuration file, you MUST enable schema validation for your editor.

This guide explains how to enable schema validation and code completion in Visual Studio or VS-Code.

Overview

Visual Studio

You only have to set one setting, to get get Schema support

Go to: Tools > Options > Text Editor > XML > Miscellaneous

and enable Automatically download DTDs and Shemas 

Visual Studio Code

It requires one extension and configuration of user settings in VS Code.

Install and configure Visual Studio Code

Download and install Visual Studio Code (VS Code) here.
Install the extension "XML" by Red Hat" in VS Code.
Press Ctrl + Shift + X to enter the extensions section, and search in the top.

Configure VS Code

Open the properties json file by pressing Ctrl + Shift + P.
Write "Open Settings" and select "Preferences: Open User Settings (JSON)".

Add the following lines to the JSON file:

{
   "files.associations": {
      "application*.cfg": "xml",
      "start*.cfg": "xml"
   },
   "xml.fileAssociations": [
      {
         "systemId": "http://schemas.taskletfactory.com/MobileWMS/Application.xsd",
         "pattern": "application.cfg"
      },
      {
         "systemId": "http://schemas.taskletfactory.com/MobileWMS/Start.xsd",
         "pattern": "start.cfg"
      }
   ]
}

Configuration files

Make sure that application.cfg and start.cfg contains the following headers respectively.

<application xmlns="http://schemas.taskletfactory.com/MobileWMS/Application"
			 xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
			 xsi:schemaLocation="http://schemas.taskletfactory.com/MobileWMS/Application http://schemas.taskletfactory.com/MobileWMS/Application.xsd">

<start xmlns="http://schemas.taskletfactory.com/MobileWMS/Start"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	   xsi:schemaLocation="http://schemas.taskletfactory.com/MobileWMS/Start http://schemas.taskletfactory.com/MobileWMS/Start.xsd"
	   language="en"
	   screenOrientation="Portrait">

Update schema files

As the schema files are downloaded on first use, they may need to be updated from time to time, as more features are added in the configuration.
This is done by deleting the existing schema files in the following directory.

%userprofile%\.lemminx\cache\http\schemas.taskletfactory.com\MobileWMS

Troubleshooting

If the above doesn't work, please restart VS Code.

If it still doesn't work, then an executable file from Red Hat might be blocked by Windows. This can be checked by opening Windows Security and click Virus & threat protection → Protection History to find recent blocks.

If a file from the Red Hat extension has been blocked, it can be unblocked following this guide: (external site)

Typically similar to this Power Shell:

Add-MpPreference -AttackSurfaceReductionOnlyExclusions "%userprofile%\.vscode\extensions\redhat.vscode-xml-0.24.0-win32-x64\server\lemminx-win32.exe"