Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt
hiddentrue
nameExcel Loop

What is the Excel Loop? Well, it’s a loop because it helps you export requirements, send them to your customers so they add their comments, and reimport them in Confluence. You can also add other external properties in bulk, such as test results.

Want to take a quick glance at the Excel Loop feature? Check out this tutorial:

https://youtu.be/s04m7OMfOMY?si=xrCLtpUhi_haWHMJ

Use cases

  • Bulk import external properties.

  • Import external properties from external tools (such as testing tools, internal applications, etc.).

How to import external properties?

To import external properties from Excel spreadsheets:

  • Navigate to the Import tab.

  • Drag and drop or click the dropzone to upload your files.

...

Gif-Import-excel-Loop.gifImage Added

What’s the expected format for spreadsheets?

For now, the import template is fixed:

  • The first column must contain the requirement keys.

  • The following non-empty columns must contain the external property values.

  • For external property columns, the first row must contain the external property name.

sample.pngImage Modified

How does the import work?

  • The external properties are imported to requirements in the current space.

  • The external properties are imported to requirements in the current variant.

  • Existing external properties are overridden.

  • When a cell is empty, the corresponding external property is removed.

How to download a sample spreadsheet?

To download a sample spreadsheet:

  • Navigate to the Import tab.

  • Click the download box or the Download button.

  • You can use it as a starting point to import your data.

download-sample.pngImage Modified

How to find out more about imported files?

When you import files, a temporary history of imported files is displayed.

history.pngImage Modified

Successful import

When a file is successfully imported, you can check the details to find out how many external properties were created, updated or removed.

success.pngImage Modified

Failed import

When a file import fails, you can check the details to find out more about the reason for the failure.

failed.pngImage Modified

Limitations

  • For now, only external properties can be imported.

  • External properties can only be imported to requirements in the current space.

  • External properties can only be imported to requirements in the current variant.

  • We only support .XLS and .XLSX files.

  • We limit the size of the spreadsheet to 10 MB.

  • We limit the number of columns to 200 columns per spreadsheet.

  • We limit the number of rows to 1000 rows per spreadsheet.