neo-cmp-cli 1.13.15 → 1.13.17

package/template/neo-pipeline-cmps/src/utils/common.ts

@@ -0,0 +1,229 @@
+/**
+ * 多组件共用的纯工具方法（筛选 where、阶段名、金额展示、NeoBI 请求体等）
+ */
+
+export interface PropsContext {
+  data?: {
+    __NeoCurrentUser?: {
+      id?: number;
+      name?: string | null;
+    };
+  };
+}
+/** 筛选项转有限数字，无效返回 null（与 filter2chartFilter 等一致） */
+export function toFiniteNumber(v: unknown): number | null {
+  if (v == null || v === '') return null;
+  if (typeof v === 'number' && Number.isFinite(v)) return v;
+  const n = Number(v);
+  return Number.isFinite(n) ? n : null;
+}
+
+/** 时间区间起止：均为有效数字时返回闭区间 [start, end]（毫秒时间戳，与 FilterBar 一致） */
+export function closeRangeFromFilter(
+  range: unknown,
+): { start: number; end: number } | null {
+  if (!range || typeof range !== 'object') return null;
+  const r = range as { start?: unknown; end?: unknown };
+  const start = toFiniteNumber(r.start);
+  const end = toFiniteNumber(r.end);
+  if (start == null || end == null) return null;
+  return { start, end };
+}
+
+/** opportunityOwner → 用于 where 的用户 id 列表（字符串避免大整数精度丢失） */
+export function normalizeOwnerIdsForWhere(owner: unknown): string[] {
+  if (owner == null || owner === '') return [];
+  const raw = Array.isArray(owner) ? owner : [owner];
+  const out: string[] = [];
+  for (const item of raw) {
+    if (item == null || item === '') continue;
+    const s = String(item).trim().replace(/,/g, '');
+    if (s === '' || !/^-?\d+$/.test(s)) continue;
+    out.push(s);
+  }
+  return out;
+}
+
+export function entityTypeIdForWhere(businessType: unknown): string | null {
+  if (businessType == null || businessType === '') return null;
+  const s = String(businessType).trim();
+  if (s === '' || !/^-?\d+$/.test(s.replace(/,/g, ''))) return null;
+  return s.replace(/,/g, '');
+}
+
+/** 从阶段展示名取「第一个 . 之后」的片段，用于匹配 customItem1__c 等 */
+export function extractStageKeyFromStageName(stageName: string): string {
+  const s = String(stageName ?? '').trim();
+  const i = s.indexOf('.');
+  if (i < 0) return s;
+  return s.slice(i + 1).trim();
+}
+
+/** 商机行等：空或无法解析时为 0 */
+export function parseNumberOrZero(raw: unknown): number {
+  if (raw === null || raw === undefined || raw === '') return 0;
+  const n =
+    typeof raw === 'number'
+      ? raw
+      : parseFloat(String(raw).replace(/,/g, '').trim());
+  return Number.isFinite(n) ? n : 0;
+}
+
+/** 阈值配置等：空或无法解析时为 NaN */
+export function parseNumberOrNaN(raw: unknown): number {
+  if (raw === null || raw === undefined || raw === '') return NaN;
+  const n =
+    typeof raw === 'number'
+      ? raw
+      : parseFloat(String(raw).replace(/,/g, '').trim());
+  return Number.isFinite(n) ? n : NaN;
+}
+
+/** 展示用金额：$ 前缀；≥1e3 时使用 K / M / B / T 缩写 */
+export function formatAmountDisplay(n: number): string {
+  if (!Number.isFinite(n)) return '-';
+  const sign = n < 0 ? '-' : '';
+  const abs = Math.abs(n);
+  if (abs === 0) return '$0';
+
+  if (abs < 1000) {
+    const part = Number.isInteger(abs)
+      ? abs.toLocaleString('en-US')
+      : abs.toLocaleString('en-US', {
+          minimumFractionDigits: 0,
+          maximumFractionDigits: 2,
+        });
+    return `${sign}$${part}`;
+  }
+
+  const tier = Math.min(Math.floor(Math.log10(abs) / 3), 4);
+  const suffixes = ['', 'K', 'M', 'B', 'T'] as const;
+  const suffix = suffixes[tier];
+  const divisor = 1000 ** tier;
+  const scaled = abs / divisor;
+
+  let body: string;
+  if (scaled >= 100) body = String(Math.round(scaled));
+  else if (scaled >= 10) body = scaled.toFixed(1).replace(/\.0$/, '');
+  else body = scaled.toFixed(2).replace(/\.?0+$/, '');
+
+  return `${sign}$${body}${suffix}`;
+}
+
+/** queryDataTask：x-www-form-urlencoded 表单体（filter 以 JSON 字符串传递） */
+export function buildQueryDataTaskFormBody(params: {
+  viewId: string;
+  userId: string | number;
+  type: string;
+  filter: Record<string, unknown>;
+}): string {
+  const form = new URLSearchParams();
+  form.set('viewId', String(params.viewId));
+  form.set('userId', String(params.userId));
+  form.set('type', params.type);
+  form.set('filter', JSON.stringify(params.filter));
+  return form.toString();
+}
+
+/** 负责人多选默认值：当前登录用户 id（与 __NeoCurrentUser 一致） */
+export function getDefaultOpportunityOwnerIds(
+  props: PropsContext,
+): (number | string)[] {
+  // return [1246045]; // 默认用户改成 （Alice）
+  const curUser = props.data?.__NeoCurrentUser;
+  if (
+    curUser?.id == null ||
+    curUser.name == null ||
+    String(curUser.name).trim() === ''
+  ) {
+    return [];
+  }
+  return [curUser.id];
+}
+
+/** 负责人多选默认值：当前登录用户 id（与 __NeoCurrentUser 一致） */
+export function getDefaultFilterWhereByProps(props: any = {}): any {
+  let userId = 1246045; // 默认用户（Alice）
+  const curUser = props.data?.__NeoCurrentUser;
+  if (curUser?.id) {
+    userId = curUser.id;
+  }
+  const defaultFilter = {
+    relation: '1 and 2 and 3',
+    filter: [
+      {
+        modelKey: 'opportunity',
+        serialNo: 1,
+        fieldKey: 'closeDate',
+        type: 'date',
+        entityOnlyFilter: 0,
+        timeType: 'relative',
+        operate: 'eq',
+        value: [
+          {
+            val: 401,
+            baseType: 'system',
+          },
+        ],
+        seq: 1,
+      },
+      {
+        modelKey: 'opportunity',
+        serialNo: 1,
+        fieldKey: 'ownerId',
+        type: 'refer',
+        referKey: 'user',
+        optionType: 'user',
+        entityOnlyFilter: 0,
+        operate: 'in',
+        value: [
+          {
+            val: userId,
+            sub: false,
+            source: 'internal',
+            specialType: 0,
+          },
+        ],
+        includeNullValue: 0,
+        seq: 2,
+      },
+      {
+        modelKey: 'opportunity',
+        serialNo: 1,
+        fieldKey: 'entityType',
+        type: 'refer',
+        entityOnlyFilter: 0,
+        operate: 'in',
+        value: [
+          {
+            val: 8150459,
+          },
+        ],
+        seq: 3,
+      },
+    ],
+  };
+  return defaultFilter;
+}
+
+export function getDefaultFilterByProps(props: any = {}): any {
+  let userId = 1246045; // 默认用户（Alice）
+  const curUser = props.data?.__NeoCurrentUser;
+  if (curUser?.id) {
+    userId = curUser.id;
+  }
+  const defaultFilter = {
+    closeDate: 401,
+    closeDateCustomRange: {
+      start: 1775059200000,
+      end: 1782835199999,
+    },
+    opportunityOwner: [userId],
+    businessType: 8150459,
+    businessTypeLabel: 'New Business',
+    businessTypeApiKey: 'defaultBusiType_1',
+    changesSince: 'Start of the Period',
+    changesSinceCustomTime: 1775059200000,
+  };
+  return defaultFilter;
+}

package/template/neo-pipeline-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-pipeline-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;
+}