Gerenciando formulários
Nessa seção, explicaremos como você pode criar e gerenciar o seu formulário por meio da edição e das suas configurações.
Criando formulários
Para criar um formulário, basta estar em uma área de trabalho, clicar em "Formulários" na barra lateral e então clicar em "Novo formulário" na direita. Quando você for criar um formulário, por padrão ele terá:
- Um nome (que será utilizado para identificar o formulário na interface, por exemplo: Sugestões)
- Um slug (que identificará unicamente o formulário, por
exemplo:
sugestoes) - Um editor de campos (que será utilizado para criar e editar os campos do seu formulário)
Você pode aprender mais sobre os campos na seção anterior.
Quando você estiver satisfeito com os campos e tiver preenchido seu nome e slug, basta clicar em "Salvar" no canto superior-direito e seu formulário estará pronto.
Editando formulários
Para editar a estrutura de um formulário, basta estar em uma área de trabalho, clicar em "Formulários" na barra lateral e então clicar no ícone de "Editar formulário" do formulário que deseja editar. Você então entrará numa página igual a de criação de formulário, mas com todos os campos disponíveis da forma que você criou. Para salvar as mudanças feitas, basta clicar em "Salvar" no canto superior-direito.
Chaves dos campos
Antes de tudo, é importante explicar como o Starlight lida com mudanças de chaves dos seus campos. Atualmente, quando um desenvolvedor atualiza a chave de um campo, o conteúdo daquele campo nas entradas desaparecerá na interface, mas o conteúdo não será deletado ou perdido - se o desenvolvedor alterar a chave de volta para o nome antigo, os dados antigos reaparecerão. A mesma coisa acontecerá quando um campo é deletado - os dados presentes nesses campos não serão perdidos.
Por causa disso, não é recomendado mudar as chaves dos campos ou deletá-los, apesar de ser possível. Uma melhor alternativa para isso seria arquivar o campo com o nome antigo (ao invés de renomeá-lo) e criar um campo com o novo nome. Dessa forma, tanto os dados antigos quanto os novos seriam retornados pela API, e o campo antigo não aparecerá no editor de entradas por padrão (mas ainda pode ser visto com a opção "Mostrar campos arquivados").
Exportando formulários
Para exportar os envios de um formulário, basta estar em uma área de trabalho, clicar em "Formulários" na barra lateral e então clicar no formulário com os envios que você deseja exportar. Você então entrará na página daquele formulário, com todos seus envios. Para exportá-los, basta clicar no botão de "Exportar" no canto superior-direito. Por padrão, os envios do formulário serão exportados no formato .xlsx, mas ao lado do botão de exportar há um botão com reticências que, quando selecionado, possibilitará a exportação dos envios em 3 outros formatos (além do padrão): .xls, .csv e ods.
Apagando formulários
Para apagar um formulário, basta estar em uma área de trabalho, clicar em "Formulários" na barra lateral e então clicar no ícone de "Apagar formulário" no formulário selecionado. Você então terá que confirmar a ação para apagar o formulário.