Using Caché Objects - InterSystems Documentation

The Caché Data Population Utility
Property PropertyName As %String(POPSPEC = "MethodToInvoke()");
where PropertyName is the property for which you are generating data and MethodToInvoke
is the method that Populate will call to generate the data.
For example, to specify that a property is the name of a city in the United States, add the
following POPSPEC parameter value to its definition:
Property City As %String(POPSPEC = "USCity()");
When you run the Populate method, it will invoke the USCity method of the %PopulateUtils
class to generate a random city name for this property.
The value of the POPSPEC parameter is a string specifying a method name in one of the
following ways:
• POPSPEC = “Method()” — Populate invokes the method “Method” from the
%PopulateUtils class.
• POPSPEC = “.Method()” — Populate invokes the method “Method” from the current
object instance (the one being populated).
• POPSPEC = “##class(Class).Method()” — Populate invokes the method “Method”
from the “Class” class.
Where applicable, you can include parameter values within the parentheses following the
method name. If you are specifying a string value, use two pairs (““””) of quotation marks
around the value that you specify.
Property Name As %String(POPSPEC = ".MyName(""X"")");
For example, suppose a class definition contains the following code:
Property PName As %String(POPSPEC = "PName:Name(""F"")");
Property Code As %String(POPSPEC = ".MakeCode()");
Property SSN As %String(POPSPEC = "##class(MyApp.Utils).MakeSSN()");
Property Number As %Integer;
Populate generates values for the PName property by calling the method:
Set .. PName = ##class(%PopulateUtils).Name("F")
Populate generates values for the Code property by calling the local class' MakeCode method:
Set ..Code = obj.MakeCode()
where obj is the current object instance being created. (This assumes that you have defined
a MakeCode method in the class.)
164 Using Caché Objects