neo-cmp-cli 1.13.16 → 1.13.18

package/template/neo-bi-cmps/src/utils/filter2chartFilter.ts

@@ -0,0 +1,268 @@
+/**
+ * 过滤条件格式化
+ * 将筛选栏组件得到的过滤条件格式化为接口需要的格式。
+ * 
+ * 数据转换规则：
+1. closeDate
+
+非 custom：用 toFiniteNumber 把选项值（如 201 / "201"）转成数字，timeType: 'relative'，value: [{ val, baseType: 'system' }]。
+custom：读取 closeDateCustomRange.start / end，二者均为有效数字时，timeType: 'absolute'，value 为两条 { val, close: 1 }；缺区间则不生成该项。
+
+2. opportunityOwner → ownerId
+支持单值（字符串/数字）或多选数组；逐项 toFiniteNumber，无效项丢弃。至少一个有效 id 时生成 refer 条件（referKey: 'user'、optionType: 'user'、operate: 'in'、includeNullValue: 0）。
+value 为数组，每个用户为 { val, sub: false, source: 'internal', specialType: 0 }。
+
+3. businessType → entityType
+有值且能转成数字时，生成 refer + value: [{ val }]；空字符串不传 entityType。
+
+4. relation
+按最终条目的 seq 拼成 "1 and 2 and 3"；没有任何条件时为 ''，filter 为 []。
+
+ * 
+ * 例如：
+ * 筛选栏组件得到的过滤条件：
+{
+    "closeDate": "custom",
+    "closeDateCustomRange": {
+        "start": 1775577600000,
+        "end": 1777996799999
+    },
+    "opportunityOwner": ["1255807", 2088134315786370],
+    "businessType": "8150459",
+    "changesSince": "Custom",
+    "changesSinceCustomTime": 1776268800000
+}
+
+接口需要的格式：
+{
+    "relation": "1 and 2 and 3",
+    "filter": [
+      {
+        "seq": 1,
+        "fieldKey": "closeDate",
+        "modelKey": "opportunity",
+        "serialNo": 1,
+        "type": "date",
+        "entityOnlyFilter": 0,
+        "timeType": "relative",
+        "operate": "eq",
+        "value": [
+          {
+            "val": 101,
+            "baseType": "system"
+          }
+        ]
+      },
+      {
+        "seq": 2,
+        "fieldKey": "ownerId",
+        "modelKey": "opportunity",
+        "serialNo": 1,
+        "type": "refer",
+        "referKey": "user",
+        "optionType": "user",
+        "entityOnlyFilter": 0,
+        "operate": "in",
+        "value": [
+          {
+            "val": 1255807,
+            "sub": false,
+            "source": "internal",
+            "specialType": 0
+          },
+          {
+            "val": 2088134315786370,
+            "sub": false,
+            "source": "internal",
+            "specialType": 0
+          }
+        ],
+        "includeNullValue": 0
+      },
+      {
+        "seq": 3,
+        "fieldKey": "entityType",
+        "modelKey": "opportunity",
+        "serialNo": 1,
+        "type": "refer",
+        "entityOnlyFilter": 0,
+        "operate": "in",
+        "value": [
+          {
+            "val": 8150459
+          }
+        ]
+      }
+    ]
+  }
+
+  如果是 closeDate 为 custom，则需要将 closeDateCustomRange 格式化为接口需要的格式
+  {
+        "seq": 3,
+        "fieldKey": "closeDate",
+        "modelKey": "opportunity",
+        "serialNo": 1,
+        "type": "date",
+        "entityOnlyFilter": 0,
+        "timeType": "absolute",
+        "operate": "eq",
+        "value": [
+            {
+              "val": 1777305600000,
+              "close": 1
+            },
+            {
+              "val": 1780156799999,
+              "close": 1
+            }
+          ]
+      }
+*/
+
+import { toFiniteNumber } from './common';
+
+const MODEL_KEY = 'opportunity';
+const SERIAL_NO = 1;
+
+type ChartFilterItem = {
+  seq: number;
+  fieldKey: string;
+  modelKey: string;
+  serialNo: number;
+  type: string;
+  entityOnlyFilter: number;
+  operate: string;
+  value: unknown[];
+  timeType?: string;
+  referKey?: string;
+  optionType?: string;
+  includeNullValue?: number;
+};
+
+export interface ChartFilterPayload {
+  relation: string;
+  filter: ChartFilterItem[];
+}
+
+function closeDateChunk(
+  filter: Record<string, unknown>,
+): Omit<ChartFilterItem, 'seq'> | null {
+  const raw = filter.closeDate;
+  const isCustom = String(raw ?? '').toLowerCase() === 'custom';
+
+  if (isCustom) {
+    const range = filter.closeDateCustomRange as
+      | { start?: unknown; end?: unknown }
+      | undefined;
+    const start = toFiniteNumber(range?.start);
+    const end = toFiniteNumber(range?.end);
+    if (start == null || end == null) return null;
+    return {
+      modelKey: MODEL_KEY,
+      serialNo: SERIAL_NO,
+      fieldKey: 'closeDate',
+      type: 'date',
+      entityOnlyFilter: 0,
+      timeType: 'absolute',
+      operate: 'eq',
+      value: [
+        { val: start, close: 1 },
+        { val: end, close: 1 },
+      ],
+    };
+  }
+
+  const n = toFiniteNumber(raw);
+  if (n == null) return null;
+  return {
+    modelKey: MODEL_KEY,
+    serialNo: SERIAL_NO,
+    fieldKey: 'closeDate',
+    type: 'date',
+    entityOnlyFilter: 0,
+    timeType: 'relative',
+    operate: 'eq',
+    value: [{ val: n, baseType: 'system' }],
+  };
+}
+
+const ownerUserValueItem = (val: number) => ({
+  val,
+  sub: false as const,
+  source: 'internal' as const,
+  specialType: 0,
+});
+
+/** 从 opportunityOwner（单值或 id 数组）解析出有效的用户 id 列表 */
+function normalizeOwnerIds(owner: unknown): number[] {
+  if (owner == null || owner === '') return [];
+  const raw = Array.isArray(owner) ? owner : [owner];
+  const out: number[] = [];
+  for (const item of raw) {
+    if (item == null || item === '') continue;
+    const n = toFiniteNumber(item);
+    if (n != null) out.push(n);
+  }
+  return out;
+}
+
+function ownerChunk(
+  filter: Record<string, unknown>,
+): Omit<ChartFilterItem, 'seq'> | null {
+  const ids = normalizeOwnerIds(filter.opportunityOwner);
+  if (ids.length === 0) return null;
+  return {
+    modelKey: MODEL_KEY,
+    serialNo: SERIAL_NO,
+    fieldKey: 'ownerId',
+    type: 'refer',
+    referKey: 'user',
+    optionType: 'user',
+    entityOnlyFilter: 0,
+    operate: 'in',
+    value: ids.map(ownerUserValueItem),
+    includeNullValue: 0,
+  };
+}
+
+function entityTypeChunk(
+  filter: Record<string, unknown>,
+): Omit<ChartFilterItem, 'seq'> | null {
+  const busi = filter.businessType;
+  if (busi == null || busi === '') return null;
+  const val = toFiniteNumber(busi);
+  if (val == null) return null;
+  return {
+    modelKey: MODEL_KEY,
+    serialNo: SERIAL_NO,
+    fieldKey: 'entityType',
+    type: 'refer',
+    entityOnlyFilter: 0,
+    operate: 'in',
+    value: [{ val }],
+  };
+}
+
+/**
+ * 将筛选栏 payload 转为图表/接口 filter 结构；仅映射 closeDate、ownerId、entityType。
+ */
+export const filter2chartFilter = (filter: any): ChartFilterPayload => {
+  const f = filter && typeof filter === 'object' ? filter : {};
+  const parts = [
+    closeDateChunk(f),
+    ownerChunk(f),
+    entityTypeChunk(f),
+  ].filter(Boolean) as Omit<ChartFilterItem, 'seq'>[];
+
+  const filterOut: ChartFilterItem[] = parts.map((p, i) => ({
+    ...p,
+    seq: i + 1,
+  }));
+
+  const relation =
+    filterOut.length === 0
+      ? ''
+      : filterOut.map((x) => String(x.seq)).join(' and ');
+
+  return { relation, filter: filterOut };
+};

package/template/neo-bi-cmps/src/utils/filterBar.ts

@@ -0,0 +1,140 @@
+/**
+ * 筛选栏 filterBar 专用工具方法
+ */
+import moment from 'moment';
+
+export interface FilterOption {
+  value: string | number;
+  label: string;
+  /** 业务类型等接口项上的 apiKey，用于与 defaultBusiType 配置对齐 */
+  apiKey?: string;
+}
+
+/** 自定义日期区间：起止为 Unix 毫秒时间戳（日为本地 startOfDay / endOfDay） */
+export interface TimestampRange {
+  start?: number;
+  end?: number;
+}
+
+/** 规范化下拉项的 value / label */
+export function normalizeOptions(list?: FilterOption[]): FilterOption[] {
+  if (!Array.isArray(list) || list.length === 0) return [];
+  return list.map((o) => ({
+    value: o.value,
+    label: String(o.label ?? o.value),
+  }));
+}
+
+/** Changes Since 下拉默认项 */
+export function defaultChangesSinceOptions(): FilterOption[] {
+  return [
+    { value: 'Start of the Period', label: 'Start of the Period' },
+    { value: 'Custom', label: 'Custom' },
+  ];
+}
+
+/** RangePicker 选中的两天转为起止时间戳（含当日） */
+export function momentRangeToTimestamps(dates: any): TimestampRange | null {
+  const m0 = dates?.[0];
+  const m1 = dates?.[1];
+  if (!m0 || !m1) return null;
+  return {
+    start: moment(m0).startOf('day').valueOf(),
+    end: moment(m1).endOf('day').valueOf(),
+  };
+}
+
+/**
+ * 将 Close Date 相对周期编码转为本地自然日的起止时间戳（起点 0 点，终点 23:59:59.999）。
+ * 约定：百位 2=本周(iso 周)、3=本月、4=本季度（如 201/301/401 及同段其它编码）。
+ */
+export function relativeCloseDateRangeFromCode(
+  encoded: number | string,
+): TimestampRange | null {
+  const curEncoded = typeof encoded === 'number' ? encoded : Number(encoded);
+  if (!Number.isFinite(curEncoded)) return null;
+  const now = moment();
+  if (curEncoded === 201) {
+    // This Week
+    return {
+      start: now.clone().startOf('isoWeek').startOf('day').valueOf(),
+      end: now.clone().endOf('isoWeek').endOf('day').valueOf(),
+    };
+  }
+  if (curEncoded === 301) {
+    // This Month（起点为月初次日 0 点）
+    return {
+      start: now
+        .clone()
+        .startOf('month')
+        .startOf('day')
+        .add(1, 'day')
+        .valueOf(),
+      end: now.clone().endOf('month').endOf('day').valueOf(),
+    };
+  }
+  if (curEncoded === 401) {
+    // This Quarter（起点为季首次日 0 点）
+    return {
+      start: now
+        .clone()
+        .startOf('quarter')
+        .startOf('day')
+        .add(1, 'day')
+        .valueOf(),
+      end: now.clone().endOf('quarter').endOf('day').valueOf(),
+    };
+  }
+  return null;
+}
+
+/** 将 user 实体查询结果转为负责人下拉项（按 id 去重） */
+export function parseUserRecordsToOwnerOptions(records: any): FilterOption[] {
+  const arr = Array.isArray(records) ? records : [];
+  const seen = new Set<string>();
+  const out: FilterOption[] = [];
+  for (const row of arr) {
+    if (row == null || typeof row !== 'object') continue;
+    const id = row.id;
+    const name = row.name != null ? String(row.name) : '';
+    if (!id || !name || seen.has(id)) continue;
+    seen.add(id);
+    out.push({ value: id, label: name });
+  }
+  return out;
+}
+
+/** 从业务类型接口响应中取出列表数组 */
+export function getBusinessTypeRawList(res: any): any[] {
+  const raw = res?.data !== undefined ? res.data : res;
+  const arr = Array.isArray(raw)
+    ? raw
+    : raw?.records || raw?.items || raw?.list || raw?.data || [];
+  return Array.isArray(arr) ? arr : [];
+}
+
+/** 解析业务类型接口结果为下拉选项（保留 apiKey 供默认项匹配） */
+export function parseBusinessTypes(res: any): FilterOption[] {
+  const arr = getBusinessTypeRawList(res);
+  return arr
+    .map((x: any) => ({
+      value: x.id ?? x.apiKey ?? x.value,
+      label: String(x.label ?? x.name ?? x.title ?? x.apiKey ?? ''),
+      apiKey: x.apiKey != null ? String(x.apiKey) : undefined,
+    }))
+    .filter((o) => o.value != null && o.value !== '' && o.label);
+}
+
+/**
+ * 在业务类型选项中按 apiKey === defaultBusiType 解析默认选中值（与下拉 value 一致，一般为 id）
+ */
+export function resolveDefaultBusinessTypeValue(
+  options: FilterOption[],
+  defaultBusiTypeKey?: string,
+): string | number {
+  if (defaultBusiTypeKey == null || defaultBusiTypeKey === '') return '';
+  const key = String(defaultBusiTypeKey);
+  const hit = options.find((o) => o.apiKey != null && o.apiKey === key);
+  if (!hit) return '';
+  return hit.value;
+}