需求背景

  • 测试人员反馈 禅道通过csv导入的用例数量大的情况下一一去关联需求很麻烦，效率不高
  • image.png

  • 希望可以有一个一键批量关联相关用例的功能以供使用。

    修改思路

    image.png

  • 在途中红框处添加一个相关需求的选项，以批量编辑关联需求。

    涉及修改 - 自顶向下

  • view

    • testcase/view/browse.html.php
  • control
    • 添加 batchCaseStoryChange 方法

  • model

    • 添加 btachCaseStoryChange 调用的model层方法

      具体实现

      browse.html.php

      ```php

      1.      // FIXME 批量修改 pri 优先级
      2.      if(common::hasPriv('testcase', 'batchCasePriChange'))
      3.      {
      4.          echo "<li class='dropdown-submenu'>";
      5.          echo html::a('javascript:;', $lang->testcase->pri, '', "id='priChangeItem'");
      6.          echo "<ul class='dropdown-menu'>";
      7.          unset($lang->testcase->priList['']);
      8.          foreach($lang->testcase->priList as $key => $result)
      9.          {
      10.              $actionLink = $this->createLink('testcase', 'batchCasePriChange', "result=$key");
      11.              echo '<li>' . html::a('#', $result, '', "onclick=\"setFormAction('$actionLink', 'hiddenwin')\"") . '</li>';
      12.          }
      13.          echo '</ul></li>';
      14.      }
      15.        // end of FIXME
  1.           // FIXME 批量修改 story  关联需求
  2.           if(common::hasPriv('testcase', 'batchCaseStoryChange'))
  3.           {
  4.               echo "<li class='dropdown-submenu'>";
  5.               echo html::a('javascript:;', $lang->testcase->story, '', "id='storyChangeItem'");
  6.               echo "<ul class='dropdown-menu'>";

// unset($lang->testcase->priList[‘’]); foreach($storyList as $key => $result) { $actionLink = $this->createLink(‘testcase’, ‘batchCaseStoryChange’, “result=$key”); echo ‘

  • ‘ . html::a(‘#’, $result, ‘’, “onclick=\”setFormAction(‘$actionLink’, ‘hiddenwin’)\””) . ‘
    • ‘; } echo ‘‘; } // end of FIXME

    1.           if(common::hasPriv('testcase', 'batchCaseTypeChange'))
    2.           {
    3.               echo "<li class='dropdown-submenu'>";
    4.               echo html::a('javascript:;', $lang->testcase->type, '', "id='typeChangeItem'");
    5.               echo "<ul class='dropdown-menu'>";
    6.               unset($lang->testcase->typeList['']);
    7.               foreach($lang->testcase->typeList as $key => $result)
    8.               {
    9.                   $actionLink = $this->createLink('testcase', 'batchCaseTypeChange', "result=$key");
    10.                   echo '<li>' . html::a('#', $result, '', "onclick=\"setFormAction('$actionLink', 'hiddenwin')\"") . '</li>';
    11.               }
    12.               echo '</ul></li>';
    13.           }
    2. - 参照原有逻辑，如批量修改用例类来进行本次拓展
    3. <a name="bZZhy"></a>
    4. ## control层拓展
    5. ```php
    6. <?php
    9. include '../../control.php';
    13. class myTestCase extends testcase{
    17.     // FIXME 新增 批量更改关联需求
    18.     /*
    19.      * $result 前端页面传回的目标值
    20.      *
    21.      *
    22.      *
    23.      */
    24.     public function batchCaseStoryChange($result){
    25.         $caseIdList = $this->post->caseIDList ? $this->post->caseIDList : die(js::locate($this->session->caseList, 'parent'));
    26.         $caseIDList = array_unique($caseIDList);
    27.         // 调用新增的 btachCase
    28.         $this->testcase->batchCaseStoryChange($caseIdList, $result);
    30.         if(dao::isError()) die(js::error(dao::getError()));
    31.         die(js::locate($this->session->caseList, 'parent'));
    32.     }
    33. }
    • 按照禅道的扩展规则来进行control方法扩展，具体方法参考与安生逻辑

      model层扩展

      ```php <?php

    public function batchCaseStoryChange($caseIdList, $result){

    1. $now     = helper::now();
    2. $actions = array();
    3. $this->loadModel('action');
    5. foreach($caseIdList as $caseID) {
    6.     $case = new stdClass();
    7.     $case->lastEditedBy = $this->app->user->account;
    8.     $case->lastEditedDate = $now;
    9.     // FIXME 优先级更改为需求变更菜单
    10.     $case->story = $result;
    12.     $this->dao->update(TABLE_CASE)->data($case)->autoCheck()->where('id')->eq($caseID)->exec();
    13.     $this->action->create('case', $caseID, 'Edited', '', ucfirst($result));
    15. }

    }

    2. - model 层为control 层提供调用方法，
    3. - 整体调用链条 control 调用model 方法，获取到数据 渲染至页面。
    4. <a name="zeGwm"></a>
    5. # 坑点
    7. - 因是二开功能，所以页面上没有story变量 也就是说，browse页面没有story变量，所以如何吧当前产品的所有需求渲染至页面是本功能二开的一个难点。
    8. <a name="PcCiB"></a>
    9. # 解决思路
    11. - 首先去寻找禅道原生代码中类似的逻辑，参考其代码get到当前产品中所有的需求列表，渲染至前端。下见代码
    12. ```php
    13. <?php
    16. include '../../control.php';
    20. class myTestCase extends testcase{
    24.     /**
    25.      * Browse cases.
    26.      *
    27.      * @param  int    $productID
    28.      * @param  string $browseType
    29.      * @param  int    $param
    30.      * @param  string $orderBy
    31.      * @param  int    $recTotal
    32.      * @param  int    $recPerPage
    33.      * @param  int    $pageID
    34.      * @access public
    35.      * @return void
    36.      */
    37.     public function browse($productID = 0, $branch = '', $browseType = 'all', $param = 0, $orderBy = 'id_desc', $recTotal = 0, $recPerPage = 20, $pageID = 1)
    38.     {
    39.         $this->loadModel('datatable');
    41.         // FIXME 加载story模块  供后续直接进行调用
    42.         $this->loadModel('story');
    44.         /* Set browse type. */
    45.         $browseType = strtolower($browseType);
    47.         /* Set browseType, productID, moduleID and queryID. */
    48.         $productID = $this->product->saveState($productID, $this->products);
    49.         $branch    = ($branch === '') ? (int)$this->cookie->preBranch : (int)$branch;
    50.         setcookie('preProductID', $productID, $this->config->cookieLife, $this->config->webRoot, '', false, true);
    51.         setcookie('preBranch', (int)$branch, $this->config->cookieLife, $this->config->webRoot, '', false, true);
    53.         if($this->cookie->preProductID != $productID or $this->cookie->preBranch != $branch)
    54.         {
    55.             $_COOKIE['caseModule'] = 0;
    56.             setcookie('caseModule', 0, 0, $this->config->webRoot, '', false, false);
    57.         }
    58.         if($browseType == 'bymodule') setcookie('caseModule', (int)$param, 0, $this->config->webRoot, '', false, false);
    59.         if($browseType == 'bysuite')  setcookie('caseSuite', (int)$param, 0, $this->config->webRoot, '', false, true);
    60.         if($browseType != 'bymodule') $this->session->set('caseBrowseType', $browseType);
    62.         $moduleID = ($browseType == 'bymodule') ? (int)$param : ($browseType == 'bysearch' ? 0 : ($this->cookie->caseModule ? $this->cookie->caseModule : 0));
    63.         $suiteID  = ($browseType == 'bysuite') ? (int)$param : ($browseType == 'bymodule' ? ($this->cookie->caseSuite ? $this->cookie->caseSuite : 0) : 0);
    64.         $queryID  = ($browseType == 'bysearch') ? (int)$param : 0;
    66.         /* Set menu, save session. */
    67.         $this->testcase->setMenu($this->products, $productID, $branch, $moduleID, $suiteID, $orderBy);
    68.         $this->session->set('caseList', $this->app->getURI(true));
    69.         $this->session->set('productID', $productID);
    70.         $this->session->set('moduleID', $moduleID);
    71.         $this->session->set('browseType', $browseType);
    72.         $this->session->set('orderBy', $orderBy);
    74.         /* Load lang. */
    75.         $this->app->loadLang('testtask');
    77.         /* Load pager. */
    78.         $this->app->loadClass('pager', $static = true);
    79.         $pager = pager::init($recTotal, $recPerPage, $pageID);
    80.         $sort  = $this->loadModel('common')->appendOrder($orderBy);
    82.         /* Get test cases. */
    83.         $cases = $this->testcase->getTestCases($productID, $branch, $browseType, $browseType == 'bysearch' ? $queryID : $suiteID, $moduleID, $sort, $pager);
    85.         /* save session .*/
    86.         $this->loadModel('common')->saveQueryCondition($this->dao->get(), 'testcase', $browseType != 'bysearch' ? false : true);
    88.         /* Process case for check story changed. */
    89.         $cases = $this->loadModel('story')->checkNeedConfirm($cases);
    90.         $cases = $this->testcase->appendData($cases);
    92.         /* Build the search form. */
    93.         $actionURL = $this->createLink('testcase', 'browse', "productID=$productID&branch=$branch&browseType=bySearch&queryID=myQueryID");
    94.         $this->config->testcase->search['onMenuBar'] = 'yes';
    95.         $this->testcase->buildSearchForm($productID, $this->products, $queryID, $actionURL);
    97.         $showModule  = !empty($this->config->datatable->testcaseBrowse->showModule) ? $this->config->datatable->testcaseBrowse->showModule : '';
    98.         $this->view->modulePairs = $showModule ? $this->tree->getModulePairs($productID, 'case', $showModule) : array();
    100.         // FIXME assign 赋值需求列表
    101.         // test -- 调用story 模块下的方法去获取到所有的story列表之后渲染到前端页面
    103.         // todo 核心代码为
    104.         $status = '';
    105.         $limit = 0;
    106.         $type = 'full';
    107.         $hasParent = 1;
    108.         if($moduleID)
    109.         {
    110.             $moduleID = $this->loadModel('tree')->getStoryModule($moduleID);
    111.             $moduleID = $this->tree->getAllChildID($moduleID);
    112.         }
    114.         $storyStatus = '';
    115.         if($status == 'noclosed')
    116.         {
    117.             $storyStatus = $this->lang->story->statusList;
    118.             unset($storyStatus['closed']);
    119.             $storyStatus = array_keys($storyStatus);
    120.         }
    122.       // 观察到下面的代码是取得所有需求列表的关键代码，分析其参数构成，进行初始化调用。 
    123.         $stories = $this->story->getProductStoryPairs($productID, $branch ? "0,$branch" : $branch, $moduleID, $storyStatus, 'id_desc', $limit, $type, 'story', $hasParent);
    125.             // 渲染到前端页面，之后进行测试
    126.         $this->view->storyList        = $stories;
    128.         /* Assign. */
    129.         $tree = $moduleID ? $this->tree->getByID($moduleID) : '';
    130.         $this->view->title         = $this->products[$productID] . $this->lang->colon . $this->lang->testcase->common;
    131.         $this->view->position[]    = html::a($this->createLink('testcase', 'browse', "productID=$productID&branch=$branch"), $this->products[$productID]);
    132.         $this->view->position[]    = $this->lang->testcase->common;
    133.         $this->view->productID     = $productID;
    134.         $this->view->product       = $this->product->getById($productID);
    135.         $this->view->productName   = $this->products[$productID];
    136.         $this->view->modules       = $this->tree->getOptionMenu($productID, $viewType = 'case', $startModuleID = 0, $branch);
    137.         $this->view->moduleTree    = $this->tree->getTreeMenu($productID, $viewType = 'case', $startModuleID = 0, array('treeModel', 'createCaseLink'), '', $branch);
    138.         $this->view->moduleName    = $moduleID ? $tree->name : $this->lang->tree->all;
    139.         $this->view->moduleID      = $moduleID;
    140.         $this->view->summary       = $this->testcase->summary($cases);
    141.         $this->view->pager         = $pager;
    142.         $this->view->users         = $this->user->getPairs('noletter');
    143.         $this->view->orderBy       = $orderBy;
    144.         $this->view->browseType    = $browseType;
    145.         $this->view->param         = $param;
    146.         $this->view->cases         = $cases;
    147.         $this->view->branch        = $branch;
    148.         $this->view->branches      = $this->loadModel('branch')->getPairs($productID);
    149.         $this->view->suiteList     = $this->loadModel('testsuite')->getSuites($productID);
    150.         $this->view->suiteID       = $suiteID;
    151.         $this->view->setModule     = true;
    153.         $this->display();
    154.     }
    158. }