Audit a folder report

The  Audit a folder  report allows you to see various actions that any user has performed on a specific Syncplicity folder over a specified period. The report results are exported as a comma separated values (CSV) file.

Create an  Audit a folder  report

  1. Start typing in the input field the Syncplicity folder name that you want to audit. The autocomplete feature assists to locate the Syncplicity folder. Click the  icon to remove the selected Syncplicity folder.
    TIP: You cannot select the Syncplicity default folders such as Desktop or Pictures.
  2. Enter the date range. The default date range for the report is from one month back through today; this range can be changed each time you run the audit a folder report.
    • The start of the date range cannot be earlier than January 1st, 2011.
    • The end of the date range cannot be later than today.
    • The maximum range between start and end dates cannot exceed 365 days.

Explanation of the audit a folder report's CSV file columns and rows

In the CSV output file for this report, each row provides information on an action performed on the specified Syncplicity folder and during the period defined by the reports date range. If the action performed by the user was related to the sharing, unsharing, or changing of sharing permission of a Syncplicity folder, then the action's row is repeated once per group and/or user associated with the Syncplicity folder sharing action.

CSV file columns

Explanation

Syncplicity Folder: Name

The Syncplicity folder name. This is sometimes referred to as a syncpoint or a Syncplicity top-level folder within the user's Syncplicity online file browser view.

Syncplicity Folder: GUID

A globally unique identifier (GUID) for the Syncplicity folder. The values in this column allow you to filter down to a view that contains only actions taken on a specific (unique) Syncplicity folder even though there may be other folders with the same name.

Syncplicity Folder: Owner

The full name of the Syncplicity user who is the owner of the Syncplicity folder. The user names in this column allow you to filter down to a view that contains only actions taken on a Syncplicity folders owned by a specific user, even though there may be other folders with the same name.

File: Path

If the action performed by the user was related to a folder or file contained within a Syncplicity folder (rather than the Syncplicity folder itself), then this column contains the file path below the Syncplicity folder, excluding the file name.

File: Name

If the action performed by the user was related to a file contained within a Syncplicity folder (rather than the Syncplicity folder itself), then this column will contain the file name, including any extensions.

Action: Type

The type of action performed by the user. Refer to the auditable user actions section below for a list of the user actions that are reflected in the audit a user report.

Shared Link: Type

The type of shared link: "Public", "Login required", "Password required", or "Login and password required".

Shared Link: Outcome

The outcome of the "File shared link accessed" action: "Download initiated", "Login failed", or "Password incorrect".

Action: Date and Time: UTC

The date and time when the action was performed in UTC time. The date and time values are formatted in the international date and time format: yyyy-MM-dd HH:mm:ss

Action: Date and Time: UTC<+/-HH:mm>

The date and time when the action was performed in the time zone based on the locale of the administrator's browser session when the report was initiated. The time zone's positive or negative offset (in hours and minutes) from UTC time is included in the column name. The date and time values are formatted in the international date and time format: yyyy-MM-dd HH:mm:ss

Action By: User Name

The full name of the Syncplicity user who performed the action listed in the "Action: Type" column. Since this audit a user report pertains to actions performed by a specific user, this column contains the same user name throughout.

Action By: Email

The email address of the Syncplicity user who performed the action listed in the "Action: Type" column. Since this audit a user report pertains to actions performed by a specific user, this column contains the same email address throughout.

Action By: Device Name

The name of the device from which the Syncplicity user performed the action listed in the "Action: Type" column.

Action By: IP Address

The IP address of the device from which the Syncplicity user performed the action listed in the "Action: Type" column.

Folder Shared/Unshared: Group Name

If the action performed by the user was related to the sharing of a Syncplicity folder with a Syncplicity group, then this column contains the name of the group.

Folder Shared/Unshared: User Name

If the action performed by the user was related to the sharing, unsharing or changing of sharing permission of a Syncplicity folder with a Syncplicity user, then this column contains the full name of the user.

Folder Shared/Unshared: Email

If the action performed by the user was related to the sharing, unsharing or changing of sharing permission of a Syncplicity folder with a Syncplicity user, then this column contains the email address of the user.

Shared Link: Group Name

If the action performed by the user was related to the sharing of file link with a Syncplicity group ("Shared link created" action), then this column contains the name of the group.

Shared Link: User Name

If the action performed by the user was related to the sharing of a file link with a Syncplicity user ("Shared link created" action), then this column contains the full name of the user.

Shared Link: Email If the action performed by the user was related to the sharing of a file link with a Syncplicity user ("Shared link created" action), then this column contains the email address of the user.
Lock: Owner Name If the action performed by the lock owner was related to the lock, the full name of the user.
Lock: Owner Email Email address of the lock owner.
Lock: Duration

Lock duration time is based on the following examples: 

  • When lock owner sets the lock:    set for <2 hours>
  • When lock owner extends the lock:    extended for <2 hours>
  • When file is unlocked:    after <1hr>  
    • If the user unlocks the file before the lock expiration, the lock duration, which is less than the requested lock, is displayed.
    • If the lock expires, the requested duration is displayed
Tags If the action performed by the user was related to the addition or removal of tags on a file or folder (where user is editor/owner), then this column contains the tags that were added or removed.

Related Links