Finally, for each of the returned invoices, the associated firm is looked up in the id map, and the invoice is added to the cached association array.
The result of this code is that all firms now have all related invoices stored in the associations cache, so calling the invoices method on any of the firms will not cause a database query.