Importare contenuti da un foglio di calcolo
Come portare post, articoli e post brevi da un foglio .xlsx o .csv con la data e l'autore originali (file, colonne, opzioni, anteprima, avanzamento e report), cosa fa saltare una riga, ogni avviso e i limiti.
Il pulsante Importa contenuti porta nella community lo storico che stava altrove (WordPress, Substack, Circle, un vecchio gruppo, un foglio di calcolo): ogni riga del foglio diventa un post, un articolo o un post breve, con la data originale e, quando è possibile, l'autore originale. Indichi dove va ogni colonna, controlli un'anteprima e solo allora importi. Nessuno riceve notifiche.
A cosa serve
| Community | Foglio di calcolo |
|---|---|
| In migrazione da un blog o una newsletter | L'esportazione degli articoli, con titolo, testo in HTML, data ed e-mail dell'autore |
| Forum o vecchio gruppo | Le discussioni, ognuna con l'e-mail di chi l'ha aperta, verso uno spazio Feed |
| Associazione | L'archivio dei comunicati degli ultimi anni, tutti in uno spazio Contenuti |
| Corso | Gli avvisi della classe come post brevi, nell'ordine in cui sono usciti |
Come funziona
Dove si trova e chi può
Il pulsante Importa contenuti si trova nell'intestazione degli spazi Contenuti e Feed. Solo il proprietario e l'amministratore vedono il pulsante; per gli altri ruoli non compare, e l'API rifiuta.
Con l'ingresso nella community sospeso da Memberfy, l'importazione non parte. Vedi Sospensione di ingressi e vendite.
I tre tipi
| Tipo | Come entra | Dove può entrare |
|---|---|---|
| Post | Titolo e testo | Spazio Contenuti o Feed |
| Articolo | Titolo e testo | Spazio Contenuti o Feed |
| Post breve | Solo testo, fino a 500 caratteri, senza titolo e senza tag | Solo spazio Feed |
Il tipo vale per tutte le righe (opzione Tipo) o arriva da una colonna del foglio, con valori come post, articolo o breve (anche status, blog, newsletter, in italiano, inglese, spagnolo, portoghese o tedesco).
Cosa rispetta l'importazione
- La data originale resta. Il post entra con la data del foglio come data di pubblicazione, al posto di quella data nel Feed e nell'elenco dello spazio, e non in cima.
- In silenzio. Nulla viene notificato: nessun membro riceve avvisi né e-mail, i post restano fuori dalle e-mail di novità e dai contenuti in evidenza, e nessuno guadagna punti nella Classifica. Solo chi ha importato riceve, alla fine, un'e-mail con il riepilogo.
- L'autore arriva dall'e-mail. La colonna dell'e-mail dell'autore collega ogni riga a una persona della community. Deve essere membro e avere un ruolo inferiore al tuo (il proprietario importa a nome di amministratori, moderatori, finanza e membri; l'amministratore, a nome di moderatori, finanza e membri). Altrimenti la riga viene saltata e il report dice perché. La tua e-mail vale sempre. Chi ha importato resta registrato nei Log per ogni post fatto a nome di un'altra persona.
- Una data nel futuro o non valida non entra. La riga viene saltata. Una data vuota diventa la data dell'importazione, e la riga entra con un avviso.
- Nulla entra due volte. Un post o articolo con lo stesso titolo e la stessa data di uno già presente nella community viene saltato; importare di nuovo lo stesso foglio non crea duplicati. Anche le righe ripetute nel foglio stesso entrano una volta sola.
- Le immagini arrivano insieme. Le immagini dentro il testo vengono scaricate e ospitate su Memberfy, con gli stessi limiti di un'immagine caricata dall'app; i link del testo restano come sono. L'immagine che non si può scaricare resta come link all'originale, e il report lo segnala.
- I link diventano player o scheda. I link nel testo di ogni post importato diventano player o scheda, fino a 5 per post, in background, dopo l'ingresso del post.
Limiti
| Cosa | Limite |
|---|---|
| File | .xlsx o .csv, fino a 5 MB |
| Righe | Fino a 5.000 righe di dati (e 100 colonne) |
| Immagini per riga | 20; le successive restano come link |
| Immagini per importazione | 300 o 500 MB, quello che arriva prima; le successive restano come link |
| Importazioni contemporanee | Una per community; la successiva parte quando la precedente finisce |
Un foglio i cui testi insieme superano i 25 MB viene rifiutato prima di iniziare: dividilo in parti più piccole.
Passo dopo passo
1. File
- Nello spazio Contenuti o Feed, fai clic su Importa contenuti.
- Trascina il foglio o fai clic per sceglierlo (.xlsx o .csv · fino a 5 MB e 5.000 righe).
- Controlla la lettura:
- Foglio: in un .xlsx, quale foglio leggere.
- Riga di intestazione: Memberfy la trova da sola; per cambiarla, fai clic su un'altra riga della tabella.
- Separatore (virgola, punto e virgola, tabulazione o barra verticale) e Codifica: in un .csv, riconosciuti da soli; puoi cambiarli.
2. Colonne
Ogni colonna compare con le prime 3 righe e una destinazione suggerita in Va in. Sistema quello che serve; ciò che resta su Ignora non viene importato. Ogni destinazione accetta una sola colonna.
| Destinazione | Cosa ci va |
|---|---|
| Titolo | Obbligatorio per post e articoli. I titoli oltre i 300 caratteri vengono tagliati |
| Contenuto | Testo, Markdown o HTML. Obbligatorio per continuare |
| E-mail dell'autore | Il post va a nome della persona della community con questa e-mail. Senza questa colonna, tutto esce a tuo nome |
| Data di pubblicazione | La data originale. Una data senza fuso usa il fuso della community |
| Space | L'id, l'indirizzo o il nome di uno spazio Contenuti o Feed (maiuscole e accenti non contano) |
| Tipo | post, articolo o breve |
| Tag | Più valori, separati da virgola, punto e virgola o barra verticale (fino a 20 per post) |
3. Opzioni
- Space (o Space predefinito, quando c'è una colonna di space): dove entrano i post, o lo spazio usato quando la riga non ne ha uno valido. Nessuno (salta la riga) salta le righe senza uno space valido.
- Tipo (o Tipo predefinito): Post, Articolo o Post breve. Il post breve entra solo in uno spazio Feed.
- Chi vede: Solo membri o Pubblico.
- Ordine delle date, che compare quando il foglio ha date come 03/04/2024: Giorno/mese/anno o Mese/giorno/anno. La schermata mostra un esempio del foglio ("03/04/2024 sarà letta come 3 aprile 2024.") e, quando il foglio ha una data che sta in un solo ordine (come 25/12/2023), sceglie quello e lo segnala.
- Fuso: le date senza fuso sono lette nel fuso della community, che la schermata mostra.
- Autore con e-mail sconosciuta, per quando l'e-mail del foglio non è di nessuno della community: Salta la riga o Pubblica a mio nome (la riga entra con un avviso).
Le date accettate: AAAA-MM-GG (con o senza ora e fuso), GG/MM/AAAA o MM/GG/AAAA (con /, . o - e ora facoltativa), date con il nome del mese in inglese (15 March 2024, Mar 15, 2024) e timestamp Unix. Nel .xlsx, la cella data di Excel vale così com'è.
4. Anteprima
L'anteprima non salva nulla. Mostra il riepilogo (righe nel foglio, quanti saranno importati, quanti con data originale, quanti senza data, righe saltate, righe con avvisi, immagini da scaricare e dimensione dei testi) e le prime 10 righe come saranno: tipo, titolo, spazio, autore, data e avvisi, con quelle saltate segnalate.
5. Confermare
Fai clic su Importa N post e conferma. L'importazione gira in background: puoi chiudere la finestra.
6. Avanzamento
La schermata mostra "120 di 800 righe". Annulla importazione ferma le righe mancanti; i post già entrati restano pubblicati.
7. Report e storico
Alla fine, la schermata mostra Importati, Saltati, Con errore e Con avvisi, le Righe non entrate (con il motivo) e quelle Entrati con avvisi. Scarica il report genera un CSV con la riga, il risultato, il titolo e il motivo. Chi ha importato riceve anche il riepilogo via e-mail.
Importazioni precedenti, in alto nella finestra, elenca le importazioni della community, con lo stato (Non avviata, In coda, In importazione, Completata, Non riuscita, Annullata o Abbandonata) e Vedi per aprire il report. Un foglio analizzato e non importato entro 24 ore diventa Abbandonata.
Perché una riga è stata saltata
| Nel report | Cosa vuol dire | Cosa fare |
|---|---|---|
| Senza titolo | Post o articolo senza titolo | Compila il titolo o importa la riga come post breve |
| Senza contenuto | Post breve senza testo | Compila il contenuto |
| Nessuno space valido | La riga non indica uno spazio che accetti quel tipo, e non c'è uno spazio predefinito adatto | Scegli uno spazio predefinito, o correggi la colonna di space |
| Data non valida | La data non è stata capita, o non esiste (come 31/02) | Correggi la data o cambia l'Ordine delle date |
| Data nel futuro | La data è successiva a adesso: l'importazione non programma post | Correggi la data |
| Contenuto troppo lungo | Post breve con più di 500 caratteri | Importalo come post o articolo |
| Ripetuta nel foglio | Stesso tipo, titolo, data e inizio del testo di una riga precedente | Nulla: la prima è entrata |
| Esiste già un post con questo titolo e questa data | Un post o articolo uguale è già nella community, da un'importazione precedente o fatto a mano | Nulla: è ciò che evita i duplicati |
| L'e-mail dell'autore non è di nessuno della community | L'e-mail non è di un membro, e l'opzione è Salta la riga | Invita prima la persona, o scegli Pubblica a mio nome |
| Puoi pubblicare solo a nome di chi ha un ruolo inferiore al tuo | L'e-mail è di qualcuno con un ruolo uguale o superiore al tuo | Chiedi a un proprietario di importare, o togli l'e-mail dalla riga |
| Errore nel salvataggio (risultato Non riuscito) | Qualcosa è andato storto nel salvare quella riga | Importa di nuovo il foglio: ciò che è già entrato viene saltato |
Cosa vuol dire ogni avviso
La riga con un avviso è entrata; l'avviso dice cosa è cambiato.
| Avviso | Cosa vuol dire |
|---|---|
| Tipo non riconosciuto | Il valore della colonna Tipo non è post, articolo né breve; è valso il tipo delle opzioni |
| Titolo tagliato | Il titolo superava i 300 caratteri ed è stato tagliato |
| Space non trovato | Lo spazio della riga non esiste nella community; è valso lo spazio predefinito |
| Space di altro tipo | Lo spazio della riga non accetta quel tipo (per esempio, un post breve in uno spazio Contenuti); è valso lo spazio predefinito |
| Senza data | La cella della data era vuota; il post è entrato con la data dell'importazione |
| Autore non trovato | L'e-mail non è di nessuno della community; il post è uscito a tuo nome (opzione Pubblica a mio nome) |
| Tag ignorati | Il post breve non ha tag |
| Immagine non scaricata | Un'immagine del testo non è stata scaricata; resta il link all'originale |
| Immagine non supportata | L'indirizzo dell'immagine non è un link web scaricabile; resta come link |
| Troppe immagini nel post | Il testo aveva più di 20 immagini; le successive restano come link |
| Limite di immagini dell'importazione | L'importazione ha raggiunto 300 immagini o 500 MB; le successive restano come link |
Domande frequenti
I membri riceveranno una valanga di avvisi? No. Nulla dell'importazione notifica i membri né conta punti, qualunque sia la data.
Posso importare commenti e reazioni? No. L'importazione porta post, articoli e post brevi. Per portare persone, usa Importare membri da un foglio di calcolo.
Ho importato e mancavano alcune persone come autori. Posso importare di nuovo? Sì. Invita le persone, importa lo stesso foglio e le righe già entrate vengono saltate come Esiste già un post con questo titolo e questa data. I post brevi non passano per questo controllo: in una seconda importazione, lascia solo le righe mancanti.
E se sbaglio la data di un post? Modifica il post e cambia la Data di pubblicazione. Vedi Data di pubblicazione.
Con l'assistente
L'assistente fa la stessa importazione in quattro passaggi: analyze_content_import (legge il foglio), preview_content_import (il riepilogo, senza salvare), start_content_import (importa dopo aver mostrato il riepilogo) e get_content_import (avanzamento e report). Vedi Strumenti · Contenuti.
Nell'API
POST /api/import/spreadsheet (carica il file e restituisce l'analisi), POST /api/import/spreadsheet/{id}/preview (il riepilogo e le prime 10 righe), POST /api/import/spreadsheet/{id}/start (conferma e mette in coda), GET /api/import/spreadsheet/{id} (avanzamento e report), GET /api/import/spreadsheet (storico) e DELETE /api/import/{importId} (annulla). Solo proprietario e amministratore, con l'X-CommunityId. Vedi Import.