1995 lines
84 KiB
PHP
Executable File
1995 lines
84 KiB
PHP
Executable File
<?php
|
|
declare(strict_types=1);
|
|
/**
|
|
* The control file of story module of ZenTaoPMS.
|
|
*
|
|
* @copyright Copyright 2009-2023 禅道软件（青岛）有限公司(ZenTao Software (Qingdao) Co., Ltd. www.cnezsoft.com)
|
|
* @license ZPL(http://zpl.pub/page/zplv12.html) or AGPL(https://www.gnu.org/licenses/agpl-3.0.en.html)
|
|
* @author Chunsheng Wang <chunsheng@cnezsoft.com>
|
|
* @package story
|
|
* @version $Id: control.php 5145 2013-07-15 06:47:26Z chencongzhi520@gmail.com $
|
|
* @link https://www.zentao.net
|
|
*/
|
|
class story extends control
|
|
{
|
|
/**
|
|
* The construct function, load product, tree, user auto.
|
|
*
|
|
* @param string $module
|
|
* @param string $method
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function __construct(string $module = '', string $method = '')
|
|
{
|
|
parent::__construct($module, $method);
|
|
$this->loadModel('product');
|
|
$this->loadModel('project');
|
|
$this->loadModel('execution');
|
|
$this->loadModel('tree');
|
|
$this->loadModel('user');
|
|
$this->loadModel('action');
|
|
|
|
if($this->app->rawModule == 'projectstory') $this->app->tab = 'project';
|
|
}
|
|
|
|
/**
|
|
* Create a story.
|
|
*
|
|
* @param int $productID
|
|
* @param int $branch
|
|
* @param int $moduleID
|
|
* @param int $storyID
|
|
* @param int $objectID projectID|executionID
|
|
* @param int $bugID
|
|
* @param int $planID
|
|
* @param int $todoID
|
|
* @param string $extra for example feedbackID=0
|
|
* @param string $storyType requirement|story
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function create(int $productID = 0, string $branch = '', int $moduleID = 0, int $storyID = 0, int $objectID = 0, int $bugID = 0, int $planID = 0, int $todoID = 0, string $extra = '', string $storyType = 'story')
|
|
{
|
|
/* Set menu. */
|
|
$this->story->replaceURLang($storyType);
|
|
$copyStoryID = $storyID;
|
|
list($productID, $objectID) = $this->storyZen->setMenuForCreate($productID, $objectID);
|
|
if($productID == 0 && $objectID == 0) return $this->locate($this->createLink('product', 'create'));
|
|
|
|
if(!empty($_POST))
|
|
{
|
|
if(isset($_POST['module'])) $moduleID = $this->post->module;
|
|
if(isset($_POST['modules'])) $moduleID = reset($_POST['modules']);
|
|
helper::setcookie('lastStoryModule', $moduleID, $this->config->cookieLife, $this->config->webRoot, '', $this->config->cookieSecure, false);
|
|
|
|
/* Get story data from post. */
|
|
$storyData = $this->storyZen->buildStoryForCreate($objectID, $bugID);
|
|
if(!$storyData) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
|
|
$response = $this->storyZen->checkRepeatStory($storyData, $objectID);
|
|
if($response) return $this->send($response);
|
|
|
|
/* Insert story data. */
|
|
$createFunction = empty($storyData->branches) ? 'create' : 'createTwins';
|
|
$storyID = $this->story->{$createFunction}($storyData, $objectID, $bugID, $extra, $todoID);
|
|
if(empty($storyID) || dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
|
|
$productID = $this->post->product ? $this->post->product : $productID;
|
|
$message = $this->executeHooks($storyID);
|
|
if(empty($message)) $message = $this->post->status == 'draft' ? $this->lang->story->saveDraftSuccess : $this->lang->saveSuccess;
|
|
if($this->viewType == 'json') return $this->send(array('result' => 'success', 'message' => $message, 'id' => $storyID));
|
|
|
|
/* Get response when create in modal. */
|
|
$response = $this->storyZen->getResponseInModal($message);
|
|
if($response) return $this->send($response);
|
|
|
|
$response = array('result' => 'success', 'message' => $message);
|
|
if($this->post->newStory)
|
|
{
|
|
$response['message'] = $message . $this->lang->story->newStory;
|
|
$response['load'] = $this->createLink('story', 'create', "productID=$productID&branch=$branch&moduleID=$moduleID&story=$copyStoryID&objectID=$objectID&bugID=$bugID&planID=$planID&todoID=$todoID&extra=$extra&storyType=$storyType");
|
|
return $this->send($response);
|
|
}
|
|
|
|
$response['load'] = $this->storyZen->getAfterCreateLocation((int)$productID, $branch, $objectID, $storyID, $storyType);
|
|
return $this->send($response);
|
|
}
|
|
|
|
/* Init vars. */
|
|
$initStory = $this->storyZen->initStoryForCreate($planID, $copyStoryID, $bugID, $todoID);
|
|
|
|
/* Get form fields. */
|
|
$this->storyZen->setViewVarsForKanban($objectID, $this->story->parseExtra($extra));
|
|
$fields = $this->storyZen->getFormFieldsForCreate($productID, $branch, $objectID, $initStory);
|
|
$fields = $this->storyZen->setModuleField($fields, $moduleID);
|
|
$fields = $this->storyZen->removeFormFieldsForCreate($fields, $storyType);
|
|
|
|
$this->view->title = $this->view->product->name . $this->lang->colon . $this->lang->story->create;
|
|
$this->view->fields = $fields;
|
|
$this->view->blockID = $this->storyZen->getAssignMeBlockID();
|
|
$this->view->type = $storyType;
|
|
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* Create a batch stories.
|
|
*
|
|
* @param int $productID
|
|
* @param string $branch
|
|
* @param int $moduleID
|
|
* @param int $storyID
|
|
* @param int $executionID projectID|executionID
|
|
* @param int $plan
|
|
* @param string $storyType requirement|story
|
|
* @param string $extra for example feedbackID=0
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function batchCreate(int $productID = 0, string $branch = '', int $moduleID = 0, int $storyID = 0, int $executionID = 0, int $plan = 0, string $storyType = 'story', string $extra = '')
|
|
{
|
|
$this->story->replaceURLang($storyType);
|
|
|
|
if(!empty($_POST))
|
|
{
|
|
$result = $this->loadModel('common')->removeDuplicate('story', $_POST, "product={$productID}");
|
|
$_POST = $result['data'];
|
|
|
|
$stories = $this->storyZen->buildStoriesForBatchCreate($productID, $storyType);
|
|
if(empty($stories)) return $this->sendError($this->lang->error->noData, true);
|
|
if(dao::isError()) return $this->sendError(dao::getError(), true);
|
|
|
|
$storyIdList = $this->story->batchCreate($stories, $productID, $branch, $storyType, $storyID);
|
|
if(dao::isError()) return $this->sendError(dao::getError(), true);
|
|
|
|
/* Project or execution linked stories. */
|
|
if($executionID)
|
|
{
|
|
$lanes = array();
|
|
$products = array();
|
|
foreach($storyIdList as $i => $newStoryID)
|
|
{
|
|
if(isset($_POST['lanes'])) $lanes[$newStoryID] = $_POST['lanes'][$i];
|
|
$products[$newStoryID] = $productID;
|
|
}
|
|
|
|
if($this->session->project && $executionID != $this->session->project) $this->execution->linkStory($this->session->project, $storyIdList);
|
|
$this->execution->linkStory($executionID, $storyIdList, $extra, $lanes);
|
|
}
|
|
|
|
if($this->viewType == 'json') return $this->send(array('result' => 'success', 'message' => $this->lang->saveSuccess, 'idList' => $stories));
|
|
if(isInModal()) return $this->send($this->storyZen->getResponseInModal($this->lang->saveSuccess));
|
|
|
|
$locateLink = $this->storyZen->getAfterBatchCreateLocation($productID, $branch, $executionID, $storyID, $storyType);
|
|
return $this->send(array('result' => 'success', 'message' => $this->lang->saveSuccess, 'locate' => $locateLink));
|
|
}
|
|
|
|
$this->storyZen->setMenuForBatchCreate($productID, $branch, $executionID, $extra);
|
|
|
|
/* Check can subdivide or not. */
|
|
$product = $this->product->getByID($productID);
|
|
if($product) $this->lang->product->branch = sprintf($this->lang->product->branch, $this->lang->product->branchName[$product->type]);
|
|
if($storyID)
|
|
{
|
|
$story = $this->story->getByID($storyID);
|
|
$this->view->storyTitle = isset($story->title) ? $story->title : '';
|
|
if(!$this->story->checkCanSubdivide($story, !empty($product->shadow))) return $this->send(array('result' => 'fail', 'message' => $this->lang->story->errorNotSubdivide, 'load' => array('alert' => $this->lang->story->errorNotSubdivide)));
|
|
}
|
|
|
|
/* The 'batchCreateFields' of global variable $config will be changed and used by the following business logic. */
|
|
$customFields = $this->storyZen->getCustomFields($this->config, $storyType, $this->view->hiddenPlan, $product);
|
|
$showFields = $this->storyZen->getShowFields($this->config->story->custom->batchCreateFields, $storyType, $product);
|
|
|
|
$fields = $this->storyZen->getFormFieldsForBatchCreate($productID, $branch, $executionID, $storyType);
|
|
$fields = $this->storyZen->removeFormFieldsForBatchCreate($fields, $this->view->hiddenPlan, isset($this->view->execution) ? $this->view->execution->type : '');
|
|
|
|
$this->view->title = $product->name . $this->lang->colon . ($storyID ? $this->lang->story->subdivide : $this->lang->story->batchCreate);
|
|
$this->view->customFields = $customFields;
|
|
$this->view->showFields = $showFields;
|
|
$this->view->product = $product;
|
|
$this->view->branch = $branch;
|
|
$this->view->productID = $productID;
|
|
$this->view->storyID = $storyID;
|
|
$this->view->moduleID = $moduleID;
|
|
$this->view->executionID = $executionID;
|
|
$this->view->type = $storyType;
|
|
$this->view->fields = $fields;
|
|
$this->view->stories = $this->storyZen->getDataFromUploadImages($productID, $moduleID, $plan);
|
|
$this->view->storyTitle = isset($story->title) ? $story->title : '';
|
|
$this->view->forceReview = $this->story->checkForceReview();
|
|
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* The common action when edit or change a story.
|
|
*
|
|
* @param int $storyID
|
|
* @param int $projectID
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function commonAction(int $storyID, int $projectID = 0)
|
|
{
|
|
/* Get datas. */
|
|
$story = $this->story->getByID($storyID);
|
|
$this->story->replaceURLang($story->type);
|
|
|
|
/* Set menu. */
|
|
if($this->app->tab == 'project')
|
|
{
|
|
if(empty($projectID)) $projectID = $this->session->project;
|
|
$this->loadModel('project')->setMenu($projectID);
|
|
$this->view->projectID = $projectID;
|
|
}
|
|
elseif($this->app->tab == 'execution')
|
|
{
|
|
if(empty($projectID)) $projectID = $this->session->execution;
|
|
$this->loadModel('execution')->setMenu($projectID);
|
|
$this->view->executionID = $projectID;
|
|
}
|
|
elseif($this->app->tab == 'qa')
|
|
{
|
|
$this->loadModel('qa')->setMenu($story->product);
|
|
}
|
|
else
|
|
{
|
|
$this->product->setMenu($story->product, $story->branch);
|
|
}
|
|
|
|
/* Assign. */
|
|
$this->view->product = $this->product->getByID($story->product);
|
|
$this->view->productID = $this->view->product->id;
|
|
$this->view->products = $this->product->getPairs();
|
|
$this->view->story = $story;
|
|
$this->view->moduleOptionMenu = $this->tree->getOptionMenu($story->product, 'story', 0, $story->branch);
|
|
$this->view->plans = $this->loadModel('productplan')->getPairs($story->product, 0, '', true);
|
|
$this->view->actions = $this->action->getList('story', $storyID);
|
|
}
|
|
|
|
/**
|
|
* Edit a story.
|
|
*
|
|
* @param int $storyID
|
|
* @param string $kanbanGroup
|
|
* @param string $storyType story|requirement
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function edit(int $storyID, string $kanbanGroup = 'default', string $storyType = 'story')
|
|
{
|
|
$this->loadModel('file');
|
|
$this->app->loadLang('bug');
|
|
$this->commonAction($storyID);
|
|
|
|
if(!empty($_POST))
|
|
{
|
|
$storyData = $this->storyZen->buildStoryForEdit($storyID);
|
|
if(!$storyData) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
|
|
$this->storyZen->processDataForEdit($storyID, $storyData);
|
|
$this->story->update($storyID, $storyData, $this->post->comment);
|
|
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
|
|
$message = $this->executeHooks($storyID);
|
|
if(empty($message)) $message = $this->lang->saveSuccess;
|
|
if(defined('RUN_MODE') && RUN_MODE == 'api') return $this->send(array('status' => 'success', 'data' => $storyID));
|
|
|
|
$response = $this->storyZen->getResponseInModal($message);
|
|
if($response) return $this->send($response);
|
|
|
|
$params = $this->app->rawModule == 'story' ? "storyID=$storyID&version=0¶m=0&storyType=$storyType" : "storyID=$storyID";
|
|
return $this->send(array('result' => 'success', 'load' => $this->createLink($this->app->rawModule, 'view', $params), 'closeModal' => true, 'message' => $message));
|
|
}
|
|
|
|
$story = $this->story->getByID($storyID);
|
|
if($story->type == 'requirement') $this->lang->story->notice->reviewerNotEmpty = str_replace($this->lang->SRCommon, $this->lang->URCommon, $this->lang->story->notice->reviewerNotEmpty);
|
|
|
|
$fields = $this->storyZen->getFormFieldsForEdit($storyID);
|
|
$fields = $this->storyZen->hiddenFormFieldsForEdit($fields);
|
|
|
|
$this->view->title = $this->lang->story->edit . "STORY" . $this->lang->colon . $this->view->story->title;
|
|
$this->view->story = $story;
|
|
$this->view->twins = empty($story->twins) ? array() : $this->story->getByList($story->twins);
|
|
$this->view->fields = $fields;
|
|
$this->view->branches = $this->view->product->type == 'normal' ? array() : $this->loadModel('branch')->getPairs($story->product);
|
|
$this->view->lastReviewer = $this->story->getLastReviewer($story->id);
|
|
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* Batch edit story.
|
|
*
|
|
* @param int $productID
|
|
* @param int $executionID
|
|
* @param int $branch
|
|
* @param string $storyType
|
|
* @param string $from
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function batchEdit(int $productID = 0, int $executionID = 0, string $branch = '', string $storyType = 'story', string $from = '')
|
|
{
|
|
$this->story->replaceURLang($storyType);
|
|
$this->storyZen->setMenuForBatchEdit($productID, $branch, $executionID, $from);
|
|
|
|
/* Load model. */
|
|
$this->loadModel('productplan');
|
|
if($this->post->title)
|
|
{
|
|
$stories = $this->storyZen->buildStoriesForBatchEdit();
|
|
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
|
|
$this->story->batchUpdate($stories);
|
|
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
|
|
return $this->send(array('result' => 'success', 'message' => $this->lang->saveSuccess, 'load' => array('back' => true)));
|
|
}
|
|
|
|
$stories = $this->storyZen->getStoriesByChecked();
|
|
if(!$stories) return $this->send(array('result' => 'success', 'load' => $this->session->storyList));
|
|
|
|
/* Set Custom*/
|
|
foreach(explode(',', $this->config->story->list->customBatchEditFields) as $field) $customFields[$field] = $this->lang->story->$field;
|
|
$showFields = $this->config->story->custom->batchEditFields;
|
|
if($storyType == 'requirement')
|
|
{
|
|
unset($customFields['plan'], $customFields['stage']);
|
|
$showFields = str_replace(array('plan', 'stage'), '', $showFields);
|
|
}
|
|
|
|
$product = $this->product->getByID($productID);
|
|
if($product && $product->type == 'normal') unset($customFields['branch']);
|
|
$this->view->customFields = $customFields;
|
|
$this->view->showFields = $showFields;
|
|
|
|
$this->storyZen->setFormOptionsForBatchEdit($productID, $executionID, $stories);
|
|
|
|
$this->view->title = $this->lang->story->batchEdit;
|
|
$this->view->productID = $productID;
|
|
$this->view->branch = $branch;
|
|
$this->view->storyType = $storyType;
|
|
$this->view->stories = $stories;
|
|
$this->view->executionID = $executionID;
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* Change a story.
|
|
*
|
|
* @param int $storyID
|
|
* @param string $from
|
|
* @param string $storyType story|requirement
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function change(int $storyID, string $from = '', string $storyType = 'story')
|
|
{
|
|
if(!empty($_POST))
|
|
{
|
|
$storyData = $this->storyZen->buildStoryForChange($storyID);
|
|
if(!$storyData) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
|
|
$changes = $this->story->change($storyID, $storyData);
|
|
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
|
|
if($this->post->comment != '' or !empty($changes))
|
|
{
|
|
$action = !empty($changes) ? 'Changed' : 'Commented';
|
|
$actionID = $this->action->create('story', $storyID, $action, $this->post->comment);
|
|
$this->action->logHistory($actionID, $changes);
|
|
|
|
/* Record submit review action. */
|
|
$story = $this->story->fetchByID($storyID);
|
|
if($story->status == 'reviewing') $this->action->create('story', $storyID, 'submitReview');
|
|
}
|
|
|
|
$message = $this->executeHooks($storyID);
|
|
if(empty($message)) $message = $this->lang->saveSuccess;
|
|
if(defined('RUN_MODE') and RUN_MODE == 'api') return $this->send(array('status' => 'success', 'data' => $storyID));
|
|
|
|
$response = $this->storyZen->getResponseInModal($message);
|
|
if($response) return $this->send($response);
|
|
|
|
$location = $this->storyZen->getAfterChangeLocation($storyID, $storyType);
|
|
return $this->send(array('result' => 'success', 'message' => $message, 'load' => $location));
|
|
}
|
|
|
|
$this->commonAction($storyID);
|
|
$story = $this->view->story;
|
|
if($story->status != 'active') return $this->send(array('result' => 'success', 'load' => $this->session->storyList));
|
|
$this->story->getAffectedScope($story);
|
|
|
|
/* Assign. */
|
|
$this->view->title = $this->lang->story->change . "STORY" . $this->lang->colon . $story->title;
|
|
$this->view->users = $this->user->getPairs('pofirst|nodeleted|noclosed', $story->assignedTo);
|
|
$this->view->fields = $this->storyZen->getFormFieldsForChange($storyID);
|
|
$this->view->lastReviewer = $this->story->getLastReviewer($story->id);
|
|
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* 激活需求。
|
|
* Activate a story.
|
|
*
|
|
* @param int $storyID
|
|
* @param string $storyType story|requirement
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function activate(int $storyID, string $storyType = 'story')
|
|
{
|
|
if(!empty($_POST))
|
|
{
|
|
$postData = $this->storyZen->buildStoryForActivate();
|
|
$changes = $this->story->activate($storyID, $postData);
|
|
|
|
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
|
|
if($changes)
|
|
{
|
|
$actionID = $this->action->create('story', $storyID, 'Activated', $this->post->comment);
|
|
$this->action->logHistory($actionID, $changes);
|
|
}
|
|
|
|
$this->executeHooks($storyID);
|
|
|
|
if(isInModal())
|
|
{
|
|
$execution = $this->execution->getByID((int)$this->session->execution);
|
|
if($this->app->tab == 'execution' and $execution->type == 'kanban')
|
|
{
|
|
return $this->send(array('result' => 'success', 'message' => $this->lang->saveSuccess, 'callback' => "refreshKanban()", 'closeModal' => true));
|
|
}
|
|
else
|
|
{
|
|
return $this->send(array('result' => 'success', 'message' => $this->lang->saveSuccess, 'load' => true, 'closeModal' => true));
|
|
}
|
|
}
|
|
return $this->send(array('result' => 'success', 'message' => $this->lang->saveSuccess, 'load' => true, 'closeModal' => true));
|
|
}
|
|
|
|
$this->commonAction($storyID);
|
|
|
|
/* Assign. */
|
|
$this->view->title = $this->lang->story->activate . "STORY" . $this->lang->colon . $this->view->story->title;
|
|
$this->view->users = $this->user->getPairs('pofirst|nodeleted|noclosed', $this->view->story->closedBy);
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* View a story.
|
|
*
|
|
* @param int $storyID
|
|
* @param int $version
|
|
* @param int $param executionID|projectID
|
|
* @param string $storyType story|requirement
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function view(int $storyID, int $version = 0, int $param = 0, string $storyType = 'story')
|
|
{
|
|
$uri = $this->app->getURI(true);
|
|
$tab = $this->app->tab;
|
|
$story = $this->story->getById($storyID, $version, true);
|
|
$product = $this->product->getByID((int)$story->product);
|
|
|
|
if($tab == 'product' and !empty($product->shadow)) return $this->send(array('result' => 'success', 'load' => "{$uri}##app=project"));
|
|
if(!$story) return $this->send(array('result' => 'success', 'message' => $this->lang->notFound, 'load' => $this->createLink($this->config->vision == 'lite' ? 'project' : 'product', 'all')));
|
|
if(!$this->app->user->admin and strpos(",{$this->app->user->view->products},", ",$story->product,") === false) return $this->send(array('result' => 'success', 'message' => $this->lang->product->accessDenied, 'load' => array('back' => true)));
|
|
|
|
$this->session->set('productList', $uri . "#app={$tab}", 'product');
|
|
if(!empty($story->fromBug)) $this->session->set('bugList', $uri, 'qa');
|
|
|
|
$version = empty($version) ? $story->version : $version;
|
|
$story = $this->story->mergeReviewer($story, true);
|
|
|
|
$this->app->loadLang('bug');
|
|
$this->story->replaceURLang($story->type);
|
|
$this->storyZen->getLinkedObjects($story);
|
|
$this->storyZen->setHiddenFieldsForView($product);
|
|
|
|
if($product->type != 'normal') $this->lang->product->branch = sprintf($this->lang->product->branch, $this->lang->product->branchName[$product->type]);
|
|
|
|
/* Set menu. */
|
|
if($this->app->tab == 'project')
|
|
{
|
|
$projectID = $param ? $param : $this->session->project;
|
|
$this->loadModel('project')->setMenu($projectID);
|
|
$this->view->projectID = $projectID;
|
|
}
|
|
elseif($this->app->tab == 'execution')
|
|
{
|
|
$executionID = $param ? $param : $this->session->execution;
|
|
$this->loadModel('execution')->setMenu($executionID);
|
|
$this->view->executionID = $executionID;
|
|
}
|
|
elseif($this->app->tab == 'qa')
|
|
{
|
|
$this->loadModel('qa')->setMenu($story->product);
|
|
}
|
|
else
|
|
{
|
|
$this->product->setMenu($story->product, $story->branch);
|
|
}
|
|
|
|
$this->view->title = "STORY #$story->id $story->title - $product->name";
|
|
$this->view->branches = $product->type == 'normal' ? array() : $this->loadModel('branch')->getPairs($product->id);
|
|
$this->view->users = $this->user->getPairs('noletter');
|
|
$this->view->executions = $this->execution->getPairs(0, 'all', 'nocode');
|
|
$this->view->project = $this->project->fetchByID($param);
|
|
$this->view->version = $version;
|
|
$this->view->preAndNext = $this->loadModel('common')->getPreAndNextObject('story', $storyID);
|
|
$this->view->builds = $this->loadModel('build')->getStoryBuilds($storyID);
|
|
$this->view->releases = $this->loadModel('release')->getStoryReleases($storyID);
|
|
$this->view->story = $story;
|
|
$this->view->product = $product;
|
|
$this->view->actions = $this->action->getList('story', $storyID);
|
|
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* Delete a story.
|
|
*
|
|
* @param int $storyID
|
|
* @param string $confirm yes|no
|
|
* @param string $from taskkanban
|
|
* @param string $storyType story|requirement
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function delete(int $storyID, string $confirm = 'no', string $from = '', string $storyType = 'story')
|
|
{
|
|
$story = $this->story->fetchById($storyID);
|
|
if($story->parent < 0) return $this->send(array('result' => 'fail', 'callback' => "zui.Modal.alert('{$this->lang->story->cannotDeleteParent}');"));
|
|
|
|
if($confirm == 'no')
|
|
{
|
|
if($story->type == 'requirement') $this->lang->story->confirmDelete = str_replace($this->lang->SRCommon, $this->lang->URCommon, $this->lang->story->confirmDelete);
|
|
$confirmURL = $this->createLink('story', 'delete', "story=$storyID&confirm=yes&from=$from&storyType=$storyType");
|
|
return $this->send(array('result' => 'fail', 'callback' => "zui.Modal.confirm({message: '{$this->lang->story->confirmDelete}', icon: 'icon-exclamation-sign', iconClass: 'warning-pale rounded-full icon-2x'}).then((res) => {if(res) $.ajaxSubmit({url: '$confirmURL'});});"));
|
|
}
|
|
else
|
|
{
|
|
$this->dao->update(TABLE_STORY)->set('deleted')->eq(1)->where('id')->eq($storyID)->exec();
|
|
$this->loadModel('action')->create($story->type, $storyID, 'deleted', '', actionModel::CAN_UNDELETED);
|
|
|
|
if($story->parent > 0)
|
|
{
|
|
$this->story->updateParentStatus($story->id);
|
|
$this->action->create('story', $story->parent, 'deleteChildrenStory', '', $storyID);
|
|
}
|
|
|
|
$this->executeHooks($storyID);
|
|
|
|
if(defined('RUN_MODE') && RUN_MODE == 'api') return $this->send(array('status' => 'success'));
|
|
if($this->app->tab == 'execution' and $from == 'taskkanban') return $this->send(array('result' => 'success', 'closeModal' => true, 'callback' => "refreshKanban()"));
|
|
|
|
$locateLink = $this->session->storyList ? $this->session->storyList : $this->createLink('product', 'browse', "productID={$story->product}");
|
|
return $this->send(array('result' => 'success', 'load' => $locateLink, 'closeModal' => true));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* Review a story.
|
|
*
|
|
* @param int $storyID
|
|
* @param string $from product|project
|
|
* @param string $storyType story|requirement
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function review(int $storyID, string $from = 'product', string $storyType = 'story')
|
|
{
|
|
if(!empty($_POST))
|
|
{
|
|
$storyData = $this->storyZen->buildStoryForReview($storyID);
|
|
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
|
|
$this->story->review($storyID, $storyData, $this->post->comment);
|
|
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
|
|
$message = $this->executeHooks($storyID);
|
|
if(empty($message)) $message = $this->lang->saveSuccess;
|
|
|
|
if(isInModal())
|
|
{
|
|
if($this->app->tab == 'execution') $this->loadModel('kanban')->updateLane($this->session->execution, 'story', $storyID);
|
|
return $this->send($this->storyZen->getResponseInModal($message));
|
|
}
|
|
if(defined('RUN_MODE') and RUN_MODE == 'api') return $this->send(array('status' => 'success', 'data' => $storyID));
|
|
|
|
$location = $this->storyZen->getAfterReviewLocation($storyID, $storyType, $from);
|
|
return $this->send(array('result' => 'success', 'message' => $message, 'load' => $location));
|
|
}
|
|
|
|
$this->commonAction($storyID);
|
|
$story = $this->view->story;
|
|
$reviewers = $this->story->getReviewerPairs($storyID, $story->version);
|
|
$this->story->getAffectedScope($story);
|
|
|
|
$this->view->title = $this->lang->story->review . "STORY" . $this->lang->colon . $story->title;
|
|
$this->view->fields = $this->storyZen->getFormFieldsForReview($storyID);
|
|
$this->view->reviewers = $reviewers;
|
|
$this->view->isLastOne = count(array_diff(array_keys($reviewers), explode(',', $story->reviewedBy))) <= 1;
|
|
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* Batch review stories.
|
|
*
|
|
* @param string $result
|
|
* @param string $reason
|
|
* @param string $storyType story|requirement
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function batchReview(string $result, string $reason = '', string $storyType = 'story')
|
|
{
|
|
if(!$this->post->storyIdList) return $this->send(array('result' => 'success', 'load' => $this->session->storyList));
|
|
|
|
$storyIdList = $this->post->storyIdList;
|
|
$storyIdList = array_unique($storyIdList);
|
|
$message = $this->story->batchReview($storyIdList, $result, $reason);
|
|
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
$this->loadModel('score')->create('ajax', 'batchOther');
|
|
|
|
$response = array();
|
|
$response['result'] = 'success';
|
|
$response['load'] = false;
|
|
if($message) $response['callback'] = "zui.Modal.alert('{$message}').then((res) => {loadCurrentPage()});";
|
|
if(empty($message)) $response['load'] = true;
|
|
return $this->send($response);
|
|
}
|
|
|
|
/**
|
|
* Recall the story review or story change.
|
|
*
|
|
* @param int $storyID
|
|
* @param string $from list
|
|
* @param string $confirm no|yes
|
|
* @param string $storyType story|requirement
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function recall(int $storyID, string $from = 'list', string $confirm = 'no', string $storyType = 'story')
|
|
{
|
|
$story = $this->story->fetchById($storyID);
|
|
|
|
if($confirm == 'no')
|
|
{
|
|
$confirmTips = $story->status == 'changing' ? $this->lang->story->confirmRecallChange : $this->lang->story->confirmRecallReview;
|
|
$confirmURL = $this->createLink('story', 'recall', "storyID=$storyID&from=$from&confirm=yes&storyType=$storyType");
|
|
return $this->send(array('result' => 'fail', 'callback' => "zui.Modal.confirm({message:'{$confirmTips}', icon: 'icon-exclamation-sign', iconClass: 'warning-pale rounded-full icon-2x'}).then((res) => {if(res) $.ajaxSubmit({url: '$confirmURL'});});"));
|
|
}
|
|
|
|
if($story->status == 'changing') $this->story->recallChange($storyID);
|
|
if($story->status == 'reviewing') $this->story->recallReview($storyID);
|
|
|
|
$action = $story->status == 'changing' ? 'recalledChange' : 'Recalled';
|
|
$this->loadModel('action')->create('story', $storyID, $action);
|
|
|
|
$locateLink = $this->session->storyList ? $this->session->storyList : $this->createLink('product', 'browse', "productID={$story->product}");
|
|
if($from == 'view')
|
|
{
|
|
$module = 'story';
|
|
$method = 'view';
|
|
$params = "storyID=$storyID&version=0¶m=0&storyType=$storyType";
|
|
if($this->app->tab == 'project')
|
|
{
|
|
$module = 'projectstory';
|
|
$method = 'view';
|
|
$params = "storyID=$storyID";
|
|
}
|
|
elseif($this->app->tab == 'execution')
|
|
{
|
|
$module = 'execution';
|
|
$method = 'storyView';
|
|
$params = "storyID=$storyID";
|
|
}
|
|
$locateLink = $this->createLink($module, $method, $params);
|
|
}
|
|
|
|
return $this->send(array('result' => 'success', 'load' => $locateLink));
|
|
}
|
|
|
|
/**
|
|
* Submit review.
|
|
*
|
|
* @param int $storyID
|
|
* @param string $storyType story|requirement
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function submitReview(int $storyID, string $storyType = 'story')
|
|
{
|
|
if($_POST)
|
|
{
|
|
$storyData = $this->storyZen->buildStoryForSubmitReview();
|
|
if(!$storyData) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
|
|
$changes = $this->story->submitReview($storyID, $storyData);
|
|
if(dao::isError()) return print(js::error(dao::getError()));
|
|
|
|
if($changes)
|
|
{
|
|
$actionID = $this->loadModel('action')->create('story', $storyID, 'submitReview');
|
|
$this->action->logHistory($actionID, $changes);
|
|
}
|
|
|
|
if(isInModal()) return $this->send(array('result' => 'success', 'message' => $this->lang->saveSuccess, 'closeModal' => true, 'callback' => 'loadCurrentPage()'));
|
|
return $this->send(array('result' => 'success', 'message' => $this->lang->saveSuccess, 'closeModal' => true, 'load' => $this->createLink('story', 'view', "storyID=$storyID&version=0¶m=0&storyType=$storyType")));
|
|
}
|
|
|
|
/* Get story and product. */
|
|
$story = $this->story->fetchById($storyID);
|
|
$product = $this->product->getById($story->product);
|
|
|
|
/* Get reviewers. */
|
|
$reviewers = $product->reviewer;
|
|
if(!$reviewers and $product->acl != 'open') $reviewers = $this->loadModel('user')->getProductViewListUsers($product);
|
|
|
|
/* Get story reviewer. */
|
|
$reviewerList = $this->story->getReviewerPairs($story->id, $story->version);
|
|
$story->reviewer = array_keys($reviewerList);
|
|
|
|
$this->view->story = $story;
|
|
$this->view->actions = $this->action->getList('story', $storyID);
|
|
$this->view->reviewers = $this->user->getPairs('noclosed|nodeleted', '', 0, $reviewers);
|
|
$this->view->users = $this->user->getPairs('noclosed|noletter');
|
|
$this->view->needReview = (($this->app->user->account == $product->PO or $this->config->story->needReview == 0 or !$this->story->checkForceReview()) and empty($story->reviewer)) ? "checked='checked'" : "";
|
|
$this->view->lastReviewer = $this->story->getLastReviewer($story->id);
|
|
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* 关闭需求。
|
|
* Close the story.
|
|
*
|
|
* @param int $storyID
|
|
* @param string $from taskkanban
|
|
* @param string $storyType story|requirement
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function close(int $storyID, string $from = '', string $storyType = 'story')
|
|
{
|
|
$story = $this->story->getById($storyID);
|
|
$this->commonAction($storyID);
|
|
|
|
if(!empty($_POST))
|
|
{
|
|
$postData = form::data($this->config->story->form->close)
|
|
->stripTags($this->config->story->editor->close['id'], $this->config->allowedTags)
|
|
->removeIF($this->post->closedReason != 'duplicate', 'duplicateStory')
|
|
->removeIF($this->post->closedReason != 'subdivided', 'childStories')
|
|
->get();
|
|
$postData = $this->loadModel('file')->processImgURL($postData, $this->config->story->editor->close['id'], $this->post->uid);
|
|
|
|
$changes = $this->story->close($storyID, $postData);
|
|
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
|
|
$this->story->closeParentRequirement($storyID, $postData);
|
|
|
|
if($changes)
|
|
{
|
|
$preStatus = $story->status;
|
|
$isChanged = !empty($story->changedBy) ? true : false;
|
|
if($preStatus == 'reviewing') $preStatus = $isChanged ? 'changing' : 'draft';
|
|
|
|
$actionID = $this->action->create('story', $storyID, 'Closed', $this->post->comment, ucfirst($this->post->closedReason) . ($this->post->duplicateStory ? ':' . (int)$this->post->duplicateStory : '') . "|$preStatus");
|
|
$this->action->logHistory($actionID, $changes);
|
|
}
|
|
|
|
$this->dao->update(TABLE_STORY)->set('assignedTo')->eq('closed')->where('id')->eq((int)$storyID)->exec();
|
|
|
|
$this->executeHooks($storyID);
|
|
|
|
if(isInModal())
|
|
{
|
|
$execution = $this->execution->getByID((int)$this->session->execution);
|
|
$executionLaneType = $this->session->executionLaneType ? $this->session->executionLaneType : 'all';
|
|
$executionGroupBy = $this->session->executionGroupBy ? $this->session->executionGroupBy : 'default';
|
|
if(($this->app->tab == 'execution' && $execution->type == 'kanban') || $from == 'taskkanban')
|
|
{
|
|
return $this->send(array('result' => 'success', 'message' => $this->lang->saveSuccess, 'closeModal' => true, 'callback' => "refreshKanban()"));
|
|
}
|
|
else
|
|
{
|
|
return $this->send(array('result' => 'success', 'message' => $this->lang->saveSuccess, 'closeModal' => true, 'load' => true));
|
|
}
|
|
}
|
|
|
|
if(defined('RUN_MODE') && RUN_MODE == 'api') return $this->send(array('status' => 'success', 'data' => $storyID));
|
|
return $this->send(array('result' => 'success', 'message' => $this->lang->saveSuccess, 'load' => inlink('view', "storyID=$storyID&version=0¶m=0&storyType=$storyType"), 'closeModal' => true));
|
|
}
|
|
|
|
/* Get story and product. */
|
|
$product = $this->dao->findById($story->product)->from(TABLE_PRODUCT)->fields('name, id, `type`')->fetch();
|
|
|
|
$this->story->replaceURLang($story->type);
|
|
|
|
/* Set the closed reason options and remove subdivided options. */
|
|
$reasonList = $this->lang->story->reasonList;
|
|
if($story->status == 'draft') unset($reasonList['cancel']);
|
|
unset($reasonList['subdivided']);
|
|
|
|
$storyBranch = $story->branch > 0 ? $story->branch : '0';
|
|
$branch = $product->type == 'branch' ? $storyBranch : 'all';
|
|
$productStories = $this->story->getProductStoryPairs($story->product, $branch, 0, 'all', 'id_desc', 0, '', $storyType);
|
|
|
|
$this->view->title = $this->lang->story->close . "STORY" . $this->lang->colon . $story->title;
|
|
$this->view->product = $product;
|
|
$this->view->story = $story;
|
|
$this->view->productStories = $productStories;
|
|
$this->view->actions = $this->action->getList('story', $storyID);
|
|
$this->view->users = $this->loadModel('user')->getPairs();
|
|
$this->view->reasonList = $reasonList;
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* 批量关闭需求。
|
|
* Batch close the stories.
|
|
*
|
|
* @param int $productID
|
|
* @param int $executionID
|
|
* @param string $storyType story|requirement
|
|
* @param string $from contribute|work
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function batchClose(int $productID = 0, int $executionID = 0, string $storyType = 'story', string $from = '')
|
|
{
|
|
if(!$this->post->storyIdList) return $this->send(array('result' => 'success', 'load' => $this->session->storyList));
|
|
$storyIdList = $this->post->storyIdList;
|
|
$storyIdList = array_unique($storyIdList);
|
|
|
|
$this->story->replaceURLang($storyType);
|
|
|
|
if($this->post->comment)
|
|
{
|
|
$stories = $this->storyZen->buildStoriesForBatchClose(); /* Get the stories which need to be closed. */
|
|
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
|
|
$this->story->batchClose($stories);
|
|
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
|
|
$this->loadModel('score')->create('ajax', 'batchOther');
|
|
return $this->send(array('result' => 'success', 'message' => $this->lang->saveSuccess, 'load' => $this->session->storyList));
|
|
}
|
|
|
|
$this->storyZen->setMenuForBatchClose($productID, $executionID, $from, $storyType);
|
|
|
|
/* Get the skipped and already closed stories, and the count of stories which have a twin. */
|
|
$stories = $this->story->getByList($storyIdList);
|
|
$ignoreTwins = array();
|
|
$twinsCount = array();
|
|
foreach($stories as $story)
|
|
{
|
|
if(!empty($ignoreTwins) and isset($ignoreTwins[$story->id]))
|
|
{
|
|
unset($stories[$story->id]);
|
|
continue;
|
|
}
|
|
|
|
if($story->parent == -1) $skippedStory[] = $story->id;
|
|
if($story->status == 'closed') $closedStory[] = $story->id;
|
|
if($story->parent == -1 || $story->status == 'closed') unset($stories[$story->id]);
|
|
|
|
if(!empty($story->twins))
|
|
{
|
|
$twinsCount[$story->id] = 0;
|
|
foreach(explode(',', trim($story->twins, ',')) as $twinID)
|
|
{
|
|
$twinsCount[$story->id] ++;
|
|
$ignoreTwins[$twinID] = $twinID;
|
|
}
|
|
}
|
|
}
|
|
|
|
$errorTips = '';
|
|
if(isset($closedStory)) $errorTips .= sprintf($this->lang->story->closedStory, implode(',', $closedStory));
|
|
if(isset($skippedStory)) $errorTips .= sprintf($this->lang->story->skipStory, implode(',', $skippedStory));
|
|
|
|
$this->view->productID = $productID;
|
|
$this->view->stories = $stories;
|
|
$this->view->storyType = $storyType;
|
|
$this->view->twinsCount = $twinsCount;
|
|
$this->view->errorTips = $errorTips;
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* Batch change the module of story.
|
|
*
|
|
* @param int $moduleID
|
|
* @param string $storyType story|requirement
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function batchChangeModule(int $moduleID, string $storyType = 'story')
|
|
{
|
|
if(empty($_POST['storyIdList'])) return $this->send(array('result' => 'success', 'load' => true));
|
|
|
|
$storyIdList = array_unique($this->post->storyIdList);
|
|
$allChanges = $this->story->batchChangeModule($storyIdList, $moduleID);
|
|
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
|
|
foreach($allChanges as $storyID => $changes)
|
|
{
|
|
$actionID = $this->action->create('story', $storyID, 'Edited');
|
|
$this->action->logHistory($actionID, $changes);
|
|
}
|
|
$this->loadModel('score')->create('ajax', 'batchOther');
|
|
return $this->send(array('result' => 'success', 'load' => true));
|
|
}
|
|
|
|
/**
|
|
* Batch stories convert to tasks.
|
|
*
|
|
* @param int $executionID
|
|
* @param int $projectID
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function batchToTask(int $executionID = 0, int $projectID = 0)
|
|
{
|
|
if($this->app->tab == 'execution' and $executionID) $this->loadModel('execution')->setMenu($executionID);
|
|
if($this->app->tab == 'project' and $executionID) $this->loadModel('execution')->setMenu($executionID);
|
|
|
|
if(!empty($_POST['name']))
|
|
{
|
|
$response['result'] = 'success';
|
|
$response['message'] = $this->lang->story->successToTask;
|
|
|
|
$tasks = $this->storyZen->buildDataForBatchToTask($executionID, $projectID);
|
|
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
|
|
$taskIdList = $this->story->batchToTask($executionID, $tasks);
|
|
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
|
|
if($this->viewType == 'json') return $this->send(array('result' => 'success', 'message' => $this->lang->saveSuccess, 'idList' => $taskIdList));
|
|
return $this->send(array('result' => 'success', 'message' => $this->lang->saveSuccess, 'load' => $this->createLink('execution', 'task', "executionID=$executionID")));
|
|
}
|
|
|
|
if(!$this->post->storyIdList) return $this->locate($this->session->storyList);
|
|
|
|
$stories = $this->story->getByList($_POST['storyIdList']);
|
|
$activeStories = array();
|
|
$storyPairs = array();
|
|
foreach($stories as $story)
|
|
{
|
|
if(str_contains(',draft,reviewing,changing,closed,', ",{$story->status},")) continue;
|
|
|
|
$activeStories[$story->id] = $story;
|
|
$storyPairs[$story->id] = $story->title;
|
|
}
|
|
|
|
if(empty($stories)) return $this->send(array('result' => 'fail', 'message' => $this->lang->story->noStoryToTask, 'load' => $this->session->storyList));
|
|
|
|
$this->view->title = $this->lang->story->batchToTask;
|
|
$this->view->executionID = $executionID;
|
|
$this->view->syncFields = empty($_POST['fields']) ? array() : $_POST['fields'];
|
|
$this->view->hourPointValue = empty($_POST['hourPointValue']) ? 0 : $_POST['hourPointValue'];
|
|
$this->view->taskType = empty($_POST['type']) ? '' : $_POST['type'];
|
|
$this->view->stories = $activeStories;
|
|
$this->view->storyPairs = $storyPairs;
|
|
$this->view->modules = $this->loadModel('tree')->getTaskOptionMenu($executionID, 0, 'allModule');
|
|
$this->view->members = $this->loadModel('user')->getTeamMemberPairs($executionID, 'execution', 'nodeleted');
|
|
$this->view->storyTasks = $this->loadModel('task')->getStoryTaskCounts(array_keys($stories), $executionID);
|
|
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* Batch change the plan of story.
|
|
*
|
|
* @param int $planID
|
|
* @param int $oldPlanID
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function batchChangePlan(int $planID, int $oldPlanID = 0)
|
|
{
|
|
if(empty($_POST['storyIdList'])) return $this->send(array('result' => 'success', 'load' => true));
|
|
|
|
$storyIdList = array_unique($this->post->storyIdList);
|
|
$allChanges = $this->story->batchChangePlan($storyIdList, $planID, $oldPlanID);
|
|
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
|
|
foreach($allChanges as $storyID => $changes)
|
|
{
|
|
$actionID = $this->action->create('story', $storyID, 'Edited');
|
|
$this->action->logHistory($actionID, $changes);
|
|
}
|
|
$this->loadModel('score')->create('ajax', 'batchOther');
|
|
return $this->send(array('result' => 'success', 'load' => true));
|
|
}
|
|
|
|
/**
|
|
* Batch change branch.
|
|
*
|
|
* @param int $branchID
|
|
* @param string $confirm yes|no
|
|
* @param string $storyIdList
|
|
* @param string $storyType story|requirement
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function batchChangeBranch(int $branchID, string $confirm = '', string $storyIdList = '', string $storyType = 'story')
|
|
{
|
|
if(empty($storyIdList) and empty($_POST['storyIdList'])) return $this->send(array('result' => 'success', 'load' => true));
|
|
|
|
if(!empty($_POST['storyIdList'])) $storyIdList = $this->post->storyIdList;
|
|
if(is_string($storyIdList)) $storyIdList = array_filter(explode(',', $storyIdList));
|
|
$storyIdList = array_unique($storyIdList);
|
|
$plans = $this->loadModel('productplan')->getPlansByStories($storyIdList);
|
|
if(empty($confirm))
|
|
{
|
|
$stories = $this->story->getByList($storyIdList);
|
|
$normalStotyIdList = '';
|
|
$conflictStoryIdList = '';
|
|
$conflictStoryArray = array();
|
|
|
|
/* Determine whether there is a conflict between the branch of the story and the linked plan. */
|
|
foreach($storyIdList as $storyID)
|
|
{
|
|
if($stories[$storyID]->branch == $branchID) continue;
|
|
if($branchID == BRANCH_MAIN) continue;
|
|
if(!isset($plans[$storyID])) continue;
|
|
|
|
foreach($plans[$storyID] as $plan)
|
|
{
|
|
if($plan->branch == $branchID) continue;
|
|
|
|
$conflictStoryIdList .= "[{$storyID}]";
|
|
$conflictStoryArray[] = $storyID;
|
|
break;
|
|
}
|
|
}
|
|
|
|
/* Prompt the user whether to continue to modify the conflicting stories branch. */
|
|
if($conflictStoryIdList)
|
|
{
|
|
$normalStotyIdList = array_diff($storyIdList, $conflictStoryArray);
|
|
$normalStotyIdList = implode(',', $normalStotyIdList);
|
|
$storyIdList = implode(',', $storyIdList);
|
|
$confirmURL = $this->createLink('story', 'batchChangeBranch', "branchID=$branchID&confirm=yes&storyIdList=$storyIdList&storyType=$storyType");
|
|
$cancelURL = $this->createLink('story', 'batchChangeBranch', "branchID=$branchID&confirm=no&storyIdList=$normalStotyIdList&storyType=$storyType");
|
|
return $this->send(array('result' => 'success', 'load' => array('confirm' => sprintf($this->lang->story->confirmChangeBranch, $conflictStoryIdList), 'confirmed' => $confirmURL, 'canceled' => $cancelURL)));
|
|
}
|
|
}
|
|
|
|
$allChanges = $this->story->batchChangeBranch($storyIdList, $branchID, $confirm, $plans);
|
|
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
foreach($allChanges as $storyID => $changes)
|
|
{
|
|
$actionID = $this->action->create('story', $storyID, 'Edited');
|
|
$this->action->logHistory($actionID, $changes);
|
|
}
|
|
if(!dao::isError()) $this->loadModel('score')->create('ajax', 'batchOther');
|
|
return $this->send(array('result' => 'success', 'load' => true));
|
|
}
|
|
|
|
/**
|
|
* Batch change the stage of story.
|
|
*
|
|
* @param string $stage
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function batchChangeStage(string $stage)
|
|
{
|
|
if(empty($_POST['storyIdList'])) return $this->send(array('result' => 'success', 'load' => true));
|
|
|
|
$storyIdList = array_unique($this->post->storyIdList);
|
|
$message = $this->story->batchChangeStage($storyIdList, $stage);
|
|
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
$this->loadModel('score')->create('ajax', 'batchOther');
|
|
|
|
$response = array();
|
|
$response['result'] = 'success';
|
|
$response['load'] = false;
|
|
if($message) $response['callback'] = "zui.Modal.alert('{$message}').then((res) => {loadCurrentPage()});";
|
|
if(empty($message)) $response['load'] = true;
|
|
return $this->send($response);
|
|
|
|
}
|
|
|
|
/**
|
|
* 需求的指派给页面。
|
|
* Assign the story to a user.
|
|
*
|
|
* @param int $storyID
|
|
* @param string $kanbanGroup
|
|
* @param string $from ''|taskkanban
|
|
* @param string $storyType story|requirement
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function assignTo(int $storyID, string $kanbanGroup = 'default', string $from = '', string $storyType = 'story')
|
|
{
|
|
if(!empty($_POST))
|
|
{
|
|
$changes = $this->story->assign($storyID);
|
|
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
if($changes)
|
|
{
|
|
$actionID = $this->loadModel('action')->create('story', $storyID, 'Assigned', $this->post->comment, $this->post->assignedTo);
|
|
$this->action->logHistory($actionID, $changes);
|
|
}
|
|
|
|
$message = $this->executeHooks($storyID);
|
|
$response = $this->storyZen->getResponseInModal($message);
|
|
if($response) return $this->send($response);
|
|
|
|
return $this->send(array('result' => 'success', 'message' => $this->lang->saveSuccess, 'load' => true, 'closeModal' => true));
|
|
}
|
|
|
|
/* Get story and product to render the view. */
|
|
$story = $this->story->getById($storyID);
|
|
$product = $this->product->getByID($story->product);
|
|
$users = $this->config->vision == 'lite' ? $this->user->getTeamMemberPairs($this->session->project) : $this->user->getPairs('nodeleted|noclosed|pofirst|noletter');
|
|
|
|
$this->view->title = zget($product, 'name', $story->title) . $this->lang->colon . $this->lang->story->assign;
|
|
$this->view->story = $story;
|
|
$this->view->storyType = $storyType;
|
|
$this->view->actions = $this->action->getList('story', $storyID);
|
|
$this->view->users = $users;
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* Batch assign to.
|
|
*
|
|
* @param string $storyType story|requirement
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function batchAssignTo(string $storyType = 'story', string $assignedTo = '')
|
|
{
|
|
if(empty($_POST['storyIdList'])) return $this->send(array('result' => 'success', 'load' => true));
|
|
|
|
if(empty($assignedTo)) $assignedTo = $this->post->assignedTo;
|
|
$storyIdList = array_unique($this->post->storyIdList);
|
|
$oldStories = $this->story->getByList($storyIdList);
|
|
|
|
$allChanges = $this->story->batchAssignTo($storyIdList, $assignedTo);
|
|
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
|
|
$ignoreStories = array();
|
|
$assignedTwins = array();
|
|
foreach($allChanges as $storyID => $changes)
|
|
{
|
|
$oldStory = $oldStories[$storyID];
|
|
if($oldStory->status == 'closed') $ignoreStories[] = "#{$storyID}";
|
|
|
|
/* Sync twins. */
|
|
if(empty($oldStory->twins)) continue;
|
|
|
|
$twins = array_unique(array_filter(explode(',', $oldStory->twins)));
|
|
foreach($twins as $i => $twinID)
|
|
{
|
|
if(in_array($twinID, $storyIdList) || isset($assignedTwins[$twinID])) unset($twins[$i]);
|
|
}
|
|
$this->story->syncTwins($storyID, implode(',', $twins), $changes, 'Assigned');
|
|
foreach($twins as $assignedID) $assignedTwins[$assignedID] = $assignedID;
|
|
}
|
|
$this->loadModel('score')->create('ajax', 'batchOther');
|
|
|
|
$response = array('result' => 'success', 'load' => true);
|
|
if($ignoreStories) $response['ignoreMessage'] = sprintf($this->lang->story->ignoreClosedStory, implode(',', $ignoreStories));
|
|
return $this->send($response);
|
|
}
|
|
|
|
/**
|
|
* 查看需求的相关任务。
|
|
* Tasks of a story.
|
|
*
|
|
* @param int $storyID
|
|
* @param int $executionID
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function tasks(int $storyID, int $executionID = 0)
|
|
{
|
|
$tasks = $this->loadModel('task')->getListByStory($storyID, $executionID);
|
|
|
|
$this->view->tasks = $tasks;
|
|
$this->view->users = $this->user->getPairs('noletter');
|
|
$this->view->summary = $this->execution->summary($tasks);
|
|
$this->view->story = $this->story->getById($storyID);
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* 查看需求的相关缺陷。
|
|
* Bugs of a story.
|
|
*
|
|
* @param int $storyID
|
|
* @param int $executionID
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function bugs(int $storyID, int $executionID = 0)
|
|
{
|
|
$this->view->bugs = $this->loadModel('bug')->getStoryBugs($storyID, $executionID);
|
|
$this->view->users = $this->user->getPairs('noletter');
|
|
$this->view->story = $this->story->getById($storyID);
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* 查看需求的相关用例。
|
|
* Cases of a story.
|
|
*
|
|
* @param int $storyID
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function cases(int $storyID)
|
|
{
|
|
$this->view->cases = $this->loadModel('testcase')->getStoryCases($storyID);
|
|
$this->view->users = $this->user->getPairs('noletter');
|
|
$this->view->resultList = $this->lang->testcase->resultList;
|
|
$this->view->story = $this->story->getById($storyID);
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* 展示用户需求关联的软件需求，或软件需求关联的用户需求。
|
|
* Show the URs/SRs of the SR/UR.
|
|
*
|
|
* @param int $storyID
|
|
* @param string $storyType story|requirement
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function relation(int $storyID, string $storyType = 'story')
|
|
{
|
|
$story = $this->story->getById($storyID);
|
|
$storyType = $storyType != $story->type ? $story->type : $storyType;
|
|
$selectFields = array('id', 'pri', 'title', 'plan', 'openedBy', 'assignedTo', 'estimate', 'status');
|
|
|
|
$this->view->relation = $this->story->getStoryRelation($storyID, $storyType, $selectFields);
|
|
$this->view->users = $this->user->getPairs('noletter');
|
|
$this->view->storyType = $storyType;
|
|
$this->view->story = $story;
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* 关联需求。
|
|
* Link story and requirement.
|
|
*
|
|
* 引用1：软件需求列表页，关联用户需求，将软件需求关联到用户需求。
|
|
* 引用2：用户需求列表页，关联软件需求，将用户需求关联到软件需求。
|
|
*
|
|
* @param int $storyID
|
|
* @param string $type linkStories|linkRelateUR|linkRelateSR
|
|
* @param int $linkedStoryID
|
|
* @param string $browseType ''|bySearch
|
|
* @param int $queryID 0|
|
|
* @param string $storyType story|requirement
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function linkStory(int $storyID, string $type = 'linkStories', int $linkedStoryID = 0, string $browseType = '', int $queryID = 0, string $storyType = 'story')
|
|
{
|
|
$this->commonAction($storyID);
|
|
|
|
if($type == 'remove')
|
|
{
|
|
$this->story->unlinkStory($storyID, $linkedStoryID);
|
|
helper::end();
|
|
}
|
|
|
|
if($_POST)
|
|
{
|
|
$this->story->linkStories($storyID, $this->post->stories);
|
|
|
|
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
|
|
return $this->send(array('result' => 'success', 'callback' => 'loadCurrentPage()', 'closeModal' => true));
|
|
}
|
|
|
|
/* Get story, product, products, and queryID. */
|
|
$story = $this->story->getById($storyID);
|
|
$products = $this->product->getPairs('', 0, '', 'all');
|
|
|
|
/* Change for requirement story title. */
|
|
if($story->type == 'requirement')
|
|
{
|
|
$this->lang->story->title = str_replace($this->lang->URCommon, $this->lang->SRCommon, $this->lang->story->title);
|
|
$this->lang->story->linkStory = str_replace($this->lang->URCommon, $this->lang->SRCommon, $this->lang->story->linkStory);
|
|
}
|
|
|
|
/* Build search form. */
|
|
$actionURL = $this->createLink('story', 'linkStory', "storyID=$storyID&type=$type&linkedStoryID=$linkedStoryID&browseType=bySearch&queryID=myQueryID&storyType=$storyType");
|
|
$this->product->buildSearchForm($story->product, $products, $queryID, $actionURL, $story->type == 'story' ? 'requirement' : 'story');
|
|
|
|
/* Get stories to link. */
|
|
$stories2Link = $this->story->getStories2Link($storyID, $type, $browseType, $queryID, $story->type);
|
|
|
|
/* Assign. */
|
|
$this->view->title = $this->lang->story->linkStory . "STORY" . $this->lang->colon .$this->lang->story->linkStory;
|
|
$this->view->type = $type;
|
|
$this->view->stories2Link = $stories2Link;
|
|
$this->view->users = $this->loadModel('user')->getPairs('noletter');
|
|
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* 关联软件需求。
|
|
* Link related stories.
|
|
*
|
|
* @param int $storyID
|
|
* @param string $browseType
|
|
* @param string $excludeStories
|
|
* @param int $param
|
|
* @param int $recTotal
|
|
* @param int $recPerPage
|
|
* @param int $pageID
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function linkStories(int $storyID, string $browseType = '', string $excludeStories = '', int $param = 0, int $recTotal = 0, int $recPerPage = 20, int $pageID = 1)
|
|
{
|
|
/* Load pager. */
|
|
$this->app->loadClass('pager', true);
|
|
$pager = new pager($recTotal, $recPerPage, $pageID);
|
|
|
|
/* Get story, product, products, and queryID. */
|
|
$story = $this->story->getById($storyID);
|
|
$products = $this->product->getPairs('', 0, '', 'all');
|
|
$queryID = ($browseType == 'bySearch') ? $param : 0;
|
|
$type = $story->type == 'story' ? 'linkRelateSR' : 'linkRelateUR';
|
|
$method = $story->type == 'story' ? 'linkStories' : 'linkRequirements';
|
|
|
|
/* Build search form. */
|
|
$actionURL = $this->createLink('story', $method, "storyID=$storyID&browseType=bySearch&excludeStories=$excludeStories&queryID=myQueryID");
|
|
$this->product->buildSearchForm($story->product, $products, $queryID, $actionURL, $story->type);
|
|
|
|
$this->view->story = $story;
|
|
$this->view->stories2Link = $this->story->getStories2Link($storyID, $type, $browseType, $queryID, $story->type, $pager, $excludeStories);
|
|
$this->view->products = $products;
|
|
$this->view->users = $this->user->getPairs('noletter');
|
|
$this->view->pager = $pager;
|
|
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* 关联用户需求。
|
|
* Link related requirements.
|
|
*
|
|
* @param int $storyID
|
|
* @param string $browseType
|
|
* @param string $excludeStories
|
|
* @param int $param
|
|
* @param int $recTotal
|
|
* @param int $recPerPage
|
|
* @param int $pageID
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function linkRequirements(int $storyID, string $browseType = '', string $excludeStories = '', int $param = 0, int $recTotal = 0, int $recPerPage = 20, int $pageID = 1)
|
|
{
|
|
$this->lang->story->title = str_replace($this->lang->SRCommon, $this->lang->URCommon, $this->lang->story->title);
|
|
$this->config->product->search['fields']['title'] = $this->lang->story->title;
|
|
unset($this->config->product->search['fields']['plan']);
|
|
unset($this->config->product->search['fields']['stage']);
|
|
|
|
echo $this->fetch('story', 'linkStories', "storyID=$storyID&browseType=$browseType&excludeStories=$excludeStories¶m=$param&recTotal=$recTotal&recPerPage=$recPerPage&pageID=$pageID");
|
|
}
|
|
|
|
/**
|
|
* 当软件需求关联的用户需求有变更时，让用户决定是否变更软件需求。
|
|
* Ask user to decide to whether change related story after the user requirement changed.
|
|
*
|
|
* @param int $storyID
|
|
* @param string $result yes|no
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function processStoryChange(int $storyID, string $result = 'yes')
|
|
{
|
|
$this->commonAction($storyID);
|
|
$story = $this->story->getByID($storyID);
|
|
|
|
if($result == 'no')
|
|
{
|
|
$this->dao->update(TABLE_STORY)->set('URChanged')->eq(0)->where('id')->eq($storyID)->exec();
|
|
return $this->send(array('result' => 'success', 'load' => true, 'closeModal' => true));
|
|
}
|
|
|
|
$this->view->changedStories = $this->story->getChangedStories($story);
|
|
$this->view->users = $this->loadModel('user')->getPairs('noletter');
|
|
$this->view->storyID = $storyID;
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* 获取执行的需求列表信息用于html下拉列表。
|
|
* AJAX: get stories of a execution in html select.
|
|
*
|
|
* @param int $executionID
|
|
* @param int $productID
|
|
* @param int|string $branch 0|all|integer
|
|
* @param int $moduleID
|
|
* @param int $storyID
|
|
* @param string $pageType batch
|
|
* @param string $type full|short
|
|
* @param string $status all|unclosed
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function ajaxGetExecutionStories(int $executionID, int $productID = 0, int|string $branch = 0, int $moduleID = 0, int $storyID = 0, string $pageType = '', string $type = 'full', string $status = 'all')
|
|
{
|
|
if($moduleID)
|
|
{
|
|
$moduleID = $this->loadModel('tree')->getStoryModule($moduleID);
|
|
$moduleID = $this->tree->getAllChildID($moduleID);
|
|
}
|
|
|
|
$stories = $this->story->getExecutionStoryPairs($executionID, $productID, $branch, $moduleID, $type, $status);
|
|
|
|
if($this->app->getViewType() === 'json')
|
|
{
|
|
return print(json_encode($stories));
|
|
}
|
|
elseif($this->app->getViewType() == 'mhtml')
|
|
{
|
|
return print(html::select('story', empty($stories) ? array() : $stories, $storyID, 'onchange=setStoryRelated()'));
|
|
}
|
|
elseif($pageType == 'batch')
|
|
{
|
|
$storyList = array();
|
|
foreach($stories as $id => $name) $storyList[] = array('value' => $id, 'text' => $name);
|
|
return $this->send($storyList);
|
|
}
|
|
else
|
|
{
|
|
$items = array();
|
|
foreach($stories as $storyID => $storyName) $items[] = array('text' => $storyName, 'value' => $storyID, 'keys' => $storyName);
|
|
return print(json_encode($items));
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 获取产品的需求列表信息用于html下拉列表。
|
|
* AJAX: get the stories of a product in html select.
|
|
*
|
|
* @param int $productID
|
|
* @param int $branch
|
|
* @param int $moduleID
|
|
* @param int $storyID
|
|
* @param string $onlyOption
|
|
* @param string $status ''|all|noclosed|changing|active|draft|closed|reviewing
|
|
* @param int $limit
|
|
* @param string $type full|all
|
|
* @param int $hasParent 0|1
|
|
* @param int $objectID projectID|executionID
|
|
* @param int $isHTML 0|1
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function ajaxGetProductStories(int $productID, int $branch = 0, int $moduleID = 0, int $storyID = 0, string $onlyOption = 'false', string $status = '', int $limit = 0, string $type = 'full', int $hasParent = 1, int $objectID = 0, int $isHTML = 1)
|
|
{
|
|
$hasParent = $hasParent >= 1 ? true : false;
|
|
|
|
if($moduleID)
|
|
{
|
|
$moduleID = $this->loadModel('tree')->getStoryModule($moduleID);
|
|
$moduleID = $this->tree->getAllChildID($moduleID);
|
|
}
|
|
|
|
$storyStatus = $this->story->getStatusList($status);
|
|
|
|
if($objectID)
|
|
{
|
|
$stories = $this->story->getExecutionStoryPairs($objectID, $productID, $branch, $moduleID, $type);
|
|
}
|
|
else
|
|
{
|
|
$stories = $this->story->getProductStoryPairs($productID, $branch, $moduleID, $storyStatus, 'id_desc', $limit, $type, 'story', $hasParent);
|
|
}
|
|
|
|
if(!in_array($this->app->tab, array('execution', 'project')) and empty($stories)) $stories = $this->story->getProductStoryPairs($productID, $branch, 0, $storyStatus, 'id_desc', $limit, $type, 'story', $hasParent);
|
|
|
|
if($isHTML == 0)
|
|
{
|
|
$storyList = array();
|
|
foreach($stories as $storyID => $storyName) $storyList[] = array('value' => $storyID, 'text' => $storyName);
|
|
return $this->send($storyList);
|
|
}
|
|
|
|
$items = array();
|
|
foreach($stories as $storyID => $storyName) $items[] = array('text' => $storyName, 'value' => $storyID, 'keys' => $storyName);
|
|
return print(json_encode($items));
|
|
}
|
|
|
|
/**
|
|
* AJAX: search stories of a product as json
|
|
*
|
|
* @param string $key #storyID|storyID|keyword
|
|
* @param int $productID
|
|
* @param int $branch
|
|
* @param int $moduleID
|
|
* @param int $storyID
|
|
* @param string $status noclosed
|
|
* @param int $limit 50|0
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function ajaxSearchProductStories(string $key, int $productID, int $branch = 0, int $moduleID = 0, int $storyID = 0, string $status = 'noclosed', int $limit = 50)
|
|
{
|
|
if($moduleID)
|
|
{
|
|
$moduleID = $this->loadModel('tree')->getStoryModule($moduleID);
|
|
$moduleID = $this->tree->getAllChildID($moduleID);
|
|
}
|
|
|
|
$storyStatus = array();
|
|
if($status == 'noclosed')
|
|
{
|
|
$storyStatus = $this->lang->story->statusList;
|
|
unset($storyStatus['closed']);
|
|
$storyStatus = array_keys($storyStatus);
|
|
}
|
|
|
|
$stories = $this->story->getProductStoryPairs($productID, $branch, $moduleID, $storyStatus);
|
|
$result = array();
|
|
$resultCount = 0;
|
|
foreach ($stories as $id => $story)
|
|
{
|
|
if($limit > 0 && $resultCount > $limit) break;
|
|
if(('#' . $id) === $key || stripos($story, $key) !== false)
|
|
{
|
|
$result[$id] = $story;
|
|
$resultCount++;
|
|
}
|
|
}
|
|
if($resultCount < 1) $result['info'] = $this->lang->noResultsMatch;
|
|
|
|
echo json_encode($result);
|
|
}
|
|
|
|
/**
|
|
* 获取需求详情和操作日志。
|
|
* AJAX: get the actions and detail of the story for web app.
|
|
*
|
|
* @param int $storyID
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function ajaxGetDetail(int $storyID)
|
|
{
|
|
$this->view->actions = $this->action->getList('story', $storyID);
|
|
$this->view->story = $this->story->getByID($storyID);
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* 获取需求的信息。
|
|
* AJAX: get module of a story.
|
|
*
|
|
* @param int $storyID
|
|
* @param string $pageType batch
|
|
* @access public
|
|
* @return mixed
|
|
*/
|
|
public function ajaxGetInfo(int $storyID, string $pageType = '')
|
|
{
|
|
$story = $this->story->getByID($storyID);
|
|
if(empty($story)) return;
|
|
|
|
$storyInfo['moduleID'] = $story->module;
|
|
$storyInfo['estimate'] = $story->estimate;
|
|
$storyInfo['pri'] = $story->pri;
|
|
$storyInfo['spec'] = html_entity_decode($story->spec, ENT_QUOTES | ENT_SUBSTITUTE | ENT_HTML401, 'UTF-8');
|
|
$storyInfo['status'] = $story->status;
|
|
|
|
if($pageType == 'batch') return $this->send(array('storyInfo' => $storyInfo));
|
|
|
|
return print(json_encode($storyInfo));
|
|
}
|
|
|
|
/**
|
|
* 获取某产品下的父需求列表。
|
|
* AJAX: get the parent story.
|
|
*
|
|
* @param int $productID
|
|
* @param string $labelName
|
|
* @access public
|
|
* @return string
|
|
*/
|
|
public function ajaxGetParentStory(int $productID, string $labelName = '')
|
|
{
|
|
$stories = $this->story->getParentStoryPairs($productID);
|
|
|
|
$items = array();
|
|
foreach($stories as $storyID => $storyTitle)
|
|
{
|
|
if(empty($storyID)) continue;
|
|
$items[] = array('text' => $storyTitle, 'value' => $storyID);
|
|
}
|
|
|
|
return print(json_encode(array('items' => $items, 'name' => $labelName)));
|
|
}
|
|
|
|
/**
|
|
* 查看需求的报告。
|
|
* The report page.
|
|
*
|
|
* @param int $productID
|
|
* @param int $branchID
|
|
* @param string $storyType
|
|
* @param string $browseType
|
|
* @param int $moduleID
|
|
* @param string $chartType
|
|
* @param int $projectID
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function report(int $productID, int $branchID, string $storyType = 'story', string $browseType = 'unclosed', int $moduleID = 0, string $chartType = 'pie', int $projectID = 0)
|
|
{
|
|
$this->loadModel('report');
|
|
$this->view->charts = array();
|
|
$this->view->datas = array();
|
|
|
|
if(!empty($_POST))
|
|
{
|
|
foreach($this->post->charts as $chart)
|
|
{
|
|
$chartFunc = 'getDataOf' . $chart;
|
|
$chartData = $this->story->$chartFunc();
|
|
$chartOption = $this->lang->story->report->$chart;
|
|
if(!empty($chartType)) $chartOption->type = $chartType;
|
|
$this->story->mergeChartOption($chart);
|
|
|
|
$this->view->charts[$chart] = $chartOption;
|
|
$this->view->datas[$chart] = $this->report->computePercent($chartData);
|
|
}
|
|
}
|
|
|
|
$this->story->replaceURLang($storyType);
|
|
|
|
$product = $this->product->getByID($productID);
|
|
if(strpos('project,execution', $this->app->tab) !== false)
|
|
{
|
|
$project = $this->dao->findByID($projectID)->from(TABLE_PROJECT)->fetch();
|
|
if($project->type == 'project')
|
|
{
|
|
$this->loadModel('project')->setMenu($projectID);
|
|
if($project and $project->model == 'waterfall') unset($this->lang->story->report->charts['storiesPerPlan']);
|
|
}
|
|
else
|
|
{
|
|
$this->loadModel('execution')->setMenu($projectID);
|
|
}
|
|
|
|
if(!$project->hasProduct)
|
|
{
|
|
unset($this->lang->story->report->charts['storiesPerProduct']);
|
|
|
|
if(!$project->multiple) unset($this->lang->story->report->charts['storiesPerPlan']);
|
|
}
|
|
}
|
|
else
|
|
{
|
|
$this->product->setMenu($productID, $branchID);
|
|
}
|
|
|
|
if($storyType != 'story')
|
|
{
|
|
unset($this->lang->story->report->charts['storiesPerPlan']);
|
|
unset($this->lang->story->report->charts['storiesPerStage']);
|
|
}
|
|
|
|
$this->view->title = $product->name . $this->lang->colon . $this->lang->story->reportChart;
|
|
$this->view->productID = $productID;
|
|
$this->view->branchID = $branchID;
|
|
$this->view->browseType = $browseType;
|
|
$this->view->storyType = $storyType;
|
|
$this->view->moduleID = $moduleID;
|
|
$this->view->chartType = $chartType;
|
|
$this->view->projectID = $projectID;
|
|
$this->view->checkedCharts = $this->post->charts ? implode(',', $this->post->charts) : '';
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* 导出需求数据。
|
|
* Get the data of the stories to export.
|
|
*
|
|
* @param int $productID
|
|
* @param string $orderBy
|
|
* @param int $executionID
|
|
* @param string $browseType
|
|
* @param string $storyType requirement|story
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function export(int $productID, string $orderBy, int $executionID = 0, string $browseType = '', string $storyType = 'story')
|
|
{
|
|
/* format the fields of every story in order to export data. */
|
|
if($_POST)
|
|
{
|
|
$this->loadModel('transfer');
|
|
$postData = form::data($this->config->transfer->form->export)->get();
|
|
|
|
$this->session->set('storyTransferParams', array('productID' => $productID, 'executionID' => $executionID));
|
|
/* Create field lists. */
|
|
if(!$productID or $browseType == 'bysearch')
|
|
{
|
|
$this->config->story->dtable->fieldList['branch']['dataSource'] = array('module' => 'branch', 'method' => 'getAllPairs', 'params' => 1);
|
|
$this->config->story->dtable->fieldList['module']['dataSource']['method'] = 'getAllModulePairs';
|
|
$this->config->story->dtable->fieldList['module']['dataSource']['params'] = 'story';
|
|
|
|
$this->config->story->dtable->fieldList['project']['dataSource'] = array('module' => 'project', 'method' => 'getPairsByIdList', 'params' => $executionID);
|
|
$this->config->story->dtable->fieldList['execution']['dataSource'] = array('module' => 'execution', 'method' => 'getPairs', 'params' => $executionID);
|
|
|
|
$productIdList = implode(',', array_flip($this->session->exportProductList));
|
|
|
|
$this->config->story->dtable->fieldList['plan']['dataSource'] = array('module' => 'productplan', 'method' => 'getPairs', 'params' => $productIdList);
|
|
}
|
|
|
|
$this->post->set('rows', $this->story->getExportStories($orderBy, $storyType, $postData));
|
|
$this->fetch('transfer', 'export', 'model=story');
|
|
}
|
|
|
|
$fileName = $storyType == 'requirement' ? $this->lang->URCommon : $this->lang->SRCommon;
|
|
$project = null;
|
|
if($executionID)
|
|
{
|
|
$execution = $this->loadModel('execution')->getByID($executionID);
|
|
$fileName = $execution->name . $this->lang->dash . $fileName;
|
|
$project = $execution;
|
|
if($execution->type == 'execution') $project = $this->project->getById($execution->project);
|
|
}
|
|
else
|
|
{
|
|
$productName = $this->lang->product->all;
|
|
if($productID)
|
|
{
|
|
$product = $this->product->getById($productID);
|
|
$productName = $product->name;
|
|
|
|
if($product->shadow) $project = $this->project->getByShadowProduct($productID);
|
|
}
|
|
if(isset($this->lang->product->featureBar['browse'][$browseType]))
|
|
{
|
|
$browseType = $this->lang->product->featureBar['browse'][$browseType];
|
|
}
|
|
else
|
|
{
|
|
$browseType = isset($this->lang->product->moreSelects[$browseType]) ? $this->lang->product->moreSelects[$browseType] : '';
|
|
}
|
|
|
|
$fileName = $productName . $this->lang->dash . $browseType . $fileName;
|
|
}
|
|
|
|
/* Unset product field when in single project. */
|
|
if(isset($project->hasProduct) && !$project->hasProduct)
|
|
{
|
|
$filterFields = array(', product,', ', branch,');
|
|
if($project->model != 'scrum') $filterFields[] = ', plan,';
|
|
$this->config->story->exportFields = str_replace($filterFields, ',', $this->config->story->exportFields);
|
|
}
|
|
|
|
$this->view->fileName = $fileName;
|
|
$this->view->allExportFields = $this->config->story->exportFields;
|
|
$this->view->customExport = true;
|
|
$this->view->storyType = $storyType;
|
|
$this->display();
|
|
}
|
|
|
|
/**
|
|
* 通过AJAX方式获取用户需要处理的需求。
|
|
* AJAX: get stories of a user in html select.
|
|
*
|
|
* @param int $userID
|
|
* @param string $id the id of the select control.
|
|
* @param int $appendID
|
|
* @access public
|
|
* @return string
|
|
*/
|
|
public function ajaxGetUserStories(int $userID = 0, string $id = '', int $appendID = 0)
|
|
{
|
|
if(empty($userID)) $userID = $this->app->user->id;
|
|
$user = $this->loadModel('user')->getById($userID, 'id');
|
|
$stories = $this->story->getUserStoryPairs($user->account, 10, 'story', '', $appendID);
|
|
|
|
$items = array();
|
|
foreach($stories as $storyID => $storyTitle) $items[] = array('text' => $storyTitle, 'value' => $storyID);
|
|
|
|
$fieldName = $id ? "stories[$id]" : 'story';
|
|
return print(json_encode(array('name' => $fieldName, 'items' => $items)));
|
|
}
|
|
|
|
/**
|
|
* 通过AJAX方式获取需求的状态。
|
|
* AJAX: get story status.
|
|
*
|
|
* @param string $method
|
|
* @param string $params
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function ajaxGetStatus(string $method, string $params = '')
|
|
{
|
|
parse_str(str_replace(',', '&', $params), $params);
|
|
$status = '';
|
|
if($method == 'create')
|
|
{
|
|
$status = 'draft';
|
|
if(!empty($params['needNotReview'])) $status = 'active';
|
|
if(!empty($params['project'])) $status = 'active';
|
|
if($this->story->checkForceReview()) $status = 'draft';
|
|
}
|
|
elseif($method == 'change')
|
|
{
|
|
$oldStory = $this->dao->findById((int)$params['storyID'])->from(TABLE_STORY)->fetch();
|
|
$status = $oldStory->status;
|
|
if($params['changing'] and $oldStory->status == 'active' and empty($params['needNotReview'])) $status = 'changing';
|
|
if($params['changing'] and $oldStory->status == 'active' and $this->story->checkForceReview()) $status = 'changing';
|
|
if($params['changing'] and $oldStory->status == 'draft' and $params['needNotReview']) $status = 'active';
|
|
}
|
|
elseif($method == 'review')
|
|
{
|
|
$oldStory = $this->dao->findById((int)$params['storyID'])->from(TABLE_STORY)->fetch();
|
|
$status = $oldStory->status;
|
|
if($params['result'] == 'revert') $status = 'active';
|
|
}
|
|
echo $status;
|
|
}
|
|
|
|
/**
|
|
* 用AJAX方式获取需求的指派给。
|
|
* AJAX: get story assignee.
|
|
*
|
|
* @param string $type create|review|change
|
|
* @param int $storyID
|
|
* @param array|string $assignees
|
|
* @access public
|
|
* @return mixed
|
|
*/
|
|
public function ajaxGetAssignedTo(string $type = '', int $storyID = 0, array|string $assignees = '')
|
|
{
|
|
$users = $this->loadModel('user')->getPairs('noclosed|nodeleted');
|
|
|
|
if($type == 'create')
|
|
{
|
|
$selectUser = is_array($assignees) ? current($assignees) : '';
|
|
|
|
return print(html::select('assignedTo', $users, $selectUser, "class='from-control picker-select'"));
|
|
}
|
|
|
|
if($type == 'review')
|
|
{
|
|
$story = $this->story->getByID($storyID);
|
|
$reviewers = $this->story->getReviewerPairs($storyID, $story->version);
|
|
$isChanged = $story->changedBy ? true : false;
|
|
$superReviewers = trim(zget($this->config->story, 'superReviewers', ''), ',');
|
|
$isSuperReviewer = strpos(",{$superReviewers},", ",{$this->app->user->account},") !== false;
|
|
|
|
if(count($reviewers) == 1)
|
|
{
|
|
$selectUser = $isChanged ? $story->changedBy : $story->openedBy;
|
|
}
|
|
else
|
|
{
|
|
unset($reviewers[$this->app->user->account]);
|
|
foreach($reviewers as $account => $result)
|
|
{
|
|
if(empty($result))
|
|
{
|
|
$selectUser = $account;
|
|
break;
|
|
}
|
|
else
|
|
{
|
|
$selectUser = $isChanged ? $story->changedBy : $story->openedBy;
|
|
}
|
|
}
|
|
}
|
|
|
|
if($isSuperReviewer !== false) $selectUser = $isChanged ? $story->changedBy : $story->openedBy;
|
|
|
|
return print(html::select('assignedTo', $users, $selectUser, "class='from-control picker-select'"));
|
|
}
|
|
|
|
if($type == 'change')
|
|
{
|
|
$selectUser = is_array($assignees) ? current($assignees) : '';
|
|
|
|
return print(html::select('assignedTo', $users, $selectUser, "class='from-control picker-select'"));
|
|
}
|
|
|
|
return false;
|
|
|
|
}
|
|
|
|
/**
|
|
* AJAX: Get user requirements.
|
|
*
|
|
* @param int $productID
|
|
* @param int $branchID
|
|
* @param int $moduleID
|
|
* @param string $requirementList
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function ajaxGetURS(int $productID, string $branchID = '0', int $moduleID = 0, string $requirementList = '0')
|
|
{
|
|
$moduleIdList = $this->loadModel('tree')->getAllChildId($moduleID);
|
|
|
|
$URS = $this->story->getProductStoryPairs($productID, $branchID, $moduleIdList, 'changing,active,reviewing', 'id_desc', 0, '', 'requirement');
|
|
|
|
$items = array();
|
|
foreach($URS as $URID => $URTitle)
|
|
{
|
|
if(empty($URID)) continue;
|
|
$items[] = array('text' => $URTitle, 'value' => $URID);
|
|
}
|
|
|
|
return print(json_encode(array('name' => 'URS[]', 'multiple' => true, 'defaultValue' => $requirementList, 'items' => $items)));
|
|
}
|
|
|
|
/**
|
|
* 移除需求的孪生需求。
|
|
* AJAX: Deleted story twin.
|
|
*
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function ajaxRelieveTwins()
|
|
{
|
|
$twinID = !empty($_POST['twinID']) ? $_POST['twinID'] : 0;
|
|
$story = $this->story->getByID($twinID);
|
|
$twins = explode(',', trim($story->twins, ','));
|
|
|
|
if(empty($story->twins)) return $this->send(array('result' => 'fail'));
|
|
|
|
/* Batch unset twinID from twins for the story by the product. */
|
|
$replaceSql = "UPDATE " . TABLE_STORY . " SET twins = REPLACE(twins,',$twinID,', ',') WHERE `product` = $story->product";
|
|
$this->dbh->exec($replaceSql);
|
|
|
|
/* Update twins to empty by twinID and if twins eq ','. */
|
|
$this->dao->update(TABLE_STORY)->set('twins')->eq('')->where('id')->eq($twinID)->orWhere('twins')->eq(',')->exec();
|
|
|
|
if(!dao::isError()) $this->loadModel('action')->create('story', $twinID, 'relieved');
|
|
return $this->send(array('result' => 'success', 'twinsCount' => count($twins)-1));
|
|
}
|
|
|
|
/**
|
|
* 获取需求ID和需求概要信息键值对的html信息。批量关闭时如果原因是重复了，需要选择重复的需求。
|
|
* AJAX: Get the html with story pairs to choose the duplicated story.
|
|
*
|
|
* @param int $storyID
|
|
* @access public
|
|
* @return void
|
|
*/
|
|
public function ajaxGetDuplicatedStory(int $storyID)
|
|
{
|
|
$story = $this->story->getByID($storyID);
|
|
$stories = $this->story->getProductStoryPairs($story->product, $story->branch, 0, 'all', 'id_desc', 0, '', $story->type);
|
|
|
|
$items = array();
|
|
foreach($stories as $storyID => $storyTitle)
|
|
{
|
|
if(empty($storyID)) continue;
|
|
$items[] = array('text' => $storyTitle, 'value' => $storyID, 'keys' => $storyTitle);
|
|
}
|
|
return print(json_encode($items));
|
|
}
|
|
}
|