Service Studio checks whether there are any modified or missing references when you open your eSpace. If there are any modified or missing references, Service Studio asks if you want to open the Add/Remove References window to manage the modified or missing references.

Modified Reference

A modified reference has one of the following overlays:

Relevant changes are those where the following properties are modified:

How to Resolve a Modified Reference:

  1. In the eSpace menu or on the Toolbar, select the Add/Remove References.

By default, when there is one or more modified producers, the filters are set to 'Show In Use', on the left pane, and 'Show Missing or Modified', on the right pane.

The producers in use are displayed in bold and the modified references are marked with the or icons.

  1. On the right pane, select the modified reference and press the Refresh button. The Refresh operation updates your eSpace with the new definition of the referenced element.

The status of the Producer and reference are afterwards updated.

The Refresh operation is also available when you right-click on the name of the reference .

  1. Press the Ok button and all the refreshed references are automatically updated in your eSpace and their status changed to Refreshed.

If you don't refresh your modified references, a warning message is presented, during the 1-Click Publish.

Missing Reference

A reference is missing when:

 

How to Resolve a Missing Reference:

  1. In the eSpace menu or on the Toolbar, select the Add/Remove References.

By default, when there is one or more modified producers, the filters are set to 'Show In Use', on the left pane, and 'Show Missing or Modified', on the right pane.

The producers in use are displayed in bold and the missing references are marked with the icon.

  1. On the right pane, un-check the missing reference to delete it from your eSpace.

You must be aware of the consequences to your application business logic when a reference is deleted from your eSpace. For that, confirm with the owner of the Producer or with the Service Center administrator that this producer is no longer available or that this referable element was intentionally removed from the public elements. If so, you must change your eSpace logic and replace the referable element by another one or design a new logic from scratch.

  1. Press the Ok button and all the un-selected references are automatically deleted from your eSpace.

If you don't remove the missing references, a warning message is presented during the 1-Click Publish, to avoid any unexpected behaviors that might result from using these references.

Resolve All Modified and Missing References

When a producer is modified or missing, you can solve at once all the modified and missing references, by simply clicking on the Refresh modified and remove missing references.

How to Resolve All the References of a Producer:

  1. In the eSpace menu or on the Toolbar, select the Add/Remove References.

By default, the filters are 'Show In Use', on the left pane, and 'Show Missing or Modified', on the right pane.

The producers in use are displayed in bold. The status of the producer and its references have one of the following icons: modified or missing.

  1. On the left pane, check the name of the producer and press the Refresh modified and remove missing button.

This operation refreshes the definition of the modified references and un-checks the missing ones.

The Refresh modified and remove missing operation is also available when you right-click on the producer's name, either in left or right panes.

  1. Press the Ok button and all the Refreshed references are automatically updated and all the un-selected references are deleted from your eSpace.

What if Modified or Missing References are not Refreshed

You can decide to wait before refreshing your modified or missing references because, for example, the changes in the producer are not yet completed. In this situation, Service Studio presents a warning message during the publication of your eSpace and if you decide to ignore it, you should be aware that some unexpected behaviors might occur:

You may handle any of these exceptions with the AllExceptions Error Handler. See how to handle exceptions.

Finally, you may launch, at any time, the Add/Remove References window and refresh the modified references or remove the missing ones.

See Also

Add/Remove References Window