Using Caché Objects - InterSystems Documentation

where oref is the OREF of the specific object, PropertyName is the name of the property to
associate the data with, and RefId is the ID of the referenced object. For every reference
property there are SetObject (using OID value) and SetObjectId (using ID value) methods.
For example, to assign a particular saved Person object as the owner in a Car object, use the
following code:
Do car.OwnerSetObjectId(PersonId)
where car is the OREF of the Car object and PersonId is the ID of the saved Person object.
10.4.1.2 Modifying Referenced Objects Using Cascading Dot Syntax
Once an object is associated with the reference, the properties within that object can be populated
or modified using cascading dot syntax as follows:
Set oref.PropertyName.RefPropertyName = value
where oref is the OREF of the specific object to associate the data with, PropertyName is the
name of the reference property, RefPropertyName is the name of a data type property within
the referenced object to associate the data with, and value is the actual data. For example, to
set the value of the Name property of a Car object' s Owner property, use the following code:
Set car.Owner.Name = "Doe,Jane"
where car is the OREF of the Car object and “Doe,Jane” is the desired name.
If any of the values referred to within a cascading dot syntax expression is null (""), then the
entire expression evaluates to null. For example:
Set car.Owner = ""
Write car.Owner.Name // prints ""
Modifying Objects
10.4.2 Modifying Embedded Object Properties
The data stored in an embedded object property exists as part of a separate object in memory
but can only be stored as data embedded within a separate, persistent object. There are two
ways to modifying an embedded object property:
• Instantiate a new instance of the embedded object and associate that instance with the
embedded object property.
• Directly create and populate the embedded object property using cascading dot syntax.
Using Caché Objects 73