Convert Classic Playbooks to Canvas Playbooks

overview the playbook conversion tool helps you migrate your existing classic playbooks to canvas playbooks with minimal manual effort the conversion process creates canvas compatible assets based on your existing classic playbooks, allowing you to begin using the new canvas experience while preserving your existing automation logic the conversion process is designed to support a gradual transition from classic playbooks to canvas playbooks your existing classic playbooks remain available during the migration process, giving you time to validate and test the converted assets before making them part of your production workflows before you begin recommended migration approach before converting production playbooks, it is strongly recommended that you perform the migration in a development or test environment first migrating in a non production environment allows you to validate the converted canvas playbooks and components verify trigger behavior and workflow execution identify any migration specific changes that require updates become familiar with the canvas experience before migrating production workloads reduce the risk of unexpected interruptions in production environments after you have successfully validated the converted assets in a development or test environment, repeat the migration process in production prerequisites to use the playbook conversion tool, contact your administrator and ensure the following feature flags are enabled feature flag purpose playbook classic migration enables classic playbook to canvas playbook migration user notifications displays migration status notifications important requirements before attempting a migration the classic playbook must be enabled only one migration can run at a time while a migration is running, additional migrations cannot be started a classic playbook cannot be edited while it is being migrated convert all classic playbooks use this option when you want to migrate all eligible classic playbooks in bulk follow the steps to execute bulk migrations step 1 open the classic playbooks page navigate to orchestration > playbook classics when the required feature flags are enabled, the convert playbooks button appears at the top of the page step 2 start the bulk conversion select convert playbooks a migration information window appears the dialog provides information about canvas and explains that existing classic playbooks are not modified new canvas assets are created during migration migration may take some time status updates are delivered through notifications select cancel to exit without starting migration convert all to begin migrating all eligible classic playbooks step 3 wait for migration completion during migration you cannot edit the playbook while migration is in progress additional conversion requests cannot be started until the current migration finishes step 4 review migration results select the notifications icon in the application header a successful migration displays classic playbook migration completed select the notification to open the converted assets convert a single classic playbook use this option when you want to migrate one classic playbook at a time step 1 locate the playbook navigate to orchestration > playbook classics step 2 start the conversion open the playbook's more actions menu (three dots) select convert playbook the migration starts immediately step 3 wait for completion while migration is running the user interface prevents modifications to the playbook additional conversion requests cannot be started until the current migration finishes step 4 review the result open the notification feed after migration completes successful migrations display classic playbook migration completed selecting the notification redirects you to the migrated canvas playbook access converted assets when migration succeeds, the converted asset name is created using the following naming convention \<originalname> migrated for example threatenrichment migrated depending on the structure of the classic playbook, migration may produce a canvas playbook one or more components a combination of playbooks and components enable the converted canvas playbook converted canvas playbooks are disabled by default after validating the converted asset, enable it before using it in production workflows understanding migration outcomes the conversion result depends on the structure of the original classic playbook playbook without a trigger if the classic playbook does not contain a trigger, it is converted into a component after migration no canvas playbook is created a component is created instead the component name includes the migrated suffix locate the converted asset on the components page playbook with multiple triggers if the classic playbook contains multiple triggers the original workflow logic becomes a component a canvas playbook is created separate flows are generated for each trigger all generated flows reference the same component for example a classic playbook with two triggers produces one component one canvas playbook two flows within the canvas playbook playbook with promoted outputs canvas does not support promoted outputs in the same way as classic playbooks if a classic playbook contains a promoted output the playbook flow that contains the promoted output is converted into a component a canvas playbook is created to invoke the generated component the generated component is used to expose the output behavior in canvas migration status indicators each classic playbook displays a status icon indicating migration status status meaning checkmark migration completed successfully warning icon migration failed re convert a previously migrated playbook after a classic playbook has been converted, the menu option changes from convert playbook to convert playbook again when you select convert playbook again , a tooltip displays the following warning delete the existing converted canvas playbook before converting again to perform another migration delete any existing converted canvas playbooks or components associated with the classic playbook return to the classic playbook start the migration again troubleshooting failed migrations if migration fails, a notification appears some classic playbooks failed to migrate select the notification to view the failed playbooks list the dialog displays all playbooks that failed during migration to download detailed error information select download as txt open the downloaded file the report includes migration run details failed playbook information error messages failure reasons example failure if a migrated canvas playbook already exists, the report may contain canvas solution 'playbookname migrated' already exists delete the existing solution before re migrating this playbook resolution delete the existing migrated canvas playbook return to the classic playbook run the migration again important migration behaviors disabled classic playbooks only enabled classic playbooks can be migrated if a classic playbook is disabled it is excluded from bulk migrations it cannot be converted using the convert playbook option you must enable the classic playbook before attempting migration webhook triggers if your classic playbook uses a webhook trigger the webhook url changes after migration existing integrations continue referencing the original webhook url unless updated after migration open the converted canvas playbook retrieve the new webhook url update any external systems that call the webhook failure to update external integrations may prevent the canvas playbook from receiving events playbook buttons and correlations a playbook button or correlation can be associated with only one playbook at a time if a classic playbook is currently linked to a playbook button a correlation then during migration the association is removed from the classic playbook the association is transferred to the converted canvas playbook review these associations after migration to confirm they behave as expected best practices perform migrations in a development or test environment before production validate all converted playbooks and components before enabling them review webhook configurations after migration verify playbook button and correlation associations enable converted canvas playbooks only after successful testing resolve all migration warnings before deleting the original classic playbook