Sovellusten tuonti ja vienti

Keplin-sovellus mahtuu yhteen tiedostoon. Paketti .keplinapp kuljettaa kaiken, mitä sovellus on — tietomallin, näytöt, API:t, skriptit, raportit, työnkulut, teeman, käännökset, roolit ja käyttöoikeudet — valmiina asennettavaksi alustan toiseen asennukseen. Se on työkalu kolmeen eleeseen:

• Ympäristön vaihto: kehitetään yhdessä asennuksessa ja asennetaan asiakkaan tuotantoon.
• Toimitus: sovelluksen lähettäminen sille, joka ajaa sen toisella palvelimella.
• Talletus: arkistoitu paketti on kopio sovelluksen suunnitelmasta, joka tuodaan takaisin kun tarve tulee.

Tärkeä päätös on salaisuuksissa: paketti voi matkustaa puhtaana (suositus) tai täydellisenä ja salalauseella salattuna. Kaksi seuraavaa osiota selittävät eleen; taulukko keskellä kertoo tarkalleen, mikä lähtee mukaan kussakin tilassa.

#Sovelluksen vieminen

1. Avaa sovellus ja napsauta ratasta Sovelluksen asetukset, sitten Yleistä.
2. Vieritä alas paneeliin Ota tämä sovellus mukaan — ”.keplinapp-tiedosto asennettavaksi muualle.” — ja napsauta Vie.

3. Avautuu valintaikkuna Vie sovellus: ”Luo .keplinapp-paketin, jossa on kaikki, mitä sovellus on — API:t, skriptit, tietomalli, enumit ja ajastukset — valmiina tuotavaksi toiseen instanssiin.”

4. Valitse kohdassa Salaisuudet toinen kahdesta tilasta:

   Tila	Mitä se tarkoittaa
   Ilman salaisuuksia (suositus)	”Tietolähteiden yhteydet ja salaisuudet lähtevät tyhjinä, ja sovelluksen käyttäjien TILIT jäävät tähän asennukseen — matkaan lähtee sovellus rooleineen ja käyttöoikeuksineen, ei sen käyttäjät.” Oikea tila sovelluksen toimittamiseen kolmansille.
   Salaisuuksien kanssa, salalauseella suojattuna	”Arvot lähtevät salattuina tässä määrittämälläsi salalauseella; sitä kysytään tuotaessa. Tämä on TÄYDELLINEN kopio: mukaan lähtevät myös tilit ja niille kuuluva.” Oikea tila sovelluksen siirtämiseen palvelimelta toiselle mitään menettämättä.

5. Jos valitsit suojatun tilan, määritä Salalause (vähintään 8 merkkiä).

6. Napsauta Vie paketti. Selain lataa tiedoston gestao-clientes.keplinapp ja näkyviin tulee vahvistus ”Paketti viety.”

#Mitä paketissa matkustaa

Paketti erottaa kolme asiaa: sovelluksen (matkustaa aina), sen mikä on tämän asennuksen omaa (ei matkusta koskaan) ja ihmisten datan (matkustaa vain suojatussa tilassa).

Sisältö	Ilman salaisuuksia	Salalauseella
Tietomalli, näytöt, API:t, skriptit, raportit, työnkulut, enumit	Matkustaa	Matkustaa
Teema, käännökset, roolit ja käyttöoikeudet	Matkustaa	Matkustaa
Ajastukset	Matkustavat pois päältä	Matkustavat pois päältä
Yhteydet tietolähteisiin ja tallennustiloihin	Määritykset jäävät tyhjiksi	Matkustaa, salalauseella salattuna
Sovelluksen salaisuudet	Vain avaimet, ”määritettävä” kohteessa	Matkustavat, salattuina
Sovelluksen sisäisten tietokantojen data	Vain taulujen rakenne	Täysi data
Sovelluksen käyttäjien tilit, ilmoituslaatikko, lähetetyt tiedostot, kesken olevat prosessit	Kaikki jää tähän asennukseen	Kaikki matkustaa
Suoritushistoria ja telemetria	Jää	Jää
API-avaimet	Jäävät	Jäävät
Julkaisu (hostit ja tarjoillut versiot)	Jää	Jää

#Paketin tuominen

Tuonti asuu samassa modaalissa kuin luonti:

1. Napsauta sivupalkissa Uusi sovellus ja valitse kortti Tuo paketti (vain ylläpitäjät).
2. Napsauta kohdassa Paketti aluetta ”Napsauta valitaksesi .keplinapp-tiedoston” ja valitse tiedosto.
3. Slug (valinnainen): jätä tyhjäksi säilyttääksesi paketin alkuperäisen slugin — ”Pakollinen vain, jos alkuperäisellä slugilla on jo sovellus.” Näin asennat saman sovelluksen toisen kopion, rinnakkain.
4. Salalause (jos tarpeen): ”vain paketeille, jotka on viety salaisuuksien kanssa”. Puhdas paketti tuodaan ilman mitään salalausetta.
5. Napsauta Tuo. Lopussa näkyy ”Sovellus "Gestão de Clientes" tuotu.” ja sovellus avautuu, jo sivupalkissa.

Yksityiskohtia, jotka kannattaa tietää:

• Paketti saa olla enintään 200 MB.
• Keplinin vanhassa versiossa viety paketti päivitetään automaattisesti sisään tullessaan. Uudemman version paketti hylätään pyynnöllä päivittää alusta ensin.
• Jos jokin epäonnistuu kesken, mitään ei jää asennetuksi — tuonti siivoaa kaiken aloittamansa ja näyttää virheen. Puolikasta sovellusta ei koskaan jää.

#Tuonnin jälkeen

Modaali itse jättää muistutuksen: ”Tuonnin jälkeen: vahvista tietolähteiden yhteydet ja salaisuudet (jos paketti tuli ilman salaisuuksia, ne jäävät tyhjiksi) ja ota haluamasi ajastukset käyttöön — ne tulevat aina pois päältä.” Käytännössä saapumislista on tämä:

1. Tietolähteet — avaa jokainen ja vahvista (tai täytä) yhteys; paketissa ilman salaisuuksia ne tulevat määrittämättöminä.
2. Salaisuudet — avaimet ovat olemassa, arvot ovat tyhjiä; täytä ne.
3. Ajastukset — kytke haluamasi päälle, yksi kerrallaan.
4. Tilit — paketissa ilman salaisuuksia käyttäjiä ei tule; luo heidät sovelluksen asetuksissa (Sovelluksen käyttäjät) tai kytke julkinen rekisteröityminen päälle.
5. Julkaisu ja API-avaimet — hostit ja avaimet ovat aina tämän asennuksen omia; julkaise sovellus ja myönnä uudet avaimet kuluttajille.

#Yleiset virheet

Viesti	Mistä on kyse	Mitä tehdä
”Tiedosto ei ole kelvollinen .keplinapp-paketti.”	Tiedosto on vioittunut tai se ei ole paketti.	Vie uudelleen lähteessä ja käytä tiedostoa juuri sellaisena kuin se latautui.
”Tämä paketti vietiin salaisuuksien kanssa — anna salalause.”	Paketti on suojattua tilaa ja kenttä jäi tyhjäksi.	Täytä Salalause ja toista.
”Väärä salalause — paketin salaisuudet eivät aukea.”	Salalause ei ole viennin salalause.	Varmista viejältä; ilman oikeaa salalausetta paketti ei mene sisään.
”Sovellus slugilla "…" on jo olemassa — valitse tuonnille toinen slug.”	Alkuperäinen slug on jo varattu tässä asennuksessa.	Täytä Slug (valinnainen) uudella tunnisteella.
”Liian suuri paketti (enintään 200 MB).”	Tiedosto ylittää rajan.	Vie ilman salaisuuksia (data jää pois) tai pienennä sovelluksen tiedostoja lähteessä.
”Paketti on Keplinin uudemmasta versiosta…”	Kohdeasennus on vanhentunut.	Päivitä kohdealusta ja tuo uudelleen.