Referência

Imagine que você administra uma loja de roupas online. Para cada produto, você quer registrar a qual marca ele pertence. Se a marca "DailyWear" tem dezenas de produtos, você acaba digitando o mesmo nome de marca, o mesmo logotipo e o mesmo texto de apresentação em cada produto. E quando o texto de apresentação da marca muda, você precisa corrigir essas dezenas um por um.

A referência elimina essa repetição. A informação da marca é criada uma única vez, à parte, e cada produto só precisa vincular essa marca. Em vez de digitar a mesma informação toda vez, você vincula a informação que está em um único lugar: é isso que é a referência. Ao corrigir o texto de apresentação da marca uma vez, a mudança se aplica de uma só vez a todos os produtos que vincularam essa marca.

Esta página trata do que é a referência que vincula um Content a outro Content, do que acontece quando você os vincula e de como os Content se ligam entre si.

A diferença entre apontar e copiar

Há duas maneiras de pensar em registrar a informação da marca em cada produto.

Uma é copiar. Cada vez que você cria um produto, escreve o nome da marca "DailyWear" e o texto de apresentação da marca diretamente dentro desse produto. Cem produtos guardam cem cópias do mesmo texto. Quando a apresentação da marca muda, você precisa encontrar e corrigir todas as cem cópias, e se deixar passar uma só, esse produto passa a mostrar uma apresentação diferente.

A outra é apontar. Você cria a marca "DailyWear" como um único Content à parte, e cada produto apenas aponta para esse Content de marca. A informação fica em um único lugar: a marca. Ao corrigir o texto de apresentação nesse único lugar, todos os produtos que apontam para a marca acompanham a mesma apresentação nova.

A referência é esse "apontar". O Field que contém o vínculo é chamado de Content Reference no estúdio de conteúdo. Ao colocar um Field Content Reference no Content Type do produto, você escolhe nesse campo o Content de marca para vincular. Em outras palavras, em vez de transcrever à mão a informação da marca em cada produto, você desenha uma única seta que diz "a marca deste produto é aquela DailyWear ali".

A forma do vínculo

Quando você vincula um produto e uma marca, o resultado tem a forma a seguir. Vários produtos são vinculados a uma mesma marca, em um único lugar.

Produto "Copo Térmico de Aço Inox 500ml" ──vincular──▶
Produto "Mini Copo Térmico 350ml" ──vincular──▶   Marca "DailyWear"
Produto "Garrafa de Água Dobrável 600ml" ──vincular──▶

A marca "DailyWear" é criada uma única vez, e tanto os copos quanto a garrafa são todos vinculados a esse único lugar. Ao corrigir o texto de apresentação da marca uma vez no Content DailyWear, os três produtos acima acompanham a nova apresentação.

O vínculo pode ser feito não apenas entre Content, mas também de um Content para uma Media (arquivos enviados, como imagens e vídeos). Anexar uma foto principal a um produto é um exemplo disso. Esta página trata do caso em que se ligam Content entre si. Como anexar Media é tratado em Media.

O que vem junto quando você vincula

Se você deixar uma marca vinculada a um produto, ao trazer a informação do produto pode trazer junto a informação da marca vinculada. Ao exibir o produto copo na tela, o nome e o texto de apresentação da marca "DailyWear" vinculada a ele vêm junto de uma só vez. Mesmo sem ter copiado a informação da marca para o lado do produto, os valores são lidos no único lugar onde a marca está, seguindo o vínculo.

Por isso a informação da marca pode ficar sempre em um só lugar: o Content de marca. Cada vez que o produto é lido, a informação da marca daquele momento vem junto, seguindo o vínculo. Ao corrigir a marca, na próxima vez que o produto for lido, o conteúdo corrigido vem junto.

O formato detalhado de até onde o Content vinculado é trazido junto e de qual requisição o traz é tratado na referência da API. No estúdio de conteúdo, basta deixar o vínculo feito.

Definir os tipos que podem ser vinculados

Em um Field Content Reference você pode aplicar a restrição "neste campo só certos Content podem ser vinculados". No campo de marca de um produto, não convém que qualquer Content entre, porque uma avaliação ou um aviso não deve ser vinculado por engano no lugar da marca.

Por isso você pode definir que nesse campo só seja possível vincular Content criados com o Content Type "Marca". Com isso, o que se pode escolher no campo de marca fica limitado às marcas, e outros tipos de Content não são vinculados. Também é possível permitir vários Content Type juntos para vínculo. Por exemplo, é possível permitir em um único campo tanto "Marca" quanto "Parceiro", para que qualquer um dos dois possa ser vinculado.

Essa restrição é definida nas configurações detalhadas do Field Content Reference. Em Validações, ative Aceitar apenas Content Type especificado e escolha "Marca" como o Content Type permitido.

Essa restrição é verificada ao salvar ou publicar. Se você vincular um Content que não seja de um Content Type permitido, o salvamento é bloqueado, e se o Content vinculado for excluído nesse meio-tempo e não puder mais ser encontrado, isso também é apanhado na verificação. É um mecanismo que impede o acúmulo de vínculos feitos por engano.

Vincular vários itens em um campo

Vincular apenas uma marca a um produto costuma ser suficiente. Mas há momentos em que você quer vincular vários itens em um único campo. Por exemplo, no campo "Produtos que combinam com este" você quer deixar ligados vários produtos relacionados.

Nesse caso, configure o Field Content Reference como Usar como tipo de lista. Assim você pode vincular vários Content em um único campo, como deixar o copo, a garrafa e a garrafa térmica todos vinculados no campo "Produtos que combinam com este". Mesmo ao usar o tipo lista, a restrição sobre os tipos que podem ser vinculados pode ser aplicada da mesma forma.

Criar o campo de vínculo de marca em "Produto"

Para que um produto possa vincular uma marca, adicione um Field do tipo Content Reference ao Content Type "Produto". Como adicionar um Field é tratado em Modelagem de Content. Na tela em que você escolhe o tipo de Field, escolha Content Reference e, em seguida, defina como "Marca" os "tipos que podem ser vinculados" vistos acima.

Como é preciso ter um alvo para o vínculo antes de ligar, prepare antes o lado da marca.

1. Crie o Content Type "Marca". Inclua Field como o nome da marca e o texto de apresentação.
2. Crie um Content de marca, "DailyWear", com o Content Type "Marca".
3. Adicione um Field Content Reference ao Content Type "Produto" e defina os tipos que podem ser vinculados como "Marca".
4. Abra o produto "Copo Térmico de Aço Inox 500ml" e clique em Editar.
5. Clique em Adicionar Content Existente no campo de marca. A janela Selecionar Content se abre.
6. Escolha "DailyWear" na lista e vincule.

A janela Selecionar Content mostra apenas a "Marca" que você definiu como o tipo que pode ser vinculado. A restrição definida antes se aplica aqui diretamente.

Agora o produto copo está vinculado à marca "DailyWear". Se em outros produtos você também escolher "DailyWear" no mesmo campo, vários produtos ficam vinculados juntos a uma única marca.

O que saber ao trabalhar com vínculos

Se o Content vinculado desaparecer, é apanhado na verificação. Se você excluir um Content de marca que um produto vinculou, o campo de marca do produto fica com um Content que não pode mais ser encontrado vinculado. Nesse estado, salvar ou publicar o produto é bloqueado na verificação. Vincule outra marca novamente ou, se esse campo não for obrigatório, esvazie-o e tente de novo.

Vincular não faz com que os dois Content se fundam em um só. O produto e a marca permanecem como Content separados. Mesmo que você exclua o produto, o Content de marca permanece intacto, e mesmo que você corrija a marca, o próprio Content do produto permanece intacto. O que muda é apenas o valor lido junto seguindo o vínculo.

O que fazer em seguida

• Modelagem de Content: trata de como adicionar um Field Content Reference ao Content Type "Produto".
• Media: trata de como anexar Media, como uma foto principal, a um produto.
• Estados e publicação: trata da etapa de publicar um Content vinculado para torná-lo visível externamente.
• Referência da API: consulte quando for trabalhar diretamente em um programa com o formato da requisição que traz junto o Content vinculado e com a estrutura do item Refer que contém o vínculo.