Salesforce Spring14 – Migrating Public Tags to Topics

This week on Wizard News we take a look at migrating Public Tags to the new Topic’s on record feature in the Spring ’14 Release. Organizations that have heavily been using Public Tags were likely dismayed when that information wasn’t migrated as Topics when the feature was enabled. The good news is the tag data is still there. The better news is a community member Mike Telow has created a great tool to migrate your public tags to topics.

First let’s take a look at why you would want to migrate your Public Tags as topics.

Why Use Topics on Records

Tags were a feature that allowed users to place mini-notes on records. The tags displayed at the top of the records and they were useful to return a list of all records using that tag. There were limitations to the tag system. You could not report on tags or create list views. Exporting your list of records was a challenge. Here’s what we can do with Topics on records that we could not do with tags.

  • Create List Views – a new criteria “Topics” is available to create list views of records that include or exclude a topic
  • Report on Topics – We can report on topics. This needs a shot in the arm for records vote here
  • Global Search Friendly
  • They’re just cooler

There’s some nice bonuses here. Plus, Salesforce is likely to continue developing Topics.

Let’s Migrate Already

There are four easy steps to getting your Public Tags migrated to Topics.

  1. Enable Topics for each Object
  2. Install Migration Tool
  3. Migrate Public Tags

Wait Brian! I can hear you shout. That’s only 3 items. You’re right. The fourth is: Do this is Sandbox first. This is an unmanaged package. I trust Mike Telow’s coding skills, but everyone can make mistakes. I recommend always installing ANY AppExchange package in a Sandbox for review and testing first.

Enable Topics

Enabling Topics is very easy. Under the Customize Menu we expand Topics and Select “Topics of Objects.” We have a list of Objects in our org and next to each object a pick list to either Disable (Default) or Enable Topics. Please note that Enabling Topics for the object will remove Public Tags. Personal Tags will still be available.

Enabling Topics

Enabling Topics

Install Migration Tool

You can find Mike Telow’s tool here: https://github.com/mtetlow/Salesforce-Public-Tag-To-Chatter-Topics-Migration

Installation is very easy. The link to install the package is: https://login.salesforce.com/packaging/installPackage.apexp?p0=04ti0000000H2Cy to install in your sandbox, simply replace login.salesforce.com with your Sandbox instant information. For example: CS15.salesforce.com

**Update 8/22/2014 — Note the link to the package has change since this blog post. There was an update to Mike’s code which required a new package. I strongly recommend you check out Mike’s github link posted above which will have the most updated links. /End Update ****

From here simply review the package details and proceed to steps 1 through 3. I recommend only installing for Admins. Who else will be doing the migration other than the Admin?

Once the app is installed, we can do the migration.

Migrate these Tags Already

I have two accounts with Tags. Here’s an example of both in one screenshot. The top part I’m adding Tags and the bottom is the view of Tags already on the record.

PreMigration Examples

These are the two records we’ll be migrating their Public Tags to topics. First step is to go to the Migration Tool’s page. This is something we have to manually enter.

  • Click on your Home Tab.
  • Delete “/home/home.jsp”
  • Append “/Apex/tagMigration”

So your URl should now look something like: CS7.Salesforce.com/apex/tagMigration  and you should be looking at a page like this:

Tagmigration pageThere’s lots of information on this page. It’ll display all the areas Tags are currently available. The most important item is the “Start Public Tags to Topics Migration” button at the bottom. Click this button. When running in Sandbox, make sure the “Access to Send Email” is set to “All Email.” Any other setting will cause an error and the migration will not run. This is only an issue with Sandbox. You can see your Access level under “Email Administration” -> “Deliverability.”

You will receive an email once the migration is completed. Here’s what my sample accounts looked like once it was completed:

After migration AccountsWe’re done! Look at those topics, so very pretty.

The last thing to do is uninstall the package. That’s right. Once we’re done migrating all our public tags there’s no reason to keep the package in our org any longer. We like nice clean orgs right?

Very simple and easy process to migrate all your public tags over to topics. Are you planning on using Topics on records? How will you be using them? Love to hear from you in the comments!

Recommended Posts
Showing 7 comments
  • Rhonda Ross
    Reply

    Great blog post. When I used Apex/tagMigration, I got the message URL No Longer Exists. I found that if I used apex/tagMigration instead, this message went away. Unfortunately, I then got the message Too many SOQL queries: 101. Very good advice to always test in sandbox first, since difference orgs can have different results depending on volume of data, other customizations already in place, etc.

  • Venkata Sowjanya Penneti
    Reply

    I see the code from Github. I see that if there are no records associated with any Tag, then Those Tags will not be added as Topics……

  • Marcelle
    Reply

    Thanks for this post, does this include personal tags or only public tags?

pingbacks / trackbacks

Leave a Reply