CATL-1114: Support Cases In Scheduled Reminders

CRM/Admin/Form/ScheduleReminders.php

@@ -702,6 +702,7 @@ public function listTokens() {
     $tokens = array_merge(CRM_Core_SelectValues::eventTokens(), $tokens);
     $tokens = array_merge(CRM_Core_SelectValues::membershipTokens(), $tokens);
     $tokens = array_merge(CRM_Core_SelectValues::contributionTokens(), $tokens);
+    $tokens = array_merge(CRM_Core_SelectValues::caseTokens(), $tokens);
     return $tokens;
   }
 

CRM/Case/ActionMapping.php

@@ -0,0 +1,138 @@
+<?php
+/*
+ +--------------------------------------------------------------------+
+ | CiviCRM version 5                                                  |
+ +--------------------------------------------------------------------+
+ | Copyright CiviCRM LLC (c) 2004-2019                                |
+ +--------------------------------------------------------------------+
+ | This file is a part of CiviCRM.                                    |
+ |                                                                    |
+ | CiviCRM is free software; you can copy, modify, and distribute it  |
+ | under the terms of the GNU Affero General Public License           |
+ | Version 3, 19 November 2007 and the CiviCRM Licensing Exception.   |
+ |                                                                    |
+ | CiviCRM is distributed in the hope that it will be useful, but     |
+ | WITHOUT ANY WARRANTY; without even the implied warranty of         |
+ | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.               |
+ | See the GNU Affero General Public License for more details.        |
+ |                                                                    |
+ | You should have received a copy of the GNU Affero General Public   |
+ | License and the CiviCRM Licensing Exception along                  |
+ | with this program; if not, contact CiviCRM LLC                     |
+ | at info[AT]civicrm[DOT]org. If you have questions about the        |
+ | GNU Affero General Public License or the licensing of CiviCRM,     |
+ | see the CiviCRM license FAQ at http://civicrm.org/licensing        |
+ +--------------------------------------------------------------------+
+ */
+
+/**
+ * Class CRM_Event_ActionMapping
+ *
+ * This defines the scheduled-reminder functionality for CiviCase entities.
+ */
+class CRM_Case_ActionMapping extends \Civi\ActionSchedule\Mapping {
+
+  /**
+   * The value for civicrm_action_schedule.mapping_id which identifies the
+   * "Case" mapping.
+   *
+   * Note: This value is chosen to match legacy DB IDs.
+   */
+  const CASE_MAPPING_ID = 99;
+
+  /**
+   * Register Case-related action mappings.
+   *
+   * @param \Civi\ActionSchedule\Event\MappingRegisterEvent $registrations
+   */
+  public static function onRegisterActionMappings(\Civi\ActionSchedule\Event\MappingRegisterEvent $registrations) {
+    $registrations->register(CRM_Case_ActionMapping::create(array(
+      'id' => CRM_Case_ActionMapping::CASE_MAPPING_ID,
+      'entity' => 'civicrm_case',
+      'entity_label' => ts('Case'),
+      'entity_value' => 'case_type',
+      'entity_value_label' => ts('Case Type'),
+      'entity_status' => 'case_status',
+      'entity_status_label' => ts('Case Status'),
+      'entity_date_start' => 'case_start_date',
+      'entity_date_end' => 'case_end_date',
+    )));
+  }
+
+  /**
+   * @inheritdoc
+   */
+  public function getRecipientListing($type) {
+    if ($type == 'case_roles') {
+      $result = civicrm_api3('RelationshipType', 'get', array(
+        'sequential' => 1,
+        'options' => array('limit' => 0, 'sort' => "label_b_a"),
+      ))['values'];
+      $cRoles = array();
+      foreach ($result as $each) {
+        $cRoles[$each['id']] = $each['label_b_a'];
+      }
+      return $cRoles;
+    }
+    return array();
+  }
+
+  /**
+   * @inheritdoc
+   */
+  public function getRecipientTypes() {
+    return array('case_roles' => 'Case Roles');
+  }
+
+  /**
+   * @inheritdoc
+   */
+  public function createQuery($schedule, $phase, $defaultParams) {
+    $selectedValues = (array) \CRM_Utils_Array::explodePadded($schedule->entity_value);
+    $selectedStatuses = (array) \CRM_Utils_Array::explodePadded($schedule->entity_status);
+
+    $query = \CRM_Utils_SQL_Select::from("civicrm_case c")->param($defaultParams);
+    $query->join('r', "INNER JOIN civicrm_relationship r ON c.id = r.case_id");
+    $query->join('cs', "INNER JOIN civicrm_contact ct ON r.contact_id_b = ct.id");
+    $query->join('ce', "INNER JOIN civicrm_email ce ON ce.contact_id = ct.id");
+
+    if (!empty($selectedValues)) {
+      $query->where("c.case_type_id IN (#caseId)")
+        ->param('caseId', $selectedValues);
+    }
+
+    if (!empty($selectedStatuses)) {
+      $query->where("c.status_id IN (#selectedStatuses)")
+        ->param('selectedStatuses', $selectedStatuses);
+    }
+
+    if (!empty($caseRoles)) {
+      $query->where("r.relationship_type_id IN (#caseRoles)")
+        ->param('caseRoles', $caseRoles);
+    }
+
+    if ($schedule->recipient_listing && $schedule->limit_to) {
+      switch ($schedule->recipient) {
+        case 'case_roles':
+          $caseRoles = (array) \CRM_Utils_Array::explodePadded($schedule->recipient_listing);
+          $query->where("r.relationship_type_id IN (#caseRoles)")
+            ->param('caseRoles', $caseRoles);
+          break;
+      }
+    }
+
+    // $schedule->start_action_date is user-supplied data. validate.
+    if (!array_key_exists($schedule->start_action_date, $this->getDateFields())) {
+      throw new CRM_Core_Exception("Invalid date field");
+    }
+
+    $query['casDateField'] = $schedule->start_action_date;
+    $query['casAddlCheckFrom'] = 'civicrm_case c';
+    $query['casContactIdField'] = 'ct.id';
+    $query['casEntityIdField'] = 'r.case_id';
+    $query['casContactTableAlias'] = 'ct';
+    $query->where('r.is_active = 1 AND c.is_deleted = 0');
+
+    return $query;
+  }
+}

Civi/ActionSchedule/Mapping.php

@@ -298,6 +298,8 @@ protected static function getValueLabelMap($name) {
       $valueLabelMap['auto_renew_options'] = \CRM_Core_OptionGroup::values('auto_renew_options');
       $valueLabelMap['contact_date_reminder_options'] = \CRM_Core_OptionGroup::values('contact_date_reminder_options');
       $valueLabelMap['civicrm_membership_type'] = \CRM_Member_PseudoConstant::membershipType();
+      $valueLabelMap['case_type'] = \CRM_Case_PseudoConstant::caseType();
+      $valueLabelMap['case_status'] = \CRM_Case_PseudoConstant::caseStatus();
 
       $allCustomFields = \CRM_Core_BAO_CustomField::getFields('');
       $dateFields = [

Civi/Core/Container.php

@@ -364,6 +364,7 @@ public function createEventDispatcher($container) {
     $dispatcher->addListener(\Civi\ActionSchedule\Events::MAPPINGS, ['CRM_Contribute_ActionMapping_ByType', 'onRegisterActionMappings']);
     $dispatcher->addListener(\Civi\ActionSchedule\Events::MAPPINGS, ['CRM_Event_ActionMapping', 'onRegisterActionMappings']);
     $dispatcher->addListener(\Civi\ActionSchedule\Events::MAPPINGS, ['CRM_Member_ActionMapping', 'onRegisterActionMappings']);
+    $dispatcher->addListener(\Civi\ActionSchedule\Events::MAPPINGS, ['CRM_Case_ActionMapping', 'onRegisterActionMappings']);
 
     if (\CRM_Utils_Constant::value('CIVICRM_FLEXMAILER_HACK_LISTENERS')) {
       \Civi\Core\Resolver::singleton()->call(CIVICRM_FLEXMAILER_HACK_LISTENERS, [$dispatcher]);

templates/CRM/Admin/Form/ScheduleReminders.tpl

@@ -211,6 +211,40 @@
         showHideLimitTo();
       }
 
+      function caseRolesFilter() {
+        if(!$("#entity_1", $form).val()){
+          return;
+        }
+        var caseType = $("#entity_1", $form).val();
+        CRM.api3('CaseType', 'get', {
+          "id": {"IN":caseType}
+        }).done(function(result) {
+          if (!CRM._.isEmpty(result.values)) {
+            var values = [];
+            CRM._.each(result.values, function(v, i) {
+              CRM._.each(v.definition.caseRoles, function(v2, j) {
+                values.push(v2.name);
+              });
+            });
+            // filter options
+            $("#recipient_listing > option").each(function(i, val) {
+              var text = $(val).text();
+              if ($.inArray(text, values) == -1) {
+                $(this).remove();
+              }
+            });
+          }
+          $("#recipientList", $form).show();
+        });
+      }
+
+      $('#entity_1', $form).change(function () {
+        var recipient = $("#recipient", $form).val();
+        if (recipient == 'case_roles') {
+          populateRecipient();
+        }
+      });
+
       // CRM-14070 Hide limit-to when entity is activity
       function showHideLimitTo() {
         $('#limit_to', $form).toggle(!($('#entity_0', $form).val() == '1'));