cq5 content models: the tags « contentGoesHere

Posted by Bertrand Delacretaz APR 23, 2009

Posted in contentmodels, cq5 and jcr Comments 9

cq5 content models: the tags

In software engineering, modularity often leads to hard choices when it comes to how big or small things should be. In a JCR content repository, the question is how granular should my content be?. A more granular structure contains more information, but too much granularity might slow things down.

Inside a JCR node, we can create a simple or complex hierachy of content atoms and metadata. But how far should we go? Should we think in terms of files, mini-databases, or simple name-value pairs?

JCR beginners often have a hard time figuring out the best content models for their problem, so we thought we'd share some of our experience here.

Starting with this post, we will explain some of the cq5 content structures. Without going into theoretical details - just by describing and explaining those structures.

Today, we'll have a look at the cq5 tags, used as semi-structured metadata, mostly for content pages. In cq5, tags like stockphotography/animals/birds can be added to content pages. Tags belong to namespaces (stockphotography in our example), and can be arranged hierarchically within their namespace.

cq5 tags - user view

Looking at the tags from the cq5 site admin console, we see a simple tree of concepts,grouped in namespaces (Marketing) and categories (Interest). Each tag has a unique TagID, visible in the first column on the right, that will later be used to connect content with those tags.

Nothing surprising here, except maybe the fact that our tags live in a hierarchical space,as opposed to a flat one. This creates simple namespaces for our tags, allowing several "worlds"of tags to be combined without conflicts.

How are we going to store this in JCR? In cq5, the tags are stored as a tree of JCR nodes,with a structure similar to the above one, using the cq:Tag node type. The content model simply reflects the reality of the tags and their natural organization.

The cq:Tag node type

Here's the definition of the cq:Tag node type in CQ5.2:

The tag node is required to have a sling:resourceType property with a default value of tagging/tag. That property is used by the Sling rendering system to select the appropriate components to render the tags, in the cq5 site admin console for example.

The node can contain nt:base child nodes which have the cq:Tag type by default. The cq:Tag node can also contain any number of additional ("residual" in JCRspeak) properties, single or multi-valued.

The cq:Tag node type also uses the mix:title mixin, which defines two optional String properties,jcr:title and jcr:description. The jcr:title property is used to allow tags to be renamed without changing their identifier. The cq5 user interface displays the jcr:title value, which can change over time,but it's the path of the cq:Tag node that is used as the tag identifier.

There's no specific node type for tag namespaces: a cq:Tag node that doesn't have a cq:Tag parent is considered as being a namespace. In cq5, tag definitions are stored under /etc/tags, and that node is not a cq:Tag, so cq:Tag child nodes like /etc/tags/marketing define tag namespaces.

At Day we like to keep things open whenever possible: the cq:Tag node type is not designed to put strong constraints on the content, and that's inline with David's model rule #1:

Data First, Structure Later. Maybe

We haven't reached the maybe stage yet.The cq:Tag node type is clearly here to help, not to restrict what we can do.

Tags content model

Switching to the CRX Explorer, we notice that the tree structure under /etc/tags simply maps the namespace/category/tag structure of our tags. Nothing surprising again, and that's a good thing. Obvious content structures will help others understand what we're doing.

Looking at the properties of the /etc/tags/stockphotography/animals/baby_animals node,we see that the TagId property that's visible in the cq5 site admin console is not explicitely stored in the content - it is simply defined by the storage path of the tag node under /etc/tags, to avoid redundant information.

Don't you love the Principle of Least Surprise?

At this point you're probably thinking that all this is quite obvious - and you're right! The beauty of a JCR content repository is that you can in most cases store information without any structural transformations. Tags are items grouped in namespaces and categories, so a tree of namespace/category/tag nodes makes perfect sense, and is largely self-explaining.

Tagging content

To tag content, we simply add a multi-value tags property to the jcr:contentnodes of cq5 pages, or to other pieces of content. A page might have:

cq:tags =
[

marketing:interest/business,
marketing:interest/investor,
marketing:interest/services
]

if it was tagged with the business, investor, services tags of the interest category of the marketing namespace.

We don't use JCR references, but simply store paths in properties, as this gives us more flexibility when restructuring things. It's hard to say what will happen to those tags, and to the very concept of tagging, over the expected lifetime of our product, so we accept potentially dangling references (and cope with them at the application level) to gain content agility.

Coda

That's it for now! We hope to write more about our content models in the near future, to help our readers see how simple JCR content models can be - and should be.

As usual, feedback is very welcome - let us know if this information is useful to you!

COMMENTS

By Christian Sprecher - 4:38 PM on Apr 23, 2009 Reply
Just out of curiosity: Is this tag concept part of a broader taxonomy model within CQ5? And what is your (resp. Day's) stance reg. "auto-tagging"? Is it worth it?.
By Bertrand Delacretaz - 9:20 AM on Apr 24, 2009 Reply
@Christian, the tags *are* the taxonomy, we use a few (Sling/OSGi) tagging services to manage them and the tagged content. IMO, auto-tagging can be very useful...once that works! We are exploring options, especially in the context of the IKS project [1]. One could either try to extract all tags from content, or just suggest additional tags based on the tags that you select. The latter might give better results for now, until content extraction algorithms are good enough for arbitrary content. I *think* some or our customers already do auto-tagging or something similar, tuned to their types of content and vocabularies. The problem is much simpler with a controlled vocabulary than with unrestricted content, of course. [1] http://dev.day.com/microsling/content/blogs/main/iksfirst3.html
By Renaud Richardet - 9:34 PM on May 02, 2009 Reply
Thanks Bertrand for the clear explanation. In terms of performance, how does it scale up when one queries for all documents with the tag "marketing:interest/services"?
By Bertrand Delacretaz - 10:29 AM on May 04, 2009 Reply
Hi Renaud, as the path of the tag "marketing:interest/services" is stored as a property of each document that has that tag, the query is quite efficient and scalable. I'm not an expert in JCR query performance, but I would assume that looking for all nodes that have a property with a specific string value is fast. That's certainly the case in Jackrabbit which uses Lucene's inverted indexes.
By Bertrand Delacretaz - 1:49 PM on Jul 06, 2010 Reply
In the meantime we have started work on autotagging as part of the IKS FISE project, see http://wiki.iks-project.eu/index.php/FISE
By air maxes 90 - 8:45 AM on Mar 02, 2012 Reply
Dnssb specialize in world-famous brands <A href="http://www.cheaphotjordan.com/">Cheap Jordan Shoes</A> of in-style and

fashionable shoes, Apparels, jeans, <A href="http://www.cheaphotjordan.com/">black jordans</A> polular handbags, blets and

purses,etc. You can buy cheap cloting,<A href="http://www.cheapjeremyscotty.com/">Jeremy Scott Shoes</A>nike sneakers ,cheap <A

href="http://www.cheaphotjordan.com/">womens jordan shoes</A> Jordan shoes,<A href="http://www.cheapjswings.com/">jeremy scott x

adidas</A> athletic shoes,cheap dunks,<A href="http://www.cheapjeremyscotty.com/">Adidas Wings Shoes</A> max shoes,nike shox,<A

href="http://www.cheapjswings.com/">jeremy scott bear</A> Adidas, Reebok, Puma, new nfl Jerseys, and other popular brand name

shoes of high quality cheap price here! The most important <A href="http://www.cheaphotjordan.com/">cheap air jordan shoes</A>

thing, we can offer you the lowest price and the best service for you----the professional team, the most speed. With high quality

products and <A href="http://www.cheaphotjordan.com/">jordan sneakers</A> a sophisticated customer service system, Dnssb.com has

earned the<A href="http://www.cheaphotjordan.com/air-jordan-shoes-c-1.html">Air Jordan Shoes</A> best reputation <A

href="http://www.cheapjeremyscotty.com/jeremy-scott-wings-hoodie-c-36.html">Jeremy Scott wings Hoodie</A>among the online stores.

<A href="http://www.cheaphotjordan.com/air-jordan-2011-c-1_43.html">Air Jordan 2011</A> We are a well managed corporation and <A

href="http://www.cheaphotjordan.com/air-jordan-2-c-1_3.html">Air Jordan 2</A> the one company you can trust with all your needs.

You never <A href="http://www.cheaphotjordan.com/air-jordan-14-c-1_15.html">Air Jordan 14</A>need to browse the whole mall and

wait in line at a crowded store to deal with bored salespeople in order to get the latest and hottest styles.Otherwise we can

offer <A href="http://www.cheapjeremyscotty.com/">Jeremy Scott Wings Shoes</A>the the <A href="http://www.cheaphotjordan.com/air-

jordan-21-c-1_22.html">Air Jordan 21</A>free shipping if you can buy to the certain<A href="http://www.cheaphotjordan.com/nike-

air-max-shoes-c-35.html">Nike Air <A href="http://www.cheapjswings.com/adidas-football-boots-c-83.html">Adidas Football Boots</A>

quantity have the easy safe payment ways like<A href="http://www.cheapjswings.com/adidas-jermey-scott-c-66.html">Adidas Jermey

Scott</A> the credit <A href="http://www.cheapjeremyscotty.com/jeremy-scott-teddy-bear-c-33.html">Jeremy Scott Teddy

Bear</A>cards.I am sure you can find the Newest, cheapest and high quality product here. All of our products<A

href="http://www.cheaphotjordan.com/nike-air-stab-shoes-c-37.html">Nike Air Stab Shoes</A> The fields of physical fitness and shoe

design have pooled their resources to create Vibram Five Fingers. The Vibram line is a revolutionary new type of footwear. Unlike

other athletic shoes, Vibram Five Fingers is based off of the bare human foot, bringing unparalleled flexibility, comfort, and

balance to its wearer.While often <A href="http://www.cheaphotfivefingers.com/">vibram five finger</A> overlooked, toes <A

href="http://www.cheaphotfivefingers.com/">five fingers shoes</A> actually play an important role in keeping balance. This<A

href="http://www.cheaphotfivefingers.com/vibram-five-fingers-mens-shoes-c-75.html">Vibram Five Fingers Men's Shoes</A> is why

Vibram's unique shape offers so many benefits. Much<A href="http://www.cheaphotfivefingers.com/vibram-five-fingers-mens-shoes-

vibram-five-fingers-mens-flow-c-75_77.html">Vibram Five Fingers Men's Flow</A> like a glove, there's a section for each toe,

allowing the wearer to wiggle and spread his or her toes as if barefoot. The <A href="http://www.cheaphotfivefingers.com/vibram-

five-fingers-mens-shoes-vibram-five-fingers-mens-sprint-c-75_79.html">Vibram Five Fingers Men's Sprint</A> design also works to

enhance body awareness, allowing the athlete to perform at full capacity. Vibram FiveFingers also improve posture by evenly

distributing the wearer's body weight.
By jone - 3:46 PM on Mar 26, 2012 Reply
<a href="http://www.topbrandshoe.com/"> cheap Men Dunk Shoes </a>
<a href="http://www.topbrandshoe.com/"> cheap Dunk shoes </a>
<a href="http://www.topbrandshoe.com/"> Cheap women Dunk </a>
<a href="http://www.topbrandshoe.com/"> Cheap Dunk sneakers </a>
<a href="http://www.topbrandshoe.com/"> Cheap Dunk SB </a>
<a href="http://www.topbrandshoe.com/"> Cheap SB sneakers </a>
<a href="http://www.topbrandshoe.com/"> Cheap men Dunk </a>
<a href="http://www.topbrandshoe.com/"> fashion Dunk </a>
<a href="http://www.tobrandshoe.com/"> fashion Nike Dunk </a>
<a href="http://www.topbrandshoe.com/"> fashion Dunk shoes </a>
<a href="http://www.topbrandshoe.com/"> fashion women Dunk </a>
<a href="http://www.topbrandshoe.com/"> fashion Dunk sneakers </a>
<a href="http://www.topbrandshoe.com/"> fashion Dunk SB </a>
<a href="http://www.topbrandshoe.com/"> fashion SB sneakers </a>
<a href="http://www.topbrandshoe.com/"> fashion men Dunk </a>
<a href="http://www.topbrandshoe.com/"> discount Nike Dunk </a>
<a href="http://www.topbrandshoe.com/"> discount Dunk </a>
<a href="http://www.topbrandshoe.com/"> discount Nike Dunk </a>
<a href="http://www.topbrandshoe.com/"> discount Dunk shoes </a>
<a href="http://www.topbrandshoe.com/"> discount women Dunk </a>
<a href="http://www.topbrandshoe.com/"> discount Dunk sneakers </a>
<a href="http://www.topbrandshoe.com/"> discount Dunk SB </a>
<a href="http://www.topbrandshoe.com/"> discount SB sneakers </a>
<a href="http://www.topbrandshoe.com/"> discount men Dunk </a>
<a href="http://www.topbrandshoe.com/"> nike dunk on sale </a>
<a href="http://www.topbrandshoe.com/"> nike dunk for sale </a>
<a href="http://www.topbrandshoe.com/"> nike dunk free shipping </a>
<a href="http://www.topbrandshoe.com/"> dunk on sale </a>
<a href="http://www.topbrandshoe.com/"> dunk free shipping </a>
<a href="http://www.topbrandshoe.com/"> Cheap Nike Dunk Shoes </a>
<a href="http://www.topbrandshoe.com/">Women Nike Dunk SB Shoes</a>
<a href="http://www.topbrandshoe.com/"> Nike SB Shoes </a>
<a href="http://www.topbrandshoe.com/"> Nike Dunk Sneakers </a>
<a href="http://www.topbrandshoe.com/"> Nike SB Sneakers </a>
<a href="http://www.topbrandshoe.com/"> Nike Dunk High Top </a>
<a href="http://www.topbrandshoe.com/"> Nike Dunk shoes </a>
By jone - 3:47 PM on Mar 26, 2012 Reply
[url=http://www.topbrandshoe.com] cheap Men Dunk Shoes [/url]
[url=http://www.topbrandshoe.com] Cheap women Dunk [/url]
[url=http://www.topbrandshoe.com] Cheap Dunk sneakers [/url]
[url=http://www.topbrandshoe.com] Cheap Dunk SB [/url]
[url=http://www.topbrandshoe.com] Cheap SB sneakers [/url]
[url=http://www.topbrandshoe.com] fashion Dunk [/url]
[url=http://www.topbrandshoe.com] fashion Nike Dunk [/url]
[url=http://www.topbrandshoe.com] fashion Dunk shoes [/url]
[url=http://www.topbrandshoe.com] fashion women Dunk [/url]
[url=http://www.topbrandshoe.com] fashion Dunk sneakers [/url]
[url=http://www.topbrandshoe.com] fashion men Dunk [/url]
[url=http://www.topbrandshoe.com] discount Nike Dunk [/url]
[url=http://www.topbrandshoe.com] discount Dunk [/url]
[url=http://www.topbrandshoe.com] discount Nike Dunk [/url]
[url=http://www.topbrandshoe.com] discount women Dunk [/url]
[url=http://www.topbrandshoe.com] discount Dunk sneakers [/url]
[url=http://www.topbrandshoe.com] discount Dunk SB [/url]
[url=http://www.topbrandshoe.com] discount men Dunk [/url]
[url=http://www.topbrandshoe.com] nike dunk on sale [/url]
[url=http://www.topbrandshoe.com] nike dunk for sale [/url]
[url=http://www.topbrandshoe.com] nike dunk free shipping [/url]
[url=http://www.topbrandshoe.com] dunk free shipping [/url]
[url=http://www.topbrandshoe.com] Cheap Nike Dunk Shoes [/url]
[url=http://www.topbrandshoe.com] Women Nike Dunk SB Shoes [/url]
[url=http://www.topbrandshoe.com] Nike SB Shoes[/url]
[url=http://www.topbrandshoe.com] Nike Dunk Sneakers[/url]
[url=http://www.topbrandshoe.com] Nike SB Sneakers [/url]
[url=http://www.topbrandshoe.com] Nike Dunk High Top [/url]
[url=http://www.topbrandshoe.com] Nike Dunk shoes [/url]

Latest Posts

Popular Posts [+][-]

Archives [+][-]

Follow us on Twitter