Manage Package Versions
Packages support versioning to maintain a record of package changes throughout the promotion lifecycle. Each version of a package is uniquely identified and timestamped, providing traceability across the Workspaces where the package is promoted.
Package versions preserve the history of a package and allow previous versions to be accessed when needed. This helps maintain provenance of the package as it moves through development, testing, and production environments.
View Package Versions
Previous versions of a package are available from the package on the SDLC Manager page. Version information includes the package version and associated metadata, including Data Labels.
Use the version history to review the versions created for a package and identify when a particular version was created.
To view versions of a package…
Go to SDLC Manager.
Select the package for which you want to view the versions.
Select the three-dot menu at the top.
Select Version History. The Version History modal lists package versions, including:
Version ID
Version Name
Created On Date and Time
Created By
Alternatively, select the Version number on the package details page to view the version history.
Create a New File from a Package Version
You can create a new package file from any version in the version history, including the current version. The available action depends on whether the package version was created in the current Workspace or promoted into it.
Version Created in the Current Workspace
To create a new file from a package version created in the current workspace…
Go to SDLC Manager.
Select the package for which you want to view the versions.
Select the three-dot menu at the top.
Select Version History. The Version History modal is displayed.
Select the three-dot menu of the version.
Select + Create a New File.
In the Create new file from this version? modal, select Create New to create a new package version identical to the selected version.
Review or edit the default name of the version.
Select Save to create the duplicate, or Close to cancel without duplicating.
Version Promoted into the Current Workspace
To create a new file from a package version promoted into the current workspace…
Go to SDLC Manager.
Select the package for which you want to view the versions.
Select the three-dot menu at the top.
Select Version History. The Version History modal is displayed.
Select the three-dot menu of the version.
Select + Create a New File.
In the Create new file from this version? modal, select Create New to create a new package version identical to the selected version.
Review or edit the default name of the version.
Select Save to create the duplicate, or Close to cancel without duplicating.
Restore a Package Version
Restore a previous version of a package when an earlier state of the package needs to be promoted again.
A package version is restored in the original workspace where the package was created. This creates a new package version identical to the one being restored. The restored version can then be used for re-promotion to downstream workspaces.
When restoring a previous version, the restored package can be created as one of these:
Version 1 of a new package.
A new incremental version of the existing package, following the same versioning behavior used for workflows.
After the version is restored, use the standard package promotion process to promote it to the required downstream workspace.
To restore a version…
From the version's three-dot menu, select Restore Version.
Select Restore to create a new package version.
Select Cancel to exit without restoring the package.
Re-promote a Package Version
Re-promote a package version when a previously approved version needs to be used again in the same workspace or promoted to another workspace.
To re-promote a package version…
Go to SDLC Manager.
Select the package for which you want to view the versions.
Select the three-dot menu at the top.
Select Version History. The Version History modal is displayed.
Select the three-dot menu of the version that you want to re-promote.
Select Repromote version.
Select Restore Version to confirm the action.
For a package version that already exists in the current destination (upstream) Workspace, re-promoting it creates a new promotion request with the current Workspace as both the source and target. The request follows the standard approval process.
After the request is approved, a new package version is created in the current Workspace that is identical to the selected version. You can then use the standard package promotion process to promote that newly created version to downstream Workspaces.
Re-promoting a version does not overwrite or remove existing entries in version history. Each restore and subsequent promotion creates a new version record, preserving the complete history of the package.
Promotion History
Promotion history provides a record of package promotion activity, including who approved a promotion, when the package was approved, and associated approval information.
Promotion history is available on the package details page and can also be used to filter the promotion requests list.
To view the promotion history of a package…
Go to SDLC Manager.
Select the package for which you want to view the versions.
Select the Promotion History tab at the top.
Select a view to limit the requests shown:
All: Displays all promotion requests for the package.
Incoming: Displays requests promoting the package into the current Workspace.
Outgoing: Displays requests promoting the package from the current Workspace.
Use the filter option to further refine the requests displayed.
For each promotion request, the table shows:
Status: The current status of the request.
Request type: The type of promotion request.
Workspace: The Workspace associated with the request.
Requester: The user who submitted the request.
Date Requested: The date and time the request was created.
ID and Name: The identifier and name of the associated item.
Select Date Requested to sort the list by request date.