KEPLIN Docs

Templates de apps

O que é um template, como se cria uma app a partir de um, como se guarda uma app como template, como se apaga, e como um template desta plataforma chega a template de sistema.

Um template é uma app que serve de ponto de partida: o modelo de dados, os ecrãs, os scripts e os relatórios, isto é, tudo o que é desenho, prontos a receber um nome novo e a começar a trabalhar. É a diferença entre abrir uma app vazia e abrir uma app que já sabe o que é.

Na galeria vivem lado a lado duas famílias, identificadas por uma etiqueta:

Etiqueta De onde vem
Sistema Instalado por quem gere a instalação. É a oferta base, igual para todos.
Desta plataforma Guardado aqui, a partir de uma app desta plataforma. Só esta plataforma o vê.

Criar uma app a partir de um template

  1. Clica em Nova app, no cabeçalho do Dashboard ou na barra lateral, e escolhe o cartão A partir de template.
  2. A galeria mostra os templates disponíveis, com a imagem, o nome, a descrição e a versão. Escolhe um.
  3. Escreve o Nome da nova app. O slug deriva dele, como em qualquer criação.
  4. Se o template trouxer tabelas de dados, escolhe Onde vivem os dados:
    • SQLite gerido pelo Keplin, sem configuração: a app traz o ficheiro de dados dela, e podes ligá-la a um servidor externo mais tarde;
    • ou um servidor de base de dados (PostgreSQL, MySQL, MariaDB, SQL Server ou Oracle), com os dados da ligação. Escolhe uma base de dados vazia: as tabelas são criadas nesse motor e, se já existirem, a criação pára antes de tocar em nada.
  5. Se o template trouxer dados, escolhe a Língua dos dados da app (os estados, as fases e as prioridades que a app traz nascem nessa língua) e, opcionalmente, liga Incluir dados de exemplo.
  6. Clica em Criar a partir do template.

A galeria de templates no modal Nova app: os cartões com nome, versão e a etiqueta de origem.
A galeria de templates no modal Nova app: os cartões com nome, versão e a etiqueta de origem.

A app nova é tua desde o primeiro segundo: mudar o que ela traz não toca no template, e actualizar o template mais tarde não toca nas apps que nasceram dele.

Nota

Um template traz a APLICAÇÃO, nunca as pessoas: não há contas de utilizadores, caixa de correio nem ficheiros enviados. E os agendamentos chegam desligados: uma app acabada de nascer não começa a trabalhar sozinha.

Guardar uma app como template

Qualquer app desta plataforma pode servir de ponto de partida:

  1. Abre as Definições da app, a secção Geral, e, em Levar esta app, clica em Guardar como template.
  2. Dá-lhe um Nome, uma Descrição (o que este template dá a quem começa por ele) e uma Versão.
  3. Opcional: em Pré-visualização (opcional), carrega em Escolher imagem (PNG ou JPEG). A imagem aparece no cartão da galeria.
  4. Clica em Guardar. O template fica na galeria desta plataforma.

O diálogo Guardar como template, com nome, descrição e versão preenchidos.
O diálogo Guardar como template, com nome, descrição e versão preenchidos.

Guardar outra vez a mesma app substitui o template dela: o identificador é o slug da app, e é assim que se mantém a oferta actualizada sem acumular cópias.

Ver e apagar os templates desta plataforma

Os templates desta plataforma estão listados nas Definições da plataforma, no grupo Apps, na secção Templates: o nome, a versão, a descrição, a app de onde veio, a data em que foi guardado e o tamanho.

Para apagar um template:

  1. Na linha do template, carrega no ícone do caixote.
  2. A confirmação aparece na própria linha. Carrega em Apagar.

O template sai da galeria da Nova app. As apps já criadas a partir dele não mudam. Os templates de sistema não aparecem nesta lista e não se apagam aqui.

A secção Templates das Definições, com um template guardado a partir de uma app
A secção Templates das Definições, com um template guardado a partir de uma app

Levar um template a template de sistema

Um template guardado aqui pode passar a fazer parte da oferta base da instalação:

  1. Depois de guardar, clica em Descarregar .keplintemplate, no diálogo, ou em Descarregar, na secção Templates das Definições.
  2. Envia o ficheiro a quem gere a instalação. É essa pessoa que o carrega no backoffice e o torna visível a todas as plataformas.

O mesmo ficheiro também se instala noutra instalação qualquer: é um pacote completo, sem dependências de rede.

Porque não vejo…?

  • …o cartão A partir de template com templates? A galeria está vazia enquanto não houver templates de sistema instalados nem templates guardados nesta plataforma. Guarda uma app como template, ou fala com quem gere a instalação.
  • …os dados da app original no template? É assim por desenho: um template é o desenho, nunca os dados de quem usa a app de origem.
  • …o botão Guardar como template? É de administradores, como tudo o que cria e gere apps.
  • …uma forma de apagar o template na galeria da Nova app? A galeria só serve para escolher. Os templates apagam-se em Definições › Templates.