Creación de parámetros predeterminados en Amazon QuickSight

Creación o edición de un valor predeterminado estático que se aplique a todas las vistas del panel

1. Elija el menú contextual (v) situado junto al parámetro que desea editar o cree un parámetro nuevo siguiendo los pasos que se indican en Configuración de parámetros en Amazon QuickSight.

2. Ingrese un valor para Valor predeterminado estático para establecer un valor predeterminado estático.

Identificación de las personas para un parámetro dinámico predeterminado (DDP)

• Enumere los nombres de usuario individuales o los nombres de grupo:

  • Para enumerar nombres de usuario individuales, incluya una columna que identifique a las personas para su DDP. Esta columna debe contener el nombre de usuario del sistema de cada persona que utilice para conectarse desde su proveedor de identidad QuickSight. El nombre de usuario suele coincidir con el alias de correo electrónico de la persona antes del signo @, pero no siempre.

    Para obtener una lista de usuarios, usa la operación o el AWS CLI comando de la ListUsers QuickSight API. El comando de la CLI se muestra en el siguiente ejemplo. Especifique el Región de AWS para su proveedor de identidad, por ejemplous-east-1.

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

    El siguiente ejemplo modifica el comando anterior al agregar una consulta que limita los resultados a los usuarios activos.

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

    El conjunto de resultados es similar al siguiente ejemplo. Este ejemplo es un extracto de la salida JSON (--output json). Las personas que tienen nombres de usuario federados tienen un principio IDs que comienza por la palabrafederated.

    [
        {
            "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"
        }
    ]

  • Para listar los nombres de grupo, incluya una columna que identifique los grupos que contienen los nombres de usuario para su DDP. Esta columna debe contener los nombres de los grupos del sistema que se utilizan para conectarse desde su proveedor de identidad a QuickSight. Para identificar los grupos que puede añadir al conjunto de datos, utilice una o más de las siguientes operaciones de QuickSight API o comandos de CLI:

    • ListGroups— Enumera QuickSight los grupos por Cuenta de AWS ID y espacio de nombres para los Región de AWS que contienen su proveedor de identidad.

    • ListGroupMemberships— Muestra los usuarios del grupo especificado QuickSight .

    • ListUserGroups— Muestra los QuickSight grupos de los que es miembro un QuickSight usuario.

    También puede pedir a su administrador de red que consulte a su proveedor de identidad para obtener esta información.

Creación de un conjunto de datos para un DDP de valor único

1. Cree columnas de conjunto de datos con parámetros de valor único. La primera columna de la consulta o el archivo debe corresponder a las personas que utilizan el panel. Este campo puede contener nombres de usuario o de grupo. Sin embargo, el soporte para grupos solo está disponible en la edición QuickSight Enterprise.

2. Para cada campo que muestre un valor predeterminado dinámico de un parámetro de valor único, agregue una columna al conjunto de datos. El nombre de la columna no es importante; puede utilizar el mismo nombre que el campo o el parámetro.

   Los parámetros de valor único solo funcionan según lo especificado si la combinación de entidad de usuario y valor predeterminado dinámico es única para el campo de ese parámetro. Si hay varios valores en un campo predeterminado para una entidad de usuario, el control de valor único para ese campo muestra el valor predeterminado estático en su lugar. Si no se define ningún valor predeterminado estático, el control no muestra ningún valor predeterminado. Tenga cuidado si utiliza nombres de grupo, porque algunos nombres de usuario pueden ser miembros de varios grupos. Si esos grupos tienen valores predeterminados diferentes, entonces este tipo de nombre de usuario funciona como una entrada duplicada.

   El siguiente ejemplo muestra una tabla que parece contener dos parámetros de valor único. Suponemos esto porque ningún nombre de usuario está vinculado a varios valores predeterminados. Para que esta tabla sea más fácil de entender, agregamos la palabra 'default' delante de los nombres de los campos del análisis. Así, puede leer la tabla mediante la siguiente instrucción, cambiándole los valores de cada fila: Cuando lo ve anacarolinasilva los controles muestran una región predeterminada NorthEast y un segmento predeterminado SMB.

   Viewed-by	Default-region	Default-segment
   anacarolinasilva	NorthEast	SMB
   liujie	SouthEast	SMB
   saanvisarkar	NorthCentral	SMB
   zhangwei	SouthCentral	SMB

3. Importe estos datos y guárdelos como un conjunto de datos nuevo. QuickSight

4. En su análisis, agregue el conjunto de datos que creó. El análisis necesita utilizar al menos otro conjunto de datos que coincida con las columnas que definió para los valores predeterminados. Para obtener más información, consulte Añadir un conjunto de datos a un análisis.

Creación de un conjunto de datos para un DDP de varios valores

1. Cree columnas de conjunto de datos con parámetros de varios valores. La primera columna de la consulta o el archivo debe corresponder a las personas que utilizan el panel. Este campo puede contener nombres de usuario o de grupo. Sin embargo, el soporte para grupos solo está disponible en la edición QuickSight Enterprise.

2. Para cada campo que muestre un valor predeterminado dinámico de un parámetro de varios valores, agregue una columna al conjunto de datos. El nombre de la columna no es importante; puede utilizar el mismo nombre que el campo o el parámetro.

   A diferencia de los parámetros de valor único, los parámetros de varios valores permiten varios valores en el campo asociado al parámetro.

   El siguiente ejemplo muestra una tabla que parece contener un parámetro de valor único y un parámetro de varios valores. Podemos suponerlo porque cada nombre de usuario tiene un valor único en una columna y algunos nombres de usuario tienen varios valores en la otra columna. Para que esta tabla sea más fácil de entender, agregamos la palabra 'default' delante de los nombres de los campos del análisis. Así, puede leer la tabla mediante la siguiente instrucción, cambiándole los valores a cada fila: Cuando viewed-by es liujie, los controles muestran un valor de default-region SouthEast, y un valor de default-city Atlanta. Y si leemos una fila más adelante, veremos que liujie también tiene Raleigh como default-city.

   Viewed-by	Default-region	Default-city
   anacarolinasilva	NorthEast	Nueva York
   liujie	SouthEast	Atlanta
   liujie	SouthEast	Raleigh
   saanvisarkar	NorthCentral	Chicago
   zhangwei	SouthCentral	Dallas
   zhangwei	SouthCentral	Kansas City

   En este ejemplo, el parámetro al que aplicamos default-region funciona correctamente tanto si se trata de un parámetro de un solo valor como de varios valores. Si es un parámetro de valor único, funcionan dos entradas para un usuario porque ambas entradas tienen el mismo valor, SouthEast. Si es un parámetro de varios valores, funciona igual, salvo que se selecciona un solo valor predeterminado. Sin embargo, si cambiamos el parámetro que utiliza default-city predeterminada como valor predeterminado de un parámetro de varios valores a un parámetro de valor único, no veremos seleccionados estos valores predeterminados. En su lugar, el parámetro utiliza el valor predeterminado estático, si hay alguno definido. Por ejemplo, si el valor predeterminado estático se establece en Atlanta, liujie tiene Atlanta seleccionada en ese control, pero no Raleigh.

   En algunos casos, es posible que el valor predeterminado estático también se utilice como valor predeterminado dinámico. Si es así, asegúrese de probar el control para un nombre de usuario que no utilice un valor predeterminado que pueda ser ambos.

   Si un nombre de usuario pertenece a varios grupos, el usuario nombrado ve un conjunto de valores predeterminados que es la unión de los valores predeterminados de los dos grupos.

3. Importe estos datos y guárdelos como un conjunto de datos nuevo. QuickSight

4. En su análisis, agregue el conjunto de datos que creó. El análisis necesita utilizar al menos otro conjunto de datos que coincida con las columnas que definió para los valores predeterminados. Para obtener más información, consulte Añadir un conjunto de datos a un análisis.

Adición de un DDP a su análisis

1. En la QuickSight consola, elija el icono de parámetros en la parte superior de la página y elija un parámetro existente. Seleccione Editar parámetro en el menú del parámetro. Para agregar un nuevo parámetro, elija el signo más (+) cerca de Parámetros.

2. Elija Establecer un valor predeterminado dinámico.

3. Configure las siguientes opciones con sus parámetros:

   • Conjunto de datos con valores predeterminados e información del usuario: elija el conjunto de datos que creó y agregó a su análisis.

   • Columna de nombre de usuario: para crear valores predeterminados basados en nombres de usuario, elija la columna del conjunto de datos que contiene los nombres de usuario.

   • Columna de nombre de grupo: para crear valores predeterminados basados en nombres de grupo, elija la columna del conjunto de datos que contiene los nombres de grupo.

   • Columna para el valor predeterminado: elija la columna que contiene los valores predeterminados para este parámetro.

4. Seleccione Aplicar para guardar los cambios de configuración y, a continuación, haga clic en Actualizar para guardar los cambios de los parámetros. Para salir sin guardar los cambios, elija Cancelar.

5. Agregue un filtro para cada campo que contenga valores predeterminados dinámicos para que los valores predeterminados funcionen. Para obtener más información sobre cómo usar filtros con parámetros, consulte Uso de filtros con parámetros en Amazon QuickSight.

   Amazon QuickSight usa el valor predeterminado estático para cualquier persona cuyo nombre de usuario no exista en el conjunto de datos, no tenga un valor predeterminado asignado o no tenga un valor predeterminado único. Cada persona solo puede tener un conjunto de valores predeterminados. Si no desea usar valores predeterminados dinámicos, puede establecer un valor predeterminado estático en su lugar.