Add domain method getIdFieldsByStringField

sfdx-source/apex-extensions/main/default/classes/domains/fflib_SObjects2.cls

@@ -626,6 +626,37 @@ public virtual class fflib_SObjects2
 		return result;
 	}
 
+	/**
+	 * Get a map with the values of an Id field by a String field with a one to many relation
+	 * Key fields containing null values are omitted
+	 *
+	 * @param valueField The Id field to use as the Value of the Map
+	 * @param keyField The String field to use as the Key of the map
+	 *
+	 * @return Returns a map with the values of two fields
+	 *
+	 * @example
+	 * Accounts accounts = Accounts.newInstance(records);
+	 * Map<String, Set<Id>> accountIdsByCountry = accounts.getIdFieldsByStringField(Account.BillingCountry, Account.Id);
+	 */
+	@TestVisible
+	protected virtual Map<String, Set<Id>> getIdFieldsByStringField(Schema.SObjectField valueField, Schema.SObjectField keyField)
+	{
+		Map<String, Set<Id>> result = new Map<String, Set<Id>>();
+		for (SObject record : getRecords())
+		{
+			String keyFieldString = String.valueOf(record.get(keyField));
+			if (keyFieldString == null) continue;
+
+			if (!result.containsKey(keyFieldString))
+			{
+				result.put(keyFieldString, new Set<Id>());
+			}
+			result.get(keyFieldString).add((Id) record.get(valueField));
+		}
+		return result;
+	}
+
 	/**
 	 * @param sObjectField The Schema.SObjectField to get their Id values
 	 * @param criteria The criteria condition that must be met to include the value in the return

sfdx-source/apex-extensions/tests/classes/domains/fflib_SObjects2Test.cls

@@ -105,6 +105,7 @@ private class fflib_SObjects2Test
 		domain.getFieldsByField(Account.Id, Account.AnnualRevenue);
 		domain.getFieldByField(Account.Id, Account.Id);
 		domain.getIdFieldsByIdField(Account.Id, Account.Id);
+		domain.getIdFieldsByStringField(Account.Name, Account.Id);
 		domain.getIdFieldValues(Account.Id);
 		domain.getIdFieldValues(Account.Id, criteria);
 		domain.getDecimalFieldValues(Account.BillingLatitude, criteria);
@@ -116,6 +117,7 @@ private class fflib_SObjects2Test
 		domain.getSObjectsByStringField(Account.Name);
 		domain.getStringFieldByStringField(Account.Name, Account.AccountNumber);
 		domain.getStringFieldValues(Account.Name, criteria);
+		domain.stri
 
 		// todo - add assertions
 	}