Property Sets

   

 

FinalBuilder Property Sets are a group of values which belong together.  A common use of property sets is to use them for the version information for compilers as the version information consists of a set of integer values, eg. Major, Minor, Release, Build.  In most cases these four values need to be treated as one, eg. Load from INI, apply to compiler, use them to generate a filename, Save to INI.  But in other cases a single property of the property set might be singled out (eg. to increment the Build number).

 

There are a set of actions which deal with Property sets:

PropertySet define

PropertySet load from INI file

PropertySet load from Registry

PropertySet load from FBD

PropertySet save to INI file

PropertySet save to Registry

PropertySet save to FBD

PropertySet increment value

PropertySet log values

PropertySet assign properties

PropertySet to Variable

 

In all cases the property set needs to be defined, so use a PropertySet define action at the start of your build.  Once the PropertySet define action has been added to your build, the other PropertySet actions can access the named property set.

 

A common practise would be to load a property set at the beginning of the build, possibly increment a property, use the property set in various actions, and then at the end of the build save the property set if the build was successfully.  Property sets can be saved and loaded from INI files, the system Registry, or the FBD file.  The values of the Property Set can also be set using hard coded values or FinalBuilder variables by using the PropertySet assign properties action.  A good way to record the values of the property set is to use the PropertySet log values action, which outputs the current values of the property set to the FinalBuilder log.

 

To build up a string value using the different properties of a property set, use the PropertySet to Variable action.  This action allows you to define a prefix, suffix, separator and any of the properties in any order to build up a value which is saved in a FinalBuilder variable.

 

The following PropertySets are always available:

Win32 Version Numbers
Win32 Version Info
.Net Assembly Numbers
.Net Assembly Info

 

Some PropertySet types are registered by certain packages:

 

VisualBasic Package

VisualBasic Version Info
VisualBasic Version Numbers

 

For detailed information on the values of the property sets, see Property Set Definitions

 

PropertySets can also be accessed in Script and any text field of an action that also allows FinalBuilder variables. See Accessing PropertySets for more information.