CiviCRM Community Forums (archive)

I had an API use-case which involved:

1. A list of pre-existing records in a Civi table (civicrm_word_replacement -- aka API entity "WordReplacement")
2. A list of new/updated records to go in the table -- but no ID#s.
3. A business-key I could use to match the new/updated info with the existing info. (The business-key was "domain_id+find_word".)

This would ordinarily be a bit annoying because you need to figure out the ID# for each record by searching on the business-key, and it seemed like a good opportunity to implement a more generic matching feature:

• Wiki: http://wiki.civicrm.org/confluence/display/CRMDOC/API+changes#APIchanges-4.4.0%27create%27and%27replace%27actionsaccept%27options.match%27or%27options.match-mandatory%27
• Wiki: http://wiki.civicrm.org/confluence/display/CRMDOC/API+Reference#APIReference-Options
• JIRA: http://issues.civicrm.org/jira/browse/CRM-13312
• PR: https://github.com/civicrm/civicrm-core/pull/1560