One package file may reference another package file in order to incorporate routines and variables from the latter. References to other package files can be added by clicking the Insert Reference icon in the toolbar (see SCRIPTING: Toolbar (PackageFile Editor) ). When inserting a reference, the "Open Package File" dialog will appear. Once the *.epk3 file you want to reference is selected, click the "Open" button. Each reference will appear individually under the References component in the Explorer window. When a reference has been added to the experiment, the References component can be expanded by clicking the "+" icon next to the component, and collapsed by clicking the "-" icon next to the component.
References can be removed by selecting the reference you want to remove in the Explorer window and then clicking the Remove Reference icon in the toolbar.
When adding a package file that includes a reference to another *.epk3 file to an E-Prime experiment, the referenced package files must also be added to that experiment. Take, for example, a package file named "PST" that references another package file named "EP". If the "PST" package file is added to an *.es3 file, the "EP" package must also be added. If the referenced package file has not been added, a warning will be displayed indicating the name of the package that is referenced and must be added. A warning will also be displayed if the referenced package file does not exist on your machine.
Clicking the name of a referenced package file under the References component will open a form interface containing information about the reference. Several properties are also available to specify how the reference will work in the context of the package file that is referencing it.
|Name||The name associated with the referenced package file.|
|GUID||A unique, 32-character, identifier associated with the referenced package file.|
|Position||A property used to specify where the referenced package file should appear in the Add Package dialog within E-Studio relative to the package file referencing it. Possible values are "Before", "After", and "Any" (indicating that the position of the reference in the Add Package dialog is not significant). When adding a package file that references other *.epk3 files, a warning will appear if the referenced package files are not placed in accordance with the Position setting for the reference.|
|Version||The current version number of the referenced package file, separated into Major, Minor, Internal, and Build. By default, this number will be based on the package file selected in the Open Package File dialog when inserting the reference.|
|Version Persist||A number used to determine the minimum version of the referenced package file that must exist on the user’s machine. A warning will appear if the user does not have access to the required version, indicating that the referenced package file must be updated.|
|ForbidVersionPersistP||A number used to determine the maximum version of the referenced package file that can exist on the user’s machine.|
|ForbidVersionPersist Warning||A warning message that should appear if the version persist value of the referenced package file on the user’s machine exceeds the value entered into ForbidVersionPersist.|