Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 14 Next »

Introduction

It is not possible to uninstall XTM Connect – Sitecore automatically. It 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).

IMPORTANT!
Make sure to always create a backup before removing items and files.

Since every Sitecore instance is different, there is no way of predicting all the possible issues that can arise from executing this process. This article should give you a solid understanding of what is the best order in which items and files related to the XTM connector are to be deleted.

Uninstalling instructions

While removing items from Sitecore always use the Remove links option (but sometimes it is necessary to use Scan for broken Links between the steps anyway). All the items paths are preceded by a database name (master or core). File paths are relative to the main Sitecore installation path on the server.

  1. Verify that none of your items inherits from XtmConnectorBaseTemplate.

  • In the Content Editor, select XtmConnectorBaseTemplate (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, and remove XtmConnectorBaseTemplate from base templates that were selected, and save the item:

  1. 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 there are no items using any of its workflow steps.

2024-03-25 15_15_50-.png

  • If there are any items with the 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 Content Editor; you need to Edit fields under the Workflow section:

IMPORTANT!

The Workflow section is only visible when the Standard fields option is selected under View tab.

  1. Delete XtmUser, XtmAdmin, XtmProjectViewRestriction roles (using the Role Manager).

  2. Delete item: master/sitecore/content/XTM Translation, and all of its sub-items.

  3. Delete item: /master/sitecore/templates/XTM/XtmSettings.

  4. Delete item: /master/sitecore/templates/XTM, and all of its sub-items.

  5. Delete item: /master/sitecore/System/Workflows/XTM Translation.

  6. Delete item: /master/sitecore/system/Dictionary/XtmAddToQueueSimpleFilter, and all of its sub-items (only applicable to the connector version between 2.5 and 3.2).

  7. Delete item: /master/sitecore/system/Dictionary/ImportTypeOptions, and all of its sub-items (only applicable to the connector version between 2.5 and 3.2).

  8. Delete all ribbon chunks (switch to the core DB is needed – 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,

  1. Empty Recycle Bin for master DB and core DB (switch between the master and core DB is required).

  2. Delete files: /sitecore/shell/Themes/Standard/Xtm.zip and /sitecore/shell/Themes/Standard/XtmNewIcons.zip (if the connector version is 2.7 or higher).

  3. Delete folder: /XtmFiles/.

  4. Delete folder: /XtmData/.

  5. Delete folder: /App_Config/Include/Xtm/ (or /App_Config/Include/LjungbergIt/ – for the connector version below 2.0).

  6. Delete file: /App_Data/packages/<XTM connector installation package>.zip – this is optional since those are the packages uploaded to the server while installing/upgrading the connector.

  7. Delete files with names starting with XTM (dll's, configs, pdbs, etc.) from the /bin/ folder.

  • FOLDER XtmAssemblies 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. The folder was added in v.3.1 before it was named HtmlAgilityPack. Do not delete those dlls from the bin folder itself. Depending on the version of the connector, not all dlls can be present in your case (make sure that you do not use dlls below in other plugins).

  1. In the Breaking Links window, choose Remove Links.

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

  1. While logged in to Sitecore, go to Sitecore Experience Manager → Desktop → Reporting tools → Scan for broken Links.

  1. Select the master checkbox and click Rebuild link database.


  • No labels