Importer et exporter des apps

Une app Keplin tient dans un fichier. Le package .keplinapp emporte tout ce que l'app est — le modèle de données, les écrans, les APIs, les scripts, les rapports, les workflows, le thème, les traductions, les rôles et les permissions — prêt à installer dans une autre installation de la plateforme. C'est l'outil de trois gestes :

• Changer d'environnement : développer sur une installation et installer sur celle de production du client.
• Livrer : envoyer l'app à qui va la faire tourner sur un autre serveur.
• Conserver : un package archivé est une copie du design de l'app, que l'on réimporte quand il le faut.

La décision importante porte sur les Secrets : un package peut voyager propre (recommandé) ou complet et chiffré avec une passphrase. Les deux sections suivantes expliquent le geste ; le tableau du milieu dit exactement ce qui part dans chaque mode.

#Exporter une app

1. Ouvrez l'app et cliquez sur le bouton d'engrenage Paramètres de l'app, puis sur Général.
2. Descendez jusqu'au panneau Emporter cette app — « Un fichier .keplinapp à installer ailleurs. » — et cliquez sur Exporter.

3. La boîte de dialogue Exporter l'app s'ouvre : « Génère un package .keplinapp avec tout ce qu'est l'app — APIs, scripts, modèle de données, enums et planifications — prêt à importer dans une autre instance. »

4. Dans Secrets, choisissez l'un des deux modes :

   Mode	Ce que cela signifie
   Sans secrets (recommandé)	« Les connexions des datasources et les secrets partent vides, et les COMPTES des utilisateurs de l'app restent dans cette installation — c'est l'application qui voyage, avec ses rôles et ses permissions, pas ceux qui l'utilisent. » C'est le bon mode pour livrer l'app à des tiers.
   Avec secrets, protégés par une passphrase	« Les valeurs partent chiffrées avec la passphrase définie ici ; elle sera demandée à l'importation. C'est une copie COMPLÈTE : elle emporte aussi les comptes et ce qui leur appartient. » C'est le bon mode pour changer l'app de serveur sans rien perdre.

5. Si vous avez choisi le mode protégé, définissez la Passphrase (8 caractères minimum).

6. Cliquez sur Exporter le package. Le navigateur télécharge le fichier gestao-clientes.keplinapp et la confirmation « Package exporté. » apparaît.

#Ce qui voyage dans le package

Le package distingue trois choses : l'application (elle voyage toujours), ce qui appartient à cette installation (ne voyage jamais) et les données des personnes (elles ne voyagent qu'en mode protégé).

Contenu	Sans secrets	Avec passphrase
Modèle de données, écrans, APIs, scripts, rapports, workflows, enums	Voyage	Voyage
Thème, traductions, rôles et permissions	Voyage	Voyage
Planifications	Voyagent désactivées	Voyagent désactivées
Connexions aux datasources et aux stockages	La configuration reste à remplir	Voyage, chiffrée avec la passphrase
Secrets de l'app	Seulement les clés, « à configurer » à destination	Voyagent, chiffrés
Données des bases de données internes de l'app	Seulement la structure des tables	Données complètes
Comptes des utilisateurs de l'app, boîte de notifications, fichiers envoyés, processus en cours	Tout reste dans cette installation	Tout voyage
Historique des exécutions et télémétrie	Reste	Reste
Clés API	Restent	Restent
Publication (hôtes et versions servies)	Reste	Reste

#Importer un package

L'import vit dans la même fenêtre que la création :

1. Dans la barre latérale, cliquez sur Nouvelle app et choisissez la carte Importer un package (administrateurs seulement).
2. Dans Package, cliquez sur la zone « Cliquez pour choisir le fichier .keplinapp » et sélectionnez le fichier.
3. Slug (facultatif) : laissez vide pour conserver le slug original du package — « Obligatoire uniquement s'il existe déjà une app avec le slug original. » C'est ainsi que vous installez une seconde copie de la même app, côte à côte.
4. Passphrase (le cas échéant) : « uniquement pour les packages exportés avec des secrets ». Un package propre s'importe sans aucune passphrase.
5. Cliquez sur Importer. À la fin apparaît « App "Gestão de Clientes" importée. » et l'app s'ouvre, déjà dans la barre latérale.

Des détails qui valent la peine d'être connus :

• Le package peut peser au maximum 200 Mo.
• Un package exporté depuis une ancienne version de Keplin est mis à jour automatiquement à son arrivée. Un package venu d'une version plus récente est refusé, avec une demande de mettre d'abord la plateforme à jour.
• Si quelque chose échoue en cours de route, rien n'est installé — l'import nettoie tout ce qu'il avait commencé à créer et affiche l'erreur. Il ne reste jamais une demi-app.

#Après l'import

La fenêtre elle-même laisse le rappel : « Après l'import : confirmez les connexions des datasources et les secrets (si le package est arrivé sans secrets, ils restent à remplir) et activez les planifications que vous voulez — elles arrivent toujours désactivées. » En pratique, la liste d'arrivée est celle-ci :

1. Datasources — ouvrez chacun et confirmez (ou remplissez) la connexion ; dans un package sans secrets, ils arrivent à configurer.
2. Secrets — les clés existent, les valeurs sont vides ; remplissez-les.
3. Planifications — activez celles que vous voulez, une par une.
4. Comptes — dans un package sans secrets, aucun utilisateur n'arrive ; créez-les dans les paramètres de l'app (Utilisateurs de l'app) ou activez l'inscription publique.
5. Publication et clés API — les hôtes et les clés appartiennent toujours à cette installation ; publiez l'app et émettez de nouvelles clés pour les consommateurs.

#Erreurs courantes

Message	Ce qui se passe	Quoi faire
« Le fichier n'est pas un package .keplinapp valide. »	Le fichier est corrompu ou n'est pas un package.	Réexportez à l'origine et utilisez le fichier tel qu'il a été téléchargé.
« Ce package a été exporté avec des secrets — indiquez la passphrase. »	Le package est en mode protégé et le champ est resté vide.	Remplissez la Passphrase et recommencez.
« Passphrase incorrecte — les secrets du package ne se déchiffrent pas. »	La passphrase n'est pas celle de l'exportation.	Vérifiez auprès de qui a exporté ; sans la bonne passphrase, le package n'entre pas.
« Il existe déjà une app avec le slug "…" — choisissez un autre slug pour l'import. »	Le slug original est déjà occupé dans cette installation.	Remplissez Slug (facultatif) avec un nouvel identifiant.
« Package trop volumineux (max 200 Mo). »	Le fichier dépasse la limite.	Exportez sans secrets (les données restent dehors) ou réduisez les fichiers de l'app à l'origine.
« Le package vient d'une version plus récente de Keplin… »	L'installation de destination est périmée.	Mettez à jour la plateforme de destination et importez à nouveau.