Using Caché Objects - InterSystems Documentation

Using Objects with Caché ObjectScript
Set person.Name = "Doe,Jane"
where person is the OREF of the Person object and “Doe,Jane” is the name you want to
assign to that person.
This general syntax works for any data type property. There is special syntax, described in
the sections below, for:
• reference properties
• embedded object properties
• collections–list properties and array properties
• streams
10.4.1 Modifying Reference Properties
The data stored in a reference property exists as an independent object that can be instantiated
separately from the object containing the reference. To establish the link between the two
objects, the referenced object must be associated with the other object's reference property
through a Caché ObjectScript call (see below). Once this link exists, you can either modify
the referenced object directly or use cascading dot syntax.
10.4.1.1 Associating an Object with a Reference Property
There are two ways to associate an object with a reference property: if the object is in memory,
you can use its OREF, or, if it exists on disk, you can use its object identifier (ID).
For a referenced object in memory, the syntax is:
Set oref.PropertyName = RefOref
where oref is the OREF of the specific object, PropertyName is the name of the property to
associate the data with, and RefOref is OREF of the referenced object. For example, to assign
a particular Person object as the owner in a Car object, use the following code:
Set car.Owner = person
where car is the OREF of the Car object and person is the OREF of the Person object.
If the referenced object has been stored to disk and has an ID value, you can use the following
syntax:
Do oref.PropertyNameSetObjectId(RefId)
72 Using Caché Objects