This section defines the versioning terms that are important to understand.
Asset
A resource under the control of the version management system used by ATG Content Administration—for example, foo.html
. An asset maintains a list of its own asset versions.
Asset Version
A specific version of an asset—for example, version 2 of foo.html
. Each asset version has a unique version number. The initial version of an asset is always version 1. When a new asset version is created, it is immediately assigned the next available version number.
Head Version
The most recent version of an asset for a particular branch.
Development Line
In other version management systems, a set of assets is often called a line of development or code line. In ATG Content Administration, a development line is one of the following:
Branch: A named, modifiable line of development that includes a specific set of assets. ATG Content Administration provides an empty main branch. As part of the process of setting up your asset management server, you import your initial set of assets into the main branch.
Branch assets are modifiable only if they are checked out into a workspace.
Workspace: A working, editable set of asset versions. Workspaces are always created from branches. Asset versions are checked out into workspaces, where they can be edited or deleted.
Every ATG Content Administration project has its own workspace that includes the working set of asset versions for the project. When a user creates a project in the Business Control Center, the VersionManager is called to create a workspace for the project. The user can then add one or more asset versions into the project workspace. When the project is complete, the updated versions of the project assets are checked into the repository, and the workspace itself is marked as checked in.
Snapshot: A set of assets identified by a timestamp in the database and the project
checkin_date
.
VersionManager
The VersionManager
service manages all development lines that are created and used in the content development environment. It is the central factory for creating, storing, and querying all versioning objects: development lines, assets, and asset versions. ATG Content Administration provides a default VersionManager
, which is located in Nucleus at /atg/epub/version/VersionManagerService
.
The development lines managed by the VersionManagerService
are stored in the /atg/epub/version/VersionManagerRepository
, which is also provided with ATG Content Administration.