# Migration report

> HTML migration report generated by Activity Migrator, including the report structure, tabs, and bulk-run view.

The `analyze`, `upgrade`, and `bulk` commands generate an HTML migration report alongside the SARIF report. Both reports are saved in the `.upgrade` folder of the original project.

The HTML report file is named after the project, followed by a unique identifier, for example `GSuiteMigration-7de07881-c2fa-4f2b-b750-28b1c483dbad.html`. The file can be opened in a browser to view the report.

A log file is also saved next to the report (`project-<id>.log` in the `.upgrade` folder).

:::note
Viewing the HTML report requires a recent browser, such as Microsoft Edge or Google Chrome version 123 or later.
:::

The report header shows the project name, the overall migration status (for example, **Completed with errors**), the Activity Migrator version, the duration of the run, and the date and time it ran.

The HTML report is organized into the following tabs:

* **Overview**: A summary of the migration results and the actions required after migration.
* **Projects**: The projects included in the run and their migration status. It appears only for bulk runs.
* **Workflows**: Every workflow in the project, with its migration status, activity outcomes, and findings.
* **Findings**: All errors, warnings, and notes reported during migration.
* **Run details**: Information about the migration run, the project and log files, and the results reported by each migration rule.

![Overview tab of the Activity Migrator HTML report, showing the status summary, summary cards, migration breakdown, and next steps](https://dev-assets.cms.uipath.com/assets/images/studio/activity-migrator-report-overview-c56e7b6b.webp)

## Overview tab

The **Overview** tab contains the following:

* **Status summary**: The overall result of the migration, with the number of workflows analyzed, activities attempted, and errors and warnings reported.
* **Summary cards**:
  - **Errors**: Issues that need manual work.
  - **Warnings**: Issues for which a review is recommended.
  - **Notes**: Informational steps.
  - **Workflows**: The number of workflows that are clean, have warnings, or have errors.
  - **Activities migrated**: The number of activities that migrated cleanly, migrated with warnings, or failed.
* **Migration breakdown**: Bar charts that show workflows by status and activity outcomes.
* **Project-level results**: Findings that apply to the project as a whole rather than to a specific workflow, such as the general migration summary for each extension.
* **Next steps**: The action items marked as **PostMigration Action Required**, which you must fix in Studio after the migration. Each item shows the activity, the reason, the workflow file, and the finding code. Selecting **View all action items** shows the full list.

The migration can have one of the following statuses:

| Status | Description |
| --- | --- |
| **Succeeded** | All workflows and activities were migrated without issues. |
| **Completed with warnings** | Everything was migrated, but some results need a review, such as validation errors or incomplete migrations in the resulting workflows. |
| **Completed with errors** | Some workflows or activities couldn't be migrated. The original workflow is kept in the output folder. You can try to migrate it manually in Studio, but this isn't guaranteed to work. |

## Workflows tab

The **Workflows** tab lists every workflow in the project with its migration status. It contains the following:

* **Status filters**: Show all workflows, or only the workflows with a specific status. Each filter shows the number of workflows with that status.
  - **Not migrated**: Workflows with activities that failed to migrate.
  - **With warnings**: Workflows that migrated, but have warnings to review.
  - **Clean**: Workflows that migrated without issues.
* **Filter by workflow path**: Search for workflows by their path in the project.
* **Results summary**: The number of workflows shown, along with the totals for failed activities, validation issues, and action items.
* **Workflows table**:
  - **Workflow**: The workflow path, relative to the project folder.
  - **Status**: The migration status of the workflow. Selecting the column header sorts by status.
  - **Activities**: The number of activities in the workflow, broken down into migrated, with warnings, and failed, along with a progress bar.
  - **Problems in**: The migration step that reported the issues, for example **GSuite Activities Upgrade**.

Selecting a workflow opens its findings.

## Findings tab

The **Findings** tab lists all the results reported during migration. By default, it shows errors and warnings. It contains the following:

* **Level filters**: Show or hide findings by level. Each filter shows the number of findings at that level.
  - **Errors**: Activities that couldn’t be migrated and need manual work.
  - **Warnings**: Issues for which a review is recommended.
  - **Notes**: Informational steps performed during migration.
  - **Action required**: Findings marked as **PostMigration Action Required**, which you must fix in Studio after the migration.
* **Search**: Search findings by message, workflow, or activity.
* **Rule**: Show only the findings reported by a specific migration rule.
* **Group by**: Group the findings, for example by workflow. Each group shows the workflow path and the number of findings it contains. Selecting a group expands or collapses it.
* **Show all results**: Display all findings, at every level.

The findings table contains the following columns:

* **Level**: The severity of the finding: **Error**, **Warning**, or **Note**.
* **Message**: The description of the finding. Findings that require action after migration are labeled **Action required**. For longer messages, selecting the link below the message, for example **+1 more line**, expands the full text.
* **Activity**: The display name of the affected activity.
* **Rule**: The migration rule that reported the finding, for example **CreateScriptDeployment Activity Migration**.

Selecting a finding opens its details. The details window contains the following:

* **Activity**: The activity before and after migration. For example, a **Get Outlook Mail Messages** activity can be replaced by a migrated **Get Outlook Mail Messages** activity and an **Assign** activity. If the activity couldn't be migrated, the **After** side is empty. Below it, the finding message explains the result.
* **About the rule**: A description of the migration rule that reported the finding, including what the rule migrates and which properties it preserves. Selecting the heading expands or collapses the description.
* **Level**: The severity of the finding: **Error**, **Warning**, or **Note**.
* **Workflow**: The workflow that contains the activity.
* **Step**: The migration step that reported the finding, for example **Mail Activities Upgrade**.
* **Rule**: The display name and the ID of the rule that reported the finding.

## Run details tab

The **Run details** tab contains information about the migration run itself:

* **Run summary**:
  - **Execution**: Whether the migration ran to completion, for example **All steps ran**.
  - **Started** and **Finished**: The date and time the run started and ended.
  - **Duration**: How long the run took.
  - **Tool version**: The version of the Activity Migrator used for the run.

* **Files**:
  - **Project folder**: The path to the migrated project.
  - **Log file**: The path to the migration log file, saved in the `.upgrade` folder of the project. Selecting the path opens the log file.

  Selecting **Copy** next to a path copies it to the clipboard.

* **Results by rule**: The migration rules that reported results during the run. The header shows the number of rules reported. For each rule, the table shows:
  - **Rule**: The display name and the ID of the rule, for example **CreateScriptDeployment Activity Migration** (`CREATE-SCRIPT-DEPLOYMENT-ACTIVITY-MIGRATION`).
  - **Results**: The number of results the rule reported, by level.
  - **Locations**: The number of locations where the rule reported results.

  Selecting a rule opens its description and results.

The filters and search narrow the results. For each changed activity, the activity before and after migration is available for review. The theme selector in the top-right corner of the report switches between light and dark mode. **Auto** follows your system setting.

## Bulk migration report

For bulk runs, the Activity Migrator also generates a report for all projects, saved in the folder specified with the `-p, --path` option, for example `repository-analyze-results.html`. Each project still gets its own report in its `.upgrade` folder.

For this case, the HTML report contains the same tabs as the project report, plus a **Projects** tab and an all-projects view that lists the projects needing attention first.

The report header shows the number of projects and how many of them need attention. The **Project** dropdown in the top-right corner switches between **All projects** and the results of an individual project.

![Projects tab of the Activity Migrator bulk migration report, listing projects with their migration status, sorted by the ones that need attention first](https://dev-assets.cms.uipath.com/assets/images/studio/activity-migrator-bulk-report-projects-34080037.webp)

### Projects tab

The **Projects** tab lists all the projects included in the bulk run. By default, the projects that need attention are shown first. It contains the following:

* **Status filters**: Show all projects, or only the projects with a specific status: **Need attention**, **With warnings**, or **Clean**. Each filter shows the number of projects with that status.
* **Filter by project name or path**: Search for projects by name or folder path.
* **Has problem**: Show only the projects with a specific type of problem.
* **Projects** table:
  - **Project**: The project name and folder path.
  - **Status**: The migration status of the project, for example **Succeeded**, **Completed with warnings** or **Completed with errors**. Selecting the column header sorts by status.
  - **Workflows**: The number of workflows in the project and how many of them migrated cleanly, along with a progress bar.
  - **Errors**, **Warnings**, and **Notes**: The number of findings at each level.
  - **Actions**: The number of action items that require manual fixes in Studio after the migration.
  - **Duration**: How long the migration of the project took.

### Viewing a project in the bulk report

Selecting a project in the **Projects** table, or from the **Project** dropdown, opens its detailed results. The dropdown shows each project's name and status, for example **CreateSAPOrders · Warnings**.

The project opens with the same **Overview**, **Workflows**, **Findings**, and **Run details** tabs as a project report. In addition:

* The breadcrumb at the top of the page shows the selected project. Selecting **All projects** returns to the results for all projects.
* The project navigation in the top-right corner shows the position of the project in the list, for example **1 of 3, worst first**. The arrows go to the previous or next project. Projects are ordered starting with the ones that need the most attention.
