Upgrade MES ​.NET controls for AVEVA InTouch HMI applications

If your organization is using MES .NET controls in System Platform for InTouch HMI applications, you have to first remove the previous version of the MES .NET controls before upgrading to the current version of the controls.

If you are importing a newer version of the MESControls.aaPKG file that excludes controls that are no longer used (for example, FactMES.Controls.EntityUsageEditor, FactMES.Controls.LaborUsageEditor), the deprecated controls will not be available for use in the System Platform IDE.

1. Perform the MES version upgrade.

2. Open the System Platform IDE and make a list of the MES controls in the toolbox folder that are being used in each galaxy.

3. Delete the MES controls from the toolbox folder in each galaxy.

   The MES .NET control DLLs are removed from the default System Platform application folders in which they were stored. These folders are:

   • \ArchestrA\Framework\Bin

   • \ArchestrA\Framework\FileRepository\<galaxy_name>\Vendors

4. Exit the System Platform IDE.

5. In Windows Explorer, perform a recursive search for the names of the MES .NET controls within the \ArchestrA application folder to make sure that they were deleted.

   For example, if you deleted the SampleViewer control, search for the name of the control, SampleViewer. Each imported control will have a folder with a name in the format Invensys_Systems__Inc__FactMES.Controls.<control_name>.

6. Delete any of the MES .NET control DLL folders that are found in the \ArchestrA application folder but not the DLL files in the \MES\Controls installation folder.

7. Restart the System Platform IDE.

8. Import the MES controls package that was installed with the new release into each galaxy.

   By default, the MES .NET controls are installed in the Controls folder of the MES application folder. All the DLL files present in the MES\Controls directory are enclosed in the MESControls.aaPKG file. You can import individual DLL files or import all the .NET controls into the System Platform IDE by importing the MESControls.aaPKG file.

   For detailed information about importing .NET controls into System Platform IDE, see the MES .NET Controls Developer documentation.

9. If using the MES Stateless or Stateful APIs, reimport these script libraries.

10. Open any graphics that previously contained MES controls that have been removed (for example, Entity Usage Editor or Labor Usage Editor) and delete the no longer available MES .NET controls.