Panel Studio

O Panel Studio é o editor de aplicações Panel dentro do PlaidCloud. Mostra os ficheiros da aplicação junto a um editor, cria uma pré-visualização privada que pode abrir e publica a aplicação quando estiver pronto. Não precisa de um repositório git para começar.

Abrir o Panel Studio

No quadro Início de um projeto, escolha Open in Studio numa aplicação Panel.
Em As minhas aplicações Panel, escolha Open in Studio na linha de uma aplicação.

Para iniciar uma nova aplicação, escolha Create app em qualquer um dos locais.

Criar uma aplicação

A caixa de diálogo Create app permite-lhe começar a partir de um de cinco locais:

Começar a partir de	O que obtém
Blank	Uma aplicação mínima com um `app.py` e um `requirements.txt`.
Tabela	Uma aplicação criada sobre a tabela que escolher.
Vista	O mesmo, criado sobre uma vista do projeto.
Modelo	Uma aplicação pronta a usar do Panel App Kit.
From the gallery	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 seu Projeto e escolha Criar. O Studio abre a nova aplicação com os respetivos ficheiros listados à esquerda.

Editar

Escolha um ficheiro na lista para o editar no editor. Liste as suas dependências Python em requirements.txt, um pacote por linha. São instaladas quando a aplicação é compilada.

Escolha Ask 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

As suas edições só chegam aos visualizadores quando publica.

Guardar

Guardar armazena as suas alterações como rascunho. A aplicação em direto não muda e mais ninguém vê o rascunho.

Pré-visualização

Pré-visualização cria o seu rascunho guardado como 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 guardar.
Uma área de trabalho pode ter até 10 pré-visualizações em simultâneo.
Guarde novamente e escolha Pré-visualização para ver as suas edições mais recentes.

Publicar

Publicar substitui a aplicação em direto pelo seu rascunho guardado. Requer permissão de edição no projeto da aplicação, e o Studio pede-lhe primeiro que confirme.

Se outra pessoa publicou uma alteração depois de ter aberto a aplicação, o Studio comunica um conflito em vez de substituir o trabalho dessa pessoa. Recarregue a aplicação, transfira as suas edições e publique novamente.

Estado da compilação e erros

O separador Criar mostra o estado da compilação mais recente e atualiza-se à 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 vêm com uma sugestão de correção.

Os erros e os avisos também são assinalados nas respetivas linhas no editor, para ver o problema onde ele está.

Para saber o que significa cada estado depois de a aplicação ser publicada, consulte Utilizar uma aplicação Panel.

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 nela e confirme. A versão restaurada passa a ser a aplicação em direto e é recompilada. O seu rascunho por guardar não se perde: permanece no rascunho e entra em produção sobre a versão restaurada da próxima vez que publicar. Se a aplicação já corresponder a essa versão, o Studio di-lo e não altera nada. Se alguém publicou enquanto restaurava, o Studio não restaura nada e pede-lhe que tente novamente.

Análise

O separador Análise mostra como as pessoas usam a aplicação e a rapidez com que esta responde. Escolha os últimos 7, 14 ou 30 dias.

Secção	Mostra
Views per day	Quantas vezes a aplicação foi aberta em cada dia.
Page load	O tempo de carregamento mediano e o tempo que 95 por cento dos carregamentos superam, a partir dos carregamentos de página do período.
Slowest queries	As consultas que demoraram mais, 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 a Análise consegue ler, indica que os valores são parciais. Quando os carregamentos de página ultrapassam o limite de desempenho da aplicação, a Análise avisa-o de quantos foram e de que consultas foram lentas. A Análise nunca mostra os dados que uma consulta devolveu nem os nomes das pessoas que abriram a aplicação.

Ambos os separadores exigem que a aplicação esteja atribuída a um projeto; uma aplicação não atribuída mostra uma indicação para a atribuir.

Alertas e resumos

Escolha Alerts & Digests 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

Escolha Gallery… para listar a aplicação como um modelo a partir do qual qualquer pessoa que possa ver o seu projeto pode criar a sua própria aplicação, ou para a retirar da galeria. Consulte A galeria de aplicações.

Afixar no Início

Escolha Pin to Home para adicionar a aplicação ao quadro Início do projeto, e Unpin from Home para a remover.

Eliminar uma aplicação

Eliminar uma aplicação Panel pede-lhe primeiro que confirme. Em As minhas aplicações Panel, use o ícone de menos na linha da aplicação. Anular a publicação também pede confirmação.

Passos seguintes

Criar aplicações Panel com o Weave — descreva a aplicação e aprove a alteração exata.
O Panel App Kit — os componentes que os pontos de partida de tabela, vista e modelo do Studio 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.