@sapui5/ts-types 1.103.0 → 1.104.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (65) hide show
  1. package/package.json +1 -1
  2. package/types/index.d.ts +3 -0
  3. package/types/sap.apf.d.ts +1 -1
  4. package/types/sap.ca.ui.d.ts +1 -1
  5. package/types/sap.chart.d.ts +1 -1
  6. package/types/sap.collaboration.d.ts +1 -1
  7. package/types/sap.esh.search.ui.d.ts +1 -1
  8. package/types/sap.f.d.ts +157 -1
  9. package/types/sap.fe.common.d.ts +1 -1
  10. package/types/sap.fe.core.d.ts +1166 -29
  11. package/types/sap.fe.macros.d.ts +627 -52
  12. package/types/sap.fe.navigation.d.ts +1391 -1
  13. package/types/sap.fe.templates.d.ts +161 -2
  14. package/types/sap.fe.test.d.ts +12 -1
  15. package/types/sap.feedback.ui.d.ts +1 -1
  16. package/types/sap.gantt.d.ts +7 -4
  17. package/types/sap.insights.d.ts +1 -1
  18. package/types/sap.landvisz.d.ts +1 -1
  19. package/types/sap.m.d.ts +1870 -57
  20. package/types/sap.makit.d.ts +1 -1
  21. package/types/sap.me.d.ts +1 -1
  22. package/types/sap.ndc.d.ts +1 -1
  23. package/types/sap.ovp.d.ts +1 -1
  24. package/types/sap.rules.ui.d.ts +1 -1
  25. package/types/sap.sac.df.d.ts +2 -2
  26. package/types/sap.sac.grid.d.ts +1 -1
  27. package/types/sap.suite.ui.commons.d.ts +498 -18
  28. package/types/sap.suite.ui.generic.template.d.ts +32 -25
  29. package/types/sap.suite.ui.microchart.d.ts +1 -1
  30. package/types/sap.tnt.d.ts +1 -1
  31. package/types/sap.ui.codeeditor.d.ts +1 -1
  32. package/types/sap.ui.commons.d.ts +1 -1
  33. package/types/sap.ui.comp.d.ts +1128 -243
  34. package/types/sap.ui.core.d.ts +111 -20
  35. package/types/sap.ui.dt.d.ts +1 -1
  36. package/types/sap.ui.export.d.ts +3 -3
  37. package/types/sap.ui.fl.d.ts +1 -1
  38. package/types/sap.ui.generic.app.d.ts +1 -1
  39. package/types/sap.ui.generic.template.d.ts +1 -1
  40. package/types/sap.ui.integration.d.ts +41 -62
  41. package/types/sap.ui.layout.d.ts +1 -1
  42. package/types/sap.ui.mdc.d.ts +1 -1
  43. package/types/sap.ui.richtexteditor.d.ts +1 -1
  44. package/types/sap.ui.rta.d.ts +3 -1
  45. package/types/sap.ui.suite.d.ts +1 -1
  46. package/types/sap.ui.support.d.ts +1 -1
  47. package/types/sap.ui.table.d.ts +1 -1
  48. package/types/sap.ui.testrecorder.d.ts +1 -1
  49. package/types/sap.ui.unified.d.ts +81 -1
  50. package/types/sap.ui.ux3.d.ts +1 -1
  51. package/types/sap.ui.vbm.d.ts +1 -161
  52. package/types/sap.ui.vk.d.ts +59 -1
  53. package/types/sap.ui.vtm.d.ts +1 -1
  54. package/types/sap.ui.webc.common.d.ts +118 -0
  55. package/types/sap.ui.webc.fiori.d.ts +13298 -0
  56. package/types/sap.ui.webc.main.d.ts +39842 -0
  57. package/types/sap.uiext.inbox.d.ts +1 -1
  58. package/types/sap.ushell.d.ts +32 -20
  59. package/types/sap.ushell_abap.d.ts +1 -1
  60. package/types/sap.uxap.d.ts +1 -1
  61. package/types/sap.viz.d.ts +1 -1
  62. package/types/sap.webanalytics.core.d.ts +1 -1
  63. package/types/sap.zen.commons.d.ts +1 -1
  64. package/types/sap.zen.crosstab.d.ts +1 -1
  65. package/types/sap.zen.dsh.d.ts +1 -1
@@ -1,4 +1,4 @@
1
- // For Library Version: 1.103.0
1
+ // For Library Version: 1.104.1
2
2
 
3
3
  declare namespace sap {
4
4
  /**
@@ -10,45 +10,933 @@ declare namespace sap {
10
10
  */
11
11
  namespace core {
12
12
  /**
13
- * Main class for components used for an application in SAP Fiori elements.
14
- *
15
- * Application developers using the templates and building blocks provided by SAP Fiori elements should
16
- * create their apps by extending this component. This ensures that all the necessary services that you
17
- * need for the building blocks and templates to work properly are started.
18
- *
19
- * When you use sap.fe.core.AppComponent as the base component, you also need to use a rootView. SAP Fiori
20
- * elements provides two options:
21
- * - sap.fe.templates.RootContainer.view.NavContainer when using sap.m.routing.Router
22
- * - sap.fe.templates.RootContainer.view.Fcl when using sap.f.routing.Router (FCL use case)
13
+ * Collection of controller extensions used internally in SAP Fiori elements exposing a method that you
14
+ * can override to allow more flexibility.
23
15
  */
24
- export const AppComponent: undefined;
16
+ namespace controllerextensions {
17
+ /**
18
+ * @SINCE 1.90.0
19
+ *
20
+ *
21
+ * A controller extension offering hooks into the edit flow of the application
22
+ */
23
+ class EditFlow extends sap.ui.core.mvc.ControllerExtension {
24
+ constructor();
25
25
 
26
- /**
27
- * @SINCE 1.90.0
28
- *
29
- * Internal base controller class for SAP Fiori elements application.
30
- *
31
- * If you want to extend a base controller for your custom page, please use for sap.fe.core.PageController.
32
- */
33
- export const BaseController: undefined;
26
+ /**
27
+ * @SINCE 1.90.0
28
+ *
29
+ *
30
+ * Submit the current set of changes and navigate back.
31
+ *
32
+ * @returns Promise resolves once the changes have been saved
33
+ */
34
+ applyDocument(
35
+ /**
36
+ * Context of the document
37
+ */
38
+ oContext: object
39
+ ): Promise<any>;
40
+ /**
41
+ * @SINCE 1.90.0
42
+ *
43
+ *
44
+ * Discard the editable document.
45
+ *
46
+ * @returns Promise resolves once editable document has been discarded
47
+ */
48
+ cancelDocument(
49
+ /**
50
+ * Context of the editable document
51
+ */
52
+ oContext: /* was: sap.fe.core.V4Context */ any,
53
+ /**
54
+ * Can contain the following attributes:
55
+ */
56
+ mParameters: {
57
+ /**
58
+ * This is the control used to open the discard popover
59
+ */
60
+ control: object;
61
+ /**
62
+ * Optional, supresses the discard popover and allows custom handling
63
+ */
64
+ skipDiscardPopover?: boolean;
65
+ }
66
+ ): Promise<any>;
67
+ /**
68
+ * @SINCE 1.90.0
69
+ *
70
+ *
71
+ * Creates a new document.
72
+ *
73
+ * @returns Promise resolves once the object has been created
74
+ */
75
+ createDocument(
76
+ /**
77
+ * ODataListBinding object or the binding path for a temporary list binding
78
+ */
79
+ vListBinding: string | sap.ui.model.odata.v4.ODataListBinding,
80
+ /**
81
+ * Contains the following attributes:
82
+ */
83
+ mInParameters: {
84
+ /**
85
+ * Specifies if the new entry should be created at the top or bottom of a table in case of creationMode
86
+ * 'Inline'
87
+ */
88
+ createAtEnd?: boolean;
89
+ /**
90
+ * The creation mode using one of the following:
91
+ * NewPage - the created document is shown in a new page, depending on whether metadata
92
+ * 'Sync', 'Async' or 'Deferred' is used
93
+ * Inline - The creation is done inline (in a table)
94
+ * External - The creation is done in a different application specified via the parameter
95
+ * 'outbound'
96
+ */
97
+ creationMode: string;
98
+ /**
99
+ * The navigation target where the document is created in case of creationMode 'External'
100
+ */
101
+ outbound?: string;
102
+ }
103
+ ): Promise<any>;
104
+ /**
105
+ * @SINCE 1.90.0
106
+ *
107
+ *
108
+ * Deletes the document.
109
+ *
110
+ * @returns Promise resolves once document has been deleted
111
+ */
112
+ deleteDocument(
113
+ /**
114
+ * Context of the document
115
+ */
116
+ oContext: sap.ui.model.odata.v4.Context,
117
+ /**
118
+ * Can contain the following attributes:
119
+ */
120
+ mInParameters: {
121
+ /**
122
+ * Description of the object being deleted
123
+ */
124
+ description: string;
125
+ /**
126
+ * Title of the object being deleted
127
+ */
128
+ title: string;
129
+ }
130
+ ): Promise<any>;
131
+ /**
132
+ * @SINCE 1.90.0
133
+ *
134
+ *
135
+ * Creates a draft document for an existing active document.
136
+ *
137
+ * @returns Promise resolves once the editable document is available
138
+ */
139
+ editDocument(
140
+ /**
141
+ * Context of the active document
142
+ */
143
+ oContext: /* was: sap.fe.core.V4Context */ any
144
+ ): Promise<any>;
145
+ /**
146
+ * @SINCE 1.90.0
147
+ *
148
+ * Invokes an action (bound or unbound) and tracks the changes so that other pages can be refreshed and
149
+ * show the updated data upon navigation.
150
+ *
151
+ * @returns A promise once the action has been invoked
152
+ */
153
+ invokeAction(
154
+ /**
155
+ * The name of the action to be called
156
+ */
157
+ sActionName: string,
158
+ /**
159
+ * Contains the following attributes:
160
+ */
161
+ mInParameters?: {
162
+ /**
163
+ * For a bound action, a context or an array with contexts for which the action is to be called must be
164
+ * provided
165
+ */
166
+ contexts?:
167
+ | sap.ui.model.odata.v4.Context
168
+ | sap.ui.model.odata.v4.Context[];
169
+ /**
170
+ * Mode how actions are to be called: 'ChangeSet' to put all action calls into one changeset, 'Isolated'
171
+ * to put them into separate changesets
172
+ */
173
+ invocationGrouping?: string;
174
+ /**
175
+ * A human-readable label for the action. This is needed in case the action has a parameter and a parameter
176
+ * dialog is shown to the user. The label will be used for the title of the dialog and for the confirmation
177
+ * button
178
+ */
179
+ label?: string;
180
+ /**
181
+ * For an unbound action, an instance of an OData V4 model must be provided
182
+ */
183
+ model?: sap.ui.model.odata.v4.ODataModel;
184
+ /**
185
+ * Boolean value indicating whether navigation is required after the action has been executed. Navigation
186
+ * takes place to the context returned by the action
187
+ */
188
+ requiresNavigation?: boolean;
189
+ }
190
+ ): Promise<any>;
191
+ /**
192
+ * @SINCE 1.98.0
193
+ *
194
+ *
195
+ * This function can be used to intercept the 'Create' action. You can execute custom coding in this function.
196
+ * The framework waits for the returned promise to be resolved before continuing the 'Create' action.
197
+ * If you reject the promise, the 'Create' action is stopped.
198
+ * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
199
+ * The override execution is: {@link sap.ui.core.mvc.OverrideExecution.After}.
200
+ *
201
+ *
202
+ * @returns A promise to be returned by the overridden method. If resolved, the 'Create' action is triggered.
203
+ * If rejected, the 'Create' action is not triggered.
204
+ */
205
+ onBeforeCreate(
206
+ /**
207
+ * Object containing the parameters passed to onBeforeCreate
208
+ */
209
+ mParameters?: {
210
+ /**
211
+ * Path pointing to the context on which Create action is triggered
212
+ */
213
+ contextPath?: string;
214
+ /**
215
+ * Array of values that are filled in the Action Parameter Dialog
216
+ */
217
+ createParameters?: any[];
218
+ }
219
+ ): Promise<any>;
220
+ /**
221
+ * @SINCE 1.98.0
222
+ *
223
+ *
224
+ * This function can be used to intercept the 'Delete' action. You can execute custom coding in this function.
225
+ * The framework waits for the returned promise to be resolved before continuing the 'Delete' action.
226
+ * If you reject the promise, the 'Delete' action is stopped.
227
+ * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
228
+ * The override execution is: {@link sap.ui.core.mvc.OverrideExecution.After}.
229
+ *
230
+ *
231
+ * @returns A promise to be returned by the overridden method. If resolved, the 'Delete' action is triggered.
232
+ * If rejected, the 'Delete' action is not triggered.
233
+ */
234
+ onBeforeDelete(
235
+ /**
236
+ * Object containing the parameters passed to onBeforeDelete
237
+ */
238
+ mParameters?: {
239
+ /**
240
+ * An array of contexts that are going to be deleted
241
+ */
242
+ contexts?: sap.ui.model.odata.v4.Context[];
243
+ }
244
+ ): Promise<any>;
245
+ /**
246
+ * @SINCE 1.98.0
247
+ *
248
+ *
249
+ * This function can be used to intercept the 'Discard' action. You can execute custom coding in this function.
250
+ * The framework waits for the returned promise to be resolved before continuing the 'Discard' action.
251
+ * If you reject the promise, the 'Discard' action is stopped and the user stays in edit mode.
252
+ * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
253
+ * The override execution is: {@link sap.ui.core.mvc.OverrideExecution.After}.
254
+ *
255
+ *
256
+ * @returns A promise to be returned by the overridden method. If resolved, the 'Discard' action is triggered.
257
+ * If rejected, the 'Discard' action is not triggered and the user stays in edit mode.
258
+ */
259
+ onBeforeDiscard(
260
+ /**
261
+ * Object containing the parameters passed to onBeforeDiscard
262
+ */
263
+ mParameters?: {
264
+ /**
265
+ * Page context that is going to be discarded.
266
+ */
267
+ context?: sap.ui.model.odata.v4.Context;
268
+ }
269
+ ): Promise<any>;
270
+ /**
271
+ * @SINCE 1.98.0
272
+ *
273
+ *
274
+ * This function can be used to intercept the 'Edit' action. You can execute custom coding in this function.
275
+ * The framework waits for the returned promise to be resolved before continuing the 'Edit' action.
276
+ * If you reject the promise, the 'Edit' action is stopped and the user stays in display mode.
277
+ * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
278
+ * The override execution is: {@link sap.ui.core.mvc.OverrideExecution.After}.
279
+ *
280
+ *
281
+ * @returns A promise to be returned by the overridden method. If resolved, the 'Edit' action is triggered.
282
+ * If rejected, the 'Edit' action is not triggered and the user stays in display mode.
283
+ */
284
+ onBeforeEdit(
285
+ /**
286
+ * Object containing the parameters passed to onBeforeEdit
287
+ */
288
+ mParameters?: {
289
+ /**
290
+ * Page context that is going to be edited.
291
+ */
292
+ context?: sap.ui.model.odata.v4.Context;
293
+ }
294
+ ): Promise<any>;
295
+ /**
296
+ * @SINCE 1.90.0
297
+ *
298
+ *
299
+ * This function can be used to intercept the 'Save' action. You can execute custom coding in this function.
300
+ * The framework waits for the returned promise to be resolved before continuing the 'Save' action.
301
+ * If you reject the promise, the 'Save' action is stopped and the user stays in edit mode.
302
+ * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
303
+ * The override execution is: {@link sap.ui.core.mvc.OverrideExecution.After}.
304
+ *
305
+ *
306
+ * @returns A promise to be returned by the overridden method. If resolved, the 'Save' action is triggered.
307
+ * If rejected, the 'Save' action is not triggered and the user stays in edit mode.
308
+ */
309
+ onBeforeSave(
310
+ /**
311
+ * Object containing the parameters passed to onBeforeSave
312
+ */
313
+ mParameters?: {
314
+ /**
315
+ * Page context that is going to be saved.
316
+ */
317
+ context?: sap.ui.model.odata.v4.Context;
318
+ }
319
+ ): Promise<any>;
320
+ /**
321
+ * @SINCE 1.90.0
322
+ *
323
+ *
324
+ * Saves a new document after checking it.
325
+ *
326
+ * @returns Promise resolves once save is complete
327
+ */
328
+ saveDocument(
329
+ /**
330
+ * Context of the editable document
331
+ */
332
+ oContext: /* was: sap.fe.core.V4Context */ any,
333
+ /**
334
+ * undefined
335
+ */
336
+ mParameters: any
337
+ ): Promise<any>;
338
+ /**
339
+ * @SINCE 1.90.0
340
+ *
341
+ * @EXPERIMENTAL (since 1.90.0
342
+ * )
343
+ *
344
+ * Secured execution of the given function. Ensures that the function is only executed when certain conditions
345
+ * are fulfilled.
346
+ *
347
+ * @returns A promise that is rejected if the execution is prohibited and resolved by the promise returned
348
+ * by the fnFunction.
349
+ */
350
+ securedExecution(
351
+ /**
352
+ * The function to be executed. Should return a promise that is settled after completion of the execution.
353
+ * If nothing is returned, immediate completion is assumed.
354
+ */
355
+ fnFunction: Function,
356
+ /**
357
+ * Definitions of the preconditions to be checked before execution
358
+ */
359
+ mParameters?: {
360
+ /**
361
+ * Defines the busy indicator
362
+ */
363
+ busy?: {
364
+ /**
365
+ * Executes function only if application isn't busy.
366
+ */
367
+ check?: boolean;
368
+ /**
369
+ * Triggers a busy indicator when the function is executed.
370
+ */
371
+ set?: boolean;
372
+ };
373
+ /**
374
+ * This operation updates the current document without using the bound model and context. As a result, the
375
+ * draft status is updated if a draft document exists, and the user has to confirm the cancellation of the
376
+ * editing process.
377
+ */
378
+ updatesDocument?: boolean;
379
+ }
380
+ ): Promise<any>;
381
+ /**
382
+ * @SINCE 1.90.0
383
+ *
384
+ *
385
+ * Updates the draft status and displays the error messages if there are errors during an update.
386
+ *
387
+ * @returns Promise resolves once draft status has been updated
388
+ */
389
+ updateDocument(
390
+ /**
391
+ * Context of the updated field
392
+ */
393
+ oContext: object,
394
+ /**
395
+ * Promise to determine when the update operation is completed. The promise should be resolved when the
396
+ * update operation is completed, so the draft status can be updated.
397
+ */
398
+ oPromise: Promise<any>
399
+ ): undefined | Promise<any>;
400
+ }
401
+ /**
402
+ * @SINCE 1.86.0
403
+ *
404
+ *
405
+ * Controller extension providing hooks for intent-based navigation
406
+ */
407
+ class IntentBasedNavigation extends sap.ui.core.mvc
408
+ .ControllerExtension {
409
+ constructor();
34
410
 
35
- /**
36
- * @SINCE 1.79.0
37
- *
38
- * Common Extension API for all pages of SAP Fiori elements for OData V4.
39
- */
40
- export const ExtensionAPI: undefined;
411
+ /**
412
+ * @SINCE 1.86.0
413
+ *
414
+ *
415
+ * Provides a hook to customize the {@link sap.fe.navigation.SelectionVariant} related to the intent-based
416
+ * navigation.
417
+ */
418
+ adaptNavigationContext(
419
+ /**
420
+ * SelectionVariant provided by SAP Fiori elements.
421
+ */
422
+ oSelectionVariant: /* was: sap.fe.core.SelectionVariant */ any,
423
+ /**
424
+ * Object containing intent-based navigation-related info
425
+ */
426
+ oNavigationInfo: {
427
+ /**
428
+ * Action related to the intent
429
+ */
430
+ action: string;
431
+ /**
432
+ * Semantic object related to the intent
433
+ */
434
+ semanticObject: string;
435
+ }
436
+ ): void;
437
+ /**
438
+ * @SINCE 1.86.0
439
+ *
440
+ *
441
+ * Navigates to an intent defined by an outbound definition in the manifest.
442
+ */
443
+ navigateOutbound(
444
+ /**
445
+ * Identifier to locate the outbound definition in the manifest.
446
+ * This provides the semantic object and action for the intent-based navigation.
447
+ * Additionally, the outbound definition can be used to provide parameters for intent-based navigation.
448
+ * See {@link topic:be0cf40f61184b358b5faedaec98b2da Descriptor for Applications, Components, and Libraries}
449
+ * for more information.
450
+ */
451
+ sOutbound: string,
452
+ /**
453
+ * Optional map containing key/value pairs to be passed to the intent.
454
+ * If mNavigationParameters are provided, the parameters provided in the outbound definition of the manifest
455
+ * are ignored.
456
+ */
457
+ mNavigationParameters: object
458
+ ): void;
459
+ }
460
+ /**
461
+ * @SINCE 1.90.0
462
+ *
463
+ * @EXPERIMENTAL (since 1.90.0
464
+ * )
465
+ *
466
+ * A controller extension offering message handling.
467
+ */
468
+ class MessageHandler extends sap.ui.core.mvc.ControllerExtension {
469
+ constructor();
470
+
471
+ /**
472
+ * @SINCE 1.90.0
473
+ *
474
+ * @EXPERIMENTAL (since 1.90.0
475
+ * )
476
+ *
477
+ * Shows a message dialog with transition messages if there are any.
478
+ * The message dialog is shown as a modal dialog. Once the user confirms the dialog, all transition messages
479
+ * are removed from the message model. If there is more than one message, a list of messages is shown. The
480
+ * user
481
+ * can filter on message types and can display details as well as the long text. If there is one message,
482
+ * the dialog immediately shows the details of the message. If there is just one success message, a message
483
+ * toast is shown instead.
484
+ *
485
+ * @returns A promise that is resolved once the user closes the dialog. If there are no messages
486
+ * to be shown, the promise is resolved immediately
487
+ */
488
+ showMessageDialog(): Promise<any>;
489
+ }
490
+ /**
491
+ * @SINCE 1.94.0
492
+ *
493
+ *
494
+ * Controller extension providing hooks for the navigation using paginators
495
+ */
496
+ class Paginator extends sap.ui.core.mvc.ControllerExtension {
497
+ constructor();
41
498
 
499
+ /**
500
+ * @SINCE 1.94.0
501
+ *
502
+ *
503
+ * Initiates the paginator control.
504
+ */
505
+ initialize(
506
+ /**
507
+ * ODataListBinding object
508
+ */
509
+ oBinding: any,
510
+ /**
511
+ * Current context where the navigation is initiated
512
+ */
513
+ oContext: sap.ui.model.odata.v4.Context
514
+ ): void;
515
+ /**
516
+ * @SINCE 1.94.0
517
+ *
518
+ *
519
+ * Returns the updated context after the paginator operation.
520
+ */
521
+ onContextUpdate(
522
+ /**
523
+ * Final context returned after the paginator action
524
+ */
525
+ oContext: sap.ui.model.odata.v4.Context
526
+ ): void;
527
+ }
528
+ /**
529
+ * @SINCE 1.86.0
530
+ *
531
+ *
532
+ * A controller extension offering hooks into the routing flow of the application
533
+ */
534
+ class Routing extends sap.ui.core.mvc.ControllerExtension {
535
+ constructor();
536
+
537
+ /**
538
+ * @SINCE 1.90.0
539
+ *
540
+ *
541
+ * Allows navigation to a specific context.
542
+ */
543
+ navigate(
544
+ /**
545
+ * Object containing the context to be navigated
546
+ */
547
+ oContext: sap.ui.model.odata.v4.Context
548
+ ): void;
549
+ /**
550
+ * Navigate to another target.
551
+ *
552
+ * @returns Promise that is resolved when the navigation is finalized
553
+ */
554
+ navigateToRoute(
555
+ /**
556
+ * Name of the target route
557
+ */
558
+ sTargetRouteName: string,
559
+ /**
560
+ * Parameters to be used with route to create the target hash
561
+ */
562
+ oParameters?: any
563
+ ): Promise<any>;
564
+ /**
565
+ * @SINCE 1.90.0
566
+ *
567
+ *
568
+ * This function is used to intercept the routing event after binding a page.
569
+ * If it is declared as an extension, it allows you to intercept and change the normal flow of binding.
570
+ *
571
+ * This function is not called directly, but overridden separately by consuming controllers.
572
+ * The override execution is: {@link sap.ui.core.mvc.OverrideExecution.After}.
573
+ */
574
+ onAfterBinding(
575
+ /**
576
+ * Object containing the context to be navigated
577
+ */
578
+ oContext: object
579
+ ): void;
580
+ /**
581
+ * @SINCE 1.90.0
582
+ *
583
+ *
584
+ * This function is used to intercept the routing event before binding a page.
585
+ * If it is declared as an extension, it allows you to intercept and change the normal flow of binding.
586
+ *
587
+ * This function is not called directly, but overridden separately by consuming controllers.
588
+ * The override execution is: {@link sap.ui.core.mvc.OverrideExecution.After}.
589
+ */
590
+ onBeforeBinding(
591
+ /**
592
+ * Object containing the context for the navigation
593
+ */
594
+ oContext: object
595
+ ): void;
596
+ /**
597
+ * @SINCE 1.86.0
598
+ *
599
+ *
600
+ * This function can be used to intercept the routing event happening during the normal process of navigating
601
+ * from one page to another.
602
+ * If declared as an extension, it allows you to intercept and change the normal navigation flow.
603
+ * If you decide to do your own navigation processing, you can return `true` to prevent the default routing
604
+ * behavior.
605
+ *
606
+ * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
607
+ * The override execution is: {@link sap.ui.core.mvc.OverrideExecution.After}.
608
+ *
609
+ *
610
+ * @returns `true` to prevent the default execution, false to keep the standard behavior
611
+ */
612
+ onBeforeNavigation(
613
+ /**
614
+ * Object containing row context and page context
615
+ */
616
+ mNavigationParameters: {
617
+ /**
618
+ * The currently selected context
619
+ */
620
+ bindingContext: sap.ui.model.odata.v4.Context;
621
+ }
622
+ ): boolean;
623
+ }
624
+ /**
625
+ * @SINCE 1.86.0
626
+ *
627
+ *
628
+ * A controller extension offering hooks into the routing flow of the application
629
+ */
630
+ class Share extends sap.ui.core.mvc.ControllerExtension {
631
+ constructor();
632
+
633
+ /**
634
+ * @SINCE 1.93.0
635
+ *
636
+ *
637
+ * Adapts the metadata used while sharing the page URL via 'Send Email', 'Share in SAP Jam', and 'Save as
638
+ * Tile'.
639
+ *
640
+ * @returns Share Metadata or a Promise resolving the Share Metadata
641
+ */
642
+ adaptShareMetadata(
643
+ /**
644
+ * Object containing the share metadata.
645
+ */
646
+ oShareMetadata: {
647
+ /**
648
+ * Email-specific metadata.
649
+ */
650
+ email?: {
651
+ /**
652
+ * Title that will be used as "email subject" in 'Send Email'. This takes precedence over oShareMetadata.title.
653
+ */
654
+ title: string;
655
+ /**
656
+ * URL that will be used specifically for 'Send Email'. This takes precedence over oShareMetadata.url.
657
+ */
658
+ url: string;
659
+ };
660
+ /**
661
+ * SAP Jam-specific metadata.
662
+ */
663
+ jam?: {
664
+ /**
665
+ * Title that will be used as 'share text' in 'Share in SAP Jam'. This takes precedence over oShareMetadata.title.
666
+ */
667
+ title: string;
668
+ /**
669
+ * URL that will be used specifically for 'Share in SAP Jam'. This takes precedence over oShareMetadata.url.
670
+ */
671
+ url: string;
672
+ };
673
+ /**
674
+ * Save as Tile-specific metadata.
675
+ */
676
+ tile?: {
677
+ /**
678
+ * Icon to be used for the tile.
679
+ */
680
+ icon: string;
681
+ /**
682
+ * Query URL of an OData service from which data for a dynamic tile is read.
683
+ */
684
+ queryUrl: string;
685
+ /**
686
+ * Subtitle to be used for the tile.
687
+ */
688
+ subtitle: string;
689
+ /**
690
+ * Title to be used for the tile. This takes precedence over oShareMetadata.title.
691
+ */
692
+ title: string;
693
+ /**
694
+ * URL that will be used specifically for 'Save as Tile'. This takes precedence over oShareMetadata.url.
695
+ */
696
+ url: string;
697
+ };
698
+ /**
699
+ * Default title that will be used as 'email subject' in 'Send Email', 'share text' in 'Share in SAP Jam'
700
+ * and 'title' in 'Save as Tile'
701
+ */
702
+ title: string;
703
+ /**
704
+ * Default URL that will be used via 'Send Email', 'Share in SAP Jam', and 'Save as Tile'
705
+ */
706
+ url: string;
707
+ }
708
+ ): object | Promise<any>;
709
+ /**
710
+ * @SINCE 1.93.0
711
+ *
712
+ *
713
+ * Opens the share sheet.
714
+ */
715
+ openShareSheet(
716
+ /**
717
+ * The control to which the ActionSheet is opened.
718
+ */
719
+ oControl: object
720
+ ): void;
721
+ }
722
+ /**
723
+ * @SINCE 1.85.0
724
+ *
725
+ *
726
+ * A controller extension offering hooks for state handling
727
+ * If you need to maintain a specific state for your application, you can use the controller extension.
728
+ */
729
+ class ViewState extends sap.ui.core.mvc.ControllerExtension {
730
+ constructor();
731
+
732
+ /**
733
+ * This function should add all controls relevant for refreshing to the provided control array.
734
+ * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
735
+ * The override execution is: {@link sap.ui.core.mvc.OverrideExecution.After}.
736
+ */
737
+ adaptBindingRefreshControls(
738
+ /**
739
+ * The collected controls
740
+ */
741
+ aCollectedControls: sap.ui.base.ManagedObject[]
742
+ ): void;
743
+ /**
744
+ * Customize the `refreshBinding` function for a certain control.
745
+ * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
746
+ * The override execution is: {@link sap.ui.core.mvc.OverrideExecution.After}.
747
+ */
748
+ adaptBindingRefreshHandler(
749
+ /**
750
+ * The control for which the refresh handler is adapted.
751
+ */
752
+ oControl: sap.ui.base.ManagedObject,
753
+ /**
754
+ * A plain object which can have one function: `refreshBinding`
755
+ */
756
+ oControlHandler: any[]
757
+ ): void;
758
+ /**
759
+ * Customize the `retrieve` and `apply` functions for a certain control.
760
+ * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
761
+ * The override execution is: {@link sap.ui.core.mvc.OverrideExecution.After}.
762
+ */
763
+ adaptControlStateHandler(
764
+ /**
765
+ * The control to get state handler for
766
+ */
767
+ oControl: sap.ui.base.ManagedObject,
768
+ /**
769
+ * A list of plain objects with two functions: `retrieve` and `apply`
770
+ */
771
+ aControlHandler: object[]
772
+ ): void;
773
+ /**
774
+ * This function should add all controls for given view that should be considered for the state handling
775
+ * to the provided control array.
776
+ * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
777
+ * The override execution is: {@link sap.ui.core.mvc.OverrideExecution.After}.
778
+ */
779
+ adaptStateControls(
780
+ /**
781
+ * The collected controls
782
+ */
783
+ aCollectedControls: sap.ui.base.ManagedObject[]
784
+ ): void;
785
+ /**
786
+ * Applying additional, not control related, states - is called only if navigation type is iAppState.
787
+ * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
788
+ * The override execution is: {@link sap.ui.core.mvc.OverrideExecution.After}.
789
+ */
790
+ applyAdditionalStates(
791
+ /**
792
+ * The current view state
793
+ */
794
+ oViewState: object,
795
+ /**
796
+ * Extensible array of promises to be resolved before continuing
797
+ */
798
+ aPromises: Promise<any>
799
+ ): void;
800
+ /**
801
+ * Defines whether the view state should only be applied once initially.
802
+ * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
803
+ * The override execution is: {@link sap.ui.core.mvc.OverrideExecution.Instead}.
804
+ *
805
+ * Important:
806
+ * You should only override this method for custom pages and not for the standard ListReportPage and ObjectPage!
807
+ *
808
+ *
809
+ * @returns If `true`, only the initial view state is applied once,
810
+ * else any new view state is also applied on follow-up calls (default)
811
+ */
812
+ applyInitialStateOnly(): boolean;
813
+ /**
814
+ * Apply navigation parameters - is called only if navigation type is not iAppState.
815
+ * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
816
+ * The override execution is: {@link sap.ui.core.mvc.OverrideExecution.After}.
817
+ */
818
+ applyNavigationParameters(
819
+ /**
820
+ * The current navigation parameter
821
+ */
822
+ oNavParameter: {
823
+ /**
824
+ * The actual navigation type
825
+ */
826
+ navigationType: any;
827
+ /**
828
+ * undefined
829
+ */
830
+ requiresStandardVariant?: boolean;
831
+ /**
832
+ * undefined
833
+ */
834
+ selectionVariant?: object;
835
+ /**
836
+ * undefined
837
+ */
838
+ selectionVariantDefaults?: object;
839
+ },
840
+ /**
841
+ * Extensible array of promises to be resolved before continuing
842
+ */
843
+ aPromises: Promise<any>
844
+ ): void;
845
+ /**
846
+ * Applies the given view state to this extensions view.
847
+ *
848
+ * @returns Promise for async state handling
849
+ */
850
+ applyViewState(
851
+ /**
852
+ * The view state to apply (can be undefined)
853
+ */
854
+ oViewState: any,
855
+ /**
856
+ * The current navigation parameter
857
+ */
858
+ oNavParameter: {
859
+ /**
860
+ * The actual navigation type
861
+ */
862
+ navigationType: any;
863
+ /**
864
+ * Defines whether standard variant must be used in VM
865
+ */
866
+ requiresStandardVariant?: boolean;
867
+ /**
868
+ * The selectionVariant from the navigation
869
+ */
870
+ selectionVariant?: object;
871
+ /**
872
+ * The selectionVariant defaults from the navigation
873
+ */
874
+ selectionVariantDefaults?: object;
875
+ }
876
+ ): Promise<any>;
877
+ /**
878
+ * Hook to react when state for given view was applied.
879
+ * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
880
+ * The override execution is: {@link sap.ui.core.mvc.OverrideExecution.After}.
881
+ */
882
+ onAfterStateApplied(
883
+ /**
884
+ * Extensible array of promises to be resolved before continuing
885
+ */
886
+ aPromises: Promise<any>
887
+ ): void;
888
+ /**
889
+ * Hook to react before a state for given view is applied.
890
+ * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
891
+ * The override execution is: {@link sap.ui.core.mvc.OverrideExecution.After}.
892
+ */
893
+ onBeforeStateApplied(
894
+ /**
895
+ * Extensible array of promises to be resolved before continuing
896
+ */
897
+ aPromises: Promise<any>
898
+ ): void;
899
+ /**
900
+ * Called when the application is restored due to keep-alive mode.
901
+ */
902
+ onRestore(): void;
903
+ /**
904
+ * Called when the application is suspended due to keep-alive mode.
905
+ */
906
+ onSuspend(): void;
907
+ /**
908
+ * Extend the map of additional states (not control bound) to be added to the current view state of the
909
+ * given view.
910
+ * This function is meant to be individually overridden by consuming controllers, but not to be called directly.
911
+ * The override execution is: {@link sap.ui.core.mvc.OverrideExecution.After}.
912
+ */
913
+ retrieveAdditionalStates(
914
+ /**
915
+ * The additional state
916
+ */
917
+ mAdditionalStates: object
918
+ ): void;
919
+ /**
920
+ * Retrieve the view state of this extensions view.
921
+ * When this function is called more than once before finishing, all but the final response will resolve
922
+ * to `undefined`.
923
+ *
924
+ * @returns A promise resolving the view state
925
+ */
926
+ retrieveViewState(): Promise<any>;
927
+ }
928
+ }
42
929
  /**
43
930
  * Collection of classes provided by SAP Fiori elements for the Flexible Programming Model
44
931
  */
45
932
  namespace fpm {
46
933
  /**
47
934
  * @SINCE 1.92.0
48
- * @EXPERIMENTAL (since 1.92.0)
49
935
  *
50
- * Component that can be used as a wrapper component for custom pages.
936
+ * @EXPERIMENTAL (since 1.92.0
937
+ * )
51
938
  *
939
+ * Component that can be used as a wrapper component for custom pages.
52
940
  * The component can be used in case you want to use SAP Fiori elements Building Blocks or XML template
53
941
  * constructions. You can either extend the component and set the viewName and contextPath within your code
54
942
  * or you can use it to wrap your custom XML view directly the manifest when you define your custom page
@@ -71,9 +959,234 @@ declare namespace sap {
71
959
  * }
72
960
  * ```
73
961
  */
74
- export const Component: undefined;
962
+ class Component
963
+ /* was: sap.fe.core.TemplateComponent */ extends Object {
964
+ constructor();
965
+ }
966
+ }
967
+
968
+ interface $AppComponentSettings
969
+ extends sap.ui.core.$UIComponentSettings {}
970
+
971
+ /**
972
+ * Main class for components used for an application in SAP Fiori elements.
973
+ * Application developers using the templates and building blocks provided by SAP Fiori elements should
974
+ * create their apps by extending this component.
975
+ * This ensures that all the necessary services that you need for the building blocks and templates to work
976
+ * properly are started.
977
+ *
978
+ * When you use sap.fe.core.AppComponent as the base component, you also need to use a rootView. SAP Fiori
979
+ * elements provides two options:
980
+ *
981
+ * - sap.fe.templates.RootContainer.view.NavContainer when using sap.m.routing.Router
982
+ *
983
+ * - sap.fe.templates.RootContainer.view.Fcl when using sap.f.routing.Router (FCL use case)
984
+ */
985
+ class AppComponent extends sap.ui.core.UIComponent {
986
+ constructor();
987
+ }
988
+ /**
989
+ * @SINCE 1.90.0
990
+ *
991
+ *
992
+ * Internal base controller class for SAP Fiori elements application.
993
+ * If you want to extend a base controller for your custom page, please use for sap.fe.core.PageController.
994
+ */
995
+ class BaseController extends sap.ui.core.mvc.Controller {
996
+ constructor();
997
+
998
+ /**
999
+ * @SINCE 1.91.0
1000
+ *
1001
+ *
1002
+ * Returns the current app component.
1003
+ *
1004
+ * @returns The app component or, if not found, null
1005
+ */
1006
+ getAppComponent(): sap.fe.core.AppComponent;
1007
+ /**
1008
+ * Convenience method provided by SAP Fiori elements to enable applications to include the view model by
1009
+ * name into each controller.
1010
+ *
1011
+ * @returns The model instance
1012
+ */
1013
+ getModel(
1014
+ /**
1015
+ * The model name
1016
+ */
1017
+ sName?: string
1018
+ ): sap.ui.model.Model;
1019
+ /**
1020
+ * Convenience method for setting the view model in every controller of the application.
1021
+ *
1022
+ * @returns The view instance
1023
+ */
1024
+ setModel(
1025
+ /**
1026
+ * The model instance
1027
+ */
1028
+ oModel: sap.ui.model.Model,
1029
+ /**
1030
+ * The model name
1031
+ */
1032
+ sName: string
1033
+ ): sap.ui.core.mvc.View;
1034
+ }
1035
+ /**
1036
+ * @SINCE 1.79.0
1037
+ *
1038
+ *
1039
+ * Common Extension API for all pages of SAP Fiori elements for OData V4.
1040
+ */
1041
+ class ExtensionAPI extends sap.ui.base.Object {
1042
+ constructor();
1043
+
1044
+ /**
1045
+ * Add any control as a dependent control to this SAP Fiori elements page.
1046
+ */
1047
+ addDependent(
1048
+ /**
1049
+ * Control to be added as a dependent control
1050
+ */
1051
+ oControl: sap.ui.core.Control
1052
+ ): void;
1053
+ /**
1054
+ * Get access to models managed by SAP Fiori elements.
1055
+ *
1056
+ * The following models can be accessed:
1057
+ *
1058
+ *
1059
+ * - undefined: the undefined model returns the SAPUI5 OData V4 model bound to this page
1060
+ *
1061
+ * - i18n / further data models defined in the manifest
1062
+ * ui: returns a SAPUI5 JSON model containing UI information.
1063
+ * Only the following properties are public and supported:
1064
+ *
1065
+ *
1066
+ * - isEditable: set to true if the application is in edit mode
1067
+ *
1068
+ *
1069
+ * .
1070
+ * editMode is deprecated and should not be used anymore. Use isEditable instead.
1071
+ *
1072
+ * @returns The required model
1073
+ */
1074
+ getModel(
1075
+ /**
1076
+ * Name of the model
1077
+ */
1078
+ sModelName?: string
1079
+ ): undefined | sap.ui.model.Model;
1080
+ /**
1081
+ * Load a fragment and go through the template preprocessor with the current page context.
1082
+ *
1083
+ * @returns The fragment definition
1084
+ */
1085
+ loadFragment(
1086
+ /**
1087
+ * The settings object
1088
+ */
1089
+ mSettings: {
1090
+ /**
1091
+ * The contextPath to be used for the templating process
1092
+ */
1093
+ contextPath: string;
1094
+ /**
1095
+ * The controller to be attached to the fragment
1096
+ */
1097
+ controller: object;
1098
+ /**
1099
+ * The ID of the fragment itself
1100
+ */
1101
+ id: string;
1102
+ /**
1103
+ * The initial binding context
1104
+ */
1105
+ initialBindingContext: sap.ui.model.Context;
1106
+ /**
1107
+ * The name of the fragment to be loaded
1108
+ */
1109
+ name: string;
1110
+ }
1111
+ ): Promise<any>;
1112
+ /**
1113
+ * Navigate to another target.
1114
+ */
1115
+ navigateToTarget(
1116
+ /**
1117
+ * Name of the target route
1118
+ */
1119
+ sTarget: string,
1120
+ /**
1121
+ * undefined
1122
+ */
1123
+ oContext: sap.ui.model.Context
1124
+ ): void;
1125
+ /**
1126
+ * Remove a dependent control from this SAP Fiori elements page.
1127
+ */
1128
+ removeDependent(
1129
+ /**
1130
+ * Control to be added as a dependent control
1131
+ */
1132
+ oControl: sap.ui.core.Control
1133
+ ): void;
1134
+ /**
1135
+ * Triggers an update of the app state.
1136
+ * Should be called if the state of a control, or any other state-relevant information, was changed.
1137
+ *
1138
+ * @returns A promise that resolves with the new app state object.
1139
+ */
1140
+ updateAppState(): undefined | Promise<any>;
75
1141
  }
1142
+ /**
1143
+ * @SINCE 1.88.0
1144
+ *
1145
+ *
1146
+ * Base controller class for your custom page used inside an SAP Fiori elements application.
1147
+ * This controller provides preconfigured extensions that will ensure you have the basic functionalities
1148
+ * required to use the building blocks.
1149
+ */
1150
+ class PageController extends sap.fe.core.BaseController {
1151
+ constructor();
76
1152
 
1153
+ /**
1154
+ * @SINCE 1.91.0
1155
+ *
1156
+ *
1157
+ * Returns the current app component.
1158
+ *
1159
+ * @returns The app component or, if not found, null
1160
+ */
1161
+ getAppComponent(): sap.fe.core.AppComponent;
1162
+ /**
1163
+ * Convenience method provided by SAP Fiori elements to enable applications to include the view model by
1164
+ * name into each controller.
1165
+ *
1166
+ * @returns The model instance
1167
+ */
1168
+ getModel(
1169
+ /**
1170
+ * The model name
1171
+ */
1172
+ sName?: string
1173
+ ): sap.ui.model.Model;
1174
+ /**
1175
+ * Convenience method for setting the view model in every controller of the application.
1176
+ *
1177
+ * @returns The view instance
1178
+ */
1179
+ setModel(
1180
+ /**
1181
+ * The model instance
1182
+ */
1183
+ oModel: sap.ui.model.Model,
1184
+ /**
1185
+ * The model name
1186
+ */
1187
+ sName: string
1188
+ ): sap.ui.core.mvc.View;
1189
+ }
77
1190
  /**
78
1191
  * @SINCE 1.86.0
79
1192
  *
@@ -97,6 +1210,30 @@ declare namespace sap {
97
1210
  }
98
1211
 
99
1212
  interface IUI5DefineDependencyNames {
1213
+ "sap/fe/core/AppComponent": undefined;
1214
+
1215
+ "sap/fe/core/BaseController": undefined;
1216
+
1217
+ "sap/fe/core/controllerextensions/EditFlow": undefined;
1218
+
1219
+ "sap/fe/core/controllerextensions/IntentBasedNavigation": undefined;
1220
+
1221
+ "sap/fe/core/controllerextensions/MessageHandler": undefined;
1222
+
1223
+ "sap/fe/core/controllerextensions/Paginator": undefined;
1224
+
1225
+ "sap/fe/core/controllerextensions/Routing": undefined;
1226
+
1227
+ "sap/fe/core/controllerextensions/Share": undefined;
1228
+
1229
+ "sap/fe/core/controllerextensions/ViewState": undefined;
1230
+
1231
+ "sap/fe/core/ExtensionAPI": undefined;
1232
+
1233
+ "sap/fe/core/fpm/Component": undefined;
1234
+
100
1235
  "sap/fe/core/library": undefined;
1236
+
1237
+ "sap/fe/core/PageController": undefined;
101
1238
  }
102
1239
  }