Back to Community Samples

Evolution entity utility

Description

This utility can be added to the Uniface IDE as a User Defined Worksheet.

It allow the user of the IDE to view all components that use a specific entity. From this utility the components can be opened in the component editor or compiled without opening the component. Also all components can be compiled in one single action. The result of the compile is shown.

The utility also shows all relationships the specific entities has. Regardless if this entity is the one or the many.

How to install?

1. Copy the evo_utilities.uar file to the working directory of your project environment.
2. Modify the assignmentfile of your IDE:
1. add the location of evo_utilities.uar to the [RESOURCES] section;
2. add 'EVO_WSH_ENT' to the IDE_DEFINE_WORKSHEETS_ENT logical.
3. Delete the ide_state.zip file

In my ide.asn this leads to:

[RESOURCES]
evo_utilities.uar

[LOGICALS]
IDE_DEFINE_WORKSHEETS_ENT = EVO_WSH_ENT

How to use this utility?

After installation the entity editor has a new tab: 'Entity utilities'.

As soon as you open an entity in the IDE you should see this tab.

This version of the utility has 3 parts:

1. Header. This part shows some information about the selected entity.
2. Components. Shows all components that use this entity or one of the subtypes of it.
3. Relationships. Shows all relationships that this entity has, regardless the position in this relationship.

Refresh the content

Uniface refreshes the content automatically after a modification in the entity. To make sure to include changes in other components or relationships use the refresh button in the header.

Compile a component

The component can be compiled without opening them. Just push the ‘Compile’ button.

It is also possible to select multiple records. The ‘compile selection’ button will compile all selected records.

The result of the compiler is shown next to the ‘Compile’ button:

• Ok (green background) means the component is compiled without errors
• Error (red background) means the compiler found errors

Opening the component

Just click the ‘Open’ button and the component will be opened in a new editor.

Open the relationship

This utility shows all relationships this entity has.

Just click on the ‘Open relationship’ button to open the relationship in a new editor.

FAQ

I don’t see the tab. What did I do wrong?

It takes just a few steps to install the worksheet, but on every step it can go wrong. Please check:

1. Did you make all the modifications in the correct assignmentfile? Please use the assignmentfile that is mentioned in the shortcut to your IDE.
2. Check the path to the evo_utilities.uar file.
3. Did you add the worksheet to the right logical? It must be added to the IDE_DEFINE_WORKSHEETS_ENT  logical.
4. Did you delete the ide_state.zip file?

I see old info in the utility

Press the ‘refresh’ button in the top on the left.