Getting started with Engineering Workflow Management source control
Engineering Workflow Management source control is a component-based version control system that is built on the Jazz platform. You can use Engineering Workflow Management source control to manage source code, documents, and other artifacts that you want to place under version control and share with a team.
- The Jazz® Build Engine
and Build System
Toolkit have built-in support for the following tasks:
- Loading files from Engineering Workflow Management source control.
- Capturing snapshots of build input so that a build can be reproduced exactly.
- Accessing rich set of tools that you can use to view the component versions in a specific build. You can also compare the components with their versions in other builds, streams, and workspaces.
- You can link change sets to work items, which enables traceability for individual changes and provides insight into why they were made. For more information, see Tracking work by using work items.
- You can use process pre-conditions to control the flow of change sets. For example, you can configure a process so that a change set must be reviewed and approved before it can be delivered to an integration stream. For more information, see https://www.ibm.com/docs/en/elms/elm/7.1?topic=SSYMRC_7.1/com.ibm.jazz.platform.doc/topics/t_projects_teams_process.dita.
Workspaces, change sets, and change flow
Engineering Workflow Management source control stores artifacts such as files and folders in the Jazz repository. You create a repository workspace to hold your private copies of the files and folders that you want to work with. Then, you load the contents of your repository workspace into a sandbox (a directory in your computer's file system). The files and folders in the sandbox are accessible to tools, such as editors, compilers, and integrated development environments. As you make changes to the contents of your sandbox, you periodically check them in to the repository workspace so that the changes are backed up on the server. In the repository workspace, related changes are collected as change sets, which deliver changes to multiple files and folders in a single operation.
First steps with Engineering Workflow Management source control
- When you work on your own, you typically create a project in your Eclipse workspace, share it to put it under Engineering Workflow Management source control, and proceed to check in your changes. As needed, you can create workspace snapshots that preserve important configurations so that you can re-create them if you need to. For more information, see Working independently in Engineering Workflow Management source control.
- When you work as part of a team, you might start by accepting a team invitation, or you might create a new repository workspace from one of the team's streams.
The following diagram demonstrates a sample source control workflow. The diagram is provided only as an example. Although you can complete many of the steps in either the Web client or the Eclipse client, these steps link to topics for the Eclipse client.