Esportatore FTP: invio automatico di sostenitori e donazioni
L'Esportatore FTP è l'applicazione di Riseact che invia in automatico sostenitori o donazioni a un server FTP, a intervalli regolari (ogni giorno, settimana, mese, trimestre o anno). Lo configuri una volta e da quel momento i dati partono da soli, senza che nessuno debba esportarli e caricarli a mano. Negli esempi l'organizzazione è Save The Unicorns, un'associazione inventata: nomi, segmenti, modelli e dati del server sono fittizi.
A cosa serve
Il problema che risolve
Riseact raramente è l'unico sistema di un'organizzazione. Gli stessi dati servono spesso anche altrove, ad esempio:
- al gestionale
contabile,contabile, che deve registrare le donazioni incassate; - al CRM o database centrale dell'organizzazione (o della sede nazionale o internazionale), che raccoglie i sostenitori di tutti i canali;
- a un sistema di reportistica che produce i numeri per la direzione;
- a un fornitore esterno che lavora sui tuoi sostenitori, come un'agenzia, una tipografia per gli invii postali o un contact center.
Molti di questi sistemi non si collegano direttamente a Riseact, ma sanno leggere un file da una cartella condivisa. Senza automazione qualcuno dovrebbe ogni volta esportare da Riseact, scaricare il file e caricarlo nella cartella giusta. Ègiusta: un lavoro ripetitivo, facile da dimenticare e con il rischio di mandare il file sbagliato o con colonne diverse dalla volta prima.
Che cos'è un server FTP
Un server FTP è uno spazio su internet dove si depositano file, una specie di cassetta delle lettere per i dati. Chi ha le credenziali può lasciarci un file.file; Ilil sistema che deve usarlo va poi a prenderlo da lì. Di solito il server è dell'organizzazione o del fornitore che riceve i dati, non di Riseact.
FTP, FTPS e SFTP sono tre modi (protocolli) per collegarsi a questo spazio. SFTP e FTPS cifrano la connessione e proteggono i dati durante l'invio.invio; Ilil semplice FTP nonno. li cifra: perPer i dati dei donatori preferisci sempre SFTP o FTPS, se il server li supporta. SFTP è anche il più semplice da configurare, perché non richiede certificati.
Come funziona, in pratica
Pensa a un corriere che passa ogni notte. All'orario stabilito Riseact:
- prende i record del segmento che hai scelto, come sono in quel momento;
- tiene tutti i record o solo quelli nuovi, secondo il metodo scelto (vedi sotto);
Il sistema di destinazione legge il file con le sue regole e i suoi tempi. Riseact si occupa solo di consegnarlo.
Ogni file contiene tutti
Tutti i record che in quel momento rientrano nel segmento, nono solo quellii nuovi
Con Solo i nuovi record Riseact ricorda fin dove è laarrivato soluzione(nel piùdettaglio sicura.dell'attività lo vedi alla voce Esportati fino al). Se un invio non riesce, i record di quel periodo partono con il primo invio riuscito successivo. Un sostenitore che dona di nuovo genera una nuova donazione, quindi una nuova riga nel file successivo. Il metodo conta i record creati: un record già inviato e poi modificato non viene rinviato.
Il metodo si sceglie alla creazione dell'attività e non si può cambiare dopo. Per passare all'altro metodo crea una nuova attività.
Perché conviene
- Nessun lavoro
manuale:manuale: i dati partono anche quando nessuno ci pensa, nei weekend e nelle ferie. - Sempre lo stesso
file:file: colonne, ordine e formato non cambiano, quindi il sistema che lo riceve lo legge senza errori. - Dati
aggiornati:aggiornati: il segmento viene riletto a ogni invio, quindi il file comprende anche i sostenitori e le donazioni arrivati nel frattempo. - Più
sicurezza:sicurezza: il file va direttamente da Riseact al server, senza passare dai computer delle persone o dalle email. Controllo:Controllo: il log di ogni attività dice quando è partito l'invio e se ci sono stati errori.
Quando non serve
| Ti serve | Usa |
|---|---|
| Un file da aprire una volta, per un'analisi o un controllo | Il pulsante Esporta in |
| Tenere allineata una lista email | L'integrazione dedicata (vedi Integrazione Mailchimp) |
| Ricevere un file a cadenza fissa (al massimo una volta al giorno) in un sistema esterno | L'Esportatore FTP |
Come è organizzato
Ogni invio automatico si chiama attività. Un'attività risponde a trequattro domande:
| Domanda | Dove la configuri |
|---|---|
| Cosa mando? | Tipo (sostenitori o donazioni), segmento e modello di esportazione |
Puoi avere fino a 5 attività.attività, Adcompletamente esempio una con le donazioni del giorno per la contabilità e una con i sostenitori ogni settimana per la sede centrale,indipendenti: ognuna con il suo server,segmento, iil suoisuo datimodello, il suo server e il suo log.
Esempio. Save The Unicorns raccoglie con due campagne: i banchetti in piazza ("Banchetti degli Unicorni") e le raccolte personali ("Adotta un unicorno"). Il gestionale vuole le donazioni ogni notte. Ci sono due strade:
Prima di configurare un'attività, mettiti d'accordo con chi gestisce il sistema che riceverà i file su quattrocinque punti: quali colonne servono, ogni quanto serve il file, se il sistema vuole ogni volta tutto o solo le novità, se gestisce i record già ricevuti e quali sono i dati di accesso al server.
Prima di iniziare
- Dati del server FTP: protocollo, host, porta, utente, password e cartella di destinazione. Te li fornisce chi gestisce il server che riceverà i file. Il server deve rispettare i requisiti elencati sotto.
- Segmento (facoltativo): se non vuoi esportare tutti i record, crea prima il segmento nella lista Sostenitori o Donazioni (vedi Segmenti di sostenitori e donazioni).
- Modello di esportazione (facoltativo): se vuoi scegliere le colonne del file, crea prima il modello (vedi Modelli di esportazione e storico esportazioni). Senza modello il file usa i Campi
predefiniti.predefiniti.
Requisiti del server
- Raggiungibile da
internet:internet: un server accessibile solo dalla rete interna dell'organizzazione o in VPN non riceve i file. - Accesso con utente e password.
- Cartella di destinazione già
esistente,esistente, in cui l'utente può scrivere, rinominare e cancellare file. Con il solo permesso di scrittura falliscono sia il test di connessione sia l'invio. - Solo per
FTPS:FTPS: certificato valido (non autofirmato) e TLS esplicito. Con SFTP il certificato non serve.
Cosa contiene il file
Colonne:Colonne: solo i campi già presenti in Riseact, con i loro nomi. Non puoi rinominare le colonne né aggiungerne di nuove. Se il sistema che riceve ha un suo tracciato, scegli nel modello di esportazione i campi che più gli si avvicinano.Formato:Formato: CSV oppure Excel (XLSX). Separatore e codifica dei caratteri non sono configurabili.- Nome del
file:file: fisso, non modificabile. È composto da nome dell'attività, tipo di export, data e ora dell'esecuzione, ad esempionomeattività_donations_20261005-030000.csv.csv.
Installare l'Esportatore FTP
3. Dopo l'installazione l'app compare in


Creare un'attività
Nella pagina FTP Exporter clicca Aggiungi attività. La procedura ha quattrocinque passaggi, elencati a destra: Attività, Dati, Metodo, Destinazione, Pianificazione. Con Avanti e Indietro ti sposti tra i passaggi.

1. Attività
Nome
Tipo di

2. Dati
Segmento: "Tutte le donazioni" (o tutti i sostenitori) oppure un segmento salvato. Il segmento viene riletto a ogni
Modello di
Formato del file: CSV (predefinito) o Excel (XLSX).
Nel menu Segmento compaiono i segmenti salvati del tipo scelto al passaggio 1.
Nel menu Modello di export compaiono solo i modelli del tipo scelto al passaggio
Tutti i record: ogni file
Solo

Il metodo non si può cambiare dopo la creazione.
3.4. Destinazione
| Campo | Cosa inserire |
|---|---|
| Protocollo | FTP, FTPS (FTP su TLS esplicito, con certificato valido e non autofirmato) oppure SFTP (su SSH). Predefinito: SFTP. |
| Host | L'indirizzo del |
| Porta | La porta del server (per SFTP di solito 22) |
| Utente e Password | Le credenziali di accesso al server |
| Cartella di destinazione | Percorso assoluto sul server dove caricare i file (es. /export/riseact). La cartella deve esistere già e l'utente deve poterci scrivere, rinominare e cancellare file. |
Prima
Compila i dati del server e, prima di andare 

4.5. Pianificazione
Scegli ogni quanto inviare il file. Ogni esecuzione chiede a Riseact un nuovo export e lo carica sul server. Le date sono fisse, non dipendono dal giorno in cui crei l'attività.
| Frequenza | Quando parte |
|---|---|
| Una volta al giorno | Ogni giorno |
| Una volta a settimana | Ogni lunedì |
| Una volta al mese | Il primo giorno di ogni mese |
| Una volta ogni 3 mesi | Il primo giorno di gennaio, aprile, luglio e ottobre |
| Una volta all'anno | Il primo gennaio di ogni anno |

Gestire le attività

Più in basso, nella configurazione, i dati del server (protocollo, host, utente, cartella)

Vuoi sospendere l'invio per un periodo? Spegni l'interruttore Attiva invece di eliminare l'attività: quando lo riaccendi riparte dalla prossima data utile, senza riconfigurare nulla. Con Solo i nuovi record, il primo invio dopo la pausa comprende anche i record creati nel frattempo.
Problemi comuni
| Cosa vedi | Cosa fare |
|---|---|
| Connessione non riuscita durante il test | Controlla host, porta, protocollo e credenziali con chi gestisce il server. Verifica che il server sia raggiungibile da internet (non solo in VPN) e che la cartella di destinazione esista. |
| Test o invio falliscono anche con credenziali corrette | Verifica che l'utente possa scrivere, rinominare e cancellare file nella cartella: il solo permesso di scrittura non basta. Con FTPS controlla anche che il certificato sia valido e non autofirmato e che il server usi TLS esplicito. |
| Nel log compaiono errori di connessione | Il server non era raggiungibile al momento dell'export. Dal menu Azioni usa Testa configurazione FTP e correggi i dati se servono. |