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:

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

To iterate over specific Unit types:

#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:

#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.

#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