Subscribe

UiPath Task Capture

The Task Capture Guide

Troubleshooting Guide

On this page, you can find basic troubleshooting steps for some of the most common issues that can occur while working with Task Capture.

Troubleshooting a Broken Template

Template Format

If a broken template error message is displayed while trying to import a customized template to Task Capture please follow the below steps in order to try and resolve the issue:

🚧

Important:

Task Capture only accepts .ssword files (default file type created from Task Capture). If it's different than .ssword or you created it either manually or using other tools, it's not accepted by the application. Please follow the steps from the Creating your own Word Template page to find out how to create a custom template and Exporting a Template to export it as the .ssword file.

In case the invalid .ssword file was created using Task Capture let's dive deeper and discover what might go wrong with it.

  1. Access the folder from your PC where you store the template and make a copy of the file.
  2. Change the format of the file copy to .zip.
  3. Check the files and folders in the created .zip archive. It should contain template folder and config.xml file.
  4. In case the structure of the folders is different or any file is missed but you can access the .docx file of your template, please extract it from the .zip archive and follow the steps from the Creating your own Word Template page to create a new template from it.
  5. Otherwise please proceed to open the log file from Task Capture.
    The log file is frequently requested during the troubleshooting process. To retrieve it simply access Task Capture top-panel menu > Help > Open Logs Folder.
  6. Open a Support request by completing this form. Add the Logs File and the .ssword file that can not be imported to the ticket created for the issue.

Incorrect Formatting of the Template

If you received one of the errors below most likely there's something wrong with the Word template that you used.

Error invoking remote method output.export: Multi error

Word experienced an error trying to open the file.

While we are working to solve this issue, we recommend you to follow the below steps in order to work around this issue:

  1. Go to Template View page in Task Capture, hover over the template you used for export and click Edit template button.
  2. The folder with the template files is opened on your PC.

📘

Note:

Create a copy of the template you used. As you'll apply several changes we don't want you to lose the information.

  1. Go to the word parent folder and copy/paste the folder of the template you want to edit.
  2. Open this new folder > template folder, > open the template.docx file.
  3. Make sure that all the placeholders work correctly by:
    1. Removing all formatting from the placeholders texts using the Clear All Formatting button.
    2. Adding each placeholder at the beginning of the new line.
    3. Remove all spaces before and after the placeholder.

Clear All Formatting button

📘

Note:

You can also play around with the images and placeholders in the template by trying to move or remove each of them one by one, saving the file and checking whether the template works correctly.

  1. Save the changes applied to the file.
  2. Restart Task Capture.
  3. Open a new or existing workflow.
  4. Go to Export & Publish page > Word > Document Properties > Template View.
  5. In the list of templates you'll see 2 files of your template (original and the one you just created). Select the second one, and proceed with exporting your process.
  6. If the issue persists please contact our technical support team.

📘

Note:

Please add the .ssword file that can not be exported correctly to the ticket.

UiPath Studio Export Error

If an error is displayed while trying to export your process as XAML file to Studio apply the following troubleshooting steps:

  • Check if the problem is caused by the .ssp file by following the below steps:
    1. Access the process in Task Capture.
    2. Export the workflow as Word Document.
    3. If this works, open a different .ssp file in Task Capture.
    4. Export it in Studio as a XAML file.
  • Chech if your file contains broken steps by following the below steps:
    1. Access the process in Task Capture.
    2. Delete the first half of the available steps.
    3. Export the remaining process in Studio as a XAML file.
    4. If this works access again the process in Task Capture.
    5. Delete the other half of the available steps.
    6. Export the remaining process in Studio as a XAML file.
    7. Access again the process in Task Capture.
    8. When the broken step is found Delete its title and description. The issue is usually caused by some characters.

Actions not Recorded After Starting the Capture Process

Check the below causes:

  • Check the writing permissions for user data folders.
    Task Capture uses %localappdata% as the installation folder and %appdata% and %temp% folder as temporary storage. If you have read-only access to user data folders, this can prevent Task Capture to write particular data.
  • Check the Anti-Viruses logs.
    Task Capture uses low-level hooks via the SetWindowsHookEx WinAPI method this is why some Anti-Viruses detect Task Capture as a spying software.

If the issue is not caused by one of the above points please proceed to open the log file from Task Capture. The log file is frequently requested during the troubleshooting process. To retrieve it simply access Task Capture top-panel menu > Help > Open Logs Folder.
Open a Support request by completing this form. Add the Logs File to the ticket created for the issue and the .ssword file that can not be imported.

Integration with Automation Hub and Test Manager

In case you cannot open Task Capture from Automation Hub or Test Manager or if the export to any of these platforms is not displayed when accessing the Export & Publish page after installing the MSI installer the following troubleshooting can solve the issue:

Start with the following steps:

  1. Install Task Capture using the 20.4.2 or above version of the .exe installer.
  2. Uninstall the Task Capture 20.4.2 or above version.
  3. Access the Task Capture installed using the .msi installer.

If this does not solve the issue remove Task Capture/Explorer Expert data from Windows Registry by following the instructions below:

  1. Press the Windows + R hotkeys from your keyboard.
  2. The Run pop-up is displayed. Type regedit. Click OK.
  3. Open Computer\HKEY_CURRENT_USER\Software\Classes\uipathtaskcapture directory.
  4. Search for the guid (global unique identifier) record containing task-capture or explorer-expert in its properties. Delete that record.
    1. If you do not have access to the guide record you can delete the uipathtaskcapture folder.
  1. Try to install the TaskCapture.msi version again.

Updated 3 months ago


See Also

FAQs

Troubleshooting Guide


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.