Crear un distintivo de característica

Para crear un distintivo de característica, siga estos pasos:

1. En la consola de App Configuration, pulse Distintivos de características.

2. Seleccione el Entorno actual para visualizar la lista de distintivos de característica en ese entorno.

3. Pulse Crear. El panel lateral se abre y muestra los campos para crear un nuevo indicador de función.

   

4. Proporcione los detalles del distintivo de característica:

   • Nombre: nombre del distintivo de característica.
   • ID de distintivo de característica: el valor de ID de distintivo de característica se sugiere automáticamente en función del nombre de la recopilación introducido. Puede modificar el nombre, si es necesario. Utilice el valor ID de distintivo de característica como el identificador en su SDK o código de API.
   • Tipo de distintivo: especifique el tipo del distintivo de característica. El tipo soportado incluye: Booleano, Serie y Numérico. Para obtener más información sobre el tipo de distintivo y los valores predeterminados, consulte Selección del tipo de distintivo de característica.
   • Valor predeterminado: especifique el valor predeterminado para el tipo de distintivo de característica seleccionado. Para obtener más información sobre el tipo de distintivo y los valores predeterminados, consulte Selección del tipo de distintivo de característica.
   • Opcionalmente, seleccione una colección para aplicar un distintivo de característica ahora. De lo contrario, debe añadir una colección antes de conmutar un distintivo de característica. Puedes añadir el indicador de función a una o varias colecciones seleccionándolo en la lista « Habilitar el indicador en todas las colecciones ».
   • Despliegue de características: especifique Rollout percentage utilizando el graduador. Para obtener más información sobre el despliegue manual, consulte Configurar el porcentaje de despliegue de funciones.
   • Descripción: añada una descripción del distintivo de característica, que es opcional.
   • Si lo deseas, define etiquetas que te ayuden a identificar el indicador de función.

5. Pulse Crear.

De forma predeterminada, al crear un nuevo indicador de función, el interruptor «Habilitado» aparece en la posición « OFF ».

Seleccionar tipo de distintivo de característica

Puede tener uno de los siguientes tipos de distintivos asociados a un distintivo de característica:

• Boolean
• Serie
• Numérico

Cada tipo de distintivo tiene un valor predeterminado.

• Al colocar el interruptor en la posición «ON», es obligatorio introducir el valor de «Habilitado», que puede anularse al seleccionar un segmento como destinatario.
• Cuando se coloca el interruptor en la posición «OFF», es obligatorio introducir el valor de «Desactivado», que puede anularse al seleccionar un segmento como destinatario.

Boolean

Cuando selecciona el Tipo de distintivo como Booleano, se visualizan los detalles de Valor predeterminado:

1. Seleccione Valor habilitado en la lista. Este valor se devuelve de forma predeterminada cuando el interruptor de la bandera de función está en la posición «ON ». Este valor se puede anular al dirigir la campaña a un segmento.

2. Seleccione Valor inhabilitado en la lista. Este valor se devuelve de forma predeterminada cuando el conmutador se establece en OFF para el distintivo de característica.

Serie

Cuando selecciona el Tipo de distintivo como Serie, se visualizan los detalles de Valor predeterminado:

1. Seleccione el Formato del tipo de distintivo de serie en la lista. El formato soportado es Texto, JSON y YAML. Cuando se selecciona el formato JSON o YAML, proporcione el Valor habilitado y el Valor inhabilitado en el formato seleccionado.

2. Especifique el Valor habilitado. Este valor se devuelve de forma predeterminada cuando el interruptor de activación está en la posición «ON» para el indicador de función. Este valor se puede anular al dirigir la campaña a un segmento.

3. Especifique el Valor inhabilitado. Este valor se devuelve de forma predeterminada cuando el conmutador se establece en OFF para el distintivo de característica.

Numérico

Cuando selecciona el Tipo de distintivo como Tipo de distintivo, se visualizan los detalles de Valor predeterminado:

1. Seleccione Valor habilitado en la lista. Solo se da soporte a los valores enteros. Este valor se devuelve de forma predeterminada cuando el interruptor de activación está en la posición «ON» para el indicador de función. Este valor se puede anular al dirigir la campaña a un segmento.

2. Seleccione Valor inhabilitado en la lista. Solo se da soporte a los valores enteros. Este valor se devuelve de forma predeterminada cuando el conmutador se establece en OFF para el distintivo de característica.

Apuntar recopilaciones a distintivos de características

Opcionalmente, seleccione una colección para aplicar un distintivo de característica ahora. De lo contrario, debe añadir una colección antes de conmutar un distintivo de característica. Puede añadir distintivos de características a una o varias recopilaciones ya sea durante la creación del distintivo de característica o bien durante la edición de detalles de un distintivo de característica.

Para añadir recopilaciones al distintivo de característica, en el campo Disponibilidad de distintivos en las recopilaciones, seleccione la recopilación de la lista.

Si intentas seleccionar un indicador de función que no esté vinculado a una colección, aparecerá una ventana para añadir dicho indicador a una colección.

Configurar porcentaje de despliegue de característica

Puede configurar el distintivo de característica con un porcentaje de despliegue en el rango de 0 a 100, que indica la aplicabilidad de la característica a un conjunto parcial de usuarios o dispositivos.

El lanzamiento manual permite habilitar una función para un pequeño porcentaje de usuarios seleccionados al azar o para un subconjunto de entidades, lo que ofrece un mayor control sobre el ciclo de lanzamiento y permite una implementación progresiva. Cuando esté seguro de que la característica que desea desplegar funciona según lo previsto, aumente el porcentaje con el tiempo.

El despliegue manual utiliza un algoritmo hash que genera un hash basado en el conjunto de reglas. El SDK utiliza este hash para generar un valor de porcentaje para ese usuario. El valor porcentual generado para ese usuario se compara con el valor establecido para el valor de despliegue manual, determina si el usuario es elegible para recibir esa función o no.

Por ejemplo, el hash tiene particiones de 1 a 100.000. Cuando asigna un distintivo de característica, el hash asigna valores de 1 a 100.000 a los usuarios de cada partición. Por ejemplo, cuando asigna un 25% a un distintivo de característica, App Configuration SDK entrega esa característica a particiones hash de 1 a 25.000. Si cambia el porcentaje de usuarios que reciben esa característica del 25% al 50%, las particiones 25.001 a 50.000 se añadirían al conjunto de particiones que ya reciben esa característica.

La función de implementación manual está disponible en los planes Lite y Enterprise.

A continuación se exponen algunos de los escenarios de despliegue manual:

• Si el distintivo de característica está inhabilitado, el SDK devuelve el Valor inhabilitado predeterminado.
• Si el indicador de función está activado sin ninguna regla de segmento y no se ha establecido ningún despliegue manual, el SDK devuelve el valor Activado por defecto.
• Si el indicador de función está activado sin ninguna regla de segmento y el despliegue manual está establecido en 0%, el SDK devuelve el valor Desactivado para todos los usuarios.
• Si el indicador de función está activado sin ninguna regla de segmento y el rollout manual está configurado a un porcentaje, digamos 50%, entonces el SDK comprueba si el usuario pertenece al tamaño de rollout manual configurado, si el usuario pertenece a los criterios de rollout, entonces el SDK devuelve el valor Activado. Si el usuario no pertenece a los criterios de despliegue, el SDK devuelve el Valor inhabilitado.
• Si el distintivo de característica está habilitado con reglas de segmento, el SDK evalúa primero al usuario con las reglas configuradas. Si el usuario es parte de la regla configurada, entonces el SDK evalúa si el usuario es elegible para el rollout manual.
  • Si se configuran varias reglas y se comprueba si el usuario coincide con la regla hasta la primera coincidencia. Si no se encuentra ninguna coincidencia, el SDK se evalúa con respecto al despliegue predeterminado.
  • Si se evalúa que el usuario forma parte del segmento y el despliegue manual del segmento es 0%, aunque el usuario forme parte del segmento, no recibirá el valor del segmento. El SDK devuelve el Valor inhabilitado predeterminado.
  • Si se evalúa que el usuario forma parte del segmento y el rollout manual del segmento se establece en un porcentaje, digamos 50%, entonces el SDK comprueba si el usuario pertenece al tamaño de rollout configurado, si el usuario pertenece a los criterios de rollout, entonces el SDK devuelve el valor de anulación del segmento. Si el usuario no pertenece a los criterios de despliegue, el SDK devuelve Valor inhabilitado.

Apuntar a un segmento con un distintivo de característica

Puede implantar distintivos de características en uno o varios segmentos de destino. Puede establecer distintos valores de distintivos para distintos segmentos, si es necesario.

1. En la consola de App Configuration, vaya a Distintivos de características. Este panel muestra la lista de indicadores de características disponibles en el entorno actual de la instancia del servicio « App Configuration ».

2. Haga clic en Añadir orientación en la fila de la bandera de la función requerida para mostrar el panel lateral Añadir configuraciones de orientación.

3. La sección Despliegue de funciones (por defecto) muestra el deslizador por defecto Porcentaje de despliegue definido al crear la bandera de característica. Puede ajustar el valor del porcentaje de despliegue moviendo el control deslizante. Los cambios se guardan automáticamente a medida que ajustas la barra deslizante.

4. En la sección Reglas, puede definir reglas que controlen quién ve su función y gestionar múltiples reglas con facilidad. La vista inicial muestra el botón Crear regla y un campo de búsqueda para filtrar las reglas existentes.

   

   Al crear la regla especifique lo siguiente:

   • Nombre de la regla - Introduzca un nombre descriptivo para la regla (máximo 100 caracteres).

   • ID de regla- Introduzca un identificador único para la regla. Sólo debe contener letras, números, puntos (.), guiones (-) y guiones bajos (_). Máximo 100 caracteres.

   • En el porcentaje de despliegue, puede definir el valor como Anular o Heredar del valor por defecto. Si la opción Anular está seleccionada, ajuste el valor del porcentaje de Despliegue utilizando el control deslizante. El porcentaje se guarda automáticamente a medida que se ajusta el control deslizante.

   • Seleccionar segmentos- Elija uno o más segmentos de la lista. Los segmentos seleccionados se muestran con un indicador de recuento (por ejemplo, "Se ha seleccionado 1 × segmento"). Si no hay segmentos disponibles para el objetivo, pulse Crear segmento. Para obtener más información sobre la creación de un segmento, consulte Crear un segmento.

   • Para el Valor habilitado, puede seleccionar Alterar temporalmente y modificar el valor o seleccionar Heredar de distintivo.

   • Prioridad- Establezca la prioridad de la regla para determinar el orden en que se evalúan las reglas. Puede establecer la prioridad en una de las siguientes opciones:

     • Establecer en último lugar - Establece la prioridad de la regla en último lugar. Esta opción es la predeterminada.
     • Establecer al principio - Establece la prioridad al principio de las reglas (es decir, 1).
     • Posición específica - Establece la prioridad en una posición específica definida por el usuario. (El número de prioridad puede estar comprendido entre 1 y el número de reglas).

   La regla se crea y se guarda al hacer clic en Guardar regla. No hay ningún botón separado de Crear o Cancelar- simplemente cierre el panel cuando haya terminado de configurar la regla.

5. Después de crear una regla, ésta aparece en la tabla de reglas mostrando información sobre Prioridad, Nombre de la regla, Segmentos y Despliegue. Puede realizar las siguientes acciones para cada regla utilizando el menú de desbordamiento :

   • Copiar- Crea una nueva regla duplicando una regla existente.

   

   

   • Editar regla- Modifica la configuración de una regla existente.

   

   

   • Editar prioridad- Cambia el orden de evaluación de las reglas. La prioridad determina el orden en que se evalúan las reglas. Las reglas con un número de prioridad más bajo se evalúan primero. Puede establecer la prioridad en una de las opciones mencionadas anteriormente.

   

   

   • Eliminar- Elimina la regla. Al seleccionar borrar, aparece un cuadro de diálogo de confirmación para evitar el borrado accidental.

   

   

Si intentas seleccionar un indicador de función que no esté vinculado a una colección, aparecerá una ventana para añadir dicho indicador a una colección.

Cómo se evalúan las normas de selección

Cuando configure la orientación, tenga en cuenta el siguiente comportamiento de evaluación:

• Dentro de un segmento, los distintos atributos se evalúan con AND.
• Dentro de un mismo atributo de segmento, los valores múltiples se evalúan con OR.
• Dentro de una regla de selección, se evalúan varios segmentos seleccionados con OR.
• Entre las reglas de selección, las reglas se evalúan por prioridad, y se aplica la primera regla coincidente.

Por ejemplo, si una regla contiene los segmentos Production - US-East y Production - Eu-De, la regla coincide cuando coincide cualquiera de los segmentos. Si desea desplegar a esos públicos por separado, cree reglas separadas o defina cada segmento con todos los atributos requeridos y ordene las reglas por prioridad.

Si desea habilitar una función primero para los usuarios de producción en eu-de, y más tarde para los usuarios de producción en us-east, defina cada segmento con todos los atributos necesarios, como:

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

A continuación, oriente esos segmentos en reglas separadas y ordene las reglas por prioridad en la vista Editar orientación. Este planteamiento ayuda a garantizar que cada regla coincida sólo con la audiencia prevista.

Habilitación de un distintivo de característica

Una vez que hayas asignado un indicador de función a un segmento, haz clic en el botón de activación (ON/OFF) para activar o desactivar dicho indicador.

Distintivos de características - menú de desbordamiento

El menú de desbordamiento para cada distintivo de característica (tres puntos verticales) consta de las operaciones Editar, Copiar y Suprimir y Eliminar destino para los distintivos de características que ya tienen destinos.

• Cuando se selecciona la opción «Editar», puedes modificar el nombre y la descripción, añadir o eliminar etiquetas, cambiar el tipo de indicador y el valor por defecto, y añadir o eliminar colecciones en el campo « Disponibilidad del indicador en las colecciones ».
• Cuando se selecciona la opción «Copiar», se copia la información del indicador de función y es necesario modificar el nombre de dicho indicador. Si lo desea, modifique los otros detalles en función de su necesidad.
• Cuando se selecciona la opción Suprimir, se visualiza una ventana de confirmación para solicitar la confirmación de la supresión del distintivo de característica seleccionado. La opción «Eliminar» elimina definitivamente el indicador de función y la acción no se puede deshacer.
• En la lista de distintivos de características, en el distintivo de característica, al pulsar Copiar en el portapapeles, el valor ID de distintivo de característica del distintivo de característica se copia en el portapapeles.
• Al eliminar la segmentación, se elimina la asignación de los indicadores de función a un segmento.