Creazione di parametri predefiniti in Amazon QuickSight

Creazione o modifica di un valore predefinito statico da applicare alla vista del pannello di controllo di tutti

1. Scegli il menu contestuale (v) accanto al parametro da modificare oppure crea un nuovo parametro completando i passaggi descritti in Configurazione dei parametri in Amazon QuickSight.

2. Per impostare un valore predefinito statico, immetti un valore nel campo Valore predefinito statico.

Per identificare le persone per un parametro dinamico predefinito (DDP)

• Elenca i nomi dei singoli utenti o dei gruppi:

  • Per elencare i singoli nomi utente, includi una colonna che identifichi le persone per teDDP. Questa colonna deve contenere il nome utente di sistema di ogni persona a cui si connette dal tuo provider di QuickSight identità. Questo nome utente è spesso uguale all'alias e-mail di una persona prima del segno @, ma non sempre.

    Per ottenere un elenco di utenti, usa l'ListUsers QuickSight APIoperazione o il AWS CLI comando. Il CLI comando è illustrato nell'esempio seguente. Specificate il Regione AWS nome per il vostro provider di identità, ad esempious-east-1.

    awsacct1="111111111111"
    namespace="default"
    region="us-east-1"
    
    aws quicksight list-users --aws-account-id $awsacct1 --namespace $namespace --region $region 

    L'esempio seguente modifica il comando precedente aggiungendo una query che limita i risultati agli utenti attivi.

    awsacct1="111111111111"
    namespace="default"
    region="us-east-1"
    
    aws quicksight list-users --aws-account-id $awsacct1 --namespace $namespace --region $region --query 'UserList[?Active==`true`]'

    L'aspetto del file dei risultati è simile a quello riportato di seguito. Questo esempio è un estratto da JSON output ()--output json. Le persone che hanno nomi utente federati hanno dei principi IDs che iniziano con la parola. federated

    [
        {
            "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/anacasilva",
            "UserName": "anacarolinasilva",
            "Email": "anacasilva@example.com",
            "Role": "ADMIN",
            "Active": true,
            "PrincipalId": "federated/iam/AIDAJ64EIEIOPX5CEIEIO"
        },
        {
            "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/Reader/liujie-stargate",
            "UserName": "Reader/liujie-stargate",
            "Role": "READER",
            "Active": true,
            "PrincipalId": "federated/iam/AROAIJSEIEIOMXTZEIEIO:liujie-stargate"
        },
        {
            "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/embedding/cxoportal",
            "UserName": "embedding/cxoportal",
            "Email": "saanvisarkar@example.com",
            "Role": "AUTHOR",
            "Active": true,
            "PrincipalId": "federated/iam/AROAJTGEIEIOWB6BEIEIO:cxoportal"
        },
        {
            "Arn": "arn:aws:quicksight:us-east-1:111111111111:user/default/zhangwei@example.com",
            "UserName": "zhangwei@example.com",
            "Email": "zhangwei@example.com",
            "Role": "AUTHOR",
            "Active": true,
            "PrincipalId": "user/d-96123-example-id-1123"
        }
    ]

  • Per elencare i nomi dei gruppi, includi una colonna che identifichi i gruppi contenenti i nomi utente per il tuo. DDP Questa colonna deve contenere i nomi dei gruppi di sistema utilizzati per la connessione dal provider di identità a QuickSight. Per identificare i gruppi che puoi aggiungere al set di dati, utilizza una o più delle seguenti QuickSight API operazioni o CLI comandi:

    • ListGroups— Elenca QuickSight i gruppi in base all' Account AWS ID e allo spazio dei nomi Regione AWS che contiene il provider di identità.

    • ListGroupMemberships— Elenca gli utenti del gruppo specificato QuickSight .

    • ListUserGroups— Elenca i QuickSight gruppi di cui un QuickSight utente è membro.

    Oppure puoi chiedere all'amministratore di rete di interrogare il tuo provider di identità per ottenere queste informazioni.

Per creare un set di dati per un valore singolo DDP

1. Crea colonne del set di dati con parametri a valore singolo. La prima colonna della query o del file deve essere dedicata alle persone che utilizzano il pannello di controllo. Questo campo può contenere nomi utente o nomi di gruppi. Tuttavia, il supporto per i gruppi è disponibile solo nell'edizione QuickSight Enterprise.

2. Per ogni campo che visualizza un valore predefinito dinamico per un parametro a valore singolo, aggiungi una colonna al set di dati. Il nome della colonna non ha importanza: puoi usare lo stesso nome del campo o del parametro.

   I parametri a valore singolo funzionano solo come specificato se la combinazione di entità utente e impostazione predefinita dinamica è unica per il campo di quel parametro. Se sono presenti più valori in un campo predefinito per un'entità utente, il controllo a valore singolo per quel campo visualizza invece il valore predefinito statico. Se non è definito alcun valore predefinito statico, il controllo non visualizza un valore predefinito. Fai attenzione se utilizzi nomi di gruppo, poiché alcuni nomi utente potrebbero essere membri di più gruppi. Se tali gruppi hanno valori predefiniti diversi, questo tipo di nome utente sarà una voce duplicata.

   L'esempio seguente mostra una tabella che sembra contenere due parametri a valore singolo. Facciamo questa ipotesi perché nessun nome utente è associato a più valori predefiniti. Per facilitare la comprensione di questa tabella, aggiungiamo la parola 'default' davanti ai nomi dei campi dell'analisi. Pertanto, è possibile leggere la tabella facendo la seguente dichiarazione, modificando i valori per ogni riga: Quando vengono visualizzati da anacarolinasilva, i controlli visualizzano un'area NorthEast predefinita e un segmento SMB predefinito.

   Visualizzato da	Regione predefinita	Segmento predefinito
   anacarolinasilva	NorthEast	SMB
   liujie	SouthEast	SMB
   saanvisarkar	NorthCentral	SMB
   zhangwei	SouthCentral	SMB

3. Importa questi dati in QuickSight e salvalo come nuovo set di dati.

4. Nella tua analisi, aggiungi il set di dati che hai creato. L'analisi deve utilizzare almeno un altro set di dati che corrisponda alle colonne definite per i valori predefiniti. Per ulteriori informazioni, consulta Aggiunta di un set di dati a un'analisi.

Per creare un set di dati per un multivalore DDP

1. Crea colonne del set di dati con parametri multivalore. La prima colonna della query o del file deve essere dedicata alle persone che utilizzano il pannello di controllo. Questo campo può contenere nomi utente o nomi di gruppi. Tuttavia, il supporto per i gruppi è disponibile solo nell' QuickSight edizione Enterprise.

2. Per ogni campo che visualizza un valore predefinito dinamico per un parametro multivalore, aggiungi una colonna al set di dati. Il nome della colonna non ha importanza: puoi usare lo stesso nome del campo o del parametro.

   A differenza dei parametri a valore singolo, i parametri multivalore consentono più valori nel campo associato al parametro.

   L'esempio seguente mostra una tabella che sembra contenere un parametro a valore singolo e un parametro multivalore. Possiamo fare questa ipotesi perché ogni nome utente ha un valore univoco in una colonna e alcuni nomi utente hanno più valori nell'altra colonna. Per facilitare la comprensione di questa tabella, aggiungiamo la parola 'default' davanti ai nomi dei campi dell'analisi. Pertanto, è possibile leggere la tabella facendo la seguente dichiarazione, modificando i valori per ogni riga: Quando viewed-by è liujie, i controlli visualizzano un valore default-region pari a SouthEast e un valore default-city pari a Atlanta. E se leggiamo prima una riga, vediamo che anche liujie ha Raleigh in default-city.

   Visualizzato da	Regione predefinita	Città predefinita
   anacarolinasilva	NorthEast	New York
   liujie	SouthEast	Atlanta
   liujie	SouthEast	Raleigh
   saanvisarkar	NorthCentral	Chicago
   zhangwei	SouthCentral	Dallas
   zhangwei	SouthCentral	Kansas City

   In questo esempio, il parametro a cui applichiamo la default-region funziona correttamente sia che si tratti di un parametro a valore singolo che multivalore. Se si tratta di un parametro a valore singolo, due voci funzionano per un utente perché entrambe hanno lo stesso valore, SouthEast. Se è un parametro multivalore, funziona comunque tranne per il fatto che per impostazione predefinita è selezionato un solo valore. Tuttavia, se cambiamo il parametro che utilizza default-city come valore predefinito da un parametro multivalore a un parametro a valore singolo, questi valori predefiniti non saranno selezionati. Al contrario, il parametro utilizza il valore predefinito statico, se ne è definito uno. Ad esempio, se il valore predefinito statico è impostato su Atlanta, liujie ha Atlanta selezionato in quel controllo, ma non Raleigh.

   In alcuni casi, il valore statico predefinito potrebbe essere utilizzato anche come valore predefinito dinamico. In tal caso, assicurati di testare il controllo per un nome utente che non utilizzi un valore predefinito che può essere entrambi.

   Se un nome utente appartiene a più gruppi, l'utente denominato visualizza un set di valori predefiniti che è un'unione dei valori predefiniti dei due gruppi.

3. Importa questi dati in QuickSight e salvalo come nuovo set di dati.

4. Nella tua analisi, aggiungi il set di dati che hai creato. L'analisi deve utilizzare almeno un altro set di dati che corrisponda alle colonne definite per i valori predefiniti. Per ulteriori informazioni, consulta Aggiunta di un set di dati a un'analisi.

Per DDP aggiungere un

1. Nella QuickSight console, scegli l' icona Parametri nella parte superiore della pagina e scegli un parametro esistente. Scegli Modifica parametro dal menu del parametro. Per aggiungere un nuovo parametro, scegli il segno più (+) accanto a Parametri.

2. Scegliere Set a dynamic default (Imposta un valore predefinito dinamico).

3. Configura le seguenti opzioni con le tue impostazioni:

   • Set di dati con valori predefiniti e informazioni sull'utente: scegli il set di dati che hai creato e aggiunto all'analisi.

   • Colonna del nome utente: per creare valori predefiniti basati sui nomi utente, scegli la colonna del set di dati che contiene i nomi utente.

   • Colonna nome del gruppo: per creare valori predefiniti basati sui nomi utente, scegli la colonna del set di dati che contiene i nomi utente.

   • Colonna per il valore predefinito: scegli la colonna che contiene i valori predefiniti per questo parametro.

4. Scegli Applica per salvare le modifiche alle impostazioni, quindi scegli Aggiorna per salvare le modifiche ai parametri. Per uscire senza apportare modifiche, scegli Annulla.

5. Aggiungi un filtro per ogni campo che contiene valori predefiniti dinamici in modo che i valori predefiniti funzionino. Per ulteriori informazioni sull'uso dei filtri con i parametri, consulta Utilizzo di filtri con parametri in Amazon QuickSight.

   Amazon QuickSight utilizza il valore predefinito statico per chiunque il cui nome utente non esiste nel set di dati, non ha un valore predefinito assegnato o non ha un valore predefinito univoco. Ogni persona può avere solo un set di impostazioni predefinite. Se non desideri utilizzare valori predefiniti dinamici, puoi scegliere di impostare un valore predefinito statico.