...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
...
Because every Sitecore instance is different there is no way of predicting all the possible issues that can occur during this process. But this guide should give you solid understanding of what is the best order to delete or items and files related to Sitecore Connector. While removing items from Sitecore always use ‘Remove links’ option (but sometimes it is necessary to use ‘Scan for broken Links’ between the steps anyway). All the Items paths precede with database name (master or core). File paths are relative to the main Sitecore installation path on the server.
...
Verify that none of your items inherits from XtmConnectorBaseTemplate (more details below)
...
Verify that none of your items is in XTMWorkflowState (using Workbox details below)
...
Delete XtmUser, XtmAdmin, XtmProjectViewRestriction roles (using Role Manager)
...
Delete item /master/sitecore/content/XTM Translation and all its subitems
...
| Table of Contents | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
| Page Properties | ||
|---|---|---|
| ||
Introduction
It is not possible to uninstall XTM Connect – Sitecore automatically. This must be done manually, both on the Sitecore Content Management website (marked below with green) and directly on the server that hosts this website (marked with blue).
| Note |
|---|
IMPORTANT! |
Since every Sitecore instance is different, there is no way of predicting all the possible issues that can arise from performing this process. This article should give you a solid understanding of the best sequence in which you should delete items and files related to the XTM connector.
...
Uninstallation instructions
While removing items from Sitecore, always use the Remove links option (although it is sometimes necessary to use Scan for broken Links between the steps). All item paths are preceded by a database name (master or core). File paths are relative to the main Sitecore installation path on the server.
Verify that none of your items inherits from XtmConnectorBaseTemplate.
In the Content Editor, selectXtmConnectorBaseTemplate (under sitecore → Templates → XTM), and, in the upper menu, choose the Navigate tab and expand the Links dropdown.
...
Click every Items that refer to the selected item, change tab to Content, remove XtmConnectorBaseTemplate from the base templates that have been selected and then save the item:
...
Verify that none of your items is in XTMWorkflowState.
Open the Content Editor, choose Workbox (from the “lower tabs” menu), select the XTM Translation workflow and verify that no items are using any of its workflow steps.
...
If any items are using the XTM Translation workflow steps, select Open link to edit the workflow and clear it or change to another workflow.
...
This will open the Content Editor popup. Select Edit fields in the Workflow section:
...
| Note |
|---|
IMPORTANT! The Workflow section is only displayed when the Standard fields option is selected in the View tab. |
Delete the XtmUser, XtmAdmin and XtmProjectViewRestriction roles (using the RoleManager).
Delete the master/sitecore/content/XTM Translation item and all of its sub-items.
Delete the /master/sitecore/templates/XTM/XtmSettings item.
Delete
...
the /master/sitecore/templates/XTM
...
item and all of its sub-items.
Delete
...
the /master/sitecore/System/Workflows/XTM
...
Translations item.
Delete
...
the /master/sitecore/system/Dictionary/XtmAddToQueueSimpleFilter
...
item and all of its sub-items (only applicable to the connector version
...
between 2.5 and 3.2).
Delete
...
the /master/sitecore/system/Dictionary/ImportTypeOptions
...
item and all of its sub-items (only applicable to the connector version
...
between 2.5 and 3.2).
Delete all
...
ribbon chunks (you need to switch to the core DB
...
to do this – more details below):
/core/sitecore/content/Applications/Content Editor/Ribbons/Chunks/XTM Translation/TranslationReport,
/core/sitecore/content/Applications/Content Editor/Ribbons/Chunks/XTM Translation,
/core/sitecore/content/Applications/Content Editor/Ribbons/Ribbons/Default/XTM,
/core/sitecore/content/Applications/Content Editor/Ribbons/Strips/XTM/XTM Translation,
/core/sitecore/content/Applications/Content Editor/Ribbons/Strips/XTM,
Empty
...
the Recycle Bin
...
for the master DB and core DB (you need to switch between the master and core DB
...
to do so).
Delete
...
these files: /sitecore/shell/Themes/Standard/Xtm.zip
...
and /sitecore/shell/Themes/Standard/XtmNewIcons.zip (if the connector version is 2.7 or higher).
Delete this folder: /XtmFiles/.
Delete this folder: /XtmData/.
Delete this folder: /App_Config/Include/Xtm/ (or /App_Config/Include/LjungbergIt/
...
– if the connector version is below 2.0).
Delete this file: /App_Data/packages/<XTM connector installation package>.zip
...
– this is optional
...
since these are the packages that are uploaded to the server
...
when the connector is installed/upgraded.
Delete files whose names start with XTM (dlls, configs, pdbs, etc.)
...
from the /bin/ folder.
The XtmAssemblies FOLDER which contains all dlls used by the connector: HtmlAgilityPack.dll, RestSharp.dll, DotNetZip.dll, RestSharp.dll, FluentValidation.dll, Sentry.dll, Sentry.Platform.Abstraction.dll, Sentry.Protocol.dll, Swashbuckle.Core.dll, AutoMapper.dll.
...
In Breaking Links window chose Remove Links
ad 1. Removing XtmConnectorBaseTemplate
In the Content Editor, select the XtmConnectorBaseTemplate (under sitecore/Templates/XTM) in the upper menu choose ‘Navigate' tab and expand it.
...
Click every ‘Item that refers to the selected item’ change tab to Content, remove XtmConnectorBaseTemplate from selected base templates and save the item:
...
ad 2. Checking for items in XtmWorkflow
Open ContentEditor, choose Workbox (from lower tabs menu), select ‘Xtm Translation’ workflow and verify that there are no items using any of its WorkflowSteps.
...
If there are any items with ‘Xtm Translation’ workflow steps you can use Open link to edit the workflow and clear it or change to another workflow.
...
This will open a popup with ContentEditor you need to Edit fields under Workflow section
...
Note: the Workflow section is only visible when ‘Standard fields’ option is selected under View main tab.
...
Links rebuild
Sitecore Experience Management -> Desktop -> Reporting tools -> Scan for broken Links
...
Select "master" checkbox
Click "Rebuild link database"
...
The folder was added in v.3.1. Before, it was called HtmlAgilityPack. Do not delete the dlls in the bin folder itself. Depending on the version of the connector, not all dlls will be present in your case (make sure that you do not use the dlls listed below in other plugins).
In the Breaking Links window, choose Remove Links.
...
Other actions
How to switch to the CORE database
While logged in to Sitecore, go to Sitecore Experience Manager → Desktop, click on master from the bottom-right list,and select core.
How to rebuild links
While logged in to Sitecore, go to Sitecore Experience Manager → Desktop → Reporting tools → Scan for broken Links.
...
Select the master checkbox and click Rebuild link database.
...