Introduction
Sometimes you might be experiencing different problems with removal or cancellation of XTM projects straight from the Sitecore CMS. Such situation might stem from the fact that there are many places in the CMS from which you can potentially remove or cancel an XTM project. However, there exists only one official and correct way for doing so, which is the topic of this article.
The most important thing to keep in mind is that any action relating to project cancellation or removal must be performed in the Translation queue window!
Project cancellation principles
Cancellation process
You can Cancel the project via the Actions dropdown, located at the top of the dialog window. Remember to first select a particular XTM project that you want to cancel, from the list, otherwise the the Actions dropdown will be greyed out and not selectable.
XTM projects that CAN be cancelled must have the following statuses in the Sitecore CMS:
Sent → Project has already been sent off to XTM Cloud for translation but the workflow has not been started yet.
In progress → Project has already been sent off to XTM Cloud for translation and its workflow has now been started.
XTM projects that CANNOT be cancelled have the following statuses in the Sitecore CMS:
New → Project has not yet been sent to translation in XTM Cloud.
Finished → Project is no longer in progress.
Result
Cancellation of the project causes the project to be cancelled in XTM Cloud:
The project in question gets a Cancelled status on all of its content items in the Translation queue dialog window.
The content items' corresponding language versions are removed from the Sitecore CMS:
Project removal principles
Removal process
Removal of projects can be performed in two places, contrary to project cancellation:
You can Remove the project via the Actions dropdown, located at the top of the dialog window. Remember to first select a particular XTM project that you want to remove, from the list, otherwise the the Actions dropdown will be greyed out and not selectable.
XTM projects that CAN be removed must have the following statuses in the Sitecore CMS:
New → Project has not yet been sent to translation in XTM Cloud.
Cancelled → Project has already been cancelled in the Sitecore CMS.
XTM projects that CANNOT be removed must have the following statuses in the Sitecore CMS:
Sent → Project has to be cancelled first.
In progress → Project has to be cancelled first.
Finished → Project has to be cancelled first.
You can also remove a particular project from the project’s dropdown context menu, that is located on the right-hand side of the said project, by means of the Remove project option. The mechanism by which this option functions is the same as in the case of removing the project via the Actions dropdown.
Remove item
For projects with statuses In progress and Sent, you can also make use of the Remove item option, from the project’s dropdown context menu.
Upon clicking on the option, you can select concrete content items that you might want to remove from the project. An important thing to note while using the Remove item option is that you do not necessarily have to cancel those items first to remove them. Once all the items have been removed in this view, the project is removed automatically.
Result
Removal of the project causes the project to be removed entirely in XTM Cloud.
The project in question and all of its content items are removed from the Translation queue dialog window.
The content items' corresponding language versions are removed from the Sitecore CMS:
How NOT to remove projects in the Sitecore CMS
Sometimes you might have accidentally removed an XTM project in the Sitecore CMS the way it should not have been removed. There are two places that you should avoid.
Removing active project directly in XTM Cloud
If you remove an active project directly in XTM Cloud, it will not be removed from the Translation queue dialog window. Instead, it will get the Cancelled status. What is more, a date of removing the project is appended to the project’s name.
The most important thing, however, is that the content items' language versions relating to this project are not removed from the Sitecore CMS, which has a serious consequence in the form of the said content items being blocked from their subsequent submissions to XTM Cloud.
This is caused by the fact that those language versions are still in the In translation status. One of the XTM Connect – Sitecore mechanisms is that a particular content item cannot be sent off to XTM Cloud for the same language second time unless the first language version of this item is imported back to Sitecore CMS from XTM Cloud.
Removing active project directly from the content tree in the Sitecore CMS
If you remove an active project directly from the content tree in the Sitecore CMS (sitecore → Content → XTM Translation → Translation In Progress):
it will also be removed from the Translation queue dialog window. However, it will remain as an active project in XTM Cloud.
The most important thing, however, is that the content items' language versions relating to this project are not removed from the Sitecore CMS, which has a serious consequence in the form of the said content items being blocked from their subsequent submissions to XTM Cloud.
This is caused by the fact that those language versions are still in the In translation status. One of the XTM Connect – Sitecore mechanisms is that a particular content item cannot be sent off to XTM Cloud for the same language second time unless the first language version of this item is imported back to the Sitecore CMS from XTM Cloud.