P4Polarion is an integration for Perforce with the Polarion ALM system
This integration is not support by Perforce Support.
Please refer to LICENSE.
Work-In-Progress: to be updated during development...
Scans for 'user' modified Perforce Jobs and updates the Polarion WorkItem.
<job name="Perforce Job Scanner"
id="jobscanner.job"
cronExpression="0 0 1 ? * *"
scope="project:paul">
</job>
Imports new 'user' added Perforce Jobs (based on ReportedDate) and create new Polarion WorkItems setting the WorkItem Type filed and assigning to a Polarion Project.
<job name="Perforce Job Import"
id="jobimport.job"
cronExpression="0 0 1 ? * *"
scope="project:paul">
<view>PolarionProject=paul</view>
<type>defect</type>
<delete>false</delete>
</job>
WorkItem (id) | Replacation | Job (field) |
---|---|---|
id |
CREATE --> |
Job |
project |
CREATE --> |
PolarionProject |
description |
<--CREATE|UPDATE --> |
Description |
title |
<--CREATE|UPDATE --> |
PolarionTitle |
status |
CREATE|UPDATE --> |
Status |
author |
<--CREATE|UPDATE --> |
ReportedBy |
linkedRevisions |
CREATE|UPDATE --> |
(p4 fixes ) |
Stores the last scan in Perforce Server time using Epoch in seconds.
p4 counter Polarion.Job.Time
Stores the last import in Perforce Server time using Epoch in seconds.
p4 counter Polarion.Import.Time
field-name | data-type | length | field-type | preset |
---|---|---|---|---|
Job |
word | 32 | required | |
Status |
select | 10 | required | |
Description |
text | 0 | required | $blank |
ReportedBy |
word | 32 | required | $user |
ReportedDate |
date | 20 | once | $now |
ModifiedBy |
word | 20 | always | $user |
ModifiedDate |
date | 20 | always | $now |
PolarionTitle |
text | 80 | required | |
PolarionProject |
word | 32 | required |
Fields:
101 Job word 32 required
102 Status select 10 required
105 Description text 0 required
107 ReportedBy word 32 required
109 ReportedDate date 20 once
110 ModifiedBy word 20 always
111 ModifiedDate date 20 always
112 PolarionTitle text 80 required
113 PolarionProject word 80 required
Values:
Status accepted/analysis/analysis-pending/analysis-taken/approved/changesNeeded/completed/done/draft/implemented/inReview/inprogress/open/rejected/reopened/reviewed/verified/verified-done/verified-rejected/unknown
Presets:
Status open
Description $blank
ReportedBy $user
ReportedDate $now
ModifiedBy $user
ModifiedDate $now
In a situation where more than one Perforce repository is connected to a Polarion Project, the WorkItem 'Linked Revisions' will link a Perforce change and update the corresponding 'fix' record on the server.
# Polarion Integration ## About This Project P4Polarion is an integration for Perforce with the [Polarion ALM system](https://www.polarion.com) ## Support This integration is not support by Perforce Support. ## License Please refer to [LICENSE](https://swarm.workshop.perforce.com/projects/perforce_software-p4polarion/files/main/LICENSE). ## Notes Work-In-Progress: to be updated during development... ### Scan Jobs (Polarion CRON) Scans for 'user' modified Perforce Jobs and updates the Polarion WorkItem. ``` <job name="Perforce Job Scanner" id="jobscanner.job" cronExpression="0 0 1 ? * *" scope="project:paul"> </job> ``` ### Import Jobs (Polarion CRON) Imports new 'user' added Perforce Jobs (based on ReportedDate) and create new Polarion WorkItems setting the WorkItem Type filed and assigning to a Polarion Project. ``` <job name="Perforce Job Import" id="jobimport.job" cronExpression="0 0 1 ? * *" scope="project:paul"> <view>PolarionProject=paul</view> <type>defect</type> <delete>false</delete> </job> ``` ### WorkItem to Job replication WorkItem (id) | Replacation | Job (field) ------------------|:-----------------------:|------------- `id` | `CREATE`--> | `Job` `project` | `CREATE`--> | `PolarionProject` `description` | <--`CREATE|UPDATE`--> | `Description` `title` | <--`CREATE|UPDATE`--> | `PolarionTitle` `status` | `CREATE|UPDATE`--> | `Status` `author` | <--`CREATE|UPDATE`--> | `ReportedBy` `linkedRevisions` | `CREATE|UPDATE`--> | (`p4 fixes`) ### Perforce counters Stores the last scan in Perforce Server time using Epoch in seconds. `p4 counter Polarion.Job.Time` Stores the last import in Perforce Server time using Epoch in seconds. `p4 counter Polarion.Import.Time` ### Perforce JobSpec Fields field-name | data-type | length | field-type | preset ------------------|---------------|-----------|---------------|-------------- `Job` | word | 32 | required | `Status` | select | 10 | required | `Description` | text | 0 | required | `$blank` `ReportedBy` | word | 32 | required | `$user` `ReportedDate` | date | 20 | once | `$now` `ModifiedBy` | word | 20 | always | `$user` `ModifiedDate` | date | 20 | always | `$now` `PolarionTitle` | text | 80 | required | `PolarionProject` | word | 32 | required | ### Example Perforce JobSpec ``` Fields: 101 Job word 32 required 102 Status select 10 required 105 Description text 0 required 107 ReportedBy word 32 required 109 ReportedDate date 20 once 110 ModifiedBy word 20 always 111 ModifiedDate date 20 always 112 PolarionTitle text 80 required 113 PolarionProject word 80 required Values: Status accepted/analysis/analysis-pending/analysis-taken/approved/changesNeeded/completed/done/draft/implemented/inReview/inprogress/open/rejected/reopened/reviewed/verified/verified-done/verified-rejected/unknown Presets: Status open Description $blank ReportedBy $user ReportedDate $now ModifiedBy $user ModifiedDate $now ``` ### Multiple Perforce 'repository' connections In a situation where more than one Perforce repository is connected to a Polarion Project, the WorkItem 'Linked Revisions' will link a Perforce change and update the corresponding 'fix' record on the server. ![Polarion Mapping](docs/images/mapping.png)
# | Change | User | Description | Committed | |
---|---|---|---|---|---|
#8 | 19697 | Paul Allen | Minor updates | ||
#7 | 19669 | Paul Allen | Update Polarion Setup Guide | ||
#6 | 19600 | Paul Allen |
Removed Polarion link to Perforce Job status. Use free text field for PolarionStatus. |
||
#5 | 18792 | Paul Allen | Move Polarion Status to a 'PolarionStatus' in the Perforce Job. | ||
#4 | 18029 | Paul Allen | Update notes with Polarion Server Uri | ||
#3 | 17344 | Paul Allen | Added development notes - basis for documentation. | ||
#2 | 16846 | Liz Lam | Fixed link to LICENSE file. | ||
#1 | 15898 | Matt Attaway | License file and simple readme for p4polarion |