Crea un indicatore di funzione

Per creare un feature flag, segui questi passaggi:

1. Nella console App Configuration, fai clic su Features flags.

2. Selezionare Ambiente corrente per visualizzare l'elenco di indicatori di funzione in tale ambiente.

3. Fai clic su Crea. Il pannello laterale viene aperto con i campi per creare un nuovo indicatore di funzione.

   

   di caratteristica*

4. Fornire i dettagli dell'indicatore di funzione:

   • Nome- nome dell'indicatore della funzione.
   • ID indicatore funzione- il valore dell'ID indicatore funzione viene suggerito automaticamente in base al nome della funzione immesso. È possibile modificare lo stesso, se necessario. Utilizza il valore ID indicatore funzione come identificativo nel tuo codice SDK o API.
   • Tipo di indicatore- specificare il tipo di indicatore della funzione. Il tipo supportato include: Boolean, String e Numeric. Per ulteriori informazioni sul tipo di indicatore e sui valori predefiniti, consultare Selezione del tipo di indicatore della funzione.
   • Valore predefinito- specificare il valore predefinito per il tipo di indicatore della funzione selezionato. Per ulteriori informazioni sul tipo di indicatore e sui valori predefiniti, consultare Selezione del tipo di indicatore della funzione.
   • Facoltativamente, selezionare ora una raccolta per l'applicazione di un indicatore di funzione. Altrimenti, è necessario aggiungere una raccolta prima di attivare / disattivare un indicatore di funzione. È possibile aggiungere l'indicatore di funzione a una o più raccolte selezionando l'elenco Disponibilità indicatore tra le raccolte.
   • Rollout funzione- specificare il Rollout percentage utilizzando il dispositivo di scorrimento. Per ulteriori informazioni sul rollout manuale, vedere Configurazione della percentuale di rollout delle funzioni.
   • Descrizione- aggiungere una descrizione dell'indicatore della funzione, che è facoltativa.
   • Facoltativamente, definire Tag che consentono di identificare l'indicatore della funzione.

5. Fai clic su Crea.

Per impostazione predefinita, quando si crea un nuovo indicatore di funzione, l'interruttore di attivazione / disattivazione Abilitata è impostato su OFF.

Selezione del tipo di indicatore della funzione

È possibile avere uno dei seguenti tipi di indicatore associato a un indicatore di elemento:

• Booleano
• Stringa
• Numerico

Ciascun tipo di flag ha un valore predefinito.

• Quando si imposta l'interruttore di attivazione / disattivazione su ON, è richiesto il valore per Valore abilitato, che può essere sovrascritto quando si ha come destinazione un segmento.
• Quando si imposta l'interruttore su OFF, è richiesto il valore per Valore disabilitato, che può essere sovrascritto quando si ha come destinazione un segmento.

Booleano

Quando si seleziona Tipo di indicatore come Booleano, vengono visualizzati i dettagli Valore predefinito:

1. Selezionare il valore "Abilitato " dall'elenco. Questo valore viene restituito per impostazione predefinita quando l'interruttore di attivazione / disattivazione è impostato su ON per l'indicatore della funzione. Questo valore può essere sovrascritto quando si seleziona un segmento come target.

2. Selezionare il valore "Disabilitato " dall'elenco. Questo valore viene restituito per impostazione predefinita quando l'interruttore di attivazione / disattivazione è impostato su OFF per l'indicatore della funzione.

Stringa

Quando si seleziona Tipo di indicatore come Stringa, vengono visualizzati i dettagli Valore predefinito:

1. Selezionare il Formato del tipo di indicatore stringa dall'elenco. Il formato supportato è Text, JSON e YAML. Quando è selezionato il formato JSON o YAML, fornisci il Valore abilitato e il Valore disabilitato nel formato selezionato.

2. Specificare il valore "Abilitato ". Questo valore viene restituito per impostazione predefinita quando l'interruttore di attivazione / disattivazione è impostato su ON per l'indicatore della funzione. Questo valore può essere sovrascritto quando si seleziona un segmento come target.

3. Specificare il valore "Disabilitato ". Questo valore viene restituito per impostazione predefinita quando l'interruttore di attivazione / disattivazione è impostato su OFF per l'indicatore della funzione.

Numerico

Quando si seleziona Tipo di indicatore come Numerico, vengono visualizzati i dettagli Valore predefinito:

1. Selezionare il valore "Abilitato " dall'elenco. Sono supportati solo valori interi. Questo valore viene restituito per impostazione predefinita quando l'interruttore di attivazione / disattivazione è impostato su ON per l'indicatore della funzione. Questo valore può essere sovrascritto quando si seleziona un segmento come target.

2. Selezionare il valore "Disabilitato " dall'elenco. Sono supportati solo valori interi. Questo valore viene restituito per impostazione predefinita quando l'interruttore di attivazione / disattivazione è impostato su OFF per l'indicatore della funzione.

Raccolte di destinazione per indicatori di funzione

Facoltativamente, selezionare ora una raccolta per l'applicazione di un indicatore di funzione. Altrimenti, è necessario aggiungere una raccolta prima di attivare / disattivare un indicatore di funzione. È possibile aggiungere gli indicatori di funzione a una o più raccolte durante la creazione dell'indicatore di funzione o durante la modifica dei dettagli dell'indicatore di funzione.

Per aggiungere raccolte all'indicatore funzione, per il campo Disponibilità indicatore tra raccolte, selezionare la raccolta dall'elenco.

Se si tenta di specificare un indicatore di funzione non collegato ad una raccolta, viene visualizzata una finestra per aggiungere un indicatore di funzione ad una raccolta.

Configura percentuale di rollout funzione

È possibile configurare l'indicatore della funzione con una percentuale di rollout compresa tra 0 e 100, che indica l'applicabilità della funzione a una serie parziale di utenti o dispositivi.

Il rollout manuale aiuta ad abilitare una funzionalità a una piccola percentuale di utenti casuali o a un sottoinsieme di entità, fornendo un maggiore controllo sul ciclo di rilascio e ottenendo una consegna progressiva. Quando si è certi che la funzione che si desidera implementare funziona come previsto, aumentare la percentuale nel tempo.

Il rollout manuale utilizza un algoritmo di hashing che genera un hash basato sul set di regole. Questo hash viene usato dall'SDK per generare un valore percentuale per tale utente. Il valore percentuale generato per quell'utente viene confrontato con il valore impostato per il valore di rollout manuale e determina se l'utente è idoneo o meno a ricevere quella funzione.

Ad esempio, l'hash ha partizioni da 1 a 100.000. Quando si assegna un indicatore di funzione, l'hash assegna valori da 1 a 100.000 agli utenti in ogni partizione. Ad esempio, quando assegni il 25% a un flag della funzione, l'SDK App Configuration fornisce tale funzione alle partizioni hash da 1 a 25.000. Se si modifica la percentuale di utenti che ricevono tale funzione dal 25% al 50%, le partizioni da 25.001 a 50.000 verranno aggiunte alla serie di partizioni che già ricevono tale funzione.

La funzionalità di rollout manuale è disponibile per i piani Lite ed Enterprise.

Di seguito sono riportati alcuni scenari di rollout manuale:

• Se l'indicatore della funzione è disabilitato, SDK restituisce il valore predefinito Disabilitato.
• Se il flag della funzione è abilitato senza regole di segmento e non è impostato alcun rollout manuale, l'SDK restituisce il valore predefinito Valore abilitato.
• Se il flag della funzione è abilitato senza alcuna regola di segmento e il rollout manuale è impostato su 0%, l'SDK restituisce il valore Disabilitato per tutti gli utenti.
• Se il flag della funzione è abilitato senza alcuna regola di segmento e il rollout manuale è impostato su una percentuale, ad esempio il 50%, l'SDK controlla se l'utente appartiene alla dimensione del rollout manuale configurato; se l'utente appartiene ai criteri di rollout, l'SDK restituisce il valore Abilitato. Se l'utente non appartiene ai criteri di rollout, l'SDK restituisce il Valore disabilitato.
• Se l'indicatore della funzione è abilitato con le regole di segmento, SDK valuta prima l'utente rispetto alle regole configurate. Se l'utente fa parte della regola configurata, l'SDK valuta se l'utente è idoneo per il rollout manuale.
  • Se sono configurate più regole e l'utente viene controllato per la corrispondenza della regola fino alla prima corrispondenza. Se non viene trovata alcuna corrispondenza, l'SDK viene valutato rispetto al rollout predefinito.
  • Se l'utente viene valutato come parte del segmento e il rollout manuale del segmento è pari a 0%, anche se l'utente fa parte del segmento, non riceverà il valore del segmento. L'SDK restituisce il valore disabilitato predefinito.
  • Se l'utente viene valutato come parte del segmento e il rollout manuale del segmento è impostato su una percentuale, ad esempio il 50%, l'SDK controlla se l'utente appartiene alla dimensione del rollout configurata; se l'utente appartiene ai criteri del rollout, l'SDK restituisce il valore di override del segmento. Se l'utente non appartiene ai criteri di rollout, l'SDK restituisce Valore disabilitato.

Destinazione di un segmento con un flag di funzione

È possibile distribuire i feature flag a uno o più segmenti di destinazione. È possibile impostare valori di indicatore differenti per segmenti differenti, se necessario.

1. Dalla console App Configuration, vai a Feature flags. Questo riquadro visualizza un elenco di indicatori di funzione disponibili nell'ambiente corrente dell'istanza del servizio App Configuration.

2. Fare clic su Aggiungi targeting nella riga del flag della funzione richiesta per visualizzare il pannello laterale Aggiungi configurazioni di targeting.

3. La sezione Rollout della caratteristica (Default) visualizza il cursore della percentuale di rollout predefinito definito durante la creazione della bandiera della caratteristica. È possibile regolare il valore della percentuale di rollout spostando il cursore. Le modifiche vengono salvate automaticamente man mano che si regola il cursore.

4. Nella sezione Regole, è possibile definire regole che controllano chi vede la vostra funzione e gestire più regole con facilità. La vista iniziale mostra il pulsante Crea regola e un campo di ricerca per filtrare le regole esistenti.

   

   Quando si crea la regola, specificare quanto segue:

   • Nome regola- Inserire un nome descrittivo per la regola (massimo 100 caratteri).

   • ID regola- Inserire un identificativo univoco per la regola. Deve contenere solo lettere, numeri, punti (.), trattini (-) e trattini bassi (_). Massimo 100 caratteri.

   • Nella percentuale di rollout, è possibile definire il valore come Sovrascrivi o Eredita da quello predefinito. Se è selezionata l'opzione Override, regolare il valore della percentuale di rollout utilizzando il cursore. La percentuale viene salvata automaticamente man mano che si regola il cursore.

   • Seleziona segmenti- Scegliere uno o più segmenti dall'elenco. I segmenti selezionati vengono visualizzati con un indicatore di conteggio (ad esempio, "1 × segmento selezionato"). Se nessun segmento è disponibile per la destinazione, fare clic su Crea segmento. Per ulteriori informazioni sulla creazione di un segmento, vedere Creazione di un segmento.

   • Per Valore abilitato, è possibile selezionare Sovrascrivi e modificare il valore oppure selezionare Eredita da indicatore.

   • Priorità- Impostare la priorità della regola per determinare l'ordine di valutazione delle regole. È possibile impostare la priorità su una delle seguenti opzioni:

     • Imposta in fondo - Imposta la priorità della regola come ultima. Questa è l'opzione predefinita.
     • Imposta in cima - Imposta la priorità in cima alle regole (ad esempio, 1).
     • Posizione specifica - Imposta la priorità su una posizione specifica definita dall'utente. (il numero di priorità può essere compreso tra 1 e il numero di regole).

   La regola viene creata e salvata quando si fa clic su Salva regola. Non esiste un pulsante separato per la creazione o l'annullamento: è sufficiente chiudere il pannello una volta terminata la configurazione della regola.

5. Dopo aver creato una regola, questa viene visualizzata nella tabella delle regole con le informazioni relative a Priorità, Nome regola, Segmenti e Rollout. È possibile eseguire le seguenti azioni per ogni regola utilizzando il menu di overflow :

   • Copia- Crea una nuova regola duplicando una regola esistente.

   

   

   • Modifica regola- Modifica la configurazione di una regola esistente.

   

   

   • Modifica priorità- Modifica l'ordine di valutazione delle regole. La priorità determina l'ordine di valutazione delle regole. Le regole con un numero di priorità inferiore vengono valutate per prime. È possibile impostare la priorità su una delle opzioni menzionate in precedenza.

   

   

   • Elimina- Rimuovi la regola. Quando si seleziona l'opzione Elimina, viene visualizzata una finestra di dialogo di conferma per evitare l'eliminazione accidentale.

   

   

Se si tenta di specificare un indicatore di funzione non collegato ad una raccolta, viene visualizzata una finestra per aggiungere un indicatore di funzione ad una raccolta.

Come vengono valutate le regole di targeting

Quando si configura il targeting, tenere presente il seguente comportamento di valutazione:

• All'interno di un segmento, diversi attributi vengono valutati con AND.
• All'interno di un singolo attributo di segmento, più valori vengono valutati con OR.
• All'interno di una regola di targeting, più segmenti selezionati vengono valutati con OR.
• Tra le regole di targeting, le regole vengono valutate in base alla priorità e viene applicata la prima regola corrispondente.

Ad esempio, se una regola contiene i segmenti Production - US-East e Production - Eu-De, la regola corrisponde quando uno dei due segmenti corrisponde. Se si desidera effettuare il roll-out a questi pubblici separatamente, creare regole separate o definire ogni segmento con tutti gli attributi richiesti e ordinare le regole per priorità.

Se si desidera abilitare una funzione prima per gli utenti di produzione in eu-de e successivamente per gli utenti di produzione in us-east, definire ogni segmento con tutti gli attributi richiesti, ad esempio:

• Segmento 1: environment is production e region is eu-de
• Segmento 2: environment is production e region is us-east

Quindi, indirizzare questi segmenti in regole separate e ordinare le regole in base alla priorità nella vista Modifica targeting. Questo approccio consente di garantire che ogni regola corrisponda solo al pubblico previsto.

Abilitazione di un indicatore di funzione

Dopo aver assegnato un indicatore di funzione a un segmento, fare clic sull'interruttore (ON/OFF) per abilitare o disabilitare un indicatore di funzione.

Indicatori funzione - menu di overflow

Il menu di overflow per ciascun indicatore di funzione (tre punti verticali) è costituito dalle operazioni Modifica, Copia e Elimina e Rimuovi destinazione per tali indicatori di funzione già indicati.

• Quando è selezionata l'opzione Modifica, è possibile modificare Nome, Descrizione, aggiungere o eliminare Tag, modificare il Tipo di indicatore e il Valore predefinito e aggiungere o rimuovere le raccolte per le informazioni sul campo Disponibilità indicatore tra raccolte.
• Quando si seleziona l'opzione Copia, vengono copiate le informazioni sull'indicatore della funzione ed è necessario modificare il Nome dell'indicatore della funzione. Facoltativamente, modificare gli altri dettagli in base alle proprie esigenze.
• Quando è selezionata l'opzione Elimina, viene visualizzata una finestra di conferma per ricercare la conferma per eliminare l'indicatore della funzione selezionato. L'opzione di eliminazione elimina in modo permanente l'indicatore della funzione e l'azione non può essere annullata.
• Nell'elenco degli indicatori di funzione, in un indicatore di funzione, quando si fa clic sull'icona Copia negli appunti, il valore ID indicatore di funzione dell'indicatore di funzione viene copiato negli appunti.
• Rimuovi destinazione rimuove la destinazione degli indicatori di funzione per un segmento.