Variabili e ambienti

Le variabili di Restorm risiedono in una cartella di variabili, che può contenerne più insiemi: uno per ambiente.

Ambienti e sotto-ambienti

Un ambiente è un elenco di coppie chiave / valore. Può contenere dei sotto-ambienti, che ereditano dal genitore e sovrascrivono ciò che ridefiniscono.

È lo strumento giusto per modellare staging → staging / customer A, staging / customer B: la base comune è scritta una volta sola, si ripete soltanto la differenza.

Scegliere l’ambiente attivo

Il selettore di ambiente si trova a sinistra della smartbar di ogni scheda di richiesta. Mostra una pastiglia colorata e il nome dell’ambiente.

Il popover propone una casella «Applica a tutte le richieste»: se selezionata, commuta l’intera cartella in un colpo solo — è quello che serve per portare un intero progetto da local a staging.

Tipi di valore

Una variabile non è soltanto una stringa. Restorm propone tipicamente:

Tipo	Che cos’è
Stringa	Un valore letterale, inviato così com’è
Espressione	Un template Handlebars — è il solo tipo le cui {{ }} vengono valutate
Numerico	Un numero, con un formato di visualizzazione
Booleano	Vero / falso
Data-ora	Una data ISO, con un formato
Colore	Un colore esadecimale
Segreto	Un riferimento a una sorgente di segreti — il valore non transita mai nel file di progetto
Elenco	Un elenco di valori
Enumerazione / Enumerazione multipla	Un valore vincolato da un’enumerazione importata
Elenco personalizzato / Elenco personalizzato multiplo	Una scelta per etichetta in un elenco di valori personalizzato
Variabile	Un riferimento a un’altra variabile
Ambiente	Un riferimento a un ambiente
Nullo	Il valore nullo esplicito

Stringa o espressione?

È la trappola numero uno. Una variabile di tipo Stringa che contiene Bearer {{token}} verrà inviata letteralmente, parentesi graffe comprese. Perché la sostituzione avvenga, il valore deve essere di tipo Espressione.

Ordine di risoluzione

Dal più generale al più specifico — vince l’ultimo:

1. l’ambiente radice, poi ciascun sotto-ambiente della catena;
2. le variabili dell’ambiente stesso, nel loro ordine di dichiarazione: una variabile può quindi basarsi su quelle definite sopra di essa;
3. le variabili di run impostate da uno scenario (azione Definisci variabile), che coprono l’ambiente per la durata dell’esecuzione;
4. i valori propri della richiesta (header, parametri di query, parametri di percorso), con ciascun gruppo che si risolve sul contesto accumulato;
5. infine le {{ }} scritte direttamente nei campi della richiesta — si veda Variabili inline.

Restorm effettua inoltre più passaggi: un’espressione di un ambiente padre può quindi recuperare un valore ridefinito da un figlio.

Variabili disattivate

Ogni variabile ha una casella di attivazione. Una variabile disattivata non entra nel contesto — è il modo pulito per neutralizzare temporaneamente una sovrascrittura senza eliminarla.

All’importazione, le coppie chiave / valore il cui valore si risolve a vuoto vengono disattivate automaticamente: la prima esecuzione non invia quindi uno sciame di header vuoti.

E gli helper?

Ogni espressione è un template Handlebars, con oltre cento helper disponibili: stringhe, matematica, date, elenchi, codifica, hash, dati casuali.

Una variabile prevale su un helper

Se esiste una variabile chiamata min ed esiste anche un helper min, {{min}} (senza argomenti) legge la variabile, mentre {{min a b}} (con argomenti) chiama l’helper.