How to Integrate Perforce and Bugzilla with Synergy ALM
Setup Eclipse to use Synergy ALM
-
1. Installed Synergy ALM, refer Synergy ALM Installation Guide.
-
3. Customize your working perspective with Synergy ALM views.
From eclipse, select Window/Show View/Others and select all Synergy ALM views from the view selection dialog
-
4. Setup Perforce for your Eclipse
From eclipse, bring up Preferences dialog, choose Team/Perforce from the left hand list and give the location of p4 executable.
-
5. Setup Synergy ALM for your Eclipse
From eclipse, bring up Preferences dialog, choose Synergy ALM from the left hand list and setup submit comments template, Synergy ALM can even generate a suggested check-in comments for user.
-
6. Enable Perforce for your project
User then need enable perforce with the working project. Check perforce plugin document for detail.
-
7. Connect to a Bugzilla Repository
In order to work with Bugzilla Repository you need set it up in Synergy ALM Repositories view. Go to Synergy ALM Repositories view, right click and select “Add Task Repository” in popup menu.
For testing only, you can choose to use a demo bugzilla server “https://landfill.bugzilla.org/bugzilla-tip/”. You can use “Create new account” link showing in the dialog to setup your own testing account.
-
8. Create task query
In order to work with cases in Bugzilla server, you needs to create a repository query in Synergy ALM Task List View. You can always modify a query by double clicking the query item in Synergy ALM Task List View.
Choose “My Bugzilla” repository we just connected.
For testing only, you can follow the testing query shown below.
Now you can explore the Bugzilla cases in the Synergy ALM Task List view.
Correlate Perforce Checkin with Bugzilla Case
-
1. Checkin code for a bug
After finish coding within a Perforce shared project, right click project select “Team -> Synergy ALM Submit” from popup menu.
Click “Generate Description with Lined Task...”
Select task you want the submission to link with
After select a task Synergy ALM will automatically generate a check-in comments, based on user’s setup in preferences. User should only modify the contents between the first line and last line, since the first line is the linked task identifier and last line is the url of the linked task.
Click “Submit” to submit the change.
-
2. Synergy Checkin - Update Task Status and Checkin Source Code with One Click
By clicking the “Synergy Checkin” button, user can update task status and checkin code at the same time. Synergy Checkin also create the linkage between the task and the code change.
-
3. Query submitted change list and open linked task
To browse the change list, user can switch to Synergy ALM Change List view. A ways click refresh tool button to get latest change list.
It is a master detail view, in the detail panel user can open the linked task by click “Open Task >>” button.
-
4. Look up Checkin History for a Task and Modify Task
User can bring up a task editor by click open task button in Change List view showing above or by click open task button in change list search dialog or by double click the task in the Synergy ALM task list view. In the open editors, choose to use Synergy ALM - Bugzilla editor.
-
★Always click refresh button on the top to retrieve the latest update from Bugzilla repository.
-
★Expending “Discussion” section to see source code change history for this task. Click “Open Linked Change” icon to open the source code change description.
-
★You can update task attributes (working time track) by expanding the Attributes section.
-
★Save the contents in this editor will not submit contents to Bugzilla repository, user needs to click submit button in order to update repository.
The comments section contains all check-in list that linked to this task. By clicking the “Open change list” button for each check-in item you can get all detail information about the change.
-
5. Synergy History
With “Synergy History” function user can lookup task history for a given source file. By clicking “Synergy History” menu next to perforce “History” menu, you can bring up the task history viewer.
In “Synergy History” view, by right clicking a task history record, you can choose to open task editor or find more information about the perforce change.
-
6. Work with Bugzilla cases
User can browse Bugzilla cases in the Synergy ALM Task List view. User can also create new task by clicking the new task button in the view.
-
7. Find a specific change number and its linked task
User can make a global perforce change number search by click the Synergy ALM p4 search button.
References:
