Updating references to Progress assemblies, including those for OpenEdge Ultra Controls from Infragistics, is easy. This is especially true if you have upgraded to a new version of Progress Developer Studio for OpenEdge, and you simply want to update all references to work with the new version. Note that Progress Developer Studio for OpenEdge offers to perform this update automatically the first time you open a workspace in which it is needed. However, if you decline to perform the automatic update, when you later launch the tool from the OpenEdge menu, all instances of assemblies.xml and toolbox.xml in your current workspace automatically appear in the list of files to be updated, and all of the necessary settings are in place by default.

To update references to Progress controls:

  1. Launch the Update Assembly References tool. In the lower pane, make sure the Progress Assemblies tab is selected.
  2. If you want to keep a pre-update copy of each file, check Back up files before update. Each backup copy will be created in the same directory as the original, with a .bak extension.
    Note: If you launched the tool from Progress Developer Studio for OpenEdge and you just want to update all Progress assembly references to the current version, you can click OK now to complete the operation. Otherwise, continue with step 3.
  3. Select the assemblies.xml and toolbox.xml files to update.
  4. Confirm that the Choose new version field shows the version that you want your assembly references to use. By default, this is the version included with the OpenEdge release you are using. If you also have one or more other versions installed, you can select one of them from the drop-down list in this field.
  5. The left column (Old Assembly Reference) lists all references currently in the selected files. For each reference, the New Assembly Reference column to the right shows the corresponding reference to the version specified in the Choose new version: field. If you want to selectively specify a different version for one or more references, refer to the next step below. Otherwise, to update all references to the selected version, click OK now to complete the operation.
  6. To specify a different version for a reference, click the row in the table, and then click the magnifying glass icon that appears in the Browse column. The Select New Assembly dialog appears and lets you choose any available assembly:
    • On the Global Assemblies tab, you can filter the list by entering an initial string in the Filter field. Click the desired assembly in the list to select it, and click OK to insert the reference.
    • On the Local Assemblies tab, a filtered file browser lets you select any DLL file on your system. Browse to the appropriate directory in the left pane, select the file in the right pane, and click OK to insert the reference.
    Note: If you prefer, you can enter text directly in the New Assembly Version column instead of browsing. However, no validation is performed on the value entered.
  7. After specifying the new assemblies as necessary, click OK to update the references and close the tool. A completion dialog offers the option of restarting Progress Developer Studio for OpenEdge, which is necessary before you can use the new assemblies.