› Packages › Add a package to GitHub › Check in an item checked out to GitHub

Check in an item checked out to GitHub

When the source control is turned on, after making changes to the package or the items in the package that are checked out to GitHub, you can check in only the package definition or the package along with items, or individual items and commit changes to GitHub.

  • When you check in a package or add an item to GitHub, the version of the package or item increases only if the package is modified and there are unsaved changes. For example, the version will increase when you change the description of the package or add/remove the items or modify an individual item.

  • You can rename an item while checking in the item to GitHub.

  • When checking in an extraction group, any associated document and activity variants are updated in GitHub.

  • When checking in a process, any associated skins are updated in GitHub.

  • When checking in a form, any associated form variants are updated in GitHub.

  • When checking in an extraction group, the associated classification groups are also checked in.

  • When you check out and get the latest version of an item if the version in GitHub is higher than the version in TotalAgility, the item is imported from GitHub and checked out and locked.

  • When you switch between working folders and try to check in an item that is in GitHub under a different folder than your current working folder, the item is checked into its original working folder, that is the place it was checked out from.

To check in an item, you should have configured GitHub integration. See Configure GitHub integration in System settings.

Check in a package

You can check in a package that is checked out to GitHub.

  1. Navigate to Packages > Packages.
    The Packages list page appears.
  2. On the context menu of the package to check in, click Check in.

    Alternatively, use the Check in option available on the modeling bar of the package to check in the package.

    The Check in to GitHub dialog box is displayed.

  3. Optional. Add a Comment for the updated package.
  4. When you check in the package, by default, any items that are newly added to the checked-out package and are not under source control, are checked in to GitHub. To include the items that are already checked out from the package that exists in GitHub along with the package definition, select Check in all items in package. The items that are newly added to GitHub display a source control indicator which can be viewed from the list pages of the items.

    If you do not select Check in all items in package, only the package definition is checked in to GitHub. You can check in the individual items to GitHub from the respective list pages.

  5. By default, after checking in a package, the changes are committed to GitHub. The package is then available to other users for checking out. To keep the package checked out and locked with the current user after checking in the package to GitHub, select Keep checked out. The items that are already checked out from the package that exists in GitHub and then modified are checked in but remain in checked-out state with the current user. The newly added items to the package if any, are added to GitHub but do not remain in the checked-out state.

    You can rename a package while checking in a package to GitHub. However, the associated working folder remains the same as that was set within the File > Info tab.

  6. Click Check in.

    The package is checked into GitHub.

Check in an individual item from the package

You can check in an individual item from the package that is checked out to GitHub.

  1. Navigate to the list page of the item, such as process.
  2. On the context menu of the process that is checked out, click Check in.

    Alternatively, use the Check in option available on the modeling bar of the item such as process to check in the process.

    The Check in to GitHub dialog box is displayed.

  3. Optional. Add a Comment for the updated item.
  4. By default, after checking in an item, the changes are committed to GitHub and the item is available for checkout for other users. To keep the item checked out and locked with the current user after checking in the item to GitHub, select the check box for Keep checked out. The checkout and lock will remain for the item after checking in, and the item remains open if it was opened when checking in.

    If the option is not selected, after checking in the item to GitHub, the item does not remain in the checkout state and the lock is removed and the item is closed if it was opened when checking in.

  5. Click Check in.

    The item is exported and updated on GitHub.