Você está aqui:
Criar um arquivo .CSV
Siga estas diretrizes ao preparar um arquivo .csv para importação.
Edições obrigatórias
| Disponível em: Lightning Experience |
| Disponível em: Enterprise, Unlimited e Developer Editions |
- A primeira linha no arquivo .csv lista os nomes de campo do objeto para o qual você deseja carregar os registros. Pense nisto como as colunas em uma planilha.Por exemplo, se você carregar os registros no objeto Fato de previsão do programa de manufatura, a primeira linha do arquivo .csv ficará da seguinte maneira.
ImportanteMuitos objetos no Salesforce estão relacionados a outros objetos. Lembre-se destes fatores adicionais ao listar os campos de relacionamento na primeira linha.
- Adicione uma referência a um objeto relacionado em um arquivo CSV.
- Para descrever o relacionamento entre um objeto e seu pai, use
RelationshipName.IndexedFieldName, em queRelationshipNameé o nome do relacionamento do campo eIndexedFieldNameé o nome do campo indexado que identifica exclusivamente o registro pai. - Use a chamada describeSObjects() na API para obter o valor da propriedade relationshipName para um campo.
Aqui está um exemplo de campos de relacionamento:
AdvAcctForecastSetUseé o pai deManufacturingProgramForecastFact.- Nome é um campo indexado em
AdvAcctForecastSetUse. Como resultado, você pode usarAdvAcctForecastSetUse.Namepara identificar o registro deAdvAcctForecastSetUsede maneira exclusiva.
Nota Use valores exclusivos no campo indexado. Se houver mais de um registro com o mesmo valor, o processo de carregamento do arquivo .csv falhará com o erroDUPLICATE_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 linha subsequente corresponde a um registro no Salesforce. Um registro consiste em uma série de campos delimitados por vírgulas.
FastCars AutoX Chennai JanFY2023,Fast Cars Program Set Use,Active,AutoX,Chennai,026T10000002icqIAA,500,250000,22,150000,300,FastCars AutoX Chennai JanFY2023 - Garanta que todos os registros em um arquivo .csv sejam para o mesmo objeto. Você especificará o Objeto de destino quando importar o arquivo CSV.
- Use apenas vírgulas como delimitadores.
- Garanta que os arquivos .csv estejam no formato UTF-8.
- Garanta que todos os produtos no arquivo .csv tenham o mesmo número de períodos associados. Se os produtos no arquivo .csv tiverem períodos diferentes, o upload falhará com um erro.
- Usamos a API em massa para carregar registros. Para obter mais informações sobre como preparar um arquivo .csv para upload da API em massa, consulte Preparar arquivos CSV
Um fabricante de carros chamado Carros rápidos quer lançar o carro AutoX em 2025. O gerente de programa de um fornecedor de manufatura, Componentes de carro, quer prever a quantidade do programa, a receita esperada por unidade, a quantidade prevista, a receita de previsão para janeiro de 2023, fevereiro de 2023 e março de 2023 para os locais de planta Chennai e Bangalore.
Crie um arquivo .csv para previsões do programa neste formato.
| Nome | AdvAcctForecastSetUse.Name | Status | ProductionModel.Name | ProductionLocation.Name | PeriodID | ProgramQuantity | ExpectedRevenuePerUnit | MarketSharePercent | ForecastedQuantity | ForecastedRevenue | ExternalReferenceNumber |
|---|---|---|---|---|---|---|---|---|---|---|---|
| FastCars AutoX Chennai JanFY2023 | Uso do conjunto do programa Carros rápidos | Ativo | AutoX | Chennai | 026T10000002icqIAA | 500 | 250000 | 22 | 150000 | 300 | FastCars AutoX Chennai JanFY2023 |
| FastCars AutoX Chennai FebFY2023 | Uso do conjunto do programa Carros rápidos | Ativo | AutoX | Chennai | 026T10000002icrIAA | 600 | 120000 | 15 | 97000 | 350 | FastCars AutoX Chennai FebFY2023 |
| FastCars AutoX Chennai MarFY2023 | Uso do conjunto do programa Carros rápidos | Ativo | AutoX | Chennai | 026T10000002icsIAA | 700 | 230000 | 26 | 230000 | 400 | FastCars AutoX Chennai MarFY2023 |
| FastCars AutoX Bangalore JanFY2023 | Uso do conjunto do programa Carros rápidos | Ativo | AutoX | Bangalore | 026T10000002icqIAA | 550 | 89000 | 10 | 54000 | 450 | FastCars AutoX Bangalore JanFY2023 |
| FastCars AutoX Bangalore FebFY2023 | Uso do conjunto do programa Carros rápidos | Ativo | AutoX | Bangalore | 026T10000002icrIAA | 670 | 350000 | 21 | 340000 | 500 | FastCars AutoX Bangalore FebFY2023 |
| FastCars AutoX Bangalore MarFY2023 | Uso do conjunto do programa Carros rápidos | Ativo | AutoX | Bangalore | 026T10000002icsIAA | 890 | 150000 | 18 | 450000 | 550 | FastCars AutoX Bangalore MarFY2023 |
Aqui está um exemplo do arquivo 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
Se o gerente de programa de Componentes de carro quiser prever a quantidade prevista e o percentual de participação no mercado no nível de variante (cor AutoX vermelho e cor AutoX azul) por três meses (janeiro de 2023, fevereiro de 2023 e março de 2023) para os locais Chennai e Bangalore, ele poderá criar um arquivo .csv para as previsões de variante do programa, como mostrado neste exemplo:
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
Considerações para criar um arquivo CSV
- Preencha ExternalReferenceNumber com um nome ou um número exclusivo. Você pode usar esse campo durante a opção inserir e atualizar para identificar registros existentes. Por exemplo, você deseja alterar a quantidade do programa de carros AutoX para 600 no período de janeiro de 2023 para o local Chennai, use este formato.
Se houver um registro no Salesforce com o mesmo ExternalReferenceNumber no objeto de destino, o sistema atualizará o registro com os valores fornecidos no arquivo .csv. Caso contrário, o sistema inserirá um novo registro no objeto de destino.ProgramQuantity,ExternalReferenceNumber 600,FastCars AutoX Chennai JanFY2023
Nota Você também pode usar o campo Nome como o Nome da API do campo de ID externo durante a operação de inserir e atualizar. Porém, se houver mais de um registro com o mesmo nome, o processo de upload do arquivo .csv falhará com o erroDUPLICATE_EXTERNAL_ID:Name: more than one record found for external id field. - Você não pode usar o nome do campo de relacionamento (
RelationshipName.IndexedFieldName) para o objeto Período, pois ele tem apenas ID como campo de pesquisa e não pode personalizar o objeto para adicionar um campo de ID externo.

