KEPLIN Docs

Creare e gestire le app

Dove vivono le app, come se ne crea una nella finestra Nuova app, come si cambiano nome e icona, e come si elimina un'app senza sorprese.

In Keplin, l'app è l'unità di tutto: ogni applicazione che costruisci — con il suo modello dei dati, le sue schermate, le sue API, i suoi script, i suoi utenti e le sue impostazioni — è un'app, autocontenuta e indipendente dalle altre. Questa pagina mostra dove appaiono le app, come se ne crea una, come se ne cambia l'identificazione, e che cosa succede (esattamente) quando si elimina.

Dove vivono le app

Le app stanno in due posti:

  • La Dashboard, la prima pagina dopo l'accesso, ha una riga per ogni app che il tuo account può aprire, con l'attività delle ultime 24 ore. Clicca sul nome di un'app per aprirla. Vedi Lo spazio di lavoro.
  • La barra laterale sinistra mostra, al centro, le app che hai fissato nella Dashboard con il pin Fissa nel menu laterale. La barra si divide in tre zone: in alto la Dashboard, in basso l'amministrazione (Osservabilità, Utenti, Chiavi API, Impostazioni), e al centro le app fissate, ognuna con la sua icona e il suo nome. È l'unica zona della barra che prende lo scorrimento quando le app sono tante.

La barra laterale con le app fissate nella zona centrale, l'app Gestione Clienti fra loro
La barra laterale con le app fissate nella zona centrale, l'app Gestione Clienti fra loro

  • Con la barra ridotta vedi solo le icone; passaci sopra il mouse per espanderla, o usa Fissa la barra laterale (il pin in alto) per tenerla aperta.
  • Clicca su un'app per aprirla: entri nel suo spazio di lavoro, nella scheda Panoramica, con gli alberi dei contenuti (UI, Codice, Dati, Test, Radar) nella barra propria dell'app.

Nota

Non tutti vedono le stesse app. Un amministratore le vede tutte; un developer vede solo le app che gli sono state assegnate nella sua scheda, in Utenti. Se un'app "non appare", quasi sempre è questo.

Creare un'app

Creare un'app significa aprire una finestra, darle un nome e un'icona. Solo gli amministratori hanno il pulsante.

  1. Nell'intestazione della Dashboard, o nella zona delle app della barra laterale (il pulsante con il segno più, alla fine dell'elenco), clicca su Nuova app.
  2. Si apre la finestra Nuova app — "Scegli come nasce l'app: vuota, con datasource, da un modello o importata." — con quattro schede a scelta: Applicazione vuota, Applicazione con datasource, Da un modello e Importa pacchetto. Per un'app da zero, scegli Applicazione vuota. (La scheda Applicazione con datasource fa lo stesso e crea già il primo datasource SQLite dell'app; i modelli e l'importazione hanno pagine proprie in questo capitolo.)
  3. Compila il Nome. È il nome che appare nella barra laterale e nelle intestazioni — per esempio, Gestione Clienti.
  4. Se vuoi, scrivi una Descrizione — una frase che dica al resto del team a che cosa serve l'app.
  5. Scegli l'Icona (vedi la sezione successiva).
  6. Clicca su Crea app. L'app nasce vuota, appare nella Dashboard e il suo spazio di lavoro si apre immediatamente. Per averla anche nella barra laterale, fissala nella Dashboard con Fissa nel menu laterale.

La finestra Nuova app con la scheda Crea da zero compilata per l'app Gestione Clienti
La finestra Nuova app con la scheda Crea da zero compilata per l'app Gestione Clienti

Campo Obbligatorio Limiti A che cosa serve
Nome Sì Da 2 a 120 caratteri Il nome visibile dell'app, ovunque.
Descrizione No Fino a 500 caratteri Contesto per il team; appare nell'intestazione dell'app.
Icona No — Il volto dell'app nella barra laterale. Senza una scelta, resta il razzo.

Lo slug — l'identificatore che nasce con l'app

Accanto al campo Nome c'è la nota: "Lo slug è derivato automaticamente dal nome." Lo slug è la versione breve e tecnica del nome — minuscole, senza spazi né accenti: Gestão de Clientes dà gestao-clientes. È lui a identificare l'app negli indirizzi (la versione di lavoro risponde su /app/gestao-clientes), nell'esportazione e nella conferma di eliminazione.

Attenzione

Lo slug deve essere unico nell'installazione e non si cambia dopo che l'app esiste. Se c'è già un'app con lo stesso slug, la creazione si ferma con l'errore "Esiste già un progetto con lo slug…" — cambia il nome (o elimina la vecchia app) e riprova.

L'icona dell'app

Il campo Icona apre il selettore Scegli icona della piattaforma: una griglia con centinaia di icone e una casella "Cerca icone…" per filtrare per nome. Clicca su un'icona per sceglierla; Predefinito riporta al razzo di partenza.

L'icona scelta accompagna l'app ovunque: nella barra laterale, nell'intestazione dello spazio di lavoro, e viaggia con lei quando la esporti in un pacchetto. In un'installazione con molte app, un'icona distintiva vale oro — è da lì che si trova l'app con la barra ridotta.

Cambiare nome, descrizione o icona

L'identificazione dell'app si cambia nelle sue impostazioni, in qualsiasi momento:

  1. Apri l'app, dalla Dashboard o dalla barra laterale.
  2. In cima alla barra dell'app, clicca sul pulsante a ingranaggio Impostazioni dell'app e scegli Generale.
  3. Nel pannello Identificazione, cambia il Nome, la Descrizione o l'icona. L'icona sta proprio accanto al nome, perché è così che i due appaiono nella Dashboard e nella barra laterale.
  4. Clicca su Salva. La conferma "Impostazioni salvate." appare, e la Dashboard e la barra laterale si aggiornano subito.

Il pannello Identificazione nella sezione Generale delle impostazioni dell'app Gestione Clienti
Il pannello Identificazione nella sezione Generale delle impostazioni dell'app Gestione Clienti

Nota

Cambiare il nome non cambia lo slug né nessun indirizzo pubblicato — chi usa l'app non nota niente. Il nome è cosmetico; lo slug è strutturale.

L'icona sul telefono

KeplinGo mette una scorciatoia di ogni app nella schermata Home del telefono (vedi Collegare il telefono a un'app). L'icona di quella scorciatoia si sceglie nel pannello Icona sul telefono della sezione Generale.

Per scegliere l'icona sul telefono, segui questi passaggi:

  1. Nelle Impostazioni dell'app, apri Generale.
  2. Nel pannello Icona sul telefono, fai clic su Carica immagine e scegli l'immagine. Per usare un'immagine che è già negli asset dell'app, fai clic sul pulsante dell'immagine, a sinistra di Carica immagine.
  3. Facoltativo: in Colore di sfondo, scegli il colore che sta dietro le parti trasparenti dell'immagine. Vuoto è bianco.
  4. In Come appare su Android, verifica che la parte importante del disegno resti dentro il cerchio tratteggiato.
  5. Fai clic su Salva.

L'immagine deve essere PNG, JPG o WebP, quadrata, di almeno 432 × 432 px. Android taglia gli angoli con la forma scelta dal produttore del telefono (cerchio, superellisse o quadrato arrotondato), e solo il cerchio centrale, circa il 61% del lato, appare sempre. L'anteprima mostra l'immagine intera con quella zona sicura, e l'immagine ritagliata da ciascuna delle tre forme.

Senza immagine, KeplinGo disegna l'Icona dell'app sul colore principale del tema. I telefoni aggiornano la scorciatoia alla successiva apertura dell'app.

Nota

Carica immagine salva subito l'immagine negli asset dell'app, nella cartella mobile/. L'icona della scorciatoia cambia solo dopo Salva.

Eliminare un'app

Eliminare un'app è definitivo, e per questo la piattaforma chiede più di un clic.

  1. Apri Impostazioni dell'app → Generale e scendi fino al pannello Elimina — "L'app, i suoi dati e i suoi file. Non si torna indietro."
  2. Clicca su Elimina app.
  3. Si apre la finestra di conferma 'Eliminare "Gestione Clienti"?', che avvisa: 'Elimina l'app "Gestione Clienti" con tutte le API, i datasource, le chiavi API e i package. Non si torna indietro — le app consumatrici perdono l'accesso immediatamente.'
  4. Scrivi lo slug dell'app (gestao-clientes) nel campo di conferma — il pulsante si sblocca solo quando il testo coincide esattamente.
  5. Clicca su Elimina definitivamente. Torni alla Dashboard, ormai senza l'app.

La finestra di conferma per eliminare l'app, con lo slug scritto per sbloccare il pulsante
La finestra di conferma per eliminare l'app, con lo slug scritto per sbloccare il pulsante

Che cosa succede, con precisione:

Viene eliminato L'app intera in questa installazione: modello, schermate, API, script, report, workflow, tutte le versioni, gli account degli utenti dell'app, i file salvati sul disco dell'app e la sua cronologia.
Smette di funzionare subito Gli indirizzi pubblicati e le chiavi API dell'app — qualsiasi sistema che la consumasse perde l'accesso all'istante.
Resta intatto L'audit (chi ha fatto che cosa resta consultabile nell'Osservabilità) e tutto ciò che è infrastruttura esterna: database di altri sistemi a cui l'app si collegava, file in S3, SFTP o condivisioni di rete. Eliminare l'app non elimina mai dati fuori da lei.

Attenzione

Non c'è cestino né "annulla". Prima di eliminare un'app con del lavoro dentro, esportala come pacchetto — la pagina "Importare ed esportare app" spiega come, e un pacchetto conservato è l'unico modo di recuperarla dopo.

Perché non vedo…?

  • …il pulsante Nuova app? Creare e importare app è esclusivo degli amministratori. Con un profilo da developer, il pulsante non appare — chiedi a un amministratore di creare l'app e di assegnartela.
  • …un'app che esiste? Il tuo account non ha quell'app assegnata. Un amministratore risolve dalla scheda del tuo account, in Utenti.
  • …il pannello Elimina? Solo gli amministratori entrano nella sezione Generale delle impostazioni con i poteri per eliminare. Se la sezione si apre ma qualcosa fallisce al salvataggio, verifica il tuo profilo con un amministratore.