Вы находитесь здесь:
Создание CSV-файла
Следуйте этим рекомендациям при подготовке CSV-файла к импорту.
Требуемые версии
| Доступно в версиях: Lightning Experience |
| Доступно в версиях: Enterprise Edition, Unlimited Edition и Developer Edition |
- Первая строка CSV-файла содержит имена полей объекта, в который нужно загрузить записи. Считайте их столбцами в электронной таблице.Например, при загрузке записей в объект «Факт прогноза программы производства» первая строка CSV-файла выглядит следующим образом.
Важно!Многие объекты в Salesforce связаны с другими объектами. Помните о следующих дополнительных факторах при добавлении полей взаимосвязи в первую строку.
- Добавьте ссылку на связанный объект в CSV-файл.
- Чтобы описать взаимосвязь между объектом и его родительской записью, воспользуйтесь
RelationshipName.IndexedFieldName, гдеRelationshipName— это имя взаимосвязи поля, аIndexedFieldName— это индексированное имя поля, уникально определяющее родительскую запись. - Используйте вызов descriptionSObjects() в API для получения значения свойства 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-файле имеют неравные периоды, загрузка не выполняется с ошибкой.
- Мы используем Bulk API для загрузки записей. Дополнительные сведения о том, как подготовить CSV-файл к загрузке Bulk API, см. в разделе «Подготовка CSV-файлов»
Производитель автомобилей под именем «Быстрые автомобили» хочет запустить автомобиль AutoX в 2025 году. Менеджер программы в поставщике производства, «Компоненты автомобиля», хочет прогнозировать количество программы, ожидаемый доход на единицу продукции, прогнозируемое количество и прогнозируемый доход на январь 2023 года, февраль 2023 года и март 2023 года для расположений завода в Ченнае и Бангалоре.
Создайте CSV-файл для прогнозов программы в этом формате.
| Имя | AdvAcctForecastSetUse.Name | Статус | ProductionModel.Name | ProductionLocation.Name | PeriodID | ProgramQuantity | ExpectedRevenuePerUnit | MarketSharePercent | ForecastedQuantity | Прогнозируемый доход | ExternalReferenceNumber |
|---|---|---|---|---|---|---|---|---|---|---|---|
| FastCars AutoX Chennai JanFY2023 | Использование набора программ для быстрых автомобилей | Активно | AutoX | Ченнай | 026T10000002icqIAA | 500 | 250000 | 22 | 150000 | 300 | FastCars AutoX Chennai JanFY2023 |
| FastCars AutoX Chennai FebFY2023 | Использование набора программ для быстрых автомобилей | Активно | AutoX | Ченнай | 026T10000002icrIAA | 600 | 120000 | 15 | 97000 | 350 | FastCars AutoX Chennai FebFY2023 |
| FastCars AutoX Chennai MarFY2023 | Использование набора программ для быстрых автомобилей | Активно | AutoX | Ченнай | 026T10000002icsIAA | 700 | 230000 | 26 | 230000 | 400 | FastCars AutoX Chennai MarFY2023 |
| FastCars AutoX Bangalore JanFY2023 | Использование набора программ для быстрых автомобилей | Активно | AutoX | Бангалор | 026T10000002icqIAA | 550 | 89000 | 10 | 54000 | 450 | FastCars AutoX Bangalore JanFY2023 |
| FastCars AutoX Bangalore FebFY2023 | Использование набора программ для быстрых автомобилей | Активно | AutoX | Бангалор | 026T10000002icrIAA | 670 | 350000 | 21 | 340000 | 500 | FastCars AutoX Bangalore FebFY2023 |
| FastCars AutoX Bangalore MarFY2023 | Использование набора программ для быстрых автомобилей | Активно | AutoX | Бангалор | 026T10000002icsIAA | 890 | 150000 | 18 | 450000 | 550 | FastCars AutoX Bangalore 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
Если менеджер программы в «Компоненты автомобиля» хочет прогнозировать прогнозируемое количество и процент доли рынка на уровне варианта (красный цвет AutoX и синий цвет AutoX) на три месяца (январь 2023, февраль 2023 и март 2023) для расположений Ченнай и Бангалор, он может создать 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 на 600 для периода января 2023 года для расположения Ченнай, используйте этот формат.
Если запись существует в 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) не может использоваться для объекта «Период», так как поле поиска содержит только код, а объект не может быть настроен для добавления поля внешнего кода.

