Usted está aquí:
Crear un archivo .CSV
Siga estas directrices cuando prepare un archivo .csv para importar.
Ediciones necesarias
| Disponible en: Lightning Experience |
| Disponible en: Enterprise Edition, Unlimited Edition y Developer Edition |
- La primera fila del archivo .csv enumera los nombres de campo del objeto al que desea cargar los registros. Piense en estos como las columnas de una hoja de cálculo.Por ejemplo, si carga registros en el objeto Hecho de previsión de programa de Manufacturing, la primera fila en el archivo .csv tiene este aspecto.
ImportanteMuchos objetos en Salesforce están relacionados con otros objetos. Tenga en cuenta estos factores adicionales al enumerar campos de relaciones en la primera fila.
- Agregue una referencia a un objeto relacionado en un archivo CSV.
- Para describir la relación entre un objeto y su principal, utilice
RelationshipName.IndexedFieldName, dondeRelationshipNamees el nombre de relación del campo yIndexedFieldNamees el nombre de campo indexado que identifica de forma exclusiva el registro principal. - Utilice la llamada describeSObjects() en la API para obtener el valor de la propiedad relationshipName para un campo.
Este es un ejemplo de campos de relaciones:
AdvAcctForecastSetUsees el padre deManufacturingProgramForecastFact.- Nombre es un campo indexado en
AdvAcctForecastSetUse. Como resultado, puede utilizarAdvAcctForecastSetUse.Namepara identificar de forma exclusiva el registro deAdvAcctForecastSetUse.
Nota Asegúrese de utilizar valores exclusivos en el campo indexado. Si hay más de un registro con el mismo valor, el proceso de carga de archivo .csv falla con el errorDUPLICATE_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 - Cada fila posterior se corresponde con un registro en Salesforce. Un registro está compuesto de una serie de campos delimitados por comas.
FastCars AutoX Chennai JanFY2023,Fast Cars Program Set Use,Active,AutoX,Chennai,026T10000002icqIAA,500,250000,22,150000,300,FastCars AutoX Chennai JanFY2023 - Asegúrese de que todos los registros de un archivo .csv son para el mismo objeto. Especificará el objeto de destino cuando importe el archivo CSV.
- Utilice solo comas como delimitadores.
- Asegúrese de que los archivos .csv tienen el formato UTF-8.
- Asegúrese de que todos los productos en el archivo .csv tienen el mismo número de periodos asociados. Si los productos en el archivo .csv tienen periodos no iguales, la carga falla con un error.
- Utilizamos la API masiva para cargar registros. Para obtener más información sobre cómo preparar un archivo .csv para la carga masiva de la API, consulte Preparar archivos CSV.
Un fabricante de vehículos denominado Fast Cars desea lanzar el vehículo AutoX en 2025. El gerente de programa de un proveedor de fabricación, Componentes de vehículo, desea pronosticar la cantidad de programa, los ingresos previstos por unidad, la cantidad pronosticada, los ingresos para enero de 2023, febrero de 2023 y marzo de 2023 para las ubicaciones de planta Chennai y Bangalore.
Cree un archivo .csv para previsiones de programa en este formato.
| Nombre completo | AdvAcctForecastSetUse.Name | Estado | ProductionModel.Name | ProductionLocation.Name | PeriodID | ProgramQuantity | ExpectedRevenuePerUnit | MarketSharePercent | ForecastedQuantity | ForecastedRevenue | ExternalReferenceNumber |
|---|---|---|---|---|---|---|---|---|---|---|---|
| FastCars AutoX Chennai JanFY2023 | Uso del conjunto de programa Autos rápidos | Activo | AutoX | Chennai | 026T10000002icqIAA | 500 | 250000 | 22 | 150000 | 300 | FastCars AutoX Chennai JanFY2023 |
| FastCars AutoX Chennai FebFY2023 | Uso del conjunto de programa Autos rápidos | Activo | AutoX | Chennai | 026T10000002icrIAA | 600 | 120000 | 15 | 97000 | 350 | FastCars AutoX Chennai FebFY2023 |
| FastCars AutoX Chennai MarFY2023 | Uso del conjunto de programa Autos rápidos | Activo | AutoX | Chennai | 026T10000002icsIAA | 700 | 230000 | 26 | 230000 | 400 | FastCars AutoX Chennai MarFY2023 |
| FastCars AutoX Bangalore JanFY2023 | Uso del conjunto de programa Autos rápidos | Activo | AutoX | Bangalore | 026T10000002icqIAA | 550 | 89000 | 10 | 54000 | 450 | FastCars AutoX Bangalore JanFY2023 |
| FastCars AutoX Bangalore FebFY2023 | Uso del conjunto de programa Autos rápidos | Activo | AutoX | Bangalore | 026T10000002icrIAA | 670 | 350000 | 21 | 340000 | 500 | FastCars AutoX Bangalore FebFY2023 |
| FastCars AutoX Bangalore MarFY2023 | Uso del conjunto de programa Autos rápidos | Activo | AutoX | Bangalore | 026T10000002icsIAA | 890 | 150000 | 18 | 450000 | 550 | FastCars AutoX Bangalore MarFY2023 |
Este es un ejemplo del archivo 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
Si el gestor de programa de Componentes de vehículo desea pronosticar la cantidad prevista y el porcentaje de cuota de mercado a nivel de la variante (color rojo AutoX y color azul AutoX) durante tres meses (enero de 2023, febrero de 2023 y marzo de 2023) para las ubicaciones Chennai y Chennai, puede crear un archivo .csv para las previsiones de variantes de programa como se muestra en este ejemplo.
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
Consideraciones para crear un archivo CSV
- Rellene ExternalReferenceNumber con un nombre o un número exclusivo. Puede utilizar este campo durante la alteración para identificar registros existentes. Por ejemplo, desea cambiar la cantidad de vehículos del programa a 600 para el periodo de enero de 2023 para la ubicación Chennai, utilice este formato.
Si existe un registro en Salesforce con el mismo ExternalReferenceNumber en el objeto de destino, el sistema actualiza el registro con los valores proporcionados en el archivo .csv. De lo contrario, el sistema inserta un nuevo registro en el objeto de destino.ProgramQuantity,ExternalReferenceNumber 600,FastCars AutoX Chennai JanFY2023
Nota También puede utilizar el campo Nombre como Nombre de API de campo de Id. externo durante la operación de modificación. Pero si hay más de un registro con el mismo nombre, el proceso de carga de archivo .csv falla con el errorDUPLICATE_EXTERNAL_ID:Name: more than one record found for external id field. - No puede utilizar el nombre del campo de relación (
RelationshipName.IndexedFieldName) para el objeto Periodo porque solo tiene Id. como el campo de búsqueda y no puede personalizar el objeto para agregar un campo de Id. externo.

