![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |
A form can refer to model elements in other resources in the Business Studio workspace, for example:Since the referenced model elements reside in independently modifiable files such references are susceptible to breakage if proper working procedures are not observed. When Business Studio detects breakages, it creates unresolved reference problem markers on the referencing forms.
•
• Conversely, retaining the references means that the referencing forms are left pointing at a resource or model element that no longer exists in the workspace, which will cause unresolved reference problem markers to appear.The confirmation dialog presented by Business Studio when any form-referenced resource is deleted can be suppressed by selecting the Do not ask this question again check box on the Clear Forms References dialog.Figure 66 Clear Forms References DialogIf necessary, you can still use the Preview button (as shown in Figure 67) and deselect any Clear forms references to deleted elements changes (as shown in Figure 68).Figure 67 Delete Resources DialogFigure 68 Changes to be Performed OptionsPlease note, whether it is appropriate to clear or retain the references depends on your intentions.
For example - if you move or rename a BOM file that is referenced from another project, this will update all forms references including those in referencing projects. If you then export just the project containing the changed BOM and import it to another workspace, the referencing forms in the target workspace will acquire unresolved reference problem markers because they will still be pointing to the old BOM file name or location.Even so, team members must take care not to do things which affect resources being modified by other team members – if this happens a merge conflict will result. The most reliable way to resolve a merge conflict is the ‘optimistic locking’ approach of rejecting one change set in its entirety then reapplying the rejected changes to the accepted change set. Otherwise, you will be faced with a tricky, error-prone textual merge of complex XML model files.
• Reload the working copy quick fix removes stale unresolved reference problem markers.
• Clear the reference quick fix simply clears the offending reference.
• Repair the reference quick fix helps you to locate a suitable replacement model element.Figure 69 Quick Fix DialogThis quick fix is used to remove the unresolved reference markers that can sometimes linger after the missing resource has been reinstated; this can sometimes happen during project import.This quick fix can be applied to multiple unresolved reference problem markers simultaneously. It simply clears the offending references, which often places the referencing form model into an invalid state that is then reported by other problem markers. Such problems must then be fixed individually from within Form Designer.This quick fix can only be applied to one unresolved reference problem marker at a time. It presents a dialog that lists all the possible model elements that could be used as a replacement for the missing referenced model element.Figure 70 Repair Reference DialogSelecting the desired replacement and pressing the OK button closes the dialog and updates the form to point to the selected element, and the unresolved reference marker goes away. If the chosen item is in an unreferenced project the wizard requests permission to add a project reference.Alternatively, pressing the Clear button closes the dialog and clears the unresolved reference – see the description for the Clear the reference quick fix.
![]() |
Copyright © TIBCO Software Inc. All Rights Reserved |