The provided placeholders deliver pin-related information in the Reports.

NOTE: The inclusion of all pin-related placeholders is structured in a section marked by an open and closed tag format. The section begins with the opening tag {{pins}}, followed by adding more pin placeholders in the usual manner. Finally, the section is concluded with the closing tag {{/pins}}. It is important to note that the additional / appears exclusively in the closing tag. The exception to this rule are the sorting placeholders, where the pin area is added within the sorting area.

Pin Details Placeholders

{{pins}} - Opens the pin area.
{{/pins}} - Closes the pin area.
{{pin-number}} - Displays the Pin Number.
{{pin-creation-date}} - Shows the date the pin was created in the app.
{{pin-created-by}} - Displays the name of the user who created the pin.
{{pin-status}} - Displays the current Status of the pin - open, closed, inactive. Learn more about Pin Status here.
{{pin-category}} - Displays the current Category of the pin.
{{pin-title}} - Provides the Title of the pin.
{{pin-closed-on}} - If the pin is closed, this shows the date it was closed. If it is open, an empty value is returned.
{{pin-closed-by}} - If the pin is closed, this placeholder indicates the name of the user who marked it as closed. If the pin is still open, the placeholder returns an empty value.
{{pin-link}} - Provides a link to the pin in the app. Only active project members with the correct Role can access it. For example, Subcontractors without assigned Tasks cannot see the pin.
{{pin-qr-code}} - Generates a QR code for the pin. Similar to pin links, only active project members with the correct Role can access the pin through this code. This placeholder is only available for Word Reports.
{{pin-qr-list}} - This placeholder is used outside the pins area and displays a List of QR codes for all pins included in the Report. The QR codes can then be scanned with our iOS apps, and the pins will be opened directly if the user has the rights to access them. This placeholder is only available for Word Reports.
{{pin-task-progress}} - Shows the progress of Tasks within the pin, e.g., 2/5 Tasks completed.
{{pin-plan-name}} - Displays the name of the Plan in which the pin is located.
{{pin-plan-version}} - Displays the Version number of the current Plan revision.
{{plan-folder-name}} - Refers to the name of the folder in which the Plan is stored.
{{pin-group}} - Lists all groups (except filter groups) to which the pin has been added.
{{pin-creation-date-notime}} - Shows only the date the pin was created in the app.

Pin Sorting Placeholders

With these placeholders, you can organize Reports by plans and categories and append a Title to ensure proper sorting in the table of contents.

If there is no specific sorting placeholder, the app uses the standard sorting from the Pin/Task List. However, the sorting placeholders override the app's standard sorting. NOTE: These placeholders are only for Word Reports.

NOTE: The sorting placeholders should include the pin area within the sorting area. The correct usage is:

```

{{pin-sort}}

...sorting placeholders...

{{pin}}

...pin placeholders...

{{/pin}}

{{/pin-sort}}

```

{{pin-sort}} - Opens the pin sorting area.
{{/pin-sort}} - Closes the pin sorting area.
{{sort-by-plan}} - This function arranges the pins by the name of the Plan they are associated with and then sorts them by their Pin Numbers.
{{sort-by-category}} - With this function, pins are ordered by their respective Categories, with the categories sorted in alphabetical order from Z to A.
{{pin-sort-title}} - This placeholder is used in conjunction with one of the two preceding placeholders. It serves to display the name of the sorted Plan or Category.
{{sort-by-pf-NAME}} - Sorts the results of a Report based on the content of a specific Pin Field. Instead of sorting by standard fields (e.g., Creator or date), this placeholder can sort directly by a custom field within the pins – for example, by a specific Status, a part of a building, or a named text field.

It can be used in the following layout:

The Report will display the results as shown below:

Plan View Placeholders

NOTE: These placeholders are only for Word Reports.

{{pin-plan-snippet-large}} - This placeholder provides a Plan snippet for each pin in the Report. It shows the position of the pin on the Plan along with a minimap that displays the entire Plan and the specific position of the provided plan snippet. The zoom level of the plan snippet and the size of the minimap can be adjusted during Report creation. The small plan snippet shows a highly magnified section of the Plan, while the medium and large levels show increasingly larger parts of the Plan.
{{plan-snippet-overview-a4}} - Displays the entire Plan in A4 format, including the selected pins for the Report, on a whole A4 page.
{{plan-snippet-overview-a5}} - Displays the Plan, including the selected pins for the Report, in A5 format.

NOTE: The placeholders for plan views in A4 and A5 formats are designed to work in conjunction with the placeholder for pin sorting by Plan - {{sort-by-plan}}. It is essential to ensure that these placeholders are positioned in the pin sorting area for their intended use. The correct usage is:

```

{{pin-sort}}

{{sort-by-plan}}

{{plan-snippet-overview-a4}} or {{plan-snippet-overview-a5}}

{{pin}}

...pin placeholders...

{{/pin}}

{{/pin-sort}}

```

Dataset Placeholders

{{all-datasets}} - Displays all Dataset links associated with a pin in separate Rows. The format shows the Title of the Dataset, followed by the ID and the Title, e.g., "Crafts: 08 - Electrical"; "Room List: 2.008 - WC/Shower".
{{alldatasets-all-info}} - This placeholder provides all additional information from the Dataset links used in the pin and presents them in a table format in your Report. This placeholder is only available for Word Reports.
{{dataset-DATASETNAME}} - Retrieves information from the "ID" and "Title" Columns for the selected Dataset. To use this placeholder, replace "Datasetname" with the specific Dataset you want to represent in the Report. For example, if there is a Dataset named "Room info" with the following data: ID - 1, Title (Room) - Living Room, the placeholder would be named {{dataset-roominfo}}. It will be displayed in the Report as follows: "1 - Living Room". If multiple links from the same Dataset are selected, they are separated by a comma - "1 - Living Room, 2 - Bathroom".
{{dataset-column-DATASETNAME--COLUMNNAME}} - This placeholder returns data from a specific Column (defined by "COLUMNNAME") within a selected Dataset ("DATASETNAME"). It is important to note that there must be two hyphens -- between the Dataset name and the Column name. For example: {{dataset-column-room-info--room}} will only display the room in the Report: "Living Room".

NOTE: If the Dataset or Column name consists of multiple words, replace the spaces with a hyphen, e.g., use {{dataset-room-info}} instead of {{dataset-Room info}}.

Pin Media Placeholders

NOTE: These placeholders are only for Word Reports.

{{Pin-Media}} - Displays all Media attachments, excluding photos and sketches, including Audio and video Files, Documents, Notices, and visual Files added as a Document. The Media are displayed without preview in a table and contain the following information: Media type, filename, Creator, creation date, and an optional Description if provided during upload.
{{if-media}} and {{end-if-media}} - When placed outside the placeholders for open and closed Media, they check if Media content is present. Headings are only displayed if there is actually Media content that follows the condition.
{{pin-media-without-notes}} - Displays all Files attached to the pin. Notices and images are excluded.

Image Placeholders

NOTE: These placeholders are only for Word Reports. The only exception is the placeholder {{pin-media-file-name}}.

{{picture-table-small}} - Displays three images in each Row with creation date, time, and Description under each photo.
{{picture-table-medium}} - Displays two images side by side in each Row. The creation date, time, and Descriptions are provided under the images.
{{picture-table-large}} - Displays one image per Row at maximum size, along with creation date, time, and Description, if available.
{{picture-table-small-notime}} - Displays three images per Row without information on creation date and time.
{{picture-table-medium-notime}} - Displays two images side by side in each Row, without providing information on creation date and time.
{{picture-table-large-notime}} - Displays a large image table with one image per Row at maximum size. It contains no information on creation date and time.
{{picture-table-small-filename}} - Displays three small images in each Row with the filenames of the photos under the photos, directly before the creation date and time, to allow for precise referencing.
{{picture-table-medium-filename}} - Displays two images in each Row with the filenames of the photos under the photos, directly before the creation date and time, to allow for precise referencing.
{{picture-table-large-filename}} - Displays one large image in each Row with the filenames of the photos under the photos, directly before the creation date and time, to allow for precise referencing.
{{pin-feature-image}} - This placeholder displays the very first image from the pin gallery, which is also the main image displayed at the top of the pin (the so-called feature image).
{{all-pin-media-file-names}} - Provides a List of the names of all Media Files, separated by ";".
{{pin-media-file-name}} - This placeholder returns the filename of an image. It is used in an area enclosed by {{pin-medias}} and {/pin-medias}}. This placeholder is exclusively applicable in an Excel Template. For more information, please see the article on "Excel Placeholders".

Placeholders for Notices

{{pin-notices}} - Displays all Notices of a pin separated by ";".
{{pin-notices-format}} - This placeholder displays each Notice individually, including information about the creation date and time under each Notice. This placeholder is only available for Word Reports.

Placeholders for Attached Files

NOTE: These placeholders are only for Word Reports.

{{attach-documents}} - Displays the content of all PDF Files attached to the pins in the Report. This feature allows for convenient viewing of the attached PDF contents within the Report itself, without having to switch to another Document.
{{attach-documents-format}} - Displays the content of the attached PDF Documents at the correct scale to ensure a clear and easily readable presentation in the Report.

Task Placeholders

{{if-tasks}} and {{end-if-tasks}} - When placed outside the placeholders for open and close the Task area, they check if there are Tasks in the pin. Headings are only displayed if there is at least one active Task that follows the condition.
{{tasks}} - Opens the area for placeholders related to Tasks.
{{/tasks}} - Closes the Task area.

NOTE: The Task area is located within the pin area, e.g.:

{{pins}} ...Pin placeholders... {{tasks}} ...Task placeholders... {{/tasks}} {{/pins}}

To learn more about the Task-related placeholders, please read the corresponding article.

GPS Data and Pin Location Placeholders

{{pin-latitude}} - Pin GPS data - latitude.
{{pin-longitude}} - Pin GPS data - longitude.
{{pin-altitude}} - Pin GPS data - altitude.
{{pin-x}} - Displays in percentage the position of the pin on the X-axis of the Plan from the starting point at the top left.
{{pin-y}} - Displays in percentage the position of the pin on the Y-axis of the Plan from the starting point at the top left.

Pin Fields

Placeholders for Pin Fields assist in displaying various types of information in a Report and offer flexibility in its structure. These placeholders start with "pf", followed by the Field name and the desired value for display. You can easily access pre-generated placeholders for your Pin Fields within the app:

Navigate to the project settings.
Select the "Pin Designs" tab.
Access the detail view for a Field.
Click on the {{}} icon to display related placeholders.
Copy each placeholder using the designated button.

Types of Pin Field Placeholders:

{{pf-FIELDNAME-title}} - Returns only the Title of the selected Field, e.g., "Cost".
{{pf-FIELDNAME-value}} - Returns only the value entered in the Pin Field, e.g., 75.
{{pf-FIELDNAME-title-value}} - Displays the Title of the Pin Field and the value, e.g., "Cost: 75".
{{pf-FIELDNAME-title-suf}} - Displays the Field title and the suffix, e.g., "Cost (€)".
{{pf-FIELDNAME-value-suf}} - Returns the Field value and the suffix, for example, "75 €".
{{pf-FIELDNAME-title-value-suf}} - Displays the Field title, the value, and the suffix, e.g., "Cost: 75 €".
{{pf-FIELDNAME-suf}} - Display only the suffix, e.g., "€".

In addition, there are other specific Pin Field Placeholders:

{{pin-tags}} - Provides the tags added to the pin.
{{all-pf}} - Presents all Pin Fields in a table format, with Field titles in the first column and their values in the second.

Placeholders for Colors of the Pin Slider

{{pfc-FIELDNAME}} - This specialized placeholder retrieves the value of the Pin Slider Field and displays it as a color in the Report. To implement this, the slider field must be configured in a specific way by naming the slider values according to the colors intended for display in the Report.

For example, a Pin Slider Field named "Urgency" with three values: Green, Yellow, and Red, as shown below: