Project Packages

Package definition is introduced with FlexDeploy 5.0, where user can define package with list of files which can used during build request of with release definition. Package details can change during development life cycle as necessary. Users can continue to build ad-hoc packages i.e. without any name as before.

Packages are uniquely defined at partial deployment project, hence you can have package with same name in two different projects if necessary. Package list can be accessed from Packages button or green packages tab.

Project Packages tab and Packages button on Project Activity screen are only available when Package Build Type is set to "Packages Only" or "Both".

Security Permission

Execute Project permissions is needed for package create and edit. Users can create or update package from build request form also, hence this approach is taken for package security. Users will configure permission can also edit packages. 

Package list will display all configured packages for project. On page load the filters will be defaulted to show only "Active" packages created 3 months ago or after by the logged in user. In the example below those filters are removed to show all packages. 

Notice the "Latest Version" will provide a link to the latest build version for the given package. On the other hand, the columns between "Latest Version" and "Created On" are dynamic columns representing the latest deployment version to each environment for that given package. Every environment associated to this projects deployment instance(s) will display a column with the environment display name as its column header. These dynamic columns are sorted by the sort order defined in Topology → Environment. Clicking on these links for latest version or deployment version will navigate to the corresponding project workflow execution details.

Note

Partial Deploy Projects of type 'Salesforce' have the following extra data columns for Salesforce DX packages and Unit Testing:

  • Package Path
  • Version Syntax
  • Test Level
  • Tests

Following actions are available for package list screen.

ActionNotes
CreateCreate new package.
Edit / ViewClick on package name to edit or view package details.
DeleteDelete selected package. Executions for the package will not be deleted. If package is configured in Release, delete is not allowed.
BuildSubmit build request for selected package. Package details (files) will be used to initialize build request form.
DeploySubmit deploy request for selected package. Latest version for package will be selected by default. If package is not yet built, deploy button will be disabled.

When user clicks on package name or Create button, package details screen shows up as show below.

Following actions are available for edit package screen.

ActionNotes
BuildSubmit build request for selected package. Package details (files) will be used to initialize build request form.
DeploySubmit deploy request for selected package. Latest version for package will be selected by default. If package is not yet built, deploy button will be disabled.
ApplySave changes and stay on package details screen.
SaveSave changes and go back to previous screen.
BackGo back to previous screen without saving any changes.
DeleteDelete selected file from package.
Add File(s)

User can either type in partial file path and click Add File(s) to add all matching files or click Add File without entering anything in Search Files to Add input, Add File(s) popup will show up where user can search, select and add files.

Added files are appended to existing file list.

Add File(s) from Change LogsUser can add files from Change Logs by searching and clicking a revision. Each revision has a list of changed files which are appended to the existing files list. The list of revisions is populated from the configured SCM and selected stream.
Select - AllSelect all files.
Select - NoneSelect no files.
Select - InvertSelect files that are currently selected and vice versa.
Selected Files - RemoveRemove selected files from package.
Sort AllSort added files as per sequence definition done on Project Files screen.
File Drag and DropDrag and drop one file at a time. Dragged file is inserted before the file when it is dropped.
TopMove selected file to top of list.
BottomMove selected file to bottom on list.

When user clicks on Add File(s) from Change Logs button, search and select file revision screen shows up as show below.

Package Editable

Packages with a status of "Completed" or "InActive" can not be built or deployed. Once a package becomes "Completed" then it can no longer be edited. Also packages that are a part of an active release can not be set to "Completed" or "InActive".