@sapui5/types 1.115.1 → 1.117.0

package/types/sap.ui.dt.d.ts

@@ -1,3 +1,3 @@
-// For Library Version: 1.115.1
+// For Library Version: 1.117.0
 
 declare namespace sap {}

package/types/sap.ui.export.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.115.1
+// For Library Version: 1.117.0
 
 declare module "sap/ui/export/library" {
   /**
@@ -60,6 +60,12 @@ declare module "sap/ui/export/library" {
    * File types for document export.
    */
   export enum FileType {
+    /**
+     * @since 1.117
+     *
+     * Portable Document Format (PDF) file type.
+     */
+    PDF = "PDF",
     /**
      * Office Open XML - SpreadsheetML file type.
      */
@@ -255,13 +261,199 @@ declare module "sap/ui/export/ExportBase" {
 
   export interface ExportBase$BeforeExportEventParameters {}
 
+  export type ExportBase$BeforeExportEvent = Event<
+    ExportBase$BeforeExportEventParameters,
+    ExportBase
+  >;
+}
+
+declare module "sap/ui/export/ExportHandler" {
+  import EventProvider from "sap/ui/base/EventProvider";
+
+  import Metadata from "sap/ui/base/Metadata";
+
+  import Filter from "sap/ui/export/util/Filter";
+
+  import Event from "sap/ui/base/Event";
+
   /**
-   * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'ExportBase$BeforeExportEventParameters'
-   * in 1.115.1 and any later releases.
+   * @since 1.102
+   *
+   * The `sap.ui.export.ExportHandler` class allows you to export table data from an SAPUI5 application.
    */
-  export type $ExportBaseBeforeExportEventParameters = ExportBase$BeforeExportEventParameters;
+  export default class ExportHandler extends EventProvider {
+    /**
+     * Any export-related functionality is encapsulated in the `ExportHandler` that also stores user settings
+     * throughout the session.
+     */
+    constructor(
+      /**
+       * `ExportHandler` capabilities that define supported file types and features
+       */
+      mCapabilities: object
+    );
 
-  export type ExportBase$BeforeExportEvent = Event<ExportBase$BeforeExportEventParameters>;
+    /**
+     * Creates a new subclass of class sap.ui.export.ExportHandler with name `sClassName` and enriches it with
+     * the information contained in `oClassInfo`.
+     *
+     * `oClassInfo` might contain the same kind of information as described in {@link sap.ui.base.EventProvider.extend}.
+     *
+     * @returns Created class / constructor function
+     */
+    static extend<T extends Record<string, unknown>>(
+      /**
+       * Name of the class being created
+       */
+      sClassName: string,
+      /**
+       * Object literal with information about the class
+       */
+      oClassInfo?: sap.ClassInfo<T, ExportHandler>,
+      /**
+       * Constructor function for the metadata object; if not given, it defaults to the metadata implementation
+       * used by this class
+       */
+      FNMetaImpl?: Function
+    ): Function;
+    /**
+     * Returns a metadata object for class sap.ui.export.ExportHandler.
+     *
+     * @returns Metadata object describing this class
+     */
+    static getMetadata(): Metadata;
+    /**
+     * @since 1.102
+     *
+     * Attaches event handler `fnFunction` to the {@link sap.ui.export.ExportHandler#event:beforeExport} event
+     * of this `sap.ui.export.ExportHandler`.
+     *  When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
+     * otherwise it will be bound to this `sap.ui.export.ExportHandler` itself.
+     *  This event is fired just before the export process is started.
+     *
+     * @returns Reference to `this` in order to allow method chaining
+     */
+    attachBeforeExport(
+      /**
+       * An application-specific payload object that will be passed to the event handler along with the event
+       * object when firing the event
+       */
+      oData: object,
+      /**
+       * The function to be called when the event occurs
+       */
+      fnHandler: Function,
+      /**
+       * Context object to call the event handler with; defaults to this `sap.ui.export.ExportHandler` instance
+       * itself
+       */
+      oListener?: object
+    ): this;
+    /**
+     * @since 1.102
+     *
+     * Attaches event handler `fnFunction` to the {@link sap.ui.export.ExportHandler#event:beforeExport} event
+     * of this `sap.ui.export.ExportHandler`.
+     *  When called, the context of the event handler (its `this`) will be bound to `oListener` if specified,
+     * otherwise it will be bound to this `sap.ui.export.ExportHandler` itself.
+     *  This event is fired just before the export process is started.
+     *
+     * @returns Reference to `this` in order to allow method chaining
+     */
+    attachBeforeExport(
+      /**
+       * The function to be called when the event occurs
+       */
+      fnHandler: Function,
+      /**
+       * Context object to call the event handler with; defaults to this `sap.ui.export.ExportHandler` instance
+       * itself
+       */
+      oListener?: object
+    ): this;
+    /**
+     * Cleans up the internal structures and removes all event handlers.
+     *
+     * The object must not be used anymore after destroy was called.
+     * See:
+     * 	sap.ui.base.Object#destroy
+     */
+    destroy(): void;
+    /**
+     * @since 1.102
+     *
+     * Detaches event handler `fnFunction` from the {@link sap.ui.export.ExportHandler#event:beforeExport} event
+     * of this `sap.ui.export.ExportHandler`.
+     *  The passed function and listener object must match the ones used for event registration.
+     *
+     * @returns Reference to `this` in order to allow method chaining
+     */
+    detachBeforeExport(
+      /**
+       * The function to be called when the event occurs
+       */
+      fnHandler: Function,
+      /**
+       * Context object on which the given function had to be called
+       */
+      oListener?: object
+    ): this;
+    /**
+     * @since 1.102
+     *
+     * Exports the data as defined via parameter. The function returns a `Promise` that will be resolved after
+     * the export process has been finished. In case of an error, its message will be shown in a `Dialog`, and
+     * the `Promise` will be rejected.
+     *
+     * @returns A `Promise` that gets resolved after the export process has been finished
+     */
+    export(
+      /**
+       * Export settings that are used for the export
+       */
+      mExportSettings: object
+    ): Promise<any>;
+    /**
+     * @since 1.102
+     *
+     * Exports the data as defined by the user. This function will show an export settings dialog where the
+     * user can define certain settings that influence the output of the export functionality.
+     *
+     * @returns A `Promise` that resolves once the data has been exported
+     */
+    exportAs(
+      /**
+       * General export settings containing `workbook` and `dataSource` information
+       */
+      oSettings: object,
+      /**
+       * Resolves the label for a particular column that is not directly contained in the export settings
+       */
+      fnResolveColumnLabel?: Function
+    ): Promise<any>;
+  }
+
+  export interface ExportHandler$BeforeExportEventParameters {
+    /**
+     * Contains export-related configuration
+     */
+    exportSettings?: object;
+
+    /**
+     * User-specific settings from the Export As dialog
+     */
+    userExportSettings?: object;
+
+    /**
+     * Array of filter settings for the exported data
+     */
+    filterSettings?: Filter[];
+  }
+
+  export type ExportHandler$BeforeExportEvent = Event<
+    ExportHandler$BeforeExportEventParameters,
+    ExportHandler
+  >;
 }
 
 declare module "sap/ui/export/Spreadsheet" {
@@ -680,13 +872,10 @@ declare module "sap/ui/export/Spreadsheet" {
 
   export interface Spreadsheet$BeforeSaveEventParameters {}
 
-  /**
-   * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'Spreadsheet$BeforeSaveEventParameters'
-   * in 1.115.1 and any later releases.
-   */
-  export type $SpreadsheetBeforeSaveEventParameters = Spreadsheet$BeforeSaveEventParameters;
-
-  export type Spreadsheet$BeforeSaveEvent = Event<Spreadsheet$BeforeSaveEventParameters>;
+  export type Spreadsheet$BeforeSaveEvent = Event<
+    Spreadsheet$BeforeSaveEventParameters,
+    Spreadsheet
+  >;
 }
 
 declare module "sap/ui/export/util/Filter" {

package/types/sap.ui.fl.d.ts

@@ -1,4 +1,4 @@
-// For Library Version: 1.115.1
+// For Library Version: 1.117.0
 
 declare module "sap/ui/fl/library" {}
 
@@ -744,17 +744,6 @@ declare module "sap/ui/fl/variants/VariantManagement" {
      * @returns Value of property `inErrorState`
      */
     getInErrorState(): boolean;
-    /**
-     * Gets current value of property {@link #getManualVariantKey manualVariantKey}.
-     *
-     * If set to `true`, the key for a vendor variant will be added manually.
-     *   **Note:** This flag is only used internally.
-     *
-     * Default value is `false`.
-     *
-     * @returns Value of property `manualVariantKey`
-     */
-    getManualVariantKey(): boolean;
     /**
      * @since 1.109
      *
@@ -964,24 +953,6 @@ declare module "sap/ui/fl/variants/VariantManagement" {
        */
       bInErrorState?: boolean
     ): this;
-    /**
-     * Sets a new value for property {@link #getManualVariantKey manualVariantKey}.
-     *
-     * If set to `true`, the key for a vendor variant will be added manually.
-     *   **Note:** This flag is only used internally.
-     *
-     * When called with a value of `null` or `undefined`, the default value of the property will be restored.
-     *
-     * Default value is `false`.
-     *
-     * @returns Reference to `this` in order to allow method chaining
-     */
-    setManualVariantKey(
-      /**
-       * New value for property `manualVariantKey`
-       */
-      bManualVariantKey?: boolean
-    ): this;
     /**
      * @since 1.109
      *
@@ -1124,12 +1095,6 @@ declare module "sap/ui/fl/variants/VariantManagement" {
      */
     showSetAsDefault?: boolean | PropertyBindingInfo | `{${string}}`;
 
-    /**
-     * If set to `true`, the key for a vendor variant will be added manually.
-     *   **Note:** This flag is only used internally.
-     */
-    manualVariantKey?: boolean | PropertyBindingInfo | `{${string}}`;
-
     /**
      * Indicates that the control is in error state. If set to `true`, an error message will be displayed whenever
      * the variant is opened.
@@ -1194,7 +1159,7 @@ declare module "sap/ui/fl/variants/VariantManagement" {
      * This event is fired when the Save View dialog or the Save As dialog is closed with the
      * save button.
      */
-    save?: (oEvent: Event<VariantManagement$SaveEventParameters>) => void;
+    save?: (oEvent: VariantManagement$SaveEvent) => void;
 
     /**
      * This event is fired when users presses the cancel button inside Save As dialog.
@@ -1204,33 +1169,27 @@ declare module "sap/ui/fl/variants/VariantManagement" {
     /**
      * This event is fired when users apply changes to variants in the Manage Views dialog.
      */
-    manage?: (oEvent: Event<VariantManagement$ManageEventParameters>) => void;
+    manage?: (oEvent: VariantManagement$ManageEvent) => void;
 
     /**
      * This event is fired when a new variant is selected.
      */
-    select?: (oEvent: Event<VariantManagement$SelectEventParameters>) => void;
+    select?: (oEvent: VariantManagement$SelectEvent) => void;
   }
 
   export interface VariantManagement$CancelEventParameters {}
 
-  /**
-   * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'VariantManagement$CancelEventParameters'
-   * in 1.115.1 and any later releases.
-   */
-  export type $VariantManagementCancelEventParameters = VariantManagement$CancelEventParameters;
-
-  export type VariantManagement$CancelEvent = Event<VariantManagement$CancelEventParameters>;
+  export type VariantManagement$CancelEvent = Event<
+    VariantManagement$CancelEventParameters,
+    VariantManagement
+  >;
 
   export interface VariantManagement$InitializedEventParameters {}
 
-  /**
-   * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'VariantManagement$InitializedEventParameters'
-   * in 1.115.1 and any later releases.
-   */
-  export type $VariantManagementInitializedEventParameters = VariantManagement$InitializedEventParameters;
-
-  export type VariantManagement$InitializedEvent = Event<VariantManagement$InitializedEventParameters>;
+  export type VariantManagement$InitializedEvent = Event<
+    VariantManagement$InitializedEventParameters,
+    VariantManagement
+  >;
 
   export interface VariantManagement$ManageEventParameters {
     /**
@@ -1255,13 +1214,10 @@ declare module "sap/ui/fl/variants/VariantManagement" {
     def?: string;
   }
 
-  /**
-   * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'VariantManagement$ManageEventParameters'
-   * in 1.115.1 and any later releases.
-   */
-  export type $VariantManagementManageEventParameters = VariantManagement$ManageEventParameters;
-
-  export type VariantManagement$ManageEvent = Event<VariantManagement$ManageEventParameters>;
+  export type VariantManagement$ManageEvent = Event<
+    VariantManagement$ManageEventParameters,
+    VariantManagement
+  >;
 
   export interface VariantManagement$SaveEventParameters {
     /**
@@ -1302,13 +1258,10 @@ declare module "sap/ui/fl/variants/VariantManagement" {
     tile?: boolean;
   }
 
-  /**
-   * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'VariantManagement$SaveEventParameters'
-   * in 1.115.1 and any later releases.
-   */
-  export type $VariantManagementSaveEventParameters = VariantManagement$SaveEventParameters;
-
-  export type VariantManagement$SaveEvent = Event<VariantManagement$SaveEventParameters>;
+  export type VariantManagement$SaveEvent = Event<
+    VariantManagement$SaveEventParameters,
+    VariantManagement
+  >;
 
   export interface VariantManagement$SelectEventParameters {
     /**
@@ -1317,13 +1270,10 @@ declare module "sap/ui/fl/variants/VariantManagement" {
     key?: string;
   }
 
-  /**
-   * @deprecated (since 1.115.1) - This name was introduced in 1.115.0, but will be 'VariantManagement$SelectEventParameters'
-   * in 1.115.1 and any later releases.
-   */
-  export type $VariantManagementSelectEventParameters = VariantManagement$SelectEventParameters;
-
-  export type VariantManagement$SelectEvent = Event<VariantManagement$SelectEventParameters>;
+  export type VariantManagement$SelectEvent = Event<
+    VariantManagement$SelectEventParameters,
+    VariantManagement
+  >;
 }
 
 declare module "sap/ui/fl/write/_internal/fieldExtensibility/ABAPExtensibilityVariant" {