> 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/list-of-inspection-defects.md).

# List of inspection defects

This document lists all available placeholders for Inspection Defects List Documents.

## Overview

This printer provides placeholders for generating defect lists from Deal Inspections. It includes information about the Deal, the Inspection, Units associated with the Inspection, and the list of Defects found during the Inspection.

***

## Simple Placeholders

### Deal and Inspection Information

#### `$deal_id`

Unique identifier of the Deal (numeric ID).\
**Type**: Integer

#### `$inspection_type`

Localized name of the Inspection type (e.g., "Handover", "Technical Inspection").\
**Type**: String | **UI**: "Type" (`business_case_inspection_param_type`)

#### `$actual_date_time`

Date and time when the Inspection actually took place.\
**Type**: DateWrapper | **UI**: "Actual date" (`business_case_inspection_param_actualdate`)

### Main Unit Information

These placeholders provide information about the main Unit on the Deal. All values are empty strings if there is no main Unit.

#### `$flat_internal_id`

Internal ID of the main Flat/Unit on the Deal.\
**Type**: String | **UI**: "Number in project" (`flat_param_internalid`)

#### `$flat_floor_no`

Floor number of the main Unit.\
**Type**: Integer | **UI**: "Floor No." (`floor_param_floorno`)

#### `$building_name`

Name of the Building containing the main Unit.\
**Type**: String | **UI**: "Name" (`building_param_name`)

#### `$project_name`

Name of the Project containing the main Unit.\
**Type**: String | **UI**: "Name" (`project_param_name`)

***

## Units Lists

Multiple lists are available for iterating over Units associated with the Inspection. Each list is filtered by Unit type.

### Available Lists

| List Name           | Description                                                           |
| ------------------- | --------------------------------------------------------------------- |
| `$units`            | All Units on the Deal                                                 |
| `$cellars`          | Units of type CELLAR                                                  |
| `$parking`          | Units of type PARKING (legacy alias, use `$parkings`)                 |
| `$parkings`         | Units of type PARKING                                                 |
| `$outdoor_parkings` | Units of type OUTDOOR\_PARKING                                        |
| `$garages`          | Units of type GARAGE                                                  |
| `$parkingLikeUnits` | All Units with parking-like types (PARKING, OUTDOOR\_PARKING, GARAGE) |

### How to Use

To iterate over Units in your template:

```velocity
#foreach($unit in $units)
  Unit: $unit.internal_id (Floor: $unit.floor_no)
#end
```

To iterate over specific Unit types:

```velocity
#if(!$cellars.isEmpty())
Cellars:
#foreach($cellar in $cellars)
  - $cellar.internal_id
#end
#end
```

### Unit Item Properties

Each item in the Unit lists has the following properties:

#### `$unit.internal_id`

Internal ID of the Unit.\
**Type**: String | **UI**: "Number in project" (`flat_param_internalid`)

#### `$unit.floor_no`

Floor number where the Unit is located.\
**Type**: Integer | **UI**: "Floor No." (`floor_param_floorno`)

***

## Defects (Repeating List)

The `$defects` list contains all Defects associated with the Inspection.

### How to Use

To iterate over Defects in your template:

```velocity
#foreach($defect in $defects)
  Defect No.: $defect.internal_id
  Description: $defect.description
  Location: $defect.location
#end
```

### Available Properties

Each `$defect` item has the following properties:

Identification

#### `$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 (e.g., customer's reference number). Empty string if not set.\
**Type**: String | **UI**: "Defect No. according to the customer" (`business_case_reclamation_defect_param_externalid`)

#### `$defect.is_external_id`

Whether an external ID is set.\
**Type**: Boolean

Location

#### `$defect.location`

Location description (e.g., room name). Empty string if not set.\
**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 (from DefectRoomFormatter). Empty string if not set.\
**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. Empty string if not set.\
**Type**: String | **UI**: "Reclamation description" (`business_case_reclamation_description`)

#### `$defect.is_description`

Whether description is set.\
**Type**: Boolean

#### `$defect.note`

Additional notes. Empty string if not set.\
**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 this Defect prevents the usage of the flat.\
**Type**: Boolean | **UI**: "Prevents flat usage" (`business_case_reclamation_defect_param_prevents_flat_usage`)

#### `$defect.deadline_calculated`

Calculated deadline date for fixing the Defect.\
**Type**: DateWrapper

#### `$defect.is_deadline_alternative`

Whether an alternative deadline has been set (different from calculated).\
**Type**: Boolean

Images (Nested List)

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

Note: The first Defect in the list will have a placeholder image if it has no attachments. This ensures the template renders correctly even when there are no actual images.

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

#### `$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/list-of-inspection-defects.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.