KEPLIN Docs

Sovellusten luonti ja hallinta

Missä sovellukset asuvat, miten sellainen luodaan modaalissa Uusi sovellus, miten nimi ja kuvake vaihdetaan, ja miten sovellus poistetaan ilman yllätyksiä.

Keplinissä sovellus on kaiken yksikkö: jokainen rakentamasi sovellus — tietomalleineen, näyttöineen, API:neen, skripteineen, käyttäjineen ja asetuksineen — on sovellus, itsenäinen ja muista riippumaton. Tämä sivu näyttää, missä sovellukset näkyvät, miten sellainen luodaan, miten sen tunnistetietoja muutetaan, ja mitä (tarkalleen) tapahtuu, kun sellainen poistetaan.

Missä sovellukset asuvat

Sovellukset ovat kahdessa paikassa:

  • Kojelaudalla, joka on ensimmäinen sivu kirjautumisen jälkeen, on yksi rivi jokaista sovellusta kohden, jonka tilisi voi avata, ja viimeisten 24 tunnin toiminta. Napsauta sovelluksen nimeä avataksesi sen. Katso Työtila.
  • Vasen sivupalkki näyttää keskellä sovellukset, jotka olet kiinnittänyt Kojelaudalla nastalla Kiinnitä sivupalkkiin. Palkki jakautuu kolmeen vyöhykkeeseen: ylhäällä Kojelauta, alhaalla hallinta (Havainnointi, Käyttäjät, API-avaimet, Asetukset) ja keskellä kiinnitetyt sovellukset, kullakin oma kuvakkeensa ja nimensä. Se on palkin ainoa vyöhyke, joka saa vierityksen, kun sovelluksia on paljon.

Sivupalkki, kiinnitetyt sovellukset keskivyöhykkeellä, sovellus Gestão de Clientes niiden joukossa
Sivupalkki, kiinnitetyt sovellukset keskivyöhykkeellä, sovellus Gestão de Clientes niiden joukossa

  • Kutistetussa palkissa näet vain kuvakkeet; vie hiiri sen päälle laajentaaksesi sen, tai käytä Kiinnitä sivupalkki (nasta ylhäällä) pitääksesi sen auki.
  • Napsauta sovellusta avataksesi sen: astut sen työtilaan, välilehdelle Yleiskatsaus, sisältöpuut (UI, Koodi, Data, Testit, Radar) sovelluksen omassa palkissa.

Huomio

Kaikki eivät näe samoja sovelluksia. Ylläpitäjä näkee kaikki; developer näkee vain sovellukset, jotka hänelle on määritetty hänen tiedoissaan, kohdassa Käyttäjät. Jos sovellus ”ei näy”, kyse on lähes aina tästä.

Sovelluksen luominen

Sovelluksen luominen on modaalin avaamista, nimen ja kuvakkeen antamista. Vain ylläpitäjillä on painike.

  1. Napsauta Kojelaudan otsikossa tai sivupalkin sovellusvyöhykkeellä (plusmerkkipainike luettelon lopussa) Uusi sovellus.
  2. Avautuu modaali Uusi sovellus — ”Valitse, miten sovellus syntyy: tyhjänä, datasourcella, mallista tai tuotuna.” — neljällä kortilla: Tyhjä sovellus, Sovellus datasourcella, Mallista ja Tuo paketti. Alusta alkavalle sovellukselle valitse Tyhjä sovellus. (Kortti Sovellus datasourcella tekee saman ja luo heti sovelluksen ensimmäisen SQLite-datasourcen; malleilla ja tuonnilla on omat sivunsa tässä luvussa.)
  3. Täytä Nimi. Se on nimi, joka näkyy sivupalkissa ja ylätunnisteissa — esimerkiksi Gestão de Clientes.
  4. Halutessasi kirjoita Kuvaus — lause, joka kertoo muulle tiimille, mihin sovellus on.
  5. Valitse Kuvake (katso seuraava osio).
  6. Napsauta Luo sovellus. Sovellus syntyy tyhjänä, ilmestyy Kojelaudalle ja sen työtila avautuu heti. Jos haluat sen myös sivupalkkiin, kiinnitä se Kojelaudalla valinnalla Kiinnitä sivupalkkiin.

Modaali Uusi sovellus, välilehti Luo alusta täytettynä sovellukselle Gestão de Clientes
Modaali Uusi sovellus, välilehti Luo alusta täytettynä sovellukselle Gestão de Clientes

Kenttä Pakollinen Rajat Mihin se on
Nimi Kyllä 2–120 merkkiä Sovelluksen näkyvä nimi, kaikkialla.
Kuvaus Ei Enintään 500 merkkiä Kontekstia tiimille; näkyy sovelluksen ylätunnisteessa.
Kuvake Ei — Sovelluksen kasvot sivupalkissa. Ilman valintaa jää raketti.

Slug — tunniste, joka syntyy sovelluksen mukana

Kentän Nimi vieressä on huomautus: ”Slug johdetaan automaattisesti nimestä.” Slug on nimen lyhyt ja tekninen versio — pienaakkosin, ilman välilyöntejä ja aksentteja: Gestão de Clientes antaa gestao-clientes. Se yksilöi sovelluksen osoitteissa (työversio vastaa osoitteessa /app/gestao-clientes), viennissä ja poiston vahvistuksessa.

Varoitus

Slugin on oltava asennuksessa ainutkertainen, ja sitä ei voi muuttaa sovelluksen synnyttyä. Jos samalla slugilla on jo sovellus, luonti pysähtyy virheeseen ”Projekti slugilla … on jo olemassa” — vaihda nimeä (tai poista vanha sovellus) ja yritä uudelleen.

Sovelluksen kuvake

Kenttä Kuvake avaa alustan valitsimen Valitse kuvake: ruudukko, jossa on satoja kuvakkeita, ja hakukenttä ”Hae kuvakkeita…” nimellä suodattamiseen. Napsauta kuvaketta valitaksesi sen; Oletus palauttaa alkuperäisen raketin.

Valittu kuvake seuraa sovellusta kaikkialle: sivupalkkiin, työtilan ylätunnisteeseen, ja se matkustaa sovelluksen mukana, kun viet sen pakettina. Asennuksessa, jossa on paljon sovelluksia, erottuva kuvake on kullanarvoinen — sillä sovellus löydetään palkin ollessa kutistettuna.

Nimen, kuvauksen tai kuvakkeen vaihtaminen

Sovelluksen tunnistetiedot muutetaan sen asetuksissa, milloin tahansa:

  1. Avaa sovellus Kojelaudalta tai sivupalkista.
  2. Napsauta sovelluspalkin yläreunassa ratasta Sovelluksen asetukset ja valitse Yleistä.
  3. Muuta paneelissa Tunnistetiedot kohtaa Nimi, Kuvaus tai kuvaketta. Kuvake on aivan nimen vieressä, koska juuri niin ne kaksi näkyvät Kojelaudalla ja sivupalkissa.
  4. Napsauta Tallenna. Vahvistus ”Asetukset tallennettu.” tulee näkyviin, ja Kojelauta ja sivupalkki päivittyvät heti.

Tunnistetiedot-paneeli sovelluksen Gestão de Clientes asetusten Yleistä-osiossa
Tunnistetiedot-paneeli sovelluksen Gestão de Clientes asetusten Yleistä-osiossa

Huomio

Nimen vaihtaminen ei muuta slugia eikä mitään julkaistua osoitetta — sovelluksen käyttäjät eivät huomaa mitään. Nimi on kosmeettinen; slug on rakenteellinen.

Kuvake puhelimessa

KeplinGo lisää jokaisesta sovelluksesta pikakuvakkeen puhelimen aloitusnäytölle (katso Puhelimen yhdistäminen sovellukseen). Pikakuvakkeen kuvake valitaan osion Yleistä paneelissa Kuvake puhelimessa.

Valitse kuvake puhelimessa näin:

  1. Avaa Sovelluksen asetuksissa osio Yleistä.
  2. Valitse paneelissa Kuvake puhelimessa Lataa kuva ja valitse kuva. Jos haluat käyttää kuvaa, joka on jo sovelluksen asseteissa, valitse kuvapainike kohdan Lataa kuva vasemmalla puolella.
  3. Valinnainen: valitse kohdassa Taustaväri väri, joka jää kuvan läpinäkyvien osien taakse. Tyhjä on valkoinen.
  4. Tarkista kohdassa Miltä se näyttää Androidissa, että kuvan tärkeä osa on katkoviivaympyrän sisällä.
  5. Valitse Tallenna.

Kuvan on oltava neliön muotoinen PNG-, JPG- tai WebP-kuva, vähintään 432 × 432 px. Android rajaa kulmat puhelimen valmistajan valitsemalla muodolla (ympyrä, superellipsi tai pyöristetty neliö), ja vain keskimmäinen ympyrä, noin 61 % sivusta, näkyy aina. Esikatselu näyttää koko kuvan tämän turva-alueen kanssa sekä kuvan kunkin kolmen muodon rajaamana.

Ilman kuvaa KeplinGo piirtää sovelluksen Kuvakkeen teeman päävärin päälle. Puhelimet päivittävät pikakuvakkeen, kun sovellus avataan seuraavan kerran.

Huomio

Lataa kuva tallentaa kuvan heti sovelluksen asseteihin, kansioon mobile/. Pikakuvakkeen kuvake muuttuu vasta, kun valitset Tallenna.

Sovelluksen poistaminen

Sovelluksen poistaminen on lopullista, ja siksi alusta pyytää enemmän kuin yhden napsautuksen.

  1. Avaa Sovelluksen asetukset → Yleistä ja vieritä alas paneeliin Poista — ”Sovellus, sen data ja tiedostot. Tätä ei voi perua.”
  2. Napsauta Poista sovellus.
  3. Avautuu vahvistusikkuna ”Poistetaanko "Gestão de Clientes"?”, joka varoittaa: ”Poistaa sovelluksen "Gestão de Clientes" ja kaikki sen API:t, tietolähteet, API-avaimet ja paketit. Paluuta ei ole — sitä käyttävät sovellukset menettävät pääsyn välittömästi.”
  4. Kirjoita sovelluksen slug (gestao-clientes) vahvistuskenttään — painike vapautuu vasta, kun teksti täsmää tarkalleen.
  5. Napsauta Poista pysyvästi. Palaat Kojelautaan, ilman sovellusta.

Vahvistusikkuna sovelluksen poistamiseksi, slug kirjoitettuna painikkeen vapauttamiseksi
Vahvistusikkuna sovelluksen poistamiseksi, slug kirjoitettuna painikkeen vapauttamiseksi

Mitä tapahtuu, tarkalleen:

Poistetaan Koko sovellus tässä asennuksessa: malli, näytöt, API:t, skriptit, raportit, työnkulut, kaikki versiot, sovelluksen käyttäjien tilit, sovelluksen levylle tallennetut tiedostot ja sen historia.
Lakkaa toimimasta heti Julkaistut osoitteet ja sovelluksen API-avaimet — jokainen sitä käyttänyt järjestelmä menettää pääsyn sillä hetkellä.
Jää koskematta Auditointi (kuka teki mitäkin on yhä katsottavissa Havainnoinnissa) ja kaikki ulkoinen infrastruktuuri: muiden järjestelmien tietokannat, joihin sovellus yhdistyi, tiedostot S3:ssa, SFTP:ssä tai verkkojaoissa. Sovelluksen poistaminen ei koskaan poista dataa sen ulkopuolelta.

Varoitus

Roskakoria tai ”kumoa”-toimintoa ei ole. Ennen kuin poistat sovelluksen, jossa on työtä, vie se pakettina — sivu ”Sovellusten tuonti ja vienti” kertoo miten, ja talletettu paketti on ainoa tapa palauttaa se myöhemmin.

Miksi en näe…?

  • …painiketta Uusi sovellus? Sovellusten luonti ja tuonti kuuluu vain ylläpitäjille. Developer-profiililla painiketta ei ole — pyydä ylläpitäjää luomaan sovellus ja määrittämään sen sinulle.
  • …sovellusta, joka on olemassa? Tilillesi ei ole määritetty sitä sovellusta. Ylläpitäjä hoitaa asian tilisi tiedoissa, kohdassa Käyttäjät.
  • …paneelia Poista? Vain ylläpitäjät pääsevät asetusten Yleistä-osioon poisto-oikeuksin. Jos osio avautuu mutta jokin epäonnistuu tallennettaessa, varmista profiilisi ylläpitäjältä.