Capsule package

This topic describes the Capsule package section, how to create a Capsule package, and its other features.

 

The Capsule package page allows you to create and manage Transporter packages that you can run to transport the Capsule folders and Capsules of a package to the current Platform. You can use this feature to transfer the Capsule folder structure from one Platform to another by creating a Capsule package on one Platform and then uploading and running the package on another Platform.

 

To access the Capsule packages section, access the System Administration space of the desired Platform and click on the Capsule packages tile. You will be taken to the Capsule packages page.

In the Capsule packages page you can see all existing Capsule transporter packages and their main information: the table is sortable and searchable using the interactive header fields. You can also show or hide columns to your liking, by clicking the Column chooser button in the upper right corner of the table.

The table contains the following information:

• Name. This column displays the name of each Capsule package
• Source platform. This column displays the name of the source environment where each Capsule package was created
• Target platform. This column displays the name of the target (current) environment where each Capsule package will be run
• Comments. This column displays additional comments on each Capsule package. You can click on the desired column field to edit a comment
• Run. This column displays a button that you can click to run a Capsule package
• Last run. This column displays the date and time of the last run of each Capsule package, in the following format: DD/MM/AAAA, HH:SS 
• Result. This column displays the result of the last run of each Capsule package 
• Size. This column displays the total storage space in MegaBytes that each Capsule package occupies on the Platform machine

 

Creating a Capsule package

To create a Capsule package, proceed as follows:

1. From the Capsule packages section of the desired Platform, click on “+TRANSPORTER PACKAGE” in the upper left corner to bring up the "New transporter package" configuration panel. You can also do this by clicking on the same button in the Capsule snapshot page explained above.
2. Snapshot selection. Here you must choose the source Capsule snapshot on the left drop-down list and then choose the target Capsule snapshot on the right drop-down list. You can click on the arrow in the middle to switch them
   
3. Target structure definition. Here you can select or deselect the Capsules and Capsule Folders in the list that you want to include/remove from the target snapshot’s structure that will be applied to the Platform where the package is executed. Essentially, here you can clean the target structure, if needed.

   The list displays the full structure of the target Capsule folders and Capsules along with a date and time that indicates the last time each Capsule folder and Capsule was modified
   

4. Snapshot comparison. Here you must configure which Capsules you want to transfer from the structure of the source snapshot to the structure of the target snapshot. The mappings are displayed in a table view that contains the following information:

   • Source structure: This column shows the full path of each Capsule in the source structure

   • Last update: This column displays the date and time of the last time each Capsule of the source structure was modified

   • Target structure: This column displays the full path of each Capsule in the target structure

   • Last update: This column displays the date and time of the last time each Capsule of the target structure was modified

   • Action: This column displays if a target Capsule will be updated or created. The column will display "No changes" in the case where a Capsule is the same in both source and target structures and has the same "Last Update" dates

   • Comparison Log: This column displays a "COMPARE" button that you can click to open the "Compare log" pop-up window where you can check the differences between source and target Capsules, only in the cases where the Capsules in the target structure will be updated. The "Compare log" shows a table-view, similar to the source and target structure mappings one, which displays the name of the Screens, Procedures, Masks, and images that will be created, deleted, or updated in the Capsules of the target structure.
     

   You can configure the mappings between source structure and target structure in the following ways:

   1. Auto compare. You can click on the "AUTO COMPARE" button to copy the entire source structure to the target structure. Board will automatically compare the two structures and update the Capsules of the target structure that have the same name and are located in the same Capsule folders as in the source structure, and add any Capsules and Capsule folders that do not currently exist in the target structure

      You can manually edit, delete or add a mapping row after performing the Auto compare feature.

   2. Manual mapping. You can click on the "+NEW MAPPING" button to add one or more rows which you can manually configure to specify the Capsules you want to transfer. To do this, proceed as follows:
      1. Click on the "+NEW MAPPING" button to add a mapping row
      2. From the "Select source capsule" drop-down list on the left, choose the source Capsule that you want to transfer
      3. Click on the "Capsule/Folder" field to open a drop-down list where you can choose a target Capsule that you want to update/substitute (the Action column field will display the "Update" value) or choose a Capsule folder where you want to transfer the source Capsule (the Action column field will display the "Create" value).

         In addition, you can manually enter the target path and change the name of the target Capsule in the "Capsule/Folder" field. You can enter the path and name in the following format: CapsuleFolder/CapsuleSubFolder/CapsuleName.bcps
         

         In the cases where you are transporting the structure of a Development environment to a Production environment, it is highly recommended not to manually create a Capsule folder structure in the target Production environment that is different from the Development environment and therefore has not been tested.

      You can click on the "CLEAN TABLE" button to delete all the mappings from the table.

5. Summary. Here you can check a preview of the package configuration. Board displays a table that contains the following information:
   • Package structure: This column displays the structure of the target after the mapping configuration
   • Source: This column displays the names of the Capsule folders and Capsules of the source structure that have been mapped to the Capsule folders and Capsules of the target structure
   • Action: This column displays the type of action that will be performed on each Capsule and Capsule folder when you execute the package in the target Platform. The actions can be Create, Update, Remove, or No changes.

   

6. Info. Here you must enter the name of the package in the "Name" field and add any additional comments in the "Notes" field. You can also enable the "Backup" option, which automatically creates a snapshot of the Capsule folder structure of the current Platform when you run the current Capsule package.

   If the storage space limit is reached, Board will automatically delete the oldest snapshots to free the necessary space for the new snapshot. The snapshots that have the "Golden copy" option enabled are excluded from the automatic deletion.

7. Click on "SAVE CHANGES" to save the Capsule package

 

Managing a Capsule package

The Capsule packages page allows you to perform the following management tasks on existing packages:

• Edit a Capsule package
• Remove a Capsule package
• Download a Capsule package to your local computer.
• Upload a Capsule package to the Platform you are working on

To edit a Capsule package, select it to bring up the package configuration panel and modify the desired options explained in the steps in the Capsule package creation process.

The package configuration panel displays additional information under the following menus:

• CONTENT. This menu contains a table that displays the Capsule folder structure of the selected package
• AUTOMATION COMMANDS. This menu contains the commands that you can use to run the package via the CLI Automation
• LOGS. This menu contains a log that provides information about the execution of the package.

 

To delete Capsule packages, select the desired ones and then click on the "DELETE" button.

 

To download Capsule packages, select the desired ones and then click on the "DOWNLOAD" button. A .trsp file that contains the selected packages will be downloaded to your local machine.

 

To upload Capsule packages, Click on the "UPLOAD" button and choose the .trsp file containing the Capsule folder structure of the package.

 

Running a Capsule package

To run a Capsule package, proceed as follows:

1. From the Capsule packages page, click on the button under the "Run" column of the desired Capsule package to run it
   
2. Board will perform a pre-execution check where it will list any possible warning or error messages. You may find these messages in the following cases:
   1. The Capsule package action on a Capsule displays the value "Update", but that Capsule does not exist in the current Platform. The Capsule package will create that Capsule in this case
   2. The Capsule package action on a Capsule displays the value "Create", but that Capsule already exists in the current Platform. The Capsule package will overwrite that Capsule in this case
   3. The Capsule package action on a Capsule displays the value "No changes", but that Capsule is different in the current Platform. The Capsule package will overwrite that Capsule in this case
   4. The Capsule package action on a Capsule displays the value "No changes", but that Capsule does not exist in the current Platform. The Capsule package will create that Capsule in this case
   5. The Capsule package action on a Capsule displays the value "Remove", but that Capsule does not exist in the current Platform. The Capsule package will not do anything in this case

   

   You cannot run a Capsule package if there are errors during the pre-execution check.

3. Click on "RUN PACKAGE" to run the package execution

The configured Capsule folder structure and content of the package will be applied to the current Platform after you run a successful execution of the package.