1. Antes de começar
O banco de dados do AppSheet (ASDB, na sigla em inglês) é o banco de dados nativo proprietário do AppSheet para organizar e gerenciar os dados que os apps do AppSheet processam. Com a interface e o alto desempenho, ele oferece uma experiência melhor para criadores de apps e usuários finais, se comparado a outras origens de dados externas frequentemente usadas, como os apps Planilhas Google, BigQuery e Cloud SQL O banco de dados do AppSheet é uma opção padrão de dados para todos os aplicativos do AppSheet.
O que você vai aprender
- Como criar um novo banco de dados do AppSheet com dados de exemplo ou dados importados de um planilha Google.
- Como personalizar os dados no editor de banco de dados do AppSheet.
- Como gerar um aplicativo do AppSheet usando um banco de dados.
- Como alterar o banco de dados e gerar novamente as tabelas no AppSheet levando em conta as mudanças de estrutura das tabelas.
O que você vai criar
Este codelab mostra como gerar e personalizar um novo banco de dados do AppSheet de duas maneiras: desde o começo, com dados padrão fornecidos por um banco de dados do AppSheet e a partir de dados de uma planilha Google. Depois, vamos aprender como gerar um novo aplicativo do AppSheet usando uma tabela do AppSheet. Por último, como alterar uma tabela de banco de dados no editor de banco de dados e gerar a tabela novamente no editor de app do AppSheet.
O que é necessário
- Acesso ao ambiente de desenvolvimento do AppSheet (appsheet.com).
2. Criar e personalizar um novo banco de dados do AppSheet
Para começar, você criou e personalizou um novo banco de dados do AppSheet do zero usando o banco de dados inicial padrão. Com isso, você teve a chance de testar o editor do banco de dados sem pular para as etapas posteriores deste banco de dados.
- Acesse a página inicial do AppSheet (appsheet.com) e clique em Create > Database > New database.
- Um novo banco de dados de exemplo é criado e o editor de banco de dados do AppSheet é mostrado.
- Personalize o banco de dados alterando o nome dele de Untitled database para Tasks DB. (Clique duas vezes no título padrão, Untitled database, para editar o nome.)
- Altere o nome da tabela de Table 1 para Tasks. (Clique duas vezes na guia para editar).
- Altere a primeira coluna de Title para Task.
- Adicione um novo registro clicando em + no canto superior esquerdo.
- Clique duas vezes na coluna Status para saber como o tipo enumerado e o tipo item do menu suspenso são usados.
- Opcional: clique nos botões depois dos sinais = para colorir cada opção do menu suspenso.
- Opcional: experimente mais opções com o editor adicionando novas opções para o tipo enumerado Status (clique em Add option), além de mudar as cores.
- Opcional: experimente outros tipos de coluna, como Cor, Progresso, Sim/Não e Telefone, e confira os resultados.
Fique à vontade para testar mais com o editor do banco de dados. Nas próximas etapas, você vai criar um novo banco de dados.
3. Criar e personalizar novos bancos de dados importando de uma planilha Google
As etapas a seguir mostram como importar dados de uma planilha Google.
Usar uma planilha para criar o banco de dados
- Primeiro, copie esta planilha do Google pública e mude o nome dela para
ASDB: IO Codelab
.
Perceba que ela tem duas guias: Tasks e Owners.
- Como antes, acesse a tela inicial do AppSheet (appsheet.com) e clique em Create > Database > Import from Sheets.
- No seletor de arquivos do Google Drive, escolha sua cópia da planilha
ASDB: IO Codelab
(caso você não tenha mudado o nome dela).
Isso leva a um novo banco de dados do AppSheet gerado com os dados da planilha.
Adicionar uma referência à tabela "Tasks"
A seguir, você vai adicionar uma referência à tabela "Owners" pela tarefa "Tasks".
- Na tabela "Tasks" no banco de dados do AppSheet, clique duas vezes na coluna Owner para editar as respectivas configurações.
- Mude o tipo de Text para References > Reference.
- Defina Table to reference como Owners e, depois, clique em Save.
- Um alerta é exibido sobre a mudança do tipo da coluna. Nesse caso, os dados na coluna são compatíveis com o novo tipo de coluna, então clique em Yes para continuar.
- O banco de dados do AppSheet vai tentar corresponder às linhas na tabela "Owners" com os nomes na tabela "Tasks". Como esse conjunto de dados é correspondente, o banco de dados do AppSheet vai preencher a coluna "Owners" com as referências certas nas linhas "Owners".
- Para testar a referência, clique em uma célula de "Owner" e atualize para outro proprietário, como Sarah.
Depois de selecionado, o novo valor (Sarah) aparece na célula "Owner" (na tabela "Tasks").
Mudar a coluna "Label" da tabela referenciada
O banco de dados do AppSheet permite selecionar uma Coluna "Label" para qualquer tabela. Isso permite especificar qual coluna você quer que apareça em uma tabela pai. Também determina o que é exibido na tabela pai em um app de front-end vinculado do AppSheet. Então, em vez de exibir a coluna Name da tabela "Owners" na tabela "Tasks" (mostrado anteriormente), é possível mostrar a coluna Email da tabela "Owners".
- Para fazer isso, altere Label column na tabela Owners para Email passando o mouse no lado direito do cabeçalho da coluna Email e clique nos três pontos verticais.
Isso invoca o menu contextual da coluna.
- Selecione Use column as label no menu contextual para definir o identificador da coluna como a coluna Email.
- Para conferir se a coluna "Email" está selecionada como o identificador de coluna referenciada na tabela "Tasks", clique na tabela Tasks e perceba que a coluna "Owner" agora exibe o endereço de e-mail. Talvez você tenha que atualizar o navegador para que a coluna "Owner" seja atualizada.
4. Gerar um app do AppSheet de um banco de dados do AppSheet
Quando você tiver terminado de personalizar seu banco de dados, é possível gerar um app do AppSheet diretamente do banco de dados. Isso é útil se você quiser uma interface de usuário personalizada de front-end, precisar adicionar automações ou filtros de segurança, etc. Para fazer isso, siga estas etapas:
- Clique em Apps no lado direito do editor do ASDB.
Isso invoca o menu contextual à direita para gerar um novo app.
- Clique em New AppSheet app para gerar um novo app.
Quando o app for gerado, perceba que ele mostra um aviso:
Column "Owner" in Tasks_Schema has a reference to an unknown table or slice "Owners". Open the column definition to select a source table.
Isso acontece porque o app gerado tem apenas a coluna "Tasks", e a coluna "Owner" tem uma referência a uma tabela "Owners" desconhecida.
Para consertar isso, adicione a tabela "Owners" ao app do AppSheet.
- Na página Data no editor do AppSheet, clique em +.
- No menu contextual Add data, selecione AppSheet Database como a origem de dados.
- Depois, selecione o banco de dados ASDB: IO Codelab (se você não mudou o nome nas etapas anteriores).
- Na próxima caixa de diálogo, selecione a caixa de seleção padrão SELECT ALL e depois clique em Add to app.
Quando a tabela "Owners" for adicionada ao app, o erro Reference não aparecerá mais.
- Agora que a nova tabela Owners do AppSheet foi adicionada, é possível criar uma nova visualização para exibir os dados, ao clicar na página Views no AppSheet e depois em + ao lado de PRIMARY NAVIGATION.
- Na caixa de diálogo Add a new view clique em Create a new view
- Quando a nova visualização é criada, defina estas opções:
Nome da visualização: Owners Para estes dados: Owners Tipo da visualização: deck
Parabéns, seu app está pronto.
- Para testar a referência entre "Tasks" e "Owners", clique na visualização Owners ou Tasks na pré-visualização de dispositivos móveis e selecione um registro para ver os relacionados (referenciados).
Por exemplo, é possível clicar na visualização Owners e, a seguir, clicar em um registro para detalhar e ver os registros relacionados de Task.
5. Alterar o banco de dados e gerar novamente a tabela "Tasks"
Agora que você criou um banco de dados do AppSheet e gerou um novo app usando isso, tente alternar uma tabela no banco de dados. Mude um tipo de dados da coluna e observe o que acontece ao app vinculado do AppSheet.
- Na tabela Tasks no banco de dados, altere o tipo da coluna Due Date para Date and time > Date.
Quando você voltar para o app do AppSheet, perceba que ele detecta que o banco de dados foi atualizado com um aviso:
App Schema for table 'Tasks' is out of sync with the schema in AppSheet database. Please regenerate the table structure
- Para gerar novamente, clique no ícone para isso no na parte de cima à direita.
- Isso aciona uma caixa de diálogo de aviso:
- Clique em Regenerate para continuar. Isso atualiza o tipo da coluna Due Date no app para ser do tipo Date e ativa o elemento de entrada de seletor de data no formulário Edit para registros de tarefas.
6. Parabéns
Você concluiu o codelab do banco de dados do AppSheet (ASDB).
Leia mais
- Site da documentação oficial do banco de dados do AppSheet