GetDuplicates

Description

Returns links to the immediate duplicates of this object.

This method returns only immediate duplicates; it does not return duplicates of duplicates. To return all of the duplicates for a given Entity object, including duplicates of duplicates, call the GetAllDuplicates method.

Syntax

VBScript

entity.GetDuplicates 

Perl

$entity->GetDuplicates(); 

Identifier

Description

entity

An Entity object representing a user data record. Inside a hook, if you omit this part of the syntax, the Entity object corresponding to the current data record is assumed (VBScript only).

Return value

For Visual Basic, a Variant containing a List of Link Objects is returned. Each Link object points to a duplicate of this object. If this object has no duplicates, the return value is an Empty Variant. For Perl, a Links Object collection is returned.

Examples

VBScript

In the following example, entity1 is the original object. The objects entity2 and entity3 are duplicates of entity1. In addition, the object entity4 is a duplicate of entity3. Given the following statement:

linkObjs = entity1.GetDuplicates 

The linkObjs variable would be a List of two Link Objects:

• A link between entity1 and entity2
• A link between entity1 and entity3

Perl

$dups = $entity->GetDuplicates();



# Find out how many duplicates there

# are so the for loop can iterate them 

$numdups = $dups->Count();



for ($x = 0; $x < $numdups ; $x++)

   {

   $dupvar = $dups->Item($x);

   $childentity = $dupvar->GetChildEntity();

   }