Skip to main content

Unassigned Logs

tip
  • Purpose: Reconcile tracker data from unmapped computers and map them to employee profiles.
  • Navigation: Go to Tracker → Unassigned Logs (URL: /app/main/unassigned-logs).
  • How it Works: Click any table row to open the mapping modal, select the employee, confirm any reassignment warning, and click Save.
  • Impact: Connecting machine systems to active employee profiles properly routes time metrics and screenshots to user timelines and reports.

What are Unassigned Logs?​

Unassigned Logs are time tracking and desktop activity logs captured from user desktops where the machine/computer itself has not yet been associated (mapped) to an active employee profile in Vineforce Teams.

When employees install and run desktop tracking applications, including Vineforce Teams Desktop and the silent-mode Vineforce Teams Lite, activity metrics (such as time tracked, active window titles, and screenshots) are automatically captured and synced. If the machine's hostname or hardware UUID is not mapped to any active employee profile, the system groups these entries under Unassigned Logs.

This screen is required for administrators to reconcile these logs, linking the system hardware to the correct user. Mapping a system ensures that all subsequent activity tracking is attributed to the correct team member's reports, timelines, and dashboard widgets.

How to Navigate to the Unassigned Logs Screen​

Administrators can access the screen by navigating to: Tracker → Unassigned Logs

  • URL Route: /app/main/unassigned-logs
  • Required Permission: Pages.TrackerDashboard.UnassignedLogs

Screen Layout and Table Overview​

The screen displays all unassigned log aggregates in a lazy-loaded table. Logs are grouped together by the source desktop system.

Table Columns​

The table displays the following fields:

ColumnDescriptionSortable
System NameThe host name of the computer that synced the tracker logs (e.g., DESKTOP-5M4LK91).Yes
System Unique IDThe unique hardware UUID (systemUuid) of the machine.Yes
OS PlatformThe operating system of the host machine (e.g., Windows, Linux, macOS). Displays with platform-specific badges.Yes
From DateThe date of the earliest unassigned activity log recorded from the machine.No
To DateThe date of the most recent unassigned activity log recorded from the machine.No

OS Platform Badge Styling​

To help quickly identify systems, the operating system is displayed with color-coded badges:

  • Windows — Light blue badge (badge-light-primary) with a desktop icon.
  • Linux — Light green badge (badge-light-success) with a desktop icon.
  • macOS — Light blue/info badge (badge-light-info) with a desktop icon.
  • Unknown/Other — Dark badge (badge-light-dark).

Search and Filtering Behavior​

There are currently no search or filter fields available on this screen.

All logs are loaded dynamically with server-side pagination. Sorting is available on the System Name, System Unique ID, and OS Platform columns by clicking the column headers.

Row-Level Actions​

Assign Logs to User​

  • Trigger: Click anywhere on a table row.
  • Behavior: Opens the Assign Logs to User modal for the clicked machine.
  • Purpose: Allows the administrator to select an employee from the system and map all existing and future logs from this machine to their account.

The "Assign Logs to User" Modal​

The modal provides a dropdown field to select a user and validates their mapping status in real time.

Fields and Controls​

  1. Select User (UserName): A dropdown displaying all registered users.
  2. Mapping Warning / Info Alert:
    • User is Not Mapped: If the selected user is not currently mapped to any machine, a green success banner is displayed:

      "This username is not currently associated with any machine. You may proceed with the mapping."

    • User is Already Mapped: If the selected user is already mapped to a different machine, a yellow warning banner is displayed:

      "This username is already mapped to [PreviousMachineName]. Please confirm if you want to reassign it."

  3. Confirm Reassignment Checkbox (confirmCheck):
    • Only visible when the user is already mapped to a different machine.
    • Label: "I confirm that I want to reassign this username to the current machine."
    • Must be checked to enable the Save button.
  4. Save Button: Submits the mapping.
  5. Close Button: Cancels the action and closes the modal.

Data Loading & Synchronization​

  • Lazy Loading: The main list is lazily loaded using PrimeNG's lazy-load events, calling the backend API getUnAssignedLogsData.
  • Pagination: The page size defaults to the predefined count (typically 10 records) and can be configured using the paginator.
  • Mapping Sync: Once a user mapping is successfully saved, the system calls assignLogsToUser which updates the database. The app fires a global event unassignedLogsUpdated via ABP (abp.event.trigger). This event triggers an automatic reload of the main table and updates any dashboard widgets containing unassigned logs.

Business Rules & Permissions​

  • Permission Guard: Accessing the screen or its dashboard widgets requires the permission Pages.TrackerDashboard.UnassignedLogs.
  • Reassignment Rule: Mapped machines cannot be silently overwritten. Administrators must explicitly check the reassignment confirmation to prevent accidental overwrites of existing user-machine mappings.

Frequently Asked Questions (FAQ)​

Why are my tracking hours showing up under Unassigned Logs?​

This happens when the tracking app (Desktop or Lite) is installed on a computer but the computer hasn't been associated with an employee profile. Reconciling this mapping resolves the issue.

Can I assign a user to multiple computers?​

A user profile can only be mapped to one system name at a time. If you map a user to a new machine, the administrator must confirm the reassignment which overwrites the previous association.

How soon do logs sync after saving the mapping?​

Once mapped and saved, existing historical logs and all subsequent real-time tracking logs will instantly associate with the designated user profile across timelines, reports, and dashboards.