--- title: "Scenario 3: Promotion of a PingOne DaVinci flow (early access)" description: Learn how to promote a PingOne DaVinci flow and understand how flow versioning is handled during promotion. component: pingone page_id: pingone:early-access-features:ea-p1_config_promotion_scenario_3 canonical_url: https://docs.pingidentity.com/pingone/early-access-features/ea-p1_config_promotion_scenario_3.html revdate: December 22, 2025 section_ids: configure-and-run-the-promotion-in-the-source-environment: Configure and run the promotion in the source environment steps: Steps result: Result verify-the-promotion: Verify the promotion steps-2: Steps result-2: Result --- # Scenario 3: Promotion of a PingOne DaVinci flow (early access) The goal of this scenario is for you to promote a PingOne DaVinci flow so that you can understand how flow versioning is handled during promotion. In this scenario, you'll promote a DaVinci flow named **Test Registration, Password Reset, and Recovery** from the **Promotion-Source** environment to the **Promotion-Target** environment. This flow has four versions in the source environment, and **Version 3** is the deployed version. ![A screenshot of the Test Registration, Password Reset, and Recovery flow in the Promotion-Source environment showing that there are four versions of the flow and Version 3 is the deployed version.](_images/p1-promote-test-dv-flow-in-source.png) No versions of the flow exist in the target environment. ![A screenshot of the Promotion-Target environment showing that there are no versions of the Test Registration, Password Reset, and Recovery flow.](_images/p1-promote-test-dv-flow-not-in-target.png) ## Configure and run the promotion in the source environment To configure the promotion, you'll confirm the target environment, select the resource to promote (the **Test Registration, Password Reset, and Recovery** flow), and determine whether the resource should be created as new in the target environment or mapped to an existing resource. Then you'll run the promotion. ### Steps 1. In the PingOne admin console for the **Promotion-Source** environment, go to **Promote > Promotions**. 2. Click **Run a Promotion**. 3. On the **Confirm Target Environment** modal, ensure that **Promotion-Target** is selected in the **Target Environment** list. 4. Select **The correct environment is selected and I want to continue** and click **Confirm**. ![A screenshot of the Confirm Target Environment modal with Promotion-Target selected in the Target Environment list and the confirmation checkbox selected.](_images/p1-promote-confirm-target-env.png) After you confirm the target environment, PingOne takes snapshots of both environments, compares configuration resources, and lists the resources that you can promote. ![A screenshot of the Select Resources to Promote page without anything selected.](_images/p1-promote-select-resources.png) 5. On the **Select Resources to Promote** page, search for the **Test Registration, Password Reset, and Recovery** flow and select it. ![A screenshot of the Select Resources to Promote page showing the Test Registration, Password Reset, and Recovery flow.](_images/p1-promote-select-dv-flow.png) 6. Click **Next**. The **Map Resources** page displays. Because no versions of the flow exist in the target environment, the promotion service indicates that the flow will be created as a new resource. ![A screenshot of the Map Resources page showing that the Test Registration, Password Reset, and Recovery flow will be created as a new resource.](_images/p1-promote-scenario3-map-resources.png) 7. Click **Confirm and Continue**. | | | | - | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | For the purposes of this scenario, there are no dependencies to map. If there were dependencies, you would need to map them on the **Auto-select Dependencies** page before continuing. | 8. Verify the promotion details on the **Confirm Promotion** page, enter release notes, and click **Run Promotion**. ### Result You're returned to the **Promotions** page and the current promotion is listed with a status of **In Progress**. After about 30 seconds, refresh the page. The status will change to **Success** for a successful promotion. ![A screenshot of the Promotions page showing a successful promotion.](_images/p1-promote-promotion-successful.png) ## Verify the promotion To verify the results of the promotion, first confirm the details of the promotion in the source environment, then ensure that the flow exists as expected in the target environment. ### Steps 1. In the PingOne admin console for the **Promotion-Source** environment, go to **Promote > Promotions**. 2. Locate the promotion in the list, click the **More Options** icon (⋮), and select **View**. | | | | - | ------------------------------------------------------------------------------------------------------------------ | | | Promotions are listed in reverse chronological order, so the most recent promotion appears at the top of the list. | * Overview tab The **Overview** tab shows information about when the promotion was started and completed, the source and target environments, the status of the promotion, and any release notes that were added. ![A screenshot of the Overview tab for the initial promotion of the Test Registration, Password Reset, and Recovery flow.](_images/p1-promote-verify-promotion-dv-flow-overview-tab.png) * Promoted Resources tab The **Promoted Resources** tab shows that the **Test Registration, Password Reset, and Recovery** flow was promoted to the target environment. ![A screenshot of the Promoted Resources tab for the initial promotion of the Test Registration, Password Reset, and Recovery flow.](_images/p1-promote-verify-promotion-dv-flow-resources-tab.png) 3. On the **Overview** tab, click **View Target Environment**. You're taken to the PingOne admin console for the target environment so that you can confirm that the promoted resources exist and match what you expect. 4. For this scenario, go to **DaVinci** and click **Flows** in the sidebar for the DaVinci admin console. The **Test Registration, Password Reset, and Recovery** flow is now listed on the **Flows** page in the target environment. ![A screenshot of the Test Registration, Password Reset, and Recovery flow in the target environment.](_images/p1-promote-dv-flow-promoted-in-target.png) 5. Click the **Test Registration, Password Reset, and Recovery** flow to open it. 6. Click the **More Options** icon (⋮) in the header and select **Flow Versions**. ### Result The **Flow Versions** panel displays, showing that, as expected, **Version 3** of the flow was promoted and is the only version in the target environment. ![A screenshot of the Flow Versions panel showing that Version 3 of the Test Registration, Password Reset, and Recovery flow is the only version in the target environment.](_images/p1-promote-dv-flow-promoted-in-target-showing-version.png)