How to Integrate Perforce and RallyDev with Synergy ALM



Setup Eclipse to use Synergy ALM


  1. 1. Installed Synergy ALM, refer Synergy ALM Installation Guide.


  1. 2. Get license and apply the license

  2. 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

   

   




  1. 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.


  1. 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.




  1. 6. Enable Perforce for your project


User then need enable perforce with the working project. Check perforce plugin document for detail.


  1. 7. Connect to a RallyDev Repository


In order to work with RallyDev Repository you need set it up in Synergy ALM Repositories view


  


  


  1. 8. Create task query

  

In order to work with RallyDev User Stories/Tasks/Defects, user needs to create a repository query in Synergy ALM Task View. User can always modify a query by double clicking it.


  




   

  

  


Correlate Perforce Checkin with RallyDev Story/Task/Defect


  1. 1. Checkin Source Code

  

After finish code development work within a 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.


  1. 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.



  2. 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.

  

   


  1. 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.

  

  1. ★Always click refresh button on the top to retrieve the latest update from  RallyDev repository.

  2. ★Expending “Discussion” section to see source code change history for this task. Click “Open Linked Change” icon to open the source code change description.

  3. ★You can update task attributes (working time track) by expanding the Attributes section.

  4. ★Save the contents in this editor will not submit contents to RallyDev repository, user needs to click submit button in order to update repository. 




The discussion 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.  




  1. 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.




  1. 6.Work with RallyDev User Stories/Tasks/Defects

  

User can browse Rally user stories, tasks, and defects in the Synergy ALM  task view. To  create new task, click the new task button in the upper right corner of Synergy ALM task view.




  1. 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:


  1. ★Synergy ALM Online Demo Video

  2. ★ Synergy ALM Home Page

  3. ★ How to license and deploy Synergy ALM

  4. ★ Get a trial license


  1. ★ How to install Synergy ALM


  1. ★ How to integrate Perforce and RallyDev with Synergy ALM


  1. ★ How to integrate Perforce and Bugzilla with Synergy ALM