Importare ed esportare app

Un'app di Keplin sta in un file. Il pacchetto .keplinapp porta con sé tutto ciò che l'app è — il modello dei dati, le schermate, le API, gli script, i report, i workflow, il tema, le traduzioni, i ruoli e le autorizzazioni — pronto da installare in un'altra installazione della piattaforma. È lo strumento per tre gesti:

• Cambiare ambiente: sviluppare in un'installazione e installare in quella di produzione del cliente.
• Consegnare: mandare l'app a chi la eseguirà su un altro server.
• Conservare: un pacchetto archiviato è una copia del progetto dell'app, che si reimporta quando serve.

La decisione importante sta nei segreti: un pacchetto può viaggiare pulito (consigliato) oppure completo e cifrato con una passphrase. Le due sezioni successive spiegano il gesto; la tabella in mezzo dice esattamente che cosa parte in ogni modalità.

#Esportare un'app

1. Apri l'app e clicca sul pulsante a ingranaggio Impostazioni dell'app, poi su Generale.
2. Scendi fino al pannello Porta questa app — "Un file .keplinapp da installare altrove." — e clicca su Esporta.

3. Si apre la finestra Esporta app: "Genera un pacchetto .keplinapp con tutto ciò che l'app è — API, script, modello dati, enum e pianificazioni — pronto da importare in un'altra istanza."

4. In Segreti, scegli una delle due modalità:

   Modalità	Che cosa significa
   Senza segreti (consigliato)	"Le connessioni dei datasource e i secret viaggiano vuoti, e gli ACCOUNT degli utenti dell'app restano in questa installazione — viaggia l'applicazione, con i ruoli e le autorizzazioni, non chi la usa." È la modalità giusta per consegnare l'app a terzi.
   Con segreti, protetti da passphrase	"I valori viaggiano cifrati con la passphrase che imposti qui; verrà richiesta all'importazione. È una copia COMPLETA: porta anche gli account e ciò che appartiene loro." È la modalità giusta per spostare l'app di server senza perdere niente.

5. Se hai scelto la modalità protetta, imposta la Passphrase (minimo 8 caratteri).

6. Clicca su Esporta pacchetto. Il browser scarica il file gestao-clientes.keplinapp e appare la conferma "Pacchetto esportato."

#Che cosa viaggia nel pacchetto

Il pacchetto distingue tre cose: l'applicazione (viaggia sempre), ciò che è di questa installazione (non viaggia mai) e i dati delle persone (viaggiano solo nella modalità protetta).

Contenuto	Senza segreti	Con passphrase
Modello dei dati, schermate, API, script, report, workflow, enum	Viaggia	Viaggia
Tema, traduzioni, ruoli e autorizzazioni	Viaggia	Viaggia
Pianificazioni	Viaggiano disattivate	Viaggiano disattivate
Connessioni a datasource e archiviazioni	La configurazione resta da compilare	Viaggia, cifrata con la passphrase
Secrets dell'app	Solo le chiavi, "da configurare" nella destinazione	Viaggiano, cifrati
Dati dei database interni dell'app	Solo la struttura delle tabelle	Dati completi
Account degli utenti dell'app, casella delle notifiche, file inviati, processi a metà	Resta tutto in questa installazione	Viaggia tutto
Cronologia delle esecuzioni e telemetria	Resta	Resta
Chiavi API	Restano	Restano
Pubblicazione (host e versioni servite)	Resta	Resta

#Importare un pacchetto

L'importazione vive nella stessa finestra della creazione:

1. Nella barra laterale, clicca su Nuova app e scegli la scheda a scelta Importa pacchetto (solo amministratori).
2. In Pacchetto, clicca sull'area "Clicca per scegliere il file .keplinapp" e seleziona il file.
3. Slug (opzionale): lascia vuoto per mantenere lo slug originale del pacchetto — "Obbligatorio solo se esiste già un'app con lo slug originale." È così che installi una seconda copia della stessa app, affiancata.
4. Passphrase (se applicabile): "solo per i pacchetti esportati con segreti". Un pacchetto pulito si importa senza nessuna passphrase.
5. Clicca su Importa. Alla fine appare 'App "Gestione Clienti" importata.' e l'app si apre, già nella barra laterale.

Dettagli che vale la pena conoscere:

• Il pacchetto può pesare al massimo 200 MB.
• Un pacchetto esportato da una versione vecchia di Keplin viene aggiornato automaticamente all'ingresso. Un pacchetto di una versione più recente viene rifiutato con la richiesta di aggiornare prima la piattaforma.
• Se qualcosa fallisce a metà, non resta installato niente — l'importazione ripulisce tutto quello che aveva cominciato a creare e mostra l'errore. Non resta mai una mezza app.

#Dopo l'importazione

La finestra stessa lascia il promemoria: "Dopo l'importazione: conferma le connessioni dei datasource e i secret (se il pacchetto è arrivato senza segreti restano da compilare) e attiva le pianificazioni che vuoi — arrivano sempre disattivate." In pratica, la lista d'arrivo è questa:

1. Datasource — apri ognuno e conferma (o compila) la connessione; in un pacchetto senza segreti arrivano da configurare.
2. Secrets — le chiavi esistono, i valori sono vuoti; compilali.
3. Pianificazioni — attiva quelle che vuoi, una a una.
4. Account — in un pacchetto senza segreti non arrivano utenti; creali nelle impostazioni dell'app (Utenti dell'app) o attiva la registrazione pubblica.
5. Pubblicazione e chiavi API — gli host e le chiavi sono sempre di questa installazione; pubblica l'app ed emetti chiavi nuove per i consumatori.

#Errori comuni

Messaggio	Che cosa succede	Che cosa fare
"Il file non è un pacchetto .keplinapp valido."	Il file è corrotto o non è un pacchetto.	Riesporta all'origine e usa il file così come è stato scaricato.
"Questo pacchetto è stato esportato con segreti — indica la passphrase."	Il pacchetto è della modalità protetta e il campo è rimasto vuoto.	Compila la Passphrase e riprova.
"Passphrase sbagliata — i segreti del pacchetto non si decifrano."	La passphrase non è quella dell'esportazione.	Verificala con chi ha esportato; senza la passphrase giusta il pacchetto non entra.
'Esiste già un'app con lo slug "…" — scegli un altro slug per l'importazione.'	Lo slug originale è già occupato in questa installazione.	Compila Slug (opzionale) con un identificatore nuovo.
"Pacchetto troppo grande (max 200 MB)."	Il file supera il limite.	Esporta senza segreti (i dati restano fuori) o riduci i file dell'app all'origine.
"Il pacchetto è di una versione più recente di Keplin…"	L'installazione di destinazione è obsoleta.	Aggiorna la piattaforma di destinazione e importa di nuovo.