@ibiz-template/runtime 0.1.21 → 0.1.23-alpha.0

package/src/controller/control/kanban/kanban.controller.ts

@@ -0,0 +1,370 @@
+import { RuntimeError, RuntimeModelError } from '@ibiz-template/core';
+import { IDEKanban, IUIActionGroupDetail } from '@ibiz/model-core';
+import { isNil } from 'ramda';
+import {
+  IDragChangeInfo,
+  IKanbanController,
+  IKanbanEvent,
+  IKanbanState,
+  MDCtrlLoadParams,
+} from '../../../interface';
+import { calcDeCodeNameById } from '../../../model';
+import { ControlVO } from '../../../service';
+import { UIActionUtil } from '../../../ui-action';
+import { ButtonContainerState, UIActionButtonState } from '../../utils';
+import { DataViewControlController } from '../data-view';
+import { KanbanService } from './kanban.service';
+
+export class KanbanController
+  extends DataViewControlController<IDEKanban, IKanbanState, IKanbanEvent>
+  implements IKanbanController
+{
+  /**
+   * 数据视图（卡片）部件服务
+   *
+   * @type {KanbanService}
+   * @memberof KanbanController
+   */
+  declare service: KanbanService;
+
+  /**
+   * 允许调整顺序
+   * @author lxm
+   * @date 2023-09-11 04:02:39
+   * @readonly
+   * @type {boolean}
+   */
+  get enableEditOrder(): boolean {
+    return this.model.enableCardEditOrder === true;
+  }
+
+  /**
+   * 是否支持调整分组。
+   * @author lxm
+   * @date 2023-09-11 04:04:00
+   * @readonly
+   * @type {boolean}
+   */
+  get enableEditGroup(): boolean {
+    return this.model.enableCardEditGroup === true;
+  }
+
+  /**
+   * 是否允许新建
+   * @author lxm
+   * @date 2023-09-11 04:05:25
+   * @readonly
+   * @type {boolean}
+   */
+  get enableNew(): boolean {
+    return this.model.enableCardNew === true;
+  }
+
+  protected async initControlService(): Promise<void> {
+    this.service = new KanbanService(this.model);
+    await this.service.init(this.context);
+  }
+
+  protected initState(): void {
+    super.initState();
+    this.state.size = this.model.pagingSize || 1000;
+    this.state.updating = false;
+    // 支持调整顺序和分组时
+    this.state.draggable = this.enableEditOrder || this.enableEditGroup;
+  }
+
+  /**
+   * 初始化
+   *
+   * @protected
+   * @return {*}  {Promise<void>}
+   * @memberof KanbanController
+   */
+  protected async onCreated(): Promise<void> {
+    await super.onCreated();
+    await this.initGroupActionStates();
+  }
+
+  /**
+   * 初始化分组右侧界面行为按钮的状态
+   *
+   * @author chitanda
+   * @date 2023-08-02 17:08:04
+   * @return {*}  {Promise<void>}
+   */
+  async initGroupActionStates(): Promise<void> {
+    const { groupUIActionGroup } = this.model;
+    if (!groupUIActionGroup?.uiactionGroupDetails?.length) {
+      return;
+    }
+    const containerState = new ButtonContainerState();
+    groupUIActionGroup.uiactionGroupDetails.forEach(detail => {
+      const actionid = detail.uiactionId;
+      if (actionid) {
+        const buttonState = new UIActionButtonState(
+          detail.id!,
+          this.context.srfappid!,
+          actionid,
+        );
+        containerState.addState(detail.id!, buttonState);
+      }
+    });
+    await containerState.update();
+    this.state.groupActionGroupState = containerState;
+
+    this.evt.on('onSelectionChange', event => {
+      let data = event.data[0];
+      if (data && data instanceof ControlVO) {
+        data = data.getOrigin();
+      }
+      if (data) {
+        this.state.groupActionGroupState!.update(
+          data,
+          this.model.appDataEntityId!,
+        );
+      }
+    });
+  }
+
+  /**
+   * 本地排序items
+   * @author lxm
+   * @date 2023-09-04 09:30:55
+   * @param {IData[]} items
+   */
+  sortItems(items: IData[]): void {
+    const sortField = this.model.minorSortAppDEFieldId!;
+    const { minorSortDir } = this.model!;
+    if (!sortField) {
+      throw new RuntimeModelError(this.model, '排序属性没配置');
+    }
+    if (!minorSortDir) {
+      throw new RuntimeModelError(this.model, '排序方向没配置');
+    }
+    const isAsc = minorSortDir === 'ASC';
+
+    // 格式化排序属性的值
+    items.forEach(item => {
+      const sortValue = item[sortField];
+      if (isNil(sortValue)) {
+        item[sortField] = 0;
+      } else {
+        const toNum = Number(sortValue);
+        if (Number.isNaN(toNum)) {
+          throw new RuntimeError(
+            `${item.srfmajortext}的排序属性无法转换成数值`,
+          );
+        }
+      }
+    });
+
+    // 排序
+    items.sort((a, b) =>
+      isAsc ? a[sortField] - b[sortField] : b[sortField] - a[sortField],
+    );
+  }
+
+  async afterLoad(args: MDCtrlLoadParams, items: IData[]): Promise<IData[]> {
+    // 每次加载回来先本地排序，把数据的排序属性规范一下
+    this.sortItems(this.state.items);
+    return super.afterLoad(args, items);
+  }
+
+  handleDataGroup(): Promise<void> {
+    if (!this.model.enableGroup || this.model.groupMode === 'NONE') {
+      throw new RuntimeError('看板部件必须开启分组');
+    }
+    return super.handleDataGroup();
+  }
+
+  /**
+   * 拖拽变更事件处理回调
+   * @author lxm
+   * @date 2023-09-11 04:12:58
+   * @param {IDragChangeInfo} info
+   * @return {*}  {Promise<void>}
+   */
+  async onDragChange(info: IDragChangeInfo): Promise<void> {
+    if (!this.enableEditGroup) {
+      if (info.from !== info.to) {
+        ibiz.message.warning('当前看板不允许调整分组！');
+        return;
+      }
+    }
+
+    const isAsc = this.model.minorSortDir === 'ASC';
+    const { from, to, fromIndex, toIndex } = info;
+    const groupField = this.model.groupAppDEFieldId!;
+    const sortField = this.model.minorSortAppDEFieldId!;
+    const modifiedItems: IData[] = [];
+    const fromGroup = this.state.groups.find(x => x.key === from)!;
+    const toGroup = this.state.groups.find(x => x.key === to)!;
+
+    if (!this.enableEditOrder) {
+      if (info.from === info.to) {
+        ibiz.message.warning('当前看板不允许调整次序');
+        return;
+      }
+
+      // 只修改分组不管排序
+      const draggedItem = fromGroup.children[fromIndex];
+      draggedItem[groupField] = info.to; // 变更分组
+      return this.updateChangedItems([draggedItem] as ControlVO[]);
+    }
+
+    /**
+     * 获取下一个100的倍数
+     * @author lxm
+     * @date 2023-09-11 10:03:46
+     * @param {number} num
+     * @return {*}  {number}
+     */
+    const getNextSort = (num: number): number => {
+      return num + (100 - (num % 100));
+    };
+
+    const originArr = [...toGroup.children];
+    const changedArr = [...toGroup.children];
+
+    // 计算出拖拽前和拖拽后的数组
+    const draggedItem = fromGroup.children[fromIndex];
+    if (info.from !== info.to) {
+      draggedItem[groupField] = info.to; // 变更分组
+      changedArr.splice(toIndex, 0, draggedItem);
+    } else {
+      changedArr.splice(fromIndex, 1);
+      changedArr.splice(toIndex, 0, draggedItem);
+    }
+
+    // 前台先改值
+    const removeItems = fromGroup.children.splice(fromIndex, 1);
+    toGroup.children.splice(toIndex, 0, ...removeItems);
+
+    // 降序把数组反转,保证两个数组都是从小到大排
+    if (!isAsc) {
+      originArr.reverse();
+      changedArr.reverse();
+    }
+
+    let lastSort: number;
+    let cacheArr: IData[] = []; // 缓存的不修改数组
+    let cacheLastSort: number; // 缓存不修改数组第一个元素上一个排序值
+    changedArr.forEach((item, index) => {
+      if (lastSort === undefined) {
+        // 第一次出现要调整顺序的，如果不是0用原来位置的排序值，否则使用100
+        if (item !== originArr[index]) {
+          if (!originArr[index]) {
+            // 从别的分组挪进来的且处于末尾时使用上一个元素的排序值的后一个100
+            lastSort =
+              index === 0 ? 100 : getNextSort(originArr[index - 1][sortField]);
+          } else {
+            lastSort = originArr[index][sortField] || 100; // 如果是0的时候给100否则用原来的
+          }
+          item[sortField] = lastSort;
+          modifiedItems.push(item);
+        }
+      } else {
+        // 如果当前排序值比上一个小，提升它的排序值
+        if (lastSort >= item[sortField]) {
+          if (cacheArr.length > 0) {
+            cacheArr.forEach(cache => {
+              cache[sortField] = getNextSort(cacheLastSort);
+              modifiedItems.push(cache);
+              cacheLastSort = cache[sortField];
+            });
+            lastSort = cacheLastSort;
+            cacheLastSort = 0;
+            cacheArr = [];
+          }
+          item[sortField] = getNextSort(lastSort);
+          modifiedItems.push(item);
+        } else {
+          if (cacheArr.length === 0) {
+            cacheLastSort = lastSort;
+          }
+          cacheArr.push(item);
+        }
+        lastSort = item[sortField];
+      }
+    });
+
+    this.updateChangedItems(modifiedItems as ControlVO[]);
+  }
+
+  /**
+   * 批量更新修改的项，并更新后台返回的数据，然后重新计算分组和排序
+   * @author lxm
+   * @date 2023-09-11 04:13:15
+   * @param {ControlVO[]} changedItems
+   * @return {*}  {Promise<void>}
+   */
+  async updateChangedItems(changedItems: ControlVO[]): Promise<void> {
+    try {
+      this.state.updating = true;
+      await Promise.all(
+        changedItems.map(async item => {
+          // 往上下文添加主键
+          const deName = calcDeCodeNameById(this.model.appDataEntityId!);
+          const tempContext = this.context.clone();
+          tempContext[deName] = item.srfkey;
+
+          // 调用接口修改数据
+          const res = await this.service.updateGroup(tempContext, item);
+
+          // 更新完之后更新state里的数据。
+          if (res.data) {
+            const index = this.state.items.findIndex(
+              x => x.srfkey === item.srfkey,
+            );
+            this.state.items.splice(index, 1, res.data);
+          }
+        }),
+      );
+    } finally {
+      this.state.updating = false;
+      await this.afterLoad({}, this.state.items);
+    }
+  }
+
+  /**
+   * 点击新建
+   * @author lxm
+   * @date 2023-09-11 07:22:33
+   * @param {MouseEvent} event
+   * @param {(string | number)} group 分组标识
+   */
+  onClickNew(event: MouseEvent, group: string | number): void {
+    const params = { ...this.params, srfgroup: group };
+    UIActionUtil.execAndResolved('new', {
+      context: this.context,
+      params,
+      data: [],
+      view: this.view,
+      event,
+    });
+  }
+
+  /**
+   * 分组工具栏点击处理回调
+   * @author lxm
+   * @date 2023-09-11 04:48:06
+   * @param {IUIActionGroupDetail} detail
+   * @param {MouseEvent} event
+   * @return {*}  {Promise<void>}
+   */
+  async onGroupToolbarClick(
+    detail: IUIActionGroupDetail,
+    event: MouseEvent,
+    group: string | number,
+  ): Promise<void> {
+    const actionId = detail.uiactionId;
+    const params = { ...this.params, srfgroup: group };
+    await UIActionUtil.execAndResolved(actionId!, {
+      context: this.context,
+      params,
+      data: this.state.selectedData,
+      view: this.view,
+      event,
+    });
+  }
+}

package/src/controller/control/kanban/kanban.service.ts

@@ -0,0 +1,33 @@
+import { IHttpResponse } from '@ibiz-template/core';
+import { IDEKanban } from '@ibiz/model-core';
+import { ControlVO } from '../../../service';
+import { DataViewControlService } from '../data-view';
+
+/**
+ * 看板（kanban）部件服务
+ *
+ * @export
+ * @class DataViewControlService
+ * @extends {MDControlService<IDEDataView>}
+ */
+export class KanbanService extends DataViewControlService<IDEKanban> {
+  /**
+   * 更新分组数据
+   *
+   * @author lxm
+   * @date 2022-09-07 19:09:11
+   * @param {IParams} context 上下文
+   * @param {ControlVO} data 数据
+   * @returns {*}
+   */
+  async updateGroup(
+    context: IParams,
+    data: ControlVO,
+  ): Promise<IHttpResponse<ControlVO>> {
+    const updateAction =
+      this.model.updateGroupControlAction?.appDEMethodId || 'update';
+    let res = await this.exec(updateAction, context, data.getOrigin());
+    res = this.handleResponse(res);
+    return res as IHttpResponse<ControlVO>;
+  }
+}

package/src/controller/control/list/list.controller.ts

@@ -181,6 +181,7 @@ export class ListController
       childrenMap.forEach((value: IData[], key: string) => {
         groups.push({
           caption: key,
+          key,
           children: [...value],
         });
       });
@@ -211,6 +212,7 @@ export class ListController
         );
         groups.push({
           caption: codeListItem.text,
+          key: codeListItem.value,
           children: [...value],
         });
         keys.push(codeListItem.value as string);
@@ -221,6 +223,7 @@ export class ListController
       if (otherGroup.length > 0) {
         groups.push({
           caption: '其他',
+          key: '其他',
           children: [...otherGroup],
         });
       }

package/src/controller/control/list/list.service.ts

@@ -28,6 +28,7 @@ export class ListService extends MDControlService<IDEList> {
         const deFieldKey = deField.toLowerCase();
         mapField = new UIMapField(uiKey, deFieldKey, {
           isOriginField: true,
+          dataType: item.dataType,
         });
       } else {
         // 前台属性

package/src/controller/control/md-ctrl/md-ctrl.service.ts

@@ -29,6 +29,7 @@ export class MDCtrlService extends MDControlService<IDEMobMDCtrl> {
         const deFieldKey = deField.toLowerCase();
         mapField = new UIMapField(uiKey, deFieldKey, {
           isOriginField: true,
+          dataType: item.dataType,
         });
       } else {
         // 前台属性

package/src/controller/control/pickup-view-panel/pickup-view-panel.controller.ts

@@ -1,4 +1,5 @@
 import { IAppDEGridView, IDEPickupViewPanel } from '@ibiz/model-core';
+import { ViewCallTag } from '../../../constant';
 import {
   IPickupViewPanelState,
   IPickupViewPanelEvent,
@@ -119,7 +120,7 @@ export class PickupViewPanelController
    * @memberof PickupViewPanelController
    */
   async getSelectedData(): Promise<IData[]> {
-    const items: IData[] = await this.embedView.call('GetData');
+    const items: IData[] = await this.embedView.call(ViewCallTag.GET_DATA);
     return items;
   }
 
@@ -132,7 +133,7 @@ export class PickupViewPanelController
    * @memberof PickupViewPanelController
    */
   async getAllData(): Promise<IData[]> {
-    const items: IData[] = await this.embedView.call('GetAllData');
+    const items: IData[] = await this.embedView.call(ViewCallTag.GET_ALL_DATA);
     return items;
   }
 }

package/src/controller/control/toolbar/toolbar.controllerr.ts

@@ -5,7 +5,7 @@ import {
   IDETBUIActionItem,
   IControlLogic,
 } from '@ibiz/model-core';
-import { ViewMode } from '../../../constant';
+import { ViewCallTag, ViewMode } from '../../../constant';
 import {
   IToolbarState,
   IToolbarEvent,
@@ -69,7 +69,7 @@ export class ToolbarController<
     // 执行界面行为
     if (item.itemType === 'DEUIACTION') {
       const actionId = (item as IDETBUIActionItem).uiactionId;
-      const res = await this.ctx.view.call('GetData');
+      const res = await this.ctx.view.call(ViewCallTag.GET_DATA);
       const data = res || [];
       const args = this.getEventArgs();
       args.params = Object.assign(param, args.params);

package/src/controller/ctx/ctx.ts

@@ -42,6 +42,15 @@ export class CTX<V extends IViewController = IViewController> {
    */
   view!: V;
 
+  /**
+   * 是否已经销毁
+   *
+   * @author chitanda
+   * @date 2023-09-11 11:09:57
+   * @protected
+   */
+  protected isDestroyed = false;
+
   /**
    * CTX事件
    * @author lxm
@@ -90,6 +99,7 @@ export class CTX<V extends IViewController = IViewController> {
     this.controllersMap.clear();
     this.view = null as any;
     this.state = null as any;
+    this.isDestroyed = true;
   }
 
   /**
@@ -118,6 +128,9 @@ export class CTX<V extends IViewController = IViewController> {
    * @date 2023-03-27 01:59:35
    */
   endLoading(): void {
+    if (this.isDestroyed) {
+      return;
+    }
     this.view.endLoading();
   }
 

package/src/de-logic/utils/handle-src-val.ts

@@ -56,12 +56,14 @@ export function handleSrcVal(
     // 直接值
     case 'SRCVALUE':
       return srcValue;
-    // 视图参数
-    case 'VIEWPARAM':
+    case 'WEBCONTEXT': // 网页请求上下文
+    case 'VIEWPARAM': // 视图参数
       value = ctx.viewParams;
       break;
-    // 应用上下文
-    case 'APPDATA':
+    case 'APPLICATION': // 系统全局对象
+    case 'SESSION': // 用户全局对象
+    case 'APPDATA': // 应用上下文
+    case 'DATACONTEXT': // 数据上下文
       value = ctx.context;
       break;
     // 当前环境参数

package/src/engine/view-base.engine.ts

@@ -1,4 +1,5 @@
 import { RuntimeError } from '@ibiz-template/core';
+import { ViewCallTag } from '../constant';
 import {
   IViewController,
   IToolbarController,
@@ -119,7 +120,7 @@ export class ViewEngineBase implements IViewEngine {
   }
 
   async call(key: string, _args?: IData): Promise<IData | null | undefined> {
-    if (key === 'GetData') {
+    if (key === ViewCallTag.GET_DATA) {
       return this.getData();
     }
     return undefined;

package/src/interface/controller/controller/common/i-drag-change-info.ts

@@ -0,0 +1,40 @@
+/**
+ * 拖拽变更信息
+ * @author lxm
+ * @date 2023-08-30 04:23:41
+ * @export
+ * @interface IDragChangeInfo
+ */
+export interface IDragChangeInfo {
+  /**
+   * 变更前的分组标识
+   * @author lxm
+   * @date 2023-08-30 04:24:25
+   * @type {string}
+   */
+  from: string | number;
+
+  /**
+   * 变更后的分组标识
+   * @author lxm
+   * @date 2023-08-30 04:24:45
+   * @type {string}
+   */
+  to: string | number;
+
+  /**
+   * 变更前的索引位置
+   * @author lxm
+   * @date 2023-08-30 04:25:02
+   * @type {number}
+   */
+  fromIndex: number;
+
+  /**
+   * 变更后的索引位置
+   * @author lxm
+   * @date 2023-08-30 04:24:53
+   * @type {number}
+   */
+  toIndex: number;
+}

package/src/interface/controller/controller/common/index.ts

@@ -1 +1,2 @@
 export * from './i-enforceable.controller';
+export * from './i-drag-change-info';

package/src/interface/controller/controller/control/i-data-view-control.controller.ts

@@ -10,12 +10,11 @@ import { IMDControlController } from './i-md-control.controller';
  * @interface IDataViewControlController
  * @extends {IMDControlController<IDEDataView, IDataViewControlState, IDataViewControlEvent>}
  */
-export interface IDataViewControlController
-  extends IMDControlController<
-    IDEDataView,
-    IDataViewControlState,
-    IDataViewControlEvent
-  > {
+export interface IDataViewControlController<
+  T extends IDEDataView = IDEDataView,
+  S extends IDataViewControlState = IDataViewControlState,
+  E extends IDataViewControlEvent = IDataViewControlEvent,
+> extends IMDControlController<T, S, E> {
   /**
    * 加载更多
    *

package/src/interface/controller/controller/control/i-kanban.controller.ts

@@ -0,0 +1,14 @@
+import { IDEKanban } from '@ibiz/model-core';
+import { IKanbanEvent } from '../../event';
+import { IKanbanState } from '../../state';
+import { IDataViewControlController } from './i-data-view-control.controller';
+
+/**
+ * 看板部件控制器
+ *
+ * @export
+ * @interface IDataViewControlController
+ * @extends {IMDControlController<IDEDataView, IDataViewControlState, IDataViewControlEvent>}
+ */
+export interface IKanbanController
+  extends IDataViewControlController<IDEKanban, IKanbanState, IKanbanEvent> {}

package/src/interface/controller/controller/control/i-panel.controller.ts

@@ -42,4 +42,12 @@ export interface IPanelController<
    * @memberof IPanelController
    */
   load(): Promise<void>;
+
+  /**
+   * 设置面板数据的值
+   *
+   * @param {string} name 要设置的数据的属性名称
+   * @param {unknown} value 要设置的值
+   */
+  setDataValue(name: string, value: unknown): Promise<void>;
 }

package/src/interface/controller/controller/control/index.ts

@@ -30,3 +30,4 @@ export * from './portlet/index';
 export * from './i-calendar.controller';
 export * from './i-calendar-exp-bar.controller';
 export * from './i-context-menu.controller';
+export * from './i-kanban.controller';

package/src/interface/controller/controller/control/panel-item/i-panel-data-container.controller.ts

@@ -18,4 +18,12 @@ export interface IPanelDataContainerController
    * @type {IData}
    */
   data: IData;
+
+  /**
+   * 设置面板数据的值
+   *
+   * @param {string} name 要设置的数据的属性名称
+   * @param {unknown} value 要设置的值
+   */
+  setDataValue?(name: string, value: unknown): Promise<void>;
 }

package/src/interface/controller/event/control/i-kanban.event.ts

@@ -1,11 +1,11 @@
-import { IMDControlEvent } from './i-md-control.event';
+import { IDataViewControlEvent } from './i-data-view-control.event';
 
 /**
- * 看板部件事件
+ * 看板(kanban)部件事件
  *
  * @author lxm
  * @date 2022-08-30 16:08:43
  * @export
  * @interface IMDControlEvent
  */
-export type IKanbanEvent = IMDControlEvent;
+export type IKanbanEvent = IDataViewControlEvent;