diff --git a/src/cli/backup/sharepoint.go b/src/cli/backup/sharepoint.go index 25bc12707..763540500 100644 --- a/src/cli/backup/sharepoint.go +++ b/src/cli/backup/sharepoint.go @@ -37,7 +37,11 @@ corso backup create sharepoint --site https://example.com/hr corso backup create sharepoint --site https://example.com/hr,https://example.com/team # Backup all SharePoint data for all Sites -corso backup create sharepoint --site '*'` +corso backup create sharepoint --site '*' + +# Backup all SharePoint list data for a Site +corso backup create sharepoint --site https://example.com/hr --data lists +` sharePointServiceCommandDeleteExamples = `# Delete SharePoint backup with ID 1234abcd-12ab-cd34-56de-1234abcd \ and 1234abcd-12ab-cd34-56de-1234abce @@ -57,7 +61,26 @@ corso backup details sharepoint --backup 1234abcd-12ab-cd34-56de-1234abcd \ # Explore all files within the document library "Work Documents" corso backup details sharepoint --backup 1234abcd-12ab-cd34-56de-1234abcd \ --library "Work Documents" -` + +# Explore lists by their name(s) +corso backup details sharepoint --backup 1234abcd-12ab-cd34-56de-1234abcd \ + --list "list-name-1,list-name-2" + +# Explore lists created after a given time +corso backup details sharepoint --backup 1234abcd-12ab-cd34-56de-1234abcd \ + --list-created-after 2024-01-01T12:23:34 + +# Explore lists created before a given time +corso backup details sharepoint --backup 1234abcd-12ab-cd34-56de-1234abcd \ + --list-created-before 2024-01-01T12:23:34 + +# Explore lists modified before a given time +corso backup details sharepoint --backup 1234abcd-12ab-cd34-56de-1234abcd \ + --list-modified-before 2024-01-01T12:23:34 + +# Explore lists modified after a given time +corso backup details sharepoint --backup 1234abcd-12ab-cd34-56de-1234abcd \ + --list-modified-after 2024-01-01T12:23:34` ) // called by backup.go to map subcommands to provider-specific handling. diff --git a/src/cli/export/sharepoint.go b/src/cli/export/sharepoint.go index d66bf2861..5e86cc293 100644 --- a/src/cli/export/sharepoint.go +++ b/src/cli/export/sharepoint.go @@ -45,7 +45,27 @@ corso export sharepoint --backup 1234abcd-12ab-cd34-56de-1234abcd \ # Export all files in the "Documents" library to the current directory. corso export sharepoint --backup 1234abcd-12ab-cd34-56de-1234abcd \ - --library Documents --folder "Display Templates/Style Sheets" .` + --library Documents --folder "Display Templates/Style Sheets" . + +# Export lists by their name(s) +corso export sharepoint --backup 1234abcd-12ab-cd34-56de-1234abcd \ + --list "list-name-1,list-name-2" . + +# Export lists created after a given time +corso export sharepoint --backup 1234abcd-12ab-cd34-56de-1234abcd \ + --list-created-after 2024-01-01T12:23:34 . + +# Export lists created before a given time +corso export sharepoint --backup 1234abcd-12ab-cd34-56de-1234abcd \ + --list-created-before 2024-01-01T12:23:34 . + +# Export lists modified before a given time +corso export sharepoint --backup 1234abcd-12ab-cd34-56de-1234abcd \ + --list-modified-before 2024-01-01T12:23:34 . + +# Export lists modified after a given time +corso export sharepoint --backup 1234abcd-12ab-cd34-56de-1234abcd \ + --list-modified-after 2024-01-01T12:23:34 .` ) // `corso export sharepoint [...] ` diff --git a/src/cli/restore/sharepoint.go b/src/cli/restore/sharepoint.go index 2b068ba9b..cc778a39d 100644 --- a/src/cli/restore/sharepoint.go +++ b/src/cli/restore/sharepoint.go @@ -50,7 +50,27 @@ corso restore sharepoint --backup 1234abcd-12ab-cd34-56de-1234abcd \ # Restore all files in the "Documents" library. corso restore sharepoint --backup 1234abcd-12ab-cd34-56de-1234abcd \ - --library Documents --folder "Display Templates/Style Sheets" ` + --library Documents --folder "Display Templates/Style Sheets" + +# Restore lists by their name(s) +corso restore sharepoint --backup 1234abcd-12ab-cd34-56de-1234abcd \ + --list "list-name-1,list-name-2" + +# Restore lists created after a given time +corso restore sharepoint --backup 1234abcd-12ab-cd34-56de-1234abcd \ + --list-created-after 2024-01-01T12:23:34 + +# Restore lists created before a given time +corso restore sharepoint --backup 1234abcd-12ab-cd34-56de-1234abcd \ + --list-created-before 2024-01-01T12:23:34 + +# Restore lists modified before a given time +corso restore sharepoint --backup 1234abcd-12ab-cd34-56de-1234abcd \ + --list-modified-before 2024-01-01T12:23:34 + +# Restore lists modified after a given time +corso restore sharepoint --backup 1234abcd-12ab-cd34-56de-1234abcd \ + --list-modified-after 2024-01-01T12:23:34` ) // `corso restore sharepoint [...]` diff --git a/website/blog/images/Hyperlink-Column.png b/website/blog/images/Hyperlink-Column.png new file mode 100644 index 000000000..f9d987f98 Binary files /dev/null and b/website/blog/images/Hyperlink-Column.png differ diff --git a/website/blog/images/Location-Column.png b/website/blog/images/Location-Column.png new file mode 100644 index 000000000..a4e8bd6e8 Binary files /dev/null and b/website/blog/images/Location-Column.png differ diff --git a/website/blog/images/Restored-Hyperlink-Column.png b/website/blog/images/Restored-Hyperlink-Column.png new file mode 100644 index 000000000..f800d444f Binary files /dev/null and b/website/blog/images/Restored-Hyperlink-Column.png differ diff --git a/website/blog/images/Restored-Location-Column.png b/website/blog/images/Restored-Location-Column.png new file mode 100644 index 000000000..2046c6ea8 Binary files /dev/null and b/website/blog/images/Restored-Location-Column.png differ diff --git a/website/docs/support/bugs-and-features.md b/website/docs/support/bugs-and-features.md index e0d1a2a84..b546f2889 100644 --- a/website/docs/support/bugs-and-features.md +++ b/website/docs/support/bugs-and-features.md @@ -45,3 +45,43 @@ Next, file a [GitHub issue](https://github.com/alcionai/corso/issues/) with the ([default log file](../../setup/configuration/#log-files) and `corso-gc.log`, the Corso GC log file, from above) and information on the size of the Exchange mailbox, OneDrive location, or SharePoint site that you are having an issue with. + +## Sharepoint List Anomalies + +Some columns in sharepoint list aren't recognizable from the GRAPH API response. +More about this issue [here](https://github.com/alcionai/corso/issues/5166). + +Therefore while `restore` of these columns, we default them to as text fields. +The value they hold are therefore not reinstated to the way the originally were. + + + + +### Originally created hyperlink column in Site + +![diagram of list with Hyperlink column in a site](../../blog/images/Hyperlink-Column.png) + +### Restored hyperlink column + +![diagram of restored list with Hyperlink column in a site](../../blog/images/Restored-Hyperlink-Column.png) + +### Issue tracker for hyperlink column support + +To track progress, [visit](https://github.com/microsoftgraph/msgraph-sdk-go/issues/640). + + + + +### Originally created location column in Site + +![diagram of list with Location column in a site](../../blog/images/Location-Column.png) + +### Restored location column + +![diagram of restored list with Location column in a site](../../blog/images/Restored-Location-Column.png) + +### Issue tracker for location column support + +To track progress, [visit](https://github.com/microsoftgraph/msgraph-sdk-go/issues/638). + + diff --git a/website/docs/support/known-issues.md b/website/docs/support/known-issues.md index 6f2d322f5..da4c3687a 100644 --- a/website/docs/support/known-issues.md +++ b/website/docs/support/known-issues.md @@ -45,3 +45,6 @@ Below is a list of known Corso issues and limitations: * In-place Exchange contacts restore will merge items in folders named "Contacts" or "contacts" into the default folder. * External users with access through shared links won't receive these links as they're not sent via email during restore. + +* Sharepoint list item "attachments" aren't backed up, restored or exported as + graph APIs doesn't currently provide attachment data for Lists or List Items.