Change record status: 
Project: 
Introduced in branch: 
8.1.x
Introduced in version: 
8.1.0
Description: 

MigrateIdMapInterface::lookupDestinationId() performs a lookup against a migration map table, taking a full source key (all fields specified) and returning a single destination ID array. #2225775: Migrate Drupal 6 core node translation to Drupal 8 requires the ability to specify a partial source key, potentially returning multiple destination IDs. MigrateIdMapInterface::lookupDestinationIds($source_id_values) has been added as a generalization of the former API - it will accept either a partial or complete set of source key fields, returning all matching destination IDs (an array of destination ID arrays). MigrateIdMapInterface::lookupDestinationId() is now implemented as a wrapper for MigrateIdMapInterface::lookupDestinationIds() and is deprecated.

Before

To retrieve a single destination ID from a fully-specified key:

$destination_id = $idmap->lookupDestinationId(['key1' => 'value1', 'key2' => 'value2']);

After

$destination_ids = $idmap->lookupDestinationIds(['key1' => 'value1', 'key2' => 'value2']);
$destination_id = reset($destination_ids);
Impacts: 
Module developers
Updates Done (doc team, etc.)
Online documentation: 
Not done
Theming guide: 
Not done
Module developer documentation: 
Not done
Examples project: 
Not done
Coder Review: 
Not done
Coder Upgrade: 
Not done
Other: 
Other updates done