Frequently Asked Questions about Custom Properties

How do I handle lists of custom properties programmatically?

All custom properties have a special ".Count" property associated with them.

This property tells you how many instances of a custom property currently exist.  

For example, suppose you have specified a Framework level custom property named STATES where the Administrator could choose one or more states from a fixed list.

To determine how many states were chosen for the current user you do this:  

   Invoke Method(#avFrameworkManager.avGetUserProperty) Atlevel(F)

          Withname(STATES.Count) Numericvalue(#Tot_State)

#Tot_State now contains how many entries are currently in the list of states.

If you then wanted get the state values from the list you might code this:

   Begin_Loop To(#Tot_sTate) Using(#Index)

        Invoke Method(#avFrameworkManager.avGetUserProperty) Atlevel(F)

               Withname(STATES) Instance(#Index) AlphaValue(#State_Code)

        Add_Entry << possibly some user visible list >>


Why are the .COUNT values different by list type?

The .COUNT values returned to your program will vary by the type of custom property and the input method you have specified:

Type Input Method .COUNT Value / Comments


Single Value

Always 1

Alphanumeric, Numeric

List of Values

Always returned as the maximum number of entries allowed in the list. Your program needs to screen out which entries are "null" according to their values returned (e.g. blank or zero values may be considered to be "null" entries within your application). 


List of Values

Not a valid custom property definition. You cannot define this type of custom property. 

Alphanumeric, Numeric

Fixed List

The number of entries actually selected by the administrator (or by default). The default behavior is to select the first entry in the default fixed list specified by the designer.  


Fixed List

Always the maximum number of entries allowed in the fixed list. See next question as well.  



What are Boolean Fixed Lists For?

Boolean fixed lists allow multiple Boolean values to be consolidated into a single custom property. This is often easier and more efficient that coding multiple single Boolean values and it keeps the options together.

For example, imagine you need to store these custom properties:

User is allowed Jump

User is allowed to Hop

User is allowed to Skip

User is allowed to Run

You can do this by defining four Boolean single value properties (e.g. named JUMP, HOP, SKIP and RUN). They would appear to the administrator like this: 

To retrieve these properties programmatically you would do something like this:

   Invoke Method(#avFrameworkManager.avGetUserProperty) Atlevel(F)

          Withname(JUMP) BooleanValue(#CAN_Jump)

   Invoke Method(#avFrameworkManager.avGetUserProperty) Atlevel(F)

          Withname(HOP) BooleanValue(#CAN_Hop)

   Invoke Method(#avFrameworkManager.avGetUserProperty) Atlevel(F)

          Withname(SKIP) BooleanValue(#CAN_Skip)

   Invoke Method(#avFrameworkManager.avGetUserProperty) Atlevel(F)

          Withname(RUN) BooleanValue(#CAN_Run)

You can also do this by using a Boolean fixed list containing 4 entries (e.g. named ACTIONS). This would appear to the administrator like this: 

In this case each entry in the list represents a user state and would be programmatically accessed like this:

     Invoke Method(#avFrameworkManager.avGetUserProperty) Atlevel(F)

          Withname(ACTIONS) Instance(1) BooleanValue(#CAN_Jump)

     Invoke Method(#avFrameworkManager.avGetUserProperty) Atlevel(F)

          Withname(ACTIONS) Instance(2) BooleanValue(#CAN_Hop)

     Invoke Method(#avFrameworkManager.avGetUserProperty) Atlevel(F)

          Withname(ACTIONS) Instance(3) BooleanValue(#CAN_Skip)

     Invoke Method(#avFrameworkManager.avGetUserProperty) Atlevel(F)

          Withname(ACTIONS) Instance(4) BooleanValue(#CAN_Run)

What about Multilingual Systems?

Custom property captions, help text and fixed list user visible captions are all multilingual capable. You should be able to cause all aspects of your custom properties that are visible to administrators to be presented in the correct language by using the normal Framework translation procedures. 

Why aren't property names unique in the Framework?

There are 2 main reasons for this:

My custom property does not seem to have the expected value?

Things that you should check first include: