Acciones con conjuntos de atributos

La sección de atributos está en la configuración del proyecto. Contiene la lista de atributos, ordenados por "tipo" (se abre en una pestaña nueva), y un formulario para crear atributos nuevos.

Creación de conjuntos de atributos

Para crear un conjunto de atributos, indique el nombre del atributo, el identificador único con el que se puede obtener la entidad y el tipo de atributo. Al hacer clic en el botón de creación, el atributo aparecerá en la lista general de atributos.

Cambio de posición de un conjunto de atributos

Puede cambiar el orden de los conjuntos de atributos en la lista general. Mantenga presionado el ícono del atributo que quiere mover y arrástrelo a su nueva posición. Los cambios se guardan automáticamente.

Modificación de conjuntos de atributos

Después de crear un conjunto de atributos, agréguele los atributos que contendrán la información de contenido. Para abrir el modo de edición, haga clic en el ícono de engranaje del atributo elegido. En la sección de edición verá los atributos existentes y un formulario para crear otros nuevos. Sobre la tabla de atributos hay un engranaje para elegir las columnas (consulte Engranaje de columnas).

Para agregar un atributo, indique su nombre y un marcador único, y elija el tipo de datos que contendrá el campo. Un conjunto de atributos puede tener un número ilimitado de atributos. A los atributos de un conjunto puede agregarles validadores (se abre en una pestaña nueva) y configurarles propiedades específicas (se abre en una pestaña nueva).

Así puede crear estructuras de datos relacionadas, lo que le da más control sobre su proyecto.

Ocultación de conjuntos de atributos

Puede agregar conjuntos de atributos a distintas entidades según su tipo. Por ejemplo, un conjunto de atributos de tipo "Products" se puede vincular a cualquier producto, y uno de tipo "Admins", a la entidad de administrador. El sistema le indica qué conjuntos de atributos puede agregar a cada entidad. Si durante el trabajo con el proyecto quiere quitar un conjunto de atributos de esta lista de sugerencias sin eliminarlo, use el ícono del ojo.

Así puede ocultar conjuntos de atributos obsoletos que ya no piensa usar, pero que ya se usan en el proyecto, lo que puede dificultar su eliminación. El conjunto oculto sigue en la lista de atributos y se puede editar.

Ocultación de un atributo

Si no quiere usar uno o varios atributos de un conjunto, puede ocultarlos. Al hacer clic en el ícono del ojo de un atributo, este se oculta y deja de mostrarse junto con los demás atributos del conjunto. Seguirá viendo el atributo en la lista general de atributos, pero no se agregará cuando agregue el conjunto a una entidad.

Eliminación de conjuntos de atributos

Si ya no necesita un conjunto de atributos, elimínelo con el ícono de la papelera. Confirme la acción en la ventana emergente y el atributo se eliminará.

 

Atributos en uso

Si un conjunto de atributos se usa en su proyecto, junto a su nombre en la lista aparece el ícono con la sugerencia «is not available for deletion as it is being used by data». Ese conjunto no se puede eliminar: el botón de eliminación de su fila no está disponible. Haga clic en el ícono para abrir la ventana Attribute Set Usage, con la lista de entidades (productos, páginas, formularios, etc.) que usan el conjunto.

La edición de un conjunto en uso también está limitada: en el editor de atributos, el campo Marker está bloqueado con el mensaje «Editing is not available as this attribute set is being used», y en la configuración del propio conjunto la casilla Templates only no está disponible.

Eliminación de un atributo

Dentro del conjunto de atributos, busque el atributo que quiere eliminar y haga clic en el ícono de eliminación .

Atributos en uso

A diferencia de un conjunto de atributos, puede eliminar un atributo que ya se usa en su proyecto. El atributo se eliminará de todas las entidades que lo usan, junto con los datos que contiene.

Adición de atributos

Mientras un conjunto de atributos no esté agregado a ninguna entidad, no se puede trabajar con él. Para poder usarlo, debe vincularlo a una entidad de su tipo. Por ejemplo, un conjunto de atributos para productos debe vincularse a un producto, y uno para administradores, a la entidad de administrador.

Para vincularlo, abra la entidad elegida y vaya a su subsección de atributos. Seleccione uno de los conjuntos de atributos que propone el sistema y se agregará automáticamente. Si la lista está vacía, no tiene atributos no ocultos del tipo correspondiente. En ese caso, vuelva a la configuración de atributos y cree uno.

En este ejemplo creamos un conjunto de atributos para páginas. Luego vamos a la sección de páginas, elegimos la página que necesitamos y abrimos su sección de atributos. Al agregar el conjunto aparecen sus atributos, que puede rellenar. Lo que introduzca en estos campos queda vinculado a la página, y podrá acceder a ese contenido a través de la API en su proyecto. Los datos introducidos en los atributos se pueden validar.

Edición de atributos

Para cambiar un atributo concreto de un conjunto, haga clic en el ícono de engranaje en la columna de acciones de la lista de atributos. La página que se abre tiene cuatro campos:

• Name: el nombre del atributo.
• Marker: el identificador único con el que se puede obtener la entidad único.
• Additional fields: para agregar campos adicionales. El valor del atributo es dinámico, es decir, el mismo atributo puede tener valores distintos en distintas páginas, bloques, formularios, eventos, etc.. En cambio, el valor que indique en Additional fields es estático. Puede usar Additional fields con distintos fines, por ejemplo, para agregar una imagen como placeholder del atributo o para indicar los textos de los tooltips. Su característica principal es que es estático: el valor que indique se conserva en el atributo cada vez que lo use. En Additional fields puede agregar varios campos. Los valores de Additional fields pueden ser de estos tipos:
  • String
  • Integer
  • Real
  • Float
  • Date and Time
  • Date
  • Time
  • File
  • Image
  • Json
• Validation rules: reglas de validación del atributo. Se describen en los capítulos siguientes. (se abre en una pestaña nueva)

Plantillas de atributos

Puede automatizar la selección de atributos para cada documento nuevo que cree. Para ello, configure una plantilla: 1 - En la configuración del atributo, marque "Templates only", 2 - Abra la pestaña "Templates" del módulo "Settings" y cree una plantilla con los parámetros necesarios, 3 - Abra la configuración de la plantilla creada y elija el conjunto de atributos que configuró antes.

Ahora puede rellenar los atributos del conjunto elegido para que cada documento nuevo con esa plantilla tenga ya los datos necesarios en sus atributos.

Para asignar la plantilla, abra la configuración del documento y elija su plantilla en la lista.

Marcador repetido

Todos los marcadores del sistema son únicos y no deben repetirse. Si introduce un valor que ya existe, verá un mensaje que lo indica y le propone usar ese marcador en el atributo nuevo.

Si acepta usar el marcador existente, el sistema carga automáticamente toda la configuración del atributo (nombre, validadores, campos adicionales, etc.), lo que simplifica las búsquedas posteriores en los documentos.