- 1. What is a tag ?
- 2. How are the tags for repeatable sections different?
- 3. In practice, how do I display repeatable sections in my custom reports?
Repeatable sections are useful when your operator needs to repeat the same action multiple times.
By using repeatable section tags, you can display the data collected in these repeatable sections.
1. What is a tag ?
With Ermeo, you can customize your reports in Word or Excel format. We use a tag system to insert data from interventions into your reports. A tag is a code used to identify a block. To retrieve all these tags, there are two solutions:
- Each block in your form has a tag. You need to click on the tag button to retrieve this tag
2. Each form has a configuration file. The configuration file contains all the tags for the blocks that make up your form. This file can be found on the home page of your form.
2. How are the tags for repeatable sections different?
The tags designating the content of a repeatable section must be placed between a ##repeat_section:start## tag and a ##repeat_section:end## tag.
2.1. Example
- Let's say there's a repeatable section with the tag: ##repeat_section_reference##
- And a task contained in the repeatable section, with the tag: ##ref_task##
The tags should be placed in the following order within the custom report:
- ##repeat_section_reference:start##
- ##ref_task##
- ##repeat_section_reference:end##
The "start" and "end" tags should only be entered once. Everything between these two tags will be repeated. Between the start and end tags, you can place as many tags as you want.
3. In practice, how do I display repeatable sections in my custom reports?
3.1. Context
Imagine a company that needs to inspect a construction site. For each engine encountered on the site, the field operator will need to record the engine's power. They will need to perform this action multiple times.The company wants to collect the different power readings in an Excel file that will constitute a custom report.
- In a form, drag and drop the "Repeatable Section" block. Name it "Repeatable Section".
- Within this repeatable section, drag and drop the "Number" block. Name it "Engine Power".
- Download the configuration file from your form's home page.
- Copy and paste the different tags into your custom report template in Excel format.
Please follow this structure:
- ##repeat_section_reference:start##
- ##ref_task##
- ##repeat_section_reference:end##
- Import the custom report template.
- Start an intervention with the created form.
- For each engine encountered, click on "Add". The "Add" button allows you to add an occurrence to your repeatable section. Click on "Add" as many times as you want.
- Download the report of your intervention with the previously imported report template.
- The different readings taken appear on your custom report.
- To display the section title, place the tag ##ref_section_repetable: title##
- The start and end tags do not display any text.