Scanning and fixing problems in the Target configuration

Use the FormSync Scan/Fix forms and objects option to check potentially problematic configurations for errors and inconsistencies that should be fixed before performing an upgrade synchronization.

Note: This procedure applies to both the stand-alone version and form version of FormSync. You can achieve the same results using Command Line Interface (CLI) commands and switches. See Using FormSync with a CLI.

To scan and optionally fix forms and objects before synchronization, perform these steps:

  1. Launch FormSync.
  2. On the FormSync Configurations page, select the Scan/Fix forms and objects option.
  3. From the Target drop-down list, select the configuration to check.
  4. Click OK.
    FormSync opens the Check/Fix Forms and Objects dialog box (in the stand-alone version) or the corresponding form page (in the form version).
  5. From the Fix to apply drop-down list, select one of these options:
    • Check forms - This option simply scans for potential problems and outputs a list of its findings in the text area at the bottom of the dialog/page.
    • Fix forms - This option scans for potential problems and attempts to fix any problems it finds. It then outputs a log of these actions in the text area at the bottom of the dialog/page.
    • Fix ETX - This option scans for misplaced ETX characters in string tables and fixes any errors it finds. It then outputs a log of these actions in the text area at the bottom of the dialog/page.
    • Check Explorer shortcuts - This option checks for shortcut errors in the Explorer.
    • Fix Explorer shortcuts - This option finds shortcut errors in the Explorer and removes shortcuts where the target form does not exist.
  6. Optionally, to filter the results according to the scope of the forms or objects, from the Scope drop-down list, select the scope to filter for:
    • All - FormSync processes all forms and objects that correspond to the selected Fix to apply option.
    • Vendor - FormSync processes only Vendor forms and objects.
    • Non-vendor - FormSync processes all forms and objects EXCEPT those with a scope of Vendor.
    • Site - FormSync processes only those forms and objects that have a scope of Site Default.
    • Group - FormSync processes only those forms and objects that have a scope of Group.
    • User - FormSync processes only those forms and objects that have a scope of User.
  7. Optionally, to have the utility list only the form names (and not all the components on each form as well), select the List form names only option.
    Note: This option is available only for the Check forms and Fix forms options in Step 5.
  8. Optionally, in the Filter field, specify the name (not caption) of a form to process.
    Note: You can specify only form names in this field, one at a time. You can use SQL wild cards, as well as the asterisk (*) as an equivalent of the standard % wild card.
  9. Click Start.
FormSync proceeds to scan the designated forms and objects for problems. If a "Fix" option is selected, it also attempts to fix any problems it finds.

When finished, FormSync outputs a log of all findings and actions to the text area at the bottom of the form. You can copy this output and save it in a text file for further review or action.

Note: If you are using the form version of FormSync, when you are finished with this procedure, to return to the main page of the form, click Close. Do NOT close this page using the X button, as this closes the entire form (unless, of course, you want to close the entire form).