3 * File for the TestCase class
7 * @author Walt Haas <walt@dharmatech.org> (801) 534-1262
8 * @copyright Copyright CiviCRM LLC (C) 2009
9 * @license http://www.fsf.org/licensing/licenses/agpl-3.0.html
10 * GNU Affero General Public License version 3
11 * @version $Id: ActivityTest.php 31254 2010-12-15 10:09:29Z eileen $
14 * This file is part of CiviCRM
16 * CiviCRM is free software; you can redistribute it and/or
17 * modify it under the terms of the GNU Affero General Public License
18 * as published by the Free Software Foundation; either version 3 of
19 * the License, or (at your option) any later version.
21 * CiviCRM is distributed in the hope that it will be useful,
22 * but WITHOUT ANY WARRANTY; without even the implied warranty of
23 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
24 * GNU Affero General Public License for more details.
26 * You should have received a copy of the GNU Affero General Public
27 * License along with this program. If not, see
28 * <http://www.gnu.org/licenses/>.
32 * Include class definitions
34 require_once 'CiviTest/CiviCaseTestCase.php';
37 * Test APIv3 civicrm_case_* functions
39 * @package CiviCRM_APIv3
41 class api_v3_CaseTest
extends CiviCaseTestCase
{
44 protected $_apiversion =3;
45 protected $followup_activity_type_value;
48 * Test setup for every test
50 * Connect to the database, truncate the tables that will be used
51 * and redirect stdin to a temporary file
53 public function setUp() {
54 $this->_entity
= 'case';
58 $activityTypes = $this->callAPISuccess('option_value', 'get', array(
59 'option_group_id' => 2,
60 'name' => 'Follow Up',
61 'label' => 'Follow Up',
64 $this->followup_activity_type_value
= $activityTypes['values'][0]['value'];
66 $this->_params
= array(
67 'case_type_id' => $this->caseTypeId
,
68 'subject' => 'Test case',
74 * check with empty array
76 function testCaseCreateEmpty() {
77 $result = $this->callAPIFailure('case', 'create', array());
81 * check if required fields are not passed
83 function testCaseCreateWithoutRequired() {
85 'subject' => 'this case should fail',
89 $result = $this->callAPIFailure('case', 'create', $params);
93 * Test create function with valid parameters
95 function testCaseCreate() {
97 $params = $this->_params
;
98 // Test using label instead of value
99 unset($params['case_type_id']);
100 $params['case_type'] = $this->caseType
;
101 $result = $this->callAPIAndDocument('case', 'create', $params, __FUNCTION__
, __FILE__
);
105 $result = $this->callAPISuccess('case', 'get', array('id' => $id));
106 $this->assertEquals($result['values'][$id]['id'], $id, 'in line ' . __LINE__
);
107 $this->assertEquals($result['values'][$id]['case_type_id'], $this->caseTypeId
, 'in line ' . __LINE__
);
108 $this->assertEquals($result['values'][$id]['subject'], $params['subject'], 'in line ' . __LINE__
);
112 * Test update (create with id) function with valid parameters
114 function testCaseUpdate() {
116 $params = $this->_params
;
117 // Test using name instead of value
118 unset($params['case_type_id']);
119 $params['case_type'] = $this->caseType
;
120 $result = $this->callAPISuccess('case', 'create', $params);
122 $result = $this->callAPISuccess('case', 'get', array('id' => $id));
123 $case = $result['values'][$id];
126 $params = array('id' => $id);
127 $params['subject'] = $case['subject'] = 'Something Else';
128 $result = $this->callAPISuccess('case', 'create', $params);
130 // Verify that updated case is exactly equal to the original with new subject
131 $result = $this->callAPISuccess('case', 'get', array('case_id' => $id));
132 $this->assertEquals($result['values'][$id], $case, 'in line ' . __LINE__
);
136 * Test delete function with valid parameters
138 function testCaseDelete() {
140 $result = $this->callAPISuccess('case', 'create', $this->_params
);
142 // Move Case to Trash
144 $result = $this->callAPISuccess('case', 'delete', array('id' => $id, 'move_to_trash' => 1));
146 // Check result - also check that 'case_id' works as well as 'id'
147 $result = $this->callAPISuccess('case', 'get', array('case_id' => $id));
148 $this->assertEquals(1, $result['values'][$id]['is_deleted'], 'in line ' . __LINE__
);
150 // Delete Case Permanently - also check that 'case_id' works as well as 'id'
151 $result = $this->callAPISuccess('case', 'delete', array('case_id' => $id));
153 // Check result - case should no longer exist
154 $result = $this->callAPISuccess('case', 'get', array('id' => $id));
155 $this->assertEquals(0, $result['count']);
159 * Test get function based on activity
161 function testCaseGetByActivity() {
163 $result = $this->callAPISuccess('case', 'create', $this->_params
);
166 // Check result - we should get a list of activity ids
167 $result = $this->callAPISuccess('case', 'get', array('id' => $id));
168 $case = $result['values'][$id];
169 $activity = $case['activities'][0];
171 // Fetch case based on an activity id
172 $result = $this->callAPISuccess('case', 'get', array('activity_id' => $activity, 'return' => 'activities,contacts'));
173 $this->assertEquals(FALSE, empty($result['values'][$id]), 'in line ' . __LINE__
);
174 $this->assertEquals($result['values'][$id], $case, 'in line ' . __LINE__
);
178 * Test get function based on contact id
180 function testCaseGetByContact() {
182 $result = $this->callAPISuccess('case', 'create', $this->_params
);
185 // Store result for later
186 $case = $this->callAPISuccess('case', 'getsingle', array('id' => $id));
188 // Fetch case based on client contact id
189 $result = $this->callAPISuccess('case', 'get', array('client_id' => $this->_params
['contact_id'], 'return' => array('activities', 'contacts')));
190 $this->assertAPIArrayComparison($result['values'][$id], $case);
194 * Test get function based on subject
196 function testCaseGetBySubject() {
198 $result = $this->callAPISuccess('case', 'create', $this->_params
);
201 // Store result for later
202 $case = $this->callAPISuccess('case', 'getsingle', array('id' => $id));
204 // Fetch case based on client contact id
205 $result = $this->callAPISuccess('case', 'get', array('subject' => $this->_params
['subject'], 'return' => array('activities', 'contacts')));
206 $this->assertAPIArrayComparison($result['values'][$id], $case);
210 * Test get function based on wrong subject
212 function testCaseGetByWrongSubject() {
214 $result = $this->callAPISuccess('case', 'create', $this->_params
);
217 // Append 'wrong' to subject so that it is no longer the same
218 $result = $this->callAPISuccess('case', 'get', array('subject' => $this->_params
['subject'] . 'wrong', 'return' => array('activities', 'contacts')));
219 $this->assertEquals(0, $result['count'], 'in line ' . __LINE__
);
223 * Test get function with no criteria
225 function testCaseGetNoCriteria() {
227 $result = $this->callAPISuccess('case', 'create', $this->_params
);
230 // Store result for later
231 $case = $this->callAPISuccess('case', 'getsingle', array('id' => $id));
233 $result = $this->callAPISuccess('case', 'get', array('return' => array('activities', 'contacts')));
234 $this->assertAPIArrayComparison($result['values'][$id], $case);
238 * Test activity api create for case activities
240 function testCaseActivityCreate() {
241 // Create a case first
242 $params = $this->_params
;
243 $result = $this->callAPISuccess('case', 'create', $params);
247 'activity_type_id' => $this->followup_activity_type_value
,
248 'subject' => 'Test followup',
249 'source_contact_id' => $this->_loggedInUser
,
250 'target_contact_id' => $this->_params
['contact_id'],
252 $result = $this->callAPISuccess('activity', 'create', $params);
253 $this->assertEquals($result['values'][$result['id']]['activity_type_id'], $params['activity_type_id'], 'in line ' . __LINE__
);
255 // might need this for other tests that piggyback on this one
256 $this->_caseActivityId
= $result['values'][$result['id']]['id'];
258 // Check other DB tables populated properly - is there a better way to do this? assertDBState() requires that we know the id already.
259 $dao = new CRM_Case_DAO_CaseActivity();
261 $dao->activity_id
= $this->_caseActivityId
;
262 $this->assertEquals($dao->find(), 1, 'case_activity table not populated correctly in line ' . __LINE__
);
265 $dao = new CRM_Activity_DAO_ActivityContact();
266 $dao->activity_id
= $this->_caseActivityId
;
267 $dao->contact_id
= $this->_params
['contact_id'];
268 $dao->record_type_id
= 3;
269 $this->assertEquals($dao->find(), 1, 'activity_contact table not populated correctly in line ' . __LINE__
);
272 // TODO: There's more things we could check
276 * Test activity api update for case activities
278 function testCaseActivityUpdate() {
279 // Need to create the case and activity before we can update it
280 $this->testCaseActivityCreate();
283 'activity_id' => $this->_caseActivityId
,
285 'activity_type_id' => 14,
286 'source_contact_id' => $this->_loggedInUser
,
287 'subject' => 'New subject',
289 $result = $this->callAPISuccess('activity', 'create', $params);
291 $this->assertEquals($result['values'][$result['id']]['subject'], $params['subject'], 'in line ' . __LINE__
);
293 // id should be one greater, since this is a new revision
294 $this->assertEquals($result['values'][$result['id']]['id'],
295 $this->_caseActivityId +
1,
296 'in line ' . __LINE__
298 $this->assertEquals($result['values'][$result['id']]['original_id'],
299 $this->_caseActivityId
,
300 'in line ' . __LINE__
303 // Check revision is as expected
305 'activity_id' => $this->_caseActivityId
,
307 $revActivity = $this->callAPISuccess('activity', 'get', $revParams);
308 $this->assertEquals($revActivity['values'][$this->_caseActivityId
]['is_current_revision'],
310 $this->assertEquals($revActivity['values'][$this->_caseActivityId
]['is_deleted'],
314 //TODO: check some more things
317 function testCaseActivityUpdateCustom() {
318 // Create a case first
319 $result = $this->callAPISuccess('case', 'create', $this->_params
);
321 // Create custom field group
322 // Note the second parameter is Activity on purpose, not Case.
323 $custom_ids = $this->entityCustomGroupWithSingleFieldCreate(__FUNCTION__
, 'ActivityTest.php');
327 'case_id' => $result['id'],
329 'activity_type_id' => 14,
330 'subject' => 'Test followup',
331 'source_contact_id' => $this->_loggedInUser
,
332 'target_contact_id' => $this->_params
['contact_id'],
333 'custom_' . $custom_ids['custom_field_id'] => "custom string",
335 $result = $this->callAPISuccess('activity', 'create', $params);
337 $aid = $result['values'][$result['id']]['id'];
341 'activity_id' => $aid,
343 'activity_type_id' => 14,
344 'source_contact_id' => $this->_loggedInUser
,
345 'subject' => 'New subject',
347 $revAct = $this->callAPISuccess('activity', 'create', $params);
349 // Retrieve revision and check custom fields got copied
351 'activity_id' => $aid +
1,
352 'return.custom_' . $custom_ids['custom_field_id'] => 1,
354 $revAct = $this->callAPISuccess('activity', 'get', $revParams);
356 $this->assertEquals($revAct['values'][$aid +
1]['custom_' . $custom_ids['custom_field_id']], "custom string",
357 "Error message: " . CRM_Utils_Array
::value('error_message', $revAct) . ' in line ' . __LINE__
360 $this->customFieldDelete($custom_ids['custom_field_id']);
361 $this->customGroupDelete($custom_ids['custom_group_id']);