> For the complete documentation index, see [llms.txt](https://dev.realpadsoftware.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://dev.realpadsoftware.com/placeholders/document-templating/defects-list-report.md).

# Defects list report

This document lists all available placeholders for "Defects list report" Documents.

## Overview

This printer provides placeholders for generating defect reports across multiple Deals and Units. Unlike [Reclamation documents](/placeholders/document-templating/reclamation-documents.md) that work with a single Reclamation, this document type generates a consolidated list of selected Defects from potentially multiple Deals.

***

## Simple Placeholders

There are no simple placeholders at the document root level. The entire document structure is based on the `$defects` repeating list.

## Defects (Repeating List)

The `$defects` list contains all selected Defects for the report.

### How to Use

To iterate over Defects in your template:

{% code title="Velocity template" %}

```velocity
#foreach($defect in $defects)
  Project: $defect.project_name
  Building: $defect.building_name
  Unit: $defect.unit_internal_id
  Defect No.: $defect.internal_id
  Description: $defect.description
#end
```

{% endcode %}

### Available Properties

Each `$defect` item has the following properties.

#### Project / Building / Unit Context

These properties provide context about the Unit associated with the Deal. Empty strings if no Unit is assigned.

* `$defect.project_name`\
  Name of the Project containing the main Unit. Empty string if no Unit on the Deal.\
  Type: String | UI: "Name" (`project_param_name`)
* `$defect.building_name`\
  Name of the Building containing the main Unit. Empty string if no Unit on the Deal.\
  Type: String | UI: "Name" (`building_param_name`)
* `$defect.unit_internal_id`\
  Internal ID of the main Unit on the Deal. Empty string if no Unit on the Deal.\
  Type: String | UI: "Number in project" (`flat_param_internalid`)

#### Identification

* `$defect.deal_id`\
  Unique identifier of the Deal (numeric ID as string).\
  Type: String
* `$defect.internal_id`\
  Internal ID of the Defect.\
  Type: String | UI: "Defect No." (`business_case_reclamation_defect_param_internalid`)
* `$defect.external_id`\
  External ID of the Defect.\
  Type: String | UI: "Defect No. according to the customer" (`business_case_reclamation_defect_param_externalid`)
* `$defect.is_external_id`\
  Whether external ID is set.\
  Type: Boolean

#### Location

* `$defect.location`\
  Location description.\
  Type: String | UI: "Location (room etc.)" (`business_case_reclamation_defect_param_location`)
* `$defect.is_location`\
  Whether location is set.\
  Type: Boolean
* `$defect.room_location`\
  Formatted room name.\
  Type: String | UI: "Location of the room to which the defect is related" (`business_case_reclamation_defect_param_room_location`)
* `$defect.is_room_location`\
  Whether room location is set.\
  Type: Boolean

#### Description and Notes

* `$defect.description`\
  Defect description.\
  Type: String | UI: "Reclamation description" (`business_case_reclamation_description`)
* `$defect.is_description`\
  Whether description is set.\
  Type: Boolean
* `$defect.note`\
  Additional notes.\
  Type: String | UI: "Note" (`business_case_reclamation_defect_param_note`)
* `$defect.is_note`\
  Whether note is set.\
  Type: Boolean

#### Severity and Deadline

* `$defect.is_prevents_flat_usage`\
  Whether the defect prevents flat usage.\
  Type: Boolean | UI: "Prevents flat usage" (`business_case_reclamation_defect_param_prevents_flat_usage`)
* `$defect.deadline_calculated`\
  Calculated deadline for defect resolution.\
  Type: DateWrapper | UI: "Deadline (calculated)" (`business_case_reclamation_defect_param_deadline_calculated`)
* `$defect.is_deadline_alternative`\
  Whether an alternative deadline is set (indicating the calculated deadline differs from the default).\
  Type: Boolean

#### Images (Nested List)

Each defect has an `images` list containing file attachments.

Example iteration:

{% code title="Velocity template" %}

```velocity
#foreach($image in $defect.images)
  File: $image.name
  $image.file
#end
```

{% endcode %}

* `$image.name`\
  File name of the attachment.\
  Type: String
* `$image.file`\
  Embedded image of the attachment.\
  Type: Image


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://dev.realpadsoftware.com/placeholders/document-templating/defects-list-report.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.