Ações com Conjuntos de Atributos

A seção com atributos está localizada na seção de configurações do projeto. Lá você encontrará uma lista de atributos, ordenados por "tipo"., assim como um formulário para criar novos atributos.

Criação de Conjuntos de Atributos

Para criar um novo conjunto de atributos, você precisa especificar o nome do atributo,

marcador

, e também o tipo do atributo. Ao clicar no botão de criação do atributo, você o verá na lista geral de atributos.

Alteração da Posição do Conjunto de Atributos

Você pode alterar a posição dos conjuntos de atributos na lista geral. Arraste o atributo que deseja mover, clicando e segurando o ícone , e depois mova esse item. As alterações serão salvas automaticamente.

Alteração dos Conjuntos de Atributos

Depois de criar um conjunto de atributos, é necessário adicionar atributos a ele, que conterão informações de conteúdo. Para entrar no modo de edição, clique no ícone de engrenagem no atributo selecionado. Na seção de edição, você pode ver os atributos já existentes, assim como um formulário para criar novos.

Você pode adicionar um atributo especificando seu nome, um marcador único, e escolhendo o tipo de dados que esse campo conterá. Um conjunto de atributos pode ter um número ilimitado de atributos. A atributos em um conjunto de atributos podem ser adicionados validadores e configurar propriedades específicas.

Dessa forma, você pode formar estruturas de dados interconectados, o que dará mais controle sobre seu projeto.

Ocultação de Conjuntos de Atributos

Você pode adicionar conjuntos de atributos a várias entidades, de acordo com seu tipo. Assim, um conjunto de atributos do tipo "Produtos" pode ser vinculado a qualquer produto, enquanto o atributo "Administradores" pode ser vinculado à entidade administrador. O sistema irá sugerir quais conjuntos de atributos você pode adicionar a cada entidade. Se durante o trabalho no projeto você quiser excluir um conjunto de atributos dessa lista de sugestões, mas não quiser removê-lo, use o ícone de olho.

Dessa forma, você pode ocultar conjuntos de atributos que perderam a relevância e que não planeja mais usar, mas que já estão sendo utilizados no projeto, o que pode dificultar sua remoção. O conjunto de atributos oculto permanecerá na lista de atributos e estará disponível para edição.

Ocultação de Atributos

Se você não quiser usar um ou mais atributos de um conjunto, eles podem ser ocultados. Ao clicar no ícone "olho" em um atributo, ele será ocultado e não será exibido junto com os outros atributos desse conjunto. Você verá esse atributo na lista geral de atributos, no entanto, ao adicioná-lo a qualquer entidade, esse atributo não será adicionado.

Remoção de Conjuntos de Atributos

Se você não precisa mais de um conjunto de atributos, pode removê-lo usando o ícone da lixeira. Confirmando a ação na janela pop-up, o atributo será removido.

 

Atributos Utilizados

Se um conjunto de atributos está sendo utilizado em seu projeto, um ícone aparecerá ao lado de seu nome na lista com a dica "não está disponível para exclusão, pois está sendo utilizado por dados". Esse conjunto não pode ser removido: o botão de exclusão em sua linha não está disponível. Clique no ícone para abrir a janela Uso do Conjunto de Atributos com a lista de entidades (produtos, páginas, formulários, etc.) que utilizam o conjunto.

A edição de um conjunto utilizado é limitada: no editor de atributos, o campo Marcador está bloqueado com a mensagem "A edição não está disponível, pois este conjunto de atributos está sendo utilizado", e na configuração do próprio conjunto, a caixa de seleção Apenas modelos não está disponível.

Remoção de Atributos

Dentro do conjunto de atributos, selecione o atributo que deseja remover e clique no ícone de remoção .

Atributos Utilizados

Ao contrário do conjunto de atributos, você pode remover um atributo que já está sendo utilizado em seu projeto. Esse atributo será removido de todas as entidades nas quais está sendo utilizado, junto com os dados armazenados nele.

Adição de Atributos

Se um conjunto de atributos não estiver vinculado a qualquer entidade, não será possível interagir com ele. Para que um conjunto de atributos possa ser trabalhado, ele precisa ser vinculado a uma entidade de acordo com seu tipo. Assim, um conjunto de atributos para produtos deve ser vinculado a um produto, e um conjunto de atributos para administradores deve ser vinculado à entidade administrador.

Para estabelecer essa conexão, é necessário ir até a entidade selecionada e, em seguida, acessar a seção de atributos. Selecione o conjunto de atributos da lista proposta pelo sistema e ele será automaticamente adicionado. Se a lista de atributos estiver vazia, significa que você não tem atributos não ocultos do tipo correspondente. Nesse caso, volte à seção de configurações de atributos e crie um.

Neste exemplo, estamos criando um conjunto de atributos para páginas. Em seguida, vamos para a seção de páginas, escolhemos a desejada e abrimos a seção de atributos. Após adicionar o conjunto de atributos, seus atributos aparecerão, e você poderá preenchê-los. O que você preencher nesses campos será vinculado à página, e você poderá acessar o conteúdo através da API em seu projeto. Os dados inseridos nos atributos podem ser validados.

Edição de Atributos

Para alterar um atributo específico de um conjunto de atributos, é necessário clicar no ícone de engrenagem na coluna Ações na lista de atributos. Na página que aparece, há quatro campos:

• Nome - campo para alterar o nome do atributo
• Marcador - campo para alterar o
  Marcador
  único
• Campos adicionais - destinado à adição de campos adicionais. Ao contrário do valor do próprio atributo, que é dinâmico, ou seja, você pode especificar valores diferentes para o mesmo atributo em diferentes
  entidades
  , o valor que você especifica em Campos adicionais é estático. Como a Platform OneEntry oferece flexibilidade para seus usuários, você pode usar Campos adicionais para diferentes propósitos. Por exemplo, adicionar um placeholder na forma de uma imagem para o atributo ou especificar valores para tooltips. A principal característica deste módulo é sua estática, ou seja, o valor que você especificar será armazenado neste atributo toda vez que você o utilizar. Também é importante entender que é possível adicionar vários campos em Campos adicionais. Para o valor de Campos adicionais, há nove tipos disponíveis:
  • String
  • Integer
  • Real
  • Float
  • Data e Hora
  • Data
  • Hora
  • Arquivo
  • Imagem
  • Json
• Regras de validação - regras para a validação do atributo. Mais detalhes sobre isso serão abordados em capítulos seguintes.

Modelos de Atributos

Você pode automatizar a seleção de atributos a cada criação de um novo documento. Para fazer isso, é necessário configurar um modelo: 1 - Nas configurações do atributo, selecione "Apenas modelos", 2 - Abra a aba "Modelos" no módulo "Configurações" e crie um novo modelo com os parâmetros necessários, 3 - Abra as configurações do modelo criado e selecione o conjunto de atributos configurado anteriormente.

Agora você pode preencher os atributos no conjunto selecionado, para que cada novo documento com o modelo escolhido seja automaticamente preenchido com os dados necessários nos atributos.

Para definir o modelo, você precisa abrir as configurações do documento necessário e escolher o seu modelo criado na lista.

Marcador Repetido

Todos os marcadores no sistema são valores únicos e não devem se repetir, portanto, quando um valor que duplica um existente é inserido, você receberá uma mensagem informando sobre a existência desse marcador e a sugestão de usá-lo no novo atributo criado.

Ao concordar em usar o marcador existente, o sistema automaticamente puxará todas as configurações do atributo (nome, validadores, campos adicionais, etc.), o que facilitará a busca futura por documentos.