Apache NetBeans plugin

This topic describes how to use the Git Client IDE plugin with Apache NetBeans.

Clone streams

You can clone a Dimensions CM stream and populate the main branch in a Git repository with the tip of a stream.

To clone a Dimensions CM stream:

  1. In NetBeans, select Team > Git > Clone. The Clone Repository dialog box opens.
  2. In Repository URL, enter the URL of the Dimensions CM stream you want to clone. For details about the URL format and authentication methods, see Git Client command-line format.
  3. Enter a user ID and password for the Dimensions CM repository.
  4. In Specify Destination Folder, enter the location where to clone the stream. Click Next.

    Note: The name of the product or stream is automatically appended to the path.

  5. (Optional) Select a remote branch to clone, for example, main. Click Next.
  6. Specify the parent directory and the name for this clone.
  7. Click Finish.
  8. (Optional) After the clone operation has completed successfully, create a NetBeans project from the cloned sources and add it to your favorites.

Back to top

Create a task repository

You can create a task repository in NetBeans.

After you create a task repository, the Tasks tab is added to the navigation pane, and you can relate requests to commits.

To create a task repository:

  1. In NetBeans, select Window > Services.
  2. In the Services pane, right-click Task Repositories and select Create Task Repository. The Create Task Repository dialog box opens.
  3. Specify the following connection details:

    Field Description
    Connector From the Connector list, select Dimensions CM.
    Display name Enter a name for this task repository.
    URL

    Enter the URL of the Dimensions CM product to connect, in this format:

    dimensions://server/dbname@connection/product

  4. Click OK.

Back to top

View and open requests

You can view your inbox requests for the current Dimensions CM stream. You can then open requests and work on them.

Git Client IDE plugin 1.5 and later: You can work with requests from different providers in the same Dimensions CM instance. The supported providers are ALM Octane, Atlassian Jira, and SBM. For details, see Configure request providers.

To view and open requests:

  1. In NetBeans, select Window > Tasks.
  2. In the Tasks pane, In the Repositories section, expand a Dimensions CM repository. A list of requests in your Dimensions CM inbox is displayed.
  3. To view a request, right-click the request and select Open. The request opens in a new tab.
  4. To open the displayed request, click Open in Pulse or Open request.

    Dimensions CM requests open in the Dimensions CM web client. External requests open in their relevant provider instance such as ALM Octane, Jira, or SBM.

For details about PulseUno, see PulseUno.

Back to top

Relate requests and commit changes

You can commit changes and relate requests to commits.

Git Client IDE plugin 1.5 and later: You can work with requests from different providers in the same Dimensions CM instance. The supported providers are ALM Octane, Atlassian Jira, and SBM. For details, see Configure request providers.

To relate requests and commit changes:

  1. Right-click the folder or file you want to commit, and select Git > Commit.
  2. Enter a commit message.
  3. To relate a request to the commit, expand Update Task.
  4. From the Task Repository list, select a Dimensions CM repository.
  5. From the Task list, select a request from your Dimensions CM inbox.
  6. To add a message, select Add details to commit message and click (modify).
  7. Modify the template to this format: [{id}]
  8. Click OK.
  9. To add the request in the Git commit message, select After Commit.
  10. Click Commit.

Back to top

Push changes to remote stream

You can push changes from the main branch in a local Git repository to the tip of a remote Dimensions CM stream.

You can push to your currently associated stream, or a different stream that is not associated with your NetBeans project.

To push changes to a stream:

  1. To push to the current stream, right-click a folder or file, and select Git > Remote > Push to Upstream.
  2. To push to a different stream, right-click a folder or file, and select Git > Remote > Push. The Push to Remote Repository dialog box opens.
  3. Select Specify Git Repository Location.
  4. For Remote Name, enter the name of a remote repository.
  5. Enter the connection to a Dimensions CM stream in this format:

    dimensions://server/dbname@connection/product/stream

  6. Enter a user ID and password and click Next.
  7. Select the local Git branch from which you are pushing and click Next.
  8. Select the branch to be updated in the Remotes directory of your local repository.

  9. Click Finish.

Back to top

See also: