Apps aanmaken en beheren
Waar de apps leven, hoe u er een aanmaakt in het venster Nieuwe app, hoe u de naam en het icoon wijzigt, en hoe u een app verwijdert zonder verrassingen.
In Keplin is de app de eenheid van alles: elke applicatie die u bouwt — met haar eigen gegevensmodel, haar eigen schermen, haar eigen API's, haar eigen scripts, haar eigen gebruikers en haar eigen instellingen — is een app, op zichzelf staand en onafhankelijk van de andere. Deze pagina laat zien waar de apps verschijnen, hoe u er een aanmaakt, hoe u haar identificatie wijzigt, en wat er (precies) gebeurt wanneer u haar verwijdert.
Waar de apps leven
De apps staan op twee plaatsen:
- Het Dashboard, de eerste pagina na het aanmelden, heeft één rij per app die uw account kan openen, met de activiteit van de laatste 24 uur. Klik op de naam van een app om haar te openen. Zie De werkruimte.
- De linkerzijbalk toont in het midden de apps die u op het Dashboard hebt vastgezet met de speld Vastzetten in de zijbalk. De balk valt uiteen in drie zones: bovenaan het Dashboard, onderaan het beheer (Observability, Gebruikers, API-sleutels, Instellingen) en in het midden de vastgezette apps, elk met haar eigen pictogram en naam. Het is de enige zone van de balk die gaat scrollen wanneer het er veel worden.

- Met de balk ingeklapt ziet u alleen de iconen; ga er met de muis overheen om hem uit te klappen, of gebruik Zijbalk vastzetten (de speld bovenaan) om hem open te houden.
- Klik op een app om haar te openen: u komt in haar werkruimte, op het tabblad Overzicht, met de inhoudsbomen (UI, Code, Data, Tests, Radar) in de eigen balk van de app.
Opmerking
Niet iedereen ziet dezelfde apps. Een beheerder ziet ze allemaal; een developer ziet alleen de apps die hem op zijn fiche zijn toegewezen, in Gebruikers. Als een app "niet verschijnt", is dit bijna altijd de reden.
Een app aanmaken
Een app aanmaken is een venster openen, haar een naam en een icoon geven. Alleen beheerders hebben de knop.
- Klik in de koptekst van het Dashboard, of in de appzone van de zijbalk (de knop met het plusteken, aan het einde van de lijst), op Nieuwe app.
- Het venster Nieuwe app opent — "Kies hoe de app ontstaat: leeg, met datasource, vanuit een sjabloon of geïmporteerd." — met vier kaarten: Lege applicatie, Applicatie met datasource, Vanuit een sjabloon en Pakket importeren. Voor een app van nul kiest u Lege applicatie. (De kaart Applicatie met datasource doet hetzelfde en maakt meteen de eerste SQLite-datasource van de app aan; sjablonen en importeren hebben eigen pagina's in dit hoofdstuk.)
- Vul de Naam in. Dat is de naam die in de zijbalk en in de koppen
verschijnt — bijvoorbeeld
Klantenbeheer. - Schrijf desgewenst een Beschrijving — een zin die de rest van het team vertelt waar de app voor dient.
- Kies het Icoon (zie de volgende sectie).
- Klik op App aanmaken. De app wordt leeg geboren, verschijnt op het Dashboard en haar werkruimte opent meteen. Om haar ook in de zijbalk te hebben, zet u haar op het Dashboard vast met Vastzetten in de zijbalk.

| Veld | Verplicht | Grenzen | Waarvoor het dient |
|---|---|---|---|
| Naam | Ja | 2 tot 120 tekens | De zichtbare naam van de app, overal. |
| Beschrijving | Nee | Tot 500 tekens | Context voor het team; verschijnt in de kop van de app. |
| Icoon | Nee | — | Het gezicht van de app in de zijbalk. Zonder keuze blijft het de raket. |
De slug — de identificatie die met de app wordt geboren
Naast het veld Naam staat de opmerking: "De slug wordt automatisch van de
naam afgeleid." De slug is de korte, technische versie van de naam —
kleine letters, zonder spaties of accenten: Gestão de Clientes geeft
gestao-clientes. Hij identificeert de app in de adressen (de werkversie
antwoordt op /app/gestao-clientes), in de export en in de bevestiging van
het verwijderen.
Let op
De slug moet uniek zijn binnen de installatie en wijzigt niet meer nadat de app bestaat. Bestaat er al een app met dezelfde slug, dan stopt het aanmaken met de fout "Er bestaat al een project met de slug…" — wijzig de naam (of verwijder de oude app) en probeer het opnieuw.
Het icoon van de app
Het veld Icoon opent de kiezer Icoon kiezen van het platform: een raster met honderden iconen en een vak "Iconen zoeken…" om op naam te filteren. Klik op een icoon om het te kiezen; Standaard brengt de oorspronkelijke raket terug.
Het gekozen icoon vergezelt de app overal: in de zijbalk, in de kop van de werkruimte, en het reist met haar mee wanneer u haar in een pakket exporteert. In een installatie met veel apps is een onderscheidend icoon goud waard — daaraan vindt u de app met de balk ingeklapt.
De naam, de beschrijving of het icoon wijzigen
De identificatie van de app wijzigt u op elk moment in haar instellingen:
- Open de app, vanaf het Dashboard of in de zijbalk.
- Klik boven in de balk van de app op de tandwielknop Instellingen van de app en kies Algemeen.
- Wijzig in het paneel Identificatie de Naam, de Beschrijving of het icoon. Het icoon staat pal naast de naam, omdat die twee zo op het Dashboard en in de zijbalk verschijnen.
- Klik op Opslaan. De bevestiging "Instellingen opgeslagen." verschijnt, en het Dashboard en de zijbalk worden meteen bijgewerkt.

Opmerking
De naam wijzigen wijzigt niet de slug en evenmin een gepubliceerd adres — wie de app gebruikt, merkt er niets van. De naam is cosmetisch; de slug is structureel.
Het pictogram op de telefoon
KeplinGo zet een snelkoppeling naar elke app op het startscherm van de telefoon (zie De telefoon met een app verbinden). Het pictogram van die snelkoppeling kiest u in het paneel Pictogram op de telefoon van de sectie Algemeen.
Zo kiest u het pictogram op de telefoon:
- Open in de Instellingen van de app de sectie Algemeen.
- Klik in het paneel Pictogram op de telefoon op Afbeelding uploaden en kies de afbeelding. Om een afbeelding te gebruiken die al in de assets van de app staat, klikt u op de afbeeldingsknop links van Afbeelding uploaden.
- Optioneel: kies bij Achtergrondkleur de kleur achter de transparante delen van de afbeelding. Leeg is wit.
- Controleer bij Zo ziet het eruit op Android dat het belangrijke deel van de tekening binnen de gestippelde cirkel valt.
- Klik op Opslaan.
De afbeelding moet een vierkante PNG, JPG of WebP zijn van minstens 432 × 432 px. Android snijdt de hoeken af met de vorm die de fabrikant van de telefoon heeft gekozen (cirkel, superellips of afgerond vierkant), en alleen de middelste cirkel, ongeveer 61% van de zijde, is altijd zichtbaar. De voorbeeldweergave toont de hele afbeelding met die veilige zone, en de afbeelding in elk van de drie vormen.
Zonder afbeelding tekent KeplinGo het Icoon van de app op de hoofdkleur van het thema. De telefoons werken de snelkoppeling bij de volgende keer dat de app opent.
Opmerking
Afbeelding uploaden slaat de afbeelding meteen op in de assets van de
app, in de map mobile/. Het pictogram van de snelkoppeling verandert pas
na Opslaan.
Een app verwijderen
Een app verwijderen is definitief, en daarom vraagt het platform om meer dan één klik.
- Open Instellingen van de app → Algemeen en ga naar beneden tot het paneel Verwijderen — "De app, haar gegevens en haar bestanden. Dit is niet terug te draaien."
- Klik op App verwijderen.
- Het bevestigingsvenster '"Klantenbeheer" verwijderen?' opent, dat waarschuwt: 'Verwijdert de app "Klantenbeheer" met alle API's, datasources, API-sleutels en pakketten. Er is geen weg terug — de apps die haar gebruiken, verliezen onmiddellijk toegang.'
- Schrijf de slug van de app (
gestao-clientes) in het bevestigingsveld — de knop gaat pas open wanneer de tekst exact overeenkomt. - Klik op Definitief verwijderen. U keert terug naar het Dashboard, nu zonder de app.

Wat er precies gebeurt:
| Wordt verwijderd | De hele app in deze installatie: model, schermen, API's, scripts, rapporten, workflows, alle versies, de accounts van de gebruikers van de app, de bestanden die op de schijf van de app zijn bewaard en haar geschiedenis. |
| Werkt meteen niet meer | De gepubliceerde adressen en de API-sleutels van de app — elk systeem dat haar gebruikte, verliest op dat moment de toegang. |
| Blijft onaangeroerd | De audit (wie wat heeft gedaan blijft raadpleegbaar in de Observability) en alles wat externe infrastructuur is: databases van andere systemen waarmee de app verbonden was, bestanden in S3, SFTP of netwerkshares. Een app verwijderen verwijdert nooit gegevens buiten haar. |
Let op
Er is geen prullenbak en geen "ongedaan maken". Voordat u een app met werk erin verwijdert, exporteert u haar als pakket — de pagina "Apps importeren en exporteren" legt uit hoe, en een bewaard pakket is de enige manier om haar daarna terug te krijgen.
Waarom zie ik niet…?
- …de knop Nieuwe app? Apps aanmaken en importeren is voorbehouden aan beheerders. Met een developerprofiel verschijnt de knop niet — vraag een beheerder om de app aan te maken en aan u toe te wijzen.
- …een app die bestaat? Uw account heeft die app niet toegewezen gekregen. Een beheerder lost dat op in de fiche van uw account, in Gebruikers.
- …het paneel Verwijderen? Alleen beheerders komen in de sectie Algemeen van de instellingen met de bevoegdheid om te verwijderen. Opent de sectie wel maar mislukt het opslaan, controleer dan uw profiel bij een beheerder.