@ibiz-template/runtime 0.0.1-beta.1 → 0.0.1-beta.17

package/src/controller/utils/counter/counter.ts

@@ -0,0 +1,95 @@
+import { RuntimeError } from '@ibiz-template/core';
+
+/**
+ * 计数器对象，
+ *
+ * @author lxm
+ * @date 2022-09-19 11:09:36
+ * @export
+ * @class Counter
+ */
+export class Counter {
+  /**
+   * 计数
+   *
+   * @author lxm
+   * @date 2022-09-19 11:09:30
+   * @type {number}
+   */
+  count: number = 0;
+
+  /**
+   * 计数器状态
+   * 调用过一次回调后就会变为使用过的状态，任何操作都不会执行
+   *
+   * @author lxm
+   * @date 2022-09-21 19:09:21
+   * @private
+   * @type {('Unused' | 'Used')}
+   */
+  private state: 'Unused' | 'Used' = 'Unused';
+
+  /**
+   * 是否可以重复使用
+   *
+   * @author lxm
+   * @date 2022-09-21 19:09:22
+   * @protected
+   * @type {boolean}
+   */
+  protected reusable: boolean = true;
+
+  /**
+   * Creates an instance of Counter.
+   * @author lxm
+   * @date 2022-09-19 11:09:57
+   * @param {() => void} callback 回调函数，在计数归零的时候被调用
+   */
+  constructor(private callback: () => void) {}
+
+  /**
+   * 增加计数，返回增加后的计数
+   *
+   * @author lxm
+   * @date 2022-08-18 21:08:22
+   */
+  increment(): number {
+    if (this.state === 'Used') {
+      return this.count;
+    }
+    this.count += 1;
+    return this.count;
+  }
+
+  /**
+   * 减少计数，当计数为0时触发回调
+   *
+   * @author lxm
+   * @date 2022-08-18 21:08:22
+   */
+  decrement(): void {
+    if (this.state === 'Used') {
+      return;
+    }
+    if (this.count === 0) {
+      throw new RuntimeError('错误的调用！decrement不能对count为0调用');
+    }
+    this.count -= 1;
+    if (this.count === 0) {
+      this.callback();
+      if (!this.reusable) {
+        this.state = 'Used';
+      }
+    }
+  }
+
+  /**
+   * 销毁方法，解除关联
+   *
+   * @author lxm
+   * @date 2022-09-19 11:09:27
+   */
+  destroy() {
+    this.callback = undefined as never;
+  }
+}

package/src/controller/utils/de-ac-mode/de-ac-mode-util.ts

@@ -0,0 +1,48 @@
+import { DEACModeModel } from '@ibiz-template/model';
+
+/**
+ * 自填模式工具类
+ *
+ * @author lxm
+ * @date 2022-10-24 15:10:52
+ * @export
+ * @class DEACModeUtil
+ */
+export class DEACModeUtil {
+  /**
+   * 计算回填数据集合
+   *
+   * @author lxm
+   * @date 2022-10-24 15:10:00
+   * @static
+   * @param {IData} data 选中数据
+   * @param {DEACModeModel} deACMode 自填模式
+   * @returns {*}  {Promise<Array<{ name: string; value: any }>>}
+   */
+  static async calcFillDataItems(
+    data: IData,
+    deACMode: DEACModeModel,
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  ): Promise<Array<{ name: string; value: any }>> {
+    const { dataItems } = deACMode;
+    if (!dataItems.length) {
+      return [];
+    }
+    const result = await Promise.all(
+      dataItems.map(item => {
+        const value = data[item.getPSAppDEField()!.codeName.toLowerCase()];
+
+        if (item.format) {
+          // todo 值格式化
+        } else if (item.convertToCodeItemText && item.getPSCodeList()) {
+          // todo 代码表转换为文本值
+        } else if (item.customCode) {
+          // todo 脚本代码
+        }
+
+        return { name: item.name, value };
+      }),
+    );
+    return result;
+  }
+}

package/src/controller/utils/index.ts

@@ -0,0 +1,6 @@
+export * from './counter/counter';
+export * from './loading/loading-state';
+export * from './value-rule/value-rule';
+export * from './button-state';
+export * from './de-ac-mode/de-ac-mode-util';
+export * from './code-list/code-list';

package/src/controller/utils/loading/loading-state.ts

@@ -0,0 +1,57 @@
+import { Counter } from '../counter/counter';
+
+/**
+ * loading状态控制类
+ *
+ * @author lxm
+ * @date 2022-09-19 11:09:35
+ * @export
+ * @class LoadingState
+ */
+export class LoadingState {
+  private $isLoading: boolean = false;
+
+  /**
+   * 当前的loading状态，多次loading叠加时，只有所有loading都结束才会变回false。
+   *
+   * @author lxm
+   * @date 2022-09-19 11:09:43
+   * @readonly
+   * @type {boolean}
+   */
+  get isLoading(): boolean {
+    return this.$isLoading;
+  }
+
+  /**
+   * loading计数器
+   *
+   * @author lxm
+   * @date 2022-09-19 11:09:08
+   * @private
+   */
+  private counter = new Counter(() => {
+    this.$isLoading = false;
+  });
+
+  /**
+   * 开始loading
+   *
+   * @author lxm
+   * @date 2022-09-19 11:09:55
+   */
+  begin() {
+    this.$isLoading = true;
+    this.counter.increment();
+  }
+
+  /**
+   * 结束loading
+   *
+   * @author lxm
+   * @date 2022-09-19 11:09:34
+   */
+  end() {
+    this.counter.decrement();
+  }
+}

package/src/controller/utils/value-rule/value-rule.ts

@@ -0,0 +1,90 @@
+/* eslint-disable @typescript-eslint/no-unused-vars */
+import { IPSDEFormItemVR, IPSDEGridEditItemVR } from '@ibiz-template/model';
+import { isNilOrEmpty } from 'qx-util';
+import { IBizVerify } from '../../../service';
+
+/**
+ * 生成值规则
+ *
+ * @author lxm
+ * @date 2022-09-02 09:09:02
+ * @export
+ * @param {IPSDEFormItemVR[]} itemVRs 项值规则集合
+ * @param {string} name 值属性名称
+ * @param {string} valueItemName 值项名称
+ * @returns {*}  {IData[]}
+ */
+export function generateRules(
+  itemVRs: IPSDEFormItemVR[] | IPSDEGridEditItemVR[],
+  name: string,
+  valueItemName: string,
+): IData[] {
+  const rules: IData[] = [];
+  itemVRs.forEach(item => {
+    const { valueRuleType } = item;
+    const sysRule = item.getPSSysValueRule();
+    const deRule = item.getPSDEFValueRule();
+    // 系统值规则
+    if (valueRuleType === 'SYSVALUERULE' && sysRule) {
+      // 正则值规则
+      if (sysRule.ruleType === 'REG') {
+        rules.push({
+          pattern: new RegExp(sysRule.regExCode),
+          message: sysRule.ruleInfo,
+          trigger: 'change blur',
+        });
+        // 脚本值规则
+      } else if (sysRule.ruleType === 'SCRIPT') {
+        rules.push({
+          validator: (
+            rule: IData,
+            value: IData,
+            callback: () => boolean,
+            source: IData,
+          ) => {
+            // 空值时不校验
+            if (!value) {
+              return true;
+            }
+            try {
+              // eslint-disable-next-line no-eval
+              eval(sysRule.scriptCode);
+            } catch (error) {
+              console.error(error);
+            }
+            return true;
+          },
+          trigger: 'change blur',
+        });
+      }
+      // 属性值规则
+    } else if (valueRuleType === 'DEFVALUERULE' && deRule) {
+      // 有值项的情况，校验值项的值
+      const valueName = valueItemName || name;
+      rules.push({
+        validator: (
+          rule: IData,
+          value: IData,
+          callback: (params: Error[] | Error) => boolean,
+          source: IData,
+        ) => {
+          // 空值时不校验
+          if (isNilOrEmpty(source[valueName])) {
+            return true;
+          }
+          const { isPast, infoMessage } = IBizVerify.verifyDeRules(
+            valueName,
+            source,
+            deRule.getPSDEFVRGroupCondition(),
+          );
+          if (!isPast) {
+            callback(new Error(infoMessage || deRule.ruleInfo));
+          }
+          return true;
+        },
+        trigger: 'change blur',
+      });
+    }
+  });
+  return rules;
+}

package/src/controller/view/app-portal-view.ts

@@ -0,0 +1,33 @@
+import { AppPortalViewModel } from '@ibiz-template/model';
+import { AppPortalViewNerve } from '../neuron';
+import { ViewController } from './view';
+
+/**
+ * 应用看板视图控制器
+ *
+ * @author lxm
+ * @date 2022-09-08 16:09:49
+ * @export
+ * @class AppPortalViewController
+ * @extends {ViewController}
+ */
+export class AppPortalViewController<
+  T extends AppPortalViewModel = AppPortalViewModel,
+> extends ViewController<T> {
+  declare nerve: AppPortalViewNerve;
+
+  protected createNerve(): AppPortalViewNerve {
+    return new AppPortalViewNerve(this);
+  }
+
+  protected async onInit(): Promise<void> {
+    await super.onInit();
+    // 数据看板适配器
+    const { dashboard } = this.model;
+    if (dashboard) {
+      this.providers[dashboard.name] = await ibiz.register.control.get(
+        dashboard,
+      );
+    }
+  }
+}

package/src/controller/view/edit-view.ts

@@ -0,0 +1,278 @@
+import { IBizContext, RuntimeError } from '@ibiz-template/core';
+import { EditViewModel } from '@ibiz-template/model';
+import { OpenAppViewCommand } from '../../command';
+import { ViewMode } from '../../constant';
+import { IModalData } from '../../interface';
+import { EntityService } from '../../service';
+
+import { EditViewNerve } from '../neuron';
+import { ViewController } from './view';
+
+/**
+ * 编辑视图控制器
+ *
+ * @author chitanda
+ * @date 2022-08-01 21:08:31
+ * @export
+ * @class EditViewController
+ * @extends {ViewController}
+ */
+export class EditViewController<
+  T extends EditViewModel = EditViewModel,
+> extends ViewController<T> {
+  /**
+   * 实体服务
+   *
+   * @author lxm
+   * @date 2022-09-29 15:09:46
+   * @protected
+   * @type {EntityService}
+   */
+  protected entityService!: EntityService;
+
+  declare nerve: EditViewNerve;
+
+  protected createNerve(): EditViewNerve {
+    return new EditViewNerve(this);
+  }
+
+  protected async onInit(): Promise<void> {
+    await super.onInit();
+    this.entityService = await ibiz.entityService.getService(
+      this.model.appEntity.codeName,
+      this.context,
+    );
+    this.nerve.self.evt.on('mounted', () => {
+      if (this.modal.mode !== ViewMode.EMBED && this.model.source.loadDefault) {
+        this.load();
+      }
+    });
+    // 编辑表单适配器
+    const { form } = this.model;
+    if (form) {
+      this.providers[form.name] = await ibiz.register.control.get(form);
+    }
+  }
+
+  protected handleViewParams(): void {
+    // 编辑视图识别上下文的srfkey并转成实体名称，然后删除srfkey
+    if (this.context.srfkey) {
+      this.context[this.model.appEntity.deName] = this.context.srfkey;
+      this.context.srfkey = undefined; // 避免delete不掉，先置空
+      delete this.context.srfkey;
+    }
+    return super.handleViewParams();
+  }
+
+  getData(): IData[] {
+    const formData = this.nerve.form.call.getData();
+    return formData;
+  }
+
+  /**
+   * 编辑视图加载方法
+   *
+   * @author lxm
+   * @date 2022-08-30 19:08:36
+   */
+  async load(): Promise<IData> {
+    const { form } = this.nerve;
+    const data = await form.call.load();
+    this.calcCaption(data);
+    if (this.toolbarState) {
+      this.toolbarState.update(data.getOrigin());
+    }
+    return data;
+  }
+
+  /**
+   * 保存数据
+   *
+   * @author lxm
+   * @date 2022-08-31 22:08:01
+   */
+  async save(): Promise<IData> {
+    const { form } = this.nerve;
+    const data = await form.call.save();
+    return data;
+  }
+
+  /**
+   * 保存结束后处理（不论是否是视图触发的表单保存）
+   *
+   * @author lxm
+   * @date 2022-10-10 16:10:03
+   * @param {boolean} isNewData 是否是新建
+   * @param {IData} data 保存后返回的数据
+   * @returns {*}  {Promise<void>}
+   */
+  async onAfterFormSave(isNewData: boolean, data: IData): Promise<void> {
+    // 新建保存，更新上下文
+    if (isNewData) {
+      const { deName } = this.model.appEntity;
+      this.context[deName] = data[deName];
+    }
+    this.calcCaption(data);
+    this.nerve.self.evt.asyncEmit('viewDataChange', {
+      type: isNewData ? 'CREATE' : 'UPDATE',
+      data: [data],
+      control: 'form',
+    });
+  }
+
+  /**
+   * 表单删除后事件的处理
+   *
+   * @author lxm
+   * @date 2022-11-15 18:11:14
+   * @param {IData} data
+   * @returns {*}  {Promise<void>}
+   */
+  async onAfterFormRemove(data: IData): Promise<void> {
+    this.nerve.self.evt.asyncEmit('viewDataChange', {
+      type: 'REMOVE',
+      data: [data],
+      control: 'form',
+    });
+  }
+
+  /**
+   * 保存数据
+   *
+   * @author lxm
+   * @date 2022-08-31 22:08:01
+   */
+  async saveAndNew() {
+    await this.save();
+    // 新建即删除主键并加载
+    this.context[this.model.appEntity.deName] = undefined;
+    await this.load();
+  }
+
+  /**
+   * 保存数据
+   *
+   * @author lxm
+   * @date 2022-08-31 22:08:01
+   */
+  async remove() {
+    const { form } = this.nerve;
+    await form.call.remove();
+  }
+
+  async refresh() {
+    const data = await this.load();
+    this.nerve.self.evt.asyncEmit('refreshed', [data]);
+  }
+
+  /**
+   * 工作流启动
+   *
+   * @author lxm
+   * @date 2022-09-29 20:09:27
+   * @returns {*}  {Promise<void>}
+   */
+  async wfStart(): Promise<void> {
+    // 先保存
+    await this.save();
+
+    // *获取工作流版本信息
+    const res = await this.entityService.wf.getWFVersion();
+    if (res.data.length === 0) {
+      throw new RuntimeError('当前工作流版本不存在');
+    }
+    // todo 多个的情况要出一个确认框选择后走后续逻辑
+
+    const wfInfo = res.data[0];
+    const refKey = `WFSTART@${wfInfo.wfversion}`;
+
+    // 处理视图上下文
+    const newContext = new IBizContext(
+      {
+        activeForm: wfInfo['process-form'],
+      },
+      this.context,
+    );
+    // 处理视图参数
+    const newParams = {
+      processDefinitionKey: wfInfo.definitionkey,
+    };
+
+    // 查找工作流启动视图
+    const startView = this.model.source
+      .findPSAppViewRef(refKey)
+      ?.getRefPSAppView();
+
+    // *没有工作流启动视图的，自己启动工作流
+    if (!startView) {
+      await this.nerve.form.call.wfStart(newParams);
+      await this.closeView();
+      return;
+    }
+
+    // *有工作流启动视图的，由启动视图执行工作流启动
+    const result: IModalData = await ibiz.commands.execute(
+      OpenAppViewCommand.TAG,
+      startView,
+      newContext,
+      newParams,
+    );
+
+    // 启动视图正常关闭后关闭当前视图
+    if (result.ok) {
+      await this.closeView();
+    }
+  }
+
+  /**
+   * 工作流提交
+   *
+   * @author lxm
+   * @date 2022-09-29 20:09:27
+   * @returns {*}  {Promise<void>}
+   */
+  wfSubmit(): Promise<void> {
+    return this.nerve.form.call.wfSubmit();
+  }
+
+  /**
+   * 工作流提交
+   *
+   * @author lxm
+   * @date 2022-09-29 20:09:27
+   * @returns {*}  {Promise<void>}
+   */
+  async wfWithdraw(
+    context: IContext,
+    params: IParams,
+    data: IData,
+  ): Promise<void> {
+    await this.entityService.wf.wfWithdraw(
+      context,
+      { ...params, taskId: params.taskId || params.srftaskid },
+      {
+        ...data.getRequestData(),
+      },
+    );
+  }
+
+  /**
+   * 设置视图标题
+   *
+   * @author lxm
+   * @date 2022-08-31 16:08:49
+   * @param {string} caption
+   */
+  calcCaption(data: IData): void {
+    // 全局关闭信息栏或者全局开启信息栏但是视图不显示信息栏时，不设置信息栏标题
+    if (!ibiz.config.enableDataInfoBar || !this.model.source.showDataInfoBar) {
+      return;
+    }
+    const majorText = data[this.model.appEntity.textName];
+    if (majorText) {
+      this.setCaption(`${this.model.caption} - ${majorText}`);
+    } else if (!this.context[this.model.appEntity.deName]) {
+      this.setCaption(`${this.model.caption} - 新建`);
+    }
+  }
+}