Raggruppare gli errori del Data Loader per correggere solo i record rifiutati

Dopo un import con Salesforce Data Loader, le righe rifiutate finiscono in un CSV: Richard C di AIL Studio mostra come raggrupparle per messaggio di errore e ricaricare solo quelle corrette¹.

Data Loader scrive due file CSV, uno che inizia con success e uno con error. Il file degli errori ha una colonna che spiega perché il caricamento è fallito. Il file dei successi elenca le righe caricate con gli eventuali nuovi Id. Per capire che cosa non è entrato e perché, bisogna aprire l’error CSV, non fermarsi al success CSV¹.

Si può arrivare ai due file da Data Loader con View Successes e View Errors, oppure aprirli dalla cartella selezionata alla schermata Finish. Avviso pratico: se il file sorgente aveva colonne chiamate success o error, le intestazioni dell’output possono risultare confuse. Conviene rinominare quei campi prima di analizzare i risultati¹.

Molti messaggi hanno un codice, poi due punti, poi un testo più lungo. Si raggruppa usando il prefisso prima del primo due punti. Nell’esempio dell’articolo i gruppi attesi sono tre: DUPLICATE_VALUE, REQUIRED_FIELD_MISSING, INSUFFICIENT_ACCESS_ON_CROSS_REFERENCE_ENTITY. Due righe per i primi due gruppi, una per il terzo. L’esempio è dichiarato fittizio, non proviene da un’org cliente¹.

Su un foglio con la colonna ERROR in E, si estrae la chiave in F2 e si riempie verso il basso: =IF(E2="","",IFERROR(LEFT(E2,FIND(":",E2)-1),E2)) Si contano quindi le occorrenze in G2: =IF(F2="","",COUNTIF(F:F,F2)) Poi si copia la colonna F, si incolla come valori e si rimuovono i duplicati per ottenere l’elenco dei gruppi. Infine si filtra per chiave e si lavora un gruppo alla volta¹.

Si può fare via script. L’articolo propone un estratto in Python, solo libreria standard, che legge error_contacts.csv, prende il testo prima del primo due punti e conta le occorrenze:

import csv
from collections import Counter

def group_key(message):
    message = (message or "").strip()
    return message.split(":", 1)[0] if message else "(blank)"

with open("error_contacts.csv", newline="", encoding="utf-8") as handle:
    rows = list(csv.DictReader(handle))

counts = Counter(group_key(r.get("ERROR")) for r in rows)

for key, n in counts.most_common():
    print(n, key)

Sull’esempio stampa 2 DUPLICATE_VALUE, 2 REQUIRED_FIELD_MISSING, 1 INSUFFICIENT_ACCESS_ON_CROSS_REFERENCE_ENTITY¹.

La correzione procede per gruppi, mappando ciascun codice alle voci di Salesforce Help. Per DUPLICATE_VALUE, Help indica un duplicato in un campo marcato Unique: bisogna trovare il campo mappato e modificare i valori in collisione. Nell’esempio, Legacy_Id__c ha il valore CT-001 ripetuto. Per REQUIRED_FIELD_MISSING, Help indica un campo obbligatorio mancante: si aggiunge il valore nel CSV degli errori e si importa di nuovo quel file. Per Insufficient access rights on cross-reference id, Help elenca cause tipiche: Id errato, record cancellato o non condiviso con l’utente che carica o con il proprietario della riga. Si riduce la dimensione del batch a 1 per isolare l’Id problematico. Non si inventano Id di Account per sbloccare l’errore¹.

Se la maggior parte delle righe è già entrata, non si rilancia il file intero. Si ricaricano solo le righe corrette dall’error CSV per evitare duplicati nei successi¹.

Ci sono limiti. Le righe accettate ma sbagliate, per esempio con AccountId errato, non compaiono nell’error CSV. Due messaggi diversi, anche se simili, restano gruppi separati. Il file indica un problema di riferimento incrociato, non la sharing rule precisa che lo ha causato. L’articolo non ha interrogato alcuna org Salesforce: ogni team deve riallineare i passaggi alle proprie regole di caricamento. AIL Studio non è affiliata con Salesforce. Salesforce è un marchio di Salesforce, Inc.¹

AIL Studio offre anche un “Salesforce Export Check” da 19 dollari: si pagano i 19 dollari, si inviano via email gli export di Contact e Account a madebyailstudio@gmail.com, si riceve un workbook con i rilievi entro 3 giorni lavorativi dalla ricezione di un export utilizzabile¹.

Se il messaggio non contiene due punti, l’autore suggerisce di cercare nel testo una frase ripetuta, per esempio duplicate value found, e raggruppare su quella¹.