Working with Entities


Creating a New Entity

New entities can be created via the File > New > Entity menu item. The name you enter can only include a-z, A-Z, 0-9, or "." and must not start with a digit (0-9) or ".".

Start of instruction setTo edit an entity

  • Double click on the entity in Natural Screen Tester Explorer. A single click will display the entity's properties in the Properties area. The description of the entity can be edited in the Properties area.

Start of instruction setTo delete, copy or paste an entity

  • Right-click on the entity in Natural Screen Tester Explorer and choose the relevant option.

Start of instruction setTo locate an entity

  • Right-click on the repository in the Natural Screen Tester Explorer and choose Open Entity....

    Or:
    From the Navigate menu, choose Open Entity.... Use "?" to substitute a single character or "*" to substitute a string.

Creating a New Folder

As a Natural Screen Tester user, you may like to divide test projects into folders according to the specified interests and needs, such as development teams, subprojects etc. The same folder contains different types of entities and subfolders varying according to each test project. This allows you greater flexibility organizing your entities. A new folder can be created via the File>New>Entity>New Folder menu item.

Copying Information from Host Screens

The Designer has built-in access to the host session, this session can be used to make the definition of entities easier. This is achieved using the Session's Copy from session feature. To copy from the session, mark the relevant string of data in the host's screen, and next to the relevant field click the Copy from session icon graphics/capture_flat.gif. The string and/or position are copied.

Copying Entities

Entities can be copied between from folder to folder within an test projects and/or between test projects/servers. This can be performed by dragging and dropping the relevant entity or by using the Copy/Paste actions. When copying between test projects, the pasted entities will be placed in the root node of the repository.

Note:
When coping an entity to a test project that has the same entity name, the existing entity will be overwritten by the new one. The timestamps of the new entity (for example creation and modification date) also overwrite the values of the original entity. These changes take effect immediately, not after reloading the test project.

Opening/Finding a Specific Entity

You can search and open a specific entity in the Editor area by right-clicking on the Repository node and selecting Open Entity (Find).... The search can be filtered by entity and you can determine to search within a specific folder. You can sort the results by created/modified timestamp.

Renaming an Entity

You can rename an test project or entity (though not a field) by selecting it in the Natural Screen Tester Explorer and then either selecting Rename... from the File menu or by right-clicking on the test project/entity and selecting Rename....

Renaming Fields

Field renaming is performed via the Field Mappings tab in the Screen Editor where the relevant field is mapped. Before renaming a field, you may want to see which other entities refer to this field. This is done by clicking on the Find Referring Entities icon next to the Field name field. To rename a field, click on the Edit Entity icon next to the Field name field, and access the field editor. In the field editor click, on the Rename Field button and rename the field.

Note:
A field which does not have references can be edited directly in the Field name field in the screen editor.

Viewing an Entity's References

Natural Screen Tester entities may be interrelated with each other. The Natural Screen Tester Server maintains tables that keep track of entities that refer to other entities. For example, a field entity: the screens it is mapped to, the procedures it is an input or output parameter of, or the paths that employ it as an input / setting variable / test by field. This feature allows you to keep in check the database and avoid situations in which deleting one entity makes another entity non valid.

Start of instruction setTo view an entity's references

  1. In the Natural Screen Tester Explorer, right-click on the entity and select Find Referring Entities.

    The references are displayed in the reference view. Double-click on an entity to edit it.