293 lines
12 KiB
PHP
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->code), 'code', 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§ion=browse&key=stageCustom");
|
|
$ganttFields = $this->setting->getItem("owner=$owner&module=$module§ion=ganttCustom&key=ganttFields");
|
|
$zooming = $this->setting->getItem("owner=$owner&module=$module§ion=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§ion=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();
|
|
}
|
|
}
|