Pular para o conteúdo

Definições rápidas

Uma definição rápida (quick config) é um instantâneo nomeado da configuração de um pedido. Ajusta o pedido como quiser, guarda-o com um nome, e recarrega esse estado em dois cliques mais tarde.

É a ferramenta certa para as variantes de uma mesma chamada: Criar um cliente mínimo, Criar um cliente completo, Payload que provoca um 422.

Todos os campos de configuração do protocolo: método, URL, cabeçalhos, parâmetros, corpo, opções de modo servidor, tempo limite, etc.

O que fica excluído: a identidade do pedido (identificador, nome, notas, etiquetas, ícone, origem de importação, estado de obsolescência) e a rota de autenticação. Uma variante nunca altera, portanto, a sua autenticação, e recarregar uma variante não renomeia o seu pedido.

O botão Definições rápidas está na smartbar do separador. O seu menu emergente contém:

  • um campo Nome da configuração — pré-preenchido se o estado atual já corresponder a um registo guardado;
  • um interruptor Guardar no ficheiro de projeto (.restorm);
  • o botão Guardar;
  • a lista Definições guardadas.

O menu emergente “Definições rápidas” aberto a partir da smartbar, com três configurações guardadas e os seus distintivos de origem — três “projeto”

DestinoDistintivoOnde é escritoConsequência
ProjetoprojetNo ficheiro .restormA variante viaja com o projeto: é partilhada e versionada
UtilizadorutilisateurNas suas definições locaisA variante permanece na sua máquina; sobrevive ao fecho do projeto, mas não é partilhada

As duas listas são apresentadas em conjunto, cada linha com o seu distintivo de origem.

Clique numa configuração guardada. O Restorm pede confirmação — “Deseja recarregar a configuração ‘X’? Perderá a configuração atual se não a tiver guardado.” — e depois aplica o instantâneo e relança a resolução das {{variables}}.

O ícone de eliminação de cada linha. Se existirem cenários que referenciem a configuração, são nomeados na confirmação antes de a validar.

Uma ação de cenário ligada a um pedido pode designar uma definição rápida. A ordem de aplicação é então:

  1. o pedido de base;
  2. a definição rápida (destino projeto, designada pelo seu identificador);
  3. as sobreposições colocadas na ação;
  4. os valores que chegam por uma ligação na porta de sobreposição.

É a forma limpa de repetir o mesmo cenário com três conjuntos de dados: uma ação, três definições rápidas.

Cinco ferramentas, todas disponíveis na edição Community: list_quick_configs, add_quick_config, update_quick_config, delete_quick_config e describe_quick_config_schema — esta última devolve a lista exata dos campos aceites para cada protocolo. Um campo estranho ao protocolo é rejeitado com a lista dos campos válidos.