ISExternalProvider.GetEntityIdByIdentifier

Description

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

Syntax

object.GetEntityIdByIdentifier(aIdentifier)

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

Return Value

ISList

Returns the entities of the external provider with the specified identifier.

Example

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

Dim aExtProvider 
Dim aCode
Dim aTr
Dim aEntityCollection
Dim aMessage

aCode = "1"
set aTr = Profile.StartMapTransaction
Set aExtProvider = Profile.LoadExternalProvider(aCode)

if aExtProvider.ID = 0  then 
  Profile.MsgBox("No external provider with the specified code")
  exit sub   
end if

aExtProvider.AddEntityId "My source  1", "My identifier3", "My value A"
aExtProvider.AddEntityId "My source  2", "My identifier3", "My value B"
aExtProvider.Save
aTr.Commit

set aTr = Profile.StartMapTransaction 
set aExtProvider = Profile.LoadExternalProvider(aCode)
set aEntityCollection = aExtProvider.GetEntityIdByIdentifier ("My identifier3")
aMessage = aMessage & vbNewLine & aExtProvider.FullName &_
  " has " & aEntityCollection.Count &_
  " linked entities with the specified identifier "
 
Profile.MsgBox(aMessage)

Note:

In Profile Client v8 on User Interface Entity Identifier can be found in Organisation > External Providers > Basic > Registry.

Version information

Added in v7.8.0