DELETELINKS Function (RecordRef)
Deletes all of the links that have been added to a record.
Syntax
RecordRef.DELETELINKS
Parameters
RecordRef
Type: RecordRef
The record in the table where the links should be deleted from.
Example
The following example deletes all links from a customer record in the Customer table. The code starts by opening table 18 (Customer) as a RecordRef variable that is named CustomerRecref. The FIELD Function (RecordRef) creates a FieldRef variable that is named MyFieldRef for the first field in the table (No.). MyFieldRef.VALUE selects record 01121212 from the No. field. This record is initialized in the CustomerNum variable. The FIND Function (RecordRef) searches for record 01121212. If the record is found, the DELETELINKS function deletes all the links in the record. A message that states that the links are deleted is displayed in a message box. You can verify that the links are deleted in the Links FactBox on the Customer List or Customer Card pages. This example requires that you create the following variables and text constants in the C/AL Globals window.
| Variable name | DataType |
|---|---|
| CustomerNum | Integer |
| CustomerRecref | RecordRef |
| MyFieldRef | FieldRef |
| Text constant name | DataType | ENU value |
|---|---|---|
| Text000 | Text | All the links for customer %1 have been deleted. |
| Text001 | Text | The customer cannot be found. |
CustomerNum := '01121212';
CustomerRecref.OPEN(18);
MyFieldRef := CustomerRecref.FIELD(1);
MyFieldRef.VALUE := CustomerNum;
IF CustomerRecref.FIND('=') THEN BEGIN
CustomerRecref.DELETELINKS;
MESSAGE(Text000, CustomerNum);
END
ELSE
MESSAGE(Text001);