3 +--------------------------------------------------------------------+
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2019 |
7 +--------------------------------------------------------------------+
8 | This file is a part of CiviCRM. |
10 | CiviCRM is free software; you can copy, modify, and distribute it |
11 | under the terms of the GNU Affero General Public License |
12 | Version 3, 19 November 2007 and the CiviCRM Licensing Exception. |
14 | CiviCRM is distributed in the hope that it will be useful, but |
15 | WITHOUT ANY WARRANTY; without even the implied warranty of |
16 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. |
17 | See the GNU Affero General Public License for more details. |
19 | You should have received a copy of the GNU Affero General Public |
20 | License and the CiviCRM Licensing Exception along |
21 | with this program; if not, contact CiviCRM LLC |
22 | at info[AT]civicrm[DOT]org. If you have questions about the |
23 | GNU Affero General Public License or the licensing of CiviCRM, |
24 | see the CiviCRM license FAQ at http://civicrm.org/licensing |
25 +--------------------------------------------------------------------+
31 * @copyright CiviCRM LLC (c) 2004-2019
35 * This class is for activity assignment functions.
37 class CRM_Activity_BAO_ActivityContact
extends CRM_Activity_DAO_ActivityContact
{
42 public function __construct() {
43 parent
::__construct();
47 * Function to add activity contact.
49 * @param array $params
50 * The values for this table: activity id, contact id, record type.
53 * activity_contact object
55 public static function create(&$params) {
56 $activityContact = new CRM_Activity_DAO_ActivityContact();
58 $activityContact->copyValues($params);
59 if (!$activityContact->find(TRUE)) {
60 return $activityContact->save();
62 return $activityContact;
66 * Retrieve names of contact by activity_id.
68 * @param int $activityID
69 * @param int $recordTypeID
70 * @param bool $alsoIDs
74 public static function getNames($activityID, $recordTypeID, $alsoIDs = FALSE) {
78 if (empty($activityID)) {
79 return $alsoIDs ?
array($names, $ids) : $names;
83 SELECT contact_a.id, contact_a.sort_name
84 FROM civicrm_contact contact_a
85 INNER JOIN civicrm_activity_contact ON civicrm_activity_contact.contact_id = contact_a.id
86 WHERE civicrm_activity_contact.activity_id = %1
87 AND civicrm_activity_contact.record_type_id = %2
88 AND contact_a.is_deleted = 0
91 1 => array($activityID, 'Integer'),
92 2 => array($recordTypeID, 'Integer'),
95 $dao = CRM_Core_DAO
::executeQuery($query, $params);
96 while ($dao->fetch()) {
97 $names[$dao->id
] = $dao->sort_name
;
101 return $alsoIDs ?
array($names, $ids) : $names;
105 * Retrieve id of target contact by activity_id.
107 * @param int $activityID
108 * @param int $recordTypeID
112 public static function retrieveContactIdsByActivityId($activityID, $recordTypeID) {
113 $activityContact = array();
114 if (!CRM_Utils_Rule
::positiveInteger($activityID) ||
115 !CRM_Utils_Rule
::positiveInteger($recordTypeID)
117 return $activityContact;
120 $sql = " SELECT contact_id
121 FROM civicrm_activity_contact
122 INNER JOIN civicrm_contact ON contact_id = civicrm_contact.id
123 WHERE activity_id = %1
124 AND record_type_id = %2
125 AND civicrm_contact.is_deleted = 0
128 1 => array($activityID, 'Integer'),
129 2 => array($recordTypeID, 'Integer'),
132 $dao = CRM_Core_DAO
::executeQuery($sql, $params);
133 while ($dao->fetch()) {
134 $activityContact[] = $dao->contact_id
;
136 return $activityContact;
140 * Get the links associate array as defined by the links.ini file.
143 * Should look a bit like
144 * [local_col_name] => "related_tablename:related_col_name"
146 * @see DB_DataObject::getLinks()
147 * @see DB_DataObject::getLink()
150 * array = if there are links defined for this table.
151 * empty array - if there is a links.ini file, but no links on this table
152 * null - if no links.ini exists for this database (hence try auto_links).
154 public function links() {
155 $link = array('activity_id' => 'civicrm_activity:id');