Moving taxonomy from deeply-nested to top-level

[tdukart]

There's an interest from our editorial team to move some of our taxonomies from a deeply-nested path to a top-level taxonomy. Essentially, the idea is:

From	To
/metro/state/springfield/	/springfield/
/metro/state/springfield/nuclear-energy/	/springfield/nuclear-energy/

Has anybody done that? Any problems we should look out for? We have years of content inside those taxonomies if that affects things.

[tdukart]

(There are about a dozen taxonomies under springfield in this case, I just included one for clarity.)

[matthewroach]

It's straight forward enough using Arc APIs, but will require a script to process all your content. There is no bulk way of doing this, you'll need to iterate over each article and update them.

You would use draft API to update each ANS document - using the API https://api.{{baseUrl}}/draft/v1/:type/:id/circulation/:website

The website_url field may be omitted to trigger (re)generation on a published document based on pre-configured formatting rules.

If the website_url value changes, a new Redirect is created to forward from the old value to the new. If the new value of website_url matches an existing Redirect, the existing Redirect is converted to the Circulation's primary URL.

When a Document's Circulation changes, External Redirect objects with redirect_to equal to the original url will not be updated automatically to point to the new URL.

In draft API you will need to

1. Change section
2. Change circulation

You will need to regenerate a URL which in Arc will create the redirects for you. This allows old URLs pointing to the current URLs to work with the move of content to the new section

{
	"document_id": "123455",
	"website_id": "${webiste_id}",
	"website_url": "/springfield/article-url/",
	"website_primary_section": {
		"type": "reference",
		"referent": {
			"type": "section",
			"id": "/springfield",
			"website": "irishtimes"
		}
	},
	"website_sections": [{
		"type": "reference",
		"referent": {
			"type": "section",
			"id": "/springfield",
			"website": "irishtimes"
		}
	}]
}