Importera och exportera appar

En Keplin-app ryms i en fil. Paketet .keplinapp tar med allt som appen är — datamodellen, skärmarna, API:erna, skripten, rapporterna, arbetsflödena, temat, översättningarna, rollerna och behörigheterna — klart att installera i en annan installation av plattformen. Det är verktyget för tre gester:

• Byta miljö: utveckla i en installation och installera i kundens produktionsmiljö.
• Leverera: skicka appen till den som ska köra den på en annan server.
• Spara undan: ett arkiverat paket är en kopia av appens design, som importeras igen när det behövs.

Det viktiga beslutet gäller hemligheterna: ett paket kan resa rent (rekommenderat) eller komplett och krypterat med en lösenfras. De två följande avsnitten förklarar gesten; tabellen i mitten säger exakt vad som följer med i varje läge.

#Exportera en app

1. Öppna appen och klicka på kugghjulsknappen Appens inställningar, sedan på Allmänt.
2. Rulla ner till panelen Ta med den här appen — ”En .keplinapp-fil att installera någon annanstans.” — och klicka på Exportera.

3. Dialogen Exportera appen öppnas: ”Genererar ett .keplinapp-paket med allt som appen är — API:er, skript, datamodell, enums och scheman — klart att importera i en annan instans.”

4. Under Hemligheter, välj ett av de två lägena:

   Läge	Vad det betyder
   Utan hemligheter (rekommenderas)	”Datakällornas anslutningar och secrets följer med tomma, och appanvändarnas KONTON stannar i den här installationen — det är applikationen som reser, med sina roller och behörigheter, inte de som använder den.” Det är rätt läge för att leverera appen till tredje part.
   Med hemligheter, skyddade av en lösenfras	”Värdena följer med krypterade med den lösenfras du anger här; den efterfrågas vid importen. Det är en FULLSTÄNDIG kopia: den tar också med kontona och det som hör till dem.” Det är rätt läge för att flytta appen till en annan server utan att förlora något.

5. Om du valde det skyddade läget, ange Lösenfras (minst 8 tecken).

6. Klicka på Exportera paket. Webbläsaren laddar ner filen gestao-clientes.keplinapp och bekräftelsen ”Paketet har exporterats.” visas.

#Vad som reser i paketet

Paketet skiljer på tre saker: applikationen (reser alltid), det som tillhör den här installationen (reser aldrig) och personernas data (reser bara i det skyddade läget).

Innehåll	Utan hemligheter	Med lösenfras
Datamodell, skärmar, API:er, skript, rapporter, arbetsflöden, enums	Reser	Reser
Tema, översättningar, roller och behörigheter	Reser	Reser
Scheman	Reser avstängda	Reser avstängda
Anslutningar till datakällor och lagringar	Konfigurationen följer med tom	Reser, krypterad med lösenfrasen
Appens secrets	Bara nycklarna, ”att konfigurera” på destinationen	Reser, krypterade
Data i appens interna databaser	Bara tabellernas struktur	Fullständiga data
Appanvändarnas konton, aviseringsinkorgen, uppskickade filer, pågående processer	Allt stannar i den här installationen	Allt reser
Körhistorik och telemetri	Stannar	Stannar
API-nycklar	Stannar	Stannar
Publicering (hostar och serverade versioner)	Stannar	Stannar

#Importera ett paket

Importen bor i samma fönster som skapandet:

1. I sidofältet, klicka på Ny app och välj kortet Importera paket (bara administratörer).
2. Under Paket, klicka på ytan ”Klicka för att välja .keplinapp-filen” och välj filen.
3. Slug (valfritt): lämna tomt för att behålla paketets ursprungliga slug — ”Krävs bara om det redan finns en app med det ursprungliga sluggen.” Det är så du installerar en andra kopia av samma app, sida vid sida.
4. Lösenfras (om tillämpligt): ”bara för paket som exporterats med hemligheter”. Ett rent paket importeras utan någon lösenfras alls.
5. Klicka på Importera. Till sist visas ”Appen ’Kundhantering’ har importerats.” och appen öppnas, redan i sidofältet.

Detaljer som är värda att känna till:

• Paketet får vara högst 200 MB.
• Ett paket som exporterats i en äldre version av Keplin uppdateras automatiskt på vägen in. Ett paket från en nyare version avvisas med en uppmaning att uppdatera plattformen först.
• Om något går fel halvvägs blir ingenting installerat — importen städar bort allt den hunnit skapa och visar felet. Det blir aldrig en halv app.

#Efter importen

Fönstret självt lämnar påminnelsen: ”Efter importen: bekräfta datakällornas anslutningar och secrets (om paketet kom utan hemligheter är de tomma) och aktivera de scheman du vill ha — de kommer alltid in avstängda.” I praktiken är ankomstlistan den här:

1. Datakällor — öppna var och en och bekräfta (eller fyll i) anslutningen; i ett paket utan hemligheter kommer de okonfigurerade.
2. Secrets — nycklarna finns, värdena är tomma; fyll i dem.
3. Scheman — aktivera de du vill ha, ett i taget.
4. Konton — i ett paket utan hemligheter följer inga användare med; skapa dem i appens inställningar (Appens användare) eller aktivera den publika registreringen.
5. Publicering och API-nycklar — hostarna och nycklarna tillhör alltid den här installationen; publicera appen och utfärda nya nycklar till konsumenterna.

#Vanliga fel

Meddelande	Vad som händer	Vad du gör
”Filen är inte ett giltigt .keplinapp-paket.”	Filen är korrupt eller inte ett paket.	Exportera igen från källan och använd filen precis som den laddades ner.
”Det här paketet exporterades med hemligheter — ange lösenfrasen.”	Paketet är i det skyddade läget och fältet lämnades tomt.	Fyll i Lösenfras och försök igen.
”Fel lösenfras — paketets hemligheter går inte att dekryptera.”	Lösenfrasen är inte den från exporten.	Stäm av med den som exporterade; utan rätt lösenfras kommer paketet inte in.
”Det finns redan en app med sluggen ’…’ — välj en annan slug för importen.”	Den ursprungliga sluggen är redan upptagen i den här installationen.	Fyll i Slug (valfritt) med en ny identifierare.
”Paketet är för stort (max 200 MB).”	Filen överskrider gränsen.	Exportera utan hemligheter (datan lämnas utanför) eller minska appens filer på källan.
”Paketet är från en nyare version av Keplin…”	Destinationsinstallationen är inaktuell.	Uppdatera destinationens plattform och importera igen.