ISProvider.GetEntityIdByIdentifier

Description

This function returns the entities of the provider with the specified identifier.

Syntax

object.GetEntityIdByIdentifier(aIdentifier)

Part	Attribute	Type	Description
`object`	Required	ISProvider	The `object` always implements the ISProvider interface
`aIdentifier`	In, Required	string	The entity identifier

Return Value

ISList

Returns the entities of the provider with the specified identifier.

Example

Add two entities with the identifier "My identifier" to the provider. Get the entities with the specified identifier and display their count.

Dim aFilter 
Dim aProviders
Dim aProvider
Dim aEntityCollection
Dim aMessage

Set aFilter = Profile.CreateProvidersFilter

aFilter.Category = 2 'pcProvider  

set aProviders = Profile.LoadProvidersByFilter(aFilter)
aMessage = aMessage & vbNewLine &_
  "The number of the providers is " & aProviders.Count

for each aProvider in aProviders
  aProvider.AddEntityId "My source  1", "My identifier", "My value A"
  aProvider.AddEntityId "My source  2", "My identifier", "My value B"
  aProvider.Save
  
  set aEntityCollection = aProvider.GetEntityIdByIdentifier ("My identifier")
  
  aMessage = aMessage & vbNewLine & aProvider.FullName &_
    " has " & aEntityCollection.Count & " linked entities "
next  
 
Profile.MsgBox (aMessage)

Note:

In Profile Client v8 on User Interface Entity Identifier can be found in Organisation > People&Places > People and Places > Open the selected Provider > Registry > Identifier.

Version information

Added in v7.8.0