Differences

This shows you the differences between two versions of the page.

--- software:squirrel:archived_files [2025/02/02 13:34] – support@smikar.com
+++ software:squirrel:archived_files [2026/03/28 11:58] (current) – support@smikar.com
@@ Line 1: / Line 1: @@
-**Archived Files Overview**
+===== 🗄️ Squirrel Archived Files Overview =====
-The Archived Files page in Squirrel provides a comprehensive view of all archived files across SharePoint sites. This page allows administrators to monitor, manage, and restore archived files quickly. The interface is designed to offer easy navigation through large datasets and enables efficient file restoration.
+The **Archived Files** section in [[https://www.smikar.com/squirrel/|Squirrel]] provides administrators with a centralized view of **all archived documents** across connected SharePoint sites. From this interface, you can efficiently search, review, and restore files on demand.
-| Select Archived Files from the Squirrel Menu | {{:software:squirrel:archived_files_menu.png?200 |}}|
+This dashboard is designed for quick navigation, even across large datasets, enabling granular control over archived content.
-| From there the main window will now show you all of your documents that have been archived from your SharePoint Sites by Squirrel. | {{:software:squirrel:archived_files_overview.png?200 |}}|
-**Main Features:**
+----
-  * **Filename Search:** The search bar allows admins to search for specific files by filename. This helps in quickly locating archived files by name.
-  * Date Archived: The table displays the date when each file was archived. This information is helpful for tracking and managing archived content over time.
-  * **Filepath:** Displays the full path of the file within the SharePoint site, helping to locate its original location and ensure the correct file is being restored.
-  * **File Size:** This column shows the size of the file in megabytes (MB), allowing admins to assess the size of archived files before initiating any actions.
-  * **Action:** Provides the Restore button for each archived file. Admins can restore any file by simply clicking on this button. The file will be returned to its original location in SharePoint.
-**File Navigation:**
+| 📂 From the Squirrel dashboard, click **Archived Files** in the left-hand menu. | {{:software:squirrel:squirrel_archived_files_sidepanel_light.png?200}} |
+| 📋 You'll see a list of all files that have been archived by Squirrel from across your SharePoint environment. | {{:software:squirrel:squirrel_archivedfiles_light.png?200}} |
-At the bottom of the archived files list, you'll find pagination controls:
+----
-  * **First:** Navigate to the first page of the archived files.
+==== 🔍 Key Features ====
-  * **Previous:** Go back to the previous page.
-  * **Next:** Move to the next set of archived files.
-  * **Last:** Navigate to the last page of archived files.
-  * **Page Number:** Indicates the current page and total number of pages.
+  * **🔎 Filename Search** -- Use the search bar at the top to quickly locate archived files by their name (minimum 3 characters).
+  * **📅 Date Archived** -- Shows when the file was archived, helping track retention periods or audit recent changes. Search by date using YYYY-MM-DD format.
+  * **📁 File Path** -- Displays the original file location in SharePoint, making it easy to verify the file's source before restoring. Use the copy icon beside any path to copy it to your clipboard.
+  * **📏 File Size** -- Indicates the total size of the file including all versions (displayed in B, KB, MB, GB, or TB as appropriate).
+  * **🔄 Restore Action** -- Each file has a **Restore** button which opens the restore options dialog, allowing you to restore to the original location or to an alternative location.
-**Action Buttons**
+----
-The Restore button is available next to each file in the list. By clicking Restore, the file will be moved back to its original location in SharePoint, making it accessible again.
+==== 📚 File Navigation ====
-**Usage Tips:**
+At the bottom of the page, use the **pagination controls** to browse through archived records:
-To speed up the process of restoring multiple files, use the Search Filename or Search Filepath filters to locate specific files quickly.
+  * ⏮️ **First** – Jump to the first page
-For large archives, take advantage of the pagination system to break down the data into manageable sections.
+  * ◀️ **Previous** – Go to the previous set of files
+  * ▶️ **Next** – Advance to the next page
+  * ⏭️ **Last** – Jump to the final page
+  * 🔢 **Page Number** – Displays your current position in the dataset (e.g., Page 3 of 12)
+----
+==== 🛠️ Restore Action ====
+Clicking the **Restore** button on any file opens the **Restore File** dialog. You will be prompted to choose where you want to restore the file.
+=== Option 1: Restore in Place ===
+Select **Restore in Place** to return the file to its original SharePoint location. The file will be queued for restoration immediately and will become available to end users with the appropriate permissions once complete.
+=== Option 2: Restore to Another Location ===
+Select **To Another Location** to restore the file to a different SharePoint site or folder. This option takes you through a two-step process:
+**Step 1 — Search for a destination site**
+  - Type at least 3 characters into the site search field.
+  - Matching sites will appear in a dropdown — click the desired site to select it.
+  - A confirmation banner will appear showing the selected site name.
+**Step 2 — Enter the path within the site**
+  - The path field will be pre-populated with the selected site's base URL.
+  - Type or refine the path to the target folder (e.g. ''Shared Documents/Restored Files/'').
+  - As you type, path suggestions will appear in a dropdown based on existing folders in the site — click a suggestion to select it, or continue typing a custom path.
+  - Click **Restore to This Location** (or press Enter) to queue the restore.
+Once submitted, a notification will confirm the file has been queued for restoration to the specified path.
+> ℹ️ You can click **Back** at any step to return to the previous screen, or click **×** to cancel the restore entirely.
+----
+==== ☑️ Bulk Restore ====
+To restore multiple files at once, use the checkboxes on the left of each row:
+  * Check individual rows to select them, or use the header checkbox to select all files on the current page.
+  * Selected rows are highlighted in green.
+  * Once one or more files are selected, click **Restore Selected** to queue all selected files for restoration to their original locations.
+  * A notification will confirm how many files were successfully queued, how many were already in the queue, and how many (if any) failed.
+> ℹ️ Bulk restore always restores files to their original locations. To restore to an alternative location, use the individual Restore button on each file.
+----
+==== 📂 Restore by Filepath ====
+When a **Filepath** search is active, an additional **Restore All in Path** button becomes available. This allows you to queue all files matching the current filepath search for restoration in one action.
+A confirmation dialog will appear showing the number of files affected and prompting you to review your search criteria before proceeding.
+----
+==== 💡 Usage Tips ====
+  * Use **Search by Filename** or **Search by File Path** to narrow results quickly — a minimum of 3 characters is required for both fields.
+  * For bulk review, use pagination to work through the archive in manageable segments.
+  * Restored files retain their original metadata and location structure.
+  * Files remain in the archive list after restoration (with updated status), allowing for full audit trails.
+  * Use the **copy icon** beside any filepath to copy the full path to your clipboard for reference.
+----
+Need help restoring files or navigating archived content? Contact [[mailto:support@smikar.com|support@smikar.com]] for assistance.