platform-custom-application-generate

何時使用此技能

當您需要以下情況時，請使用此技能：

• 建立 Lightning 應用程式
• 將分頁和功能組織成聚焦的應用程式
• 設定應用程式導覽和品牌形象
• 為物件設定自訂頁面版面配置
• 排解與自訂應用程式相關的部署錯誤

CustomApplication (Lightning App) 中繼資料規格

概觀

自訂應用程式（Lightning 應用程式）將分頁和功能分組，為特定業務流程提供聚焦的使用者體驗。一律設定為 Lightning Experience。

目的

• 將相關功能組織成聚焦的應用程式
• 為特定使用者角色分組分頁和元件
• 提供量身打造的使用者體驗
• 控制對特定功能和資料的存取
• 使用 Standard 導覽適用於一般業務應用程式，或使用 Console 導覽適用於需要多分頁工作區的專業服務/支援流程
• 使用自訂顏色和品牌形象建立專業、有品牌識別的應用程式
• 使用自訂 Lightning 頁面覆寫標準動作，以增強使用者體驗
• 透過設定檔動作覆寫啟用特定設定檔的體驗

必要屬性

核心應用程式屬性

• fullName：應用程式的 API 名稱
• label：應用程式的顯示名稱
• uiType：現代應用程式一律為 "Lightning"
• navType：關鍵——根據使用者需求和流程模式選擇
  • "Standard"：一般業務應用程式的預設值（例如銷售、行銷、營運）
  • "Console"：僅當流程需要同時管理多筆記錄，且具備分割檢視或多分頁工作區時使用（例如客戶服務、客服中心、支援作業）
• formFactors：外觀尺寸陣列（桌面版為 ["LARGE"]，行動版為 ["SMALL"]，或兩者）

選用屬性

• description：應用程式目的的簡短描述
• tabs：要包含的分頁名稱陣列
• utilityBar：公用程式列設定的 API 名稱
• brand：⚠️ 強烈建議——品牌形象設定物件（headerColor、shouldOverrideOrgTheme、footerColor）
• actionOverrides：⚠️ 當存在自訂記錄頁面時為必填——動作覆寫設定（actionName、content、formFactor、type、pageOrSobjectType）
• profileActionOverrides：特定設定檔的動作覆寫（actionName、content、formFactor、pageOrSobjectType、type、profile）
• isNavAutoTempTabsDisabled：導覽行為設定（預設：false）
• isNavPersonalizationDisabled：個人化設定（預設：false）
• isNavTabPersistenceDisabled：分頁持續性設定（預設：false）

應用程式設定

導覽類型選擇（關鍵）

navType 的決策標準：

選擇 "Standard"（預設）用於：

• 一般業務應用程式和大多數流程
• 單一記錄焦點或線性導覽模式
• 標準分頁式導覽已足夠

僅當流程需要以下情況時選擇 "Console"：

• 在分割檢視中同時管理多筆相關記錄
• 多分頁工作區，用於處理複雜、相互關聯的資料
• 同時顯示來自多個來源的上下文資訊
• 範例：客戶服務作業、支援服務台、客服中心

不確定時： 對於大多數一般業務使用案例，預設為 "Standard"

導覽設定

• isNavAutoTempTabsDisabled：控制自動暫時分頁的建立
• isNavPersonalizationDisabled：控制使用者個人化功能
• isNavTabPersistenceDisabled：控制跨工作階段的分頁持續性

分頁管理

• tabs：要包含在應用程式中的分頁名稱陣列
• formFactors：裝置特定設定（大型用於桌面，小型用於行動）

公用程式列

• utilityBar：參考 Lightning 公用程式列（顯示在 Lightning Experience 底部）

品牌形象（強烈建議——請勿省略）

重要：提供品牌形象設定，以建立專業、視覺上獨特的應用程式識別。

• brand.headerColor：頁首列顏色的十六進位格式（例如 "#0070D2"）——建議
• brand.shouldOverrideOrgTheme：覆寫組織主題（true/false）——預設：false
• brand.footerColor：頁尾顏色的十六進位格式

動作覆寫（關鍵——請勿省略）

重要：對於每個具有 flexipage 專家產生的記錄頁面的自訂物件分頁，必須建立動作覆寫。

• actionOverrides.actionName：要覆寫的動作（"View" 或 "Tab"）
• actionOverrides.content：頁面/元件名稱（FlexiPage、Visualforce、Lightning 元件）
  • 對於 "View" 動作：參考 flexipage 專家產生的記錄頁面
  • 對於 "Tab" 動作：參考 flexipage 專家產生的首頁/應用程式頁面
• actionOverrides.formFactor：裝置類型（"Large" 或 "Small"）
• actionOverrides.type：覆寫類型（"Default"、"Visualforce"、"Flexipage"、"LightningComponent"、"Scontrol"）
  • 建議：對於 flexipage 專家產生的 Lightning 記錄/首頁，使用 "Flexipage"
• actionOverrides.pageOrSobjectType：覆寫適用的物件 API 名稱
• actionOverrides.comment：選用描述（最多 1000 個字元）
  • 自動產生的註解："Action override created by Lightning App Builder during activation."
• actionOverrides.skipRecordTypeSelect：跳過記錄類型選擇（預設：false）

設定檔動作覆寫

• profileActionOverrides.actionName：要覆寫的動作（"View" 或 "Tab"）
• profileActionOverrides.content：頁面/元件名稱
  • 對於 "View" 動作：參考 flexipage 專家產生的特定設定檔記錄頁面
  • 對於 "Tab" 動作：參考 flexipage 專家產生的特定設定檔首頁
  • 可以參考與 actionOverrides 相同或不同的 FlexiPage，以提供特定設定檔的體驗
• profileActionOverrides.formFactor：裝置類型（"Large" 或 "Small"）
• profileActionOverrides.pageOrSobjectType：物件 API 名稱
• profileActionOverrides.type：覆寫類型
  • 建議：對於 flexipage 專家產生的 Lightning 頁面，使用 "Flexipage"
• profileActionOverrides.profile：設定檔 API 名稱（例如 "Admin"、"Standard User"）
  • 允許為不同的使用者設定檔提供不同的頁面版面配置

裝置支援

桌面設定

• formFactor："Large"
• tabs：應用程式分頁的完整清單

手機設定

• formFactor："Small"
• tabs：行動最佳化的分頁選擇

平板設定

• formFactor："Medium"
• tabs：平板適用的分頁選擇

使用者體驗功能

導覽行為

• 自動暫時分頁：可以啟用/停用
• 個人化：使用者自訂選項
• 分頁持續性：記住使用者的分頁選擇

無障礙性

• 鍵盤導覽：完整的鍵盤支援
• 螢幕閱讀器：與輔助技術相容
• 高對比：支援高對比模式

整合點

• 自訂分頁：包含自訂物件和 Web 分頁
• 標準分頁：包含標準 Salesforce 分頁
• Lightning 頁面：與 Lightning 頁面版面配置整合
• 元件：包含自訂 Lightning 元件

最佳做法

• 一律使用 Lightning UI：將 uiType 設定為 "Lightning" 以用於現代應用程式
• 選擇適當的導覽：關鍵——仔細分析 navType 選擇的需求
  • 對於一般業務應用程式，使用 "Standard"（預設）
  • 僅當流程需要多分頁工作區、分割檢視或同時管理多筆相關記錄時，使用 "Console"
  • Console 的範例：客戶服務、客服中心、支援作業
  • 對於大多數一般業務使用案例，預設為 "Standard"
• 包含標準分頁：新增常見的 Salesforce 分頁（首頁、客戶、聯絡人等等）
• 使用清晰、具描述性的應用程式名稱
• 邏輯地分組相關功能
• 考慮不同的使用者角色和需求
• 在不同裝置類型上測試
• 確保適當的權限和存取控制
• 為使用者提供有意義的描述
• 遵循一致的命名慣例
• 一律設定品牌形象：設定 headerColor 以建立專業的應用程式識別
• 使用可存取的品牌顏色：確保十六進位顏色具有足夠的對比度（符合 WCAG AA）
• 設定公用程式列：為使用者新增有用的快速存取工具
• 利用動作覆寫：使用 flexipage 專家的 FlexiPage 自訂特定物件的頁面版面配置
• 使用設定檔覆寫：透過參考每個設定檔不同的 flexipage 專家產生的頁面，提供角色特定的體驗

增強規則

• uiType：一律設定為 "Lightning" 以獲得現代應用程式體驗
• navType：關鍵決策——仔細分析使用者需求
  • 對於一般業務應用程式，設定為 "Standard"（預設）
  • 僅當流程需要以下情況時，設定為 "Console"：
    • 使用分割檢視功能同時管理多筆相關記錄
    • 多分頁工作區，用於處理複雜、相互關聯的資料
    • 同時顯示來自多個來源的上下文資訊
  • Console 範例：客戶服務作業、客服中心、支援服務台
  • 在 Standard 和 Console 之間猶豫時，對於大多數業務使用案例，選擇 "Standard"
• formFactors：對於桌面 Lightning Experience，一律設定為 ["LARGE"]
• 標準分頁：自動新增首頁、客戶、聯絡人、商機、潛在客戶、案例
• 導覽設定：將所有導覽旗標設定為 false 以獲得最佳使用者體驗
• 品牌形象：一律包含品牌設定以獲得專業的應用程式識別
  • 強制：將 brand.headerColor 設定為適當的顏色（例如 Salesforce 藍色為 "#0070D2"）
  • 根據需求設定 brand.shouldOverrideOrgTheme
• 動作覆寫：當存在自訂記錄頁面時，一律建立動作覆寫
  • 強制：為 "View" 動作新增 actionOverrides，指向 flexipage 專家產生的記錄頁面
  • 使用 "Flexipage" 類型，並參考確切的 FlexiPage 名稱
  • 對於桌面，將 formFactor 設定為 "Large"
  • 使用物件 API 名稱包含 pageOrSobjectType
• 設定檔動作覆寫：參考 flexipage 專家產生的頁面以進行角色型自訂
• 外觀尺寸：在覆寫中使用 "Large" 用於桌面，"Small" 用於行動

關鍵驗證檢查清單（必須驗證）

• [ ] 所有分頁都包含在應用程式中
• [ ] navType 已正確設定——驗證 Console 與 Standard 的選擇
• [ ] 對於大多數一般業務應用程式，預設為 "Standard"
• [ ] 僅當流程需要同時管理多筆記錄、分割檢視或多分頁工作區時，設定為 "Console"
• [ ] 如果需求是一般/模糊的 → navType 應為 "Standard"
• [ ] 品牌形象已設定——這對於專業應用程式是強烈建議的
• [ ] brand.headerColor 已設定有效的十六進位顏色（例如 "#0070D2"）
• [ ] brand.shouldOverrideOrgTheme 已設定（預設：false）
• [ ] 動作覆寫已建立——對於每個具有記錄頁面的自訂物件，這是強制的
• [ ] 已為每個自訂物件分頁定義動作覆寫，指向正確的記錄頁面
• [ ] actionOverrides.content 與 flexipage 專家產生的確切 FlexiPage 名稱相符
• [ ] actionOverrides.pageOrSobjectType 已設定為正確的物件 API 名稱
• [ ] actionOverrides.type 已設定為 "Flexipage"
• [ ] actionOverrides.actionName 已設定為 "View"
• [ ] actionOverrides.formFactor 已設定為 "Large"
• [ ] 所有必要欄位都已填入（fullName、label、uiType、navType、formFactors）