Creating Git reference mapping

Git reference mapping associates a Git reference, such as a branch, with a IBM® Engineering Workflow Management (EWM) process area.

About this task

You can only create a Git reference map with a process area that is a child of the process area that is associated with the Git repository. For example, if team area A is associated with a Git repository, team area B can be associated with a Git reference in that repository, if team area B is a child of team area A. After you create a Git reference map, you can enforce process rules on a branch, such as which roles can have permissions to commit to the branch.

Procedure

  1. In the repository editor, define a Git reference name.
    For example, define refs/heads/master, where refs represents the master branch.
    Note: When you define reference mapping, you can use a wildcard expression, such as refs/heads/dev/* and associate it with a process area. Then, all branches under dev are governed by the associated process area. In another example, if both refs/heads/dev/* and refs/heads/dev/feature1 branches are mapped, then for the feature1 branch, the corresponding process area is used for process enforcement.
  2. Save the Repository mapping.
  3. Optional: To map any unmapped Git references to the process area of the Git repository, select the Use this process area for unmapped references check box.
  4. Optional: You can enter a functional user ID and password to access the Git repository to get commit details like files changes and differences for each file. On the Settings page, in the Git Server Authentication Details area, enter a user ID and password. Save the changes.