Esportazioni
Riseact esporta sostenitori, donazioni e pagamenti in CSV o Excel: una tabella piatta dei record che corrispondono a un filtro, con le colonne che scegli.
Principi
- Scegli le colonne. La selezione iniziale corrisponde alle colonne delle esportazioni precedenti: se premi subito Esporta ottieni il file di sempre.
- L'identificativo c'è sempre, come prima colonna, anche se non lo selezioni.
- Il file si scarica da Impostazioni > Esportazioni. L'email di fine lavorazione contiene il link a quella pagina, non il file.
- Solo gli amministratori scaricano. Chi ha il permesso di esportazione può richiederla, ma il file lo scarica solo un amministratore dell'organizzazione. L'email di esito va agli amministratori, con il nome di chi l'ha richiesta.
- Il file dura 30 giorni. L'esportazione resta in elenco con filtri e colonne usati e non si può eliminare: è il registro di chi ha portato dati fuori dalla piattaforma.
- Un'esportazione alla volta per organizzazione.
Formati e limiti
| Formato | Righe massime |
|---|---|
| Excel (XLSX) | 100.000 |
| CSV | 1.000.000 |
Il limite si controlla quando richiedi l'esportazione, non a fine elaborazione. Oltre il milione di righe contatta il supporto tecnico.
Il CSV è in UTF-8 con BOM (così Excel legge le lettere accentate), separato da virgole.
Filtri e segmenti
Puoi esportare tutti i record, quelli selezionati a mano, quelli che corrispondono ai filtri attivi o un segmento salvato.
I filtri vengono copiati nell'esportazione al momento della richiesta: modificare dopo il segmento non cambia le esportazioni già fatte. Li trovi nella pagina di dettaglio.
Modelli di esportazione
Un modello di esportazione è una selezione di colonne salvata con un nome, per un tipo di esportazione (sostenitori, donazioni o pagamenti).
Nella finestra di esportazione, sopra le colonne, c'è la tendina dei modelli:
- Campi predefiniti è la selezione iniziale;
- scegliendo un modello, le colonne diventano quelle del modello;
- se poi cambi una colonna, la tendina passa a Modello personalizzato.
I modelli si gestiscono in Impostazioni > Esportazioni > Modelli di esportazione. Per crearne uno scegli tipo, nome e colonne; con l'interruttore Postprocessa l'export puoi associargli uno script di post-elaborazione. Il tipo non si cambia dopo la creazione: per un altro tipo duplica il modello.
Un modello contiene solo colonne ed eventualmente uno script, non dati né filtri. Modificarlo o eliminarlo non cambia le esportazioni già fatte. La colonna identificativo non si salva nel modello, perché viene scritta comunque.
Per creare e modificare i modelli serve il permesso di esportazione del tipo corrispondente.
Script di post-elaborazione
Un'esportazione CSV può passare da uno script Python scritto da te prima di essere pubblicata, per esempio per mettere la maiuscola ai nomi. Vedi Script di post-elaborazione.
Nomi delle colonne
L'intestazione del file è la chiave della colonna, non l'etichetta tradotta, così il file è lo stesso qualunque sia la lingua di chi esporta. Le etichette compaiono nella finestra di selezione e, nelle pagine di ogni esportazione, nella colonna "Nome in Riseact".
I nomi seguono la convenzione dell'importatore: minuscoli, parole separate da spazi.
Le colonne che esistono anche nell'importatore hanno lo stesso nome; le altre portano
il prefisso dell'entità di provenienza (donation , campaign , payment method ,
payment , payments , last payment ).
Il prefisso supporter dipende dal file:
- nell'esportazione sostenitori le colonne del sostenitore non hanno prefisso, tranne le statistiche, che si chiamano allo stesso modo in tutti i file;
- nelle esportazioni donazioni e pagamenti tutte le colonne del sostenitore hanno il prefisso.
Solo custom_<chiave> e privacy_<codice> usano l'underscore, come nell'importatore.
Formato dei valori
Gli stessi formati dell'importatore, così puoi esportare, correggere in Excel e reimportare.
| Tipo | Formato |
|---|---|
| Importi | x.xx, punto decimale, due decimali |
| Date | YYYY-MM-DD |
| Data e ora | ISO 8601, YYYY-MM-DDTHH:MM:SS+00:00 |
| Booleani | true / false, vuoto se non impostato |
| Tag e altri multivalore | separati da virgola nella stessa cella |
| Enumerazioni (tipo donatore, stato, frequenza) | il valore memorizzato, non l'etichetta |
I booleani non sono più SI / NO come nelle vecchie esportazioni: l'importatore
non li accetta.
Reimportare un file esportato
Si può fare con l'esportazione sostenitori, se contiene solo colonne che
l'importatore conosce (elencate in Importazioni). Una
colonna sconosciuta fa fallire il caricamento. Le colonne identificativo (id,
supporter id, donation id) possono restare: l'importatore le ignora.
Le esportazioni donazioni e pagamenti non si reimportano così come sono: le
colonne del sostenitore hanno il prefisso e l'importatore donazioni non le
riconosce. Corrispondono solo le colonne della donazione (campaign name,
donation external ref, payment method, amount, payment date,
donation tags). Inoltre il file dei pagamenti ha una riga per rata, mentre
l'importatore crea una donazione per riga.
Nessun risultato
Una ricerca senza risultati produce un'esportazione completata con la sola riga di intestazione.
Fonte: https://dev.riseact.org/docs/exporters/overview. Copia automatica da dev.riseact.org: non modificare qui, le modifiche vanno fatte sulla documentazione Docusaurus.