Files
EasySoft-ZenTaoPMS/module/transfer/model.php
T

643 lines
24 KiB
PHP

<?php
declare(strict_types=1);
/**
* The control file of transfer module of ZenTaoPMS.
*
* @copyright Copyright 2009-2023 禅道软件(青岛)有限公司(ZenTao Software (Qingdao) Co., Ltd. www.zentao.net)
* @license ZPL(https://zpl.pub/page/zplv12.html) or AGPL(https://www.gnu.org/licenses/agpl-3.0.en.html)
* @author Tang Hucheng <tanghucheng@cnezsoft.com>
* @package transfer
* @link https://www.zentao.net
*/
class transferModel extends model
{
/* 最大导入数量。*/
/* The max import number. */
public $maxImport;
/* Transfer模块的配置。*/
/* Transfer module config. */
public $transferConfig;
/* 导入字段。*/
/* Import fields. */
public $templateFields;
/* 导出字段。*/
/* Export fields. */
public $exportFields;
/* 模块配置。*/
/* Module config. */
public $moduleConfig;
/* 模块语言项。*/
/* Module language. */
public $moduleLang;
/* 模块字段列表。*/
/* Module field list. */
public $moduleFieldList;
/* 模块下拉字段列表。*/
/* Module list fields. */
public $moduleListFields;
/**
* The construc method, to do some auto things.
*
* @access public
* @return void
*/
public function __construct()
{
parent::__construct();
$this->maxImport = isset($_COOKIE['maxImport']) ? $_COOKIE['maxImport'] : 0;
$this->transferConfig = $this->config->transfer;
}
/**
* Transfer 公共方法(格式化模块语言项,Config,字段)。
* Common actions.
*
* @param int $module
* @access public
* @return void
*/
public function commonActions(string $module = '')
{
if($module)
{
$this->loadModel($module);
$this->moduleConfig = $this->config->$module;
$this->moduleLang = $this->lang->$module;
$this->moduleFieldList = $this->config->$module->dtable->fieldList ?? array();
$this->moduleListFields = explode(',', $this->config->$module->listFields ?? '');
}
}
/**
* 生成导出数据
* Export module data.
*
* @param string $module
* @access public
* @return void
*/
public function export(string $module = '')
{
/* 设置PHP最大运行内存和最大执行时间。 */
/* Set PHP max running memory and max execution time. */
ini_set('memory_limit', '-1');
ini_set('max_execution_time','100');
$fields = $this->post->exportFields;
/* Init config fieldList. */
$fieldList = $this->initFieldList($module, $fields);
/* 生成该模块的导出数据。 */
/* Generate export datas. */
$rows = $this->getRows($module, $fieldList);
if($module == 'story')
{
$product = $this->loadModel('product')->getByID((int)$this->session->storyTransferParams['productID']);
if($product and $product->shadow) foreach($rows as $id => $row) $rows[$id]->product = '';
}
/* 设置Excel下拉数据。 */
/* Set Excel dropdown data. */
$list = $this->setListValue($module, $fieldList);
if($list) foreach($list as $listName => $listValue) $this->post->set($listName, $listValue);
/* Get export rows and fields datas. */
$exportDatas = $this->generateExportDatas($fieldList, $rows);
$fields = $exportDatas['fields'];
$rows = !empty($exportDatas['rows']) ? $exportDatas['rows'] : array();
if($this->config->edition != 'open') list($fields, $rows) = $this->loadModel('workflowfield')->appendDataFromFlow($fields, $rows, $module);
$this->post->set('rows', $rows);
$this->post->set('fields', $fields);
$this->post->set('kind', $module);
}
/**
* 将字段格式化成数组。
* Init FieldList.
*
* @param string $module
* @param string $fields
* @param bool $withKey
* @access public
* @return array
*/
public function initFieldList(string $module, string|array $fields, bool $withKey = true)
{
if(!is_array($fields)) $fields = explode(',', $fields);
$this->commonActions($module);
$this->mergeConfig($module);
$this->transferConfig->sysDataList = $this->initSysDataFields();
$transferFieldList = $this->transferConfig->fieldList; //生成一个完整的fieldList结构。
$fieldList = array();
/* build module fieldList. */
foreach($fields as $field)
{
$field = trim($field);
$moduleFieldList = isset($this->moduleFieldList[$field]) ? $this->moduleFieldList[$field] : array();
/* 根据fieldList结构生成每个字段的结构。*/
/* Generate each field structure by fieldList structure. */
foreach($transferFieldList as $transferField => $value)
{
if((!isset($moduleFieldList[$transferField])) or $transferField == 'title')
{
$moduleFieldList[$transferField] = $this->transferConfig->fieldList[$transferField];
if(strpos($this->transferConfig->initFunction, $transferField) !== false) //调用初始化方法
{
$funcName = 'init' . ucfirst($transferField);
$moduleFieldList[$transferField] = $this->$funcName($module, $field);
}
}
}
$moduleFieldList['values'] = $this->initValues($module, $field, $moduleFieldList, $withKey);
$fieldList[$field] = $moduleFieldList;
}
/* 抄送给默认多选。*/
/* Copy to default multiple. */
if(!empty($fieldList['mailto']))
{
$fieldList['mailto']['control'] = 'multiple';
$fieldList['mailto']['values'] = $this->transferConfig->sysDataList['user'];
}
if($this->config->edition != 'open') $fieldList = $this->transferZen->initWorkflowFieldList($module, $fieldList);
return $fieldList;
}
/**
* 初始化导出字段下拉列表的数据。
* Init field values.
*
* @param string $model
* @param string $field
* @param array $object
* @param bool $withKey 是否需要将键值拼接到Value中
* @access public
* @return array
*/
public function initValues(string $model, string $field, array $object, bool $withKey = true)
{
$values = $object['values'];
if(!$object['dataSource']) return $values;
/* 解析dataSource。*/
/* Parse dataSource. */
extract($object['dataSource']); // $module, $method, $params, $pairs, $sql, $lang
/* 如果配置了来源方法,则调用该方法。*/
/* If config the source method, call the method. */
if(!empty($module) && !empty($method))
{
$params = !empty($params) ? $params : '';
$pairs = !empty($pairs) ? $pairs : '';
$values = $this->transferTao->getSourceByModuleMethod($model, $module, $method, $params, $pairs);
}
elseif(!empty($lang))
{
/* 如果配置了语言字段,返回语言数据。*/
/* If config the language field, return language data. */
$values = isset($this->moduleLang->$lang) ? $this->moduleLang->$lang : '';
}
/* 如果配置了系统字段,返回系统数据。*/
/* If empty values put system datas. */
if(empty($values))
{
if(strpos($this->moduleConfig->sysLangFields, $field) !== false && !empty($this->moduleLang->{$field.'List'})) return $this->moduleLang->{$field.'List'};
if(strpos($this->moduleConfig->sysDataFields, $field) !== false && !empty($this->transferConfig->sysDataList[$field])) return $this->transferConfig->sysDataList[$field];
}
if(is_array($values) && $withKey)
{
unset($values['']);
foreach($values as $key => $value) $values[$key] = $value . "(#$key)";
}
return $values;
}
/**
* 初始化名称字段。
* Init Title.
*
* @param string $module
* @param string $field
* @access public
* @return string
*/
public function initTitle(string $module, string $field = ''): string
{
if(!$field) return '';
$this->commonActions($module);
/* 如果存在config->dtable->titles,则使用config->dtable->titles。 */
/* If exists config->dtable->titles, use config->dtable->titles. */
if(!empty($this->moduleConfig->fieldList[$field]['title'])) return $this->moduleLang->{$this->moduleConfig->fieldList[$field]['title']};
/* 如果存在该字段的语言项,则使用该语言项。 */
/* If exists the field's language item, use it. */
if(isset($this->moduleLang->$field)) return $this->moduleLang->$field;
/* 如果存在该字段的语言项别名,则使用该语言项别名。 */
/* If exists the field's language item alias, use it. */
if(isset($this->moduleLang->{$field . 'AB'})) return $this->moduleLang->{$field . 'AB'};
return $field;
}
/**
* 设置字段的控件类型(是否是下拉菜单)。
* Init Control.
*
* @param string $module
* @param string $field
* @access public
* @return void
*/
public function initControl(string $module, string $field)
{
if(isset($this->moduleFieldList[$field]['control'])) return $this->moduleFieldList[$field]['control'];
if(isset($this->moduleLang->{$field.'List'})) return 'select'; //如果存在该字段的语言项列表,则控件为select
if(isset($this->moduleFieldList[$field]['dataSource'])) return 'select'; //如果定义了dataSource,则控件为select
/* 如果Transfer系统字段中存在该字段,则control为下拉。 */
/* If Transfer system field exists the field, control is select. */
if(strpos($this->transferConfig->sysDataFields, $field) !== false) return 'select';
return $this->transferConfig->fieldList['control'];
}
/**
* 设置字段是否必填。
* Init Required.
*
* @param string $module
* @param string $field
* @access public
* @return void
*/
public function initRequired(string $module, string $field)
{
if(!$field) return 'no';
$this->commonActions($module);
/* 检查必填字段中是否存在该字段,如果存在返回yes,否则返回no。 */
/* Check whether the required field contains the field. If yes, return yes. Otherwise, return no. */
if(empty($this->moduleConfig->create->requiredFields)) return 'no';
$requiredFields = "," . $this->moduleConfig->create->requiredFields . ",";
if(strpos($requiredFields, $field) !== false) return 'yes';
return 'no';
}
/**
* 初始化系统数据字段列表(project,execution,product,user)。
* Init system datafields list.
*
* @access public
* @return array
*/
public function initSysDataFields()
{
$this->commonActions();
$dataList = array();
$sysDataFields = explode(',', $this->transferConfig->sysDataFields);
foreach($sysDataFields as $field)
{
/* 调用对应模块getPairs方法获取id => name 关联数据。 */
/* Call getPairs method of corresponding module to get id => name related data. */
$dataList[$field] = $this->loadModel($field)->getPairs();
if(!isset($dataList[$field][0])) $dataList[$field][0] = '';
sort($dataList[$field]);
if($field == 'user')
{
$dataList[$field] = $this->loadModel($field)->getPairs('noclosed|nodeleted|noletter');
unset($dataList[$field]['']);
if(!in_array(strtolower($this->app->methodName), array('ajaxgettbody', 'ajaxgetoptions', 'showimport'))) foreach($dataList[$field] as $key => $value) $dataList[$field][$key] = $value . "(#$key)";
}
}
return $dataList;
}
/**
* 将被操作模块与Transfer模块的配置合并。
* Merge config.
*
* @param string $module
* @access public
* @return void
*/
public function mergeConfig(string $module)
{
$this->commonActions($module);
$transferConfig = $this->transferConfig;
$moduleConfig = $this->moduleConfig;
if(!isset($moduleConfig->export)) $moduleConfig->export = new stdClass();
if(!isset($moduleConfig->import)) $moduleConfig->export = new stdClass();
$this->moduleConfig->dateFields = isset($moduleConfig->dateFields) ? $moduleConfig->dateFields : $transferConfig->dateFields;
$this->moduleConfig->listFields = isset($moduleConfig->listFields) ? $moduleConfig->listFields : $transferConfig->listFields;
$this->moduleConfig->sysLangFields = isset($moduleConfig->sysLangFields) ? $moduleConfig->sysLangFields : $transferConfig->sysLangFields;
$this->moduleConfig->sysDataFields = isset($moduleConfig->sysDataFields) ? $moduleConfig->sysDataFields : $transferConfig->sysDataFields;
$this->moduleConfig->datetimeFields = isset($moduleConfig->datetimeFields) ? $moduleConfig->datetimeFields : $transferConfig->datetimeFields;
}
/**
* 生成导出数据。
* Generate export datas.
*
* @param array $fieldList
* @param array $rows
* @access public
* @return array
*/
public function generateExportDatas(array $fieldList, array $rows = array())
{
$exportDatas = array();
$dataSourceList = array();
foreach($fieldList as $key => $field)
{
$exportDatas['fields'][$key] = $field['title'];
if($field['values'])
{
$exportDatas[$key] = $field['values'];
$dataSourceList[] = $key;
}
}
if(empty($rows)) return $exportDatas;
$exportDatas['user'] = $this->loadModel('user')->getPairs('noclosed|nodeleted|noletter');
foreach($rows as $id => $row)
{
foreach($row as $field => $value)
{
if(isset($fieldList[$field]['from']) and $fieldList[$field]['from'] == 'workflow') continue;
if(in_array($field, $dataSourceList))
{
/* 处理下拉框数据。*/
/* Deal dropdown values. */
if($fieldList[$field]['control'] == 'select') $rows[$id]->$field = isset($exportDatas[$field][$value]) ? $exportDatas[$field][$value] : $value; // 单选下拉
if($fieldList[$field]['control'] == 'multiple') // 多选下拉
{
$separator = $field == 'mailto' ? ',' : "\n";
$multipleLsit = explode(',', (string) $value);
foreach($multipleLsit as $key => $tmpValue) $multipleLsit[$key] = zget($exportDatas[$field], $tmpValue);
$multiple = implode($separator, $multipleLsit);
$rows[$id]->$field = $multiple;
}
}
elseif(strpos($this->config->transfer->userFields, $field) !== false)
{
/* 处理用户字段。*/
/* if user deleted when export set userFields is itself. */
$rows[$id]->$field = zget($exportDatas['user'], $value);
}
/* 处理为空字段的情况。*/
/* if value = 0 or value = 0000:00:00 set value = ''. */
if(is_string($value) and ($value == '0' or substr($value, 0, 4) == '0000')) $rows[$id]->$field = '';
}
}
$exportDatas['rows'] = array_values($rows);
return $exportDatas;
}
/**
* 获取当前选中数据的所有附件。
* Get related files.
*
* @param string $module
* @param array $rows
* @access public
* @return array
*/
public function getFiles(string $module, array $rows)
{
if(empty($rows)) return array();
/* 获取附件分组。*/
/* Get file groups. */
$fileGroups = $this->transferTao->getFileGroups($module, array_keys($rows));
if(empty($fileGroups)) return $rows;
/* 将附件追加到数组中并设置下载链接。*/
/* Set related files. */
foreach($rows as $row)
{
$row->files = '';
if(!isset($fileGroups[$row->id])) continue;
foreach($fileGroups[$row->id] as $file)
{
/* 设置下载链接。*/
/* Set download link. */
$fileURL = common::getSysURL() . helper::createLink('file', 'download', "fileID={$file->id}");
$row->files .= html::a($fileURL, $file->title, '_blank') . '<br />';
}
}
return $rows;
}
/**
* 设置下拉字段数据。
* Set list value.
*
* @param string $module
* @param array $fieldList
* @access public
* @return array
*/
public function setListValue(string $module, array $fieldList)
{
$lists = array();
if(!empty($this->moduleListFields))
{
$listFields = $this->moduleListFields;
/* 从fieldList和sysLangFields中为下拉字段赋值。*/
/* Set value from fieldList and sysLangFields. */
foreach($listFields as $field)
{
if(empty($field)) continue;
$listName = $field . 'List'; // 下拉字段以字段名 + List命名。
if(!empty($_POST[$listName])) continue;
$lists[$listName] = array();
if(!empty($fieldList[$field]))
{
$lists[$listName] = $fieldList[$field]['values'];
/* 从语言项里赋值。*/
/* Set value from lang. */
if(strpos($this->moduleConfig->sysLangFields, $field)) $lists[$listName] = implode(',', $fieldList[$field]['values']);
}
/* 将下拉字段赋值给excel->sysDataField。*/
/* Set value to excel->sysDataField. */
if(isset($this->config->excel->sysDataField) && is_array($lists[$listName])) $this->config->excel->sysDataField[] = $field;
}
$lists['listStyle'] = $listFields;
}
/* 如果有级联字段,则加入级联字段列表(如用例的模块和相关需求)。*/
/* If has cascade field, add cascade field list. */
if(!empty($this->moduleConfig->cascade))
{
$lists = $this->transferTao->getCascadeList($module, $lists);
$lists['cascade'] = $this->moduleConfig->cascade;
}
return $lists;
}
/**
* 获取导出数据。
* Get Rows.
*
* @param string $module
* @param object|array $fieldList
* @access public
* @return array
*/
public function getRows(string $module, object|array $fieldList)
{
$moduleDatas = $this->getQueryDatas($module); // 根据SESSION中的条件查询数据。
if(is_object($fieldList)) $fieldList = (array) $fieldList;
if(isset($fieldList['files'])) $moduleDatas = $this->getFiles($module, $moduleDatas); // 如果有附件字段则获取附件。
/* 如果存在rows则用rows中的数据覆盖查询的数据。*/
/* If has rows, use rows data to cover query data. */
$rows = !empty($_POST['rows']) ? $_POST['rows'] : array();
foreach($rows as $id => $row) $moduleDatas[$id] = (object) array_merge((array)$moduleDatas[$id], (array)$row);
/* 设置子数据。*/
/* Deal children datas and multiple tasks. */
if($moduleDatas) $moduleDatas = $this->transferTao->updateChildDatas($moduleDatas);
/* 设置导出用户需求相关相关研发需求数据。*/
/* Deal linkStories datas. */
if($moduleDatas and isset($fieldList['linkStories'])) $moduleDatas = $this->transferTao->processLinkStories($moduleDatas);
return $moduleDatas;
}
/**
* 获取查询数据。
* Get query datas.
*
* @param string $module
* @access public
* @return array
*/
public function getQueryDatas(string $module = '')
{
$moduleDatas = array();
$checkedItem = $this->post->checkedItem ? $this->post->checkedItem : $this->cookie->checkedItem;
$onlyCondition = $this->session->{$module . 'OnlyCondition'};
$queryCondition = $this->session->{$module . 'QueryCondition'};
/* 插入用例场景数据。*/
/* Fetch the scene's cases. */
if($module == 'testcase') $queryCondition = preg_replace("/AND\s+t[0-9]\.scene\s+=\s+'0'/i", '', $queryCondition);
/* 根据SESSION中的条件查询数据。*/
/* Fetch datas by session condition. */
if($onlyCondition && $queryCondition)
{
if($module == 'story') $queryCondition = str_replace('story', 'id', $queryCondition);
$table = zget($this->config->objectTables, $module); //获取对应的表
$moduleDatas = $this->dao->select('*')->from($table)->alias('t1')
->where($queryCondition)
->beginIF($this->post->exportType == 'selected')->andWhere('t1.id')->in($checkedItem)->fi()
->fetchAll('id');
}
elseif($queryCondition)
{
$selectKey = 'id';
if($module == 'testcase') $module = 'case';
/* 字段前加入表别名。*/
/* Add table alias to field. */
preg_match_all('/[`"]' . $this->config->db->prefix . $module .'[`"] AS ([\w]+) /', $queryCondition, $matches);
if(isset($matches[1][0])) $selectKey = "{$matches[1][0]}.id";
$stmt = $this->dbh->query($queryCondition . ($this->post->exportType == 'selected' ? " AND $selectKey IN(" . ($checkedItem ? $checkedItem : '0') . ")" : ''));
while($row = $stmt->fetch())
{
if($selectKey !== 't1.id' and isset($row->$module) and isset($row->id)) $row->id = $row->$module;
$moduleDatas[$row->id] = $row;
}
}
return $moduleDatas;
}
/**
* 处理Excel表中下拉框数据。
* Deal excel dropdown values.
*
* @param string $module 模块
* @param array $rows Excel数据行
* @param string $filter
* @param array $fields
* @access public
* @return array
*/
public function parseExcelDropdownValues(string $module, array $rows, string $filter = '', array $fields = array())
{
$this->commonActions($module);
$fieldList = $this->initFieldList($module, array_keys($fields), false);
foreach($rows as $key => $data)
{
/* 每行的数据。*/
/* Row data. */
foreach($data as $field => $cellValue)
{
if(empty($cellValue) || is_array($cellValue)) continue;
if(strpos($this->transferConfig->dateFields, $field) !== false and helper::isZeroDate($cellValue)) $rows[$key]->$field = ''; // 如果是日期,并且为 0000-00-00,则转换为空
if(strpos($this->moduleConfig->dateFields, $field) !== false or strpos($this->moduleConfig->datetimeFields, $field) !== false) $rows[$key]->$field = $this->loadModel('common')->formatDate($cellValue); // 如果是时间类型字段,则转换为时间
/* 获取字段的控件类型。*/
/* Get field control type. */
$control = isset($fieldList[$field]['control']) ? $fieldList[$field]['control'] : '';
/* 如果字段是下拉字段并且在excel里不是下拉框的形式时,根据fieldList->value查找value。*/
/* If the field is a dropdown field and the value in excel is not a dropdown box, the value is found by fieldList->value. */
if(!in_array($control, array('select', 'multiple'))) continue;
$rows[$key]->$field = $this->transferTao->extractElements((string) $cellValue, $field, $fieldList[$field]['values']);
}
}
return $rows;
}
}