Project Information

Overview

By executing the Project > Project Information... command, a Project Information object is inserted in the Global node of the Tools tree and the Project Information dialog box opens. It allows you to view and define properties and information on the project file, for example, access attributes, version number, author, and company information as well as statistics concerning the project objects.

File

The File tab displays properties of the project file.

Summary

In the Summary tab of the Project Information dialog box, you can optionally add some information on the project file. This information will be displayed automatically as available Keys in the Properties tab of the Project Information dialog box.

Option Automatically generate 'Project Information' POUs:

If this option is activated, function POUs will be created automatically in the folder Project Information in the Global node of the Tools tree. You can use it to access the project properties values in the application program. Special functions will be created in this case for the properties Company, Title, and Version (GetCompany, GetTitle, GetVersion). For accessing additionally defined properties, a respective function for each property type (GetTextProperty, GetTextProperty2, GetBooleanProperty, GetNumberProperty, GetVersionProperty) will be available. In this case, call the appropriate function, pass the property key as an input, and you will get returned the property value.

Option Automatically generate 'Library Information' POUs:

If this option is activated, function POUs will be created automatically in the folder Library Information in the Global node of the Tools tree. You can use it to access the library properties values in the application program. Special functions GetLibVersion (version number as text string), GetLibVersionNumber (version number as numerical value), and IsLibReleased will be created in this case for the entered properties.

NOTE: If the options are activated, a maximum of 80 characters is allowed for each parameter. Text exceeding this length is truncated.

Example

The following property is defined in the Properties tab:

Key = nProp1

Type = Number

Value = 333

To get the value in the application program, call function GetNumberProperty, for example.

showprop:=GetNumberProperty("nProp1");

showprop must be declared as type DINT in this case.

If you are going to create a library project, refer to the chapter Create Your Own Library in the EcoStruxure Machine Expert Functions and Libraries User Guide.

Properties

The Properties tab of the Project Information dialog box allows you to define keys for some project properties. They can be used in customer-specific external programs later for controlling the respective property.

At least the information defined in the Summary tab of the dialog box will be visible as Key in the Properties table. The properties' names are used as key names, the data type automatically will be Text, and the Value will be the text strings as defined in the Summary tab. Any further keys can be added as desired.

Statistics

The table in the Statistics tab of the Project Information dialog box shows an overview on the objects used in the project: See the total Number of objects on top as well as in the table below the number of objects (Count) per Object type.

Licensing

The Licensing tab is generally not applicable to EcoStruxure Machine Expert controller platforms.

For further information, refer to the License Manager software that is automatically installed with EcoStruxure Machine Expert.

Signing

The Signing tab of the Project Information dialog box allows you to sign your library project with a provider-specific unique key.

Precondition: The key is available in the form of a private key file with extension *.libpk with a corresponding token.

First, activate the option Activate signing; then enter the path of the key file and store the project as compiled library.

The token is displayed in the Library Repository or in the Library Manager in the Details of the library. You can compare it with the token which may have been published by the provider of the library in order to verify whether the library actually is from the desired provider.

If you - as library provider - want to create a new private key file, click the button Create private key file... and select a directory to save it.