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, 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, os relatórios — tudo o que é desenho — pronto 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 na barra lateral e escolhe o cartão A partir de template.
  2. A galeria mostra os templates disponíveis, com nome, descrição e versão. Escolhe um.
  3. Escreve o Nome da nova app — o slug deriva dele, como em qualquer criação.
  4. 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 acorda a trabalhar sozinha.

Guardar uma app como template

Qualquer app desta plataforma pode virar ponto de partida:

  1. Abre as Definições da app e clica em Guardar como template (ao lado de Exportar).
  2. Dá-lhe um Nome, uma Descrição — o que este template dá a quem começa por ele — e uma Versão.
  3. 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 fresca sem acumular cópias.

Levar um template a template de sistema

Um template guardado aqui pode ser promovido à oferta base da instalação:

  1. Depois de guardar, clica em Descarregar .keplintemplate.
  2. Faz chegar o ficheiro a quem gere a instalação — é essa gestão 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? Não é um esquecimento: 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.