@sap/ux-specification 1.139.1 → 1.139.4

package/dist/specification/src/sync/v2/generate/stableIdUtils.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * @file This file contains helper functions to replicate the logic for stable id generation from Fiori Elements v2.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getViewId = getViewId;
+exports.getStableIdPartFromDataField = getStableIdPartFromDataField;
+exports.getSuffixFromIconTabFilterKey = getSuffixFromIconTabFilterKey;
+exports.getStableIdForDatafieldActionButton = getStableIdForDatafieldActionButton;
+const extensionLogger_1 = require("../../../extensionLogger");
+/**
+ * This function replicates the logic of function fnDetermineViewId in sap.suite.ui.generic.template.lib.TemplateComponent.js of FE coding.
+ * It determines the id of the view that contains one page of an FE app.
+ *
+ * @param appId - id of the app
+ * @param componentName - name of the template component (that identifies the floor plan)
+ * @param entitySet - name of the entity set of a page
+ * @returns the fully qualified view id
+ */
+function getViewId(appId, componentName, entitySet) {
+    const componentPath = componentName.split('.');
+    const templateShortName = componentPath[componentPath.length - 1];
+    // Replicate logic how oComponentData.templateName has been defined in FE coding. All follow the same pattern with exception of OP.
+    const templateName = componentName + '.view.' + (templateShortName === 'ObjectPage' ? 'Details' : templateShortName);
+    return `${appId}::${templateName}::${entitySet}`;
+}
+/**
+ * This function replicates the logic from corresponding function in sap.suite.ui.generic.template.js.AnnotationHelper.js of FE coding.
+ *
+ * @param id - the id to be modified
+ * @param generateParameters - provides access to the logger
+ * @returns the modified id
+ */
+function replaceSpecialCharsInId(id, generateParameters) {
+    if (id.indexOf(' ') >= 0) {
+        (0, extensionLogger_1.log)(generateParameters.logger, {
+            severity: "error" /* LogSeverity.Error */,
+            message: 'Spaces are not allowed in ID parts. Please check the annotations, probably something is wrong there.'
+        });
+    }
+    return id.replace(/@/g, '').replace(/\//g, '::').replace(/#/g, '::');
+}
+/**
+ * Determine the string which is used to identify an action in an action data field (DataFieldForAction or DataFieldWithIntentBasedNavigation) for the stable id generation.
+ *
+ * @param dataField - the action
+ * @returns the identifying string
+ */
+function getActionStringFromDataField(dataField) {
+    if (typeof dataField.Action === 'string') {
+        return dataField.Action;
+    }
+    if (typeof dataField.Action === 'object') {
+        return dataField.Action['path'];
+    }
+    return '';
+}
+/**
+ * Determine the string which is used to identify a semantic object in a navigation data field (DataFieldFor/WithIntentBasedNavigation) for the stable id generation.
+ *
+ * @param dataField - the navigation
+ * @returns the identifying string
+ */
+function getSemanticObjectStringFromDataField(dataField) {
+    if (typeof dataField.SemanticObject === 'string') {
+        return dataField.SemanticObject;
+    }
+    if (typeof dataField.SemanticObject === 'object') {
+        return dataField.SemanticObject['path'];
+    }
+    return '';
+}
+/**
+ * This function replicates the logic from corresponding function in sap.suite.ui.generic.template.js.AnnotationHelper.js of FE coding.
+ *
+ * @param dataField - the data field for which a stable id part should be created
+ * @param generateParameters - provides access to the logger
+ * @returns the stable id part created from the given data field
+ */
+function getStableIdPartFromDataField(dataField, generateParameters) {
+    let pathConcat = '', idPart = '';
+    if (dataField.$Type === "com.sap.vocabularies.UI.v1.DataFieldForAction" /* UIAnnotationTypes.DataFieldForAction */) {
+        return replaceSpecialCharsInId(getActionStringFromDataField(dataField), generateParameters);
+    }
+    else if (dataField.$Type === "com.sap.vocabularies.UI.v1.DataFieldForIntentBasedNavigation" /* UIAnnotationTypes.DataFieldForIntentBasedNavigation */ ||
+        dataField.$Type === "com.sap.vocabularies.UI.v1.DataFieldWithIntentBasedNavigation" /* UIAnnotationTypes.DataFieldWithIntentBasedNavigation */) {
+        idPart = replaceSpecialCharsInId(getSemanticObjectStringFromDataField(dataField), generateParameters);
+        idPart = idPart + '::' + replaceSpecialCharsInId(getActionStringFromDataField(dataField), generateParameters);
+        return idPart;
+    }
+    else if (dataField.$Type === "com.sap.vocabularies.UI.v1.DataFieldForAnnotation" /* UIAnnotationTypes.DataFieldForAnnotation */ && typeof dataField.Target === 'object') {
+        return replaceSpecialCharsInId(dataField.Target['value'], generateParameters);
+    }
+    else if (dataField.IconUrl /* && (dataField.IconUrl.Path || dataField.IconUrl.String) */) {
+        /*        if (dataField.IconUrl.Path) {
+            idPart = replaceSpecialCharsInId(dataField.IconUrl.Path, generateParameters);
+        } else if (dataField.IconUrl.String) {
+            dataFieldString = dataField.IconUrl.String.replace('://', '-');
+            idPart = replaceSpecialCharsInId(dataFieldString, generateParameters);
+        } */
+        idPart = replaceSpecialCharsInId(dataField.IconUrl.toString(), generateParameters); // todo: recheck Path and String scenario
+        return idPart;
+    }
+    else if (dataField['Value'] && dataField['Value']['type'] === 'Path') {
+        return replaceSpecialCharsInId(dataField['Value']['path'], generateParameters);
+    }
+    else if (dataField['Value'] &&
+        dataField['Value']['Apply'] &&
+        dataField['Value']['Apply']['Name'] === 'odata.concat') {
+        // todo: recheck
+        for (let i = 0; i < dataField['Value']['Apply']['Parameters'].length; i++) {
+            if (dataField['Value']['Apply']['Parameters'][i].Type === 'Path') {
+                if (pathConcat) {
+                    pathConcat = pathConcat + '::';
+                }
+                pathConcat =
+                    pathConcat +
+                        replaceSpecialCharsInId(dataField['Value']['Apply']['Parameters'][i].Value, generateParameters);
+            }
+        }
+        return pathConcat;
+    }
+    else {
+        // Todo: FE logs an error in this case. Check whether tools should do the same.
+        // If yes, some unit test will have to be adapted.
+        // In case of a string or unknown property
+        /*        log(generateParameters.logger, {
+            severity: LogSeverity.Error,
+            message: 'Unable to create a stable ID. Please check the annotations.'
+        }); */
+    }
+}
+/**
+ *  This function replicates the logic from corresponding function in sap.suite.ui.generic.template.js.AnnotationHelper.js of FE coding.
+ *
+ * @param iconTabFilterKey - in multi view case the key identifying the view. Note that we assume that replaceSpecialCharsInId has already been executed on this value (and therefore must not be called again).
+ * @returns the suffix for the stable ID part created from the given iconTabFilterKey
+ */
+function getSuffixFromIconTabFilterKey(iconTabFilterKey) {
+    if (iconTabFilterKey) {
+        return '-'.concat(iconTabFilterKey);
+    }
+    else {
+        return '';
+    }
+}
+/**
+ * This function replicates the logic from corresponding function in sap.suite.ui.generic.template.js.AnnotationHelper.js of FE coding and adds logic which is implemented
+ * in the FE fragments to build the id of an action button.
+ *
+ * @param actionInfo - the information about the action for which a stable id should be created
+ * @returns the stable id for the action button
+ */
+function getStableIdForDatafieldActionButton(actionInfo) {
+    let stableId = '';
+    let datafieldStableId = '';
+    const facetStableId = '';
+    /* To be activated when this logic is applied to OP as well:
+    if (actionInfo.facet) {
+        facetStableId = actionInfo.facet.stableIdPart;
+    } */
+    if (actionInfo.dataField) {
+        datafieldStableId = actionInfo.dataField.stableIdPart;
+    }
+    stableId = (facetStableId === '' ? '' : facetStableId + '::') + 'action::' + datafieldStableId;
+    const suffix = getSuffixFromIconTabFilterKey(actionInfo.iconTabFilterKey);
+    if (suffix) {
+        stableId = stableId.concat(suffix);
+    }
+    if (actionInfo.isChart) {
+        stableId = stableId + '::chart';
+    }
+    // Note: Special handling of determining buttons is not part of the Fiori Elements AnnotationHelper function. This is handled in the corresponding xml fragments.
+    if (actionInfo.isDetermining) {
+        stableId = stableId + '::Determining';
+    }
+    return stableId;
+}
+//# sourceMappingURL=stableIdUtils.js.map

package/dist/specification/src/sync/v2/generate/stableIdUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stableIdUtils.js","sourceRoot":"","sources":["../../../../../../src/sync/v2/generate/stableIdUtils.ts"],"names":[],"mappings":"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"}

package/dist/specification/src/sync/v2/generate/utils.d.ts

@@ -1,12 +1,13 @@
 import type { Definition } from 'typescript-json-schema';
 import type { MetadataInstanceInterface } from '../../common/decoration/factory';
-import type { v2, PageTypeV2, PageTypeV4, FileData, GenerateAppSchemaParameters } from '@sap/ux-specification-types';
+import type { v2, PageTypeV2, PageTypeV4, FileData, PropertyMessage, GenerateAppSchemaParameters } from '@sap/ux-specification-types';
 import type { AnnotationTerm, EntitySet, EntityType } from '@sap-ux/vocabularies-types';
-import type { Chart, DataPoint, LineItem, SelectionFields } from '@sap-ux/vocabularies-types/vocabularies/UI';
+import type { Chart, DataPoint, DataFieldAbstractTypes, LineItem, SelectionFields } from '@sap-ux/vocabularies-types/vocabularies/UI';
 import type * as Edm from '@sap-ux/vocabularies-types/Edm';
 import type { EntityTypeAnnotations_UI } from '@sap-ux/vocabularies-types/vocabularies/UI_Edm';
 import { ActionTypeV2 } from '../types';
-import type { FacetBase } from '../../../../../types/src/common/types';
+import { FacetBase } from '../../../../../types/src/common/types';
+import type { ExtensionLogger } from '../../..';
 /**
  * Processes a LineItem record of type DataFieldForAction and DataFieldForIntentBasedNavigation during app schema generation.
  *
@@ -173,4 +174,63 @@ export declare function getUIAnnotationForEntitySet(generateParameters: Generate
     entityType?: Edm.EntityType;
     uIAnnotations?: EntityTypeAnnotations_UI;
 };
+/**
+ * Determine the LineItemAnnotation to be used for the LR.
+ * Reproduces logic from Fiori Elements LR implementation (function createWorkingContext in LR specific AnnotationHelper).
+ *
+ * @param uIAnnotations - The UI annotations for the entity type.
+ * @param settings - Optional settings object, typically a piece of the manifest, containing an optional annotationPath property.
+ * @param logger - Optional logger instance for logging warnings or errors.
+ * @returns The determined LineItem annotation or undefined if none is found.
+ */
+export declare function getLineItemAnnotation(uIAnnotations: EntityTypeAnnotations_UI, settings?: unknown, // an object (actually a piece of the manifest) possessing an optional property annotationPath which would define the path to the PresentationVariant
+logger?: ExtensionLogger): LineItem | undefined;
+/**
+ * Possible placements for a datafield in the ui.
+ */
+export declare enum DataFieldTarget {
+    Column = "Column",
+    Toolbar = "Toolbar",// This value represents the toolbar of a table or chart. Note that the ui5 control sap.m.Toolbar may also be used for other purposes (e.g. the footer of a page)
+    Footer = "Footer"
+}
+/**
+ * An instance of this type collects information about one data field within a line item.
+ *
+ * @property target - where the data field is placed in the ui
+ * @property stableIdPart - result of getStableIdPartFromDataField() for this data field, resp. '' if that function returned undefined (only happening if the service is the datafield is not modelled correctly)
+ * @property isAction - true if the data field is of type DataFieldForAction or DataFieldForIntentBasedNavigation
+ * @property description - the text of the data field (if any)
+ * @property dataField - the actual data field from the ui annotations
+ * @property message - possibly a message indicating an issue with this data field
+ */
+export type DataFieldInfo = {
+    target: DataFieldTarget;
+    stableIdPart: string;
+    isAction: boolean;
+    description: string;
+    dataField: DataFieldAbstractTypes;
+    message?: PropertyMessage;
+};
+/**
+ * An instance of this type collects information about the line item configured for a table.
+ *
+ * @property name - the name of the line item annotation (including qualifier if any)
+ * @property dataFieldInfos - information about each data field within the line item
+ */
+export type LineItemInfo = {
+    name: string;
+    dataFieldInfos: DataFieldInfo[];
+};
+/**
+ * Collects all relevant information about a given line item.
+ *
+ * @param lineItemName - the name of the line item annotation (including qualifier if any)
+ * @param lineItemDefinition - the definition of the line item
+ * @param entityType - the entity type the line item belongs to
+ * @param tableType - the table type the line item is used for
+ * @param generateParameters - the generation parameters of the process the information is collected for. Used for logging.
+ * @param isOP - whether the line item is for an object page
+ * @returns an instance of LineItemInfo containing the collected information
+ */
+export declare function getLineItemInfo(lineItemName: string, lineItemDefinition: AnnotationTerm<LineItem>, entityType: Edm.EntityType, tableType: string, generateParameters: GenerateAppSchemaParameters, isOP: boolean): LineItemInfo;
 //# sourceMappingURL=utils.d.ts.map

package/dist/specification/src/sync/v2/generate/utils.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../../src/sync/v2/generate/utils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../../../src/sync/v2/generate/utils.ts"],"names":[],"mappings":"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"}

package/dist/specification/src/sync/v2/generate/utils.js

@@ -3,6 +3,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DataFieldTarget = void 0;
 exports.handleActionRecord = handleActionRecord;
 exports.retrieveNameWithoutVocabularyFromVisualization = retrieveNameWithoutVocabularyFromVisualization;
 exports.addLineItemsType = addLineItemsType;
@@ -20,13 +21,18 @@ exports.isEntityUpdatable = isEntityUpdatable;
 exports.addStandardHeaderActions = addStandardHeaderActions;
 exports.addStandardFooterActionsOP = addStandardFooterActionsOP;
 exports.getUIAnnotationForEntitySet = getUIAnnotationForEntitySet;
+exports.getLineItemAnnotation = getLineItemAnnotation;
+exports.getLineItemInfo = getLineItemInfo;
 const ux_specification_types_1 = require("@sap/ux-specification-types");
 const common_1 = require("../../common");
 const decorators_1 = require("../../common/decoration/decorators");
 const path_1 = require("path");
 const xml_js_1 = require("xml-js");
 const types_1 = require("../types");
+const types_2 = require("../../../../../types/src/common/types");
 const extensionLogger_1 = require("../../../extensionLogger");
+const manifestPropertyUtils_1 = require("./manifestPropertyUtils");
+const stableIdUtils_1 = require("./stableIdUtils");
 const i18next_1 = __importDefault(require("i18next"));
 /**
  * Common function for enhancing the LineItems definition of app schema by custom columns.
@@ -152,12 +158,12 @@ function handleActionRecord(appSchema, actions, lineItemProps, actionType, recor
 /**
  * Returns the type of a column lineItem action.
  *
- * @param lineItemId - optional: in case of OP the parameter must be passed to distinguish the OP tables;
+ * @param {boolean} isOP - true if we deal with the usage of the line item on an OP, false otherwise;
  * @param {object} lineItemRecord - actual record of the line item collection
  * @param actionTypes - array of action types to be filled
  */
-function getColumnActionType(lineItemId, lineItemRecord, actionTypes) {
-    if (lineItemId !== ux_specification_types_1.DefinitionName.LineItems &&
+function getColumnActionType(isOP, lineItemRecord, actionTypes) {
+    if (isOP &&
         lineItemRecord.Inline === true &&
         (lineItemRecord.$Type === "com.sap.vocabularies.UI.v1.DataFieldForAction" /* UIAnnotationTypes.DataFieldForAction */ ||
             lineItemRecord.$Type === "com.sap.vocabularies.UI.v1.DataFieldForIntentBasedNavigation" /* UIAnnotationTypes.DataFieldForIntentBasedNavigation */)) {
@@ -175,10 +181,10 @@ function getColumnActionType(lineItemId, lineItemRecord, actionTypes) {
  * Returns the type of a lineItem action.
  *
  * @param {object} lineItemRecord - actual record of the line item collection
- * @param lineItemId - The identifier of the line item, used to distinguish between different line item collections.
+ * @param {boolean} isOP - true if we deal with the usage of the line item on an OP, false otherwise;
  * @returns {string[] | undefined } ActionTypeV2[] - action type(s) of the lineItem
  */
-function getActionType(lineItemRecord, lineItemId) {
+function getActionType(lineItemRecord, isOP) {
     const actionTypes = [];
     if (lineItemRecord.$Type !== "com.sap.vocabularies.UI.v1.DataFieldForAction" /* UIAnnotationTypes.DataFieldForAction */ &&
         lineItemRecord.$Type !== "com.sap.vocabularies.UI.v1.DataFieldForIntentBasedNavigation" /* UIAnnotationTypes.DataFieldForIntentBasedNavigation */) {
@@ -201,7 +207,7 @@ function getActionType(lineItemRecord, lineItemId) {
         lineItemRecord.$Type === "com.sap.vocabularies.UI.v1.DataFieldForIntentBasedNavigation" /* UIAnnotationTypes.DataFieldForIntentBasedNavigation */) {
         actionTypes.push(types_1.ActionTypeV2.FooterIntentBased);
     }
-    getColumnActionType(lineItemId, lineItemRecord, actionTypes);
+    getColumnActionType(isOP, lineItemRecord, actionTypes);
     return actionTypes;
 }
 /**
@@ -287,6 +293,7 @@ function retrieveNameWithoutVocabularyFromVisualization(annotationTerm, visualiz
  * @param customColumnRef - schema reference to custom column definition.
  */
 function addLineItemsType(isObjectPage, appSchema, lineItemAnnotation, entityType, lineItemId, customColumnRef) {
+    const isOP = !!lineItemId;
     // Add the correct lineItem definition
     lineItemId = lineItemId || ux_specification_types_1.DefinitionName.LineItems;
     const { actions, footerActions, lineItemPath } = (0, common_1.addCommonLineItemDefinitions)(isObjectPage, appSchema, lineItemAnnotation, entityType, lineItemId);
@@ -294,7 +301,7 @@ function addLineItemsType(isObjectPage, appSchema, lineItemAnnotation, entityTyp
         let recordIndex = 0;
         lineItemAnnotation.forEach((lineItemRecord) => {
             const lineItemProperties = { lineItemPath, lineItemRecord, lineItemId, entityType };
-            const actionTypes = getActionType(lineItemRecord, lineItemId);
+            const actionTypes = getActionType(lineItemRecord, isOP);
             if (actionTypes) {
                 actionTypes.forEach((actionType) => {
                     handleAnyAction(actionType, appSchema, actions, lineItemProperties, recordIndex, footerActions, lineItemId);
@@ -753,4 +760,181 @@ function getUIAnnotationForEntitySet(generateParameters) {
     }
     return { entityType, uIAnnotations };
 }
+/**
+ * Helper function for getLineItemAnnotation which determines the presentation variant to be used. The parameters of both functions have identical meaning.
+ *
+ * @param uIAnnotations - The UI annotations for the entity type.
+ * @param annotationPath - Optional annotation path to identify the specific presentation variant.
+ * @param logger - Optional logger instance for logging warnings or errors.
+ * @returns The determined PresentationVariant or undefined if none is found.
+ */
+function getPresentationVariantForLineItem(uIAnnotations, annotationPath, logger) {
+    let presentationVariant; // the presentation variant to be used to determine the LineItem
+    // Note: annotationPath (if it exists) contains the fully qualified annotation name (starting with UIVOCABULARYDOT) which would be a member of enum UIAnnotationTerms.
+    // Inside uiAnnotations the unqualified annotation names are used as keys. They can be found in enum FacetBase or obtained from the terms above by removing UIVOCABULARYDOT.
+    if (annotationPath) {
+        const isSPV = annotationPath.includes("com.sap.vocabularies.UI.v1.SelectionPresentationVariant" /* UIAnnotationTerms.SelectionPresentationVariant */);
+        const isPV = !isSPV && annotationPath.includes("com.sap.vocabularies.UI.v1.PresentationVariant" /* UIAnnotationTerms.PresentationVariant */);
+        if (isSPV || isPV) {
+            const accessor = annotationPath.replace(ux_specification_types_1.UIVOCABULARYDOT, '');
+            const uiAnnotation = uIAnnotations[accessor]; // the ui annotation specified by the annotationPath if it exists
+            if (uiAnnotation) {
+                if (isPV) {
+                    presentationVariant = uiAnnotation;
+                }
+                else {
+                    // SPV case
+                    presentationVariant = uiAnnotation[types_2.FacetBase.PresentationVariant];
+                    if (presentationVariant &&
+                        presentationVariant.fullyQualifiedName.includes(types_2.FacetBase.SelectionPresentationVariant)) {
+                        presentationVariant = uIAnnotations[types_2.FacetBase.PresentationVariant]; // inline presentation variants are ignored, use standard presentation variant instead
+                    }
+                }
+            }
+            else {
+                // annotationPath is pointing to a selection presentation variant or a presentation variant but the corresponding annotation does not exist
+                (0, extensionLogger_1.log)(logger, {
+                    severity: "warning" /* LogSeverity.Warning */,
+                    message: i18next_1.default.t('NOANNOTATIONFORPATH', { annotationPath: annotationPath })
+                });
+                // If the annotationPath has specified a non-existing selection presentation variant fall back to the standard presentation variant
+                if (isSPV) {
+                    presentationVariant = uIAnnotations[types_2.FacetBase.PresentationVariant];
+                }
+            }
+        }
+        else {
+            // annotationPath exists but does not point to a selection presentation variant or presentation variant (should point to a selection variant then)
+            presentationVariant = uIAnnotations[types_2.FacetBase.PresentationVariant]; // use standard presentation variant in this case
+        }
+    }
+    else {
+        presentationVariant = uIAnnotations[types_2.FacetBase.PresentationVariant];
+    }
+    return presentationVariant;
+}
+/**
+ * Determine the LineItemAnnotation to be used for the LR.
+ * Reproduces logic from Fiori Elements LR implementation (function createWorkingContext in LR specific AnnotationHelper).
+ *
+ * @param uIAnnotations - The UI annotations for the entity type.
+ * @param settings - Optional settings object, typically a piece of the manifest, containing an optional annotationPath property.
+ * @param logger - Optional logger instance for logging warnings or errors.
+ * @returns The determined LineItem annotation or undefined if none is found.
+ */
+function getLineItemAnnotation(uIAnnotations, settings, // an object (actually a piece of the manifest) possessing an optional property annotationPath which would define the path to the PresentationVariant
+logger // used in case an error/warning is detected while determining the result
+) {
+    if ((0, manifestPropertyUtils_1.hasPropertyTypeError)(settings, 'annotationPath', logger)) {
+        return undefined; // return undefined in case there is an error in the settings
+    }
+    const presentationVariant = getPresentationVariantForLineItem(uIAnnotations, settings?.['annotationPath'], logger); // the presentation variant to be used to determine the LineItem (if there is one)
+    // If a PV could be determined LineItem should be defined as a visualization of the PV.
+    const visualizations = presentationVariant?.Visualizations || [];
+    let lineItemName = ''; // the name that will be used to retrieve the LineItem from uiAnnotations
+    visualizations.some(function (visualization) {
+        lineItemName = retrieveNameWithoutVocabularyFromVisualization(types_2.FacetBase.LineItem, visualization);
+        return lineItemName; // end loop as soon as name of LineItem has been identified
+    });
+    // If the above logic did not identify a name for the LineItem then still the corresponding annotation (but without qualifier) will be used
+    lineItemName = lineItemName || types_2.FacetBase.LineItem;
+    const lineItem = uIAnnotations[lineItemName];
+    if (!lineItem) {
+        (0, extensionLogger_1.log)(logger, {
+            severity: "warning" /* LogSeverity.Warning */,
+            message: i18next_1.default.t('NOLINEITEMFORPATH', { annotationPath: lineItemName })
+        });
+    }
+    return lineItem;
+}
+/**
+ * Possible placements for a datafield in the ui.
+ */
+var DataFieldTarget;
+(function (DataFieldTarget) {
+    DataFieldTarget["Column"] = "Column";
+    DataFieldTarget["Toolbar"] = "Toolbar";
+    DataFieldTarget["Footer"] = "Footer";
+})(DataFieldTarget || (exports.DataFieldTarget = DataFieldTarget = {}));
+/**
+ * Determines the target placement of an action based on its type.
+ *
+ * @param actionType - The type of the action
+ * @returns The target placement for the action, or undefined if no target can be determined
+ */
+function getTargetFromActionType(actionType) {
+    switch (actionType) {
+        case types_1.ActionTypeV2.ToolBar:
+        case types_1.ActionTypeV2.ToolBarIntentBased: {
+            return DataFieldTarget.Toolbar;
+        }
+        case types_1.ActionTypeV2.Footer:
+        case types_1.ActionTypeV2.FooterIntentBased: {
+            return DataFieldTarget.Footer;
+        }
+        case types_1.ActionTypeV2.Column:
+        case types_1.ActionTypeV2.ColumnIntentBased: {
+            return DataFieldTarget.Column;
+        }
+        case types_1.ActionTypeV2.OPColumn: {
+            return undefined; // TODO: Revisit when this code should also be used for OP
+        }
+    }
+}
+/**
+ * Collects all relevant information about a given line item.
+ *
+ * @param lineItemName - the name of the line item annotation (including qualifier if any)
+ * @param lineItemDefinition - the definition of the line item
+ * @param entityType - the entity type the line item belongs to
+ * @param tableType - the table type the line item is used for
+ * @param generateParameters - the generation parameters of the process the information is collected for. Used for logging.
+ * @param isOP - whether the line item is for an object page
+ * @returns an instance of LineItemInfo containing the collected information
+ */
+function getLineItemInfo(lineItemName, lineItemDefinition, entityType, tableType, generateParameters, isOP) {
+    const dataFieldInfos = [];
+    lineItemDefinition.forEach((lineItemRecord) => {
+        const isDataField = lineItemRecord.$Type === "com.sap.vocabularies.UI.v1.DataField" /* UIAnnotationTypes.DataField */;
+        const stableIdPart = (0, stableIdUtils_1.getStableIdPartFromDataField)(lineItemRecord, generateParameters) || '';
+        const description = (0, common_1.getDataFieldDescription)(lineItemRecord, entityType);
+        const actionTypes = isDataField ? undefined : getActionType(lineItemRecord, isOP);
+        if (actionTypes) {
+            const message = lineItemRecord.Label
+                ? undefined
+                : {
+                    type: ux_specification_types_1.PropertyMessageType.Warning,
+                    text: i18next_1.default.t('NOLABELFORBUTTON')
+                };
+            actionTypes.forEach((actionType) => {
+                const target = getTargetFromActionType(actionType); // Note that actionType has been produced by getActionType, so undefined can be excluded
+                const dataFieldInfo = {
+                    isAction: true,
+                    target,
+                    stableIdPart,
+                    description,
+                    dataField: lineItemRecord
+                };
+                if (message) {
+                    dataFieldInfo.message = message;
+                }
+                dataFieldInfos.push(dataFieldInfo);
+            });
+        }
+        else {
+            const dataFieldInfo = {
+                isAction: false,
+                target: DataFieldTarget.Column,
+                stableIdPart,
+                description,
+                dataField: lineItemRecord
+            };
+            dataFieldInfos.push(dataFieldInfo);
+        }
+    });
+    return {
+        name: lineItemName,
+        dataFieldInfos: dataFieldInfos
+    };
+}
 //# sourceMappingURL=utils.js.map