@mseep/bw-modeling-mcp 0.8.0

package/dist/tools/query.js

@@ -0,0 +1,631 @@
+import { XMLParser } from 'fast-xml-parser';
+import { createClientFromEnv, MEDIA_TYPES } from '../bw-client.js';
+// Fallback version range used when the discovery document does not advertise a
+// query media type. The exact query version depends on the BW backend SP level,
+// so the version actually accepted by the system is read from discovery at
+// startup (MEDIA_TYPES['query']) and preferred over this static list.
+const QUERY_ACCEPT = 'application/vnd.sap.bw.modeling.query-v1_8_0+xml, ' +
+    'application/vnd.sap.bw.modeling.query-v1_9_0+xml, ' +
+    'application/vnd.sap.bw.modeling.query-v1_10_0+xml, ' +
+    'application/vnd.sap.bw.modeling.query-v1_11_0+xml';
+/**
+ * Accept header for query GETs: the discovery-advertised media type first (so
+ * systems on a higher or lower SP level negotiate correctly), with the static
+ * version range kept as a fallback.
+ */
+function queryAccept() {
+    const discovered = MEDIA_TYPES['query'];
+    return discovered ? `${discovered}, ${QUERY_ACCEPT}` : QUERY_ACCEPT;
+}
+function ensureArray(val) {
+    if (val === undefined || val === null)
+        return [];
+    return Array.isArray(val) ? val : [val];
+}
+function renderFormula(token, variableMap, ckfMap, rkfMap, localMemberMap, depth = 0) {
+    if (depth > 50)
+        return '...';
+    if (!token)
+        return '?';
+    const type = token['@_xsi:type'];
+    switch (type) {
+        case 'Qry:FormulaInfixOperator': {
+            const children = ensureArray(token['Qry:childToken']);
+            if (children.length >= 2) {
+                const left = renderFormula(children[0], variableMap, ckfMap, rkfMap, localMemberMap, depth + 1);
+                const right = renderFormula(children[1], variableMap, ckfMap, rkfMap, localMemberMap, depth + 1);
+                return `(${left} ${token['@_code']} ${right})`;
+            }
+            return `(${token['@_code']})`;
+        }
+        case 'Qry:FormulaPrefixOperator': {
+            const children = ensureArray(token['Qry:childToken']);
+            const code = token['@_code'];
+            if (code === 'IF' && children.length === 3) {
+                return (`IF(${renderFormula(children[0], variableMap, ckfMap, rkfMap, localMemberMap, depth + 1)}, ` +
+                    `${renderFormula(children[1], variableMap, ckfMap, rkfMap, localMemberMap, depth + 1)}, ` +
+                    `${renderFormula(children[2], variableMap, ckfMap, rkfMap, localMemberMap, depth + 1)})`);
+            }
+            return `${code}(${children.map((c) => renderFormula(c, variableMap, ckfMap, rkfMap, localMemberMap, depth + 1)).join(', ')})`;
+        }
+        case 'Qry:FormulaIObjectOperand':
+            return token['@_infoObject'] ?? '?';
+        case 'Qry:FormulaMemberOperand': {
+            const memberId = token['@_member'];
+            const opType = token['@_operandType'];
+            if (opType === 'Variable') {
+                return variableMap.get(memberId)?.technicalName ?? memberId;
+            }
+            if (opType === 'Member') {
+                return localMemberMap.get(memberId) ?? ckfMap.get(memberId)?.technicalName ?? rkfMap.get(memberId)?.technicalName ?? memberId;
+            }
+            return ckfMap.get(memberId)?.technicalName ?? rkfMap.get(memberId)?.technicalName ?? memberId;
+        }
+        case 'Qry:FormulaConstant':
+            return String(token['@_value'] ?? '');
+        default:
+            return '?';
+    }
+}
+function countMembersRecursive(node) {
+    const children = ensureArray(node['Qry:childMembers']);
+    let count = children.length;
+    for (const c of children) {
+        count += countMembersRecursive(c);
+    }
+    return count;
+}
+function buildLocalMemberMap(members) {
+    const map = new Map();
+    function collect(memberList) {
+        for (const m of memberList) {
+            const id = m['@_id'];
+            const desc = m['Qry:description']?.['@_value'] ?? id ?? '';
+            if (id)
+                map.set(id, desc);
+            const children = ensureArray(m['Qry:childMembers']);
+            if (children.length > 0)
+                collect(children);
+        }
+    }
+    collect(members);
+    return map;
+}
+function parseSelectionGroups(groups, ckfMap, rkfMap) {
+    return groups.map((g) => {
+        const tokens = ensureArray(g['Qry:tokens']);
+        const parsedTokens = tokens.map((t) => {
+            const tType = t['@_xsi:type'];
+            if (tType === 'Qry:SelectionTokenForComponent') {
+                const compId = t['@_component'];
+                const ckfEntry = ckfMap.get(compId);
+                const rkfEntry = rkfMap.get(compId);
+                const entry = ckfEntry ?? rkfEntry;
+                return {
+                    tokenType: 'SelectionTokenForComponent',
+                    componentId: compId,
+                    componentTechnicalName: entry?.technicalName ?? compId,
+                    componentType: ckfEntry ? 'CKF' : 'RKF',
+                };
+            }
+            const fromValue = t['Qry:fromValue'];
+            const tok = {
+                tokenType: 'SelectionRange',
+                selectionType: t['@_selectionType'] ?? '',
+                operator: t['@_operator'] ?? '',
+                exclude: t['@_exclude'] === 'true' || t['@_exclude'] === true,
+                value: fromValue?.['Qry:value'] ?? '',
+            };
+            const internalValue = fromValue?.['@_internalValue'];
+            if (internalValue)
+                tok['internalValue'] = internalValue;
+            const fromValueDesc = t['@_fromValueDesc'];
+            if (fromValueDesc)
+                tok['valueDesc'] = fromValueDesc;
+            return tok;
+        });
+        return {
+            infoObject: g['@_infoObject'] ?? '',
+            description: g['@_description'] ?? '',
+            constantSelection: g['@_constantSelection'] === 'true' || g['@_constantSelection'] === true,
+            tokens: parsedTokens,
+        };
+    });
+}
+function parseMemberRecursive(member, variableMap, ckfMap, rkfMap, localMemberMap) {
+    const mType = member['@_xsi:type'];
+    const id = member['@_id'] ?? '';
+    const descNode = member['Qry:description'];
+    const desc = descNode?.['@_value'] ?? '';
+    const shortDesc = descNode?.['@_shortValue'];
+    const visibility = member['Qry:hidden']?.['@_type'] ?? 'showAlways';
+    const result = {
+        id,
+        type: mType === 'Qry:MemberFormula' ? 'MemberFormula' : 'MemberSelection',
+        description: desc,
+        visibility,
+    };
+    if (shortDesc)
+        result['shortDescription'] = shortDesc;
+    if (mType === 'Qry:MemberFormula') {
+        const formulaDef = member['Qry:formulaDefinition'];
+        const formulaToken = formulaDef?.['Qry:formulaToken'];
+        result['formula'] = formulaToken ? renderFormula(formulaToken, variableMap, ckfMap, rkfMap, localMemberMap) : '';
+    }
+    else {
+        result['selections'] = parseSelectionGroups(ensureArray(member['Qry:groups']), ckfMap, rkfMap);
+        const defaultHint = member['Qry:defaultHint'];
+        if (defaultHint?.['Qry:type'] === 'CINLink') {
+            const hintValue = defaultHint?.['Qry:value'];
+            if (hintValue) {
+                const ckfEntry = ckfMap.get(hintValue);
+                const rkfEntry = rkfMap.get(hintValue);
+                const entry = ckfEntry ?? rkfEntry;
+                if (entry) {
+                    result['referencedComponent'] = {
+                        technicalName: entry.technicalName,
+                        description: entry.description,
+                        componentType: ckfEntry ? 'CKF' : 'RKF',
+                    };
+                }
+            }
+        }
+    }
+    const childMembersRaw = ensureArray(member['Qry:childMembers']);
+    if (childMembersRaw.length > 0) {
+        result['childMembers'] = childMembersRaw.map((cm) => parseMemberRecursive(cm, variableMap, ckfMap, rkfMap, localMemberMap));
+    }
+    return result;
+}
+function parseDimElement(elem, variableMap, ckfMap, rkfMap) {
+    const type = elem['@_xsi:type'];
+    if (type === 'Qry:CustomDimension') {
+        const membersRaw = ensureArray(elem['Qry:members']);
+        const localMemberMap = buildLocalMemberMap(membersRaw);
+        let memberCount = membersRaw.length;
+        for (const m of membersRaw) {
+            memberCount += countMembersRecursive(m);
+        }
+        const members = membersRaw.map((m) => parseMemberRecursive(m, variableMap, ckfMap, rkfMap, localMemberMap));
+        return {
+            type: 'CustomDimension',
+            technicalName: elem['@_technicalName'] ?? '',
+            description: elem['Qry:description']?.['@_value'] ?? '',
+            reusable: elem['@_reusable'] === 'true' || elem['@_reusable'] === true,
+            suppressZeros: elem['@_suppressZeros'] === 'true' || elem['@_suppressZeros'] === true,
+            memberCount,
+            members,
+        };
+    }
+    const additionalInfo = elem['Qry:additionalInfo'];
+    const kvPairs = ensureArray(additionalInfo?.['Qry:keyValuePairs']);
+    const infoObjectTypeKv = kvPairs.find((kv) => kv['@_key'] === 'infoObjectType');
+    const result = {
+        type: 'Dimension',
+        infoObjectName: elem['@_infoObjectName'] ?? '',
+        description: elem['Qry:description']?.['@_value'] ?? '',
+    };
+    if (infoObjectTypeKv)
+        result.infoObjectType = infoObjectTypeKv['@_value'];
+    return result;
+}
+function renderQueryText(q) {
+    const lines = [];
+    const s = (v) => (v != null && v !== '' ? String(v) : '—');
+    const bool = (v) => (v === true || v === 'true') ? 'yes' : 'no';
+    lines.push(`Query: ${s(q['name'])} — ${s(q['description'])}`);
+    lines.push(`InfoProvider: ${s(q['infoProvider'])} (${s(q['providerType'])})`);
+    lines.push(`InfoArea: ${s(q['infoArea'])}  Package: ${s(q['package'])}`);
+    lines.push(`Status: ${s(q['status'])}  Changed: ${s(q['changedAt'])}  By: ${s(q['responsible'])}`);
+    if (q['versionNote'])
+        lines.push(`Note: ${q['versionNote']}`);
+    const settings = q['settings'] ?? {};
+    const zs = settings['zeroSuppression'] ?? {};
+    const rp = settings['resultPosition'] ?? {};
+    lines.push('');
+    lines.push('── Settings ──');
+    lines.push(`  Zero suppression: rows=${bool(zs['rows'])}  columns=${bool(zs['columns'])}  mode=${s(zs['mode'])}`);
+    lines.push(`  Result position: top=${bool(rp['onTop'])}  left=${bool(rp['onLeft'])}`);
+    lines.push(`  RFC=${bool(settings['rfcEnabled'])}  OData=${bool(settings['odataSupport'])}  EasyQuery=${bool(settings['easyQuery'])}`);
+    lines.push(`  Sign presentation: ${s(settings['signPresentation'])}`);
+    const variables = q['variables'] ?? [];
+    if (variables.length > 0) {
+        lines.push('');
+        lines.push('── Variables ──');
+        for (const v of variables) {
+            lines.push(`  ${s(v['technicalName'])}  ${s(v['description'])}`);
+            lines.push(`    InfoObject: ${s(v['infoObject'])}  Type: ${s(v['type'])}  ProcType: ${s(v['procType'])}`);
+            lines.push(`    InputType: ${s(v['inputType'])}  Represents: ${s(v['represents'])}`);
+        }
+    }
+    const filter = q['filter'] ?? [];
+    if (filter.length > 0) {
+        lines.push('');
+        lines.push('── Filter ──');
+        for (const f of filter) {
+            const selections = f['selections'] ?? [];
+            lines.push(`  ${s(f['infoObject'])}: ${JSON.stringify(selections)}`);
+        }
+    }
+    const rows = q['rows'] ?? [];
+    const columns = q['columns'] ?? [];
+    const free = q['freeCharacteristics'] ?? [];
+    lines.push('');
+    lines.push('── Layout ──');
+    lines.push(`  ROWS (${rows.length}):`);
+    for (const r of rows) {
+        lines.push(`    ${s(r['technicalName'] ?? r['infoObjectName'])}  ${s(r['description'])}  [${s(r['type'])}]`);
+    }
+    lines.push(`  COLUMNS (${columns.length}):`);
+    for (const c of columns) {
+        lines.push(`    ${s(c['technicalName'] ?? c['infoObjectName'])}  ${s(c['description'])}  [${s(c['type'])}]`);
+    }
+    lines.push(`  FREE (${free.length}):`);
+    for (const f of free) {
+        lines.push(`    ${s(f['technicalName'] ?? f['infoObjectName'])}  ${s(f['description'])}  [${s(f['type'])}]`);
+    }
+    const ckfs = q['calculatedMeasures'] ?? [];
+    if (ckfs.length > 0) {
+        lines.push('');
+        lines.push(`── Calculated Key Figures (${ckfs.length}) ──`);
+        for (const c of ckfs) {
+            lines.push(`  ${s(c['technicalName'])}  ${s(c['description'])}`);
+            if (c['formula'])
+                lines.push(`    Formula: ${s(c['formula'])}`);
+        }
+    }
+    const rkfs = q['restrictedMeasures'] ?? [];
+    if (rkfs.length > 0) {
+        lines.push('');
+        lines.push(`── Restricted Key Figures (${rkfs.length}) ──`);
+        for (const r of rkfs) {
+            lines.push(`  ${s(r['technicalName'])}  ${s(r['description'])}`);
+            const member = r['member'];
+            if (member?.['keyFigure'])
+                lines.push(`    KeyFigure: ${s(member['keyFigure'])}`);
+        }
+    }
+    const exceptions = q['exceptions'] ?? [];
+    if (exceptions.length > 0) {
+        lines.push('');
+        lines.push(`── Exceptions (${exceptions.length}) ──`);
+        for (const e of exceptions) {
+            lines.push(`  ${s(e['description'])}  evaluated=${bool(e['evaluated'])}`);
+            const thresholds = e['thresholds'] ?? [];
+            for (const t of thresholds) {
+                lines.push(`    Level ${s(t['alertLevel'])}: ${s(t['operator'])} ${s(t['value'])}`);
+            }
+        }
+    }
+    const hasCells = q['hasCellDefinitions'];
+    if (hasCells) {
+        const gridCells = q['gridCells'] ?? [];
+        const helpCells = q['helpCells'] ?? [];
+        lines.push('');
+        lines.push(`── Cell Definitions ──`);
+        lines.push(`  Grid cells: ${gridCells.length}  Help cells: ${helpCells.length}`);
+        for (const gc of gridCells) {
+            lines.push(`  [${s(gc['type'])}] ${s(gc['description'])}  coord1=${s(gc['coordinateMember1'])}  coord2=${s(gc['coordinateMember2'])}`);
+            if (gc['formula'])
+                lines.push(`    Formula: ${s(gc['formula'])}`);
+        }
+    }
+    return lines.join('\n');
+}
+export async function bwGetQuery(queryName, format = 'text') {
+    const client = createClientFromEnv();
+    const basePath = `/sap/bw/modeling/query/${queryName.toLowerCase()}`;
+    let xmlBody;
+    let versionNote;
+    const accept = queryAccept();
+    try {
+        const result = await client.get(`${basePath}/a`, accept);
+        xmlBody = result.body;
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        if (msg.includes('HTTP 404')) {
+            const result = await client.get(`${basePath}/m`, accept);
+            xmlBody = result.body;
+            versionNote = 'inactive version returned';
+        }
+        else {
+            throw err;
+        }
+    }
+    const parser = new XMLParser({
+        ignoreAttributes: false,
+        attributeNamePrefix: '@_',
+        isArray: (tagName) => [
+            'Qry:subComponents',
+            'Qry:selections',
+            'Qry:tokens',
+            'Qry:members',
+            'Qry:childMembers',
+            'Qry:childFormulas',
+            'Qry:free',
+            'Qry:rows',
+            'Qry:columns',
+            'Qry:exceptions',
+            'Qry:conditions',
+            'Qry:gridCells',
+            'Qry:helpCells',
+            'Qry:groups',
+            'Qry:childToken',
+            'Qry:referenceCharacteristic',
+            'atom:link',
+        ].includes(tagName),
+    });
+    const parsed = parser.parse(xmlBody);
+    const root = parsed['Qry:queryResource'];
+    // Step 1: Build subComponent maps
+    const variableMap = new Map();
+    const ckfMap = new Map();
+    const rkfMap = new Map();
+    const subComponents = ensureArray(root['Qry:subComponents']);
+    for (const sc of subComponents) {
+        const scType = sc['@_xsi:type'];
+        const id = sc['@_id'];
+        if (scType === 'Qry:Variable') {
+            variableMap.set(id, {
+                technicalName: sc['@_technicalName'] ?? '',
+                description: sc['Qry:description']?.['@_value'] ?? '',
+                infoObject: sc['@_infoObject'] ?? '',
+                type: sc['Qry:type'] ?? '',
+                procType: sc['Qry:procType'] ?? '',
+                inputType: sc['Qry:inputType'] ?? '',
+                represents: sc['Qry:represents'] ?? '',
+                defaultSelection: sc['Qry:defaultSelection'],
+            });
+        }
+        else if (scType === 'Qry:CalculatedMeasure') {
+            const member = sc['Qry:member'];
+            ckfMap.set(id, {
+                technicalName: sc['@_technicalName'] ?? '',
+                description: sc['Qry:description']?.['@_value'] ?? '',
+                formulaDefinition: member?.['Qry:formulaDefinition'],
+            });
+        }
+        else if (scType === 'Qry:RestrictedMeasure') {
+            rkfMap.set(id, {
+                technicalName: sc['@_technicalName'] ?? '',
+                description: sc['Qry:description']?.['@_value'] ?? '',
+                member: sc['Qry:member'],
+            });
+        }
+    }
+    // Step 3: Parse mainComponent metadata
+    const mainComp = root['Qry:mainComponent'];
+    const entityProps = mainComp['Qry:entityProperties'];
+    const links = ensureArray(entityProps['atom:link']);
+    const relatedLink = links.find((l) => l['@_rel'] === 'related');
+    const href = relatedLink?.['@_href'] ?? '';
+    let providerType;
+    if (href.includes('/hcpr/'))
+        providerType = 'CompositeProvider';
+    else if (href.includes('/alvl/'))
+        providerType = 'AggregationLevel';
+    else if (href.includes('/adso/'))
+        providerType = 'aDSO';
+    else
+        providerType = 'Unknown';
+    const packageRef = entityProps['adtCore:packageRef'];
+    // Step 4: Variables in order of subComponents appearance
+    const variables = [];
+    for (const sc of subComponents) {
+        if (sc['@_xsi:type'] !== 'Qry:Variable')
+            continue;
+        const v = {
+            technicalName: sc['@_technicalName'] ?? '',
+            description: sc['Qry:description']?.['@_value'] ?? '',
+            infoObject: sc['@_infoObject'] ?? '',
+            type: sc['Qry:type'] ?? '',
+            procType: sc['Qry:procType'] ?? '',
+            inputType: sc['Qry:inputType'] ?? '',
+            represents: sc['Qry:represents'] ?? '',
+        };
+        const defaultSel = sc['Qry:defaultSelection'];
+        if (defaultSel && defaultSel['@_fromValue'] !== undefined) {
+            v['defaultValue'] = String(defaultSel['@_fromValue']);
+        }
+        variables.push(v);
+    }
+    // Step 5: Parse filter
+    const filterSection = mainComp['Qry:filter'];
+    const selections = ensureArray(filterSection?.['Qry:selections']);
+    const filter = [];
+    for (const sel of selections) {
+        const usageType = sel['@_usageType'] ?? '';
+        const tokens = ensureArray(sel['Qry:tokens']);
+        if (usageType === 'asStartValue' && tokens.length === 0)
+            continue;
+        const infoObject = sel['@_infoObject'] ?? '';
+        const localDim = sel['Qry:localDimension'];
+        const description = localDim
+            ? localDim['Qry:description']?.['@_value'] ?? infoObject
+            : infoObject;
+        const item = { infoObject, description, usageType };
+        const fixedValues = tokens
+            .filter((t) => t['@_xsi:type'] === 'Qry:SelectionRange')
+            .map((t) => {
+            const fromValue = t['Qry:fromValue'];
+            const fv = {
+                operator: t['@_operator'] ?? '',
+                exclude: t['@_exclude'] === 'true' || t['@_exclude'] === true,
+                value: fromValue?.['Qry:value'] ?? '',
+            };
+            const fromValueDesc = t['@_fromValueDesc'];
+            if (fromValueDesc)
+                fv['valueDesc'] = fromValueDesc;
+            return fv;
+        });
+        if (fixedValues.length > 0)
+            item['fixedValues'] = fixedValues;
+        const varToken = tokens.find((t) => t['@_xsi:type'] === 'Qry:SelectionVariable');
+        if (varToken) {
+            const varId = varToken['@_variable'];
+            const varInfo = variableMap.get(varId);
+            item['variable'] = {
+                technicalName: varInfo?.technicalName ?? varId,
+                description: varInfo?.description ?? '',
+            };
+        }
+        filter.push(item);
+    }
+    // Step 6: Parse layout
+    const columnsRaw = ensureArray(mainComp['Qry:columns']);
+    const rowsRaw = ensureArray(mainComp['Qry:rows']);
+    const freeRaw = ensureArray(mainComp['Qry:free']);
+    const columns = columnsRaw.map((elem) => parseDimElement(elem, variableMap, ckfMap, rkfMap));
+    const rows = rowsRaw.map((elem) => parseDimElement(elem, variableMap, ckfMap, rkfMap));
+    const freeCharacteristics = freeRaw.map((elem) => {
+        const additionalInfo = elem['Qry:additionalInfo'];
+        const kvPairs = ensureArray(additionalInfo?.['Qry:keyValuePairs']);
+        const infoObjectTypeKv = kvPairs.find((kv) => kv['@_key'] === 'infoObjectType');
+        const result = {
+            infoObjectName: elem['@_infoObjectName'] ?? '',
+            description: elem['Qry:description']?.['@_value'] ?? '',
+        };
+        if (infoObjectTypeKv)
+            result['infoObjectType'] = infoObjectTypeKv['@_value'];
+        return result;
+    });
+    // Step 7: Calculated Measures (CKFs only)
+    const calculatedMeasures = [];
+    for (const [, ckf] of ckfMap) {
+        const formulaDef = ckf.formulaDefinition;
+        const formulaToken = formulaDef?.['Qry:formulaToken'];
+        calculatedMeasures.push({
+            technicalName: ckf.technicalName,
+            description: ckf.description,
+            formula: formulaToken ? renderFormula(formulaToken, variableMap, ckfMap, rkfMap, new Map()) : '',
+        });
+    }
+    // Step 8: Restricted Measures
+    const restrictedMeasures = [];
+    for (const [, rkf] of rkfMap) {
+        restrictedMeasures.push({
+            technicalName: rkf.technicalName,
+            description: rkf.description,
+            selections: parseSelectionGroups(ensureArray(rkf.member?.['Qry:groups']), ckfMap, rkfMap),
+        });
+    }
+    // Step 9: Exceptions
+    const exceptionsRaw = ensureArray(mainComp['Qry:exceptions']);
+    const exceptions = exceptionsRaw.map((ex) => {
+        const exTokens = ensureArray(ex['Qry:tokens']);
+        const thresholds = exTokens.map((t) => {
+            const fromValue = t['Qry:fromValue'];
+            const toValueNode = t['Qry:toValue'];
+            const threshold = {
+                alertLevel: t['@_alertLevel'] ?? '',
+                operator: t['@_operator'] ?? '',
+                value: fromValue?.['Qry:value'] ?? '',
+            };
+            const toVal = toValueNode?.['Qry:value'];
+            if (toVal !== undefined)
+                threshold['toValue'] = toVal;
+            return threshold;
+        });
+        const exception = {
+            id: ex['@_id'] ?? '',
+            active: ex['@_active'] === 'true' || ex['@_active'] === true,
+            evaluateBeforeListCalc: ex['@_evaluateBeforeListCalc'] === 'true' || ex['@_evaluateBeforeListCalc'] === true,
+            affectsChasNotListed: ex['@_affectsChasNotListed'] ?? '',
+            affectsDataCells: ex['@_affectsDataCells'] === 'true' || ex['@_affectsDataCells'] === true,
+            description: ex['Qry:description']?.['@_value'] ?? '',
+            thresholds,
+        };
+        const firstStruc = ex['Qry:definedCellFirstStruc'];
+        const firstMember = firstStruc?.['Qry:member'];
+        if (firstMember)
+            exception['firstStructureMember'] = firstMember;
+        const secondStruc = ex['Qry:definedCellSecondStruc'];
+        const secondMember = secondStruc?.['Qry:member'];
+        if (secondMember)
+            exception['secondStructureMember'] = secondMember;
+        return exception;
+    });
+    // Step 10: Cell definitions
+    const gridCellsRaw = ensureArray(mainComp['Qry:gridCells']);
+    const helpCellsRaw = ensureArray(mainComp['Qry:helpCells']);
+    const hasCellDefinitions = gridCellsRaw.length > 0 || helpCellsRaw.length > 0;
+    const gridCells = gridCellsRaw.map((gc) => {
+        const gcType = gc['@_xsi:type'];
+        const cell = {
+            id: gc['@_id'] ?? '',
+            type: gcType === 'Qry:FormulaCell' ? 'FormulaCell' : 'ReferenceCell',
+            description: gc['Qry:description']?.['@_value'] ?? '',
+            coordinateMember1: gc['Qry:coordinateMember1'] ?? '',
+            coordinateMember2: gc['Qry:coordinateMember2'] ?? '',
+        };
+        if (gcType === 'Qry:FormulaCell') {
+            const formulaDef = gc['Qry:formulaDefinition'];
+            const formulaToken = formulaDef?.['Qry:formulaToken'];
+            cell['formula'] = formulaToken ? renderFormula(formulaToken, variableMap, ckfMap, rkfMap, new Map()) : '';
+        }
+        return cell;
+    });
+    const helpCells = helpCellsRaw.map((hc) => ({
+        id: hc['@_id'] ?? '',
+        description: hc['Qry:description']?.['@_value'] ?? '',
+        selections: parseSelectionGroups(ensureArray(hc['Qry:groups']), ckfMap, rkfMap),
+    }));
+    // Step 11: Query-level settings
+    const zeroSuppr = mainComp['Qry:zeroSuppression'];
+    const planningNode = mainComp['Qry:planning'];
+    const resultPosNode = mainComp['Qry:resultPosition'];
+    const zeroSuppression = {
+        rows: zeroSuppr?.['@_rows'] === 'true' || zeroSuppr?.['@_rows'] === true,
+        columns: zeroSuppr?.['@_columns'] === 'true' || zeroSuppr?.['@_columns'] === true,
+    };
+    if (zeroSuppr?.['@_mode'])
+        zeroSuppression['mode'] = zeroSuppr['@_mode'];
+    const settings = {
+        rfcEnabled: mainComp['@_rfcEnabled'] === 'true' || mainComp['@_rfcEnabled'] === true,
+        easyQuery: mainComp['@_easyQuery'] === 'true' || mainComp['@_easyQuery'] === true,
+        odataSupport: mainComp['@_odataSupport'] === 'true' || mainComp['@_odataSupport'] === true,
+        suppressRepeatedKeyValues: mainComp['@_suppressRepeatedKeyValues'] === 'true' || mainComp['@_suppressRepeatedKeyValues'] === true,
+        showScalingFactor: mainComp['@_showScalingFactor'] === 'true' || mainComp['@_showScalingFactor'] === true,
+        signPresentation: mainComp['@_signPresentation'] ?? '',
+        zeroSuppression,
+        planning: {
+            inputMode: planningNode?.['@_inputMode'] === 'true' || planningNode?.['@_inputMode'] === true,
+            symmetrical: planningNode?.['@_symmetrical'] === 'true' || planningNode?.['@_symmetrical'] === true,
+        },
+        resultPosition: {
+            onTop: resultPosNode?.['@_onTop'] === 'true' || resultPosNode?.['@_onTop'] === true,
+            onLeft: resultPosNode?.['@_onLeft'] === 'true' || resultPosNode?.['@_onLeft'] === true,
+        },
+    };
+    const output = {
+        name: mainComp['@_technicalName'] ?? queryName.toUpperCase(),
+        description: mainComp['Qry:description']?.['@_value'] ?? '',
+        infoProvider: mainComp['@_providerName'] ?? '',
+        providerType,
+        package: packageRef?.['@_adtCore:name'] ?? '',
+        infoArea: entityProps['infoArea'] ?? '',
+        status: entityProps['objectStatus'] ?? '',
+        responsible: entityProps['@_adtCore:responsible'] ?? '',
+        changedAt: entityProps['@_adtCore:changedAt'] ?? '',
+        createdAt: entityProps['@_adtCore:createdAt'] ?? '',
+        timestamp: mainComp['@_timestamp'] ?? '',
+        settings,
+        variables,
+        filter,
+        columns,
+        rows,
+        freeCharacteristics,
+        calculatedMeasures,
+        restrictedMeasures,
+        exceptions,
+        hasCellDefinitions,
+        gridCells,
+        helpCells,
+    };
+    if (versionNote)
+        output['versionNote'] = versionNote;
+    if (format === 'raw')
+        return JSON.stringify(output, null, 2);
+    return renderQueryText(output);
+}