3 +--------------------------------------------------------------------+
4 | CiviCRM version 4.7 |
5 +--------------------------------------------------------------------+
6 | Copyright CiviCRM LLC (c) 2004-2015 |
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 +--------------------------------------------------------------------+
28 require_once 'CiviTest/CiviUnitTestCase.php';
31 * Test class for Batch API - civicrm_participant_*
33 * @package CiviCRM_APIv3
35 require_once 'CRM/Utils/DeprecatedUtils.php';
36 require_once 'CiviTest/CiviUnitTestCase.php';
39 * Class api_v3_ParticipantTest
41 class api_v3_ParticipantTest
extends CiviUnitTestCase
{
43 protected $_apiversion;
45 protected $_contactID;
46 protected $_contactID2;
47 protected $_createdParticipants;
48 protected $_participantID;
50 protected $_individualId;
53 public function setUp() {
54 $this->_apiversion
= 3;
56 $this->_entity
= 'participant';
57 $event = $this->eventCreate(NULL);
58 $this->_eventID
= $event['id'];
60 $this->_contactID
= $this->individualCreate();
62 $this->_createdParticipants
= array();
63 $this->_individualId
= $this->individualCreate();
65 $this->_participantID
= $this->participantCreate(array(
66 'contact_id' => $this->_contactID
,
67 'event_id' => $this->_eventID
,
69 $this->_contactID2
= $this->individualCreate();
70 $this->_participantID2
= $this->participantCreate(array(
71 'contact_id' => $this->_contactID2
,
72 'event_id' => $this->_eventID
,
74 $this->_participantID3
= $this->participantCreate(array(
75 'contact_id' => $this->_contactID2
,
76 'event_id' => $this->_eventID
,
78 $this->_params
= array(
79 'contact_id' => $this->_contactID
,
80 'event_id' => $this->_eventID
,
83 // to ensure it matches later on
84 'register_date' => '2007-07-21 00:00:00',
85 'source' => 'Online Event Registration: API Testing',
89 public function tearDown() {
90 $this->eventDelete($this->_eventID
);
91 $tablesToTruncate = array(
92 'civicrm_custom_group',
93 'civicrm_custom_field',
95 'civicrm_participant',
97 // true tells quickCleanup to drop any tables that might have been created in the test
98 $this->quickCleanup($tablesToTruncate, TRUE);
102 * Check with complete array + custom field
103 * Note that the test is written on purpose without any
104 * variables specific to participant so it can be replicated into other entities
105 * and / or moved to the automated test suite
107 public function testCreateWithCustom() {
108 $ids = $this->entityCustomGroupWithSingleFieldCreate(__FUNCTION__
, __FILE__
);
110 $params = $this->_params
;
111 $params['custom_' . $ids['custom_field_id']] = "custom string";
113 $result = $this->callAPIAndDocument($this->_entity
, 'create', $params, __FUNCTION__
, __FILE__
);
115 $this->assertEquals($result['id'], $result['values'][$result['id']]['id']);
117 $check = $this->callAPISuccess($this->_entity
, 'get', array('id' => $result['id']));
118 $this->assertEquals("custom string", $check['values'][$check['id']]['custom_' . $ids['custom_field_id']], ' in line ' . __LINE__
);
120 $this->customFieldDelete($ids['custom_field_id']);
121 $this->customGroupDelete($ids['custom_group_id']);
125 ///////////////// civicrm_participant_get methods
128 * Check with wrong params type.
130 public function testGetWrongParamsType() {
131 $params = 'a string';
132 $result = $this->callAPIFailure('participant', 'get', $params);
136 * Test civicrm_participant_get with empty params.
138 public function testGetEmptyParams() {
139 $this->callAPISuccess('participant', 'get', array());
143 * Check with participant_id.
145 public function testGetParticipantIdOnly() {
147 'participant_id' => $this->_participantID
,
151 'participant_register_date',
152 'participant_source',
155 $result = $this->callAPISuccess('participant', 'get', $params);
156 $this->assertAPISuccess($result, " in line " . __LINE__
);
157 $this->assertEquals($result['values'][$this->_participantID
]['event_id'], $this->_eventID
, "in line " . __LINE__
);
158 $this->assertEquals($result['values'][$this->_participantID
]['participant_register_date'], '2007-02-19 00:00:00', "in line " . __LINE__
);
159 $this->assertEquals($result['values'][$this->_participantID
]['participant_source'], 'Wimbeldon', "in line " . __LINE__
);
161 'id' => $this->_participantID
,
162 'return' => 'id,participant_register_date,event_id',
165 $result = $this->callAPISuccess('participant', 'get', $params);
166 $this->assertEquals($result['values'][$this->_participantID
]['event_id'], $this->_eventID
);
167 $this->assertEquals($result['values'][$this->_participantID
]['participant_register_date'], '2007-02-19 00:00:00');
172 * Check with params id.
174 public function testGetParamsAsIdOnly() {
176 'id' => $this->_participantID
,
178 $result = $this->callAPIAndDocument('participant', 'get', $params, __FUNCTION__
, __FILE__
);
179 $this->assertEquals($result['values'][$this->_participantID
]['event_id'], $this->_eventID
);
180 $this->assertEquals($result['values'][$this->_participantID
]['participant_register_date'], '2007-02-19 00:00:00');
181 $this->assertEquals($result['values'][$this->_participantID
]['participant_source'], 'Wimbeldon');
182 $this->assertEquals($result['id'], $result['values'][$this->_participantID
]['id']);
186 * Check with params id.
188 public function testGetNestedEventGet() {
189 //create a second event & add participant to it.
190 $event = $this->eventCreate(NULL);
191 $this->callAPISuccess('participant', 'create', array(
192 'event_id' => $event['id'],
193 'contact_id' => $this->_contactID
,
196 $description = "Demonstrates use of nested get to fetch event data with participant records.";
197 $subfile = "NestedEventGet";
199 'id' => $this->_participantID
,
200 'api.event.get' => 1,
202 $result = $this->callAPIAndDocument('participant', 'get', $params, __FUNCTION__
, __FILE__
, $description, $subfile);
203 $this->assertEquals($result['values'][$this->_participantID
]['event_id'], $this->_eventID
);
204 $this->assertEquals($result['values'][$this->_participantID
]['participant_register_date'], '2007-02-19 00:00:00');
205 $this->assertEquals($result['values'][$this->_participantID
]['participant_source'], 'Wimbeldon');
206 $this->assertEquals($this->_eventID
, $result['values'][$this->_participantID
]['api.event.get']['id']);
210 * Check Participant Get respects return properties.
212 public function testGetWithReturnProperties() {
214 'contact_id' => $this->_contactID
,
215 'return.status_id' => 1,
216 'return.participant_status_id' => 1,
217 'options' => array('limit' => 1),
219 $result = $this->callAPISuccess('participant', 'get', $params);
220 $this->assertArrayHasKey('participant_status_id', $result['values'][$result['id']]);
224 * Check with contact_id.
226 public function testGetContactIdOnly() {
228 'contact_id' => $this->_contactID
,
230 $participant = $this->callAPISuccess('participant', 'get', $params);
232 $this->assertEquals($this->_participantID
, $participant['id'],
233 "In line " . __LINE__
235 $this->assertEquals($this->_eventID
, $participant['values'][$participant['id']]['event_id'],
236 "In line " . __LINE__
238 $this->assertEquals('2007-02-19 00:00:00', $participant['values'][$participant['id']]['participant_register_date'],
239 "In line " . __LINE__
241 $this->assertEquals('Wimbeldon', $participant['values'][$participant['id']]['participant_source'],
242 "In line " . __LINE__
244 $this->assertEquals($participant['id'], $participant['values'][$participant['id']]['id'],
245 "In line " . __LINE__
250 * Check with event_id.
253 public function testGetMultiMatchReturnFirst() {
255 'event_id' => $this->_eventID
,
259 $participant = $this->callAPISuccess('participant', 'get', $params);
260 $this->assertNotNull($participant['id']);
264 * Check with event_id.
265 * in v3 this should return all participants
267 public function testGetMultiMatchNoReturnFirst() {
269 'event_id' => $this->_eventID
,
271 $participant = $this->callAPISuccess('participant', 'get', $params);
272 $this->assertNotNull($participant['count'], 3);
275 ///////////////// civicrm_participant_get methods
278 * Test civicrm_participant_get with empty params.
279 * In this case all the participant records are returned.
281 public function testSearchEmptyParams() {
282 $result = $this->callAPISuccess('participant', 'get', array());
283 // expecting 3 participant records
284 $this->assertEquals($result['count'], 3);
288 * Check with participant_id.
290 public function testSearchParticipantIdOnly() {
292 'participant_id' => $this->_participantID
,
294 $participant = $this->callAPISuccess('participant', 'get', $params);
295 $this->assertEquals($participant['values'][$this->_participantID
]['event_id'], $this->_eventID
);
296 $this->assertEquals($participant['values'][$this->_participantID
]['participant_register_date'], '2007-02-19 00:00:00');
297 $this->assertEquals($participant['values'][$this->_participantID
]['participant_source'], 'Wimbeldon');
301 * Check with contact_id.
303 public function testSearchContactIdOnly() {
304 // Should get 2 participant records for this contact.
306 'contact_id' => $this->_contactID2
,
308 $participant = $this->callAPISuccess('participant', 'get', $params);
310 $this->assertEquals($participant['count'], 2);
314 * Check with event_id.
316 public function testSearchByEvent() {
317 // Should get >= 3 participant records for this event. Also testing that last_name and event_title are returned.
319 'event_id' => $this->_eventID
,
320 'return.last_name' => 1,
321 'return.event_title' => 1,
323 $participant = $this->callAPISuccess('participant', 'get', $params);
324 if ($participant['count'] < 3) {
325 $this->fail("Event search returned less than expected miniumum of 3 records.");
328 $this->assertEquals($participant['values'][$this->_participantID
]['last_name'], 'Anderson');
329 $this->assertEquals($participant['values'][$this->_participantID
]['event_title'], 'Annual CiviCRM meet');
333 * Check with event_id.
336 public function testSearchByEventWithLimit() {
337 // Should 2 participant records since we're passing rowCount = 2.
339 'event_id' => $this->_eventID
,
342 $participant = $this->callAPISuccess('participant', 'get', $params);
344 $this->assertEquals($participant['count'], 2);
347 ///////////////// civicrm_participant_create methods
350 * Test civicrm_participant_create with empty params.
352 public function testCreateEmptyParams() {
354 $result = $this->callAPIFailure('participant', 'create', $params);
358 * Check with event_id.
360 public function testCreateMissingContactID() {
362 'event_id' => $this->_eventID
,
364 $participant = $this->callAPIFailure('participant', 'create', $params);
368 * Check with contact_id.
371 public function testCreateMissingEventID() {
373 'contact_id' => $this->_contactID
,
375 $participant = $this->callAPIFailure('participant', 'create', $params);
379 * Check with contact_id & event_id
381 public function testCreateEventIdOnly() {
383 'contact_id' => $this->_contactID
,
384 'event_id' => $this->_eventID
,
386 $participant = $this->callAPISuccess('participant', 'create', $params);
387 $this->getAndCheck($params, $participant['id'], 'participant');
391 * Check with complete array.
393 public function testCreateAllParams() {
394 $params = $this->_params
;
396 $participant = $this->callAPISuccess('participant', 'create', $params);
397 $this->_participantID
= $participant['id'];
398 // assertDBState compares expected values in $match to actual values in the DB
399 $this->assertDBState('CRM_Event_DAO_Participant', $participant['id'], $params);
403 * Test to check if receive date is being changed per CRM-9763
405 public function testCreateUpdateReceiveDate() {
406 $participant = $this->callAPISuccess('participant', 'create', $this->_params
);
408 'id' => $participant['id'],
411 $this->callAPISuccess('participant', 'create', $update);
412 $this->getAndCheck(array_merge($this->_params
, $update), $participant['id'], 'participant');
416 * Test to check if participant fee level is being changed per CRM-9781
418 public function testCreateUpdateParticipantFeeLevel() {
419 $myParams = $this->_params +
array('participant_fee_level' => CRM_Core_DAO
::VALUE_SEPARATOR
. "fee" . CRM_Core_DAO
::VALUE_SEPARATOR
);
420 $participant = $this->callAPISuccess('participant', 'create', $myParams);
422 'id' => $participant['id'],
425 $update = $this->callAPISuccess('participant', 'create', $update);
427 $this->assertEquals($participant['values'][$participant['id']]['fee_level'],
428 $update['values'][$participant['id']]['fee_level']
431 $this->callAPISuccess('participant', 'delete', array('id' => $participant['id']));
435 * Test the line items for participant fee with multiple price field values.
437 public function testCreateParticipantLineItems() {
438 // Create a price set for this event.
440 $priceset = $this->callAPISuccess('PriceSet', 'create', array(
441 'name' => 'my_price_set',
442 'title' => 'My Price Set',
445 'financial_type_id' => 4,
446 // 'entity' => array('civicrm_event' => array($this->_eventID)),
449 // Add the price set to the event with another API call.
450 // I tried to do this at once, but it did not work.
452 $priceset = $this->callAPISuccess('PriceSet', 'create', array(
453 'entity_table' => 'civicrm_event',
454 'entity_id' => $this->_eventID
,
455 'id' => $priceset['id'],
458 $pricefield = $this->callAPISuccess('PriceField', 'create', array(
459 'price_set_id' => $priceset['id'],
460 'name' => 'mypricefield',
461 'label' => 'My Price Field',
462 'html_type' => 'Text',
464 'is_display_amounts' => 1,
468 $pfv1 = $this->callAPISuccess('PriceFieldValue', 'create', array(
469 'price_field_id' => $pricefield['id'],
470 'name' => 'pricefieldvalue1',
471 'label' => 'pricefieldvalue1',
474 'financial_type_id' => 4,
477 $pfv2 = $this->callAPISuccess('PriceFieldValue', 'create', array(
478 'price_field_id' => $pricefield['id'],
479 'name' => 'pricefieldvalue2',
480 'label' => 'pricefieldvalue2',
483 'financial_type_id' => 4,
486 // pay 2 times price field value 1, and 2 times price field value 2.
487 $myParams = $this->_params +
array('participant_fee_level' => CRM_Core_DAO
::VALUE_SEPARATOR
. "pricefieldvalue1 - 2" . CRM_Core_DAO
::VALUE_SEPARATOR
. "pricefieldvalue2 - 2" . CRM_Core_DAO
::VALUE_SEPARATOR
);
488 $participant = $this->callAPISuccess('participant', 'create', $myParams);
490 // expect 2 line items.
491 $lineItems = $this->callAPISuccess('LineItem', 'get', array(
492 'entity_id' => $participant['id'],
493 'entity_table' => 'civicrm_participant',
496 $this->assertEquals(2, $lineItems['count']);
498 // Check quantity, label and unit price of lines.
499 // TODO: These assertions depend on the order of the line items, which is
500 // technically incorrect.
502 $lineItem = array_pop($lineItems['values']);
503 $this->assertEquals(2, $lineItem['qty']);
504 $this->assertEquals(5, $lineItem['unit_price']);
505 $this->assertEquals('pricefieldvalue2', $lineItem['label']);
507 $lineItem = array_pop($lineItems['values']);
508 $this->assertEquals(2, $lineItem['qty']);
509 $this->assertEquals(20, $lineItem['unit_price']);
510 $this->assertEquals('pricefieldvalue1', $lineItem['label']);
513 $this->callAPISuccess('participant', 'delete', array('id' => $participant['id']));
515 // TODO: I think the price set should be removed, but I don't know how
516 // to decouple it properly from the event. For the moment, I'll just comment
517 // out the lines below.
520 $this->callAPISuccess('PriceFieldValue', 'delete', array('id' => $pfv1['id']));
521 $this->callAPISuccess('PriceFieldValue', 'delete', array('id' => $pfv2['id']));
522 $this->callAPISuccess('PriceField', 'delete', array('id' => $pricefield['id']));
523 $this->callAPISuccess('PriceSet', 'delete', array('id' => $priceset['id']));
528 * Check with complete array.
530 public function testUpdate() {
531 $participantId = $this->participantCreate(array(
532 'contactID' => $this->_individualId
,
533 'eventID' => $this->_eventID
,
536 'id' => $participantId,
537 'contact_id' => $this->_individualId
,
538 'event_id' => $this->_eventID
,
541 'register_date' => '2006-01-21',
542 'source' => 'US Open',
544 $participant = $this->callAPISuccess('participant', 'create', $params);
545 $this->getAndCheck($params, $participant['id'], 'participant');
546 $result = $this->participantDelete($params['id']);
550 * Test to check if participant fee level is being changed per CRM-9781
551 * Try again without a custom separater to check that one isn't added
552 * (get & check won't accept an array)
554 public function testUpdateCreateParticipantFeeLevelNoSeparator() {
556 $myParams = $this->_params +
array('participant_fee_level' => "fee");
557 $participant = $this->callAPISuccess('participant', 'create', $myParams);
558 $this->assertAPISuccess($participant);
560 'id' => $participant['id'],
563 $this->callAPISuccess('participant', 'create', $update);
564 $this->assertEquals($participant['values'][$participant['id']]['fee_level'],
565 $myParams['participant_fee_level']
567 $this->getAndCheck($update, $participant['id'], 'participant');
569 ///////////////// civicrm_participant_update methods
572 * Test civicrm_participant_update with wrong params type.
574 public function testUpdateWrongParamsType() {
575 $params = 'a string';
576 $result = $this->callAPIFailure('participant', 'create', $params);
577 $this->assertEquals('Input variable `params` is not an array', $result['error_message']);
581 * Check with empty array.
583 public function testUpdateEmptyParams() {
585 $participant = $this->callAPIFailure('participant', 'create', $params);
586 $this->assertEquals($participant['error_message'], 'Mandatory key(s) missing from params array: event_id, contact_id');
590 * Check without event_id.
592 public function testUpdateWithoutEventId() {
593 $participantId = $this->participantCreate(array('contactID' => $this->_individualId
, 'eventID' => $this->_eventID
));
595 'contact_id' => $this->_individualId
,
598 'register_date' => '2006-01-21',
599 'source' => 'US Open',
600 'event_level' => 'Donation',
602 $participant = $this->callAPIFailure('participant', 'create', $params);
603 $this->assertEquals($participant['error_message'], 'Mandatory key(s) missing from params array: event_id');
604 // Cleanup created participant records.
605 $result = $this->participantDelete($participantId);
609 * Check with Invalid participantId.
611 public function testUpdateWithWrongParticipantId() {
616 'register_date' => '2006-01-21',
617 'source' => 'US Open',
618 'event_level' => 'Donation',
620 $participant = $this->callAPIFailure('Participant', 'update', $params);
624 * Check with Invalid ContactId.
626 public function testUpdateWithWrongContactId() {
627 $participantId = $this->participantCreate(array(
628 'contactID' => $this->_individualId
,
629 'eventID' => $this->_eventID
,
630 ), $this->_apiversion
);
632 'id' => $participantId,
633 'contact_id' => 12345,
636 'register_date' => '2006-01-21',
637 'source' => 'US Open',
638 'event_level' => 'Donation',
640 $participant = $this->callAPIFailure('participant', 'create', $params);
641 $result = $this->participantDelete($participantId);
644 ///////////////// civicrm_participant_delete methods
647 * Test civicrm_participant_delete with wrong params type.
649 public function testDeleteWrongParamsType() {
650 $params = 'a string';
651 $result = $this->callAPIFailure('participant', 'delete', $params);
655 * Test civicrm_participant_delete with empty params.
657 public function testDeleteEmptyParams() {
659 $result = $this->callAPIFailure('participant', 'delete', $params);
663 * Check with participant_id.
665 public function testParticipantDelete() {
667 'id' => $this->_participantID
,
669 $participant = $this->callAPISuccess('participant', 'delete', $params);
670 $this->assertAPISuccess($participant);
671 $this->assertDBState('CRM_Event_DAO_Participant', $this->_participantID
, NULL, TRUE);
675 * Check without participant_id.
677 * This should return an error because required param is missing..
679 public function testParticipantDeleteMissingID() {
681 'event_id' => $this->_eventID
,
683 $participant = $this->callAPIFailure('participant', 'delete', $params);
684 $this->assertNotNull($participant['error_message']);
688 * Delete with a get - a 'criteria delete'
690 public function testNestedDelete() {
691 $description = "Criteria delete by nesting a GET & a DELETE.";
692 $subfile = "NestedDelete";
693 $participants = $this->callAPISuccess('Participant', 'Get', array());
694 $this->assertEquals($participants['count'], 3);
695 $params = array('contact_id' => $this->_contactID2
, 'api.participant.delete' => 1);
696 $participants = $this->callAPIAndDocument('Participant', 'Get', $params, __FUNCTION__
, __FILE__
, $description, $subfile);
697 $check = $this->callAPISuccess('participant', 'getcount', array());
698 $this->assertEquals(1, $check, "only one participant should be left. line " . __LINE__
);
702 * Test creation of a participant with an associated contribution.
704 public function testCreateParticipantWithPayment() {
705 $description = "Single function to create contact with partipation & contribution.
706 Note that in the case of 'contribution' the 'create' is implied (api.contribution.create)";
707 $subfile = "CreateParticipantPayment";
709 'contact_type' => 'Individual',
710 'display_name' => 'dlobo',
711 'api.participant' => array(
712 'event_id' => $this->_eventID
,
715 'format.only_id' => 1,
717 'api.contribution.create' => array(
718 'financial_type_id' => 1,
719 'total_amount' => 100,
720 'format.only_id' => 1,
722 'api.participant_payment.create' => array(
723 'contribution_id' => '$value.api.contribution.create',
724 'participant_id' => '$value.api.participant',
728 $result = $this->callAPIAndDocument('contact', 'create', $params, __FUNCTION__
, __FILE__
, $description, $subfile);
729 $this->assertEquals(1, $result['values'][$result['id']]['api.participant_payment.create']['count']);
730 $this->callAPISuccess('contact', 'delete', array('id' => $result['id']));