KEPLIN Docs

Instellingen van de app

Thema, vertalingen, authenticatie en registratie, gebruikersaccounts, rechten en rotatie van registraties — alles wat u in een app bijstelt, sectie voor sectie.

Elke app heeft haar eigen instellingen — het thema is van deze app, de accounts zijn van deze app, de rechten zijn van deze app. Daarom reizen de instellingen met haar mee wanneer u haar in een pakket exporteert (met de uitzonderingen die de pagina "Apps importeren en exporteren" uitwerkt). Deze pagina loopt alle secties door, met bijzondere aandacht voor de zes die het meest worden gebruikt: thema, vertalingen, authenticatie, accounts, rechten en rotatie van registraties.

De instellingen openen

  1. Open de app, vanaf het Dashboard of in de zijbalk.
  2. Klik boven in de balk van de app op de tandwielknop Instellingen van de app. De navigatieboom maakt plaats voor de boom met instellingen, geordend in groepen.
  3. Klik op een sectie: zij opent als een tabblad van de werkruimte — net als een scherm of een script — met de naam van de app in de kop, de actieve sectie op een badge ernaast, en de knoppen van de sectie (bijvoorbeeld Opslaan) altijd rechtsboven.

De boom met instellingen van de app, met de groepen en de secties
De boom met instellingen van de app, met de groepen en de secties

De volledige kaart:

Groep Sectie Wat u erin vastlegt
Applicatie Algemeen Identificatie, pictogram op de telefoon, publicatie, exporteren en verwijderen. Zie de eerste twee pagina's van dit hoofdstuk.
Applicatie Authenticatie Hoe de gebruikers de app binnenkomen, openbare registratie en herstel.
Applicatie Meldingen De meldingskanalen van de app: in de app en e-mail (eigen SMTP).
Applicatie Opslag Waar de bestanden heen gaan die de gebruikers van de app uploaden (schijf van de app, S3, SFTP, netwerkshare).
Gebruikers Gebruikers van de app De accounts van wie de gebouwde app gebruikt.
Gebruikers Rechten Rollen en regels: gegevens, schermen, menu's en acties.
Uiterlijk Thema Kleuren, vorm en typografie van de gebouwde app, met voorbeeld.
Lokalisatie Vertalingen De talen van de app en de vertaalde zinnen, in een matrix.
Gegevens Rotatie van registraties Hoeveel dagen elk soort registratie wordt bewaard voordat die wordt verwijderd.

Opmerking

Dit zijn de instellingen van de app — niet te verwarren met de Instellingen van het platform (in de beheerzone van de zijbalk), die de hele installatie besturen: achtergrondprocessen, waarschuwingen, sessies en globale limieten.

Thema

De sectie Thema schildert de gebouwde app — die uw gebruikers zien — zonder ook maar één scherm aan te raken. Links staan de kleurgroepen; rechts toont het paneel Voorbeeld "Voorbeeld met de huidige tokens — wordt live bijgewerkt": elke kleur die u wijzigt, verschijnt daar op slag.

De sectie Thema van de instellingen van de app: de kleurgroepen links en het live voorbeeld rechts.
De sectie Thema van de instellingen van de app: de kleurgroepen links en het live voorbeeld rechts.

Groep Wat die schildert
Basis "Achtergrond en tekst van de app, randen en focus."
Oppervlakken "Kaarten en popovers (menu's, dropdowns, tooltips)."
Kleuren "Semantische kleuren van de componenten en de tekst op elk ervan" — primair, secundair, destructief, accent, gedempt.
Navigatie "De navigatiebalken van de app (boven, menu's, actiebalk)." Standaard volgen zij de oppervlakken; wijzig ze om uw huisstijl toe te passen. De logozone van de bovenbalk heeft een eigen achtergrond (Achtergrond van de logozone); standaard is dat de kleur van de balk.
Zijbalk "De zijbalk van de app, in elk gedrag (vast, inklapbaar, mini of mini met paneel), en de lade op tablet en telefoon." Standaard volgt hij de kleuren van de navigatie, dus een bestaande app blijft gelijk tot u deze kleuren wijzigt. De menu's die vanuit de zijbalk openen (gebruiker, taal, meldingen) gebruiken ook deze kleuren.

Elke kleur heeft een visuele kiezer en een hexadecimaal veld (#rrggbb) — typen of kiezen, het is hetzelfde. Onderaan de lijst legt Vorm en typografie de rest vast:

  • Hoekstraal — van Geen afronding (0) tot Maximum (1rem), in vijf stappen.
  • Positie van de meldingen — in welke hoek de meldingen (toasts) van de app verschijnen.
  • Lettertype (sans) — de lettertypestack van de app.

Om op te slaan: Opslaan; om terug te keren naar de oorspronkelijke kleuren: Standaardwaarden herstellen (dat herstelt ze in de editor — het wordt pas definitief wanneer u opslaat). Het opgeslagen thema geldt meteen voor de gebouwde app, en het reist met haar mee in elk pakket.

Vertalingen — de talen van de app

De sectie Vertalingen is een matrix: één rij per zin, één kolom per taal. Hier krijgt de app talen en worden de zinnen van de schermen vertaald zonder dat u één tabel hoeft te verlaten.

De vertaalmatrix van de app: één rij per zin, één kolom per taal.
De vertaalmatrix van de app: één rij per zin, één kolom per taal.

  • Een zin aanmaken: schrijf op de laatste rij, die altijd leeg staat te wachten ("typ om aan te maken…"). De Sleutel van de zin "(komt uit de zin)" — het is de tekst zelf in de basistaal die haar op de schermen identificeert.
  • Een taal toevoegen: klik op de + in de kop, kies bij "taal kiezen…" en bevestig met Taal toevoegen. Een nieuwe taal is een nieuwe kolom, die leeg wordt geboren.
  • De basistaal wisselen of een taal verwijderen: in het menu van de kolom — Tot basistaal maken en Deze taal verwijderen ("De vertalingen van deze taal verdwijnen ermee.").
  • Een zin verwijderen: in het menu van de rij, Zin verwijderen — hij verdwijnt uit alle talen zodra u opslaat.
  • Vinden wat ontbreekt: de zoekfunctie "In elke taal zoeken…" en het filter Nog aan te vullen tonen alleen de zinnen met lege cellen.

Op de schermen gebruikt u de zinnen via de tekst: t("Klantenlijst") in een TypeScript-gebeurtenis geeft de vertaling terug in de taal van wie de app gebruikt. Voor waarden midden in de zin schrijft u ze tussen accolades — «{n} records» geeft «3 records» — en het platform waarschuwt (gele cel) wanneer een vertaling een accolade kwijt is die het origineel wel heeft: in die taal zou de waarde niet verschijnen.

Tip

De tekst van een al opgeslagen zin wijzigen is haar sleutel wijzigen — en het platform wisselt haar ook op de schermen die haar gebruiken, en zegt in hoeveel schermen het heeft ingegrepen. Er blijft niets wijzen naar een zin die niet meer bestaat.

Tot slot: Opslaan: "Vertalingen opgeslagen en gecompileerd."

Wie de app gebruikt, kiest de taal in de taalkiezer van de navigatie (het item Taal) of met een knop op een scherm die keplin.i18n.setLocale aanroept. Zonder keuze opent de app in de taal van de browser of de telefoon als de app die heeft, en anders in de basistaal.

Authenticatie en registratie

Het onderdeel Authenticatie bepaalt hoe men zich aanmeldt bij de gebouwde app, niet bij het platform. Het heeft twee blokken.

Het onderdeel Authenticatie van de app, met de aanmeldmethoden en de openbare registratie
Het onderdeel Authenticatie van de app, met de aanmeldmethoden en de openbare registratie

Aanmeldmethoden: hoe de gebruikers van deze app zich aanmelden, in de volgorde van deze lijst.

  • Gebruikersnaam en wachtwoord: de referenties die in Gebruikers van de app worden beheerd. Dit is de standaardmethode.
  • De authenticatieproviders die in de Instellingen van het platform zijn geregistreerd, in Authenticatie van de apps: Microsoft Entra ID, Google, OpenID Connect, OAuth 2.0 en Active Directory. Schakel in wat de app gebruikt en zet het in volgorde met Omhoog en Omlaag.
  • Direct aanmelden: met een gekozen provider gaat wie de app opent meteen naar die provider, zonder het aanmeldscherm.

Hoe providers worden geregistreerd en accounts van gebruikers worden gekoppeld, staat in Aanmelden met authenticatieproviders.

Registratie en herstel: de openbare systeemschermen van de app, alleen voor mensen die zich met een wachtwoord aanmelden. Aanmelden via een provider maakt nooit gebruikers aan.

  • Openbare registratie toestaan: ingeschakeld „kan elke bezoeker een account maken op het scherm /register. Uitgeschakeld wordt het scherm niet geserveerd.”
  • Rol voor nieuwe registraties: de rol die automatisch wordt gegeven aan wie zich registreert. Kies een rol uit de lijst van Rechten, of Geen rol, maar zonder rol komt het account binnen en ziet het geen gegevens of schermen.
  • Het wachtwoordherstel stuurt de link via het e-mailkanaal dat in Meldingen is ingesteld. Het kanaal moet actief zijn en een volledige SMTP hebben, anders zijn er geen herstel-e-mails.

Sla op met Opslaan.

Gebruikers van de app — de accounts

De sectie Gebruikers van de app beheert de accounts van wie de app gebruikt. De waarschuwing bovenaan is de gouden regel: "Deze gebruikers horen bij de gebouwde app — zij melden zich in de runtime bij de app aan en hebben geen enkele toegang tot het KEPLIN-platform."

De lijst met gebruikers van de app Klantenbeheer: de rollen van elk account en de laatste aanmelding.
De lijst met gebruikers van de app Klantenbeheer: de rollen van elk account en de laatste aanmelding.

De lijst toont elk account met de Gebruiker, de Rollen en de Laatste aanmelding ("nooit aangemeld" wanneer er nooit een aanmelding is geweest), en zij is gemaakt om vragen te beantwoorden:

  • De zoekfunctie "Zoeken op naam, gebruikersnaam of e-mail…" en de filters op rol en status vinden elk account.
  • De amberkleurige waarschuwing "… gebruiker(s) helemaal zonder rol — zij zien geen gegevens en geen schermen" is aanklikbaar en filtert die accounts meteen — het is oorzaak nummer één van "de app is leeg".
  • Selecteer meerdere accounts om er in bulk op in te grijpen: Rol toekennen, Rol intrekken, Inschakelen, Uitschakelen — dezelfde rol aan twaalf mensen geven is één handeling, geen twaalf vensters.

Een account aanmaken of bewerken (knop Nieuwe gebruiker, of Bewerken in het menu van de rij — opent als pagina, nooit als venster):

Veld Opmerkingen
Gebruikersnaam Verplicht. "Letters, cijfers, punt, koppelteken, _ en @."
Naam / E-mail Optioneel; het e-mailadres is nodig voor het wachtwoordherstel.
Wachtwoord Bij het aanmaken is dit het beginwachtwoord — "de gebruiker kan het in de app wijzigen." Bij het bewerken: "Alleen invullen om een nieuw wachtwoord in te stellen."
Actief Uit bestaat het account wel, maar "kan het zich niet bij de app aanmelden."
Rollen Per rol aangevinkt. Een nieuw account heeft de rollen die "standaard" in de Rechten zijn vastgelegd al aangevinkt.

Een account verwijderen (menu van de rij → Verwijderen) is onomkeerbaar — de gebruiker kan zich niet meer bij de app aanmelden.

Opmerking

De rechten bewerkt u niet op het account. Die bewerkt u altijd in de rollen, in de sectie Rechten — een uitzondering die op één persoon wordt gezet, is een uitzondering die niemand ooit terugvindt.

Rechten

De sectie Rechten legt vast wat elke rol in de app mag doen, langs vier assen: gegevens, schermen, menu's en acties. "De rechten tellen op: wie twee rollen heeft, krijgt het beste van beide."

De sectie Rechten van de app: de rollen, met de gebruikers en de regels van elk, en de gedeclareerde acties eronder.
De sectie Rechten van de app: de rollen, met de gebruikers en de regels van elk, en de gedeclareerde acties eronder.

De lijst met Rollen toont elke rol met het aantal gebruikers en regels, en de badges "volledige toegang" en "standaard". Nieuwe rol maakt er een aan en opent meteen haar pagina, met vijf tabbladen:

Algemeen — de Naam, de Beschrijving en twee schakelaars:

  • Volledige toegang: "Alles, zonder uitzonderingen — en het blijft kloppen wanneer de app groeit." Dit is de beheerdersrol van de app; met deze schakelaar aan zijn de andere tabbladen niet eens van toepassing.
  • Standaard toegekend: "Toegekend aan wie zich registreert of nieuw wordt aangemaakt."

Gegevens — één rij per tabel-API, met vier vinkjes — Bekijken, Aanmaken, Wijzigen, Verwijderen — en een Bereik dat zegt tot welke records men komt:

Bereik Betekenis
Alle records Zonder beperking op rijen.
Alleen de mijne Alleen de records waarvan het "Veld dat aangeeft van wie het is" de aangemelde gebruiker is.
Met voorwaarde… Alleen de records die voldoen aan een filter dat u samenstelt — met vaste waarden of waarden uit de sessie. Een voorwaarde "niet gelijk aan" of "geen van" omvat records met een leeg veld. Een voorwaarde op een veld dat niet meer in het model bestaat, weigert de gegevens in plaats van ze allemaal te tonen.

"Het bereik wordt op de server toegepast, bij elke lees- en schrijfbewerking — in de schermen, in de code, in de rapporten en in de workflows. Zonder ook maar één regel ziet deze rol niets van deze API."

Schermen — voor elk scherm en elk apparaat (Web, Tablet, Telefoon) een niveau: Verborgen ("verschijnt niet in de menu's, en een met de hand ingetypte route wordt geweigerd"), Bekijken (alleen-lezen) ("opent alleen-lezen — velden en knoppen die schrijven, staan uit") of Bewerken. De snelkoppelingen "alles bekijken" / "alles verbergen" vullen een hele kolom. Het «bekijken» is een visuele hulp; wat het schrijven echt tegenhoudt, zijn de rechten van Gegevens, op de server.

Menu's — anders dan bij schermen is een menu standaard zichtbaar: de deur is het scherm, en die is al gesloten. Hier verbergt u de rest — een hele groep, de bel van de meldingen — per apparaat. Een groep uitvinken neemt de kinderen mee.

Acties — de werkwoorden die alleen in deze app bestaan: goedkeuren, afsluiten, exporteren. Zij worden gedeclareerd in het paneel Acties van de rollenlijst (een Sleutel als uitgave-goedkeuren en een Naam, knop Nieuwe actie) en elke rol vinkt aan welke zij geeft. Op de schermen heeft elke widget de eigenschap «Toegang» om een actie te vereisen; in TypeScript-code vraagt u keplin.session.can("uitgave-goedkeuren").

Alles wordt in één keer opgeslagen met Opslaan ("Rechten opgeslagen."). Een rol verwijderen waarschuwt hoeveel gebruikers haar kwijtraken — "wie helemaal geen rol overhoudt, ziet geen gegevens meer."

Opslag

Het onderdeel Opslag bepaalt waar de bestanden heen gaan die de gebruikers van de app uploaden. Er zijn vier typen:

Type Waar de bestanden blijven
Schijf van de app In de map van deze app, op de Keplin-server.
S3 (of compatibel) In een bucket van Amazon S3 of van een compatibele dienst (MinIO, Wasabi, R2).
SFTP Op een server via SSH, met gebruiker en wachtwoord of privésleutel.
Netwerkshare In een gedeelde map van een bestandsserver in het netwerk (Windows Server vanaf 2012, of een NAS). Alleen in installaties met één tenant.

Een app zonder geconfigureerde opslag krijgt bij de eerste upload vanzelf de Schijf van de app. Met meerdere markeert u er één met Standaard gebruiken: daarheen gaan de uploads die geen opslag kiezen.

Een opslag toevoegen

  1. Klik op Opslag toevoegen en kies het Type.
  2. Geef het een naam, bijvoorbeeld „Documentarchief”.
  3. Vul de verbinding in:
    • S3 (of compatibel): de Access key, de Secret key, de Regio en, voor een andere dienst dan Amazon, het Endpoint en Pad in plaats van subdomein. Klik daarna bij Bucket op Bucket kiezen en kies hem uit de lijst van het account.
    • SFTP: de Server, de Poort, de Gebruiker en de Aanmeldmethode (Wachtwoord of Privésleutel).
    • Netwerkshare: de Server (het IP-adres of de naam van de bestandsserver), het Domein van het account (bijvoorbeeld EMPRESA; leeg voor een account van de server zelf), de Gebruiker en het Wachtwoord. Klik daarna bij Share op Share kiezen en kies hem uit de lijst van de server.
  4. Klik bij Map op Map kiezen. Er opent een venster met de mappen van de bestemming: blader naar de map, of maak er een met Nieuwe map, en klik op Deze map kiezen. De hoofdmap kan ook worden gekozen.
  5. Klik op Testen. De test schrijft, leest en verwijdert een echt bestand.
  6. Klik op Opslaan.

Het venster om de map van een opslag te kiezen
Het venster om de map van een opslag te kiezen

Als de verbinding mislukt, noemt het bericht de oorzaak: een servernaam die niet wordt gevonden, een poort die de verbinding weigert, een onjuist of verlopen wachtwoord, een share die niet bestaat of waar het account geen toegang toe heeft, of een map waarin het account niet mag schrijven.

De opslag omvat de assets en de bestanden van de scripts niet: die blijven op de schijf van het platform.

Opmerking

De Netwerkshare maakt rechtstreeks verbinding met de bestandsserver, met SMB 2 of 3 en de authenticatie NTLMv2. Netwerkshares die vóór versie 2.28 zijn ingesteld en een map gebruikten die op de Keplin-server was gekoppeld, tonen een waarschuwing en moeten opnieuw worden ingesteld met de server, het account en de share.

Rotatie van registraties

Een app met verkeer schrijft onophoudelijk geschiedenis — aanroepen, uitvoeringen, kliks. De sectie Rotatie van registraties bepaalt "hoeveel dagen elk soort registratie wordt bewaard voordat die wordt verwijderd. Nul dagen betekent voor altijd bewaren."

De matrix van de rotatie van registraties, met het aantal te bewaren dagen per soort
De matrix van de rotatie van registraties, met het aantal te bewaren dagen per soort

Het is een raster met één rij per soort Registratie en de termijn in Bewaren (het veld toont "Voor altijd bewaard" wanneer het op nul staat):

Registratie Wat het is Van huis uit
Aanroepen van de API's "Eén rij per GraphQL-verzoek. Dit groeit het snelst in een app met verkeer." Voor altijd bewaren
Uitvoeringen van scripts "De geschiedenis achter de knop «Uitvoeringen» van de scripteditor." Voor altijd bewaren
Fouten van de apps "De voorvallen achter de problemen die de Radar toont. Ze verwijderen laat het probleem niet verdwijnen, alleen de geschiedenis ervan." Voor altijd bewaren
Navigatie en klikken "Groot volume en korte waarde: het dient om te onderzoeken wat er zojuist is gebeurd, niet als geschiedenis." 2 dagen
Planningen "De geplande tijden en wat er niet is gebeurd. Wat is mislukt, wordt twee keer zo lang bewaard." 30 dagen
Workflow-instanties "Alleen de instanties die al zijn afgerond. Instanties die nog draaien of op iemand wachten, worden nooit verwijderd. Mislukte instanties blijven twee keer zo lang staan." Voor altijd bewaren
Audit "Wie wat heeft gedaan. Hij wordt door alle apps gedeeld, dus geldt altijd de langste termijn van allemaal." Voor altijd bewaren

De opschoning draait in alle versies van de app die registraties op schijf hebben — de werkversie en de gepubliceerde —, elk met het beleid dat in die versie is opgeslagen.

Opslaan past het beleid toe ("Rotatie opgeslagen.") en de opschoning gaat voortaan elke dag op de achtergrond draaien.

Tip

Leg in een productie-app vanaf de eerste dag echte termijnen vast — 30 tot 90 dagen voor de aanroepen van de API's is een gezond vertrekpunt. "Voor altijd bewaren" is prima tijdens de ontwikkeling en een schijffactuur in productie.

Limieten om rekening mee te houden

De limieten die u in de instellingen en de handelingen van dit hoofdstuk tegenkomt:

Wat Limiet
Naam van de app 2 tot 120 tekens
Beschrijving van de app Tot 500 tekens
Gebruikersnaam van een gebruiker van de app 2 tot 120 tekens (letters, cijfers, punt, koppelteken, _ en @)
Passphrase van de export Minimaal 8 tekens
Pakket voor het importeren Maximaal 1 GB
Rotatie van registraties 0 tot 3650 dagen per soort (0 = voor altijd bewaren)

De globale limieten — de duur van de sessies en de maximale grootte van de geüploade bestanden — zijn niet per app: die wonen in de Instellingen van het platform, in het paneel "Sessies en limieten", en gelden voor de hele installatie.