Skip to main content

General topics

Notifications

Understand the automated email notification system that confirms your actions and archives your data.

Construction Admin Helper features an automated notification system to ensure traceability and provide users with a permanent record of their actions.

1 - Notification Principles

For every action performed in the application (Export, Import, Bulk Update), the system triggers an automatic email.

  • Sender: noreply@constructionadminhelper.com
  • Recipient: The email is sent only to the user who performed the action.
  • Mandatory Nature: It is not possible to unsubscribe from these notifications. They serve as “Proof of Action” and are essential for auditing.
  • Distribution Lists: Currently, it is not possible to add additional CC or BCC recipients. If you need to share the results, you must forward the email manually.

To ensure you keep your own record of actions, we recommend creating a dedicated folder in your mailbox to archive all notification emails.

2 - Email Content & Structure

The emails are designed to be easily identified in your inbox.

Subject Line Format

The subject line follows a standardized structure to help you filter your emails: ⚙ [AdminHelper] {Action Type} {Status} - Project {Project Name}

Example: ⚙ [AdminHelper] Punch items export completed - Project TEST

Email Body

The body contains a summary of the operation, including:

  • The type of action performed.
  • The Company and Project names.
  • A brief summary of the outcomes (e.g., number of items processed).

3 - Attachments & Archiving

The notification system acts as a decentralized archive for your work. Each email can include two types of attachments:

  1. Full Log File: A detailed text log of the operation (the same log displayed in the application). This is crucial for debugging if some lines failed to import.
  2. Output Excel File: For all Export/Import actions, the final Excel file is attached.
    • For Exports: You receive the data extract directly in your inbox.
    • For Imports: You receive the “Output” version of your file, which includes the status of each row in the Putput column (e.g., “OK” or “Validation Error”).

[IMPORTANT] The log file is also stored by Construction Admin Helper for auditing purposes, but the Output Excel File is never stored, so this notification is essentially the only fullr ecord of your modification or export.

[TIP] This means you always have a concrete trace of the data you pushed into or pulled from Procore, even if you delete or modified the files from your local computer.

4 - Special Cases & Troubleshooting

Background Processing

If you close your browser or lose your internet connection while a bulk import is running, the process will continue on our servers. Once finished, you will still receive the notification email with the results and the log file.

Failed Validations

If an import fails due to data errors (e.g., incorrect IDs or missing mandatory fields), the system will still send a “Failed” or “Outcome” notification. You should open the attached log or the Output Excel file to understand what needs to be corrected.

Technical Errors (Error 500)

In the event of a severe server-side crash (Error 500), the email might not be sent. However, the logs are still stored within the application’s internal database for our support team to investigate.