Ações com conjuntos de atributos

A subseção de atributos fica nas configurações do projeto. Ela contém a lista de atributos, ordenada por tipo (abre em uma nova aba), e um formulário para criar novos atributos.

Criar conjuntos de atributos

Para criar um conjunto de atributos, informe o nome, o identificador único pelo qual é possível obter a entidade e o tipo. Depois de clicar no botão de criação, o novo conjunto aparece na lista geral de atributos.

Alterar a posição de um conjunto de atributos

Você pode mudar a posição dos conjuntos de atributos na lista geral. Clique e segure o ícone do conjunto que deseja mover e arraste-o para a nova posição. As alterações são salvas automaticamente.

Editar conjuntos de atributos

Depois de criar um conjunto de atributos, adicione a ele os atributos que vão conter as informações de conteúdo. Para entrar no modo de edição, clique no ícone de engrenagem do conjunto escolhido. A tela de edição mostra os atributos existentes e um formulário para criar novos. Acima da tabela de atributos há uma engrenagem para escolher as colunas; veja Engrenagem de colunas.

Para adicionar um atributo, informe o nome e um marcador único e escolha o tipo de dados que o campo vai conter. Não há limite para o número de atributos em um conjunto. Você pode adicionar validadores (abre em uma nova aba) aos atributos de um conjunto e configurar propriedades específicas (abre em uma nova aba).

Assim, você monta estruturas de dados relacionados e tem mais controle sobre o seu projeto.

Ocultar conjuntos de atributos

Você pode adicionar conjuntos de atributos a diferentes entidades, de acordo com o tipo delas. Por exemplo, um conjunto de atributos do tipo "Products" pode ser vinculado a qualquer produto, e um do tipo "Admins", à entidade de administrador. O sistema indica quais conjuntos de atributos podem ser adicionados a cada entidade. Se, durante o trabalho no projeto, você quiser tirar um conjunto de atributos dessa lista de sugestões sem excluí-lo, use o ícone de olho.

Assim, você pode ocultar conjuntos de atributos que perderam a relevância e que você não pretende mais usar, mas que já estão em uso no projeto, o que pode dificultar a exclusão. Um conjunto oculto continua na lista de atributos e pode ser editado.

Ocultar um atributo

Se não quiser usar um ou mais atributos de um conjunto, você pode ocultá-los. Clique no ícone de olho do atributo: ele fica oculto e deixa de ser exibido com os demais atributos do conjunto. O atributo continua visível na lista geral de atributos, mas não é adicionado quando o conjunto é adicionado a uma entidade.

Excluir conjuntos de atributos

Para excluir um conjunto de atributos de que não precisa mais, use o ícone de lixeira. Depois que você confirma a ação na janela pop-up, o conjunto é excluído.

 

Atributos em uso

Se um conjunto de atributos estiver em uso no seu projeto, aparece ao lado do nome dele na lista o ícone com a dica "is not available for deletion as it is being used by data". Esse conjunto não pode ser excluído: o botão de exclusão na linha dele fica indisponível. Clique no ícone para abrir a janela Attribute Set Usage, com a lista de entidades (produtos, páginas, formulários etc.) que usam o conjunto.

A edição de um conjunto em uso também é limitada: no editor do atributo, o campo Marker fica bloqueado com a mensagem "Editing is not available as this attribute set is being used", e nas configurações do próprio conjunto a caixa de seleção Templates only fica indisponível.

Excluir um atributo

Dentro do conjunto de atributos, escolha o atributo que deseja excluir e clique no ícone de exclusão .

Atributos em uso

Ao contrário de um conjunto de atributos, um atributo pode ser excluído mesmo que já esteja em uso no seu projeto. Ele é removido de todas as entidades em que é usado, junto com os dados armazenados nele.

Adicionar atributos

Enquanto um conjunto de atributos não estiver adicionado a alguma entidade, não é possível interagir com ele. Para trabalhar com um conjunto, vincule-o a uma entidade do tipo correspondente. Por exemplo, um conjunto de atributos para produtos deve ser vinculado a um produto, e um conjunto para administradores, à entidade de administrador.

Para fazer esse vínculo, abra a entidade desejada e vá para a subseção de atributos. Escolha um dos conjuntos de atributos sugeridos pelo sistema; ele é adicionado automaticamente. Se a lista estiver vazia, você não tem conjuntos de atributos não ocultos do tipo correspondente. Nesse caso, volte às configurações de atributos e crie um.

Neste exemplo, criamos um conjunto de atributos para páginas. Em seguida, abrimos a seção de páginas, escolhemos a página desejada e abrimos a seção de atributos. Depois que o conjunto é adicionado, os atributos dele aparecem e podem ser preenchidos. O que você preencher nesses campos fica vinculado à página, e você pode acessar esse conteúdo pela API no seu projeto. Os dados inseridos nos atributos podem ser validados.

Editar atributos

Para alterar um atributo específico de um conjunto, clique no ícone de engrenagem na coluna Actions da lista de atributos. A página que se abre tem quatro campos:

• Name: altera o nome do atributo.
• Marker: altera o identificador único pelo qual é possível obter a entidade único.
• Additional fields: permite adicionar campos extras. O valor do próprio atributo é dinâmico, ou seja, o mesmo atributo pode ter valores diferentes em diferentes páginas, blocos, formulários, eventos etc.. Já o valor que você define em Additional fields é estático. Você pode usar Additional fields para finalidades diferentes, por exemplo, para adicionar uma imagem como placeholder do atributo ou definir valores para tooltips. O principal é que esse valor é estático: o que você definir fica armazenado no atributo sempre que ele for usado. Você pode adicionar vários campos em Additional fields. Os tipos disponíveis para o valor de Additional fields são:
  • String
  • Integer
  • Real
  • Float
  • Date and Time
  • Date
  • Time
  • File
  • Image
  • Json
• Validation rules: regras de validação do atributo. Elas são descritas nos capítulos seguintes. (abre em uma nova aba)

Modelos de atributos

Você pode automatizar a escolha de atributos sempre que criar um novo documento. Para isso, configure um modelo: 1 - Nas configurações do atributo, marque "Templates only"; 2 - Abra a aba "Templates" no módulo "Settings" e crie um novo modelo com os parâmetros necessários; 3 - Abra as configurações do modelo criado e escolha o conjunto de atributos configurado antes.

Agora você pode preencher os atributos do conjunto escolhido para que cada novo documento com esse modelo já venha com os dados necessários nos atributos.

Para aplicar o modelo, abra as configurações do documento desejado e escolha na lista o modelo que você criou.

Marcador repetido

Todos os marcadores do sistema são únicos e não podem se repetir. Por isso, ao inserir um valor que já existe, você recebe uma mensagem informando que esse marcador já existe e uma sugestão para usá-lo no novo atributo.

Se você aceitar usar o marcador existente, o sistema preenche automaticamente todas as configurações do atributo (nome, validadores, campos adicionais etc.), o que facilita buscas futuras nos documentos.