@bimatrix-aud-platform/aud_mcp_server 1.1.16 → 1.1.17

package/dist/generators/fixer.js

@@ -1,4 +1,5 @@
 import { readFileSync, writeFileSync } from "fs";
+import { createDefaultOlapField, isNumericColumnType } from "./olap-field.js";
 /**
  * MTSD 파일을 읽고, 자동 보정 규칙을 적용한 뒤, 파일을 덮어씁니다.
  */
@@ -92,73 +93,7 @@ function fixDataSourceReferences(doc, dsNameToId, dsIdSet, fixes) {
     }
 }
 // ---- Rule 2: OlapGrid DataSource 기반 Fields 자동 생성 ----
-// DataSource Column.Type이 "Numeric"이면 숫자형으로 판단
-const NUMERIC_COLUMN_TYPES = new Set([
-    "Numeric",
-    // SQL 타입 호환
-    "INT", "INTEGER", "BIGINT", "SMALLINT", "TINYINT",
-    "NUMERIC", "DECIMAL", "FLOAT", "DOUBLE", "REAL", "NUMBER", "MONEY",
-]);
-function isNumericColumnType(type) {
-    return NUMERIC_COLUMN_TYPES.has(type) || NUMERIC_COLUMN_TYPES.has(type.toUpperCase());
-}
-/** OlapField 기본값 생성 (OlapField constructor + Serialize 기준) */
-function createDefaultOlapField(key, caption) {
-    return {
-        Key: key,
-        Caption: caption,
-        ToolTipField: "",
-        ToolTipText: "",
-        Category: 1, // enCategory.Dimension
-        Area: 0, // enArea.Hidden
-        SummaryType: 0, // enSummaryType.None
-        TotalSummaryType: 0,
-        SummaryVariation: 0,
-        GroupByType: 0, // enGroupByType.Auto
-        Format: "",
-        Formula: "",
-        Formula2: "",
-        RefFormula: "",
-        Width: 100,
-        Unit: 1,
-        CreateType: 0, // enOlapFieldCreateType.Default
-        SortType: 0, // enSortType.None
-        MeasureSortField: "",
-        SortBaseField: "",
-        MoveAble: true,
-        SortAble: true,
-        FilterAble: true,
-        AllowFilter: true,
-        AllowRow: true,
-        AllowColumn: true,
-        AllowData: true,
-        KeyType: 0, // enKeyType.None
-        DataType: 0, // enDataType.Numeric
-        SaveMode: 0, // enSaveMode.All
-        LanguageCode: "",
-        UseChartSource: true,
-        VisibleSubTotal: true,
-        SummaryBaseFieldKey: "",
-        TextAlignment: 1, // enHorizonAlign.Right
-        HeaderAlignment: 0, // enHorizonAlign.Left
-        InDimensions: "",
-        Visible: true,
-        Expanded: true,
-        MetaItemCode: "",
-        MetaItemName: "",
-        MetaRollupType: 0,
-        MetaCalculatorField: false,
-        MetaSummaryTypeIsDistinct: false,
-        FilterInfo: {
-            FilterType: 0, // enOlapFilterType.In
-            FilterKind: 0, // enOlapFilterKind.Dimension
-            HasMeasureFilter: false,
-            MeasureFilterTypeA: 0, // enOlapMeasureFilterType.Equals
-            MeasureFilterTypeB: 0,
-            MeasureAndOrOperator: 2, // enAndOrOperator.And
-        },
-    };
-}
+// createDefaultOlapField, isNumericColumnType는 olap-field.ts에서 import
 function fixOlapGridFields(doc, datas, fixes) {
     // DataSource Id → DataSource 객체 매핑
     const dsById = new Map();

package/dist/generators/olap-field.d.ts

@@ -0,0 +1,45 @@
+/**
+ * OlapGrid iOLAPView.Fields 생성기
+ *
+ * 컬럼 정의를 입력받아 OlapField 배열을 생성합니다.
+ * iOLAP.OlapGrid.ts의 createDataSourceFields (UseMeta==false) 로직을 기반으로 합니다.
+ *
+ * @see 2.Sources/src/control/olapgrid/iOLAP.OlapGrid.ts:4592-4657  — 필드 생성
+ * @see 2.Sources/src/control/olapgrid/iOLAP.OlapGrid.ts:1806-1837  — Area 자동 배치
+ * @see 2.Sources/src/control/olapgrid/iOLAP.Enums.ts               — enCategory, enArea 등
+ */
+export declare function isNumericColumnType(type: string): boolean;
+export declare function createDefaultOlapField(key: string, caption: string): any;
+export interface OlapFieldColumn {
+    name: string;
+    caption?: string;
+    type?: string;
+    area?: string;
+    summaryType?: string;
+    format?: string;
+    sortType?: string;
+    width?: number;
+}
+export interface GenerateOlapFieldsInput {
+    columns: OlapFieldColumn[];
+    autoPlace?: boolean;
+    includeOptions?: boolean;
+}
+export interface GenerateOlapFieldsResult {
+    fields: any[];
+    iOLAPView?: any;
+    warnings: string[];
+    summary: {
+        total: number;
+        dimensions: number;
+        measures: number;
+        areaMap: {
+            row: string[];
+            column: string[];
+            data: string[];
+            filter: string[];
+            hidden: string[];
+        };
+    };
+}
+export declare function generateOlapFields(input: GenerateOlapFieldsInput): GenerateOlapFieldsResult;

package/dist/generators/olap-field.js

@@ -0,0 +1,316 @@
+/**
+ * OlapGrid iOLAPView.Fields 생성기
+ *
+ * 컬럼 정의를 입력받아 OlapField 배열을 생성합니다.
+ * iOLAP.OlapGrid.ts의 createDataSourceFields (UseMeta==false) 로직을 기반으로 합니다.
+ *
+ * @see 2.Sources/src/control/olapgrid/iOLAP.OlapGrid.ts:4592-4657  — 필드 생성
+ * @see 2.Sources/src/control/olapgrid/iOLAP.OlapGrid.ts:1806-1837  — Area 자동 배치
+ * @see 2.Sources/src/control/olapgrid/iOLAP.Enums.ts               — enCategory, enArea 등
+ */
+// ─── enums (iOLAP.Enums.ts 기준) ───
+const enArea = { Hidden: 0, Row: 1, Column: 2, Filter: 3, Data: 4 };
+const enCategory = { Default: 0, Dimension: 1, Measure: 2, Attribute: 3, Period: 4 };
+const enSummaryType = { None: 0, Sum: 1, Min: 2, Max: 3, Average: 4, Count: 5, Calculate: 9, DistinctCount: 13, Text: 14 };
+const enSortType = { None: 0, Asc: 1, Desc: 2, Custom: 3 };
+const enDataType = { Numeric: 0, String: 1, DateTime8: 2, DateTimeNow: 3, UserCode: 4, CLOB: 5 };
+// ─── 숫자형 컬럼 타입 판별 ───
+const NUMERIC_COLUMN_TYPES = new Set([
+    "Numeric",
+    "INT", "INTEGER", "BIGINT", "SMALLINT", "TINYINT",
+    "NUMERIC", "DECIMAL", "FLOAT", "DOUBLE", "REAL", "NUMBER", "MONEY",
+]);
+export function isNumericColumnType(type) {
+    return NUMERIC_COLUMN_TYPES.has(type) || NUMERIC_COLUMN_TYPES.has(type.toUpperCase());
+}
+// ─── OlapField 기본값 생성 (OlapField constructor + Serialize 기준) ───
+export function createDefaultOlapField(key, caption) {
+    return {
+        Key: key,
+        Caption: caption,
+        ToolTipField: "",
+        ToolTipText: "",
+        Category: enCategory.Dimension,
+        Area: enArea.Hidden,
+        SummaryType: enSummaryType.None,
+        TotalSummaryType: 0,
+        SummaryVariation: 0,
+        GroupByType: 0,
+        Format: "",
+        Formula: "",
+        Formula2: "",
+        RefFormula: "",
+        Width: 100,
+        Unit: 1,
+        CreateType: 0,
+        SortType: enSortType.None,
+        MeasureSortField: "",
+        SortBaseField: "",
+        MoveAble: true,
+        SortAble: true,
+        FilterAble: true,
+        AllowFilter: true,
+        AllowRow: true,
+        AllowColumn: true,
+        AllowData: true,
+        KeyType: 0,
+        DataType: enDataType.Numeric,
+        SaveMode: 0,
+        LanguageCode: "",
+        UseChartSource: true,
+        VisibleSubTotal: true,
+        SummaryBaseFieldKey: "",
+        TextAlignment: 1, // Right
+        HeaderAlignment: 0, // Left
+        InDimensions: "",
+        Visible: true,
+        Expanded: true,
+        MetaItemCode: "",
+        MetaItemName: "",
+        MetaRollupType: 0,
+        MetaCalculatorField: false,
+        MetaSummaryTypeIsDistinct: false,
+        FilterInfo: {
+            FilterType: 0,
+            FilterKind: 0,
+            HasMeasureFilter: false,
+            MeasureFilterTypeA: 0,
+            MeasureFilterTypeB: 0,
+            MeasureAndOrOperator: 2,
+        },
+    };
+}
+// ─── summaryType 문자열 → enum 변환 ───
+function parseSummaryType(s) {
+    switch (s.toLowerCase()) {
+        case "sum": return enSummaryType.Sum;
+        case "count": return enSummaryType.Count;
+        case "average":
+        case "avg": return enSummaryType.Average;
+        case "min": return enSummaryType.Min;
+        case "max": return enSummaryType.Max;
+        case "none": return enSummaryType.None;
+        case "distinctcount": return enSummaryType.DistinctCount;
+        case "text": return enSummaryType.Text;
+        default: return enSummaryType.None;
+    }
+}
+// ─── sortType 문자열 → enum 변환 ───
+function parseSortType(s) {
+    switch (s.toLowerCase()) {
+        case "asc": return enSortType.Asc;
+        case "desc": return enSortType.Desc;
+        case "none": return enSortType.None;
+        default: return enSortType.None;
+    }
+}
+// ─── area 문자열 → enum 변환 ───
+function parseArea(s) {
+    switch (s.toLowerCase()) {
+        case "row": return enArea.Row;
+        case "column":
+        case "col": return enArea.Column;
+        case "data": return enArea.Data;
+        case "filter": return enArea.Filter;
+        case "hidden": return enArea.Hidden;
+        default: return enArea.Hidden;
+    }
+}
+// ─── iOLAPView.Options 기본값 ───
+function createDefaultOptions() {
+    return {
+        ViewType: 0,
+        IsExpandAll: true,
+        ShowExpandButtons: true,
+        EmptyCellText: "",
+        NotAvaliableCellText: "",
+        ZeroDivisioinCellText: "",
+        ErrorCellText: "",
+        RowGrandTotalText: "총계",
+        ColumnGrandTotalText: "총계",
+        RowTotalText: "소계",
+        ColumnTotalText: "소계",
+        RowTotalLocation: 1,
+        ColumnTotalLocation: 1,
+        RowGrandTotalLocation: 1,
+        ColumnGrandTotalLocation: 1,
+        DisplayColumnSubTotal: true,
+        DisplayRowSubTotal: true,
+        DisplayColumnGrandTotal: true,
+        DisplayRowGrandTotal: true,
+        ShowFilterArea: true,
+        ShowColumnrArea: true,
+        ShowRowArea: true,
+        ShowDataArea: true,
+        UseMultiHeader: false,
+        AutoSelection: false,
+        HideHorizontalScrollBar: false,
+        HideVerticalScrollBar: false,
+        DisableClipBoard: false,
+        CellHeight: 24,
+        HeaderCellHeight: 24,
+        CanResizeCellWidth: true,
+        RowHeaderUnFix: false,
+        MeasuresCreateArea: 1,
+        TreeHeaderWidth: 200,
+        TreeIndentWidth: 16,
+        DisableColumnSort: false,
+        EnableWriteBack: false,
+        MergeColumnHeaders: false,
+        MergeRowHeaders: false,
+        CacheOption: {
+            UseHybrid: true,
+        },
+    };
+}
+export function generateOlapFields(input) {
+    const warnings = [];
+    const columns = input.columns || [];
+    const autoPlace = input.autoPlace !== false; // 기본 true
+    const includeOptions = input.includeOptions === true;
+    if (columns.length === 0) {
+        warnings.push("columns 배열이 비어 있습니다.");
+        return {
+            fields: [],
+            warnings,
+            summary: { total: 0, dimensions: 0, measures: 0, areaMap: { row: [], column: [], data: [], filter: [], hidden: [] } },
+        };
+    }
+    // 1. 필드 생성
+    const fields = [];
+    const nameSet = new Set();
+    for (const col of columns) {
+        if (!col.name) {
+            warnings.push("name이 비어있는 컬럼이 있어 건너뜁니다.");
+            continue;
+        }
+        if (nameSet.has(col.name)) {
+            warnings.push(`중복 컬럼명 "${col.name}" 발견, 건너뜁니다.`);
+            continue;
+        }
+        nameSet.add(col.name);
+        const caption = col.caption || col.name;
+        const field = createDefaultOlapField(col.name, caption);
+        const isNumeric = isNumericColumnType(col.type || "string");
+        // 타입 기반 기본값 설정 (createDataSourceFields 로직)
+        if (isNumeric) {
+            field.Category = enCategory.Measure;
+            field.Format = "{0:N0}";
+            field.DataType = enDataType.Numeric;
+            field.SummaryType = enSummaryType.Sum;
+            field.TextAlignment = 1; // Right
+        }
+        else {
+            field.Category = enCategory.Dimension;
+            field.DataType = enDataType.String;
+            field.SortType = enSortType.Asc;
+            field.SummaryType = enSummaryType.Count;
+            field.TextAlignment = 1; // Right
+        }
+        // 커스텀 오버라이드
+        if (col.summaryType) {
+            field.SummaryType = parseSummaryType(col.summaryType);
+        }
+        if (col.format) {
+            field.Format = col.format;
+        }
+        if (col.sortType) {
+            field.SortType = parseSortType(col.sortType);
+        }
+        if (col.width != null) {
+            field.Width = col.width;
+        }
+        // 수동 Area 지정
+        if (col.area) {
+            field.Area = parseArea(col.area);
+        }
+        fields.push(field);
+    }
+    // 2. Area 자동 배치 (setDataSource 로직 준용)
+    if (autoPlace) {
+        let rowCnt = 0;
+        let colCnt = 0;
+        let dataCnt = 0;
+        for (const field of fields) {
+            // 수동 area가 이미 지정된 경우 스킵 (Hidden=0이 아닌 경우)
+            if (field.Area !== enArea.Hidden)
+                continue;
+            if (field.DataType === enDataType.Numeric) {
+                // Numeric → Data(최대 3개) → Filter
+                if (dataCnt < 3) {
+                    field.Area = enArea.Data;
+                    dataCnt++;
+                }
+                else {
+                    field.Area = enArea.Filter;
+                }
+            }
+            else {
+                // String → Row(최대 2개) → Column(최대 2개) → Filter
+                if (rowCnt < 2) {
+                    field.Area = enArea.Row;
+                    rowCnt++;
+                }
+                else if (colCnt < 2) {
+                    field.Area = enArea.Column;
+                    colCnt++;
+                }
+                else {
+                    field.Area = enArea.Filter;
+                }
+            }
+        }
+    }
+    // 3. 요약 정보 생성
+    const areaMap = { row: [], column: [], data: [], filter: [], hidden: [] };
+    let dimensions = 0;
+    let measures = 0;
+    for (const field of fields) {
+        if (field.Category === enCategory.Measure)
+            measures++;
+        else
+            dimensions++;
+        switch (field.Area) {
+            case enArea.Row:
+                areaMap.row.push(field.Key);
+                break;
+            case enArea.Column:
+                areaMap.column.push(field.Key);
+                break;
+            case enArea.Data:
+                areaMap.data.push(field.Key);
+                break;
+            case enArea.Filter:
+                areaMap.filter.push(field.Key);
+                break;
+            default:
+                areaMap.hidden.push(field.Key);
+                break;
+        }
+    }
+    // 4. 결과 조립
+    const result = {
+        fields,
+        warnings,
+        summary: {
+            total: fields.length,
+            dimensions,
+            measures,
+            areaMap,
+        },
+    };
+    // includeOptions: iOLAPView 전체 구조 포함
+    if (includeOptions) {
+        result.iOLAPView = {
+            Options: createDefaultOptions(),
+            TopFilter: {
+                Dimension: "",
+                Measure: "",
+                Rank: 0,
+                IsTop: true,
+            },
+            Fields: fields,
+        };
+    }
+    return result;
+}

package/dist/index.js

@@ -12,6 +12,7 @@ import { generateGridColumns } from "./generators/grid-column.js";
 import { generateDataSource } from "./generators/datasource.js";
 import { fixMtsd } from "./generators/fixer.js";
 import { getControlInfo } from "./generators/control-info.js";
+import { generateOlapFields } from "./generators/olap-field.js";
 import { callSchemaService, callDbmsList, isAudConfigured, setWorkspaceRoots } from "./utils/aud-api-client.js";
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
@@ -494,6 +495,54 @@ const tools = [
             additionalProperties: true,
         },
     },
+    {
+        name: "generate_olap_fields",
+        description: "OlapGrid의 iOLAPView.Fields 배열을 생성합니다. 컬럼 정의를 입력하면 Dimension/Measure 분류, Area 자동 배치, SummaryType 설정이 완료된 OlapField 배열을 반환합니다.",
+        inputSchema: {
+            type: "object",
+            properties: {
+                columns: {
+                    type: "array",
+                    items: {
+                        type: "object",
+                        properties: {
+                            name: { type: "string", description: "컬럼명 (OlapField Key)" },
+                            caption: { type: "string", description: "표시명 (생략 시 name)" },
+                            type: {
+                                type: "string",
+                                enum: ["string", "number", "numeric", "date", "datetime", "int", "float", "decimal", "varchar", "nvarchar", "char"],
+                                description: "컬럼 데이터 타입 (number/numeric/int/float/decimal → Measure, 그 외 → Dimension)",
+                            },
+                            area: {
+                                type: "string",
+                                enum: ["row", "column", "data", "filter", "hidden"],
+                                description: "수동 Area 배치 (생략 시 자동 배치)",
+                            },
+                            summaryType: {
+                                type: "string",
+                                enum: ["sum", "count", "average", "min", "max", "none", "distinctcount", "text"],
+                                description: "집계 함수 (Measure 기본: sum, Dimension 기본: count)",
+                            },
+                            format: { type: "string", description: "표시 포맷 (예: {0:N0})" },
+                            sortType: { type: "string", enum: ["asc", "desc", "none"], description: "정렬" },
+                            width: { type: "number", description: "너비 (기본 100)" },
+                        },
+                        required: ["name"],
+                    },
+                    description: "컬럼 정의 배열",
+                },
+                autoPlace: {
+                    type: "boolean",
+                    description: "Area 자동 배치 (기본: true). false면 수동 area 지정 필드만 배치, 나머지 Hidden",
+                },
+                includeOptions: {
+                    type: "boolean",
+                    description: "iOLAPView 전체 구조(Options + Fields) 포함 여부 (기본: false)",
+                },
+            },
+            required: ["columns"],
+        },
+    },
     {
         name: "fix_mtsd",
         description: "MTSD 파일을 읽어 자동 보정 규칙을 적용하고 파일을 덮어씁니다. DataSource Name→Id 참조 보정, Params Value 누락 보정, Columns Type 누락 보정, Docking/Border 필수 속성 보정을 수행합니다.",
@@ -942,6 +991,25 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
                     ],
                 };
             }
+            case "generate_olap_fields": {
+                const result = generateOlapFields(args);
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                success: true,
+                                fields: result.fields,
+                                iOLAPView: result.iOLAPView,
+                                summary: result.summary,
+                                warnings: result.warnings.length > 0
+                                    ? result.warnings
+                                    : undefined,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
             case "fix_mtsd": {
                 const filePath = args?.path;
                 if (!filePath) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bimatrix-aud-platform/aud_mcp_server",
-  "version": "1.1.16",
+  "version": "1.1.17",
   "description": "MCP Server for i-AUD MTSD document validation and generation",
   "type": "module",
   "main": "dist/index.js",