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.

Syntaxe

VBScript

entity.GetDuplicates 

Perl

$entity->GetDuplicates(); 
Identificateur
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).
Valeur renvoyée
For Visual Basic, a Variant containing an Array 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.

Exemples

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 an array of 2 Link Objects:

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();

   } 

Commentaires en retour