SchemaAgent Client offers the Correct reference paths command when you right-click the file with the incorrect reference. This action causes SchemaAgent Client to look for files of the same name in the search path. This is the ideal solution if the ghost file has been moved to another location within the search path. In such cases, SchemaAgent Client lists all the files with the ghost file's name that it finds in the search paths. You can then select the correct path, and this path will be inserted as the reference.
When a reference in a file (that is, either an IIR statement in a schema or a schema specification in an MFD file) points to a file that cannot be found at the location specified, you can use the Correct reference paths command to make SchemaAgent look for a file with a name matching that of the referenced file at other locations in the search path. If one or more matches are found, a dialog box appears displaying the available alternative paths.
In the Correct reference path dialog box, you can expand the individual hits to check if the structure of the found file is really identical with the missing file. The dialog box is resizable so that you can display even very long paths or show complex schemas in detail without having to use the scroll bars.
You can also attempt to correct all incorrect paths in one single step. In this case, SchemaAgent displays a dialog box, where you can choose to correct the path without prompt if only one match is found.
|Note:||The menu option Extras | Correct all reference paths will correct all paths in SchemaAgent independent of the files displayed in a design window. You can also perform this operation with no Design window open.|
When you have started the process, a separate Correct reference path dialog box is displayed for each of the ghost files that are present in the design. If no match is found for a particular ghost file, this is reported in a message box.
To correct a single reference path:
|•||In the Explorer window or in a Design window, right-click a file with an error icon and select Correct reference paths from the context menu, or select the file and press Ctrl+R, or click the Correct reference paths button in the Extras toolbar.|
To correct all reference paths:
|1.||Select the menu option Extras | Correct all reference paths. The Correct all references to non-existing files dialog box opens.|
|2.||Optionally, activate the Don't prompt if only one match found check box if you want paths corrected automatically when only one alternative path is found.|
|3.||Click Start. The Correct reference path dialog box appears for the first ghost file. Do one of the following:|
|•||Select a matching path and click Yes to confirm the correction (a single match will be confirmed automatically without showing the Correct reference path dialog box if the Don't prompt if only one match found check box has been activated).|
|•||Click Yes to All to confirm all single matches without prompting.|
|•||Click Skip to jump to the next ghost file without correcting the current path.|
|•||Click Abort to terminate the process without correcting the remaining paths.|
© 2019 Altova GmbH