Add an eSpace Reference

The Add/Remove References window allows you to add references to public elements of Producers (eSpace or Extension that owns an element and exposes it for the use of other eSpaces, thus called Consumers) to your eSpace.

You may only add public elements of those Producers you have access to.

How to Add a Reference:

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

Select the Producer on the left pane. All the public elements exposed by the selected producer are displayed on the right pane.

On the right pane, check which public elements you want to add as references to your eSpace.

If you want to add as references all the public elements of a Producer, simply right-click on the Producer name, in the left pane, and select the "Add all public elements" operation. All the elements in the right pane will be checked.

Press the Ok button and all the references you have checked are automatically added to your eSpace.

After adding a reference to your eSpace, you can use it as if that element was owned by your eSpace but you cannot change its definition.

Any element added as reference to your eSpace, has its parent element automatically added as reference, as well. For example, if a web screen reference is added, its parent screen flow is also automatically added as a reference and placed in the Screen Flows folder of the eSpace tree. However, if any name clashing arises, the referenced element is automatically renamed.

Dependencies of a Reference

When you check a public element, in the Add/Remove References window, Service Studio automatically check all the dependent elements, in the right-pane. For example, suppose, you want to use the Pop3GetMails action of the RichMail extension. When you add this action, Pop3Mail and Pop3Attachments structures are automatically checked because the input arguments of this action are records of Pop3Mail and Pop3Attachments.

Likewise, if you un-check one of these dependencies, Service Studio prompts you with a Broken dependencies warning, allowing you to choose an operation that better suits your needs. See how to handle broken dependencies.