建立 .CSV 檔案
當您準備要匯入 .csv 檔案時,請遵循這些原則。
必要版本
| 提供版本:Lightning Experience |
| 提供版本:Enterprise、Unlimited 及 Developer Edition |
- .csv 檔案中的第一列,會列出您要上載記錄的物件欄位名稱。請將這些項目視為試算表中的資料欄。例如,如果您上載記錄至「製造計畫預測實情」物件,則 .csv 檔案中的第一列會如下所示。
重要許多 Salesforce 中的物件和其他物件有關。當您在第一列中列出關係欄位時,請謹記這些其他因素。
- 將參照新增至 CSV 檔案中的相關物件。
- 若要描述物件與其父系之間的關係,請使用
RelationshipName.IndexedFieldName,其中RelationshipName是欄位的關係名稱,而IndexedFieldName是唯一識別父系記錄的索引欄位名稱。 - 在 API 中使用 describeSObjects() 呼叫,以取得欄位的 relationshipName 屬性值。
以下為關係欄位的範例:
AdvAcctForecastSetUse是ManufacturingProgramForecastFact的父系。- 「名稱」是
AdvAcctForecastSetUse上的索引欄位。因此,您可以使用AdvAcctForecastSetUse.Name以唯一識別AdvAcctForecastSetUse記錄。
備註 請務必在索引欄位中使用唯一值。如果有多個記錄具有相同值,則 .csv 檔案上載程序會失敗並顯示DUPLICATE_EXTERNAL_ID:Name: more than one record found for external id field錯誤。
Name,AdvAcctForecastSetUse.Name,Status,ProductionModel.Name,ProductionLocation.Name,PeriodId,ProgramQuantity,ExpectedRevenuePerUnit,MarketSharePercent,ForecastedRevenue,ForecastedQuantity,ExternalReferenceNumber - 每一個後續的資料列均會對應至 Salesforce 中的記錄。記錄會包含一系列以逗號分隔的欄位。
FastCars AutoX Chennai JanFY2023,Fast Cars Program Set Use,Active,AutoX,Chennai,026T10000002icqIAA,500,250000,22,150000,300,FastCars AutoX Chennai JanFY2023 - 請確保 .csv 檔案中的所有記錄皆適用於相同物件。匯入 CSV 檔案時,您將會指定「目標物件」。
- 請僅使用逗號作為分隔符號。
- 請確保 .csv 檔案是 UTF-8 格式。
- 請確保 .csv 檔案中的所有產品都具有相同的相關聯週期數。如果 .csv 檔案中的產品有不相等的週期,則上載會失敗並顯示錯誤。
- 我們使用大量 API 上載記錄。如需如何準備 .csv 檔案以供大量 API 上載的詳細資訊,請參閱準備 CSV 檔案
範例
名為 Fast Cars 的汽車製造商希望在 2025 年發行 AutoX 汽車。製造供應商 (即汽車元件商) 的計畫經理想要預測計畫數量、各單位的預期收入、預測數量,以及 2023 年 1 月、2023 年 2 月和 2023 年 3 月的清奈與邦加羅爾工廠位置的預測收入。
為此格式的計畫預測建立 .csv 檔案。
| 名稱 | AdvAcctForecastSetUse.Name | 狀態 | ProductionModel.Name | ProductionLocation.Name | PeriodID | ProgramQuantity | ExpectedRevenuePerUnit | MarketSharePercent | ForecastedQuantity | ForecastedRevenue | ExternalReferenceNumber |
|---|---|---|---|---|---|---|---|---|---|---|---|
| FastCars AutoX 清奈 JanFY2023 | Fast Cars 計畫設定使用 | 啟用 | AutoX | 清奈 | 026T10000002icqIAA | 500 | 250000 | 22 | 150000 | 300 | FastCars AutoX 清奈 JanFY2023 |
| FastCars AutoX 清奈 FebFY2023 | Fast Cars 計畫設定使用 | 啟用 | AutoX | 清奈 | 026T10000002icrIAA | 600 | 120000 | 15 | 97000 | 350 | FastCars AutoX 清奈 FebFY2023 |
| FastCars AutoX 清奈 MarFY2023 | Fast Cars 計畫設定使用 | 啟用 | AutoX | 清奈 | 026T10000002icsIAA | 700 | 230000 | 26 | 230000 | 400 | FastCars AutoX 清奈 MarFY2023 |
| FastCars AutoX 邦加羅爾 JanFY2023 | Fast Cars 計畫設定使用 | 啟用 | AutoX | 邦加羅爾 | 026T10000002icqIAA | 550 | 89000 | 10 | 54000 | 450 | FastCars AutoX 邦加羅爾 JanFY2023 |
| FastCars AutoX 邦加羅爾 FebFY2023 | Fast Cars 計畫設定使用 | 啟用 | AutoX | 邦加羅爾 | 026T10000002icrIAA | 670 | 350000 | 21 | 340000 | 500 | FastCars AutoX 邦加羅爾 FebFY2023 |
| FastCars AutoX 邦加羅爾 MarFY2023 | Fast Cars 計畫設定使用 | 啟用 | AutoX | 邦加羅爾 | 026T10000002icsIAA | 890 | 150000 | 18 | 450000 | 550 | FastCars AutoX 邦加羅爾 MarFY2023 |
以下是 fastcarsprogram.csv 檔案的範例。
Name,AdvAcctForecastSetUse.Name,Status,ProductionModel.Name,ProductionLocation.Name,PeriodId,ProgramQuantity,ExpectedRevenuePerUnit,MarketSharePercent,ForecastedRevenue,ForecastedQuantity,ExternalReferenceNumber
FastCars AutoX Chennai JanFY2023,Fast Cars Program Set Use,Active,AutoX,Chennai,026T10000002icqIAA,500,250000,22,150000,300,FastCars AutoX Chennai JanFY2023
FastCars AutoX Chennai FebFY2023,Fast Cars Program Set Use,Active,AutoX,Chennai,026T10000002icrIAA,600,120000,15,97000,350,FastCars AutoX Chennai FebFY2023
FastCars AutoX Chennai MarFY2023,Fast Cars Program Set Use,Active,AutoX,Chennai,026T10000002icsIAA,700,230000,26,230000,400,FastCars AutoX Chennai MarFY2023
FastCars AutoX Bangalore JanFY2023,Fast Cars Program Set Use,Active,AutoX,Bangalore,026T10000002icqIAA,550,89000,10,54000,450,FastCars AutoX Bangalore JanFY2023
FastCars AutoX Bangalore FebFY2023,Fast Cars Program Set Use,Active,AutoX,Bangalore,026T10000002icrIAA,670,350000,21,340000,500,FastCars AutoX Bangalore FebFY2023
FastCars AutoX Bangalore MarFY2023,Fast Cars Program Set Use,Active,AutoX,Bangalore,026T10000002icsIAA,890,150000,18,450000,550,FastCars AutoX Bangalore MarFY2023
如果汽車元件商的計畫經理想要針對清奈和邦加羅爾位置,預測其三個月 (2023 年 1 月、2023 年 2 月和 2023 年 3 月) 變數層級 (紅色 AutoX 和藍色 AutoX 型汽車) 的預測數量和市占百分比,他們可以此範例所示,建立計畫變數預測的 .csv 檔案:
Name,AdvAcctForecastSetUse.Name,Status,ProductionModel.Name,ProductionLocation.Name,Product.Name,PeriodId,ForecastedQuantity,MarketSharePercent,ExternalReferenceNumber
FastCars AutoX Chennai Red JanFY2023,Fast Cars Variant Set Use,Active,AutoX,Chennai,AutoX Red,026T10000002icqIAA,500,22,FastCars AutoX Chennai Red JanFY2023
FastCars AutoX Chennai Red FebFY2023,Fast Cars Variant Set Use,Active,AutoX,Chennai,AutoX Red,026T10000002icrIAA,600,15,FastCars AutoX Chennai Red FebFY2023
FastCars AutoX Chennai Red MarFY2023,Fast Cars Variant Set Use,Active,AutoX,Chennai,AutoX Red,026T10000002icsIAA,700,26,FastCars AutoX Chennai Red MarFY2023
FastCars AutoX Chennai Blue JanFY2023,Fast Cars Variant Set Use,Active,AutoX,Chennai,AutoX Blue,026T10000002icqIAA,550,10,FastCars AutoX Chennai Blue JanFY2023
FastCars AutoX Chennai Blue FebFY2023,Fast Cars Variant Set Use,Active,AutoX,Chennai,AutoX Blue,026T10000002icrIAA,670,21,FastCars AutoX Chennai Blue FebFY2023
FastCars AutoX Chennai Blue MarFY2023,Fast Cars Variant Set Use,Active,AutoX,Chennai,AutoX Blue,026T10000002icsIAA,890,18,FastCars AutoX Chennai Blue MarFY2023
FastCars AutoX Bangalore Red JanFY2023,Fast Cars Variant Set Use,Active,AutoX,Bangalore,AutoX Red,026T10000002icqIAA,250,11,FastCars AutoX Bangalore Red JanFY2023
FastCars AutoX Bangalore Red FebFY2023,Fast Cars Variant Set Use,Active,AutoX,Bangalore,AutoX Red,026T10000002icrIAA,340,25,FastCars AutoX Bangalore Red FebFY2023
FastCars AutoX Bangalore Red MarFY2023,Fast Cars Variant Set Use,Active,AutoX,Bangalore,AutoX Red,026T10000002icsIAA,560,34,FastCars AutoX Bangalore Red MarFY2023
FastCars AutoX Bangalore Blue JanFY2023,Fast Cars Variant Set Use,Active,AutoX,Bangalore,AutoX Blue,026T10000002icqIAA,700,9,FastCars AutoX Bangalore Blue JanFY2023
FastCars AutoX Bangalore Blue FebFY2023,Fast Cars Variant Set Use,Active,AutoX,Bangalore,AutoX Blue,026T10000002icrIAA,650,12,FastCars AutoX Bangalore Blue FebFY2023
FastCars AutoX Bangalore Blue MarFY2023,Fast Cars Variant Set Use,Active,AutoX,Bangalore,AutoX Blue,026T10000002icsIAA,430,35,FastCars AutoX Bangalore Blue MarFY2023
建立 CSV 檔案的考量事項
- 使用唯一名稱或號碼填入 ExternalReferenceNumber。您可在更新插入期間使用此欄位,以識別現有記錄。例如,如果您想要將 AutoX 汽車的計畫數量,在 2023 年 1 月期間針對清奈工廠位置變更為 600 輛,請使用此格式。
如果 Salesforce 中存在和目標物件中相同 ExternalReferenceNumber 的記錄,則系統會使用 .csv 檔案中所提供的值來更新記錄。否則,系統會在目標物件中插入新記錄。ProgramQuantity,ExternalReferenceNumber 600,FastCars AutoX Chennai JanFY2023
備註 在更新插入作業期間,您也可以使用「名稱」欄位作為「外部識別碼欄位 API 名稱」。但如果有多個名稱相同的記錄存在,則 .csv 檔案上載程序會失敗並顯示DUPLICATE_EXTERNAL_ID:Name: more than one record found for external id field錯誤。 - 您無法針對「週期」物件使用關係欄位名稱 (
RelationshipName.IndexedFieldName),因為其僅具有識別碼作為對應欄位,且您無法自訂物件以新增外部識別碼欄位。
此文章是否解決您的問題?
請讓我們知道,以便我們改進!
