Preparare il file per l'importazione
1.
Gli Importazioniesempi –e infogli generaliscreenshot di questa pagina usano un'associazione inventata, Save The Unicorns: nomi, indirizzi e dati sono di fantasia.
RiseActSave permetteThe Unicorns ha l'elenco dei sostenitori in un foglio di calcolo e vuole portarlo in Riseact. Prima di importare sostenitoriprepara e donazioni dail file CSV.con queste regole.
A cosa serve
Gli importatori sono pensati come strumento di onboarding: servono a caricare i dati iniziali di un'organizzazione, non a manteneretenere una sincronizzazione continua consincronizzato un CRM esterno. Le regole valgono per sostenitori e donazioni. Come importare: Importare sostenitori e Importare donazioni.
Cosa
Principifa generali
NessunNonaggiornamentoaggiornadeii recordesistenti.esistenti:Sese un recordcorrispondentecorrispondeesistea uno già(inpresente,base alle chiavi di deduplica), viene mantenuto cosìresta com'è:è e i datipresentinon vengono mai sovrascritti.Idempotenza.SiReimportarepuòloripeterestessosenzafilecrearenondoppioni:crea duplicati. Lala deduplicaavviene tramiteusa i riferimenti esterni (external ref) o, per le righe senza chiave,tramiteun marcatore interno di riga.Report in app.Ogni importazionegeneralascia un eventoconsultabilein Impostazioni→> Importazioni, con stato, conteggi e righescartate.scartate,Aletermine viene inviata anchemanda un'email di riepilogo.Un'importazionePerperogni organizzazione ne gira una allavolta.volta:Finchéfinchéun'importazioneuna è incorso,corso nonsenepuò avviareparte un'altra per la stessa organizzazione.altra.
Limiti del file
Un (unica supportata)
Filefile più grandigrande vannova suddivisidiviso in più importazioni.
Formato dell'intestazione
Intestazioni
Le intestazioni sono minuscole,in minuscolo, con le parole separate da spazi (non snake_case, non Title Case).: Esempio:per esempio first name, supporter external ref, payment date. Il confronto ignora maiuscole/minuscoleMaiuscole e spazi esterni;esterni sono ignorati; gli spazi interni multipli vengonodiventano normalizzatiuno. aFanno uno solo.
Unica eccezione:eccezione le colonne dei campi personalizzati, che mantengono il prefisso custom_ con underscore.il trattino basso.
Regole di formato
Formato dei valori
Valgono per entrambi gli importatori (sostenitori e donazioni).
| Valore | Formato |
|---|---|
| Importi (amount) | x.xx |
2026-12-31, 2026-06-25 13:29:57, 2026-06-25T13:29:57.566Z. Formati 31/12/2026 non sono accettati. YYYY-AAAA-MM-DDGGITCodice fiscale t/ftrue/false0/1"x,y,z" Regole di deduplica
supporter external ref → email → ssn → vatdonation external refetichette.
Campi personalizzati
- Si importano
conin colonnededicatecustom_<key>, dove<key>è la chiavestabile di una definizione didel campopersonalizzatogiàesistentecreato nell'organizzazione (es.per esempiocustom_numero_tessera). LaIldefinizionecampo deve esistere già: l'importazione noncreanenuovi campi personalizzati.crea. Unachiave<key>inesistentesconosciutageneradà un errore di intestazione. Come crearli: Aggiungere dati tuoi a sostenitori e donazioni.La colonna viene assegnata all'entità della sua definizione: unUn campo di tipo sostenitore va sul sostenitore, uno di tipo donazionevasulladonazionedonazione.(anche nel file donazioni denormalizzato).
Consiglio
Reportdi edfundraising
Prima
Al5.000 termine,righe inprova Impostazionicon →tre: Importazioniun sisostenitore trovano:di Banchetti degli Unicorni, uno di Adotta un unicorno e uno senza email. Leggi l'esito, poi importa il resto.
Problemi comuni
statoL'importazionedell'importazione:fallisceInsubito,attesa,senzaIncrearecorso,nulla:Completata,èFallita;
Un errore a livello di file (CSV illeggibile, intestazioni non valide, file troppo grande,grande. controllo preliminare fallito) fa fallire l'intera importazione senza creare alcun record. Un errore su una singola riga non blocca l'importazione: la riga finisce tra quelle scartateCorreggi e ricarica.
Carica i sostenitori da un file CSV. VediCSV le regolesole generalirighe soprascartate, (formatocorreggile file,e date,ricaricale.
Nessuna
Vedi colonnaanche
supporter external ref → email → ssn → vat