Task recorder

Completed

Task recorder helps users create test cases based on business processes and tasks. It integrates with tools that consume business process recordings and supports automated testing scenarios.

Task recorder integrates with Lifecycle Services (LCS) Business Process Modeler (BPM), where users can organize recordings. Task recorder no longer generates business process diagrams from recordings. It can generate application regression tests and play back previously recorded processes.

Note

Starting in January 2026, task recordings are supported only in sandbox and production environments. Cloud-hosted environments don't support this capability. Lifecycle Services is being replaced by the Microsoft Power Platform admin center. New Lifecycle Services projects were frozen for new Finance, Supply Chain Management, and Project Operations customers on February 16, 2026.

Task recorder records user actions, including button selections, data entry, and navigation.

To see how to create and consume a Task recording as a developer for testing, watch this video.

To create a task recording, follow these steps:

  1. Before starting a new recording, refresh your browser to create a new user session. Refreshing the browser restarts Task recorder and helps prevent unwanted changes to an existing recording.
  2. Select Settings > Task recorder.
  3. Select Create recording.
  4. Enter a recording name and select Start. Task recorder enters Recording mode and displays information and controls for the recording session.
  5. Run through a process. As you go through forms, select buttons, and enter data, steps are added to the task recording.
  6. Select Stop.

You can save a task recording in several formats:

  • Save to this PC - Downloads the task recording package (an .axtr file). You can use this package to play a task guide, maintain the recording, or edit the recording's annotation.
  • Save to Lifecycle Services (LCS) - Publishes the recording on the specified business process in a BPM library. If the Lifecycle Services library is configured as a Help library, the task guide is available from the Help menu.
  • Export as Word document - Creates a Microsoft Word document with the recorded steps, as well as any screenshots that were captured.
  • Save as developer recording - Saves the raw recording file that is used for developer scenarios, such as test code generation.

Task recorder can replay steps from an existing recording. You can also use playback to update a recording with new or revised steps. After playback finishes, Task recorder creates a new recording that includes the original and updated steps. Steps that aren't run during playback aren't included.

To play back a recording that you have saved locally as a file with the ".axtr" extension, follow these steps:

  1. Open the Task recorder pane.
  2. Select Playback recording.
  3. Select Open from this PC to load the Task recorder package (.axtr).
  4. Select Start. The Task recorder begins playback.

While you play back a recording, you can choose from several controls to maintain a task recording:

  • Play next pending step - Runs the next step. This option might close open lookups, drop dialogs, or Action Pane tabs. If you need to keep those elements open, use Play all pending steps instead.
  • Play all pending steps - Runs all remaining steps until playback is paused. During playback, the button changes to Pause. If Task recorder can't perform a step, it skips the step and pauses playback.
  • Play to selected step - Runs steps until the selected step is reached, and then stops playback.

Additional editing features help you maintain recordings.

In Settings > Task Recorder > Edit recording, you can:

  • Insert steps without rerecording the entire file.
  • Move steps without rerecording the entire file.
  • Collapse the recording name and description fields to display more steps.

To edit a recording, use the following procedures.

Insert step

  1. Select the step after which you want the new step to be inserted.
  2. Go to the page where you want to add the step. The Insert step option appears.
  3. Select Insert Step. Task recorder switches to Record mode.
  4. Perform the step.
  5. Select Stop. You can repeat this step as needed.
  6. Select Done editing.
  7. Save or publish the task recording.

Move steps or subtasks

  1. Select the step after which you want to place the moved step.
  2. Select Move step after.
  3. Select the destination step or subtask.
  4. Select Done editing and save the task or publish the task guide when you are done.

Import a Task Recorder recording into Visual Studio

You can import a Task Recorder recording into Visual Studio to generate test code. The recording is imported as an XML file, and Visual Studio generates test code by using FormAdaptors.

To import a task recording into Visual Studio, follow these steps:

  1. Record a scenario by using Task Recorder, and save it as a developer recording.
  2. In Visual Studio, select the Dynamics 365 menu.
  3. Select Addins > Import task recording.
  4. Use Browse to locate the XML file for the recording.
  5. Select the model to add the generated test to. The model must reference TestEssentials for the test to build successfully.
  6. Select Import. Visual Studio generates test code based on SysTestAdapter and FormAdaptor. (This code can be viewed in the Visual Studio IDE.)
  7. Build the project to run the test.
  8. Go to Test > Windows > Test Explorer. The generated tests appear in Test Explorer.
  9. Select the test and select Run > Execute selected.

Task recorder includes advanced recording options, such as advanced grid row selection.

To ensure that the correct row is selected during playback, define filter criteria for the selected record.

During recording, after you open a form that contains a grid and select a record, the Grid row selection dialog appears. The dialog includes a filter pane that contains suggested criteria.

You can accept the suggested criteria or define your own filters.

The Rollback changes to business data option can revert business data that is created during a recording session after the recording is complete. Use this option primarily when creating task recordings for testing. The rollback option affects only records that are created during the recording session. This feature is available only in non-production environments where Test tools are installed.

You can play a task guide in On-rails mode. In this mode, the guide provides step-by-step prompts and automatically advances when a step is completed.

In On-rails mode, users can select only the control that is required for the current step.

To disable On-rails mode, select Unlock on the Task recorder toolbar. Select Unlock again to re-enable it. Select Unlock again to restore them.

If a required element isn't visible or available on the current form, the task guide enters an error state. A message explains the issue. After locating the element, the user can continue with the task guide. An error state can also occur when you use Next step or Previous step and the referenced element isn't available on the current form. Select See more to view additional information, such as example values and notes.