Migration Assessment Scan: Workflow Associations 2010
Overview
The migration tooling is typically able to migrate the Workflow Definitions from the SharePoint source to the target environment. However, any in progress workflow instances aren't migrated. As a result, in progress workflows are reset to appear as if they were never started on the destination.
Data Migration
Workflow Data is divided into the following two parts:
Workflow Definition: The definition describes the overall workflow process, for example, a three stage approval workflow with custom routing rules for each stage. This data will typically be migrated with the rest of the site collection data and will be available in your target environment.
Workflow Instances: Each running instance of a workflow definition maintains the state of the in progress workflow, for example, this document is in Stage 2 of the approval process and is assigned to John Doe. Unfortunately, this information can't be migrated to the new platform. The result is the loss of all running workflow instances. For example, a document that was in Stage 2 of a workflow in the source environment will be back at Stage Zero (workflow not started) post migration to the target environment.
Important
Any site that is configured as "No Access" (locked), in SharePoint will be skipped. To see a list of locked site collections see the Locked Sites scan output.
Preparing for Migration
To avoid unnecessary workflow restarts, it is best to complete in-flight workflows before the migration event when your content is moved to the target environment.
Post Migration
Once the migration to the target environment is complete, users will need to restart any workflows that were still in flight. If the workflow contained identities, it may be necessary to republish the workflow using SharePoint Designer.
Scan Result Reports
WorkflowAssociations2010-detail.csv This scan report provides a list of all the 2010 workflow associations in the environment along with how many running instances at the time the scan was executed.
| Column | Description |
|---|---|
| SiteId |
Unique identifier of the impacted site collection. |
| SiteURL |
URL to the impacted site collection. |
| SiteOwner |
Owner of the site collection. |
| SiteAdmins |
List of people listed as site collection administrators. |
| SiteSizeInMB |
Size of the size collection in megabytes [MB] |
| NumOfWebs |
Number of webs that exist in the site collection. |
| ContentDBName |
Name of the content database hosting the site collection. |
| ContentDBServerName |
SQL Server hosting the content database. |
| ContentDBSizeInMB |
Size of the content database hosting the site collection. |
| LastContentModifiedDate |
Date/Time the site collection had content modified. |
| TotalItemCount |
Total number of items found in the site collection. |
| Hits |
Number of requests logged for the site collection. Relies on data from the usage logging service. If the usage logging service is disabled this row shows N/A. |
| DistinctUsers |
Number of distinct users that have accessed the site collection. Relies on data from the usage logging service. If the usage logging service is disabled this row shows N/A. |
| DaysOfUsageData |
Number of days the usage logging service retains data. This provides context for Hits and DistinctUsers. For example, if this is 14 days, the Hits and DistinctUsers data is for the last 14 days. |
| Scope |
Either List, ContentType, or Site. This is the level that the workflow is associated with. |
| RunningInstances |
Number of workflows actively running at that scope. |
| WebURL |
URL to the web that the workflow is associated with. |
| ListTitle |
Title of the list the workflow is associated with. If the scope is Site, the value will be N/A. |
| ListUrl |
Url to the list with the workflow association. |
| ContentTypeName |
Name of the content type if the scope is ContentType. |
| IsReusable |
True if the workflow association was published as a reusable workflow. |
| ReusableScope |
Specifies the scope of the reusable workflow. Reusable or GlobalReusable. |
| WorkflowName |
Name of the workflow association. This is the text that displays in SharePoint when starting the workflow. |
| WorkflowDescription |
Description of the workflow association. |
| HasCustomWorkflowActivity |
True if the workflow is using a custom workflow activity that was deployed via full trust solutions. |
| WorkflowReferencedAssemblies |
Name of the assembly associated with a custom activity. Populated if HasCustomWorkflowActivity is True. |
| SolutionNames |
Name of the full trust solution package the custom activity is associated with. Populated if HasCustomWorkflowActivity is True. |
| WorkflowPublishedBy |
Name of the person that published the workflow. |
| WorkflowID |
Unique identifier associated with the workflow. |
| AddListItemPermissionsExist |
True if the workflow contains an action that adds list permissions. The activity embeds a user's identity and may not function post migration without manual republish of the workflow. |
| RemoveListItemPermissionsExists |
True if the workflow contains an action that removes list permissions. The activity embeds a user's identity and may not function post migration without manual republish of the workflow. |
| ReplaceListItemPermissionsExists |
True if the workflow contains an action that replaces list permissions. The activity embeds a user's identity and may not function post migration without manual republish of the workflow. |
| EmailActivityExists |
True if the workflow contains an action that sends email. The activity embeds a user's identity and may not function post migration without manual republish of the workflow. |
| ImpersonationExists |
True if the workflow contains an action that impersonates an account to perform an action. The activity embeds a user's identity and may not function post migration without manual republish of the workflow. |
| RulesFileExists |
True if the workflow contains conditional rules that contain identities. The activity embeds a user's identity and may not function post migration without manual republish of the workflow. |
| ContentAppovalExists |
True if the workflow contains content approval activities. The activity embeds a user's identity and may not function post migration without manual republish of the workflow. |
| WorkflowFileCheckedOut |
If the workflow file is checked out, it will not migrate as expected. |
| ScanID |
Unique identifier assigned to a specific execution of the SharePoint Migration Assessment Tool. |