Skip to main content

Mandare i dati al gestionale: l'Esportatore FTP, quando serve

Gli esempi e gli screenshot di questa pagina usano un'associazione inventata, Save The Unicorns: nomi, indirizzi e dati sono di fantasia.

Il gestionale di Save The Unicorns vuole le donazioni ogni notte. Invece di esportarle e caricarle a mano, le mandi in automatico con l'Esportatore FTP.

A cosa serve

L'Esportatore FTP è l'applicazione di Riseact che invia in automatico sostenitori o donazioni a un server FTP,FTP a intervalli regolariregolari: (ogni giorno, settimana, mese, trimestre o anno).anno. Lo configuri una volta e da quel momento i dati partono da soli,soli.

Serve senzaquando 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. Gligli stessi dati servono spesso anche altrove, ad esempio:

    al gestionale 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 altro 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 sannosa leggere un file da una cartella condivisa.ma non si collega a Riseact: il gestionale contabile, il CRM della sede nazionale, un sistema di report, un fornitore esterno come un'agenzia, una tipografia o un contact center. Senza automazione qualcuno dovrebbedeve ogni volta esportare da Riseact,esportare, scaricare e caricare il file eogni caricarlo nella cartella giusta: un lavoro ripetitivo, facile da dimenticare e con il rischio di mandare il file sbagliato o con colonne diverse dalla volta prima.volta.

    Che cos'

    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; il sistema che deve usarlo va poi a prenderlo da lì. Di solito il server è dell'organizzazionedel sistema o del fornitore che riceve i dati,riceve, non di Riseact.

    FTP, FTPS e SFTP sono tre modi (protocolli)di per collegarsi a questo spazio.collegarsi: SFTP e FTPS cifrano la connessione e proteggono i dati durante l'invio;connessione, il semplice FTP no. Per i dati dei donatori preferisci semprescegli SFTP o FTPS, se il server li supporta.FTPS. SFTP è anche il più semplice da configurare, perché non richiede certificati.

    Come funziona, in pratica

    funziona

    Pensa aCome un corriere che passa ogni notte.notte: All'all'orario stabilito Riseact:

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

      Il sistema di destinazione lo legge il file con le sue regole e i suoi tempi. Riseact si occupa solo di consegnarlo.

      Tutti i record o solo i nuovi

      MetodoCosa contiene ogni fileQuando sceglierlo Tutti i recordTuttitutti i record del segmento, anche quelli già inviatiIl sistema cheChi riceve sostituisce i dati ogni volta i dati o riconosce da solo i record già ricevuti (adper esempio dall'Id). Ti serveVuoi vedere anche ile cambiamentimodifiche suiai record già inviati. Solo i nuovi recordAlal primo invio tutto il segmento; dal secondo in poi solo i record creati dopo l'ultimo export riuscitoIl sistema cheChi riceve aggiunge i dati a quelli che ha già e non deve trovarsitrovare doppioni.

      Con Solo i nuovi record Riseact ricorda fin dove è arrivato (nel dettaglio dell'attività lo vedi alla voceattività: Esportati fino al). Se un invio non riesce, i record di quel periodo partono con il primo invio riuscito successivo.riuscito. 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òcambia: cambiare dopo. Perper passare all'altro metodo crea una nuova attività.

      Perché conviene

        Nessun lavoro manuale: i dati partono anche quando nessuno ci pensa, nei weekend e nelle ferie. Sempre lo stesso file: colonne, ordine e formato non cambiano, quindi il sistema che lo riceve lo legge senza errori. Dati aggiornati: il segmento viene riletto a ogni invio, quindi il file comprende anche i sostenitori e le donazioni arrivati nel frattempo. Più sicurezza: il file va direttamente da Riseact al server, senza passare dai computer delle persone o dalle email. 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 controlloIlil pulsante Esporta in Sostenitori, Donazioni o Pagamenti (vedi: EsportazioneEsportare sostenitorisostenitori, donazioni e donazionipagamenti) Tenere allineata una lista emailL'l'integrazione dedicata (vedidedicata: IntegrazioneMandare i sostenitori a Mailchimp) Ricevere unUn file a cadenza fissa (al massimo una volta al giorno) in un sistema esternoL'l'Esportatore FTP

        Come è organizzato

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

        cosa DomandaDove la configuri Cosa mando?Tipomando (sostenitoritipo, osegmento, donazioni)modello), segmento e modello di esportazione Tuttotutto o solo le novità?Ilnovità metodo:(metodo), tuttidove i record o solo i nuovi Dove lo mando?Il (server FTP e lacartella), cartellaquando di(frequenza). destinazione Quando lo mando?La frequenza: giorno, settimana, mese, trimestre o anno

        Puoi avere fino a 5 attività,attività completamenteindipendenti, indipendenti: ognunaciascuna con il suo segmento, il suo modello, il suo server e il suo log.

        Esempio:

        Esempio.per Save The Unicorns raccoglie con due campagne: i banchetti in piazza ("Banchetti degli Unicorni")Unicorni e le raccolte personali ("Adotta un unicorno").unicorno Ilpuoi gestionale vuole le donazioni ogni notte. Ci sono due strade:

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

          diversi.

          Prima di configurareiniziare

          un'attività, mettiti d'accordoAccordati con chi gestisce il sistema che riceverà i filericeve su cinque punti: quali colonne servono, ogni quanto serve il file,quanto, se il sistema vuole ogni volta tutto o solo le novità, se gestiscericonosce i record già ricevuti e quali sonoricevuti, i dati di accesso al server.

          Prima di iniziare

            Dati del server FTP:server: protocollo, host, porta, utente, password e cartella di destinazione. Te li fornisce chi gestisce il server che riceverà i file.cartella. Il server deve rispettare i requisiti elencatidi sotto.Esportatore FTP: requisiti del server e problemi. Segmento (facoltativo): secrealo non vuoi esportare tutti i record, crea prima il segmento nella lista Sostenitori o Donazioni (vediprima, SegmentiSalvare un gruppo di sostenitoridonatori econ donazioniun segmento). Modello di esportazione (facoltativo): secrealo vuoiprima, scegliereRiusare le colonne delcon file,i crea prima il modello (vedi Modellimodelli di esportazione e storico esportazioni). Senza modello il file usa i Campi predefiniti.

            Requisiti del server

              Raggiungibile da internet: un server accessibile solo dalla rete interna dell'organizzazione o in VPN non riceve i file. Accesso con utente e password. Cartella

              Consiglio di destinazionefundraising
              Chiedi giàa esistente,chi 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: certificato valido (non autofirmato) e TLS esplicito. Con SFTP il certificato non serve.

              Cosa contienericeve il file

                un Colonne: solo i campi già presenti in Riseact,campione con i loro nomi. Non puoi rinominare le colonne néche aggiungernesi aspetta e costruisci il modello su quello. Un file che il gestionale legge al primo colpo vale più di nuove. Se il sistema che riceve ha un suo tracciato, scegli nel modello di esportazione i campi che più gli si avvicinano. Formato: CSV oppure Excel (XLSX). Separatore e codifica dei caratteri non sono configurabili. Nome del file: fisso, non modificabile. È composto da nome dell'attività, tipo di export, data e ora dell'esecuzione, ad esempio nomeattività_donations_20261005-030000.csv.

                Installare l'Esportatore FTP

                1. Nel menu a sinistra vai in Applicazioni e clicca App Store. Apri Esportatore FTP.

                Esportatore FTP nell'App Store

                2. Clicca Installa, leggi la richiesta di autorizzazione e conferma.

                Richiesta di autorizzazione all'installazione

                3. Dopo l'installazione l'app compare in Applicazioni: aprila.

                Esportatore FTP tra le applicazioni installate

                4. Si apre la pagina FTP Exporter. Finché non crei un'attività vedi il messaggio "Nessuna attività".

                Pagina FTP Exporter senza attività

                Creare un'attività

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

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

                Passaggio 1: nome e tipo

                2. Dati
                Segmento: "Tutte le donazioni" (o tutti i sostenitori) oppure un segmento salvato. Il segmento viene riletto a ogni esecuzione.
                Modello di export: le colonne del file. Scegli un modello salvato o lascia Campi predefiniti.
                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, con il numero di colonne.

                Menu dei modelli di export

                3. Metodo
                Tutti i record: ogni file contiene tutto il segmento.
                Solo i nuovi record: il primo file contiene tutto, i successivi solo i record creati dopo l'ultimo export riuscito.
                Il metodo non si può cambiare dopo la creazione.completo.

                Passaggio 3: metodo

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

                Scegli il Protocollo dal menu.

                Menu Protocollo

                Compila i dati del server e, prima di andare avanti, clicca Testa connessione. Se qualcosa non va compare il riquadro rosso Connessione non riuscita con il motivo (qui l'host non esiste): correggi i dati e riprova.

                Passaggio 4: dati del server e test di connessione non riuscito

                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

                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 5: frequenza e prima esecuzione

                Gestire le attività

                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à

                Nel dettaglio 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 e ultima esecuzione.

                Dettaglio di un'attività: log e configurazione

                Più in basso, nella configurazione, i dati del server (protocollo, host, utente, cartella) e la data di creazione. Dal menu Azioni, in alto a destra, puoi usare Testa configurazione FTP per verificare di nuovo la connessione o Elimina per cancellare l'attività.

                Dati del server nel dettaglio dell'attività

                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. Con Tutti i record il file successivo contiene comunque tutto; con Solo i nuovi record i record mancanti partono con il primo invio riuscito. Il sistema che riceve trova doppioniL'doppioni: l'attività usa Tutti i record. Se il sistema non riconosce i record già ricevuti, crea una nuova un'attività con Solo i nuovi record e disattiva la vecchia. Il file non ha le colonne che chiede il gestionale: non puoi rinominare né aggiungere colonne: scegli nel modello chei ticampi servepiù non compare nel passaggio DatiControlla che il modello sia dello stesso tipo (Sostenitori o Donazioni) sceltovicini al passaggiosuo 1.tracciato. I

                Vedi modellianche

                siEsportatore creanoFTP: daconfigurarlo Impostazionipasso >per Esportazioni.passo "NonEsportatore èFTP: statorequisiti possibiledel leggere segmentiserver e modelliproblemi Salvare un gruppo di exportdonatori dacon Riseact"Erroreun temporaneo:segmento torna indietro e riprova tra poco. Se persiste, contatta l'assistenza.