UiPath Documentation
studio
2026.10
false
Guide de l'utilisateur de Studio

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).

Remarque :

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.

Onglet Vue d'ensemble (Overview)​

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:

État (Status)Description
réussieAll workflows and activities were migrated without issues.
Completed with warningsEverything was migrated, but some results need a review, such as validation errors or incomplete migrations in the resulting workflows.
Completed with errorsSome 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.

Onglet Projets​

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.

Cette page vous a-t-elle été utile ?

Connecter

Besoin d'aide ? Assistance(opens in new window)

Vous souhaitez apprendre ? UiPath Academy(opens in new window)

Vous avez des questions ? UiPath Forum(opens in new window)

Rester à jour