Se utilizzi Google Cloud Storage, puoi scambiare file tra magnews e un bucket GCS, per gestire in modo più semplice importazioni ed esportazioni.
Al momento puoi utilizzare Google Cloud Storage nelle attività pianificate per importare ed esportare file. In futuro sarà disponibile anche in altri contesti della piattaforma.
Per usare Google Cloud Storage, nelle attività pianificate, devi configurare tre elementi:
- un certificato digitale con la chiave del service account Google Cloud
- un file server esterno di tipo Google Cloud Storage
- un’attività pianificata che usa quel file server per leggere o scrivere i file.
L’integrazione è pensata per rendere disponibile Google Cloud Storage nello stesso flusso operativo che usi già per gli altri server remoti, così puoi gestire importazioni ed esportazioni in modo più semplice e coerente. In questo modo puoi, per esempio:
- importare file da un bucket Google Cloud Storage verso magnews
- esportare file da magnews verso un bucket Google Cloud Storage.
Crea il certificato digitale per Google Cloud Storage
Per collegare Google Cloud Storage a magnews ti serve una chiave JSON di un service account Google Cloud con i permessi adatti sul bucket che vuoi utilizzare (il permesso specifico è https://www.googleapis.com/auth/devstorage.read_write).
Dove recuperare il contenuto del certificato
Il file JSON di autenticazione va creato nella Google Cloud Console, generando una chiave per un service account (Service Account Key) .
Come creare il certificato su magnews
Apri la sezione API e integrazioni > Certificati digitali e crea un nuovo certificato.
Compila i campi:
- Nome: inserisci un nome descrittivo per riconoscere facilmente il certificato
- Id certificato: opzionale
- Tipo di certificato: seleziona Chiave per Google Cloud Service
- Contenuto del certificato: incolla il contenuto completo del file JSON del service account.
Magnews esegue una validazione di base sul contenuto del certificato per verificare che contenga i dati necessari.
Crea il file server esterno Google Cloud Storage
Dopo aver creato il certificato, puoi configurare il collegamento al bucket.
Google Cloud Storage non è un server FTP tradizionale. Per questo, in magnews viene configurato come file server esterno, ma con campi specifici diversi da quelli di FTP o SFTP.
Apri la sezione FTP > File server esterni e crea un nuovo file server.
Compila i campi disponibili:
- Nome server: nome descrittivo
- Chiave identificativa: identificativo univoco del server (opzionale)
- Tipo di server: seleziona Google Cloud Storage
- Bucket: inserisci il nome del bucket Google Cloud Storage che vuoi collegare (il bucket deve già esistere su GCS).
- Certificato: seleziona il certificato digitale GCS creato in precedenza.
Per questo tipo di configurazione non devi compilare i campi tipici dei server FTP o SFTP, come host, porta, utente o password, perché Google Cloud Storage usa un sistema di autenticazione diverso.
Usa Google Cloud Storage nelle attività pianificate
Una volta configurato il file server esterno, puoi usarlo nelle attività pianificate.
Per importare file da Google Cloud Storage
Se devi importare contatti o tabelle dati in magnews, nelle attività pianificate puoi selezionare Google Cloud Storage come sorgente dati, scegliendo il file server configurato. Questo ti permette di leggere i file presenti nel bucket e usarli come sorgente per l’importazione.
Puoi indicare un prefisso per il file, con cui saranno filtrati i file su Google Cloud Storage. Infatti, GCS non è un file server tradizionale, ma utilizza il prefisso del file per simulare le directory.
Per esportare file verso Google Cloud Storage
Se devi esportare dati da magnews, nelle attività pianificate puoi selezionare Google Cloud Storage come destinazione del file.
In questo caso scegli:
- il file server Google Cloud Storage
- l’eventuale prefisso del file, cioè il percorso o il nome iniziale da usare per salvare il file nel bucket.
Cosa verificare in caso non funzioni
Se la configurazione non funziona come previsto, nella maggior parte dei casi conviene controllare questi aspetti:
- Il file JSON incollato in magnews (nel contenuto del certificato) è completo e corretto?
- Il service account ha i permessi giusti sul bucket su Google Cloud Storage?
- Il nome del bucket è stato inserito correttamente nel file server esterno?
- L’attività pianificata usa il file server corretto e riporta correttamente il prefisso da utilizzare?