› Packages › Work with packages

Work with packages

You can modify, export, copy, unlock, deploy and delete a package.

To work with packages, navigate to Packages > Packages. A list of packages appears.

Modify a package

  1. In the Packages list, click the package to modify.

    The package opens in a new browser tab.

  2. Make changes as needed.
  3. Save the package.

Export a package

You can export a package for reuse. A package is exported as a .ZIP file. Only resources that have at least read permissions can export a package.

The exported package includes all the items associated with the package along with the sub-packages.

  • Associations of process and forms are automatically included in the package.

  • Skins are not included as part of associations; you need to include them as part of process export options.

  • The thread pools, server variables, web service references, and server XML expression variables are automatically exported.

  • Any associated reporting tags are exported.

  • All images included in the package are exported in the Images folder.

  • Any document templates, custom pages, .NET Dlls and style sheet are exported in the Assets folder.

    The .NET DLLs are only exported, if they have been added to the package manually.

  • Depending on the selected options for the device settings (include devices, device profiles and device settings), an XML-formatted string package is generated using the stored data inside the Device Manager database, and these properties are included in the package when exporting.

  1. In the Packages list, on the context menu of the package to export, click Export.

    Alternatively, you can also export the package using the Export option on the package modeling bar.

    The Export dialog box is displayed.

  2. By default, no deployment is selected and all the deployment configurations defined in the package are exported. To include the deployment configuration in the package, on the Deployment list, select a deployment type.

    The deployment configurations settings for the selected deployment type are exported and the values for the global variables, server variables, web services and device settings defined in the base package as applicable, are overwritten with the values from the selected deployment type. For example, if the server variable value in a base package is BaseDB and the server variable value in the production deployment type is ProductionDB, after export, BaseDB is overwritten with ProductionDB.

  3. Click OK.

    A message prompts you to download the ZIP file.

  4. Click Yes.
    The package is exported. If any errors occur during export, Error.txt is generated with the error details. In some scenarios, a warning message is displayed and the package is not exported.

Copy a package

  1. In the Packages list, on the context menu of the package to copy, click Copy.

    A copy of the package prefixed with "Copy 1 of <package name>" appears on the Packages page.

  2. Customize the package as needed.
  3. Save the package.

Unlock a package

Whenever a package is saved, it is locked by default so that other resources cannot modify it. You can unlock a package to allow modification.

In the packages list, on the context menu of the package to unlock, click Unlock. On confirmation, the package is unlocked and is available for modification.

You can lock a package again. When you open an unlocked package, a message appears to confirm whether to lock the package. On confirmation, the package is locked. See Lock or unlock an item for more information.

Delete a package

In the Packages list, on the context menu of the package to delete, click Delete. On confirmation, the selected package is deleted.

You cannot delete a package that is locked by another user.

Deploy a package

  1. In the Packages list, on the context menu of the package to deploy, click Deploy package.
    A new browser tab opens. The Deployment tab displays the artifacts available in the package. The artifact name, artifact type, versions and values are displayed.
  2. Do the following on the Deployment tab.
    1. Select the Deployment configuration.
    2. On the Deploy to list, select the deployment server to which to deploy this package.
    3. By default, the Execute test cases check box is selected.
  3. To filter the artifacts by groups, on the Artifact list, select the group such as Workflow.

    All the artifacts such as processes, from the selected Workflow group are displayed.

  4. Click Deploy.