Configuración de la estructura de datos del recurso configuring-the-resource-s-data-structure

Después de crear un nuevo recurso personalizado, debe configurar la estructura de datos.

Al editar el recurso, en la pestaña Data structure, puede añadir:

Adición de campos a un recurso adding-fields-to-a-resource

Puede añadir nuevos campos a un recurso para almacenar datos que no forman parte del modelo de datos predeterminado.

  1. Utilice el botón Create element para crear un campo.

  2. Especifique una etiqueta, un ID, un tipo de campo y defina la longitud máxima autorizada para este campo.

    El campo ID es obligatorio y debe ser único para cada campo añadido.

    note note
    NOTE
    Utilice un máximo de 30 caracteres.

  3. Para modificar uno de los campos, marque la opción Edit Properties.

  4. En la pantalla Field definition, puede definir una categoría que se utiliza para la audiencia y la segmentación, o incluso añadir una descripción.

  5. Seleccione la opción Specify a list of authorized values si necesita definir los valores que se ofrecen al usuario (valores de lista desglosada).

    A continuación, haga clic en Create element y especifique un Label y Value. Añada tantos valores como sea necesario.

  6. Una vez añadidos los campos, marque la casilla Add audit fields para incluir campos que detallen la fecha de creación, el usuario que ha creado el recurso, la fecha y el autor de la última modificación.

  7. Marque la casilla Add access authorization management fields para incluir los campos que indican quién tiene derechos de acceso a ese recurso en particular.

    Estos campos aparecen en los datos y metadatos que se pueden mostrar una vez que se ha realizado la actualización de la base de datos. Para obtener más información, consulte la sección Actualización de la estructura de la base de datos.

  8. Marque el campo Add automatic ID para generar automáticamente un ID. Tenga en cuenta que las entidades existentes permanecerán vacías. Para obtener más información, consulte Generación de un ID único para perfiles y recursos personalizados.

  9. Para modificar la forma en que aparece el nombre de los elementos de recurso en los pasos de listas y creación, marque la casilla Customize the title of the resource elements. Seleccione un campo entre los que ha creado para este recurso.

    note note
    NOTE
    Si no marca esta opción, se utilizará la clave primaria automática (que se crea automáticamente cada vez que se añade una entidad a la tabla) cuando se enumeran todas las entidades de esta tabla.

Los campos del recurso ahora están definidos.

Definición de claves de identificación defining-identification-keys

Cada recurso debe tener al menos una clave única. Por ejemplo, puede especificar una clave para que dos productos no tengan el mismo ID en una tabla de compra.

  1. Especifique el tamaño del almacenamiento en la sección Automatic primary key si desea que una clave técnica se genere de forma automática e incremental.

  2. Utilice el botón Create element para crear una clave.

    Los campos Label y ID se completan de forma predeterminada, pero se pueden editar.

    note note
    NOTE
    Utilice un máximo de 30 caracteres.
  3. Para definir los elementos que componen esta clave, haga clic en Create element y seleccione los campos que ha creado para este recurso.

    Las claves creadas se muestran en la sección Custom keys.

Se han creado las claves de identificación del recurso.

NOTE
Para conocer las prácticas recomendadas al crear claves de identificación, consulte esta sección.

Definición de índices defining-indexes

Un índice puede hacer referencia a uno o varios campos de recursos. Los índices permiten que la base de datos ordene registros para recuperarlos más fácilmente. Optimizan el rendimiento de las consultas SQL.

Se recomienda definir índices, pero no es obligatorio.

  1. Utilice el botón Create element para crear un índice.

  2. Los campos Label y ID se completan de forma predeterminada, pero se pueden editar.

    note note
    NOTE
    Utilice un máximo de 30 caracteres.
  3. Para definir los elementos que componen este índice, seleccione los campos de los que ha creado para este recurso.

  4. Haga clic en Confirm.

Los índices que se han creado aparecen en la lista de la sección Index.

NOTE
Para conocer las prácticas recomendadas al crear índices, consulte esta sección.

Un vínculo detalla la asociación que una tabla tiene con otras tablas.

  1. Utilice el botón Create element para crear un vínculo a un recurso de destino.

  2. Haga clic en Select a target resource.

  3. Los recursos se muestran en orden alfabético y se pueden filtrar por nombre. Su nombre técnico se muestra entre corchetes.

    Seleccione un elemento de la lista y haga clic en Confirm.

  4. Seleccione el Link type según la cardinalidad. Según el tipo de cardinalidad seleccionado, puede variar el comportamiento si se eliminan o duplican los registros.

    Los distintos tipos de vínculos son los siguientes:

    • 1 cardinality simple link: una incidencia de la tabla de origen puede tener como máximo una incidencia correspondiente de la tabla de destino.
    • N cardinality collection link: una incidencia de la tabla de origen puede tener varias incidencias correspondientes de la tabla de destino, pero una incidencia de la tabla de destino puede tener como máximo una incidencia correspondiente de la tabla de origen.
    • 0 or 1 cardinality simple link: una incidencia de la tabla de origen puede tener como máximo una incidencia correspondiente de la tabla de destino o ninguna. Tenga en cuenta que este tipo de Link type puede provocar problemas de rendimiento.

  5. En la pantalla New link, los campos Label y ID se completan de forma predeterminada, pero puede editarlos.

    note note
    NOTE
    Utilice un máximo de 30 caracteres.
    No es posible cambiar el nombre de un vínculo después de crearlo. Para cambiar el nombre de un vínculo, debe eliminarlo y crearlo de nuevo.
  6. La lista Category for the audience and targeting le permite asignar este vínculo a una categoría para que sea más visible en la herramienta de edición de consultas.

  7. Si es necesario, la sección Reverse link definition le permite mostrar la etiqueta y el ID del recurso en el recurso de destino.

  8. Defina el comportamiento de los registros a los que hace referencia el vínculo en la sección Behavior if deleted/duplicated.

    De forma predeterminada, el registro de destino se elimina una vez que el vínculo ya no haga referencia a él.

  9. En la sección Join definition, se selecciona la opción predeterminada Use the primary keys to make the join, pero puede elegir entre dos opciones:

    • Use the primary key to make the join: esta definición de combinación le permite utilizar la clave primaria de perfiles para reconciliarse con la clave primaria de las compras.
    • Define specific join conditions: esta definición de combinación le permite seleccionar manualmente los campos que se unen a ambos recursos. Tenga en cuenta que si los datos no están correctamente configurados, el registro de compra no estará visible.

Los vínculos creados se muestran en la lista de la sección Links.

NOTE
Para conocer las prácticas recomendadas al crear índices, consulte esta sección.

Ejemplo: vincular un recurso creado con el recurso “Perfiles”

En este ejemplo, queremos vincular una nueva compra de recursos con el recurso personalizado de perfiles:

  1. Cree el nuevo recurso de compra.

  2. Para vincularlo con el recurso personalizado de perfiles, despliegue la sección Links en la pestaña Data structure y haga clic en Create element.

  3. Seleccione el recurso de destino, aquí Profiles (profile).

  4. En este ejemplo, mantenga seleccionado el tipo de vínculo 1 cardinality simple link predeterminado.

  5. Elija una definición de combinación, aquí mantenga el valor predeterminado Use the primary key to make the join.

  6. Si es necesario, puede definir una pantalla de detalles para poder editar la compra y vincularla a un perfil.

    Despliegue la sección Detail screen configuration y marque la casilla de verificación Define a detail screen para configurar la pantalla que corresponde a cada elemento del recurso. Si no marca esta casilla, no se podrá acceder a la vista detallada de los elementos de este recurso.

  7. Haga clic en Create element.

  8. Seleccione el recurso vinculado y haga clic en Add.

    El nuevo recurso está ahora disponible en el menú avanzado seleccionando Client data > Purchase.

  9. Una vez que haya terminado la configuración, haga clic en Confirm.

    Ahora puede publicar el nuevo recurso.

Al añadir este vínculo, se añade una pestaña de compra en la pantalla de detalles de perfiles del menú Profiles & audiences > Profiles. Tenga en cuenta que es algo específico del recurso Profile.

Definición de extensiones de registros de envío defining-sending-logs-extension

La extensión de registros de envío le permite:

  • ampliar las funciones de los informes dinámicos añadiendo campos personalizados de perfil
  • ampliar los datos de registros de envío con datos de código de segmento y perfil

Ampliar con un código de segmento

El usuario puede ampliar los registros con el código de segmento procedente del motor de flujos de trabajo.

El código de segmento debe definirse en el flujo de trabajo.

Para activar esta extensión, marque la opción Add segment code.

Para obtener más información sobre el código de segmento, consulte la sección Segmentación.

Ampliar con un campo de perfil

NOTE
El administrador debería haber ampliado el recurso de perfil con un campo personalizado.

Haga clic en Add field y seleccione cualquier campo personalizado del recurso de perfil.

Para generar una nueva subdimensión vinculada a la dimensión del perfil, marque la opción Add this field in Dynamic reporting as a new dimension.

Desde el sistema de informes dinámico, puede arrastrar y soltar la dimensión de campo personalizada en una tabla improvisada.

Para obtener más información sobre el sistema de informes dinámico, consulte la Lista de componentes.

IMPORTANT
El número de campos que se pueden enviar al sistema de informes dinámico está limitado a 20.

Edición de propiedades de recursos editing-resource-properties

En la pantalla de recursos personalizados, el panel Summary indica el estado del recurso recién creado. Puede administrar su acceso y sus propiedades generales.

  1. Haga clic en el botón Edit properties para añadir una descripción.

  2. Si es necesario, modifique la etiqueta y el ID del recurso.

    note note
    NOTE
    Utilice un máximo de 30 caracteres.
  3. Si necesita restringir el acceso a este recurso a ciertas unidades organizativas, especifíquelas aquí. Solo los usuarios de unidades autorizadas podrán trabajar con este recurso en la aplicación.

  4. Guarde las modificaciones.

Se han guardado las modificaciones. Debe volver a publicar el recurso para aplicarlo.

Generación de un ID único para perfiles y recursos personalizados generating-a-unique-id-for-profiles-and-custom-resources

De forma predeterminada, los perfiles y los recursos personalizados no tienen un ID empresarial cuando se crean. Puede activar una opción que genere automáticamente un ID único cuando se crean los elementos. Este ID se puede utilizar para:

  • Identificar fácilmente los registros exportados en una herramienta externa.
  • Reconciliar registros al importar datos actualizados procesados en otra aplicación.

Solo se puede habilitar para perfiles y recursos personalizados.

  1. Cree una extensión al recurso de perfiles o cree un nuevo recurso.

  2. En la definición de la estructura de datos, marque la opción Add automatic ID field, en la sección Fields.

    note note
    NOTE
    Solo los registros nuevos tendrán un ID de ACS. El campo ACS ID permanece vacío para perfiles o elementos creados antes de activar esta opción.
  3. Guarde y publique la modificación realizada en el recurso. Si desea que este mecanismo se aplique a los elementos creados mediante la API, marque la opción para ampliar la API.

El campo ACS ID ahora está disponible y se rellena automáticamente cuando se crean nuevos elementos manualmente, desde la API o insertándolos desde un flujo de trabajo de importación. El campo ID de ACS es un campo de ID de usuario único (UUID) y está indexado.

Al exportar perfiles o recursos personalizados, ahora puede añadir la columna ACS ID si se ha habilitado para ese recurso. Puede reutilizar este ID en las herramientas externas para identificar registros.

Al volver a importar datos que se han procesado o actualizado en otra aplicación (por ejemplo, un CRM), puede reconciliarlos fácilmente con este ID único.

NOTE
El campo ACS ID no se actualiza para perfiles o elementos creados antes de activar la opción. Solo los registros nuevos tendrán un ID de ACS.
Este campo está en modo de solo lectura. No se puede modificar.
recommendation-more-help
3ef63344-7f3d-48f9-85ed-02bf569c4fff