Skip to content

Import and Export Issues

Occasionally you might want to bulk import or export issues for various purposes. Agile provides a number of different ways to do it.

Import Issues

If you run clash detection or capture problems in other BIM software, it is possible to import issues in batch to Agile. Click the plus button on the top right menu bar and select Import Issues. Then you can select which source to import issues from.


Import from BCF

BIM Collaboration Format (BCF) is a structured file format suited to issue tracking with a building information model. Agile supports BCF version 2.1 (recommended) or 2.0 (.bcf/.bcfzip/.zip).


Import from Navisworks

There are two types of saved items in Navisworks: Clash Detective and Saved Viewpoint. Choose one to import.


Make sure you have the latest Launcher installed and select a Navisworks session from the list to proceed to Select Items.


Import from Solibri

Please firstly make sure Solibri is opened with REST API enabled and Launcher is running in the background. We've created a Windows program called Start Solibri that does everything needed to use this function. You can find it in the Start Menu => (or Transformosa) => Start Solibri.

By default, it will import all of the issues in the current Presentation. Alternatively, you can select or mark some issues to import.


Make sure you have the latest Launcher installed and select a Solibri session from the list to proceed to Select Items.


Select Items to Import

Review and select what items to import. The table has a few tools, such as text search, filter, etc., that allow you to quickly find issues. Click NEXT to Set Issue Properties when you're done.


Set Issue Properties

You can set issue properties to apply to the selected items. Click START IMPORT to trigger the import process.


Export Issues

You can export selected issues from the Issue List to different formats, including JSON, CSV, and your custom report format.


Export to JSON

JSON format saves issue data in its original form which is easier to be analysed programmatically.

Export to CSV

CSV format is useful for data analytics. For example, you can import it into Power BI to create metrics and graphs.

Export to Custom Report

Sometimes you might need to prepare paper-based issue report. Agile supports user-defined custom report in Microsoft Word format. You can insert issue field placeholders in a DOCX file that can subsequently be populated by actual values of selected issues.


We provide a default report template which you can further modify to define printed issue fields, page layout, and other formatting options.

Download Default Report Template

Issue field placeholders must be wrapped between FOR and END-FOR as below.

+++FOR issue IN issues+++

Issue field placeholders you need should be put here...

+++END-FOR issue+++

Below is a list of supported issue fields:

Issue Field Placeholder Example
title +++INS $issue.title+++
description +++INS $issue.description+++
id +++INS $
number +++INS $issue.number+++
type +++INS $issue.type+++
status +++INS $issue.status+++
priority +++INS $issue.priority+++
disciplines +++FOR discipline IN $issue.disciplines+++
+++INS $discipline+++
+++END-FOR discipline+++
zones +++FOR zone IN $issue.zones+++
+++INS $zone+++
+++END-FOR zone+++
creator +++INS $
assignees +++FOR assignee IN $issue.assignees+++
+++INS $
+++END-FOR assignee+++
comments +++FOR comment IN $issue.comments+++
+++INS $ +++INS $comment.text+++
+++END-FOR comment+++
markup See below HTML example
dueDate +++INS $issue.dueDateFormatted+++
created +++INS $issue.createdFormatted+++
updated +++INS $issue.updatedFormatted+++
attached images +++FOR imageUrl IN issue.imageUrls+++<br>+++ IMAGE imageData(imageUrl, 1.6, 4)+++
+++END-FOR imageUrl+++

HTML syntax can be used to render markup image in your custom report. Here is an example:

+++HTML `
<meta charset="UTF-8">
<img src="${$issue.markup}" width="300" height="200" />