Reports
A successful project includes at least one report. Reports allow us to break down the overall data deliverables into smaller, manageable chunks. For example, a project requiring a list of all McDonald's locations in the United States can be split into reports for each state. The organization of the overall data into reports is driven by the customer’s needs, with Grepsr providing suggestions on best practices. Once all the requirements are confirmed, a report is created on the Grepsr side for clients to access and consume the extracted data.
Report Configuration
Report configuration helps in customizing the settings for generating a report. It helps to tailor the report to specific needs, ensuring the data is relevant and presented in a clear and useful way.
The available configurations in the Report Configuration are as follows:
| Configuration | Description | Example | Default Value |
|---|---|---|---|
| Active child task limit | Set the maximum number of child tasks a crawler can run at the same time. | Allow up to 500 child tasks to run concurrently. | 260 |
| Additional destination | Send deliveries to additional email addresses that are hidden from platform logs. | Deliver a report to xyz@company.com in addition to the primary recipient. |
N/A |
| Allow supporting files directory | Deliver supporting files using either a flat folder structure or nested folders, if applicable. | - | False |
| Custom export file name | Customize the name of exported files using placeholders such as REPORT_ID, USER_ID, ORG_ID, TEAM_ID, and HISTORY_ID. |
{report}_{YYYY}_{MM}_{DD}↓54321_2026_06_11 |
- |
| Custom zip file name | Set a custom name for ZIP files. | Save the ZIP file as daily-report.zip. |
N/A |
| Data profiler | Enable or disable the generation of a data profile that provides summary statistics and insights about the report data. | - | False |
| Default image | Select the image that will be used automatically if no other image is specified. | PHP 5.6 | N/A |
| Delivery failure emails | Specify who should be notified when a file delivery fails. | Send failure notifications to xyz@company.com. |
N/A |
| Export criteria | Specify conditions to exclude files from being exported. | {"operator":"OR","criteria":{"Status":"New"}}Exclude the export when the Status field is New. |
- |
| Meta fields | Define fields that are included only in partial downloads and excluded from regular exports. | {"Online_Khabar_News":{"meta_fields":["Title"]}}Title included only in partial downloads. |
N/A |
| Parallel API runs allowed | Set the maximum number of API requests that can run at the same time. | Allow up to 10 API requests to run concurrently. | 10 |
| Parquet schema | Define how each column should be stored in the Parquet file, such as text, numbers, or dates. | {"pagename1_.*":{"column1":"STRING","column2":"INTEGER"}}Here, column1 is stored as text and column2 is stored as a number. |
- |
| Quality rule use sample | Specify the number of rows to check when validating data quality rules. If no number is specified, the entire dataset is used. | Validate QA rules using the first 500 rows. | - |
| Supporting files zip name | Set a custom name for ZIP files containing supporting files. | custom_filename |
- |
| Unarchival batch size | Specify how many files are processed at a time when extracting archives. | Process 100 rows per batch during extraction. | 250 |
| Zip arc files remove timestamp | Configure whether timestamps are kept or removed from file names. | - | 0 |