Using Caché Objects - InterSystems Documentation

Using Objects with Caché ObjectScript
10.4.2.1 Associating an Object with an Embedded Object Property
One way to create an embedded object and populate its properties is to:
1. Instantiate a new instance of the embedded object using the class' %New method.
2. Associate the embedded object's OREF with a container object's property using the following
syntax:
Set oref.PropertyName = EmbeddedOref
where oref is the OREF of the specific object to associate the data with, PropertyName
is the name of the embedded object property, and EmbeddedOref is the OREF of the
object to embed.
3. Populate its properties using the general syntax for setting values.
Note:
Note that you can populate any of an object's properties before associating it with
its container object.
To instantiate a new instance of the embedded object, use its class' method for creating a new
method. For classes that inherit from %Persistent, this is a %New class method. For example,
to create a new Address object, use the following command:
Set address = ##class(Address).%New()
You can then associate it with the Home property of a Person object, use the following code:
Set person.Home = address
where address is the OREF of the new Address object and person is the OREF of the Person
object.
Setting the values for the embedded object's properties then requires only the basic syntax,
such as:
Set person.Home.State = "MA"
10.4.2.2 Modifying Embedded Objects Using Cascading Dot Syntax
You can also set the properties of the embedded object without explicitly instantiating it:
Set oref.PropertyName.EmbPropertyName = value
where oref is the OREF of the specific object to associate the data with,PropertyName is the
name of the embedded object property,EmbPropertyName is the name of the property within
the embedded object to associate the data with, and value is the actual data.
74 Using Caché Objects