platform-custom-tab-generate

platform-custom-tab-generate

熱門

當使用者需要建立或設定 Salesforce 自訂索引標籤時,請使用此技能。當使用者提及索引標籤、導覽索引標籤、物件索引標籤、網頁索引標籤、Visualforce 索引標籤、Lightning 元件索引標籤、應用程式頁面索引標籤或索引標籤設定時觸發。當使用者想要為自訂物件新增導覽、為外部內容建立索引標籤,或設定 Lightning 頁面索引標籤時,也請使用此技能。任何自訂索引標籤的工作一律使用此技能。

774星標
282分支
更新於 2026/7/24
SKILL.md
唯讀
名稱
platform-custom-tab-generate
描述

當使用者需要建立或設定 Salesforce 自訂索引標籤時,請使用此技能。當使用者提及索引標籤、導覽索引標籤、物件索引標籤、網頁索引標籤、Visualforce 索引標籤、Lightning 元件索引標籤、應用程式頁面索引標籤或索引標籤設定時觸發。當使用者想要為自訂物件新增導覽、為外部內容建立索引標籤,或設定 Lightning 頁面索引標籤時,也請使用此技能。任何自訂索引標籤的工作一律使用此技能。

使用時機

當您需要以下情況時,請使用此技能:

  • 為物件、網頁或 Visualforce 頁面建立索引標籤
  • 為應用程式新增導覽索引標籤
  • 設定索引標籤的顯示與存取權限
  • 排解與自訂索引標籤相關的部署錯誤

規格

CustomTab 中繼資料規格

概觀

自訂索引標籤用於在 Salesforce 應用程式中導覽至物件、網頁內容或 Visualforce 頁面。

目的

  • 提供自訂物件的導覽
  • 連結至外部網頁內容
  • 存取 Visualforce 頁面
  • 組織應用程式導覽

必要屬性

核心索引標籤屬性

  • customObject:自訂物件索引標籤設為 true,其他所有類型設為 false
  • motif:索引標籤圖示樣式 — 選擇與物件用途語意相符的 motif。請勿對每個索引標籤重複使用相同的 motif。
  • label:顯示名稱(僅非物件索引標籤為必填;物件索引標籤從物件繼承標籤)
  • url:網頁 URL(用於網頁索引標籤)
  • page:Visualforce 頁面名稱(用於 Visualforce 索引標籤)

嚴格元素允許清單 — 請先閱讀此內容

根元素必須永遠是 <CustomTab>(不是 <Tab>)。 XML 命名空間必須是 xmlns="http://soap.sforce.com/2006/04/metadata"

僅下列清單中的元素是有效的。任何不在清單上的元素都會導致部署錯誤。

索引標籤類型 僅允許這些元素(不得有其他元素)
物件索引標籤 <customObject>(必填,設為 true)、<motif>(必填)、<description>(選填)
網頁索引標籤 <customObject>(必填,設為 false)、<label>(必填)、<motif>(必填)、<url>(必填)、<urlEncodingKey>(必填,設為 UTF-8)、<description>(選填)、<frameHeight>(選填)
Visualforce 索引標籤 <customObject>(必填,設為 false)、<label>(必填)、<motif>(必填)、<page>(必填)、<description>(選填)

禁止元素(以下每個元素都會導致部署錯誤)

<sobjectName><name><fullName><apiVersion><isHidden><tabVisibility><type><mobileReady><urlFrameHeight><urlType><urlRedirect><encodingKey><height><auraComponent>

另外禁止:

  • 物件索引標籤上的 <label>(物件索引標籤從自訂物件繼承標籤)
  • 網頁索引標籤上的 <page>(僅用於 Visualforce 索引標籤)
  • 空元素,例如 <page></page><description></description>
  • 任何不在上方允許清單中的元素

索引標籤類型

物件索引標籤

  • 目的:導覽至自訂或標準物件
  • 檔案名稱決定物件:{ObjectApiName}.tab-meta.xml(例如 Space_Station__c.tab-meta.xml
  • 必要元素<customObject>true</customObject><motif>
  • 正確範例(用於 Space_Station__c.tab-meta.xml):
<?xml version="1.0" encoding="UTF-8"?>
<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
    <customObject>true</customObject>
    <motif>Custom39: Telescope</motif>
</CustomTab>
  • 正確範例(用於 Supply__c.tab-meta.xml — 注意不同的 motif):
<?xml version="1.0" encoding="UTF-8"?>
<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
    <customObject>true</customObject>
    <motif>Custom98: Truck</motif>
</CustomTab>
  • ❌ 錯誤 — 請勿新增 <sobjectName><name><fullName><label>
<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
    <sobjectName>Space_Station__c</sobjectName>  <!-- 部署錯誤 -->
    <label>Space Station</label>                  <!-- 物件索引標籤上的部署錯誤 -->
    <customObject>true</customObject>
    <motif>Custom57: Desert</motif>
</CustomTab>

網頁索引標籤

  • 目的:連結至外部網站或網頁應用程式
  • 檔案名稱:使用描述性名稱:{TabName}.tab-meta.xml(例如 Knowledge_Base.tab-meta.xml
  • 複製此確切範本 — 僅取代佔位符值。請勿新增、移除或重新命名任何 XML 元素:
<?xml version="1.0" encoding="UTF-8"?>
<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
    <customObject>false</customObject>
    <description>REPLACE_WITH_DESCRIPTION</description>
    <frameHeight>600</frameHeight>
    <label>REPLACE_WITH_LABEL</label>
    <motif>REPLACE_WITH_MOTIF</motif>
    <url>REPLACE_WITH_URL</url>
    <urlEncodingKey>UTF-8</urlEncodingKey>
</CustomTab>
  • 上述 7 個元素是網頁索引標籤檔案中唯一允許的元素。 請勿新增任何其他元素。
  • <description> 元素為選填 — 如果不需要可以移除,但請勿新增其他內容。

Visualforce 索引標籤

  • 目的:存取自訂 Visualforce 頁面
  • 檔案名稱{TabName}.tab-meta.xml(例如 Custom_Page_Tab.tab-meta.xml
  • 必要元素<customObject>false</customObject><label><motif><page>
  • 正確範例
<?xml version="1.0" encoding="UTF-8"?>
<CustomTab xmlns="http://soap.sforce.com/2006/04/metadata">
    <customObject>false</customObject>
    <label>Custom Page</label>
    <motif>Custom46: Computer</motif>
    <page>CustomPage</page>
</CustomTab>

索引標籤設定

索引標籤樣式

  • 預設:使用標準索引標籤樣式
  • 自訂:可依需求指定自訂索引標籤樣式

索引標籤可見性

  • 預設:對所有有權限的使用者可見
  • 自訂:可針對特定使用者設定檔進行設定

支援的應用程式

  • 標準應用程式:可在標準 Salesforce 應用程式中使用
  • 自訂應用程式:可包含在自訂應用程式中
  • 社群應用程式:可在社群應用程式中使用

整合點

  • 物件關係:連結至相關物件記錄
  • 網頁內容:外部網站整合
  • Visualforce 頁面:自訂頁面功能
  • Lightning 元件:現代元件整合

最佳做法

  • 使用清晰、具描述性的索引標籤標籤
  • 選擇適合功能的索引標籤類型
  • 為每個索引標籤選擇獨特且與情境相關的 motif — 不要將每個索引標籤都預設為相同圖示
  • 考量使用者體驗與導覽流程
  • 在不同應用程式中測試索引標籤功能
  • 確保適當的權限與可見性設定
  • 遵循一致的命名慣例
  • 物件索引標籤檔案必須僅包含 <customObject>true</customObject><motif> — 不得有其他內容
  • 網頁索引標籤檔案必須僅包含:<customObject>false</customObject><label><motif><url><urlEncodingKey>,以及選填的 <description><frameHeight> — 不得有其他內容
  • 永遠不要包含 <isHidden><tabVisibility><type><mobileReady> 或空元素