Prepara un file CSV per importare o aggiornare dati in Salesforce

Preparazione dei file CSV

• I file devono essere in formato UTF-8.
• L'API in blocco supporta solo le virgole come delimitatore.
  • Se stai utilizzando un computer internazionale, il file .CSV generato su Excel molto probabilmente non sarà delimitato da virgole. Puoi verificare se il delimitatore di file .CSV è una virgola aprendolo con l'app Blocco note sul tuo computer.
  • Se vedi Tom, Jones; buyer@salesforcesample.com   significa che il delimitatore corrente è un punto e virgola invece di una virgola. Ciò comporterà problemi di importazione con il file.
    • Sostituisci i punti e virgola con le virgole. Su un PC, ad esempio, puoi fare CTRL + H con la tastiera per trovare, sostituire e quindi salvare il file.
• L'API in blocco è ottimizzata per l'elaborazione di grandi set di dati e ha un formato rigoroso per i file CSV . Il modo più semplice per elaborare i file CSV è abilitare Bulk API per Data Loader. 
• È necessario includere tutti i campi obbligatori quando si crea un record. 
• Se stai aggiornando un record, tutti i campi che non sono definiti nel file CSV vengono ignorati durante l'aggiornamento.

Campi relazione in una riga di intestazione

1 FirstName, LastName, ReportsTo.Email
2 Tom, Jones, buyer@salesforcesample.com

1. Puoi usare una relazione da "genitore a genitore", ma non puoi usare una relazione da "genitore a figlio".
2. Puoi usare una relazione "figlio-genitore", ma non puoi estenderla per usare una relazione "figlio-genitore-nonno".
3. È possibile utilizzare solo campi indicizzati sull'oggetto "genitore".
   • Un campo personalizzato viene indicizzato se è selezionato il relativo campo ID esterno.
   • Un campo standard viene indicizzato se la relativa proprietà idLookup è impostata su  true. 
   • Vedi la colonna Proprietà campo nella tabella dei campi per gli  oggetti standard.  

Campi relazione per oggetti personalizzati

1 Nome, Mother_Of_Child__r.External_ID__c
2 CustomObject1,123456

Relazioni per campi polimorfici

1. Il campo WhoId è polimorfico e ha una relazioneNome di  Who. Si riferisce a un lead e il campo Email indicizzato identifica in modo univoco il record principale.
2. Il campo OwnerId non è polimorfico e ha una relationshipName di  Owner. Si riferisce a un utente e il campo ID indicizzato identifica in modo univoco il record padre.
    

1 Oggetto, Priorità, Stato, Lead: Who.Email, OwnerId
2 Campo di riferimento polimorfico Test Bulk API, Normal, NotStarted, lead@salesforcesample.com , 005D0000001AXYz

• Il delimitatore per i valori di campo in una riga deve essere una virgola.
• Se un valore di campo contiene una virgola, una nuova riga o virgolette doppie, il valore del campo deve essere contenuto tra virgolette doppie: ad esempio, "Direttore delle operazioni, regione occidentale".
• Se un valore di campo contiene virgolette doppie, le virgolette doppie devono essere precedute da un'altra virgoletta doppia: ad esempio, "Questo è il" "gold" "standard".
• I valori dei campi non vengono tagliati. Uno spazio prima o dopo una virgola di delimitazione è incluso nel valore del campo. Uno spazio prima o dopo una virgoletta doppia genera un errore per la riga.
  • Ad esempio, John, Smith è valido; John, Smith è valido, ma il secondo valore è "Smith"; . "John", "Smith" non è valido.
• I valori dei campi vuoti vengono ignorati quando aggiorni i record. Per impostare un valore di campo su null, utilizzare un valore di campo di # N / D.
• I campi con un doppio tipo di dati possono includere valori frazionari. I valori possono essere memorizzati in notazione scientifica se il numero è abbastanza grande (o, per i numeri negativi, abbastanza piccolo), come indicato dalla specifica  W3C XML Schema Part 2: Datatypes Second Edition .

• Come soluzione alternativa, gli utenti possono tentare di aprire il file .CSV in Excel e quindi salvare . Questo a volte può correggere alcuni problemi di formattazione. 
• Solo una riga non valida può causare il fallimento dell'intera importazione. È possibile suddividere il CSV in file più piccoli per identificare il record e / o la colonna che causa errori o problemi di importazione.  

File CSV di esempio

1 FirstName, LastName, Title, Reports To.Email, Birthdate, Description
2 Tom, Jones, Senior Director, buyer@salesforcesample.com , 1940-06-07Z, "Auto-descritto come" "il migliore" "guru del branding sulla costa occidentale"
3 Ian, Dury, Chief Imagineer, cto@salesforcesample.com ,, "Esperto di fama mondiale in progettazione logica fuzzy.
4 Influente negli acquisti di tecnologia. "

Considerazioni durante l'importazione di dati in oggetti diversi

• Campi di ricerca  - ID; Un ID Salesforce è una stringa alfanumerica di 15 caratteri con distinzione tra maiuscole e minuscole o 18 caratteri senza distinzione tra maiuscole e minuscole che identifica in modo univoco un particolare record. Per garantire la qualità dei dati, assicurati che tutti gli ID Salesforce immessi in Data Loader siano corretti.
• Campi elenco di selezione: il valore del campo deve corrispondere esattamente a uno dei valori nell'elenco di selezione. se fornisci qualsiasi altro nuovo valore che non esiste nel tuo elenco di selezione, non lo aggiungerà al tuo elenco, piuttosto fallirà il record.
• Campi data: i campi data devono essere formattati come delineato in Formato per i dati "Data" e "Data ora" in un file CSV altrimenti, per un Importazione guidata dei dati non è necessario modificare il formato dei campi data o ora.  
• Campi booleani: è possibile utilizzare il valore True o False per la mappatura. Ad esempio, se hai un campo casella di controllo nel tuo record, per selezionare o deselezionare il valore vero o falso per selezionarlo o deselezionarlo rispettivamente.
• Campi valuta: non è necessario aggiungere virgole o simboli di valuta. Salesforce sceglierà automaticamente il formato in base alle impostazioni di valuta predefinite dell'organizzazione.
• Indirizzo e-mail: assicurarsi che l'e-mail sia formattata correttamente in base a RFC 5321  e non includa caratteri non validi non consentiti in base ai protocolli internazionali di posta elettronica. Alcuni esempi di email non valide potrebbero essere come di seguito:
  • Abc.example.com  (nessun carattere @)
  • A @ b @ c@example.com  (solo uno @ è consentito al di fuori delle virgolette)
  • a "b (c) d, e: f; g <h> i [j \ k] l@example.com  (nessuno dei caratteri speciali in questa parte locale è consentito al di fuori delle virgolette)
  • solo "non" right@example.com  (le stringhe tra virgolette devono essere separate da un punto o l'unico elemento che compone la parte locale)
  • questo è "non \ consentito@esempio.com  (spazi, virgolette e barre rovesciate possono esistere solo se all'interno di stringhe tra virgolette e precedute da una barra rovesciata)
  • questo \ ancora \ "non \\ consentito@esempio.com  (anche se preceduto da una barra rovesciata), gli spazi, le virgolette e le barre rovesciate devono essere comunque contenuti tra virgolette)
  • john..doe @ example.com  (doppio punto prima di @)
  • con avvertenza: Gmail lo lascia passare,  Email address # Local-parte i punti del tutto
  • john.doe @ example..com (doppio punto dopo @)
  • un indirizzo valido con uno spazio iniziale
  • un indirizzo valido con uno spazio finale
• Regola di convalida : assicurati che se hai una regola di convalida applicata a qualsiasi campo, il tuo valore sia conforme ai criteri per quella regola altrimenti fallirà il record. Oppure puoi scegliere di ignorare la regola di convalida per disattivarla prima del caricamento.
• Trigger : assicurati di avere dei trigger sull'oggetto per il quale stai importando o aggiornando i record e che i tuoi record non funzionino a causa di un criterio specifico non soddisfatto. Puoi scegliere di bypassare il trigger disattivandolo prima del caricamento e al termine del caricamento puoi attivarlo di nuovo.

1. Per abbinare automaticamente i campi alle colonne, fare clic su Abbina automaticamente i campi alle colonne. Il Data Loader popola l'elenco nella parte inferiore della finestra in base alla somiglianza dei nomi dei campi e delle colonne. Per un'operazione di cancellazione, la corrispondenza automatica funziona solo sul campo ID. 
2. Per abbinare manualmente i campi alle colonne, fare click e trascinare i campi dall'elenco dei campi Salesforce in alto all'elenco dei nomi delle intestazioni di colonna CSV in basso. Ad esempio, se stai inserendo nuovi record di account in cui il tuo file CSV contiene i nomi di nuovi account, fai click e trascina il campo Nome a destra del campo dell'intestazione della colonna NOME.
3. Facoltativamente, fai click su Salva mappatura per salvare questa mappatura per un utilizzo futuro. Specificare un nome per il file di mapping SDL. Se selezioni un file esistente, il contenuto di quel file viene sostituito. Fai click su Sì per confermare questa azione o fare clic su No per scegliere un altro file. 4. Fai click su OK per utilizzare la mappatura per l'operazione corrente.

• Ritiro per recupero dati
• Inserisci, aggiorna o elimina i dati utilizzando Data Loader
• Importare i dati con l'importazione guidata dati
• Aggiungi gli ID dei record esistenti al tuo file di importazione
• Sostituisci i punti e virgola con le virgole nelle importazioni di dati CSV
• Scelta di un metodo per importare i dati

• Importazione dati: pulisci e prepara i tuoi dati utilizzando Excel 
• Come preparare un file CSV da inserire utilizzando Data Loader