Skip to main content

Understand the nightly upload log file

Review and interpret the nightly upload log file, including warnings, errors, and required actions.

C
Written by Charlotte Alderson

If your account uses a nightly upload file, the system generates a log after each run. This log shows what changes were made, highlights any issues, and indicates any actions required.

📌 Note: Users assigned as Nightly File Manager receive the log by email.

Understand how the log file works

The nightly upload file:

  • Updates existing users.

  • Adds new starters.

  • Processes leavers.

The log file confirms these actions and flags any issues.


Understand key data dependencies

  • Payroll ID is the unique identifier used to match users.

  • The file must follow the correct format to process successfully.

If this data is incorrect, errors may occur.


Understand log message types

Informational messages

These confirm successful updates and don’t require action.

Examples:

  • New user added.

  • User assigned to a group.

  • Line manager updated.


Warning messages

These highlight issues that may need review or action. Common examples:

Missing manager

  • The manager’s Payroll ID doesn’t match an existing user.
    Action:

  • Add the manager or correct the Payroll ID.

User not in upload file

  • A user exists in the system but not in the file.
    Action:

  • Add them to the file or run the leaver wizard.

Duplicate email address

  • The email already exists for another user.
    Action:

  • Update the email or correct the Payroll ID.

Archived group

  • The file assigns a user to a group that is archived.
    Action:

  • Reactivate the group or update the file.

Multiple group assignment warning

  • A user appears in more than one main group.
    Action:

  • Confirm if this is intentional or remove the extra assignment.

Missing work pattern data

  • Work pattern or start date is missing or invalid.
    Action:

  • Correct the data in the upload file.


Understand leaver processing

If the file includes an end date:

  • The system runs the leaver process automatically.

  • The user becomes read-only until their leave date.

  • Their allowance is recalculated.


Understand allowance updates

If the allowance profile changes:

  • The system recalculates the user’s entitlement.

  • The log includes a breakdown of the calculation.


Fix combined errors

Some log entries combine multiple issues.

To resolve:

  • Review each part of the message.

  • Match it to the relevant error type.

  • Apply the appropriate fix.


Confirm successful processing

After reviewing the log:

  • Check that expected updates were applied.

  • Fix any warnings that require action.

  • Monitor future logs to confirm stability.

Did this answer your question?