Using Caché Objects - InterSystems Documentation

There are two types of array properties: arrays of data types and arrays of objects. Arrays of
objects can contain either embedded or persistent objects. These arrays are populated in
similar but slightly different ways.
10.4.4.1 Populating Arrays of Data Types
To add an element to an array of data types use the following syntax:
Do oref.PropertyName.SetAt(data,key)
where oref is the OREF of the specific object to associate the data with, PropertyName is the
name of the list property, data is the actual data, and key is the key associated with the new
element.
For example, to add a new color to an array of RGB values accessed by color name in a
Palette object, use the following code:
Do palette.Colors.SetAt("255,0,0","red")
where palette is the OREF containing the array, Colors is the name of the array property, and
“red” is the key to access the value “255,0,0” .
10.4.4.2 Populating Arrays of Embedded Objects
To add an element to an array of embedded objects, create the new object, populate it, then
use the following syntax to add the object to the array:
Do oref.PropertyName.SetAt(ElementOref,key)
where oref is the OREF of the specific object to associate the data with,PropertyName is the
name of the list property,ElementOref is the OREF of the new element, and key is the key
associated with the new element. For example, to add a vaccination record accessed by date
to a Vaccination array in a Patient object, use the following code:
Do pat.Vaccination.SetAt(vac,"04/08/99")
where pat is the OREF of the Patient object and “04/08/99” is the key to access the Vaccination
object with the OREFvac.
10.4.4.3 Populating Arrays of Persistent Objects
Modifying Objects
The syntax described for populating arrays of embedded objects also applies to arrays of
persistent objects, if the objects are already in memory. In addition, you can populate arrays
of persistent objects with objects that are not in memory. Use the following syntax to add the
object to the array:
Using Caché Objects 79