Apps aanmaken en beheren

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 zijn altijd binnen handbereik, in de linkerzijbalk van het platform. De balk valt uiteen in drie zones: bovenaan het Dashboard, onderaan het beheer (Observability, Gebruikers, API-sleutels, Instellingen), en de hele ruimte daartussen is van de apps — elk met haar eigen icoon en haar eigen naam. Het is de enige zone van de balk die groeit en 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, Radar) in de eigen balk van de app.
• De kaart Apps van het Dashboard toont hoeveel geregistreerde apps er in de installatie zijn.

#Een app aanmaken

Een app aanmaken is een venster openen, haar een naam en een icoon geven. Alleen beheerders hebben de knop.

1. Klik in de appzone van de zijbalk op Nieuwe app (de knop met het plusteken, onder aan de lijst).
2. 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.)
3. Vul de Naam in. Dat is de naam die in de zijbalk en in de koppen verschijnt — bijvoorbeeld Klantenbeheer.
4. Schrijf desgewenst een Beschrijving — een zin die de rest van het team vertelt waar de app voor dient.
5. Kies het Icoon (zie de volgende sectie).
6. Klik op App aanmaken. De app wordt leeg geboren, verschijnt in de zijbalk en haar werkruimte opent meteen.

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.

#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:

1. Open de app in de zijbalk.
2. Klik boven in de balk van de app op de tandwielknop Instellingen van de app en kies Algemeen.
3. Wijzig in het paneel Identificatie de Naam, de Beschrijving of het icoon — het icoon staat pal naast de naam, omdat die twee zo ook in de zijbalk verschijnen.
4. Klik op Opslaan. De bevestiging "Instellingen opgeslagen." verschijnt en de zijbalk wordt meteen bijgewerkt.

#Een app verwijderen

Een app verwijderen is definitief, en daarom vraagt het platform om meer dan één klik.

1. 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."
2. Klik op App verwijderen.
3. 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.'
4. Schrijf de slug van de app (gestao-clientes) in het bevestigingsveld — de knop gaat pas open wanneer de tekst exact overeenkomt.
5. 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.

#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.