MSGraphMailbag - 复制/移动 SharePoint Online 中的文件和文件夹

最新推荐文章于 2022-07-14 15:31:21 发布
最新推荐文章于 2022-07-14 15:31:21 发布
阅读量658 收藏
点赞数 1
分类专栏： Microsoft Graph Mailbag Microsoft 365 Microsoft Graph 文章标签： MSGraphMailbag Microsoft 365 SPOnline Microsoft Graph
版权声明：本文为博主原创文章，遵循 CC 4.0 BY 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/FoxDave/article/details/115694561
版权

本篇我们介绍如何跨 SharePoint Online 网站实现有条件的文件和文件夹的复制和移动，这其实来自一个真实的客户需求。
在这里插入图片描述

业务场景

SharePoint Online 自带的拆箱即用的复制 (Copy To) 和移动 (Move To) 功能很强大，但是可选的目的端网站内容是基于登录用户关注或常访问的网站来显示的，客户希望能够指定用户可以看见的目的端去执行复制和移动操作。

解决方案

假如我们要将文件从网站 A 复制到网站 B，例如
A：https://contoso.sharepoint.com/sites/SiteA/Documents/
B：https://contoso.sharepoint.com/sites/SiteB/Documents/

复制文件

  1. 获取源端网站 A 的网站集 ID
GET
https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com:/sites/SiteA?$select=id
Response:
{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#sites(id)/$entity",
    "id": "contoso.sharepoint.com,1af9d2c5-2b3b-47d2-a167-ffd5d0c45205,e748bad1-cb75-432f-8bb1-adff3b9ef5da"
}
  1. 使用获得到的网站集 ID 去获取文档库的列表
GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,1af9d2c5-2b3b-47d2-a167-ffd5d0c45205,e748bad1-cb75-432f-8bb1-adff3b9ef5da/drives?$select=id,name

Response:
{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#drives(id,name)",
    "value": [
        {
            "id": "b!xdL5Gjsr0kehZ__V0MRSBdG6SOd1yy9Di7Gt_zue9dq9z2zXDxX4RYKTxY09UkQ-",
            "name": "Documents"
        },
        {
            "id": "b!xdL5Gjsr0kehZ__V0MRSBdG6SOd1yy9Di7Gt_zue9doAJ43YI-NhR6zMPnX1eLzZ",
            "name": "MyDocs1"
        },
        {
            "id": "b!xdL5Gjsr0kehZ__V0MRSBdG6SOd1yy9Di7Gt_zue9dr4572v55yoQo_RWg6MAlAR",
            "name": "MyDocs2"
        }
    ]
}
  1. 现在我们得到了文档库 (Documents) 的 ID，我们就可以对里面的文件和文件夹进行枚举了
GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,1af9d2c5-2b3b-47d2-a167-ffd5d0c45205,e748bad1-cb75-432f-8bb1-adff3b9ef5da/drives/
b!xdL5Gjsr0kehZ__V0MRSBdG6SOd1yy9Di7Gt_zue9dq9z2zXDxX4RYKTxY09UkQ-/list/drive/root/children?$select=id,name,webUrl

Response:
{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#sites('contoso.sharepoint.com%2C1af9d2c5-2b3b-47d2-a167-ffd5d0c45205%2Ce748bad1-cb75-432f-8bb1-adff3b9ef5da')/
drives('b%21xdL5Gjsr0kehZ__V0MRSBdG6SOd1yy9Di7Gt_zue9dq9z2zXDxX4RYKTxY09UkQ-')/list/drive/root/children(id,name,webUrl)",
    "value": [
        {
            "@odata.etag": "\"{297E7CA7-4C49-440D-8E5F-84844DA865D0},1\"",
            "id": "017LC4LMFHPR7CSSKMBVCI4X4EQRG2QZOQ",
            "name": "Decks",
            "webUrl": "https://contoso.sharepoint.com/sites/SiteA/Shared%20Documents/Decks"
        },
        {
            "@odata.etag": "\"{F3226AA0-414F-4523-8364-9E03AF05801B},1\"",
            "id": "017LC4LMFANIRPGT2BENCYGZE6AOXQLAA3",
            "name": "AuthCodePPEGuide.pdf",
            "webUrl": "https://contoso.sharepoint.com/sites/SiteA/Shared%20Documents/AuthCodePPEGuide.pdf"
        }
    ]
}
  1. 如果有更明确的要求，我们也可以将上面的查询通过 $filter Odata 参数进行优化，比如我们想要复制 AuthCodePPEGuide.pdf 这个文件，使用下面的查询获取到它的 ID
GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,1af9d2c5-2b3b-47d2-a167-ffd5d0c45205,e748bad1-cb75-432f-8bb1-adff3b9ef5da/drives/
b!xdL5Gjsr0kehZ__V0MRSBdG6SOd1yy9Di7Gt_zue9dq9z2zXDxX4RYKTxY09UkQ-/list/drive/root/children?$filter=startswith(name, 'AuthCodePPEGuide.pdf')&$select=id,name,webUrl

Response:
{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#sites('contoso.sharepoint.com%2C1af9d2c5-2b3b-47d2-a167-ffd5d0c45205%2Ce748bad1-cb75-432f-8bb1-adff3b9ef5da')/
drives('b%21xdL5Gjsr0kehZ__V0MRSBdG6SOd1yy9Di7Gt_zue9dq9z2zXDxX4RYKTxY09UkQ-')/list/drive/root/children(id,name,webUrl)",
    "value": [
        {
            "@odata.etag": "\"{F3226AA0-414F-4523-8364-9E03AF05801B},1\"",
            "id": "017LC4LMFANIRPGT2BENCYGZE6AOXQLAA3",
            "name": "AuthCodePPEGuide.pdf",
            "webUrl": "https://contoso.sharepoint.com/sites/SiteA/Shared%20Documents/AuthCodePPEGuide.pdf"
        }
    ]
}
  1. 现在我们能够通过 ID 获取到这个文件对象了
GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,1af9d2c5-2b3b-47d2-a167-ffd5d0c45205,e748bad1-cb75-432f-8bb1-adff3b9ef5da/drive/items/
017LC4LMFANIRPGT2BENCYGZE6AOXQLAA3
  1. 使用与上面步骤 1 和 2 类似的查询，我们可以获得目的端网站的网站集 ID 和文档库 ID，类似下面的查询
https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,1af9d2c5-2b3b-47d2-a167-ffd5d0c45205,e748bad1-cb75-432f-8bb1-adff3b9ef5da/drives/
b!w8qjV86a-EibM8Lpka5JcNG6SOd1yy9Di7Gt_zue9dq9z2zXDxX4RYKTxY09UkQ-
  1. 这里我们需要用到一个叫做 parentReference 的属性，它用来表示目的端的位置
  2. 通过执行 Microsoft Graph 查询来枚举目的端文档库，选择每个条目的 ID、Name 和 parentReference 属性
GET https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,1af9d2c5-2b3b-47d2-a167-ffd5d0c45205,e748bad1-cb75-432f-8bb1-adff3b9ef5da/drives/
b!w8qjV86a-EibM8Lpka5JcNG6SOd1yy9Di7Gt_zue9dq9z2zXDxX4RYKTxY09UkQ-/list/drive/root/children?$select=id,name,parentReference

Response:
{
    "@odata.context": "https://graph.microsoft.com/v1.0/$metadata#sites('contoso.sharepoint.com%2C1af9d2c5-2b3b-47d2-a167-ffd5d0c45205%2Ce748bad1-cb75-432f-8bb1-adff3b9ef5da')
/drives('b%21w8qjV86a-EibM8Lpka5JcNG6SOd1yy9Di7Gt_zue9dq9z2zXDxX4RYKTxY09UkQ-')/list/drive/root/children(id,name,parentReference)",
    "value": [
        {
            "@odata.etag": "\"{F72ACBB9-419C-41FC-965C-F90DDE31F699},1\"",
            "id": "01U7PKJ3NZZMVPPHCB7RAZMXHZBXPDD5UZ",
            "name": "DropFolder",
            "parentReference": {
                "driveId": "b!w8qjV86a-EibM8Lpka5JcNG6SOd1yy9Di7Gt_zue9dq9z2zXDxX4RYKTxY09UkQ-",
                "driveType": "documentLibrary",
                "id": "01U7PKJ3N6Y2GOVW7725BZO354PWSELRRZ",
                "path": "/drives/b!w8qjV86a-EibM8Lpka5JcNG6SOd1yy9Di7Gt_zue9dq9z2zXDxX4RYKTxY09UkQ-/root:"
            }
        },
        {
            "@odata.etag": "\"{08CB141D-4471-445B-B835-776E78A67C23},3\"",
  "id": "01U7PKJ3I5CTFQQ4KELNCLQNLXNZ4KM7BD",
            "name": "NDP462-DevPack-KB3151934-ENU.zip",
            "parentReference": {
                "driveId": "b!w8qjV86a-EibM8Lpka5JcNG6SOd1yy9Di7Gt_zue9dq9z2zXDxX4RYKTxY09UkQ-",
                "driveType": "documentLibrary",
                "id": "01U7PKJ3N6Y2GOVW7725BZO354PWSELRRZ",
                "path": "/drives/b!w8qjV86a-EibM8Lpka5JcNG6SOd1yy9Di7Gt_zue9dq9z2zXDxX4RYKTxY09UkQ-/root:"
            }
        }
    ]
}
  1. 接下来我们就可以使用上面步骤中获取到的 parentReference 属性来复制文件到文档库的根目录了
  2. 如果我们想要复制到指定的目录，需要 parentReference 属性中的文件夹 ID，例如复制到DropFolder文件夹
"parentReference": {
       "driveId": "b!w8qjV86a-EibM8Lpka5JcNG6SOd1yy9Di7Gt_zue9dq9z2zXDxX4RYKTxY09UkQ-",
       "id": "01U7PKJ3NZZMVPPHCB7RAZMXHZBXPDD5UZ"
    }
  1. 在步骤 5 中我们通过 ID 定义了要复制的文件，在步骤 10 中我们指定了要复制的目的端信息，接下来使用 POST 请求进行实际的复制操作
//To copy the file to the root of the destination library

POST https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,1af9d2c5-2b3b-47d2-a167-ffd5d0c45205,e748bad1-cb75-432f-8bb1-adff3b9ef5da/drive/items/
017LC4LMFANIRPGT2BENCYGZE6AOXQLAA3/copy
{
    "parentReference": {
        "driveId": -"
        "id": "01U7PKJ3N6Y2GOVW7725BZO354PWSELRRZ"
    },
    "name": "AuthCodePPEGuide.pdf"
}
//To copy the file to “DropFolder” folder in the destination library
POST https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,1af9d2c5-2b3b-47d2-a167-ffd5d0c45205,e748bad1-cb75-432f-8bb1-adff3b9ef5da/drive/items/
017LC4LMFANIRPGT2BENCYGZE6AOXQLAA3/copy
{
    "parentReference": {
       "driveId": "b!w8qjV86a-EibM8Lpka5JcNG6SOd1yy9Di7Gt_zue9dq9z2zXDxX4RYKTxY09UkQ-",
       "id": "01U7PKJ3N6Y2GOVW7725BZO354PWSELRRZ"
    },
    "name": "AuthCodePPEGuide.pdf"
}
Response:
HTTP 202 Accepted
{
    "cache-control": "no-cache",
    "client-request-id": "0ffe0ea7-85f6-402e-f504-1a8740423832",
    "location": "https://contoso.sharepoint.com/sites/SiteA/_api/v2.1/drive/operations/faa1c015-a4af-4dfb-9abf-03cd22890db3?c=ZU0xOVRzMGc4RFhJSV...",
    "request-id": "3868dff6-cdbd-45d1-bf3d-9ab98ea5491b"
}
  1. 我们可以通过返回请求的 location 属性查看复制的进度和状态
    在这里插入图片描述
    移动文件

跟复制操作类似，首先获取源端文件

https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,bc0a0284-87ff-4fcc-b039-0b7e02823759,e748bad1-cb75-432f-8bb1-adff3b9ef5da/drive/items/
01HD766IY4YTCVBFQNOBEZUBDSXXYDAQIJ

获取 parentReference 属性

"parentReference": {
       "driveId": "b!w8qjV86a-EibM8Lpka5JcNG6SOd1yy9Di7Gt_zue9dq9z2zXDxX4RYKTxY09UkQ-",
       "id": "01U7PKJ3N6Y2GOVW7725BZO354PWSELRRZ"
    }

使用PATCH操作

PATCH https://graph.microsoft.com/v1.0/sites/contoso.sharepoint.com,bc0a0284-87ff-4fcc-b039-0b7e02823759,e748bad1-cb75-432f-8bb1-adff3b9ef5da/drive/items/
01HD766IY4YTCVBFQNOBEZUBDSXXYDAQIJ

Headers:
Prefer:respond-async
Request body:
{
    "parentReference": {
        "driveId": "b!w8qjV86a-EibM8Lpka5JcNG6SOd1yy9Di7Gt_zue9dq9z2zXDxX4RYKTxY09UkQ-",
        "id": "01U7PKJ3N6Y2GOVW7725BZO354PWSELRRZ"
    },
    "name": "ProjectYRequirements.docx"
}
Response:
{
    "cache-control": "no-cache",
    "client-request-id": "8248a200-00cc-51cc-576c-b48d16109cf4",
    "location": "https://contoso.sharepoint.com/sites/Web03/_api/v2.1/drive/operations/7e75fb87-07ea-4b85-8b40-369d1343ba38?c=T3QzNlIzOG1xdW1VOGR3OGlMZjFQYm5uR21...",
    "request-id": "9e419a03-4421-413a-9753-8d6dec74515d"
}

关于上述操作的提示：

  • 如果目标名称不匹配，我们将得到 HTTP 400 - Bad Request 错误，错误信息为"invalid request"，这与文件大小无关
  • 如果匹配文件名，我们也会遇到 HTTP 400 - Bad Request，但错误代码为"Requested move requires an async response, add ‘Prefer: respond-async’ to allow"，确保请求中确实添加了
  • 要成功移动，源库和目标库必须具有相同的结构，这是因为Move操作也会将文件的元数据一起带着

使用 Microsoft Graph SDK 复制文件

//Create the destination parentReference
var parentReference = new ItemReference
{
    DriveId= "b!w8qjV86a……z2zXDxX4RYKTxY09UkQ-",
    Id= "01U7PKJ3N6Y2GOV……5BZO354PWSELRRZ"
};

//File name to save as
var fileName = "AuthCodePPEGuide.pdf";

//Copy the file over to the destination library
var result = await graphClient.Sites["contoso.sharepoint.com,1af9d2c5-2b3b-47d2-a167-ffd5d0c45205,e748bad1-cb75-432f-8bb1-adff3b9ef5da"]
    .Drives["b!xdL5Gjsr0kehZ__V0MRSBd……dq9z2zXDxX4RYKTxY09UkQ-"]
    .Items["017LC4LMFANIR……CYGZE6AOXQLAA3"].Copy(fileName, parentReference)
    .Request().PostAsync();

本篇实际上介绍了不少 Microsoft Graph 相关的请求，多看多练，熟能生巧。

Justin-Liu
关注
专栏目录
使用SharePoint中的Move To功能将一个文档转移到其他位置
SharePoint, Office 365, Cloud杂谈
10-27 2473
Office 365 SharePoint 中现在可以通过Move To功能将文档移动到本站点的其他位置或者其他站点。 1 - 首先，选中要移动的文档。可以多选。 2 - 之后就可以在右侧的Panel里选择文档即将被移动到的目的端，此处选择了另外一个站点中的一个library. 3 - 由于源端的文件上有目的端不存在的Column，所以第一次Move没有成功。会收到SharePoin...
SharePointPnP.PowerShell.Commands.Files.Recurse:附加SharePoint PowerShell模块，利用SharePoint PnP PowerShell模块以递归方式将文件和文件夹下载到SharePoint Online或从SharePoint Online上载。
05-01
附加SharePoint PowerShell模块，利用SharePoint PnP PowerShell模块以递归方式将文件和文件夹下载到SharePoint或从SharePoint上载。 如何安装模块 发布在，可以使用PowerShell 5.x或更高版本通过Install-Module ...
SHAREPOINT 2013 - 批量上传文件
MICRO BI
11-21 3042
SHAREPOINT 2013 - 批量上传文件，支持拖放功能，非常方便。   但是， 条件如下： 1，FIREFOX 最新； 2，CHROME 最新； 3，IE10; 4，IE8， IE9，需要 OFFICE 2013
SharePoint 2010文档库批量下载文档的实现
sinolover的专栏
11-21 1639
在SharePoint 2010文档库中，结合单选框，在Ribbon中提供了批量处理文档的功能，比如，批量删除、批量签出、批量签入等，但是，很遗憾，没有提供批量下载，如图: 若选中多个文档后，会发现Download a Copy这个Ribbon按钮变灰了，这几天，我自己做了一个Ribbon，实现了批量下载的功能，向大家介绍一下。 先来说一下我这个批量下载的原理： 1.Rib...
关于 SharePoint 不同文档库之间的文档迁移
weixin_30287169的博客
01-27 220
Dudu在SharePoint团队中Post了一篇文章描述了文档库的两个不方便的地方 1、无法控制文档与文件夹的权限 2、无法移动文档与文件夹 其中第一个问题是确实存在的，不过SharePoint2001是有此功能的，2003取消了，这个方面MS应该有他的考虑。第二个问题其实是可以移动的，下面的说明主要针对这个问题。 在浏览器的文件菜单下使用打开命令，在弹开的对话框中选中...
视频教程-文件共享迁移/SharePoint Online迁移-Windows
weixin_32865427的博客
05-28 238
文件共享迁移/SharePoint Online迁移 微软认证讲师，普渡大学...
SPO-Import-List-CSV:控制台应用程序，用于将记录从CSV文件导入到SharePoint Online中的列表中
05-11
控制台应用程序，用于将记录从CSV文件导入到SharePoint Online中的列表中 要求： 以下内容必须完全匹配： CSV文件的列标题 表示电子表格记录的自定义类的属性名称 相应的SharePoint网站列的内部名称 不支持实现...
SharePoint Online 建站实战教程（上）
06-09
本次课程以Office 365 企业版 E3为环境，介绍如何使用其中SharePoint Online产品相关技术，如何通过站点配置和Designer设计，通过和工作流相结合，完成企业内部需求，实现企业信息化建设。
Chrome-SP-Editor:用于从开发人员工具在SharePoint Online中创建和更新文件（js，css）的扩展
03-18
Google Chrome扩展程序，用于通过Chrome开发者工具在SharePoint Online中创建和更新文件（js，css） 这是（ 的精彩介绍视频 版本历史 5.6.9更新 将PnPjs更新到2.3.0 摩纳哥编辑器更新至0.23.0 5.6.8错误修复使用...
Create-Master-Page-from-HTML-in-SharePoint:可用于在SharePoint 2013，SharePoint 2016和SharePoiint Online中创建新母版页HTML和CSS文件
05-09
本教程将详细解释如何从HTML和CSS文件创建自定义母版页，并将其应用于SharePoint 2013、SharePoint 2016以及SharePoint Online中。 首先，理解母版页的概念至关重要。母版页是 SharePoint 网站的基础模板，它定义了...
sharepoint 迁移_如何将SharePoint迁移到SharePoint Online 2013、2010、2007
cunchi8090的博客
07-21 728
sharepoint 迁移Apart from this, an automated solution for the 除此之外，针对 还讨论了migration of SharePoint to Office 365 has also been discussed. Now, let us explore some prerequisites of the migration process...
sharepoint服务器文件迁移,SharePoint 服务器端对象迁移文件夹
weixin_32503491的博客
08-04 376
最近有个需求，写个定时迁移文件夹的小程序，因为计时器任务比较繁琐，所以选择了控制台程序。然后，用windows的计划任务执行，也许，会有广大朋友需要类似的功能，简单的分享一下代码逻辑，功能非常简单，希望大家不要见笑。//提升权限代码SPSecurity.RunWithElevatedPrivileges(delegate(){//提升权限的核心代码});//创建网站集和网站对象using (SPS...
SharePoint365 接入简要笔记
CoffeeAndIce的博客
07-14 4056
针对sharepoint接入迁移问题的简要笔记记录，主要针对文件处理
发布一个SharePoint 2010 工具(复制,移动文件和文件夹)
weixin_34362790的博客
05-24 153
工具介绍: SharePoint 2010 文档库自带了”Send To” 功能, 但是这个功能只能移动文件, 但是这个功能的限制很多, 比如只能复制文件, 只能在本站点内被复制, 而且只能复制Major 版本, 如果你要移动文件, 或者文件夹而且包含所有的版本（主要版本和次要版本）, 这个功能都满足不了. 而本工具功能如下: 　　　　1. 权限控制 　　　　2. 如果对源文档库没...
【Power Automate】复制SharePoint文档库中的文件到另一个文档库（本站点或其他站点）
liuzhenhe1988的专栏
08-19 3927
前言 在SharePoint online项目中经常会遇到站点迁移，其中可能会包含大量文件的迁移（从A站点迁移到B站点），接下来咱们通过O365中的Power Automate来实现吧，很简单哦 准备工作 准备一个o365账号（给该账号授权Power Automate license） 打点https://flow.microsoft.com/，用o365账号登录 创建工作流 1、在左侧导航点击【+创建】，选择第一个类型【自动化云端流】（其他类型会在后续更新） 2、在..
一步一步教你从SharePoint2007迁移到SharePoint2010
weixin_30660027的博客
09-02 145
　　最近在作MOSS2010的开发部署，想migrate之前MOSS2007的site到MOSS2010上，下面介绍一下笔者实践的迁移过程。首先说一下，当我们在MOSS2007上将一个site或者list保存成template文件(.stp文件)，然后将它upload到MOSS2010的template library.由此来在MOSS2010上生成site或者list是行不通的，MOSS201...
Office365与SharePoint Online开发指南
"SharePoint Online是微软提供的一款基于云端的企业协作平台，主要面向希望在云环境中构建、管理和协作的组织。本书详细介绍了如何使用SharePoint Online进行各种级别的定制和开发，涵盖了从基本的浏览器定制到高级...
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值