Panel Studio
O Panel Studio é o editor de aplicações Panel dentro do PlaidCloud. Mostra os ficheiros da aplicação ao lado de um editor, cria uma pré-visualização privada que pode abrir e publica a aplicação quando estiver pronta. Não precisa de um repositório Git para começar.
Abrir o Panel Studio
Seção intitulada “Abrir o Panel Studio”- No painel Início de um projeto, escolha Abrir no Studio numa aplicação Panel.
- Em Aplicações, escolha Studio na linha de uma aplicação.
Para iniciar uma nova aplicação, escolha Novo app > Studio. Também se encontra na linha Aplicações Studio do cartão Aplicações e identidade visual do separador Início de um projeto. Para criar a partir de uma tabela, selecione-a no separador Tabelas do projeto e escolha Criar aplicação Panel.
Criar uma aplicação
Seção intitulada “Criar uma aplicação”A caixa de diálogo Nova aplicação Studio permite começar a partir de uma de cinco origens:
| Começar a partir de | Resultado |
|---|---|
| Aplicação em branco | Uma aplicação mínima com um app.py e um requirements.txt. |
| A partir de uma tabela | Uma aplicação criada sobre a tabela escolhida. |
| A partir de uma vista | O mesmo, criado sobre uma vista do projeto. |
| A partir de outra aplicação Studio | Uma cópia de uma das suas aplicações Studio. |
| A partir da galeria | Uma cópia de uma aplicação que a sua área de trabalho listou na galeria de aplicações. |
Dê um nome à aplicação, escolha o respetivo Projeto e selecione Criar. O Studio abre a nova aplicação com os ficheiros listados à esquerda. No caso de uma tabela ou de uma vista, o pedido do Weave para criar a primeira página da aplicação fica pronto a enviar. Consulte Criar uma aplicação Panel.
Onde reside a aplicação
Seção intitulada “Onde reside a aplicação”Uma aplicação Studio é uma pasta com o nome da aplicação (<app-slug>/) dentro do repositório apps da sua área de trabalho no PlaidCloud Git, o mesmo repositório onde residem as suas outras aplicações Panel. O Studio não cria um repositório próprio para a aplicação, pelo que pode encontrar e editar o respetivo código-fonte em apps, junto das outras aplicações.
- Ramo de rascunho. O trabalho que ainda não está em produção é mantido num ramo com o nome
studio-<app-slug>. Publicar copia a pasta da aplicação desse ramo para o ramo principal. - Recompilações. Um push para
appssó recompila uma aplicação quando a pasta dessa aplicação ou orequirements.txtna raiz do repositório tiverem sido alterados. - Aplicações existentes. Uma aplicação Studio que estava num repositório próprio é movida automaticamente para a sua pasta. O repositório antigo é arquivado: permanece, só de leitura, e nunca é eliminado.
Escolha um ficheiro na lista para o editar no editor. Indique as dependências Python em requirements.txt, um pacote por linha. São instaladas quando a aplicação é compilada.
Escolha Perguntar ao Weave para que o Weave escreva ou altere a aplicação por si. Consulte Criar aplicações Panel com o Weave.
Guardar, pré-visualizar e publicar
Seção intitulada “Guardar, pré-visualizar e publicar”Guardar
Seção intitulada “Guardar”Guardar armazena as alterações como rascunho. A aplicação em produção não muda e mais ninguém vê o rascunho.
Pré-visualização
Seção intitulada “Pré-visualização”Pré-visualização compila o rascunho guardado como uma cópia privada e abre-a. Só os editores da aplicação podem abrir uma pré-visualização.
- Uma pré-visualização é removida após 24 horas sem que seja guardada qualquer alteração.
- Uma área de trabalho pode ter até 10 pré-visualizações em simultâneo.
- Guarde novamente e escolha Pré-visualização para ver as edições mais recentes.
Publicar
Seção intitulada “Publicar”Publicar substitui a aplicação em produção pelo rascunho guardado. Exige permissão de edição no projeto da aplicação e o Studio pede primeiro confirmação.
Se outra pessoa tiver publicado uma alteração depois de ter aberto a aplicação, o Studio indica um conflito em vez de substituir o trabalho dessa pessoa. Volte a carregar a aplicação, transfira as suas edições e publique novamente.
Estado da compilação e erros
Seção intitulada “Estado da compilação e erros”O separador Criar mostra o estado da compilação mais recente e é atualizado à medida que esta decorre. Quando uma compilação falha, o separador lista cada erro com o respetivo ficheiro e número de linha, para que possa ir diretamente à linha. Os problemas de dependências em requirements.txt incluem uma sugestão para a correção.
Os erros e os avisos também são assinalados nas respetivas linhas no editor, pelo que vê o problema onde ele ocorre.
Para saber o que significa cada estado depois de a aplicação ser publicada, consulte Utilizar uma aplicação Panel.
Histórico e restauro
Seção intitulada “Histórico e restauro”O separador Histórico lista todas as versões publicadas da aplicação, da mais recente para a mais antiga, com o respetivo estado de compilação. Escolha Carregar mais para ver as mais antigas.
Para voltar a uma versão anterior, escolha Restaurar nessa versão e confirme. A versão restaurada passa a ser a aplicação em produção e é recompilada. O rascunho não guardado não se perde: permanece no rascunho e entra em produção por cima da versão restaurada na próxima vez que publicar. Se a aplicação já corresponder a essa versão, o Studio indica-o e não altera nada. Se alguém tiver publicado durante o restauro, o Studio não restaura nada e pede que tente novamente.
Análises
Seção intitulada “Análises”O separador Análises mostra como as pessoas utilizam a aplicação e a rapidez com que esta responde. Escolha os últimos 7, 14 ou 30 dias.
| Secção | Mostra |
|---|---|
| Visualizações por dia | Quantas vezes a aplicação foi aberta em cada dia. |
| Carregamento de página | O tempo de carregamento mediano e o tempo que 95 por cento dos carregamentos não excedem, a partir dos carregamentos de página do período. |
| Consultas mais lentas | As consultas que demoraram mais tempo, com a frequência com que foram executadas e os respetivos tempos mediano, do extremo lento e mais lento. |
| Erros | O que correu mal no período, por tipo de erro e local da aplicação onde ocorreu. |
Quando um período contém mais atividade do que as Análises conseguem ler, é indicado que os valores são parciais. Quando os carregamentos de página ultrapassam o orçamento de desempenho da aplicação, as Análises avisam quantos o fizeram e quais as consultas que foram lentas. As Análises nunca mostram os dados devolvidos por uma consulta nem os nomes das pessoas que abriram a aplicação.
Os separadores Histórico e Análises exigem que a aplicação esteja atribuída a um projeto; uma aplicação sem atribuição mostra um pedido para a atribuir.
Alertas e resumos
Seção intitulada “Alertas e resumos”Escolha Alertas e resumos para configurar notificações que vigiam um número nos dados da aplicação e avisam quando ultrapassa um limite, ou que enviam um resumo de acordo com um agendamento. Consulte Alertas e resumos.
Listar uma aplicação na galeria
Seção intitulada “Listar uma aplicação na galeria”Escolha Galeria… no Studio. Escolha Listar na galeria para listar a aplicação como um modelo a partir do qual qualquer pessoa que possa ver o respetivo projeto pode criar a sua própria aplicação, ou Retirar da galeria para a remover. O botão está disponível para aplicações que pertencem a um projeto. É necessário acesso de edição ao projeto. Consulte A galeria de aplicações.
Afixar no Início
Seção intitulada “Afixar no Início”Escolha Afixar no Início para adicionar a aplicação ao painel Início do projeto e Desafixar do Início para a remover.
Eliminar uma aplicação
Seção intitulada “Eliminar uma aplicação”Eliminar uma aplicação Panel pede primeiro confirmação. Em Aplicações, utilize o ícone menos na linha da aplicação. Anular a publicação também pede confirmação.
Passos seguintes
Seção intitulada “Passos seguintes”- Criar aplicações Panel com o Weave — descreva a aplicação e aprove a alteração exata.
- O kit de aplicações Panel — os componentes que os pontos de partida do Studio para tabelas e vistas utilizam.
- Alertas e resumos — notifique as pessoas quando um número ultrapassa um limite ou de acordo com um agendamento.
- A galeria de aplicações — partilhe uma aplicação como ponto de partida para outras pessoas.
- Utilizar uma aplicação Panel — registos, utilização e recompilações depois de publicar.