Manage packages (Beta)

Use packaging to deploy the same changes across multiple environments.

Overview

In the Skedulo web app, a package is a way of collecting, or compiling, elements so that they are easily portable across tenants. Packaging automates the process of replicating changes across tenants, making it possible to push changes across multiple tenants in one go, rather than manually updating each tenant. This both saves time and reduces the likelihood of error.

Currently, you can package elements of the following features:

  • Standard objects and fields.
  • Custom objects and fields.
  • Global navigation configurations.
  • Roles (except admin roles.)

Package management settings page

The Package management settings page enables you to import and export packages, view your import history, and view the packages you’ve created. To access this page, select Settings > Manage Packages.

manage-packages-page.png

Create a package

To create a package on your tenant:

  1. Navigate to Settings > Manage Packages.
  2. On the Package Management page, select the Export tab.
    Manage-packages-export-tab.png
  3. In the Package name field, enter a name for the package.
  4. If required, enter a version number for your package in the Package version field. A version number will help you to identify the package on the Available Packages list.
  5. Enter any notes you want to include with the package. This information will help you to identify the package on the Available Packages list.
  6. Click Add Items to display the Add Items modal.
    manage-packages-add-item-modal.png
  7. Use the options on the modal to build your package. You can:
    • Select an item type from the dropdown to narrow down which items are visible in the list.
    • Click a chevron beside an item type to show the available items for that item, then individually select the items you want to include.
    • Click Select all to add all listed items to your package.
    • If you want to include all items that have been updated, select Add all updated items.
  8. Review the items you have selected in the panel on the right-hand side, and then click Apply to save your changes and return to the Export tab.
  9. On the Export tab, the items you’ve selected to be packaged are displayed in the Package contents list, separated by type. Easily remove unwanted items by clicking the x in an item’s lozenge. Please note that currently, you cannot export more than 30,000 items. manage-packages-package-contents.png
  10. Click Create Package to create the package. You are taken back to the Overview tab, and the new package is visible at the top of the Available Packages list. manage-packages-overview-tab.png
  11. Click Download file to download the package ready for sending to your destination tenants.

Import a package

To import a package from another tenant:

  1. On the Package Management page, select the Import tab.
    manage-packages-import-tab.png
  2. Click Browse and navigate to the file you want to import.
  3. Click Upload. The Confirm configurations modal is displayed, which lists the items contained within the file.
    manage-packages-confirm-configurations.png
  4. Click Import. The modal closes and the Package Details page is displayed, which shows a summary of the file and the status of the upload.
    manage-packages-task-details.png
  • If the package imports successfully, the status changes from InProgress to Success. Click Import at the top left-hand side of the page to return to the Import tab, where you can view your import history.
    manage-packages-imported.png

  • If an error prevents a package from importing, the status changes from InProgress to Failed. Click Why? beside the status lozenge to open the error log and view more details. manage-packages-failed.png