Delete Relationships

Delete Relationship Actions are used to delete or recycle existing Relationship Records from one Record to another in whichever Relationship Table is specified.

Explanation

Delete relationship actions are used whenever a relationship record should be deleted or recycled automatically. This is the only way to delete relationship records. A deleted relationship record is removed completely from the application's database and this operation cannot be reversed whereas a recycled relationship record is un-touched except that it's active field is changed to reflect a recycled status. This means that it will not appear in queries that involve the relationship record's table. Recycled relationship records can be restored.

Actions can be attached to a delete relationship action on either the green global automation trigger or the yellow local trigger. Actions on the global trigger will run anytime a relationship record is updated in this relationship table throughout the application, so an evaluation is necessary to ensure that it's only triggered on delete or recycle operations. Actions on the local trigger will run during this delete relationship action only, so no evaluation is required. These actions trigger on the relationship record itself; the builder has the opportunity to retrieve data from the record on either side of the relationship record or the relationship record itself during these Actions. These triggers fire before the relationship record(s) are deleted or recycled to ensure the data is still available for the actions to reference.

Example: The most common use of delete relationship actions is on a link field in the mass action area of a list on a record's view page. Suppose, on a page about an Account, there is a list of related Contacts. A builder might create a “Remove Relation” link in the mass action area of the list. To make this button function properly, edit the actions for the “Remove Relation” button, attach a delete relation action to the “Link is Clicked” automation trigger. Leave the context of the first map inherited, set the second to start from the page items, and then select the Contact to Account relationship table.

Settings

Specify Records to un-relate from each other

When this action runs, it will delete/recycle relationship records between all possible combinations of the records from the first query and the records from the second query in the specified relationship table.

Specify Relationship Table

Select which relationship table to delete/recycle relationship records between the records found by the two queries above.

Delete or Recycle Relationship Records?

Choose whether to delete or recycle the relationship records found.

Disable associated Relationship Actions

Check this box to disable all actions associated with the relationship table the relationship is getting deleted/recycled in. Actions locally associated with this delete relationship action will still run.

Describe this action

Useful as a comment, this description will overwrite the automatically generated description in the Action Manager.

Queue this action and children

When an action is queued, the subsequent actions continue to process without it. Meanwhile, the queued action and its children process separately. Queue actions that you don't want a user to wait for.

action type - delete relationships.txt · Last modified: 2016/09/14 18:19 (external edit)
Copyright WorkXpress, 2024