Importere og eksportere apper

En Keplin-app får plass i én fil. Pakken .keplinapp tar med alt appen er — datamodellen, skjermene, API-ene, skriptene, rapportene, arbeidsflytene, temaet, oversettelsene, rollene og tillatelsene — klar til å installeres i en annen installasjon av plattformen. Det er verktøyet for tre bevegelser:

• Bytte miljø: utvikle i én installasjon og installere i kundens produksjonsmiljø.
• Levere: sende appen til den som skal kjøre den på en annen server.
• Ta vare på: en arkivert pakke er en kopi av designet til appen, som importeres på nytt når det trengs.

Den viktige beslutningen ligger i hemmelighetene: en pakke kan reise ren (anbefalt) eller komplett og kryptert med en passfrase. De to neste seksjonene forklarer bevegelsen; tabellen i midten sier nøyaktig hva som følger med i hvert modus.

#Eksportere en app

1. Åpne appen og klikk på tannhjulknappen Appinnstillinger, deretter på Generelt.
2. Bla ned til panelet Ta med denne appen — «En .keplinapp-fil du kan installere et annet sted.» — og klikk på Eksporter.

3. Dialogen Eksporter app åpnes: «Genererer en .keplinapp-pakke med alt appen er — API-er, skript, datamodell, enumer og tidsplaner — klar til å importeres i en annen instans.»

4. Under Hemmeligheter, velg ett av de to modusene:

   Modus	Hva det betyr
   Uten hemmeligheter (anbefalt)	«Tilkoblingene til datakildene og hemmelighetene følger med tomme, og KONTOENE til brukerne av appen blir igjen i denne installasjonen — det er applikasjonen som reiser, med roller og tillatelser, ikke de som bruker den.» Det er riktig modus for å levere appen til tredjeparter.
   Med hemmeligheter, beskyttet av en passfrase	«Verdiene følger med kryptert med passfrasen du angir her; den blir etterspurt ved import. Dette er en KOMPLETT kopi: den tar også med kontoene og det som hører til dem.» Det er riktig modus for å flytte appen til en annen server uten å miste noe.

5. Hvis du valgte det beskyttede moduset, sett Passfrase (minst 8 tegn).

6. Klikk på Eksporter pakke. Nettleseren laster ned filen gestao-clientes.keplinapp og bekreftelsen «Pakken er eksportert.» dukker opp.

#Hva som reiser i pakken

Pakken skiller mellom tre ting: applikasjonen (reiser alltid), det som tilhører denne installasjonen (reiser aldri) og dataene til menneskene (reiser bare i det beskyttede moduset).

Innhold	Uten hemmeligheter	Med passfrase
Datamodell, skjermer, API-er, skript, rapporter, arbeidsflyter, enumer	Reiser	Reiser
Tema, oversettelser, roller og tillatelser	Reiser	Reiser
Tidsplaner	Reiser avslått	Reiser avslått
Tilkoblinger til datakilder og lagringer	Konfigurasjonen kommer tom	Reiser, kryptert med passfrasen
Hemmelighetene til appen	Bare nøklene, «må konfigureres» i målet	Reiser, kryptert
Data i appens interne databaser	Bare strukturen til tabellene	Komplette data
Kontoene til brukerne av appen, varselinnboksen, opplastede filer, halvferdige prosesser	Alt blir igjen i denne installasjonen	Alt reiser
Kjøringshistorikk og telemetri	Blir igjen	Blir igjen
API-nøkler	Blir igjen	Blir igjen
Publisering (verter og serverte versjoner)	Blir igjen	Blir igjen

#Importere en pakke

Importen bor i det samme vinduet som opprettelsen:

1. I sidefeltet, klikk på Ny app og velg kortet Importer pakke (kun administratorer).
2. Under Pakke, klikk på området «Klikk for å velge .keplinapp-filen» og velg filen.
3. Slug (valgfritt): la stå tomt for å beholde den opprinnelige sluggen fra pakken — «Bare nødvendig hvis det allerede finnes en app med den opprinnelige sluggen.» Det er slik du installerer en andre kopi av samme app, side om side.
4. Passfrase (hvis aktuelt): «bare for pakker som er eksportert med hemmeligheter». En ren pakke importeres uten noen passfrase.
5. Klikk på Importer. Til slutt dukker «Appen «Gestão de Clientes» er importert.» opp, og appen åpnes, allerede i sidefeltet.

Detaljer som er verdt å vite:

• Pakken kan være maksimalt 200 MB.
• En pakke som ble eksportert i en gammel versjon av Keplin oppgraderes automatisk på vei inn. En pakke fra en nyere versjon avvises med en anmodning om å oppdatere plattformen først.
• Hvis noe feiler underveis, blir ingenting installert — importen rydder opp alt den hadde begynt å opprette og viser feilen. Det blir aldri stående en halv app.

#Etter importen

Selve vinduet gir deg påminnelsen: «Etter importen: bekreft tilkoblingene til datakildene og hemmelighetene (kom pakken uten hemmeligheter, står de tomme) og slå på de tidsplanene du vil ha — de kommer alltid avslått.» I praksis er ankomstlisten denne:

1. Datakilder — åpne hver av dem og bekreft (eller fyll inn) tilkoblingen; i en pakke uten hemmeligheter kommer de ukonfigurert.
2. Hemmeligheter — nøklene finnes, verdiene er tomme; fyll dem inn.
3. Tidsplaner — slå på dem du vil ha, én etter én.
4. Kontoer — i en pakke uten hemmeligheter følger det ikke med brukere; opprett dem i appinnstillingene (Brukere av appen) eller slå på offentlig registrering.
5. Publisering og API-nøkler — vertene og nøklene tilhører alltid denne installasjonen; publiser appen og utsted nye nøkler til konsumentene.

#Vanlige feil

Melding	Hva som skjer	Hva du gjør
«Filen er ikke en gyldig .keplinapp-pakke.»	Filen er korrupt eller ikke en pakke.	Eksporter på nytt fra kilden og bruk filen slik den ble lastet ned.
«Denne pakken ble eksportert med hemmeligheter — oppgi passfrasen.»	Pakken er i det beskyttede moduset og feltet sto tomt.	Fyll inn Passfrase og prøv igjen.
«Feil passfrase — hemmelighetene i pakken lar seg ikke dekryptere.»	Passfrasen er ikke den fra eksporten.	Sjekk med den som eksporterte; uten riktig passfrase kommer ikke pakken inn.
«Det finnes allerede en app med sluggen «…» — velg en annen slug for importen.»	Den opprinnelige sluggen er allerede opptatt i denne installasjonen.	Fyll inn Slug (valgfritt) med en ny identifikator.
«Pakken er for stor (maks 200 MB).»	Filen overskrider grensen.	Eksporter uten hemmeligheter (dataene blir igjen) eller reduser filene i appen ved kilden.
«Pakken er fra en nyere versjon av Keplin…»	Målinstallasjonen er utdatert.	Oppdater målplattformen og importer på nytt.