Fix Partially Deprecated Apis

作者 UI52b8c4a944e39無授權條款收錄於 2026年10月8日更新於 2026年10月8日

Fix partially deprecated API usage that UI5 linter reports but cannot auto-fix. Use this skill when linter outputs: - `no-deprecated-api` for Parameters.get, JSONModel.loadData, Mobile.init, ODataModel.v2.createEntry, View.create, Fragment.load, Router constructor - `unsupported-api-usage` for string formatter in JS bindings Trigger on: Parameters.get without object param, JSONModel.loadData with bAsync=false, Mobile.init with homeIcon, createEntry with batchGroupId, View.create/Fragment.load with non-XML type, Router without async:true, formatter as string in JS. Provides specific fix patterns for each partially deprecated API variant.

僅含說明Software Development
AI 產生的概覽

修復 UI5 linter 能偵測但無法自動修復的部分棄用 SAP UI5 API 用法。

功能
此技能針對特定的棄用 UI5 API 變體提供修改前後的程式碼模式，涵蓋 Parameters.get、JSONModel.loadData、Mobile.init、ODataModel.v2.createEntry、View.create、Fragment.load、Router 建構函式，以及 JavaScript 繫結中的字串格式化器。它會將 linter 規則 ID 與訊息模式對應到相應的修正方式，並說明何時需要把檢視或片段檔案轉換為 XML。它產出的是修正後的程式碼片段，本身不會執行任何工具。
適用情境
當 UI5 linter 輸出針對上述其中一個 API 回報 no-deprecated-api 或 unsupported-api-usage，且問題無法自動解決時使用。適合正在現代化改造 UI5 應用程式碼、需要針對所用棄用變體取得具體替換模式的開發人員。
執行需求
不隨附指令碼或套件，僅為說明性指示。套用這些修正需要有 SAP UI5 程式碼庫，並可使用 UI5 linter 進行驗證。

Fix Partially Deprecated APIs

This skill fixes partially deprecated API usage that the UI5 linter detects but cannot auto-fix because they require understanding the specific deprecated variant being used.

Quick Reference

APIDeprecated UsageFix
Parameters.getNo args, string, or arrayObject with name and callback
JSONModel.loadDatabAsync=false (3rd param)Omit or set true
Mobile.inithomeIcon/homeIconPrecomposedRemove, use web manifest
ODataModel.v2.createEntrybatchGroupIdUse groupId
ODataModel.v2.createEntryproperties as arrayUse object with values
View.createtype: "JS/JSON/HTML/Template"Use "XML" or omit
Fragment.loadtype: "HTML"Use "XML" or omit
Router constructorMissing/false asyncSet async: true
Binding formatterString value in JSFunction reference

Linter Rules Handled

Rule IDMessage PatternThis Skill's Action
no-deprecated-apiUsage of deprecated variant of 'sap/ui/core/theming/Parameters.get'Use object parameter
no-deprecated-apiUsage of deprecated value for parameter '...' of 'sap/ui/model/json/JSONModel#loadData'Remove/change parameter
no-deprecated-apiUsage of deprecated value for parameter '...' of 'sap/ui/util/Mobile#init'Remove parameter
no-deprecated-apiUsage of deprecated parameter 'batchGroupId' in 'sap/ui/model/odata/v2/ODataModel#createEntry'Use groupId
no-deprecated-apiUsage of deprecated value '...' for parameter 'type' in 'sap/ui/core/mvc/View.create'Use XML type
no-deprecated-apiUsage of deprecated value '...' for parameter 'type' in 'sap/ui/core/Fragment.load'Use XML type
no-deprecated-apiUsage of deprecated value for parameter 'oConfig.async' of constructor 'sap/ui/core/Router'Set async: true
unsupported-api-usageDo not use strings for 'formatter' values in JavaScriptUse function reference

When to Use

Apply this skill when you see linter output like:

MyController.js:15:5 error Usage of deprecated variant of 'sap/ui/core/theming/Parameters.get'  no-deprecated-apiMyController.js:20:5 error Usage of deprecated value for parameter 'bAsync' of 'sap/ui/model/json/JSONModel#loadData'  no-deprecated-apiMyController.js:25:5 error Usage of deprecated parameter 'batchGroupId' in 'sap/ui/model/odata/v2/ODataModel#createEntry'  no-deprecated-apiMyController.js:30:5 error Do not use strings for 'formatter' values in JavaScript  unsupported-api-usage

Fix Strategies

1. Parameters.get - Old Variant

Problem: Calling Parameters.get() without an object parameter.

javascript
// Before - all these variants are deprecatedsap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/theming/Parameters"], function(Controller, Parameters) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            // Deprecated: no arguments            var allParams = Parameters.get();
            // Deprecated: string argument            var singleParam = Parameters.get("sapUiBaseColor");
            // Deprecated: array argument            var multiParams = Parameters.get(["sapUiBaseColor", "sapUiBaseBG"]);        }    });});

Fix Strategy: Use object parameter with callback.

javascript
// After - use object parametersap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/theming/Parameters"], function(Controller, Parameters) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            // Correct: object parameter with name and callback            Parameters.get({                name: "sapUiBaseColor",                callback: function(sValue) {                    // Use the parameter value                    console.log("Color:", sValue);                }            });
            // Correct: multiple parameters            Parameters.get({                name: ["sapUiBaseColor", "sapUiBaseBG"],                callback: function(mParams) {                    // mParams is an object with parameter values                    console.log("Base color:", mParams.sapUiBaseColor);                    console.log("Base BG:", mParams.sapUiBaseBG);                }            });        }    });});

2. JSONModel.loadData - Deprecated Parameters

Problem: Using bAsync=false or bCache=false in loadData().

javascript
// Before - bAsync=false is deprecated (3rd parameter)sap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/model/json/JSONModel"], function(Controller, JSONModel) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            var oModel = new JSONModel();
            // Deprecated: bAsync=false (synchronous loading)            oModel.loadData("/api/data", null, false);
            // Deprecated: bCache=false (6th parameter)            oModel.loadData("/api/data", null, true, "GET", false, false);        }    });});

Fix Strategy: Use async loading (default) and remove cache parameter.

javascript
// After - use async loadingsap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/model/json/JSONModel"], function(Controller, JSONModel) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            var oModel = new JSONModel();
            // Correct: async loading (default or true)            oModel.loadData("/api/data").then(function() {                // Handle loaded data            });
            // Or with parameters, omitting deprecated ones            oModel.loadData("/api/data", null, true, "GET");        }    });});

3. Mobile.init - Deprecated Parameters

Problem: Using homeIcon or homeIconPrecomposed in Mobile.init().

javascript
// Before - homeIcon and homeIconPrecomposed are deprecatedsap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/util/Mobile"], function(Controller, Mobile) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            Mobile.init({                homeIcon: "icons/icon.png",              // Deprecated                homeIconPrecomposed: true,              // Deprecated                statusBar: "default"            });        }    });});

Fix Strategy: Remove the deprecated parameters.

javascript
// After - remove homeIcon and homeIconPrecomposedsap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/util/Mobile"], function(Controller, Mobile) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            Mobile.init({                statusBar: "default"            });
            // Note: Use web app manifest (manifest.json) for home screen icons instead        }    });});

Alternative: Define home screen icons in your web app manifest:

json
{    "icons": [        {            "src": "icons/icon-192.png",            "sizes": "192x192",            "type": "image/png"        }    ]}

4. ODataModel.v2.createEntry - Deprecated Parameters

Problem: Using batchGroupId or properties as array in createEntry().

javascript
// Before - batchGroupId and properties array are deprecatedsap.ui.define([    "sap/ui/core/mvc/Controller"], function(Controller) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onCreate: function() {            var oModel = this.getView().getModel();
            var oContext = oModel.createEntry("/Products", {                batchGroupId: "myBatch",                      // Deprecated: use groupId                properties: ["Name", "Price", "Category"]    // Deprecated: use object            });        }    });});

Fix Strategy: Use groupId and pass properties as object with initial values.

javascript
// After - use groupId and properties objectsap.ui.define([    "sap/ui/core/mvc/Controller"], function(Controller) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onCreate: function() {            var oModel = this.getView().getModel();
            var oContext = oModel.createEntry("/Products", {                groupId: "myBatch",                          // Correct: groupId                properties: {                                // Correct: object with initial values                    Name: "",                    Price: 0,                    Category: ""                }            });        }    });});

5. View.create - Deprecated View Types

Problem: Creating views with deprecated types (JS, JSON, HTML, Template).

javascript
// Before - non-XML view types are deprecatedsap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/mvc/View"], function(Controller, View) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            View.create({                viewName: "my.app.view.Detail",                type: "JS"          // Deprecated: JS, JSON, HTML, Template            }).then(function(oView) {                // Use view            });        }    });});

Fix Strategy: Convert to XML view type.

javascript
// After - use XML type (or omit type, XML is default)sap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/mvc/View"], function(Controller, View) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            View.create({                viewName: "my.app.view.Detail",                type: "XML"         // Or omit - XML is default            }).then(function(oView) {                // Use view            });        }    });});

Note: This requires converting your JS/JSON/HTML view file to an XML view file.

6. Fragment.load - Deprecated Fragment Type

Problem: Loading fragments with HTML type.

javascript
// Before - HTML fragment type is deprecatedsap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/Fragment"], function(Controller, Fragment) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onOpenDialog: function() {            Fragment.load({                name: "my.app.fragment.Dialog",                type: "HTML"        // Deprecated            }).then(function(oFragment) {                // Use fragment            });        }    });});

Fix Strategy: Convert to XML fragment.

javascript
// After - use XML type (or omit, XML is default)sap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/Fragment"], function(Controller, Fragment) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onOpenDialog: function() {            Fragment.load({                name: "my.app.fragment.Dialog",                type: "XML"         // Or omit - XML is default            }).then(function(oFragment) {                // Use fragment            });        }    });});

7. Router Constructor - Missing async Flag

Problem: Creating Router without async: true.

javascript
// Before - missing or false async flag is deprecatedsap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/routing/Router"], function(Controller, Router) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            // Deprecated: no config            var oRouter1 = new Router([]);
            // Deprecated: async not set or false            var oRouter2 = new Router([], {                async: false            });        }    });});

Fix Strategy: Set async: true in the config.

javascript
// After - set async: truesap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/ui/core/routing/Router"], function(Controller, Router) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        onInit: function() {            var oRouter = new Router([], {                async: true         // Required            });        }    });});

Note: Most apps use the Component's built-in router via manifest.json, which handles this automatically when IAsyncContentCreation is implemented in Component.js (see fix-component-async skill).

8. String Formatter in JS Bindings

Problem: Using string value for formatter in JavaScript.

javascript
// Before - string formatter doesn't work in JSsap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/m/Input",    "../model/formatter"], function(Controller, Input, formatter) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        formatter: formatter,
        onInit: function() {            var oInput = new Input({                value: {                    path: "/status",                    formatter: "formatter.statusText"   // Error: string won't work                }            });        }    });});

Fix Strategy: Use function reference.

javascript
// After - use function referencesap.ui.define([    "sap/ui/core/mvc/Controller",    "sap/m/Input",    "../model/formatter"], function(Controller, Input, formatter) {    "use strict";
    return Controller.extend("my.app.controller.Main", {        formatter: formatter,
        onInit: function() {            var oInput = new Input({                value: {                    path: "/status",                    formatter: formatter.statusText    // Correct: function reference                }            });        }    });});

Note: String formatters work in XML views (resolved at runtime) but not in JS where you have direct access to the function.

Notes

  • These are "partially" deprecated because only specific usage patterns are deprecated, not the entire API
  • Always check npx @ui5/linter --details for links to modernization documentation
  • View/Fragment type changes require converting the actual view/fragment files to XML
  • The Router async: true is automatically handled when using IAsyncContentCreation in Component.js (see fix-component-async skill for correct placement)

來源與署名

來源：UI5/plugins-coding-agents位於plugins/ui5-modernization/skills/fix-partially-deprecated-apis提交2b8c4a9

授權條款： 無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架

更多來自 UI5/plugins-coding-agents 的技能

Modernize Ui5 App

UI5

編排五階段 UI5 應用程式現代化工作流程，包含驗證關卡與逐階段提交。

Software Development2026年10月8日

Modernize Flp Sandbox

UI5

將 SAP UI5 應用從舊版 FLP 沙箱遷移到新沙箱，重寫設定、鉤子與測試。

Software Development2026年10月8日

Fix Xml Native Html

UI5

指導將 UI5 XML 檢視中已棄用的原生 HTML 與 SVG 替換為等效的 UI5 控制項與圖示。

Software Development2026年10月8日

Fix Table Row Mode

UI5

將已棄用的 sap.ui.table.Table 列屬性轉換為 rowMode 聚合，修復 UI5 程式碼。

Software Development2026年10月8日

Fix Pseudo Modules

UI5

指導修正 UI5 檢查器回報的偽模組與隱式全域錯誤，透過調整模組匯入方式解決。

Software Development2026年10月8日

Fix Manifest Json

UI5

修復 UI5 linter 回報但無法自動修復的 SAP UI5 manifest.json 問題。

Software Development2026年10月8日

更多Software Development技能

Playground

anthropics

精選

建立自成一體的互動式 HTML 遊樂場，包含控制項、即時預覽與可複製的提示詞輸出。

Software Development37K今天更新

M5 Onboard

anthropics

精選

透過 USB 偵測 M5Stack ESP32 開發板，燒錄 UIFlow 2.0 韌體並安裝 MicroPython 應用程式套件。

Software Development37K今天更新

Cardputer Buddy

anthropics

精選

指導迭代 Cardputer-Adv 的 MicroPython 應用程式套件：新增應用程式、透過 USB 序列埠推送檔案、查看日誌並執行 REPL 指令。

Software Development37K今天更新

Dpop Adoption

google

精選

指導為 Google OAuth 平台實作 OAuth 2.0 DPoP（RFC 9449）傳送方約束的更新權杖。

Software Development21K今天更新

Gemini Live Api

google

精選

產生 Gemini Live API WebSocket 用戶端類別、測試、文件，以及用於雙向串流的示範介面。

Software Development21K今天更新

Gemini Api

google

精選

說明如何在 Google Agent Platform 上使用 Gen AI SDK 呼叫 Gemini API，涵蓋多種語言與多項功能。

Software Development21K今天更新