Sets a record set based off of an external search.  Searched results
        provide an overridden entry to the tree widget, by passing the
        grouping mechanism.
        
        :param      records | <orb.RecordSet>
        
        :return     <bool> | records

def setSearchedRecords(self, records):
        """
        Sets a record set based off of an external search.  Searched results
        provide an overridden entry to the tree widget, by passing the
        grouping mechanism.
        
        :param      records | <orb.RecordSet>
        
        :return     <bool> | records
        """
        self._searchTerms = 'EXTERNAL_SEARCH'
        self._currentRecordSet = records
        
        # update widget and notify any listeners
        if not self.signalsBlocked():
            self.refresh()
            self.recordsChanged.emit()
        return True