참조

옷가게 쇼핑몰을 운영한다고 생각해 보세요. 상품마다 어떤 브랜드의 제품인지 적어 두고 싶습니다. 같은 브랜드 "데일리웨어"의 상품이 수십 개라면, 상품마다 브랜드 이름, 로고, 소개 글을 똑같이 다시 입력하게 됩니다. 브랜드 소개 글이 바뀌면 그 수십 개를 하나하나 고쳐야 합니다.

참조는 이 반복을 없애 줍니다. 브랜드 정보는 따로 한 번만 만들어 두고, 각 상품은 그 브랜드를 연결하기만 하면 됩니다. 같은 정보를 매번 다시 입력하지 않고 한 곳에 있는 정보를 연결해 쓰는 것, 그것이 참조입니다. 브랜드 소개 글을 한 번 고치면, 그 브랜드를 연결한 모든 상품에 한꺼번에 반영됩니다.

이 페이지에서는 한 Content를 다른 Content에 연결하는 참조가 무엇인지, 연결하면 무엇이 일어나는지, Content끼리 어떻게 이어지는지를 다룹니다.

가리키기와 베껴 적기의 차이

브랜드 정보를 상품마다 적는 방법은 두 가지로 생각해 볼 수 있습니다.

하나는 베껴 적기입니다. 상품을 만들 때마다 브랜드 이름 "데일리웨어", 브랜드 소개 글을 그 상품 안에 직접 적습니다. 상품 100개에 같은 글이 100벌 들어갑니다. 브랜드 소개가 바뀌면 100벌을 모두 찾아 고쳐야 하고, 하나라도 빠뜨리면 상품마다 다른 소개가 보이게 됩니다.

다른 하나는 가리키기입니다. 브랜드 "데일리웨어"를 Content 하나로 따로 만들어 두고, 각 상품은 그 브랜드 Content를 가리키기만 합니다. 정보는 브랜드 한 곳에만 있습니다. 소개 글을 그 한 곳에서 고치면, 그 브랜드를 가리키는 모든 상품이 같은 새 소개를 따라갑니다.

참조는 이 "가리키기"입니다. 연결을 담는 Field를 콘텐츠 스튜디오에서는 Content Reference라고 부릅니다. 상품 Content Type에 Content Reference Field를 하나 두면, 그 칸에서 브랜드 Content를 골라 연결합니다. 비유하자면, 브랜드 정보를 상품마다 손으로 옮겨 적는 대신 "이 상품의 브랜드는 저기 있는 데일리웨어"라고 화살표 하나를 그어 두는 것입니다.

연결의 모양

상품과 브랜드를 연결하면 다음과 같은 모양이 됩니다. 여러 상품이 같은 브랜드 한 곳에 연결됩니다.

상품 "스테인리스 텀블러 500ml" ──연결──▶
상품 "보온 보냉 미니 텀블러 350ml" ──연결──▶   브랜드 "데일리웨어"
상품 "휴대용 접이식 물병 600ml" ──연결──▶

브랜드 "데일리웨어"는 한 번만 만들어 두고, 텀블러도 물병도 모두 이 한 곳에 연결됩니다. 브랜드 소개 글을 데일리웨어 Content에서 한 번 고치면, 위 세 상품이 모두 새 소개를 따라갑니다.

연결은 Content 사이뿐 아니라 Content에서 Media(올린 이미지·영상 같은 파일)로도 만들 수 있습니다. 상품에 대표 사진을 붙이는 것이 그 예입니다. 이 페이지는 Content끼리 잇는 경우를 다룹니다. Media를 붙이는 방법은 Media에서 다룹니다.

연결하면 무엇이 따라오나

상품에 브랜드를 연결해 두면, 상품 정보를 가져올 때 연결된 브랜드 정보를 함께 가져올 수 있습니다. 텀블러 상품을 화면에 보여 줄 때, 그 상품에 연결된 브랜드 "데일리웨어"의 이름과 소개 글까지 한 번에 따라옵니다. 상품 쪽에 브랜드 정보를 베껴 두지 않았는데도, 연결을 따라가 브랜드 한 곳에서 값을 읽어 오기 때문입니다.

그래서 브랜드 정보는 늘 한 곳, 브랜드 Content에만 두면 됩니다. 상품을 읽을 때마다 그 시점의 브랜드 정보가 연결을 따라 함께 옵니다. 브랜드를 고치면 다음에 상품을 읽을 때 고친 내용이 따라옵니다.

연결된 Content를 어디까지 함께 가져올지, 어떤 요청으로 가져올지에 대한 자세한 형식은 API 레퍼런스에서 다룹니다. 콘텐츠 스튜디오에서는 연결만 해 두면 됩니다.

연결할 수 있는 종류 정하기

Content Reference Field에는 "이 칸에는 어떤 Content만 연결할 수 있다"는 제한을 걸 수 있습니다. 상품의 브랜드 칸이라면, 아무 Content나 들어오면 곤란합니다. 후기나 공지가 실수로 브랜드 자리에 연결되면 안 되기 때문입니다.

그래서 이 칸에는 "브랜드" Content Type으로 만든 Content만 연결할 수 있게 정해 둘 수 있습니다. 이렇게 해 두면 브랜드 칸에서 고를 수 있는 것이 브랜드들로 한정되고, 다른 종류의 Content는 연결되지 않습니다. 연결할 수 있는 Content Type은 여러 개를 함께 허용할 수도 있습니다. 예를 들어 한 칸에 "브랜드"와 "협력사"를 모두 허용해, 둘 중 어느 쪽이든 연결하게 할 수 있습니다.

이 제한은 Content Reference Field의 상세 설정에서 정합니다. 유효성 검사에서 참조 Content Type을 켜고, 허용할 Content Type으로 "브랜드"를 고르면 됩니다.

이 제한은 저장하거나 발행할 때 검사됩니다. 허용한 Content Type이 아닌 Content를 연결하면 저장이 막히고, 연결해 둔 Content가 그 사이에 삭제되어 더는 찾을 수 없으면 역시 검사에서 걸립니다. 잘못 이어진 연결이 쌓이는 것을 막아 주는 장치입니다.

한 칸에 여러 개 연결하기

상품 하나에 브랜드를 하나만 연결하면 충분할 때가 많습니다. 하지만 한 칸에 여러 개를 연결하고 싶을 때도 있습니다. 예를 들어 "이 상품과 함께 보면 좋은 상품" 칸에는 관련 상품 여러 개를 이어 두고 싶습니다.

이때는 Content Reference Field를 목록 타입으로 사용으로 설정합니다. 그러면 한 칸에 여러 Content를 연결할 수 있습니다. "함께 보면 좋은 상품" 칸에 텀블러, 물병, 보온병을 모두 연결해 두는 식입니다. 목록 타입으로 사용할 때도 연결할 수 있는 종류 제한은 똑같이 걸 수 있습니다.

"상품"에 브랜드 연결 칸 만들기

상품이 브랜드를 연결하게 하려면, "상품" Content Type에 Content Reference 종류의 Field를 추가합니다. Field를 추가하는 방법은 Content 모델링에서 다룹니다. Field 종류를 고르는 화면에서 Content Reference를 고른 뒤, 위에서 본 "연결할 수 있는 종류"를 "브랜드"로 정하면 됩니다.

연결할 대상이 있어야 이을 수 있으므로, 그 전에 브랜드 쪽을 먼저 준비해 둡니다.

1. "브랜드" Content Type을 만드세요. 브랜드 이름, 소개 글 같은 Field를 넣습니다.
2. "브랜드" Content Type으로 브랜드 Content "데일리웨어"를 하나 만드세요.
3. "상품" Content Type에 Content Reference Field를 추가하고, 연결할 수 있는 종류를 "브랜드"로 정하세요.
4. 상품 "스테인리스 텀블러 500ml"을 열고 편집을 누르세요.
5. 브랜드 칸의 기존 Content 추가를 누르세요. Content 선택 창이 열립니다.
6. 목록에서 "데일리웨어"를 골라 연결하세요.

Content 선택 창에는 연결할 수 있는 종류로 정해 둔 "브랜드"만 나옵니다. 앞에서 건 제한이 여기에서 그대로 적용되는 것입니다.

이제 텀블러 상품이 브랜드 "데일리웨어"에 연결됐습니다. 다른 상품에서도 같은 칸에서 "데일리웨어"를 고르면, 여러 상품이 한 브랜드에 함께 연결됩니다.

연결을 다룰 때 알아 둘 것

연결한 Content가 사라지면 검사에서 걸립니다. 상품이 연결해 둔 브랜드 Content를 삭제하면, 상품의 브랜드 칸은 더는 찾을 수 없는 Content를 연결한 상태가 됩니다. 이 상태로는 상품을 저장하거나 발행할 때 검사에서 막힙니다. 다른 브랜드를 다시 연결하거나, 그 칸이 필수가 아니라면 비운 뒤에 다시 시도하면 됩니다.

연결한다고 두 Content가 하나로 합쳐지는 것은 아닙니다. 상품과 브랜드는 따로따로 Content로 남아 있습니다. 상품을 지워도 브랜드 Content는 그대로 남고, 브랜드를 고쳐도 상품 Content 자체는 그대로입니다. 바뀌는 것은 연결을 따라 함께 읽어 오는 값뿐입니다.

다음으로 할 일

• Content 모델링: "상품" Content Type에 Content Reference Field를 추가하는 방법을 다룹니다.
• Media: 상품에 대표 사진 같은 Media를 붙이는 방법을 다룹니다.
• 상태와 발행: 연결한 Content를 발행해 외부에 공개하는 단계를 다룹니다.
• API 레퍼런스: 연결된 Content를 함께 가져오는 요청 형식과 연결을 담는 Refer 항목 구조를 프로그램에서 직접 다룰 때 참고합니다.