Previous Topic: Properties Architecture ImplementationNext Topic: Complex Attribute Types


Properties Architecture Concepts

The DSM Web Service has implemented a distinct method for getting and setting object properties.

When you are creating or retrieving the properties of a DSM object using the web service, you need to make clear to the web service, those properties of the object with which you are currently concerned.

If you are creating or updating a new object, you provide as input a structure that contains a sequence of elements representing object properties whose values you need to populate. The sequence also contains a series of boolean values that indicate the property values you have supplied. Note that if you do not set a property’s matching supplied Boolean flag to true, the DSM web service will ignore the property value that you supplied.

If you are retrieving the properties of a structure, a similar rule applies. You must provide as input to the DSM function a propertiesRequired structure. This structure contains a sequence of boolean flags corresponding to each of the property values contained in the return or output properties structure of the method. For each property whose value you wish to be returned in the output structure, you must set the corresponding boolean flag in the propertiesRequired structure to true. Note that if you do not set a flag to true in the propertiesRequired input structure, the property’s value will not be returned in the output properties structure.