tests/phpunit/api/v3/ReportTemplateTest.php

   1 <?php
   2 /*
   3  +--------------------------------------------------------------------+
   4  | CiviCRM version 4.4                                                |
   5  +--------------------------------------------------------------------+
   6  | Copyright CiviCRM LLC (c) 2004-2013                                |
   7  +--------------------------------------------------------------------+
   8  | This file is a part of CiviCRM.                                    |
   9  |                                                                    |
  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.   |
  13  |                                                                    |
  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.        |
  18  |                                                                    |
  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  +--------------------------------------------------------------------+
  26 */
  27
  28 require_once 'CiviTest/CiviUnitTestCase.php';
  29
  30
  31 /**
  32  *  Test APIv3 civicrm_report_instance_* functions
  33  *
  34  *  @package CiviCRM_APIv3
  35  *  @subpackage API_Report
  36  */
  37
  38 class api_v3_ReportTemplateTest extends CiviUnitTestCase {
  39   protected $_apiversion = 3;
  40
  41   function setUp() {
  42     parent::setUp();
  43     $this->_sethtmlGlobals();
  44   }
  45
  46   function tearDown() {}
  47
  48   public function testReportTemplate() {
  49     $result = $this->callAPISuccess('ReportTemplate', 'create', array(
  50       'label' => 'Example Form',
  51       'description' => 'Longish description of the example form',
  52       'class_name' => 'CRM_Report_Form_Examplez',
  53       'report_url' => 'example/path',
  54       'component' => 'CiviCase',
  55     ));
  56     $this->assertAPISuccess($result);
  57     $this->assertEquals(1, $result['count'], 'In line ' . __LINE__);
  58     $entityId = $result['id'];
  59     $this->assertTrue(is_numeric($entityId), 'In line ' . __LINE__);
  60     $this->assertEquals(7, $result['values'][$entityId]['component_id'], 'In line ' . __LINE__);
  61     $this->assertDBQuery(1, 'SELECT count(*) FROM civicrm_option_value
  62       WHERE name = "CRM_Report_Form_Examplez"
  63       AND option_group_id = 41 ');
  64     $this->assertDBQuery(1, 'SELECT is_active FROM civicrm_option_value
  65       WHERE name = "CRM_Report_Form_Examplez"');
  66
  67     // change component to null
  68     $result = $this->callAPISuccess('ReportTemplate', 'create', array(      'id' => $entityId,
  69       'component' => '',
  70     ));
  71     $this->assertAPISuccess($result);
  72     $this->assertEquals(1, $result['count'], 'In line ' . __LINE__);
  73     $this->assertDBQuery(1, 'SELECT count(*) FROM civicrm_option_value
  74       WHERE name = "CRM_Report_Form_Examplez"
  75       AND option_group_id = 41');
  76     $this->assertDBQuery(1, 'SELECT count(*) FROM civicrm_option_value
  77       WHERE name = "CRM_Report_Form_Examplez"
  78       AND component_id IS NULL');
  79
  80     // deactivate
  81     $result = $this->callAPISuccess('ReportTemplate', 'create', array(      'id' => $entityId,
  82       'is_active' => 0,
  83     ));
  84     $this->assertAPISuccess($result);
  85     $this->assertEquals(1, $result['count'], 'In line ' . __LINE__);
  86     $this->assertDBQuery(1, 'SELECT count(*) FROM civicrm_option_value
  87       WHERE name = "CRM_Report_Form_Examplez"
  88       AND option_group_id = 41');
  89     $this->assertDBQuery(0, 'SELECT is_active FROM civicrm_option_value
  90       WHERE name = "CRM_Report_Form_Examplez"');
  91
  92     // activate
  93     $result = $this->callAPISuccess('ReportTemplate', 'create', array(      'id' => $entityId,
  94       'is_active' => 1,
  95     ));
  96     $this->assertAPISuccess($result);
  97     $this->assertEquals(1, $result['count'], 'In line ' . __LINE__);
  98     $this->assertDBQuery(1, 'SELECT count(*) FROM civicrm_option_value
  99       WHERE name = "CRM_Report_Form_Examplez"
 100       AND option_group_id = 41');
 101     $this->assertDBQuery(1, 'SELECT is_active FROM civicrm_option_value
 102       WHERE name = "CRM_Report_Form_Examplez"');
 103
 104     $result = $this->callAPISuccess('ReportTemplate', 'delete', array(      'id' => $entityId,
 105     ));
 106     $this->assertAPISuccess($result);
 107     $this->assertEquals(1, $result['count'], 'In line ' . __LINE__);
 108     $this->assertDBQuery(0, 'SELECT count(*) FROM civicrm_option_value
 109       WHERE name = "CRM_Report_Form_Examplez"
 110       ');
 111   }
 112
 113   /**
 114    *
 115    */
 116   function testReportTemplateGetRowsContactSummary() {
 117     $description = "Retrieve rows from a report template (optionally providing the instance_id)";
 118     $result = $this->callAPIAndDocument('report_template', 'getrows', array(
 119       'report_id' => 'contact/summary',
 120     ), __FUNCTION__, __FILE__, $description, 'Getrows', 'getrows');
 121
 122     //the second part of this test has been commented out because it relied on the db being reset to
 123     // it's base state
 124     //wasn't able to get that to work consistently
 125     // however, when the db is in the base state the tests do pass
 126     // and because the test covers 'all' contacts we can't create our own & assume the others don't exist
 127     /*
 128     $this->assertEquals(2, $result['count']);
 129     $this->assertEquals('Default Organization', $result[0]['civicrm_contact_sort_name']);
 130     $this->assertEquals('Second Domain', $result[1]['civicrm_contact_sort_name']);
 131     $this->assertEquals('15 Main St', $result[1]['civicrm_address_street_address']);
 132     */
 133   }
 134
 135   /**
 136    * @dataProvider getReportTemplates
 137    */
 138   function testReportTemplateGetRowsAllReports($reportID) {
 139     if(stristr($reportID, 'has existing issues')) {
 140       $this->markTestIncomplete($reportID);
 141     }
 142      $result = $this->callAPISuccess('report_template', 'getrows', array(
 143        'report_id' => $reportID,
 144     ));
 145   }
 146
 147   /**
 148    * @dataProvider getReportTemplates
 149    */
 150   function testReportTemplateGetStatisticsAllReports($reportID) {
 151     if(stristr($reportID, 'has existing issues')) {
 152       $this->markTestIncomplete($reportID);
 153     }
 154     if(in_array($reportID , array('contribute/softcredit', 'contribute/bookkeeping'))) {
 155       $this->markTestIncomplete($reportID . " has non enotices when calling statistics fn");
 156     }
 157     $description = "Get Statistics from a report (note there isn't much data to get in the test DB :-(";
 158     $result = $this->callAPIAndDocument('report_template', 'getstatistics', array(
 159       'report_id' => $reportID,
 160     ), __FUNCTION__, __FILE__, $description, 'Getstatistics', 'getstatistics');
 161   }
 162
 163   /**
 164    * Data provider function for getting all templates, note that the function needs to
 165    * be static so cannot use $this->callAPISuccess
 166    */
 167   public static function getReportTemplates() {
 168     $reportsToSkip = array(
 169         'activity' =>  'does not respect function signature on from clause',
 170         'walklist' => 'Notice: Undefined index: type in CRM_Report_Form_Walklist_Walklist line 155.
 171                        (suspect the select function should be removed in favour of the parent (state province field)
 172                       also, type should be added to state province & others? & potentially getAddressColumns fn should be
 173                       used per other reports',
 174         'contribute/repeat' => 'Reports with important functionality in postProcess are not callable via the api. For variable setting recommend beginPostProcessCommon, for temp table creation recommend From fn',
 175         'contribute/organizationSummary' => 'Failure in api call for report_template getrows:  Only variables should be assigned by reference line 381',
 176         'contribute/householdSummary' => '(see contribute/repeat) Undefined property: CRM_Report_Form_Contribute_HouseholdSummary::$householdContact LINE 260, property should be declared on class, for api accessibility should be set in beginPreProcess common',
 177         'contribute/topDonor' => 'construction of query in postprocess makes inaccessible ',
 178         'contribute/sybunt' => 'e notice - (ui gives fatal error at civicrm/report/contribute/sybunt&reset=1&force=1
 179                                 e-notice is on yid_valueContribute/Sybunt.php(214) because at the force url "yid_relative" not "yid_value" is defined',
 180         'contribute/lybunt' => 'same as sybunt - fatals on force url & test identifies why',
 181         'event/income' => 'I do no understant why but error is Call to undefined method CRM_Report_Form_Event_Income::from() in CRM/Report/Form.php on line 2120',
 182         'contact/relationship' => '(see contribute/repeat), property declaration issue, Undefined property: CRM_Report_Form_Contact_Relationship::$relationType in /Contact/Relationship.php(486):',
 183         'case/demographics' => 'Undefined index: operatorType Case/Demographics.php(319)',
 184         'activitySummary' => 'Undefined index: group_bys_freq m/ActivitySummary.php(191)',
 185         'event/incomesummary' => 'Undefined index: title, Report/Form/Event/IncomeCountSummary.php(187)',
 186         'logging/contact/summary' => '(likely to be test releated) probably logging off Undefined index: Form/Contact/LoggingSummary.php(231): PHP',
 187         'logging/contact/detail' => '(likely to be test releated) probably logging off  DB Error: no such table',
 188         'logging/contribute/summary' => '(likely to be test releated) probably logging off DB Error: no such table',
 189         'logging/contribute/detail' => '(likely to be test releated) probably logging off DB Error: no such table',
 190         'survey/detail' => '(likely to be test releated)  Undefined index: CiviCampaign civicrm CRM/Core/Component.php(196)',
 191         'contribute/history' => 'Declaration of CRM_Report_Form_Contribute_History::buildRows() should be compatible with CRM_Report_Form::buildRows($sql, &$rows)',
 192     );
 193
 194     $reports = civicrm_api3('report_template', 'get', array('return' => 'value', 'options' => array('limit' => 500)));
 195     foreach ($reports['values'] as $report) {
 196       if(empty($reportsToSkip[$report['value']])) {
 197         $reportTemplates[] = array($report['value']);
 198       }
 199       else {
 200         $reportTemplates[] = array($report['value']. " has existing issues :  " . $reportsToSkip[$report['value']]);
 201       }
 202     }
 203
 204
 205
 206     return $reportTemplates;
 207   }
 208 }