The Diff-Tool provides a capability to compare reused documents and synchronize data between them. Our main use case is to have projects with disjunct copies of documents (with the user not having access to the “source” project).
Main Features
- Compare two LiveDoc Documents in different Projects using a link role between Work Items in the Documents - the Reuse LiveDoc use case.
- Links in RTF to other Work Items are considered the same if they are the correct counterpart Work Items using the link role between them.
- Compare two revisions of the same LiveDoc Document.
- A set of fields for comparison can be defined so that only fields of interest will be compared.
- Work Items in a Document can be filtered for comparison using a Lucene query.
- Reuse a LiveDoc Document in another Project.
- Attributes to be copied can be defined separately.
- Compare the structure of two LiveDoc Documents.
- Synchronize (merge) Work Items into another LiveDoc Document including adjustment of RTFs.
- Synchronize the structure of the LiveDoc Document.
- Hide chapters in the report if there is no difference.
- Compare Enumerations by key or value.
- Currently, only Work Items are being compared, free text is not.
- Export any of the reports using the SBB PDF-Exporter.
Notice
The Diff-Tool uses the backend of Polarion. For small documents, it is not a problem, but for documents containing hundreds or even thousands of Work Items, this can be a performance issue. We are still improving the implementation so we expect to have more efficient solutions at a later point in time. Please test this out before you put it into your production environments!
We do not consider the Diff-Tool feature complete as of today (December 2024) but it already has helped us a lot in our projects. Therefore we decided to release it already.
Further usage information can be found on the „About“ page of the extension and the REST-API documentation.
If you have any questions, contact us at polarion-opensource@sbb.ch.
