Implementare le funzionalità per i gruppi di destinatari

Il targeting è una strategia di gestione delle funzionalità che gli sviluppatori possono usare per distribuire gradualmente nuove funzionalità alla propria base di utenti. La strategia si basa sul concetto di destinazione di un set di utenti noti come destinatari di destinazione. Un gruppo di destinatari è costituito da utenti, gruppi e una percentuale designata dell'intera base utenti.

  • Gli utenti possono essere account utente effettivi, ma possono anche essere computer, dispositivi o qualsiasi entità identificabile in modo univoco a cui si vuole implementare una funzionalità.

  • Spetta all'applicazione definire i gruppi. Ad esempio, quando si scelgono come destinazione gli account utente, è possibile usare gruppi di Microsoft Entra o gruppi che indicano le località degli utenti. Quando si esegue la destinazione dei computer, è possibile raggrupparli in base alle fasi di implementazione. È possibile basare i gruppi su qualsiasi attributo comune che si vuole usare per classificare i destinatari.

I filtri delle funzionalità consentono di abilitare o disabilitare un flag di funzionalità in modo condizionale. Il filtro di destinazione è uno dei filtri di funzionalità predefiniti della libreria di gestione delle funzionalità. È possibile usare un filtro di destinazione per attivare o disattivare una funzionalità per i destinatari di destinazione.

Questo articolo illustra come aggiungere e configurare un filtro di destinazione per un flag di funzionalità.

Prerequisiti

  • Una sottoscrizione di Azure. Se non ne hai uno, crea un account gratuito .
  • Un archivio di Configurazione app di Azure.

Aggiungere un filtro di destinazione

  1. Creare un flag di funzionalità denominato Beta nell'archivio di Configurazione app e aprirlo per la modifica. Per altre informazioni su come aggiungere e modificare un flag di funzionalità, vedere Creare un flag di funzionalità e modificare i flag di funzionalità.

  2. Nella finestra di dialogo Modifica flag di funzionalità selezionare Abilita flag di funzionalità se non è già selezionato. Seleziona Distribuzione e quindi seleziona Destinatari.

    Screenshot della finestra di dialogo Modifica flag di funzionalità del portale di Azure con Rollout selezionato, che mostra la scheda Destinatari con Percentuale predefinita impostata su 100 e le opzioni Sostituisci per gruppi e Sostituisci per utenti.

  3. Effettuare le selezioni seguenti:

    • Seleziona Sostituisci per gruppi.
    • Seleziona Sostituisci dagli utenti.
  4. Immettere le informazioni seguenti:

    • In Percentuale predefinita immettere 0.
    • In Includi gruppi:
      • Per Nome inserisci contoso.com.
      • In Percentuale immettere 50.
    • In Escludi gruppi immettere contoso-xyz.com.
    • In Includi utenti immettere test@contoso.com.
    • In Escludi utenti immettere testuser@contoso.com.

    Schermata del portale di Azure della finestra di dialogo Modifica flag di funzionalità, scheda Destinatari, che mostra Percentuale predefinita impostata su 0, Sostituzione per gruppi con Includi gruppi ed Escludi gruppi configurati e Sostituzione per utenti con Includi utenti ed Escludi utenti configurati.

    Queste impostazioni comportano il comportamento seguente:

    • Il flag di funzionalità è sempre disabilitato per l'utente testuser@contoso.comperché testuser@contoso.com è elencato nella sezione Escludi utenti .
    • Il flag di funzionalità è sempre disabilitato per gli utenti del contoso-xyz.com gruppo, perché contoso-xyz.com è elencato nella sezione Escludi gruppi .
    • Il flag di funzionalità è sempre abilitato per l'utente test@contoso.comperché test@contoso.com è elencato nella sezione Includi utenti .
    • Il flag di funzionalità è abilitato per il 50% degli utenti nel contoso.com gruppo, perché contoso.com è elencato nella sezione Includi gruppi con un valore percentuale pari a 50.
    • La funzionalità è sempre disabilitata per tutti gli altri utenti, perché il valore percentuale predefinito è impostato su 0.

    Il filtro di destinazione viene valutato per un determinato utente, come illustrato nel diagramma seguente.

    Diagramma di flusso con punti decisionali per percentuali, utenti e gruppi inclusi e utenti e gruppi esclusi e gli stati finali Abilitato e Disabilitato.

  5. Per salvare il flag di funzionalità, seleziona Recensi + aggiorna in basso. Dopo il passaggio della validazione, seleziona Aggiorna.

    Il filtro di targeting viene aggiunto alla tua feature flag. Questo filtro di destinazione usa la regola di destinazione configurata per abilitare o disabilitare il flag di funzionalità per utenti e gruppi specifici.

  6. Per usare il flag di funzionalità con il filtro di destinazione nell'applicazione, vedere le istruzioni relative al linguaggio o alla piattaforma in uso:

Passaggi successivi

Per altre informazioni sui filtri delle funzionalità, continuare con gli articoli seguenti: