A Django site.
September 1, 2008
» Plastic SCM working with JIRA part II

Let´s see now how to use Plastic SCM and JIRA using the "task on changeset" working mode: the first steps for setting up the extension would be the same ones as explained on the previous post for the "task on branch" option, the only difference is on the "jiraextension.conf" file, in this case its configuration must be the following one:


<JiraExtensionConfiguration>
<HttpUrl>http://192.168.1.14:8080</HttpUrl>
<User>root</User>
<Password>root</Password>
<ProjectKey>PRJ</ProjectKey>
<BranchPrefix>SCM</BranchPrefix>
<WorkingMode>TaskOnChangeset</WorkingMode>
<CustomFieldId>customfield_10000</CustomFieldId>
</JiraExtensionConfiguration>



Once the extension is set we can start working with it!

You must take into account that even though on the previous case: "task on branch", only one task in Jira was linked to one Plastic branch; in this case you can link one or more tasks with one or more changesets.

In order to start working, the project manager must have created issues in Jira and assigned them; as using this working mode, the pattern used would be “Mainline development” pattern or “Branch per developer", so in this case the user does not create a new branch for the task he is going to work on, but he checks out the files he wants to modify, makes his changes and check them in. At this point a check in information dialog will be displayed, as shown on the figure below, on this dialog the user will be able to write comments on the operation and on the "Checkin Linked Tasks" he can include the Jira issues to be linked with that changeset or commit operation:



By clicking on the "Add new issue" option on the previous dialog a new one will be displayed to indicate the ID or number of the issue to be linked, several issues can be linked to one changeset and viceversa:



Once the changeset has been linked to the issue or task in Jira, we can go to the changesets´ view where the information of the extension is displayed just by selecting a changeset. From this view users can also add new issues or delete previous ones; and by clicking on each of them an Explorer window with the associated information in Jira.

» Plastic SCM working with JIRA Part I

On the series of posts about Plastic SCM extension I am going to explain how to use Plastic SCM and JIRA for the benefit of users of this task tracking system. Plastic SCM for Atlassian JIRA provides reliable data mapping features that allow data type transformation between both tools; this highly improves your development´s traceability. Let´s see how it works!
First we have to set up the extension, in order to do this a new "Custom Field" named Plastic SCM must be created in Jira, if you want to have a look at further information on how to create a custom field in Jira you can go to our Extension´s Guide.

On the Plastic side, in order to start working you must have copied "jiraextension.dll" on the Plastic SCM client folder, adding the following lines (circled in red, which will indicate that Jira is the extension used), on the client.conf file:


The next step to ensure that the extension is properly set up is creating a "jiraextension.conf" file; on this file we indicate the extension parameters. Here we have to options, the first one is the "Task on branch" option which is used to link one task in Jira with a branch in Plastic, in order to use this option the "jiraextension.conf" file must have the following appearance:

<JiraExtensionConfiguration>
<HttpUrl>http://192.168.1.14:8080</HttpUrl>
<User>root</User>
<Password>root</Password>
<ProjectKey>PRJ</ProjectKey>
<BranchPrefix>SCM</BranchPrefix>
<WorkingMode>TaskOnBranch</WorkingMode>
<CustomFieldId>customfield_10000</CustomFieldId>
</JiraExtensionConfiguration>

And now we are all set to start working!

The person in charge of creating new tasks and assigning them has created a new Jira issue on the task tracking tool, which has been give number 3 on the project we are working on, as you can see on the following figure:


Once the task has been assigned (in this case to root as shown on the previous image), the developer will start working on it: he goes to Plastic and creates a new branch, giving it the same name as the Jira issue with the prefix stated on the "jiraextension.conf" file, in this case SCM:


Now to see how the extension works, if we go to the branch view and click on the "Show extended information option" on the top and select the newly created branch we can see on a menu on the right the information of the issue linked to that branch displayed as shown on the following image:



The extension information shows the name of the Jira issue as well as its owner, title, comment and status. By clicking on it, an Explorer window with the associated branch issue is opened, whenever the user wants to change the status of the issue, he will only have to refresh it on the Plastic branch extended information and the new information will appear.

On the next post I will explain how to use the "task on changeset" working mode working with Plastic SCM and Jira!

» Plastic SCM working with Trac

Now it is the turn of another task tracking tool that Plastic provides extension with: Trac.

Plastic SCM for Trac offers full data mapping features allowing data to be associated between both tools, improving to a great extent your development´s traceability and control. On this post I am going to explain how to work with the extension on one of the working modes available: "Task on Branch".
In order to set up the extension you must follow a few simple steps:
First you have to copy the "tracextension.dll" file on the Plastic SCM client folder
Then you have to add the lines circle in red in the following image (which will indicate that Trac is the extension used) on the client.conf file:


And last but not least on the configuring steps, you must create a "tracextension.conf" file on which to indicate the extension parameters; this is where the working mode selected will be specified, the first one is the "Task on branch" option which is used to link one task in Trac with a branch in Plastic, in order to use this option the "tracextension.conf" file must have the following appearance:

<TracExtensionConfiguration>

<XmlRpcUrl>
http://localhost:8080/trac/login/xmlrpc
</XmlRpcUrl>

<ShowTicketUrl>
http://localhost:8080/trac/ticket
</ShowTicketUrl>

<User>tester</User>

<Password>PR</Password>

<Branchprefix>SCM</Branchprefix>

<workingmode>TaskOnBranch</workingmode>

</TracExtensionConfiguration>

And now everything is set to start working!

The person in charge of creating new tasks and assigning them (either the admin or one of the developers, depending on your organization) creates a new ticket in Trac; in order to create tickets in Trac you only have to go to the "New Ticket" option highlighted on the following figure. On Trac tickets can be subdivided into three different categories: defect, enhancement or task. The new ticket is numbered as ticket 3 and assigned to developer "michael" as you can see in the image below, developers can always run a ticket search on trac by status, developer assigned, etc. On the following image you can see that ticket number 3 is among the active tickets:

Once the ticket has been created and assigned, in this case developer michael will start working on it: he goes to Plastic and creates a new branch, giving this branch the same name as the Trac issue, with the defined prefix (defined on the tracextension.conf" file), which is scm in this case. In order to create the new branch the developer only has to go to the branch view and select "create new branch" and the following window will appear:

He would then name it scm003 in order to be linked with the Trac ticket; take into account that Plastic SCM handles smart branches, so when creating a branch you can set its base and whenever a developer switches to that branch it would remember its base.

Now to see how the extension works, if we go to the branch view and click on the "Show extended information option" on the top and select the newly created branch we can see on a menu on the right the information of ticket 3, which is the one linked to that branch displayed as shown on the following image:



The extension information shows the name of the ticket in Trac as well as its owner, title, comment and status. By clicking on it, an Explorer window with the associated branch ticket will opened and whenever the user wants to change the status of a certain ticket, he will only have to refresh it on the Plastic branch extended information and the new information will appear.

I will shortly also explain how to use Plastic SCM and Trac on the "task on changeset" working mode!

August 21, 2008
» Plastic SCM working with Trac II

Now we are going to see how the extension of Plastic SCM and Trac work, in this case using the second working mode: "task on changeset". As on the previous working mode, to use this extension, the first thing you will have to do is copy the ‘tracextension.dll’’ library to Plastic SCM client folder, and add the Trac extension lines on the client.conf.

And then, for the working mode we are explaining on this post: "task on changeset",
the following "tracextension.conf" file must be created:


<TracExtensionConfiguration>

<XmlRpcUrl>
http://localhost:8080/trac/login/xmlrpc
</XmlRpcUrl>

<ShowTicketUrl>
http://localhost:8080/trac/ticket
</ShowTicket>

<User>tester</User>

<Password>PR</Password>

<Branchprefix>SCM</Branchprefix>

<workingmode>TaskOnChangeset</workingmode>

</TracExtensionConfiguration>



Now that the extension is set up you can start working with it!

Depending on your company´s structure, either the project manager or a developer would be in charge of creating the tasks on Trac and then assign them to the developer who would work to solve them.

On this example we create two new tasks: task number 6 as shown on the image below, and we had previously added tasks.





Once the tasks have been created and assigned, the developer starts working, he makes his changes after checking out the items he is going to work on (either from Plastic GUI or from one of its IDE plug ins), and when the changes are done and he checkes his code in Plastic will open a window on which the user can include in the “checkin information”, it has the following appearance:



As you can see, on the top of this window the user can include his check in comments and the list of related items is shown.
The checked in tasks are included at the buttom, by selecting the option "Add new issue" the following window will appear:



Just by entering the task number as we include number 6 for the newly created task, the information of the Trac task will be shown.

Once the check in operation is done we can go to the changeset view and just by clicking on the changeset view and selected a changeset, we can see the Trac Extension information on the right, in this case, by selecting the created changeset, we can see on the extension information about its associated task, number 6; but that is not all...as using the "task on changeset" mode, one or more than one tasks can be related with one or more changeset, from this view we can also add new tasks to the changeset.



Now we have associated two tasks with changeset 23 as both of them have been solved on the same check in operation, by clicking on one of the tasks shown on the extension information we can either delete it necessary, or open the task on the Trac IDE, from which information such as the status of the task can be modified and it will be inmediately reflected on Plastic information of the extension as soon as it is refreshed!

August 12, 2008
» How to use Plastic SCM and TechExcel DevTrack II

As we saw on the previous post on how to use Plastic SCM and DevTrack extension, there are two different options to work with the extension, depending on the working pattern your company is using, we are now going to look into the “Task on Changeset” option, which would be used for companies using the “Mainline development” pattern or “Branch per developer”.
In order to configure the extension for this working method you must set up the same “devtrackextension.dll” but in this case the file “devtrackextension.conf” changes, so it must have the following appearance:


<devtrackextensionconfiguration >
<dtlinkplusurl>
http://192.168.1.237/LinkPlusWebService/WSDTIncident.asmx
</dtlinkplusurl>

<user>terry-j</user>

<projectid>daveProject</projectid>

<systemid>daveSystem</systemid>

<branchprefix>issue</branchprefix>

<dtbuginfobrowserurl>
http://192.168.1.237/scripts/texcel/devtrack/buginfo.dll
</dtbuginfobrowserurl>

<workingmode>TaskOnChangeset</workingmode>
</devtrackextensionconfiguration>


Once the extension is set we can start working with it!

You must take into account that even though on the previous case: "task on branch", only one task in DevTrack was linked to one Plastic branch; in this case you can link one or more tasks with one or more changesets.In order to start working, the project manager must create tasks issues in DevTrack and assigned them.

Watch the image:




In this case we can see that:

The task number is 108 as we can see on the following image with the information of the newly created task, a defect in this case.

Check the image:




Now the assigned developer starts.

He would start working and edit the items needed in order to carry out the assigned task; he would go to Plastic, check out the files, edit and check them in: at this point Plastic will open a new window in order to include the “checkin information”.

The window has the following appearance:



Users can customize data:

Here the user can include his checkin, comments and link the check in operation (changeset) with the related task or tasks, as on the “Task per Changeset” one or more than one changeset can be linked to one or more than one task..
If we click on the “Add new issue” option another window will be opened, and from it we can choose the task to be linked.

In this case we link task 108 as shown on the following image:



And there we have it!

If we go to the “changesets view” we can find the information of the DevTrack tasks linked to each of the changesets, from this view we can also link more bugs to a changeset or delete previously added bugs, and as on the case of the “Task on branch” working mode, we can also go to DevTrack, make changes on the bugs and change them any time!



Hope you like it!

August 7, 2008
» How to use Plastic SCM and TechExcel DevTrack I

As you may have already seen on previous post, Plastic SCM provides with the option of using it integrated with different task tracking tools as it integrates with some of the most extensively used systems in the market, you can have a look at the list of options here.

One of them is TechExcel DevTrack!


On this post I am going to explain with examples, how to use Plastic SCM integrated DevTrack.

First of all we have to know that Plastic SCM not only integrates with this system, but also offers customizable options for the integration.

Why do we provide with different options? So you can use the one that better adjusts to your working pattern: Let´s see the “Task on Branch” working mode on this post.

The first step in order to set up the DevTrack extension on your client machine you have to copy “devtrackextension.dll” on the folder where Plastic SCM client is installed and add the following lines (circled in red) in order to indicate the client to use this extension:



And you would also need to create a file “devtrackextension.conf”, its appearance by default is the following one:


<devtrackextensionconfiguration >
<dtlinkplusurl>
http://192.168.1.237/LinkPlusWebService/WSDTIncident.asmx
</dtlinkplusurl>

<user>terry-j</user>

<projectid>daveProject</projectid>

<systemid>daveSystem</systemid>
<branchprefix>issue</branchprefix>
<dtbuginfobrowserurl>
http://192.168.1.237/scripts/texcel/devtrack/buginfo.dll
</dtbuginfobrowserurl>
</devtrackextensionconfiguration>



Finally, you need to make sure that:
the devtrackextension.dll file is on the Plastic SCM client folder.

And by default the “Task on Branch” option is set, or you can specifically set it as follows:


<devtrackextensionconfiguration>

<dtlinkplusurl>
http://192.168.1.237/LinkPlusWebService/WSDTIncident.asmx
</dtlinkplusurl>

<user>terry-j</user>
<projectid>daveProject</projectid>
<systemid>daveSystem</systemid>
<branchprefix>issue</branchprefix>
<dtbuginfobrowserurl>
http://192.168.1.237/scripts/texcel/devtrack/buginfo.dll
</dtbuginfobrowserurl>

<workingmode>
TaskOnBranch
</workingmode>

</devtrackextensionconfiguration>


Now that the extension is set up:

The first step to start working with it would be creating a new bug on our task/bug tracking system; DevTrack in this case.

In DevTrack tasks can be submitted as either defects or new features, and they can also be classified into several categories such as Minor Improvement, Future Enhancement, Discrepancy Report, etc.


As the new task is created, it is on state “NEW” and assigned to a developer. “
The title given to this new task is "Additional options: Customization".
By saving the task we can see the number D given to it, in this case it is issue number 106, and we could indicate the system to send an email to the developer in order to let him know that we have assigned him a new task.



When the assigned developer, in this case Paul, is ready to start working on task 106, he will easily create a new branch and name it according to the task created on DevTrack, and add his comments accordingly.

You can also set the branch base and it will be remembered by the branch every time a user switches to work on it... if you are interested on learning more about Plastic smart branches you can find it here.



After the branch has been created, by going to the top left on the branch view we can display the extended information of branches, which will show information on the DevTrack related bug when selecting a branch.

On the following image we select the newly created branch /scm00106 and on the right hand side we can immediately see the information of issue 106 on DevTrack: its ID, owner, title and comments are shown on the custom view:



And as soon as the task is accomplished we double clicking on the dialogue or just click on the extension button, which will take us to the DevTrack tasks, where we can change the status, which will be refreshed on Plastic:




Easy!, Hope you like it!

July 25, 2008
» How to use Plastic SCM and Bugzilla Part I

As you have probably already noticed, Plastic SCM gives you the option of using the task tracking system of your choice as it seamlessly integrates with a bunch of systems in the market …you can have a look at which ones here.
On this post I will start explaining with actual examples, how to use Plastic SCM integrated with one of these systems: Bugzilla… First of all we have to Plastic SCM not only integrates with this system, but also offers customizable options for the integration. Why? Simple, for different working patterns we provide with different integrations: Let´s see the “Task on Branch” option first.
In order to set up the Bugzilla extension on your client machine you have to copy “bugzillaextension.dll” on the folder where Plastic SCM client is installed and add the following lines (circled in red) in order to indicate the client to use this extension:



And you would also need to create a file “bugzillaextension.conf”, its appearance by default is the following one:

<bugzillaextensionconfiguration>

<bugzillabaseurl>
http://192.168.1.14:8888/bugzilla/3.0
</bugzillabaseurl>

<branchprefix>SCM</BRANCHPREFIX>



Easy, uh?

And by default the “Task on Branch” option is set, or you can specifically set it as follows:

<bugzillaextensionconfiguration>

<bugzillabaseurl>
http://192.168.1.14:8888/bugzilla/3.0/
</bugzillabaseurl>

<branchprefix>SCM$lt;/branchprefix>

<workingmode>TaskOnBranch</workingmode>

</bugzillaextensionconfiguration>


Now that the extension is set up:

The first step to start working with it would be creating a new bug on our task/bug tracking system: Bugzilla.


As new bug created, it is on state “NEW” and assigned to “tester” in this case, we also include the number of hours estimated and the deadline for the task to be finished.
The title given to this new task is New Task Created: Comments on a file, and a description is included.
By saving the bug we can see the ID given to this task by Bugzilla: 13 in this case, and we could indicate the system to send an email to the developer in order to let him know that we have assigned him a new task:



When developer tester is ready to start working on bug 13, he will easily create a new branch and name it according to the bug created on Bugzilla, and add his comments accordingly:


Then going to the top left on the branch view we can display the extended information of branches, which will show information on the Bugzilla related bug when selecting a branch. On the following image we select the newly created branch /scm013 and on the right hand side we can immediately see the information of bug13: its ID, owner, title and comments are shown on the custom view:
A standard view showing the current status is also available:

And as soon as the task is accomplished we double clicking on the dialogue or just click on the extension button, which will take us to the bug on bugzilla, where we can change the status, which will be refreshed on Plastic:

Simple and intuitive…I hope you like it!

» Plastic SCM and Mantis I

On the series of posts about Plastic SCM extension with task tracking tool, let´s see how to use Mantis extension!

As on the case of other extensions, Plastic SCM extension with Mantis provides with two different working mode options: "task on branch" and "task on changeset", on this post I will talk about the first of them. To set up the extension in Plastic you must copy the ‘mantisextension.dll’’ library to the folder where you have installed Plastic SCM client and insert the following lines (circled in red) on the "client.conf" file:



You also need to create a "mantisextension.conf" file, which must have the following appearance:


<MantisExtensionConfiguration>
<MantisBaseUrl>http://localhost:8888</MantisBaseUrl>
<Branchprefix>SCM</Branchprefix>
<workingmode>TaskOnBranch</workingmode>
</MantisExtensionConfiguration>


Being MantisBaseUrl the Url on which Mantis is installed.

Branchprefix is the prefix will have the created branches on PlasticSCM that you want to associate with Mantis issue. As the working mode we want to use is "task on branch", we specify it.

Once the extension is set and Mantis issues have been created we can start working!
The first step on this working mode is creating a task in Plastic, which must have the same name as the Mantis issue we want to link it to (in this case as the prefix is SCM we have to for example create branch /scm004 to link it with issue 4). Please be aware that using the "task on branch" working mode one single Mantis issue corresponds with one single Plastic SCM branch.

After the branch has been created, if you want to see the extension information you only have to go to the branch view and click on the "Show extended information option" on the top, then select the newly created branch and a menu on the right with the extension information will be displayed as the following image shows:




The extension information shows:

  • the name of the Mantis issue,
  • its owner, description,
  • comment
  • and status.

    By clicking on it, an Explorer window with the associated branch issue will be opened, so that when the user wants to change the status of the issue or its description, he will only have to refresh it on the Plastic branch extended information and the new information will appear.

  • » Plastic SCM and Mantis II

    As seen on the previous post, Plastic SCM and Mantis I, in order to use this extension, the first thing you will have to do is copy the ‘mantisextension.dll’’ library to Plastic SCM client fo,lder, and add the Mantis extension lines on the client.conf.
    And then, for the working mode we are explaining on this post: "task on changeset", the following "mantisextension.conf" file must be created:

    <MantisExtensionConfiguration>

    <MantisBaseUrl>http://localhost:8888</MantisBaseUrl>

    <Branchprefix>SCM</Branchprefix>

    <workingmode>TaskOnChangeset</workingmode>

    </MantisExtensionConfiguration>


    Now that the extension is set up you can start working with it!
    Depending on your company´s structure, either the project manager or a developer would be in charge of creating Mantis tasks and then assign them to the developer who would work to solve them.
    On this example we create two new tasks: task number 4 as shown on the image below, and also task 5.

    Once the tasks have been created and assigned, the developer starts working, he makes his changes after checking out the items he is going to work on (either from Plastic GUI or from one of its IDE plug ins), and when the changes are done and he checkes his code in Plastic will open a window on which the user can include in the “checkin information”, it has the following appearance:

    As you can see, on the top of this window the user can include his check in comments and the list of related items is shown.
    The checked in tasks are included at the buttom, by selecting the option "Add new issue" the following window will appear:

    Just by entering the task number as we include number 4 for the newly created task, the information of the Mantis issue will be shown.
    Once the check in operation is done we can go to the changeset view and just by clicking on the changeset view and selected a changeset, we can see the Mantis Extension information on the right, in this case, by selecting the created changeset, 23, we can see on the extension information about its associated task, number 4; but that is not all...as using the "task on changeset" mode, one or more than one tasks can be related with one or more changeset, from this view we can also add new tasks to the changeset.

    Now we have associated two tasks with changeset 23 as both of them have been solved on the same check in operation, by clicking on one of the tasks shown on the extension information we can either delete it necessary, or open the task on the Mantis IDE, from which information such as the status of the task can be modified and it will be inmediately reflected on Plastic information of the extension as soon as it is refreshed!