Defina enumeraciones y valores sugeridos en la interfaz de usuario enums-and-suggested-values
En el Modelo de datos de experiencia (XDM), se puede dar a un campo de cadena un conjunto predefinido de valores aceptados o sugeridos para controlar mejor qué valores se incorporan a ese campo o cómo se comportará en la segmentación.
Enumeraciones restringen los valores que se pueden introducir para un campo de cadena a un conjunto predefinido. Si intenta introducir datos en un campo de enumeración y el valor no coincide con ninguno de los definidos en su configuración, se denegará la ingesta.
A diferencia de las enumeraciones, la opción Valores sugeridos permite denotar un conjunto de valores recomendados para un campo de cadena que no restringen los valores que puede introducir. En su lugar, los valores sugeridos afectan a los valores predefinidos disponibles en la IU de segmentación al incluir el campo de cadena como atributo.
Al definir un nuevo campo en la interfaz de usuario de Adobe Experience Platform y establecer el tipo en Cadena, se le da la opción de definir un enum o valores sugeridos para ese campo.
Este documento explica cómo definir enumeraciones y valores sugeridos en el área de trabajo de la interfaz de usuario de Schemas. Para obtener información general rápida sobre las enumeraciones y los valores sugeridos, incluido cómo configurarlos en la interfaz de usuario y sus efectos descendentes, vea el siguiente vídeo:
Definir una enumeración enum
Seleccione Enumeraciones y Valores sugeridos, luego seleccione Enumeraciones. Aparecerán controles adicionales, que le permitirán especificar las restricciones de valor para la enumeración. Para agregar una restricción, seleccione Agregar fila.
En la columna Value, debe proporcionar el valor exacto al que desea restringir el campo. Opcionalmente, también puede proporcionar un Nombre para mostrar fácil de usar para la restricción, lo que afecta a la forma en que se representará el valor en la segmentación.
Continúe usando Agregar fila para agregar las restricciones deseadas y las etiquetas opcionales a la enumeración o seleccione el icono de eliminación (
El lienzo se actualiza para reflejar los cambios. Cuando explore este esquema en el futuro, puede ver y editar las restricciones del campo de enumeración en el carril derecho.
Definir valores sugeridos suggested-values
Seleccione Enumeraciones y valores sugeridos, luego seleccione Valores sugeridos para que aparezcan controles adicionales. Desde aquí, seleccione Agregar fila para empezar a agregar valores sugeridos.
En la columna Nombre para mostrar, proporcione un nombre descriptivo para el valor tal como desea que aparezca en la interfaz de usuario de la segmentación. Para agregar más valores sugeridos, vuelva a seleccionar Agregar fila y repita el proceso según sea necesario. Para quitar una fila agregada anteriormente, seleccione
Cuando termine, seleccione Aplicar para aplicar los cambios al esquema.
Administrar los valores sugeridos para los campos estándar
Algunos campos de componentes XDM estándar contienen sus propios valores sugeridos, como eventType de la clase XDM ExperienceEvent. Aunque puede crear valores sugeridos adicionales para un campo estándar, no puede modificar ni eliminar ningún valor sugerido que no esté definido por su organización. Al ver un campo estándar en la interfaz de usuario, sus valores sugeridos se muestran, pero son de solo lectura.
Para agregar nuevos valores sugeridos para un campo estándar, seleccione Agregar fila. Para quitar un valor sugerido que su organización agregó anteriormente, seleccione
Reglas de evolución para enumeraciones y valores sugeridos evolution
Después de utilizar un esquema con un campo enum para introducir datos en Platform, cualquier cambio adicional realizado en la definición del esquema debe cumplir con los datos que ya están en el sistema. En general, los cambios realizados en un campo existente solo pueden hacer que el campo less sea restrictivo. Un campo no puede ser más restrictivo de lo que ya es.
Cuando se trata de enumeraciones y valores sugeridos, las siguientes reglas se aplican después de la ingesta:
- Usted PUEDE agregar valores sugeridos para campos estándar y personalizados con valores sugeridos existentes.
- Usted PUEDE quitar valores sugeridos de los campos personalizados con valores sugeridos existentes.
- Usted PUEDE agregar nuevos valores de enumeración para un campo de enumeración personalizado existente.
- Usted CAN cambia los valores de enumeración de un campo personalizado a valores sugeridos solamente, o lo convierte a una cadena sin enumeración ni valores sugeridos. Este modificador no se puede deshacer una vez aplicado.
- Usted NO PUEDE eliminar enumeraciones o valores sugeridos de los campos estándar.
- Usted NO puede agregar valores de enumeración a un campo sin enumeración existente.
- Usted NO PUEDE eliminar menos de todos los valores de enumeración existentes para un campo personalizado.
- Usted NO PUEDE cambiar de valores sugeridos a una enumeración.
Combinación de reglas para enumeraciones y valores sugeridos merging
Si varios esquemas utilizan el mismo campo de enumeración con diferentes configuraciones y esos esquemas se incluyen en una unión, se aplican ciertas reglas cuando se trata de cómo se reconcilian las diferencias de enumeración. Las reglas exactas dependen de si los esquemas que hacen referencia al mismo campo estándar (como eventType) o si hacen referencia a la misma ruta de campo personalizada en diferentes grupos de campos.
Si hace referencia al mismo campo estándar:
- Cualquier valor sugerido adicional es APPENDED en la unión.
- Las actualizaciones realizadas en los valores sugeridos para la misma clave de enumeración son UPDATED en la unión.
Si se hace referencia a la misma ruta de campo personalizado en grupos de campos diferentes:
- Cualquier valor sugerido adicional es APPENDED en la unión.
- Si el mismo valor sugerido adicional se define en más de un esquema, esos valores son MERGED en la unión. En otras palabras, el mismo valor sugerido no aparecerá dos veces después de la combinación.
Limitaciones de validación
Debido a las limitaciones actuales del sistema, hay dos casos en los que el sistema no valida una enumeración durante la ingesta:
- La enumeración se define en un campo de matriz.
- La enumeración se define en más de un nivel de profundidad en la jerarquía de esquemas.
Pasos siguientes
En esta guía se explica cómo definir enumeraciones y valores sugeridos para campos de cadena en la interfaz de usuario. Para obtener información sobre cómo administrar enumeraciones y valores sugeridos mediante la API de Registro de esquemas, consulte el siguiente tutorial.
Para obtener información sobre cómo definir otros tipos de campos XDM en Schema Editor, consulte la descripción general de definición de campos en la interfaz de usuario.