Property Bag for Persistence Units and Persistence Unit Collections

This Property Bag provides access to the properties of a persistence unit. An empty Property Bag can be obtained through a call to the CoCreateInstance of the COM API. The client populates a bag and then submits it as a parameter for the Create method of the ISCPersistenceUnitCollection interface. Alternatively, the present state of persistence unit properties can be retrieved through the PropertyBag property of ISCPersistenceUnit. The retrieved value can be reviewed, modified, and submitted back through the PropertyBag property of the same interface. The contents of the bag can have one of two available forms: native format or as a string based on the optional parameter of the PropertyBag property of the ISCPersistenceUnit. The client can populate the bag in either of these two forms. Different forms can be mixed in the same instance of the bag.

Not all properties that exist in the unit have to be present in the bag when it is submitted. All property data as well as property names are validated by the API and either all are accepted or all are rejected. The rejection forces a method call to fail. If the bag includes properties that are read‑only at the moment, for instance, the model type for a erwin DM model when the model was created previously, then such properties are ignored and will not affect validation of the bag data.