Skip to main content

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:

  1. prende i record del segmento che hai scelto, come sono in quel momento;
  2. tiene tutti i record o solo quelli nuovi, secondo il metodo scelto (vedi sotto);
crea il file con le colonne del modello di esportazione; lo deposita nella cartella del server FTP; scrive nel log se l'invio è andato bene o no.

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

dall'invio
precedente:MetodoCosa l'Esportatorecontiene nonogni tienefileQuando tracciasceglierlo dicosaTutti hai già inviato. Per mandare solo le novità puoi usare un segmento con un filtro sulle date, ma se un invio fallisce non viene ripetuto erecordTutti i record didel quelsegmento, periodoanche nonquelli arrivanogià a destinazione. Se ilinviatiIl sistema che riceve sostituisce ogni volta i dati o riconosce da solo i record già ricevuti (ad esempio dall'ID),Id). inviareTi serve vedere anche i cambiamenti sui record già inviati. Solo i nuovi recordAl primo invio tutto il segmento; dal secondo in poi solo i record creati dopo l'interoultimo segmentoexport riuscitoIl sistema che riceve aggiunge i dati a quelli che ha già e non deve trovarsi doppioni.

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.
Autonomia: segmenti, modelli e attività li gestisci tu e puoi cambiarli quando serve, senza chiedere a nessuno.

Quando non serve

Ti serveUsa
Un file da aprire una volta, per un'analisi o un controlloIl pulsante Esporta in SostenitoriSostenitori, Donazioni o DonazioniPagamenti (vedi Esportazione sostenitori e donazioni)
Tenere allineata una lista emailL'integrazione dedicata (vedi Integrazione Mailchimp)
Ricevere un file a cadenza fissa (al massimo una volta al giorno) in un sistema esternoL'Esportatore FTP

Come è organizzato

Ogni invio automatico si chiama attività. Un'attività risponde a trequattro domande:

DomandaDove la configuri
Cosa mando?Tipo (sostenitori o donazioni), segmento e modello di esportazione
Tutto o solo le novità?Il metodo: tutti i record o solo i nuovi Dove lo mando?Il server FTP e la cartella di destinazione Quando lo mando?La frequenza: giorno, settimana, mese, trimestre o anno

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:

    Un file unico: un segmento con entrambe le campagne e una sola attività. Nel file la colonna Campagna dice da quale campagna arriva ogni donazione, e con un filtro le separi. Quando una campagna finisce, nel file trovi solo l'altra. Due file separati: un segmento per campagna e due attività, anche verso server o cartelle diverse.

    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 esempio nomeattività_donations_20261005-030000.csv.csv.

    Installare l'Esportatore FTP

      Passaggio Schermata 1. Nel menu a sinistra vai in Applicazioni e clicca App Store. Apri Esportatore FTP. eEsportatore FTP nell'App Store clicca 2. Clicca Installa., Leggileggi la richiesta di autorizzazione e conferma. Richiesta di autorizzazione all'installazione

      3. Dopo l'installazione l'app compare in Applicazioni.Applicazioni: Aprilaaprila. perEsportatore FTP tra le applicazioni installate vedere 4. Si apre la pagina FTP Exporter. conFinché l'elenconon dellecrei attività.un'attività
      Esportatore FTP nell'App Store di Riseact
      L'Esportatorevedi FTPil nell'Appmessaggio Store
      "Nessuna
      Richiesta di autorizzazione all'installazione dell'Esportatore FTP
      Laattività".
      richiestaPagina FTP Exporter senza attività di autorizzazione all'installazione

      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.

      Pagina FTP Exporter senza attività
      La
      pagina FTP ExporterPassaggio primaSchermata di creare la prima attività

      1. Attività


        Nome attività:attività: un nome che spieghi a cosa serve (es. "Donazioni per il gestionale contabile"gestionale"). Il nome compare anche nel nome del file.
        Tipo di export
        :export: Sostenitori o Donazioni. Passaggio 1: nome e tipo Donazioni.
        Passaggio Attività: nome e tipo di export
        Passaggio 1: nome e tipo

        2. Dati

          Segmento: scegli quali record esportare.
          Segmento: "Tutte le donazioni" (o tutti i sostenitori) oppure un segmento salvato. Il segmento viene riletto a ogni esecuzione: se nel frattempo entrano nuovi record che rispondono ai filtri, finiscono nel file. esecuzione.
          Modello di export
          :export: le colonne del file. Scegli un modello salvato o lascia Campi predefinitipredefiniti.
          Formato del file: CSV (predefinito) o Excel (XLSX).
          Passaggio 2: segmento, modello e formato Nel menu Segmento compaiono i segmenti salvati del tipo scelto al passaggio 1. Menu dei segmenti Nel menu Modello di export compaiono solo i modelli del tipo scelto al passaggio 1.1, con il numero di colonne. Menu dei modelli di export Formato3. delMetodo
          Tutti i record: ogni file: CSVcontiene (predefinito)tutto oil Excelsegmento.
          Solo (XLSX).i nuovi
          Passaggio Dati: segmento, modello di export e formato
          Passaggiorecord: 2:il segmento,primo modellofile econtiene formato
          tutto, i successivi solo i record creati dopo l'ultimo export riuscito.
          Il metodo non si può cambiare dopo la creazione. Passaggio 3: metodo

          3.4. Destinazione

          CampoCosa inserire
          ProtocolloFTP, FTPS (FTP su TLS esplicito, con certificato valido e non autofirmato) oppure SFTP (su SSH). Predefinito: SFTP.
          HostL'indirizzo del server (es. ftp.esempio.it),server, raggiungibile da internet
          PortaLa porta del server (per SFTP di solito 22)
          Utente e PasswordLe credenziali di accesso al server
          Cartella di destinazionePercorso 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

          Passaggio Schermata Scegli il Protocollo dal menu. Menu Protocollo Compila i dati del server e, prima di andare avantiavanti, clicca Testa connessione. Se qualcosa non va compare il riquadro rosso Connessione non riuscita con il motivo (es.qui l'host non trovato)esiste): correggi i dati e riprova.
          Passaggio Destinazione: protocollo e dati del server FTP
          PassaggioPassaggio 4: dati del server e test di connessione non riuscito 3:
          protocollo e dati del server
          Esito negativo del test di connessione FTP
          Il test di connessione non riuscito mostra il motivo dell'errore

          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à.

          FrequenzaQuando parte
          Una volta al giornoOgni giorno
          Una volta a settimanaOgni lunedì
          Una volta al meseIl primo giorno di ogni mese
          Una volta ogni 3 mesiIl primo giorno di gennaio, aprile, luglio e ottobre
          Una volta all'annoIl primo gennaio di ogni anno

          Passaggio Schermata L'export parte di notte (ore 03:00, fuso orario italiano).: la mattina il file è già sul server. In fondo alla pagina vedi la data della Prima esecuzione:, ècioè il primo orario utile, non il momento in cui crei l'attività. Clicca Crea attività per salvare.
          Passaggio Pianificazione: frequenza dell'export e prima esecuzione
          PassaggioPassaggio 5: frequenza e prima esecuzione 4:
          frequenza e prima esecuzione

          Gestire le attività

          Passaggio Schermata La pagina FTP Exporter elenca le attività con Nome, Tipo, Segmento, Modello di export, Intervallo e stato (Attiva). Clicca un'attività per aprirne il dettaglio.
          Elenco delle attività dell'Esportatore FTP
          L'elencoElenco delle attività delle
          attività

          Nel dettaglio trovi:trovi
            il Log (gli ultimi eventi, compresi gli errori, conservati per 3 mesi), l'interruttore Attiva e la Configurazione: tipo, segmento, modello, formato, metodo di export, Esportati fino al, intervallo, Prossima esecuzione, Ultima esecuzioneprossima e ultima esecuzione. Dettaglio di un'attività: log e configurazione Più in basso, nella configurazione, i dati del server (protocollo, host, utente, cartella). L'interruttore Attiva: se lo spegni l'attività non esegue export finché none la riattivi.data Ladi configurazionecreazione. resta salvata. Log: gli ultimi eventi dell'attività, compresi gli errori (es. connessione al server non riuscita). I log restano disponibili per 3 mesi. IlDal menu Azioni:, in alto a destra, puoi usare Testa configurazione FTP per verificare di nuovo la connessione,connessione o Elimina per cancellare l'attività. Dati del server nel dettaglio dell'attività
            Dettaglio di un'attività con log, configurazione e menu Azioni
            Il
            dettaglio di un'attività: log, configurazione e menu Azioni

            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 vediCosa fare
            Connessione non riuscita durante il testControlla 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 corretteVerifica 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 connessioneIl server non era raggiungibile al momento dell'export. Dal menu Azioni usa Testa configurazione FTP e correggi i dati se servono. L'invioCon fallito non viene ripetuto: se il segmento filtra per date,Tutti i record diil quelfile periodosuccessivo vannocontiene recuperaticomunque tutto; con un'esportazioneSolo manuale.i nuovi record i record mancanti partono con il primo invio riuscito.
            Il sistema che riceve trova doppioniL'attività usa Tutti i record. Se il sistema non riconosce i record già ricevuti, crea una nuova attività con Solo i nuovi record e disattiva la vecchia. Il modello che ti serve non compare nel passaggio DatiControlla che il modello sia dello stesso tipo (Sostenitori o Donazioni) scelto al passaggio 1. I modelli si creano da Impostazioni > Esportazioni. "Non è stato possibile leggere segmenti e modelli di export da Riseact"Errore temporaneo: torna indietro e riprova tra poco. Se persiste, contatta l'assistenza.