Files
EasySoft-ZenTaoPMS/module/programplan/zen.php
T

293 lines
12 KiB
PHP

<?php
declare(strict_types=1);
/**
* The zen file of programplan module of ZenTaoPMS.
*
* @copyright Copyright 2009-2023 禅道软件(青岛)有限公司(ZenTao Software (Qingdao) Co., Ltd. www.zentao.net)
* @license ZPL(https://zpl.pub/page/zplv12.html) or AGPL(https://www.gnu.org/licenses/agpl-3.0.en.html)
* @author lanzongjun <lanzongjun@easycorp.ltd>
* @link https://www.zentao.net
*/
class programplanZen extends programplan
{
/**
* Process formData before use it to create programplan.
*
* @param object $formData
* @access protected
* @return object
*/
protected function beforeCreate(object $formData): object
{
$formData->setIf(empty($formData->data->codes), 'codes', array());
$formData->setIf(empty($formData->data->output), 'output', array());
return $formData;
}
/**
* 生成创建项目阶段视图数据。
* Build create view data.
*
* @param object $viewData
* @access protected
* @return void
*/
public function buildCreateView(object $viewData)
{
/* Compute fields for create view. */
list($visibleFields, $requiredFields, $customFields, $showFields, $defaultFields) = $this->computeFieldsCreateView($viewData->executionType);
$this->view->title = $this->lang->programplan->create . $this->lang->colon . $viewData->project->name;
$this->view->productList = $viewData->productList;
$this->view->project = $viewData->project;
$this->view->productID = $viewData->productID ?: key($viewData->productList);
$this->view->stages = empty($viewData->planID) ? $this->loadModel('stage')->getStages('id_asc', 0, $viewData->project->model) : array();
$this->view->programPlan = $viewData->programPlan;
$this->view->plans = empty($viewData->executions) ? $viewData->plans : $viewData->executions;
$this->view->planID = $viewData->planID;
$this->view->type = 'lists';
$this->view->executionType = $viewData->executionType;
$this->view->PMUsers = $this->loadModel('user')->getPairs('noclosed|nodeleted|pmfirst', $viewData->project->PM);
$this->view->custom = $viewData->executionType == 'stage' ? 'custom' : 'customAgilePlus';
$this->view->customFields = $customFields;
$this->view->showFields = $showFields;
$this->view->visibleFields = $visibleFields;
$this->view->requiredFields = $requiredFields;
$this->view->defaultFields = $defaultFields;
$this->view->colspan = count($visibleFields) + 3;
$this->view->enableOptionalAttr = empty($viewData->programPlan) || (!empty($viewData->programPlan) && $viewData->programPlan->attribute == 'mix');
$this->display();
}
/**
* 处理编辑阶段的请求数据。
* Processing edit request data.
*
* @param object $formData
* @access protected
* @return object
*/
protected function beforeEdit(object $formData): object
{
$rowData = $formData->data;
return isset($rowData->output) ? $formData->join('output', ',')->get() : $rowData;
}
/**
* 阶段编辑后数据处理。
* Handle data after edit.
*
* @param object $plan
* @param array $changes
* @access protected
* @return void
*/
protected function afterEdit(object $plan, array $changes)
{
$actionID = $this->loadModel('action')->create('execution', $plan->id, 'edited');
$this->action->logHistory($actionID, $changes);
$newPlan = $this->programplan->getByID($plan->id);
if($plan->parent != $newPlan->parent)
{
$this->programplan->computeProgress($plan->id, 'edit');
$this->programplan->computeProgress($plan->parent, 'edit', true);
}
}
/**
* 生成编辑阶段数据。
* Build edit view data.
*
* @param object $plan
* @access protected
* @return void
*/
protected function buildEditView(object $plan)
{
$this->loadModel('project');
$this->app->loadLang('execution');
$this->app->loadLang('stage');
$parentStage = $this->project->getByID($plan->parent, 'stage');
$this->view->title = $this->lang->programplan->edit;
$this->view->isCreateTask = $this->programplan->isCreateTask($plan->id);
$this->view->plan = $plan;
$this->view->parentStageList = $this->programplan->getParentStageList($this->session->project, $plan->id, $plan->product);
$this->view->enableOptionalAttr = empty($parentStage) || (!empty($parentStage) && $parentStage->attribute == 'mix');
$this->view->isTopStage = $this->programplan->isTopStage($plan->id);
$this->view->isLeafStage = $this->programplan->checkLeafStage($plan->id);
$this->view->PMUsers = $this->loadModel('user')->getPairs('noclosed|nodeleted|pmfirst', $plan->PM);
$this->display();
}
/**
* 处理请求数据
* Processing request data.
*
* @param object $formData
* @param string $owner
* @param string $module
* @access protected
* @return object
*/
protected function beforeAjaxCustom(object $formData, string $owner, string $module): object
{
$data = $formData->get();
$zooming = empty($data->zooming) ? '' : $data->zooming;
$stageCustom = empty($data->stageCustom) ? '' : implode(',', $data->stageCustom);
$ganttFields = empty($data->ganttFields) ? '' : implode(',', $data->ganttFields);
$this->setting->setItem("$owner.$module.browse.stageCustom", $stageCustom);
$this->setting->setItem("$owner.$module.ganttCustom.ganttFields", $ganttFields);
$this->setting->setItem("$owner.$module.ganttCustom.zooming", $zooming);
return $data;
}
/**
* 生成自定义设置视图。
* Build custom setting view form data.
*
* @param string $owner
* @param string $module
* @param array $customFields
* @access protected
* @return void
*/
protected function buildAjaxCustomView(string $owner, string $module, array $customFields)
{
$stageCustom = $this->setting->getItem("owner=$owner&module=$module&section=browse&key=stageCustom");
$ganttFields = $this->setting->getItem("owner=$owner&module=$module&section=ganttCustom&key=ganttFields");
$zooming = $this->setting->getItem("owner=$owner&module=$module&section=ganttCustom&key=zooming");
$this->view->zooming = $zooming;
$this->view->customFields = $customFields;
$this->view->showFields = $this->config->programplan->ganttCustom->ganttFields;
$this->view->ganttFields = $ganttFields;
$this->view->stageCustom = $stageCustom;
$this->display();
}
/**
* 计算创建视图的可见字段字段和必填字段。
* Compute visibleFields and requiredFields for create view.
*
* @param string $executionType
* @access protected
* @return array
*/
protected function computeFieldsCreateView(string $executionType): array
{
$visibleFields = array();
$requiredFields = array();
$customFields = array();
$custom = $executionType == 'stage' ? 'custom' : 'customAgilePlus';
$customCreateFields = $executionType == 'stage' ? 'customCreateFields' : 'customAgilePlusCreateFields';
$defaultFields = $this->config->programplan->$custom->defaultFields;
foreach(explode(',', $this->config->programplan->$customCreateFields) as $field) $customFields[$field] = $this->lang->programplan->{$field};
$showFields = $this->config->programplan->$custom->createFields;
foreach(explode(',', $showFields) as $field)
{
if($field) $visibleFields[$field] = '';
}
foreach(explode(',', $this->config->programplan->create->requiredFields) as $field)
{
if($field)
{
$requiredFields[$field] = '';
if(strpos(",{$this->config->programplan->$customCreateFields},", ",{$field},") !== false) $visibleFields[$field] = '';
}
}
if(empty($this->config->setPercent)) unset($visibleFields['percent'], $requiredFields['percent']);
return array($visibleFields, $requiredFields, $customFields, $showFields, $defaultFields);
}
/**
* 生成阶段列表页阶段数据。
* Build gantt browse stage view data.
*
* @param int $projectID
* @param int $productID
* @param int $baselineID
* @param string $type
* @param string $orderBy
* @access protected
* @return array
*/
protected function buildStages(int $projectID, int $productID, int $baselineID, string $type, string $orderBy): array
{
$stages = array();
$selectCustom = 0; // Display date and task settings.
$dateDetails = 1; // Gantt chart detail date display.
/* Get data of type lists. */
if($type == 'lists')
{
$sort = common::appendOrder($orderBy);
$stages = $this->programplan->getPlans($projectID, $productID, $sort);
$this->view->dateDetails = $dateDetails;
return $stages;
}
/* Obtain user page configuration items. */
$owner = $this->app->user->account;
if(!isset($this->config->programplan->browse->stageCustom)) $this->loadModel('setting')->setItem("$owner.programplan.browse.stageCustom", 'date,task');
$selectCustom = $this->loadModel('setting')->getItem("owner={$owner}&module=programplan&section=browse&key=stageCustom");
$dateDetails = strpos($selectCustom, 'date') !== false ? 0 : 1; // Gantt chart detail date display.
foreach(explode(',', $this->config->programplan->custom->customGanttFields) as $field) $customFields[$field] = $this->lang->programplan->ganttCustom[$field];
$this->view->customFields = $customFields;
$this->view->showFields = $this->config->programplan->ganttCustom->ganttFields;
$this->view->dateDetails = $dateDetails;
$this->view->selectCustom = $selectCustom;
/* Get data for gantt. */
if($type == 'gantt' ) $stages = $this->programplan->getDataForGantt($projectID, $productID, $baselineID, $selectCustom, false);
if($type == 'assignedTo') $stages = $this->programplan->getDataForGanttGroupByAssignedTo($projectID, $productID, $baselineID, $selectCustom, false);
return $stages;
}
/**
* 生成gantt图视图数据。
* Build gantt browse view.
*
* @param int $projectID
* @param int $productID
* @param array $stages
* @param string $type
* @param string $orderBy
* @access protected
* @return void
*/
protected function buildBrowseView(int $projectID, int $productID, array $stages, string $type, string $orderBy): void
{
$this->view->title = $this->lang->programplan->browse;
$this->view->projectID = $projectID;
$this->view->productID = $productID;
$this->view->type = $type;
$this->view->ganttType = $type;
$this->view->stages = $stages;
$this->view->orderBy = $orderBy;
$this->view->project = $this->loadModel('project')->getByID($projectID);
$this->view->users = $this->loadModel('user')->getPairs('noletter');
$this->view->product = $this->loadModel('product')->getByID($productID);
$this->view->productList = $this->loadModel('product')->getProductPairsByProject($projectID, 'all', '', false);
$this->view->zooming = !empty($this->config->programplan->ganttCustom->zooming) ? $this->config->programplan->ganttCustom->zooming : 'day';
$this->display();
}
}