0
0
mirror of https://github.com/salesagility/SuiteCRM.git synced 2024-11-21 23:47:57 +00:00
salesagility_SuiteCRM/modules/ProjectTask/ProjectTask.php
2023-07-18 15:53:09 +01:00

607 lines
21 KiB
PHP
Executable File

<?php
/**
*
* SugarCRM Community Edition is a customer relationship management program developed by
* SugarCRM, Inc. Copyright (C) 2004-2013 SugarCRM Inc.
*
* SuiteCRM is an extension to SugarCRM Community Edition developed by SalesAgility Ltd.
* Copyright (C) 2011 - 2021 SalesAgility Ltd.
*
* This program is free software; you can redistribute it and/or modify it under
* the terms of the GNU Affero General Public License version 3 as published by the
* Free Software Foundation with the addition of the following permission added
* to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
* IN WHICH THE COPYRIGHT IS OWNED BY SUGARCRM, SUGARCRM DISCLAIMS THE WARRANTY
* OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
*
* This program 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 along with
* this program; if not, see http://www.gnu.org/licenses or write to the Free
* Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
* 02110-1301 USA.
*
* You can contact SugarCRM, Inc. headquarters at 10050 North Wolfe Road,
* SW2-130, Cupertino, CA 95014, USA. or at email address contact@sugarcrm.com.
*
* The interactive user interfaces in modified source and object code versions
* of this program must display Appropriate Legal Notices, as required under
* Section 5 of the GNU Affero General Public License version 3.
*
* In accordance with Section 7(b) of the GNU Affero General Public License version 3,
* these Appropriate Legal Notices must retain the display of the "Powered by
* SugarCRM" logo and "Supercharged by SuiteCRM" logo. If the display of the logos is not
* reasonably feasible for technical reasons, the Appropriate Legal Notices must
* display the words "Powered by SugarCRM" and "Supercharged by SuiteCRM".
*/
if (!defined('sugarEntry') || !sugarEntry) {
die('Not A Valid Entry Point');
}
#[\AllowDynamicProperties]
class ProjectTask extends SugarBean
{
// database table columns
public $id;
public $date_entered;
public $date_modified;
public $name;
public $description;
public $project_id;
public $project_task_id;
public $date_start;
public $date_finish;
public $duration;
public $duration_unit;
public $percent_complete;
public $parent_task_id;
public $predecessors;
public $priority;
public $importable = true;
// related information
public $assigned_user_name;
public $parent_name;
public $depends_on_name;
public $email_id;
public $table_name = 'project_task';
public $object_name = 'ProjectTask';
public $module_dir = 'ProjectTask';
public $field_name_map;
public $new_schema = true;
public $relationship_fields = array(
'email_id' => 'emails',
);
/**
* @var bool skip updating parent percent complete
*/
protected $_skipParentUpdate = false;
/**
* ProjectTask constructor.
* @param bool $init
*/
public function __construct($init = true)
{
parent::__construct();
if ($init) {
// default value for a clean instantiation
$this->utilization = 100;
global $current_user;
if (empty($current_user)) {
$this->assigned_user_id = 1;
$admin_user = BeanFactory::newBean('Users');
$admin_user->retrieve($this->assigned_user_id);
$this->assigned_user_name = $admin_user->user_name;
} else {
$this->assigned_user_id = $current_user->id;
$this->assigned_user_name = $current_user->user_name;
}
}
}
/**
* @param bool $skip updating parent percent complete
*/
public function skipParentUpdate($skip = true)
{
$this->_skipParentUpdate = $skip;
}
public function save($check_notify = false)
{
//Bug 46012. When saving new Project Tasks instance in a workflow, make sure we set a project_task_id value
//associated with the Project if there is no project_task_id specified.
if ($this->in_workflow && empty($this->id) && empty($this->project_task_id) && !empty($this->project_id)) {
$this->project_task_id = $this->getNumberOfTasksInProject($this->project_id) + 1;
}
$id = parent::save($check_notify);
if ($this->_skipParentUpdate == false) {
$this->updateStatistic();
}
return $id;
}
/*
*
*/
public function get_summary_text()
{
return $this->name;
}
/*
*
*/
public function _get_depends_on_name($depends_on_id)
{
$return_value = '';
$query = "SELECT name, assigned_user_id FROM {$this->table_name} WHERE id='{$depends_on_id}'";
$result = $this->db->query($query, true, " Error filling in additional detail fields: ");
$row = $this->db->fetchByAssoc($result);
if ($row != null) {
$this->depends_on_name_owner = $row['assigned_user_id'];
$this->depends_on_name_mod = 'ProjectTask';
$return_value = $row['name'];
}
return $return_value;
}
public function _get_project_name($project_id)
{
$return_value = '';
$query = "SELECT name, assigned_user_id FROM project WHERE id='{$project_id}'";
$result = $this->db->query($query, true, " Error filling in additional detail fields: ");
$row = $this->db->fetchByAssoc($result);
if ($row != null) {
//$this->parent_name_owner = $row['assigned_user_id'];
//$this->parent_name_mod = 'Project';
$return_value = $row['name'];
}
return $return_value;
}
/*
*
*/
public function _get_parent_name($parent_id)
{
$return_value = '';
$query = "SELECT name, assigned_user_id FROM project WHERE id='{$parent_id}'";
$result = $this->db->query($query, true, " Error filling in additional detail fields: ");
$row = $this->db->fetchByAssoc($result);
if ($row != null) {
$this->parent_name_owner = $row['assigned_user_id'];
$this->parent_name_mod = 'Project';
$return_value = $row['name'];
}
return $return_value;
}
/*
*
*/
public function build_generic_where_clause($the_query_string)
{
$where_clauses = array();
$the_query_string = DBManagerFactory::getInstance()->quote($the_query_string);
$where_clauses[] = "project_task.name like '$the_query_string%'";
$the_where = "";
foreach ($where_clauses as $clause) {
if ($the_where != "") {
$the_where .= " or ";
}
$the_where .= $clause;
}
return $the_where;
}
public function bean_implements($interface)
{
switch ($interface) {
case 'ACL':
return true;
}
return false;
}
public function listviewACLHelper()
{
$array_assign = parent::listviewACLHelper();
$is_owner = false;
$in_group = false; //SECURITY GROUPS
if (!empty($this->parent_name)) {
if (!empty($this->parent_name_owner)) {
global $current_user;
$is_owner = $current_user->id == $this->parent_name_owner;
}
/* BEGIN - SECURITY GROUPS */
//parent_name_owner not being set for whatever reason so we need to figure this out
else {
if (!empty($this->parent_type) && !empty($this->parent_id)) {
global $current_user;
$parent_bean = BeanFactory::getBean($this->parent_type, $this->parent_id);
if ($parent_bean !== false) {
$is_owner = $current_user->id == $parent_bean->assigned_user_id;
}
}
}
require_once("modules/SecurityGroups/SecurityGroup.php");
$in_group = SecurityGroup::groupHasAccess($this->parent_type, $this->parent_id, 'view');
/* END - SECURITY GROUPS */
}
/* BEGIN - SECURITY GROUPS */
/**
* if(ACLController::checkAccess('Project', 'view', $is_owner)){
*/
if (ACLController::checkAccess('Project', 'view', $is_owner, 'module', $in_group)) {
/* END - SECURITY GROUPS */
$array_assign['PARENT'] = 'a';
} else {
$array_assign['PARENT'] = 'span';
}
$is_owner = false;
if (!empty($this->depends_on_name)) {
if (!empty($this->depends_on_name_owner)) {
global $current_user;
$is_owner = $current_user->id == $this->depends_on_name_owner;
}
}
if (ACLController::checkAccess('ProjectTask', 'view', $is_owner)) {
$array_assign['PARENT_TASK'] = 'a';
} else {
$array_assign['PARENT_TASK'] = 'span';
}
return $array_assign;
}
public function create_export_query($order_by, $where, $relate_link_join = '')
{
$custom_join = $this->getCustomJoin(true, true, $where);
$custom_join['join'] .= $relate_link_join;
$query = "SELECT
project_task.*,
users.user_name as assigned_user_name ";
$query .= $custom_join['select'];
$query .= " FROM project_task LEFT JOIN project ON project_task.project_id=project.id AND project.deleted=0 ";
$query .= $custom_join['join'];
$query .= " LEFT JOIN users
ON project_task.assigned_user_id=users.id ";
$where_auto = " project_task.deleted=0 ";
if ($where != "") {
$query .= "where ($where) AND " . $where_auto;
} else {
$query .= "where " . $where_auto;
}
if (!empty($order_by)) {
//check to see if order by variable already has table name by looking for dot "."
$table_defined_already = strpos((string) $order_by, ".");
if ($table_defined_already === false) {
//table not defined yet, define accounts to avoid "ambigous column" SQL error
$query .= " ORDER BY $order_by";
} else {
//table already defined, just add it to end of query
$query .= " ORDER BY $order_by";
}
}
return $query;
}
/**
* This method recalculates the percent complete of a parent task
*/
public function updateParentProjectTaskPercentage()
{
if (empty($this->parent_task_id)) {
return;
}
if (!empty($this->project_id)) {
//determine parent task
$parentProjectTask = $this->getProjectTaskParent();
//get task children
if ($parentProjectTask) {
$subProjectTasks = $parentProjectTask->getAllSubProjectTasks();
$tasks = array();
foreach ($subProjectTasks as &$task) {
$tasks[] = $task->toArray(true);
}
$parentProjectTask->percent_complete = $this->_calculateCompletePercent($tasks);
unset($tasks);
$parentProjectTask->save(isset($GLOBALS['check_notify']) ? $GLOBALS['check_notify'] : '');
}
}
}
/**
* Calculate percent complete for parent task based on it's children tasks
* @param $subProjectTasks mixed Array of children tasks
* @return int percent complete
*/
private function _calculateCompletePercent(&$subProjectTasks)
{
$totalHours = 0;
$cumulativeDone = 0;
//update cumulative calculation - mimics gantt calculation
foreach ($subProjectTasks as $key => &$value) {
if ($value['duration'] == "") {
$value['duration'] = 0;
}
if ($value['percent_complete'] == "") {
$value['percent_complete'] = 0;
}
if ($value['duration_unit'] == "Hours") {
$totalHours += $value['duration'];
$cumulativeDone += $value['duration'] * ($value['percent_complete'] / 100);
} else {
$totalHours += ($value['duration'] * 8);
$cumulativeDone += ($value['duration'] * 8) * ($value['percent_complete'] / 100);
}
}
$cumulativePercentage = 0;
if ($totalHours != 0) {
$cumulativePercentage = round(($cumulativeDone / $totalHours) * 100);
}
return $cumulativePercentage;
}
/**
* Retrieves the parent project task of a project task
* returns project task bean
*/
public function getProjectTaskParent()
{
$projectTaskParent = false;
if (!empty($this->parent_task_id) && !empty($this->project_id)) {
$query = "SELECT id FROM project_task WHERE project_id = '{$this->project_id}' AND project_task_id = '{$this->parent_task_id}' AND deleted = 0 ORDER BY date_modified DESC";
$project_task_id = $this->db->getOne($query, true, "Error retrieving parent project task");
if (!empty($project_task_id)) {
$projectTaskParent = BeanFactory::getBean('ProjectTask', $project_task_id);
}
}
return $projectTaskParent;
}
/**
* Retrieves all the child project tasks of a project task
* returns project task bean array
*/
public function getAllSubProjectTasks()
{
$potentialParentTaskIds = [];
$projectTasksBeans = array();
if (!empty($this->project_task_id) && !empty($this->project_id)) {
//select all tasks from a project
$query = "SELECT id, project_task_id, parent_task_id FROM project_task WHERE project_id = '{$this->project_id}' AND deleted = 0 ORDER BY project_task_id";
$result = $this->db->query($query, true, "Error retrieving child project tasks");
$projectTasks = array();
while ($row = $this->db->fetchByAssoc($result)) {
$projectTasks[$row['id']]['project_task_id'] = $row['project_task_id'];
$projectTasks[$row['id']]['parent_task_id'] = $row['parent_task_id'];
}
$potentialParentTaskIds[$this->project_task_id] = $this->project_task_id;
$actualParentTaskIds = array();
$subProjectTasks = array();
$startProjectTasksCount = 0;
$endProjectTasksCount = 0;
//get all child tasks
$run = true;
while ($run) {
$count = 0;
foreach ($projectTasks as $id => $values) {
if (in_array($values['parent_task_id'], $potentialParentTaskIds)) {
$potentialParentTaskIds[$values['project_task_id']] = $values['project_task_id'];
$actualParentTaskIds[$values['parent_task_id']] = $values['parent_task_id'];
$subProjectTasks[$id] = $values;
$count = $count + 1;
}
}
$endProjectTasksCount = count($subProjectTasks);
if ($startProjectTasksCount === $endProjectTasksCount) {
$run = false;
} else {
$startProjectTasksCount = $endProjectTasksCount;
}
}
foreach ($subProjectTasks as $id => $values) {
//ignore tasks that are parents
if (!in_array($values['project_task_id'], $actualParentTaskIds)) {
$projectTaskBean = BeanFactory::getBean('ProjectTask', $id);
$projectTasksBeans[] = $projectTaskBean;
}
}
}
return $projectTasksBeans;
}
/**
* getNumberOfTasksInProject
*
* Returns the count of project_tasks for the given project_id
*
* This is a private helper function to get the number of project tasks for a given project_id.
*
* @param $project_id integer value of the project_id associated with this ProjectTask instance
* @return int total integer value of the count of project tasks, 0 if none found
*/
private function getNumberOfTasksInProject($project_id = '')
{
if (!empty($project_id)) {
$query = "SELECT count(project_task_id) AS total FROM project_task WHERE project_id = '{$project_id}'";
$result = $this->db->query($query, true);
if ($result) {
$row = $this->db->fetchByAssoc($result);
if (!empty($row['total'])) {
return $row['total'];
}
}
}
return 0;
}
/**
* Update percent complete for project tasks with children tasks based on children's values
*/
public function updateStatistic()
{
/**
* @var array Array of tasks for current project
*/
$list = array();
/**
* @var array Key-value array of project_task_id => parent_task_id
*/
$tree = array();
/**
* @var array Array with nodes which have childrens
*/
$nodes = array();
/**
* @var array Array with IDs of list which have been changed
*/
$changed = array();
$db = DBManagerFactory::getInstance();
$this->disable_row_level_security = true;
$query = $this->create_new_list_query('', "project_id = {$db->quoted($this->project_id)}");
$this->disable_row_level_security = false;
$res = $db->query($query);
while ($row = $db->fetchByAssoc($res)) {
$list[] = $row;
}
// fill in $tree
foreach ($list as $k => &$v) {
if (isset($v['project_task_id']) && $v['project_task_id'] != '') {
$tree[$v['project_task_id']] = $v['parent_task_id'];
if (isset($v['parent_task_id']) && $v['parent_task_id']) {
if (!isset($nodes[$v['parent_task_id']])) {
$nodes[$v['parent_task_id']] = 1;
}
}
}
}
unset($v);
// fill in $nodes array
foreach ($nodes as $k => &$v) {
$run = true;
$i = $k;
while ($run) {
if (isset($tree[$i]) && $tree[$i] != '') {
$i = $tree[$i];
$v++;
} else {
$run = false;
}
}
}
arsort($nodes);
unset($v);
// calculating of percentages and comparing calculated value with database one
foreach ($nodes as $k => &$v) {
$currRow = null;
$currChildren = array();
$run = true;
$tmp = array();
$i = $k;
while ($run) {
foreach ($list as $id => &$taskRow) {
if ($taskRow['project_task_id'] == $i && $currRow === null) {
$currRow = $id;
}
if ($taskRow['parent_task_id'] == $i) {
if (!array_key_exists($taskRow['project_task_id'], $nodes)) {
$currChildren[] = $taskRow;
} else {
$tmp[] = $taskRow['project_task_id'];
}
}
}
unset($taskRow);
if (count($tmp) == 0) {
$run = false;
} else {
$i = array_shift($tmp);
}
}
$subres = $this->_calculateCompletePercent($currChildren);
if ($subres != $list[$currRow]['percent_complete']) {
$list[$currRow]['percent_complete'] = $subres;
$changed[] = $currRow;
}
}
unset($v);
// updating data in database for changed tasks
foreach ($changed as $k => &$v) {
$task = BeanFactory::getBean('ProjectTask');
$task->populateFromRow($list[$v]);
$task->skipParentUpdate();
$task->save(false);
}
}
}
function getUtilizationDropdown($focus, $field, $value, $view)
{
if ($view === 'EditView') {
global $app_list_strings;
$html = '<select name="' . $field . '">';
$html .= get_select_options_with_id($app_list_strings['project_task_utilization_options'], $value);
$html .= '</select>';
return $html;
}
return translate('project_task_utilization_options', '', $focus->$field);
}