Branch Project: Upload Codebase

The Upload Codebase page in the Branch Project wizard identifies and uploads one or more codebase files for the branched project. For each codebase you want to upload, repeat the process of selecting the codebase archive, specifying the upload options, and then uploading the codebase.

This page is enabled only if you selected the Upload Codebase option from the previous Project Information page.

If you also selected the Sync with Source Control option on the Project Information page, the codebases obtained through synchronization with your Source Control Management system (described in Branch Project: Version Control Settings) during the branching operation will be added to the codebases uploaded from this page. For a description of the procedures related to the Upload Codebase page, see the following:

• Branching a Project
• Step 2: Uploading a Codebase (Optional)

The following describes the properties and actions available on the Upload Codebase page:

Branch Project: Upload Codebase Page

Field

Description

Select Archive File

Click this button to select the archive file containing the codebase you want to upload. The selected archive is displayed in the text box next to this button.

Only a .zip, .tar, .tar.gz, or .7z archive is accepted. The maximum archive file size is 10 GB.

Delete existing project codebase files

Select this option to delete all codebase files that you might have already uploaded from this page and replace them with files from the codebase currently selected for upload. If you leave this option unchecked, files from the selected codebase are added to the already uploaded files.

Archive Expansion Options

Configure the behavior of archive expansion during the upload:

• Uploaded file only—Extract the files from the uploaded archive. Any extracted archives are not expanded.
• Uploaded file and first-level archives only—Extract the files from the uploaded archive and expand all first-level archives in the codebase. Note that the expanded archive itself is retained along with its extracted contents in the parent folder.
• Uploaded file and all contained archives—Extract the files from the uploaded archive and expand archives at all levels (that is, archives with archives within archives and so forth) in the codebase. Note that each expanded archive is retained along with its extracted contents in the parent folder.

Configure the of the upload process once archives are expanded. These settings are optional and are enabled only if the Uploaded file and first-level archives only or Uploaded file and all contained archives option has been selected.

• Delete archive files after expansion—Remove those archives that have been expanded during an upload. (The archive is removed from the uploaded codebase after the upload is finished.) If you leave this option unselected, the archive is retained as an additional file directly under its parent folder.
• Append value to expanded archive directory name—(Optional) Define a string to append to the name of any folder automatically created during the upload to store an archive’s contents. After the codebase is scanned, this appended string helps you to identify those folders in the codebase tree whose contents were extracted from archives, especially if the original archives were removed from the codebase during the upload (see the previous option).

For example, suppose the appended value is _archive, and the upload process extracts an archive called 7z.zip. After the upload process expands the archive, the name of the folder containing the archive contents becomes 7z_archive, as shown in this example. Note that the example also shows that the 7z.zip archive has been removed due to the selection of Delete archives after expansion.

This appended value has a maximum of 20 characters and does not support certain special characters. (Hover over the icon for a list of unsupported characters.) For more information about archive expansion during a codebase upload, see More About Archive Expansion Behavior During Codebase Uploads.

Upload Project Codebase

Click this button to upload the selected codebase.

Once the upload completes, you can upload another codebase by selecting its archive, specifying the appropriate expansion option for the upload, and clicking this button again. You can upload as many codebases as needed.

Next

Click this button to move to the next available wizard page.

If you selected Sync from Source Control on the Project Information page, the Version Control Settings page in the wizard opens. If you did not select this option, the Project Copy Settings page opens.

Back

Click this button to navigate back to the Project Information page. Note that you cannot edit the Name field for project. Additionally, if you uploaded a codebase, the Scan Server and Upload Codebase options on the Project Information page are disabled.

Cancel

Click this button to cancel the project-branching setup. The branched project and any uploaded codebases for the project are deleted from Code Insight.