Work in the Microsoft Visual Studio IDE

You can do your ALM Octane work directly from the Microsoft Visual Studio development framework. To do so, install the ALM Octane plugin for Visual Studio.

Overview

Using the plugin, developers can connect to an ALM Octane workspace, view ALM Octane items, and make updates.

The plugins are open source.

The plugins support two-way integration:

  • The plugin updates all data in the host Visual Studio application.

  • Changes made in Visual Studio impact data in ALM Octane.

Back to top

Prerequisites

  1. Verify that your operating system is supported: 

    • Windows 10

    • Windows 8

    • Windows 7

  2. Verify that your software is supported:

    App / Plugin Version
    Microsoft Visual Studio

    2015 and 2017

    All editions: Community, Professional, and Enterprise

    ALM Octane Visual Studio plugin

    12.55.7 and later

    ALM Octane 12.55.7 and later

Back to top

Download and install the plugin

Download the plugin from the Visual Studio Marketplace.

  1. From within the Visual Studio IDE, choose Tools > Extensions and Updates > Online > Visual Studio Marketplace.

    Or, go to the Visual Studio Marketplace.

  2. Search for the ALM Octane plugin. Follow the on-screen instructions to install it.

  3. Continue to Connect to ALM Octane.

Back to top

Connect to ALM Octane

After installing, a new category of settings is available in Visual Studio. We use this area to connect Visual Studio to ALM Octane.

  1. In Visual Studio, choose Tools > Settings > ALM Octane.

  2. Enter the URL for the ALM Octane server. The format is: 

    https://<server>:<port>
  3. Enter the user name and password for logging into ALM Octane.

You can now work with ALM Octane from within Visual Studio.

Back to top

Work on your ALM Octane items

This section describes how to do your ALM Octane from the ALM Octane pane.

  1. Open the ALM Octane pane

    Choose View > Other Windows > ALM Octane. The ALM Octane pane displays work assigned to you.

    When you start another session, the ALM Octane Visual Studio plugin remembers what you were working on last time, and opens tabs in the ALM Octane pane accordingly.

    Most ALM Octane items are available from the IDE.

  2. View an item's details

    Double-click most items to open their details in a separate pane.

    Click to choose which fields to see. These settings only affect you. When you start another session, the ALM Octane Visual Studio plugin remembers your field selection.

    Click to view the item's comments.

    Tip: You can also:

    • Open the item directly in ALM Octane in a browser. Press Alt and double-click the item in the ALM Octane pane.

    • Right-click the item and choose one of the following options from the context menu: Show Details and Open in Browser.

  3. Search for items

    You can search all ALM Octane items and display the results in a new tab, showing only the relevant items based on search criteria.

    Tip: The search looks through all ALM Octane items, not just the ones assigned to you. You can use the search to assign an item to yourself.

    Enter a search string in the search box. The search results are opened in a new pane.

    The plugin remembers the last five searches you ran. Click the drop-down arrow to select one and re-run the search.

  4. Update your items

    As you implement stories and fix defects in Visual Studio, update your ALM Octane items.

    • Move the status of an item from one phase to another, according to the defined ALM Octane workflow. Make sure to save .

    • Click Comments to view and add comments.

  5. Download Gherkin test scripts to implement automation

    Gherkin tests can be initially created in ALM Octane, and then automated using Visual Studio.

    In the ALM Octane pane, right-click a Gherkin test, and choose Download Gherkin Script.

  6. Commit changes with generated messages

    When you commit changes for an item, automatically-generated text can be copied and pasted into the commit message for the item.

    You can commit changes for user stories, quality stories, defects, or active tasks.

    1. In the ALM Octane pane, right-click a user story, a quality story, a defect, or an active task.

    2. To generate the text for the commit message and copy it into the clipboard, right-click the item and select Commit Message to Clipboard.

    3. Commit your changes. In the Git Staging area, paste the contents of the clipboard into the Commit Message area.

      The format for the commit message contains the item type, the item ID, a colon (:), and the item name. You can enter more details for your commit message after the name.

      For tasks, the item related to the task (such as a story or defect) is also included.

    You can also manually edit commit messages. For details, see Track changes committed to your Source Control Management system.

Back to top

See also: