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>或空元素






