* @package entries * @version 1 * @link https://www.zentao.net */ class storiesEntry extends entry { /** * GET method. * * @param int $productID * @access public * @return string */ public function get($productID = 0) { if(!$productID) $productID = $this->param('product'); if(!$productID) return $this->sendError(400, 'Need product id.'); $control = $this->loadController('product', 'browse'); $control->browse($productID, $this->param('branch', ''), $this->param('status', 'unclosed'), 0, $this->param('type', 'story'), $this->param('order', 'id_desc'), 0, $this->param('limit', 500), $this->param('page', 1)); $data = $this->getData(); if(!$data or !isset($data->status)) return $this->sendError(400, 'error'); if(isset($data->status) and $data->status == 'fail') return $this->sendError(zget($data, 'code', 400), $data->message); $stories = $data->data->stories; $pager = $data->data->pager; $requirements = $this->loadModel('story')->getRequirements($productID); if(!empty($requirements)) $requirements = $this->story->getByList(array_keys($requirements)); $result = array(); $this->loadModel('product'); foreach($stories as $story) { $product = $this->product->getById($story->product); $story->productStatus = $product->status; if(isset($story->children)) { $story->children = array_values((array)$story->children); foreach($story->children as $id => $children) { $childrenProduct = $this->product->getById($children->product); $story->children[$id]->productStatus = $childrenProduct->status; } } $result[] = $this->format($story, 'title:decodeHtml,openedBy:user,openedDate:time,assignedTo:user,assignedDate:time,reviewedBy:user,reviewedDate:time,lastEditedBy:user,lastEditedDate:time,closedBy:user,closedDate:time,deleted:bool,mailto:userList'); } return $this->send(201, array('page' => $pager->pageID, 'total' => $pager->recTotal, 'limit' => $pager->recPerPage, 'stories' => $result, 'requirements' => $requirements)); } /** * POST method. * * @param int $productID * @access public * @return string */ public function post($productID = 0) { if(!$productID) $productID = $this->param('product', 0); if(!$productID and isset($this->requestBody->product)) $productID = $this->requestBody->product; if(!$productID) return $this->sendError(400, 'Need product id.'); $control = $this->loadController('story', 'create'); $fields = 'title,spec,verify,module,reviewer,type,parent,moduleOptionMenu,source,sourceNote,category,pri,estimate,mailto,keywords,notifyemail,uid,status'; $this->batchSetPost($fields); $module = $this->request('module', 0) ? $this->request('module', 0) : 0; $this->setPost('plans', array($this->request('plan', 0))); $this->setPost('branches', array($this->request('branch'))); $this->setPost('modules', array($module)); $this->setPost('product', $productID); $this->setPost('type', $this->request('type', 'story')); $this->setPost('grade', $this->request('grade', '')); /* 获取评审相关参数 */ $reviewer = $this->request('reviewer'); $status = $this->request('status', 'active'); // 创建时默认状态为 'active' $forceReview = $this->loadModel('story')->checkForceReview($this->request('type', 'story')); if($forceReview) { $needNotReview = 0; } else { $needNotReview = empty($reviewer) ? 1 : 0; } $this->setPost('reviewer', $reviewer); $this->setPost('needNotReview', $needNotReview); /* 设置状态逻辑,与web端保持一致(参考 common.ui.js 中的 clickSubmit 函数) */ /* 如果状态是 'active' 且有评审人且未勾选不需要评审,则将状态设置为 'reviewing' */ $hasReviewer = !empty($reviewer); $isActiveNeedReview = $status == 'active' && !$needNotReview; if($hasReviewer && $isActiveNeedReview) { $this->setPost('status', 'reviewing'); } else { /* 如果未指定状态,保持默认值 'active';如果指定了 'draft',保持 'draft' */ $this->setPost('status', $status); } $this->requireFields('title,spec,pri,category'); $control->create($productID, $this->param('branch', 0), $this->param('moduleID', 0), $this->param('storyID', 0), $this->param('objectID', 0), $this->param('bugID', 0), 0, 0, '', $this->param('type', 'story')); $data = $this->getData(); if(isset($data->status) and $data->status == 'fail') return $this->sendError(zget($data, 'code', 400), $data->message); if(isset($data->result) and !isset($data->id)) return $this->sendError(400, $data->message); $story = $this->loadModel('story')->getByID($data->id); return $this->send(200, $this->format($story, 'openedBy:user,openedDate:time,assignedTo:user,assignedDate:time,reviewedBy:user,reviewedDate:time,lastEditedBy:user,lastEditedDate:time,closedBy:user,closedDate:time,deleted:bool,mailto:userList')); } }