Archive Reviews

Applies to Collaborator 11.5, last modified on December 21, 2021

Collaborator can pack reviews to an external ZIP archive.

You can use this feature to keep historical records of the reviews (for instance, because of regulatory requirements), or to export review information to a non-proprietary format.

Note: This feature is only supported in Collaborator Enterprise. For a complete list of differences between Collaborator editions, please see the comparison page.

Create Archives

There are two ways to archive reviews: from the Web Client and from the command-line.

To archive a review from the command-line, call the ccollab admin archive command. See command description for its syntax and examples.

To archive a review from within the Web UI:

  1. Open the desired review in the Review Screen. To find the reviews, you may use Collaborator search and reporting systems.

  2. Select Review Actions > Archive in review header:

    Archive review

    Click the image to enlarge it.

This will invoke a standard Save As dialog where you can specify the location for the archive.

Create Archives Automatically

You may use Collaborator server triggers to archive reviews automatically. The general idea is to install the Command-Line Client on a server machine and call the ccollab admin archive command via the server's phase change trigger. Below are the detailed steps of how to achieve this:

  1. Install the Collaborator client on the same machine where Collaborator server is installed.

  2. Specify the connection parameters for the client.

  3. Create a directory to store the archived reviews. In this example that will be c:\archived-reviews on Windows platforms and /archived-reviews on Unix platforms.

  4. Sign in to the Collaborator web interface as an administrator.

  5. Go to the Admin > Triggers page.

  6. Find the Review Phase Changed trigger and configure it as follows:

    Windows platforms

    Executable: <Program Files>\collaborator client\ccollab.exe
    Parameters: admin archive ${review.id} --zip-path c:\archived-reviews

    Unix platforms

    Executable: /usr/local/ccollab_client/ccollab
    Parameters: admin archive ${review.id} --zip-path /archived-reviews

You may need to change paths to the Collaborator command line client and to the archives folder as necessary.

Note: In the example above, the trigger does not check if the phase has transitioned to completed, cancelled or rejected. Since the ccollab admin archive command ignores in-progress reviews (by default), you can simply call it on every phase changed event. If your team is using the tool heavily, then you should create a shell script or batch file and check the review phase before calling the ccollab admin archive command. This will result in improved performance but is not really necessary for small or medium-sized installations.

Archive Contents

For each review a separate archive is created. Generated files have the names in the format "review-ID-archive.zip", where ID stands for the identifier of the review.

Each archive contains the following information about the review:

  • The ReviewDetails.pdf file contains a PDF version of the Review Detail Report.

  • The material_conversations subfolder contains all the comments, defects and conversations that were made during the review. For each of the commented files a separate PDF version is created that holds the contents of the file and the comments and defects related to this file.

  • Review materials.

    • If the archive was created from Web UI, it contains all revisions of the materials that were uploaded to the review. If a file was uploaded multiple times (as it typically happens during rework), the archive will contain a copy of each file revision.

    • If the archive was created with the ccollab admin archive command, the amount of review materials is specified by the --zip-option parameter.

The naming structure of subfolders that store review materials depends on how the materials were uploaded. For changes uploaded via version control system, the folder name will contain the name of SCM, the name of the repository and (if available) the ID of the changeset ("git-git.example.com_foo_repo.git-85d2f5ccb7f27e1628c09e4d1373f"). For uploads of arbitrary files, the folder names will contain the "upload-file-" portion followed by the date and time ("upload-file-2015-08-18-02-58-59").

Remarks

See Also

Miscellaneous Tasks

Highlight search results