Files
EasySoft-ZenTaoPMS/module/release/control.php
T

540 lines
21 KiB
PHP

<?php
/**
* The control file of release module of ZenTaoPMS.
*
* @copyright Copyright 2009-2015 禅道软件(青岛)有限公司(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 release
* @version $Id: control.php 4178 2013-01-20 09:32:11Z wwccss $
* @link http://www.zentao.net
*/
class release extends control
{
/**
* 公共函数,设置产品菜单及页面基础数据。
* Common action, set the menu and basic data.
*
* @param int $productID
* @param string $branch
* @access public
* @return void
*/
public function commonAction(int $productID, string $branch = '')
{
$this->loadModel('product')->setMenu($productID, $branch);
$product = $this->product->getById($productID);
if(empty($product)) $this->locate($this->createLink('product', 'create'));
$this->view->product = $product;
$this->view->branch = $branch;
$this->view->branches = $product->type == 'normal' ? array() : $this->loadModel('branch')->getPairs($product->id);
}
/**
* 发布列表。
* Browse releases.
*
* @param int $productID
* @param string $branch
* @param string $type all|normal|terminate
* @param string $orderBy
* @param string $param
* @param int $recTotal
* @param int $recPerPage
* @param int $pageID
* @access public
* @return void
*/
public function browse(int $productID, string $branch = 'all', string $type = 'all', string $orderBy = 't1.date_desc', string $param = '', int $recTotal = 0, int $recPerPage = 20, int $pageID = 1)
{
$this->app->loadClass('pager', true);
$pager = new pager($recTotal, $recPerPage, $pageID);
$this->commonAction($productID, $branch);
$uri = $this->app->getURI(true);
$this->session->set('releaseList', $uri, 'product');
$this->session->set('buildList', $uri);
$showBranch = $this->view->product->type != 'normal';
if(!$showBranch)
{
unset($this->config->release->dtable->fieldList['branch']);
unset($this->config->release->search['fields']['branch']);
unset($this->config->release->search['params']['branch']);
}
$sort = $orderBy;
if(strpos($sort, 'branchName_') !== false) $sort = str_replace('branchName_', 'branch_', $sort);
$queryID = $type == 'bySearch' ? (int)$param : 0;
$actionURL = $this->createLink('release', 'browse', "productID={$productID}&branch={$branch}&type=bySearch&orderBy={$sort}&param=myQueryID");
$this->releaseZen->buildSearchForm($queryID, $actionURL, $this->view->product, $branch);
$releaseQuery = $type == 'bySearch' ? $this->releaseZen->getSearchQuery($queryID) : '';
$releases = $this->release->getList($productID, $branch, $type, $sort, $releaseQuery, $pager);
$this->view->title = $this->view->product->name . $this->lang->colon . $this->lang->release->browse;
$this->view->releases = $this->releaseZen->processReleaseListData($releases);
$this->view->pageSummary = $this->release->getPageSummary($releases, $type);
$this->view->type = $type;
$this->view->orderBy = $orderBy;
$this->view->param = $param;
$this->view->pager = $pager;
$this->view->showBranch = $showBranch;
$this->view->branchPairs = $this->loadModel('branch')->getPairs($productID);
$this->display();
}
/**
* 创建一个发布。
* Create a release.
*
* @param int $productID
* @param string $branch
* @access public
* @return void
*/
public function create(int $productID, string $branch = 'all')
{
if(!empty($_POST))
{
$releaseData = $this->releaseZen->buildReleaseForCreate($productID, (int)$branch);
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
$releaseID = $this->release->create($releaseData, $this->post->sync ? true : false);
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
$this->loadModel('action')->create('release', $releaseID, 'opened');
$result = $this->executeHooks($releaseID);
$message = $result ? $result : $this->lang->saveSuccess;
if($this->viewType == 'json') return $this->send(array('result' => 'success', 'message' => $message, 'id' => $releaseID));
if(isInModal()) return $this->send(array('result' => 'success', 'message' => $message, 'closeModal' => true, 'callback' => "parent.loadProductBuilds($productID)"));
return $this->send(array('result' => 'success', 'message' => $message, 'load' => inlink('view', "releaseID={$releaseID}")));
}
$builds = $this->loadModel('build')->getBuildPairs(array($productID), $branch, 'notrunk|withbranch|hasproject', 0, 'execution', '', false);
$releasedBuilds = $this->release->getReleasedBuilds($productID, $branch);
foreach($releasedBuilds as $build) unset($builds[$build]);
$this->commonAction($productID, $branch);
$this->view->title = $this->view->product->name . $this->lang->colon . $this->lang->release->create;
$this->view->productID = $productID;
$this->view->builds = $builds;
$this->view->users = $this->loadModel('user')->getPairs('noclosed');
$this->view->lastRelease = $this->release->getLast($productID, (int)$branch);
$this->display();
}
/**
* 编辑一个发布。
* Edit a release.
*
* @param int $releaseID
* @access public
* @return void
*/
public function edit(int $releaseID)
{
$release = $this->release->getByID($releaseID);
if(!empty($_POST))
{
$releaseData = form::data()->setIF($this->post->build === false, 'build', 0)->get();
$changes = $this->release->update($releaseData, $release);
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
if($changes)
{
$actionID = $this->loadModel('action')->create('release', $releaseID, 'Edited');
if(!empty($changes)) $this->action->logHistory($actionID, $changes);
}
$result = $this->executeHooks($releaseID);
$message = $result ? $result : $this->lang->saveSuccess;
return $this->send(array('result' => 'success', 'message' => $message, 'load' => inlink('view', "releaseID={$releaseID}")));
}
/* Get release and build. */
$this->commonAction($release->product);
$builds = $this->loadModel('build')->getBuildPairs(array($release->product), $release->branch, 'notrunk|withbranch|hasproject', 0, 'project', $release->build, false);
$releasedBuilds = $this->release->getReleasedBuilds($release->product);
foreach($releasedBuilds as $releasedBuild)
{
if(strpos(',' . trim($release->build, ',') . ',', ",{$releasedBuild},") === false) unset($builds[$releasedBuild]);
}
$this->view->title = $this->view->product->name . $this->lang->colon . $this->lang->release->edit;
$this->view->release = $release;
$this->view->builds = $builds;
$this->view->users = $this->loadModel('user')->getPairs('noclosed');
$this->display();
}
/**
* 查看一个发布。
* View a release.
*
* @param int $releaseID
* @param string $type story|bug|leftBug
* @param string $link
* @param string $param
* @param string $orderBy
* @param int $recTotal
* @param int $recPerPage
* @param int $pageID
* @access public
* @return void
*/
public function view(int $releaseID, string $type = 'story', string $link = 'false', string $param = '', string $orderBy = 'id_desc', int $recTotal = 0, int $recPerPage = 100, int $pageID = 1)
{
$release = $this->release->getByID($releaseID, true);
if(!$release) return sendError($this->lang->notFound, $this->createLink('product', 'index'));
$uri = $this->app->getURI(true);
if(!empty($release->build)) $this->session->set('buildList', $uri, 'project');
if($type == 'story') $this->session->set('storyList', $uri, 'product');
if($type == 'bug' || $type == 'leftBug') $this->session->set('bugList', $uri, 'qa');
/* Load pager. */
$this->app->loadClass('pager', true);
if($this->app->getViewType() == 'mhtml') $recPerPage = 10;
$sort = common::appendOrder($orderBy);
if(strpos($sort, 'pri_') !== false) $sort = str_replace('pri_', 'priOrder_', $sort);
$sort .= ',buildID_asc';
$storyPager = new pager($type == 'story' ? $recTotal : 0, $recPerPage, $type == 'story' ? $pageID : 1);
$bugPager = new pager($type == 'bug' ? $recTotal : 0, $recPerPage, $type == 'bug' ? $pageID : 1);
$leftBugPager = new pager($type == 'leftBug' ? $recTotal : 0, $recPerPage, $type == 'leftBug' ? $pageID : 1);
$this->releaseZen->assignVarsForView($release, $type, $link, $param, $orderBy, $storyPager, $bugPager, $leftBugPager);
$this->commonAction($release->product);
if($this->app->rawModule == 'projectrelease')
{
$projectID = (int)$this->session->project;
$this->loadModel('project')->setMenu($projectID);
$this->view->project = $this->project->getByID($projectID);
}
$this->executeHooks($releaseID);
$this->display();
}
/**
* Notify for release.
*
* @param int $releaseID
* @access public
* @return void
*/
public function notify(int $releaseID, int $projectID = 0)
{
if($_POST)
{
if(isset($_POST['notify']))
{
$notify = implode(',', $this->post->notify);
$this->dao->update(TABLE_RELEASE)->set('notify')->eq($notify)->where('id')->eq($releaseID)->exec();
$this->release->sendmail($releaseID);
$this->loadModel('action')->create('release', $releaseID, 'notified');
}
$this->send(array('result' => 'success', 'message' => $this->lang->saveSuccess, 'load' => true, 'closeModal' => true));
}
if($this->app->tab == 'project' && $projectID != 0)
{
$project = $this->loadModel('project')->getByID($this->session->project);
if(!$project->hasProduct)
{
unset($this->lang->release->notifyList['FB']);
unset($this->lang->release->notifyList['PO']);
unset($this->lang->release->notifyList['QD']);
}
if(!$project->multiple) unset($this->lang->release->notifyList['ET']);
}
$this->view->release = $this->release->getById($releaseID);
$this->view->actions = $this->loadModel('action')->getList('release', $releaseID);
$this->view->users = $this->loadModel('user')->getPairs('noletter|noclosed');
$this->display();
}
/**
* 删除发布。
* Delete a release.
*
* @param int $releaseID
* @access public
* @return void
*/
public function delete(int $releaseID)
{
$this->release->delete(TABLE_RELEASE, $releaseID);
if(dao::isError()) return $this->send(array('result' => 'fail', 'message' => dao::getError()));
$message = $this->executeHooks($releaseID) ?: $this->lang->saveSuccess;
if($this->viewType == 'json') return $this->send(array('result' => 'success', 'message' => $message));
$locate = $this->session->releaseList ? $this->session->releaseList : $this->createLink($this->app->rawModule, 'browse', "productID={$release->product}");
return $this->send(array('result' => 'success', 'load' => $locate));
}
/**
* 导出需求列表和Bug列表。
* Export story list and bug list.
*
* @access public
* @return void
*/
public function export()
{
if(!empty($_POST))
{
$type = $this->post->type;
$fileName = $this->post->fileName;
if(empty($fileName)) return $this->sendError(array('fileName' => sprintf($this->lang->error->notempty, $this->lang->release->fileName)));
$html = '';
if($type == 'story' or $type == 'all') $html .= $this->releaseZen->buildStoryDataForExport();
if($type == 'bug' || $type == 'all') $html .= $this->releaseZen->buildBugDataForExport();
if($type == 'leftbug' || $type == 'all') $html .= $this->releaseZen->buildLeftBugDataForExport();
$html = "<html><head><meta charset='utf-8'><title>{$fileName}</title><style>table, th, td{font-size:12px; border:1px solid gray; border-collapse:collapse;}</style></head><body>$html</body></html>";
$this->loadModel('file')->sendDownHeader($fileName, 'html', $html);
}
$this->display();
}
/**
* 关联需求。
* Link stories
*
* @param int $releaseID
* @param string $browseType
* @param int $param
* @param int $recTotal
* @param int $recPerPage
* @param int $pageID
* @access public
* @return void
*/
public function linkStory(int $releaseID = 0, string $browseType = '', int $param = 0, int $recTotal = 0, int $recPerPage = 100, int $pageID = 1)
{
if(!empty($_POST['stories']))
{
$this->release->linkStory($releaseID, $this->post->stories);
if(dao::isError()) return $this->sendError(dao::getError());
return $this->sendSuccess(array('load' => $this->createLink($this->app->rawModule, 'view', "releaseID={$releaseID}&type=story"), 'closeModal' => true));
}
$this->loadModel('story');
$this->session->set('storyList', $this->createLink($this->app->rawModule, 'view', "releaseID={$releaseID}&type=story&link=true&param=" . helper::safe64Encode("&browseType=$browseType&queryID=$param")), 'product');
$release = $this->release->getByID($releaseID);
$this->commonAction($release->product);
$queryID = ($browseType == 'bySearch') ? (int)$param : 0;
$this->releaseZen->buildLinkStorySearchForm($release, $queryID);
$builds = $this->loadModel('build')->getByList(explode(',', $release->build));
$executionIdList = array();
foreach($builds as $build)
{
if(!empty($build->execution)) $executionIdList[$build->execution] = $build->execution;
if(empty($build->execution) && !empty($build->project)) $executionIdList[$build->project] = $build->project;
}
/* Load pager. */
$this->app->loadClass('pager', true);
$pager = new pager($recTotal, $recPerPage, $pageID);
if($browseType == 'bySearch')
{
$allStories = $this->story->getBySearch($release->product, $release->branch, $queryID, 'id', $executionIdList, 'story', $release->stories, $pager);
}
else
{
$allStories = $this->story->batchGetExecutionStories(implode(',', $executionIdList), $release->product, 't1.`order`_desc', 'byBranch', $release->branch, 'story', $release->stories, $pager);
}
$this->view->allStories = $allStories;
$this->view->release = $release;
$this->view->users = $this->loadModel('user')->getPairs('noletter');
$this->view->browseType = $browseType;
$this->view->param = $param;
$this->display();
}
/**
* 移除关联的需求。
* Unlink a story.
*
* @param int $releaseID
* @param int $storyID
* @access public
* @return void
*/
public function unlinkStory(int $releaseID, int $storyID)
{
$this->release->unlinkStory($releaseID, $storyID);
if(dao::isError()) return $this->sendError(dao::getError());
return $this->sendSuccess(array('load' => $this->createLink($this->app->rawModule, 'view', "releaseID=$releaseID&type=story")));
}
/**
* 批量解除发布跟需求的关联。
* Batch unlink story.
*
* @param int $releaseID
* @access public
* @return void
*/
public function batchUnlinkStory(int $releaseID)
{
$this->release->batchUnlinkStory($releaseID, (array)$this->post->storyIdList);
return $this->sendSuccess(array('load' => $this->createLink($this->app->rawModule, 'view', "releaseID={$releaseID}&type=story")));
}
/**
* 发布批量关联Bug。
* Link bugs.
*
* @param int $releaseID
* @param string $browseType bug|leftBug|bySearch
* @param int $param
* @param string $type bug|leftBug
* @param int $recTotal
* @param int $recPerPage
* @param int $pageID
* @access public
* @return void
*/
public function linkBug(int $releaseID = 0, string $browseType = '', int $param = 0, string $type = 'bug', int $recTotal = 0, int $recPerPage = 100, int $pageID = 1)
{
if(!empty($_POST['bugs']))
{
$this->release->linkBug($releaseID, $type, (array)$this->post->bugs);
return $this->sendSuccess(array('load' => $this->createLink($this->app->rawModule, 'view', "releaseID={$releaseID}&type={$type}")));
}
$this->session->set('bugList', $this->createLink($this->app->rawModule, 'view', "releaseID=$releaseID&type=$type&link=true&param=" . helper::safe64Encode("&browseType=$browseType&queryID=$param")), 'qa');
/* Set menu. */
$this->loadModel('bug');
$release = $this->release->getByID($releaseID);
$this->commonAction($release->product);
/* Build the search form. */
$queryID = $browseType == 'bySearch' ? (int)$param : 0;
$this->releaseZen->buildLinkBugSearchForm($release, $queryID, $type);
/* Load pager. */
$this->app->loadClass('pager', true);
$pager = new pager($recTotal, $recPerPage, $pageID);
$builds = $this->loadModel('build')->getByList(explode(',', $release->build));
$allBugs = array();
$releaseBugs = $type == 'bug' ? $release->bugs : $release->leftBugs;
if($browseType == 'bySearch')
{
$allBugs = $this->bug->getBySearch('bug', $release->product, $release->branch, 0, 0 , $queryID, $releaseBugs, 'id_desc', $pager);
}
else
{
$functionName = $type == 'bug' ? 'getReleaseBugs' : 'getProductLeftBugs';
$allBugs = $this->bug->$functionName(array_keys($builds), $release->product, $release->branch, $releaseBugs, $pager);
}
$this->view->allBugs = $allBugs;
$this->view->releaseBugs = empty($releaseBugs) ? array() : $this->bug->getByIdList($releaseBugs);
$this->view->release = $release;
$this->view->users = $this->loadModel('user')->getPairs('noletter');
$this->view->browseType = $browseType;
$this->view->param = $param;
$this->view->type = $type;
$this->view->pager = $pager;
$this->display();
}
/**
* 移除关联的Bug。
* Unlink linked bug.
*
* @param int $releaseID
* @param int $bugID
* @param string $type
* @access public
* @return void
*/
public function unlinkBug(int $releaseID, int $bugID, string $type = 'bug')
{
$this->release->unlinkBug($releaseID, $bugID, $type);
/* if ajax request, send result. */
if(dao::isError())
{
$response['result'] = 'fail';
$response['message'] = dao::getError();
}
else
{
$response['result'] = 'success';
$response['message'] = '';
$response['load'] = $this->createLink($this->app->rawModule, 'view', "releaseID={$releaseID}&type={$type}");
}
return $this->send($response);
}
/**
* 批量解除发布跟Bug的关联。
* Batch unlink story.
*
* @param int $releaseID
* @param string $type bug|leftBug
* @access public
* @return void
*/
public function batchUnlinkBug(int $releaseID, string $type = 'bug')
{
$this->release->batchUnlinkBug($releaseID, $type, (array)$this->post->bugIdList);
return $this->sendSuccess(array('load' => $this->createLink($this->app->rawModule, 'view', "releaseID={$releaseID}&type={$type}")));
}
/**
* 激活/停止维护发布。
* Change status.
*
* @param int $releaseID
* @param string $status normal|terminate
* @access public
* @return void
*/
public function changeStatus(int $releaseID, string $status)
{
$this->release->changeStatus($releaseID, $status);
if(dao::isError()) return $this->sendError(dao::getError());
$this->loadModel('action')->create('release', $releaseID, 'changestatus', '', $status);
return $this->sendSuccess(array('load' => true));
}
}