Class %Library.Populate

abstract class %Library.Populate

For details on using this class, see Using the Populate Utility.

%Populate is a utility class that provides the ability to create instances of an object populated with random data.

To use the %Populate class do the following:

Create a persistent object class, such as Employee.
Add %Populate to the end of the class' superclass list:
```
	super = %Persistent,%Populate
```
Save and compile the class.
%Populate will add a class method, Populate(), to your class.

Run this method to create instances of your class in the database:

	Do ##class(Employee).Populate(100)

Inventory

Parameters	Properties	Methods	Queries	Indices	ForeignKeys	Triggers
1		5

Summary

Methods
OnPopulate	Populate	PopulateSerial

Parameters

• parameter POPSPEC;

The POPSPEC parameter provides a way to control how %Populate generates data for properties.
For details, see Using the Populate Utility.

Methods

• abstract method OnPopulate() as %Status

• classmethod Populate(count As %Integer = 10, verbose As %Integer = 0, DeferIndices As %Integer = 1, ByRef objects As %Integer = 0, tune As %Integer = 1, deterministic As %Integer = 0) as %Integer

Creates up to count instances an object and stores them in the database.
If verbose is true, then details are echoed to the console.
If DeferIndices is true, then indices are sorted at the end of the operation.
If objects is true, then each object that is created is returned in the objects array
If tune is true, then $SYSTEM.SQL.TuneTable is called after the instances of the class have been created. If tune>1, then $SYSTEM.SQL.TuneTable is also called for any tables projected by persistent superclasses of this class
If deterministic is true, then the set of objects produced by identical calls to Populate at different times will be identical.
Returns the number of instances successfully created.
For details, see Using the Populate Utility.

• classmethod PopulateSerial() as %String

Create a single instance of a serial object.

Class Reference IRIS for UNIX 2024.1.2
Documentation Search