Branching in batch mode

Description

We can find in the root directory of BranchManager for DOORS additional files :

Example

Objective: create our first branch by using Command Line script.

We will reproduce the first branching tutorial using Command Line.

In this first Tutorial, we will perform the simplest branch operation possible, that of a single module with no out-links.
(Help Contents…>Tutotials>Branch Lessons>Branch Lesson 1: The Simplest Branch)
  1. Set up Tutorials Database. - For that you have to run the setup script provided.:

    Tag List Editor

  2. Create a new target project - ("BranchTutoCL") to branch into:

    Before branching, you need to create a project to branch into.
    For the purpose of this lesson, create a new project in the root directory of DOORS Database:

    right-click in an empty space of the list view on the right side of the database explorer, choose New > Project...
    Enter a name for the new project, e.g. "BranchTutoCL", and press OK.

    Tag List Editor

  3. Create the TagList File - text file containing the tags to branch:

    The objectives is to create a taglist.txt which you can create by pasting a taglist created by the TagList Editor (using the TagLists tab and Edit TagList button).

    Now start the "Edit Tag Lists" script by choosing the Configuration Mgt > Edit Tags List menu option.

    Select the module baseline to branch: in our example we want to branch "Module X" from BranchManager Tutorial for [user] >2.0 Branch Lessons > 2.1 The Simplest Branch for [user]

    Tag List Editor

    Click on "Edit Taglist" button.

    Select and copy the content.

    Tag List Editor

    Paste the content in a new a text file (Taglist.txt) created in the root directory of BranchManager.

    Tag List Editor

    The Taglist.txt will contain just one module in our example:

    Tag List Editor

  4. Create/Edit the Branch Script:

    You can find in the root directory of BranchManager a script example ‘runBranchQuick.bat’.

    It’s an example of how a call to the runBranch.bat file looks:

    syntax:

    runBranchQuick.bat original example :

    Tag List Editor

    We will update this script as following:


    Result is something like this:

    Tag List Editor

    Note: There cannot be any spaces in the target project name! During DOS batch execution, it attempts to resolve it as a file name.

  5. launch the script and check result:

    Double click on the runBranchQuick.bat

    Branching is completely the same, you will even see the progress bar.

    To check the result: open BranchManager for DOORS and look in your Target Project ("BranchTutoCL"), you will find "Module X" branched.

    Tag List Editor

Limitation