A complex table change transaction allows
the user to add or edit a complex table record stored on the Agentry
Client. This transaction type is defined to target an object type.
It should, at a minimum, contain a property for the key field of
the table and the properties to target each field to be modified
by the transaction. To allow for the addition of a new record,
it should contain one property for each field in a table
a complex table change transaction is applied, the transaction first
looks for a record in the complex table whose key field value is
equal to the value of the corresponding property in the transaction.
If a match is found, the record is updated with the property values
of the transaction. If no match is found, a new record is added
to the complex table. The indexes of the complex table are then
updated to match the new or modified record.
Complex Table Change Transaction Attributes
are the attributes for a complex table change transaction.
- Type: This
attribute specifies the type of transaction. For complex table transactions
this is set to “Complex Table Change.” This attribute cannot be
changed once the transaction has been defined.
- Object: The Object attribute specifies the type of object
the transaction targets. Though primarily intended to change a complex
table record, this transaction type must still target an object.
- Table: The table attribute specifies the complex table
the transaction targets and that will be changed when the transaction
- Name: This is the identifier for the transaction definition.
This value must be unique among all transaction definitions within
the same module.
- Display Name: The display name is the value shown to
users for the transaction on the Client. This is normally seen by
the user in the Client’s Transmit Screen when an instance of the
transaction is sent to the Agentry
- Key Property: This attribute specifies the property within
the transaction to be treated as the key property. If no change
is made to the targeted object, this attribute need not be set.