Upgrading Connector for System Platform

You can upgrade to AVEVA Work Tasks 2023 R2 Connector for System Platform from the following version:

• AVEVA Work Tasks 2023 Connector for System Platform

Prerequisites

• In the AVEVA Work Tasks server, upgrade AVEVA Work Tasks 2023 to AVEVA Work Tasks 2023 R2.

• Undeploy the Platform and Workflow Gateway Object.

• Upgrade the Connector to the latest version.

Steps to Upgrade

Importing files to System Platform IDE

After installing the Connector for System Platform, you have to import the following files:

• The WorkflowGateway object file, aaPKG or aaPDF

• ArchestrA.InTouch.SkeltaControls.dll to enable workflow features in InTouch HMI

• Script function library (ArchestWorkflowScripts.dll)

• AVEVA Work Tasks controls for InTouch OMI

The aaPKG or aaPDF file saved in the AppObjects folder has to be imported to System Platform IDE. Complete the following steps to import the files:

1. Open System Platform IDE.

2. Select Galaxy menu, select Import, and then select Object(s).

   The Import Automation Object(s) window appears.

3. Go to ArchestrA Installed Path, select Workflow, select AppObjects, and then select the WorkflowGateway_XX.X.aaPKG file.

4. Click Open.

   The Import Preferences window appears.

5. Click OK.

   The status of importing the object appears in the Import Automation Object(s) window.

6. After importing the object completes, click Close.

7. Close the System Platform IDE, and then open it again.

On importing the object to System Platform IDE:

• The following dll files listed are stored in ArchestrA Installation folder > Framework > FileRepository > CustomCategoryUIFiles folder.

  • ArchestrA.Workflow.IDEExtension.dll

  • Skelta.ArchestrA.WinForms.dll

  • Skelta.WinForms.dll

  • Skelta.WinForms.Security.dll

    If these dll files are not added automatically, you must copy the files manually from C:\Program Files (x86)\ArchestrA\Workflow\IDEExtension to:

  • C:\Program Files (x86)\ArchestrA\Framework\FileRepository\CustomCategoryUIFiles

  • C:\Program Files (x86)\ArchestrA\Framework\Bin\IDEExtensions

• Verify whether the files stored in CustomCategoryUIFiles folder are copied to ArchestrA installed path > Framework > Bin >IDEExtensions folder. If not, they can be copied manually. The Workflow tab in System Platform IDE > Workflow - Toolbox tab will not be visible without these DLL files.

• Import ArchestrA.InTouch.SkeltaControls.dll to use additional controls that enables you to use workflow features in InTouch. For information about InTouch Controls, see Workflow Status View Inside InTouch.

• Import Script Function Library (ArchestrAWorkflowScirpts.dll)

  1. Open System Platform IDE.

  2. Select Galaxy menu, select Import, and then select Script Function Library.

     The Import Script Function Library window appears.

  3. Go to ArchestrA Installed Path, select Workflow, and then select Scripts.

  4. Select ArchestrAWorkflowScripts.dll file, and then click Open.

To import ArchestrA App:

8. Open System Platform IDE.

9. Select Galaxy menu, select Import, and then select ArchestrA Apps.

   The Import ArchestrA App dialog box appears.

10. Select the <Installation Path>\ArchestrA\Workflow\InTouchOMI\ folder.

    The imported ArchestrA App appears as AVEVAWorkTasksAppXXX in the Graphic Toolbox.

Note:
- Import the ArchestrA App only once as System Platform IDE allows ArchestrA App imports multiple times by creating multiple objects with an increasing sequence number like AVEVAWorkTasksAppXXX. This may create discrepancy.

- When you upgrade, it will not overwrite/upgrade the existing WorkflowManagementApp and it may create issues related to old and new versions. Hence it is recommended to delete the existing WorkflowManagementApp and then import the new one.
Also, make sure that the older/existing WorkflowManagementApp is not being used in any of the ViewApp/Layout, etc. otherwise, it will cause some warnings in the logger.