Differences

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

--- software:squirrel:orphaned_files [2025/02/02 13:38] – support@smikar.com
+++ software:squirrel:orphaned_files [2025/03/26 13:26] (current) – support@smikar.com
@@ Line 1: / Line 1: @@
-**Orphaned Files**
+===== 🔍 Squirrel Orphaned Files =====
-In the Squirrel system, Orphaned Files refer to files that are no longer linked to their original SharePoint sites or have become disconnected from their source due to various reasons, such as site migrations, deletions of the Squirrel Stub File, or reorganization. These files still exist within the Squirrel system but cannot be accessed or managed in the usual way because they are no longer associated with the original location.
+In the [[https://www.smikar.com/squirrel/|Squirrel]] system, **Orphaned Files** refer to archived files that are no longer linked to their original SharePoint site or stub file. These disconnections typically occur due to site deletions, stub removals, or major structural changes within SharePoint.
-**Why Files Become Orphaned:**
+Although orphaned files are still safely stored in Azure Blob Storage and tracked by Squirrel, they are no longer associated with their original location — which prevents standard restore workflows from functioning.
-**Site Deletion:** When a SharePoint site is deleted, all associated files may become orphaned if they are not archived or moved to another site.
+----
-**Site Reorganization:** If a site is reorganized and files are moved or restructured, some files might not get properly re-linked, resulting in them becoming orphaned.
+==== ❓ Why Files Become Orphaned ====
+- **🗑️ Site Deletion**
+  If a SharePoint site is deleted without restoring its archived files first, those files become orphaned.
+- **🔁 Site Reorganization**
+  During structural changes or site migrations, some file associations may break if not properly re-linked.
+- **🧺 Stub File Deleted or Moved**
+  When a user deletes or relocates a stub file, the link between the archive record and SharePoint is lost.
+----
+| 📂 Select **Orphaned Files** from the Squirrel Dashboard menu. | {{:software:squirrel:orphaned_files_menu.png?200}} |
+| 🧾 You’ll be shown a list of all files that are no longer linked to their original SharePoint location. | {{:software:squirrel:squirrel_orphaned_files.png?400}} |
+----
+==== 📋 Orphaned Files Table ====
+Each row in the **Orphaned Files Table** includes:
+- **📄 Filename** – The name of the orphaned file
+- **📅 Date Archived** – When the file was originally archived
+- **📁 Original Filepath** – The SharePoint path the file was originally archived from
+- **📏 File Size** – Size of the file (in MB)
+- **🛠️ Actions** – Options to **Restore** or **Delete** the orphaned file
+----
+==== 🔄 Restoring Orphaned Files ====
+When restoring orphaned files:
+. Squirrel will automatically rehydrate the file to a designated **Orphaned Files SharePoint Site**, defined in your system settings under `Orphaned_restore_path`.
+. Admins can then share the restored file with the appropriate user or migrate it manually as needed.
+> 💡 This ensures archived data is never lost — even if its original context is no longer available.
+----
+For help managing orphaned files or configuring the orphaned restore site, contact [support@smikar.com](mailto:support@smikar.com).
-| Select Orphaned Files from the Squirrel Menu | {{:software:squirrel:orphaned_files_menu.png?200 |}}|
-| From there the main window will now show you all of your documents that have been archived from your SharePoint Sites by Squirrel, but the original file location has been deleted. | updated with pic|