Pedidos, pastas e pastas de variáveis
A árvore de um projeto Restorm tem quatro famílias de elementos.
A pasta simples
Section titled “A pasta simples”Um contentor de arrumação, sem efeito sobre a execução. Utilize-a para agrupar por
domínio funcional (Faturação, Utilizadores…).
A pasta de variáveis
Section titled “A pasta de variáveis”É a peça central. Uma pasta de variáveis (ou pasta de ambiente) contém:
- os seus ambientes (
local,staging,production…), cada um com as suas variáveis e, eventualmente, com subambientes; - as suas listas de valores personalizadas;
- as enumerações provenientes de uma importação;
- a documentação de API gerada na importação (modelos, descrições, esquemas de segurança);
- as rotas de autenticação oferecidas aos seus pedidos.
Qualquer pedido colocado sob esta pasta herda o ambiente selecionado. É isso que
lhe permite escrever {{baseUrl}}/users uma única vez e alternar de um ambiente
para outro a partir da smartbar.
Uma importação cria sempre uma pasta de variáveis: é a unidade de “re-sincronização” quando recarrega a especificação de origem.
O pedido
Section titled “O pedido”Um pedido tem um tipo (o protocolo), um nome, um ícone, notas, etiquetas e a configuração própria do seu protocolo. Pode também ter:
- uma rota de autenticação (Autenticação);
- definições rápidas guardadas.
Crie um com o botão direito ▸ Adicionar ▸ e depois o protocolo pretendido. A lista completa está no catálogo dos protocolos.
O mesmo menu Adicionar oferece os oito servidores, que são elementos de pleno direito: ver Modo servidor.
O cenário
Section titled “O cenário”Um grafo de ações que orquestra pedidos e lógica. Ver Cenários.
Gestos úteis
Section titled “Gestos úteis”| Gesto | Efeito |
|---|---|
F2 | Renomear o elemento selecionado |
Ctrl+D | Clonar o elemento (com a sua subárvore) |
Delete | Eliminar |
| Arrastar e largar | Mover dentro da árvore, reordenar os favoritos |
| Clique central num caminho de navegação | Abrir o antecessor num separador em segundo plano |
Pedidos obsoletos
Section titled “Pedidos obsoletos”Um pedido pode ser marcado como obsoleto — é precisamente o que faz a re-sincronização de uma importação quando uma operação desaparece da especificação de origem. Continua na árvore, com um aviso no topo do seu separador, em vez de ser eliminado sem que se dê conta.