IRelation Interface |
Namespace: SuperOffice.COM.SuperOfficeDB
The IRelation type exposes the following members.
Name | Description | |
---|---|---|
![]() ![]() | ActiveText | ActiveText
The text for the active side of the relation, e.g. SuperOffice ASA owns SuperOffice Sweden AB, then owns is the active text |
![]() ![]() | Changed | has record been changed since read?
If the relation has been modified since it was loaded, this will return false. |
![]() ![]() | Comment | Comment
The relations description textbox - it may contain text describing the relation. Filled out by the user |
![]() ![]() | CreatedAssociate | The user that created the object
The associate that first created the relation |
![]() ![]() | CreatedDate | The date the object was saved to the database.
The date and time the relation was first created |
![]() | ExternalFieldChanged | have external fields been changed? |
![]() ![]() | GroupID | GroupId
This property is currently not in use and will just return 0. |
![]() ![]() | Identity | The primary key on the primary table. Is zero for new objects. Is set when an object is saved.
This is the internal ID of the relation |
![]() ![]() | IsAvailable | is record available in db?
Checks if the record is available in the database. It’s useful to check if a project actually exists before adding new properties to it. |
![]() ![]() | IsRequiredFilled | Are all the required fields filled out? Can we save the record?
Checks if all properties that are required in this model is filled |
![]() ![]() | IsValid | does the record exist?
To save time, we don't load a record into buffer before one of its properties is asked for. This checks if the requested record is available in buffer |
![]() ![]() | PassiveText | PassiveText
The text for the passive side of the relation, e.g. SuperOffice ASA is owned by SuperOffice Sweden AB, then is owned by is the passive text |
![]() ![]() | Reversed | Reversed
This property is currently not in use |
![]() ![]() | Sentry | Sentry settings for this object. Lets you find out your read/write access to the object. |
![]() ![]() | SourceRecord | SourceRecord object
Depending on what type of relation this is, and what SourceTable the relation has, this will return a SOContact object or a SOPerson object |
![]() ![]() | SourceTable | SourceTable - derived from the SourceRecord
This return the Table id (see the database manual) for the source record, either the person table (table id = 6) or the contact table (table id = 5). |
![]() ![]() | TargetRecord | TargetRecord
Depending on what type of relation this is, and what TargetTable the relation has, this will return a SOContact object or a SOPerson object |
![]() ![]() | TargetTable | TargetTable
This return the Table id (see the database manual) for the source record, either the person table (table id = 6) or the contact table (table id = 5). |
![]() ![]() | Type | Type
The relation types internal database id, all definitions are stored in the RelationDefinition table. The id returned is the reldef_id for the ActiveText and PassiveText of a relation. |
![]() ![]() | UpdatedAssociate | The last user to modify the object
The last associate that updated this relation object. If the relation has never been updated, this will return 0 |
![]() ![]() | UpdatedDate | The date of the most recent update.
The date and time the relation was last edited. If the relation has never been updated, this will return 0; formatted as a SuperOffice date (see the database manual), this will return 01.01.1970 |
![]() | ValidationMessage | get validation message, if empty model will think it is ok to save |
Name | Description | |
---|---|---|
![]() ![]() | CancelChanges | Undo any changes made since the object was loaded.
If you made changes to the model that you don't want to be saved to the database, call the CancelChanges method |
![]() ![]() | ChangeIdentity | Loads a different record into the object. Causes changes to the existing object to be saved first.
Saves the changes made to the relation model to the database. The last thing you do to an object if you want the changes you made to be saved. The ChangeIdentity method calls the save method first. |
![]() ![]() | Delete | Delete the object from the database. May throw an error if you are not allowed to delete the object.
Deletes the specified relation model from the database |
![]() ![]() | Save | Persist the object to the database. May throw an error if you are not allowed to save changes to the object.
Saves the changes you made to the project model to the database, does not return the new data from the database. |
![]() ![]() | SetDefaults | Populate the object with default values, such as setting the owner to the current user.
Uses the UserPreferences table to set the predefined default settings for a relation. The SetDefaults method is only available for current objects in this version of SuperOfficeDB Type Library |