Microsoft SharePoint Online 模块
在Adobe Workfront Fusion场景中,您可以自动使用Microsoft SharePoint Online的工作流,并将其连接到多个第三方应用程序和服务。
有关创建场景的说明,请参阅创建场景:文章索引中的相关文章。
有关模块的详细信息,请参阅模块:文章索引下的相关文章。
访问权限要求
| table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header | |
|---|---|
| Adobe Workfront 包 |
任意 Adobe Workfront Workflow 包以及任意 Adobe Workfront 自动化和集成包 Workfront Ultimate Workfront Prime 和 Select 包,且需额外购买 Workfront Fusion。 |
| Adobe Workfront 许可证 |
标准 工作版或更高版本 |
| Adobe Workfront Fusion 许可证 |
基于操作:适用于拥有基于操作的许可证的组织 基于连接器(旧版):Workfront Fusion for Work Automation and Integration |
| 产品 | 如果您的组织使用的 Workfront Select 或 Prime 包不包含 Workfront 自动化和集成,则必须单独购买 Adobe Workfront Fusion。 |
有关此表中信息的更多详细说明,请参阅文档中的访问权限要求。
有关 Adobe Workfront Fusion 许可证的详细信息,请参阅 Adobe Workfront Fusion 许可证。
先决条件
要使用Microsoft SharePoint Online模块,您必须拥有Microsoft SharePoint Online帐户。
SharePoint API信息
SharePoint连接器使用以下对象:
将Microsoft SharePoint Online连接到Workfront Fusion connect-microsoft-sharepoint-online-to-workfront-fusion
使用Microsoft帐户将Microsoft SharePoint Online连接到Workfront Fusion
使用高级设置将Microsoft SharePoint Online连接到Workfront Fusion
要在连接中包含凭据,请启用显示高级设置选项。 对于此类连接,您需要客户端ID、客户端密钥和租户ID。
-
在任意SharePoint模块中,单击“连接”字段附近的 添加 以打开 创建连接 框。
-
单击显示高级设置。
-
填写以下字段:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header 连接类型 若要使用客户端凭据,请选择Microsoft 365电子邮件。 连接名称 输入连接名称。 客户端 ID 输入您正在连接的SharePoint应用程序的客户端ID。 客户端密码 输入您连接到的某个SharePoint应用程序的客户端密码。 租户ID 输入您正在连接的SharePoint应用程序的租户ID。 -
点击 继续 保存连接并返回模块。
使用证书授权将Microsoft SharePoint Online连接到Workfront Fusion
您可以使用证书授权连接到SharePoint。
| note important |
|---|
| IMPORTANT |
| 要使用证书授权,您必须首先在Microsoft Entra中创建应用程序并将证书上传到该处。 |
| 有关说明,请参阅Microsoft文档中的如何为Microsoft Entra基于证书的身份验证配置证书颁发机构。 |
-
在任意SharePoint模块中,单击“连接”字段附近的 添加 以打开 创建连接 框。
-
单击显示高级设置。
-
填写以下字段:
table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto html-authored no-header 连接类型 要使用证书授权,请选择Microsoft SharePoint Online (证书身份验证)。 连接名称 输入连接名称。 客户端 ID 输入您正在连接的SharePoint应用程序的客户端ID。 指纹 输入您要连接的SharePoint应用程序的指纹。 私钥 输入在Microsoft中创建凭据时生成的证书或私钥。
要提取您的私钥或证书:
-
点击提取。
-
选择是提取证书还是私钥。
-
选择您要提取的文件类型。
-
选择包含私钥或证书的文件。
-
输入该文件的密码。
-
点击 保存 以提取文件,并返回连接设置界面。
-
-
点击 继续 保存连接并返回模块。
使用服务主体将Microsoft SharePoint Online连接到Workfront Fusion
您可以创建使用服务主体(应用程序API连接)而不是个人帐户的连接。 如果您希望连接作为应用程序或服务身份而不是特定人员运行(例如,这样当该人员离开公司或更改其密码时,集成不会中断),则此功能非常有用。
| note important |
|---|
| IMPORTANT |
| 此连接类型仅适用于进行API调用模块。 其他SharePoint模块需要本文中介绍的其他连接类型之一。 |
- 使用服务主体将Microsoft SharePoint Online连接到Workfront Fusion的先决条件
- 在Microsoft Entra ID中创建应用程序注册
- 创建客户端密码
- 授予API权限
- 收集您的连接详细信息
- 创建连接
使用服务主体将Microsoft SharePoint Online连接到Workfront Fusion的先决条件
您需要在Microsoft Entra ID中拥有全局管理员、应用程序管理员或 特权角色管理员 访问权限才能注册应用程序并授予其权限。 如果您没有此访问权限,请让您的IT或身份团队中的某人为您完成这些步骤。
继续在Microsoft Entra ID中创建应用程序注册。
在Microsoft Entra ID(服务主体)中创建应用程序注册
- 登录到Microsoft Entra管理中心。
- 转到应用注册 > 新注册。
- 为应用程序提供一个清晰且可识别的名称。 例如:
Make - SharePoint Integration。 - 将 重定向URI 保留为空。 此连接不涉及通过浏览器登录的任何人。
- 选择注册。
- 继续创建客户端密钥。
创建客户端密钥(服务主体)
- 在新应用注册中,转到证书和密钥。
- 选择新客户端密钥,添加说明,并选择有效期。
- 选择添加。
- 立即复制密码的值。 它只显示一次。 如果您在复制它之前导航离开,则必须创建一个新路径。
- 继续授予API权限。
授予API权限(服务主体)
- 在应用程序注册中,转到API权限。
- 选择添加权限,然后选择Microsoft图形。
- 选择应用程序权限。
- 选择API调用所需的权限,然后选择添加权限。
- 选择 为您的组织 授予管理员同意,然后确认。
- 继续收集您的连接详细信息。
收集您的连接详细信息(服务主体)
在应用程序注册的 概述 页面中,注意以下值。 在模块中创建连接时输入这些参数。
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| 租户ID | 在概述页面上,标记为目录(租户) ID。 |
| 客户端 ID | 在概述页面上,标记为应用程序(客户端) ID。 |
| 客户端密钥 | 您在中创建客户端密钥中复制的值。 |
继续创建连接。
创建连接(服务主体)
-
在进行API调用模块中,单击“连接”字段附近的 添加 以打开 创建连接 框。
-
单击显示高级设置。
-
在连接类型字段中,选择服务主体。
-
输入以下内容:
- 租户ID
- 客户端ID
- 客户端密码
-
点击 继续 保存连接并返回模块。
如果一切设置正确,连接验证成功。
使用联合连接将Microsoft SharePoint Online连接到Adobe Workfront Fusion
联合连接的工作方式与服务主体连接类似,只不过它不使用客户端密钥。
告诉Microsoft Entra ID信任Workfront Fusion为某个特定连接颁发的令牌,而不是存储密钥。 当连接运行时,Fusion提供短暂的标识验证,Microsoft Entra ID返回访问令牌。 由于没有客户端密钥,因此没有过期的任何内容,也没有要轮换或存储的密钥。
| note |
|---|
| NOTE |
| 设置此连接需要访问Microsoft Entra管理中心两次。 首先注册应用程序,然后在Workfront Fusion中创建连接,然后返回Microsoft Entra ID以添加联合凭据。 这是因为联合凭据标识一个特定连接,并且该标识符在创建连接之前不存在。 |
- 使用联合连接将Microsoft SharePoint Online连接到Workfront Fusion的先决条件
- 在Microsoft Entra ID(Federated连接)中创建应用程序注册
- 授予API权限(联合连接)
- 收集您的连接详细信息(联合连接)
- 在Workfront Fusion中创建连接(联合连接)
- 在Microsoft Entra ID(Federated连接)中添加联合凭据
- 验证连接(联合连接)
- 故障排除
使用联合连接将Microsoft SharePoint Online连接到Workfront Fusion的先决条件
您需要在Microsoft Entra ID中拥有“全局管理员”、“应用程序管理员”或“特权角色管理员”访问权限,才能注册应用程序、授予其权限并添加联合凭据。 如果您没有此访问权限,请让您的IT或身份团队中的某人为您完成这些步骤。
在Microsoft Entra ID(Federated连接)中创建应用程序注册
- 登录到Microsoft Entra管理中心。
- 转到“应用程序注册”>“新注册”。
- 为应用程序提供一个清晰且可识别的名称。 例如:
Workfront Fusion SharePoint Integration。 - 将重定向URI保留为空。 此连接不涉及通过浏览器登录的任何人。
- 选择注册。
请勿创建客户端密码。 联合连接不使用联合连接。 - 继续授予API权限。
授予API权限(联合连接)
- 在应用程序注册中,转到API权限。
- 选择添加权限,然后选择Microsoft图形。
- 选择应用程序权限。
- 选择API调用所需的权限,然后选择添加权限。
- 选择为您的组织授予管理员同意,然后确认。
- 继续收集您的连接详细信息。
收集您的连接详细信息(联合连接)
-
在应用程序注册的“概述”页面中,注意以下值。 在模块中创建连接时输入这些参数。
table 0-row-2 1-row-2 layout-auto html-authored no-header 租户ID 在概述页面上,标记为目录(租户) ID。 客户端 ID 在概述页面上,标记为应用程序(客户端) ID。
在Workfront Fusion中创建连接(联合连接)
-
在进行API调用模块中,单击连接字段附近的b ,打开创建连接框。
-
单击(联合连接)。
-
在连接类型字段中,选择联合连接类型。
-
输入以下内容:
- 租户ID
- 客户端 ID
-
选择创建。
Workfront Fusion显示三个值。 您可以在下一个过程中使用它们。table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header Issuer 始终 https://oidc.automations.adobe.com。主题 标识此连接。 它看起来像 fusion:6e5b1c2a345bd8d1ed98b6b4f1459818:28964。 您创建的每个连接都各不相同。受众 始终 api://AzureADTokenExchange。 -
保持此面板处于打开状态并复制 主题 值。
note NOTE 不要关闭面板或选择“取消”。 在完成其余步骤之前,连接不会完成。 如果关闭面板,则必须删除连接并重新启动,因为新连接会收到新主题。 -
继续在Microsoft Entra ID中添加联合凭据。
在Microsoft Entra ID(Federated连接)中添加联合凭据
此过程将替换客户端密码。 它会告知Microsoft Entra ID接受Workfront Fusion为此连接颁发的令牌。
-
在新的浏览器选项卡中,返回Microsoft Entra管理中心并打开您的应用程序注册。
-
转到证书和密钥 > 联合凭据。
-
选择添加凭据。
-
在联合凭据方案中,选择其他颁发者。
-
输入以下内容:
table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header Issuer https://oidc.automations.adobe.com.主题标识符 您从Workfront Fusion复制的主题。 完全粘贴,不添加空格。 名称 用于标识此连接的名称,以便您以后查找。 例如: workfront-fusion-connection-28964。受众 api://AzureADTokenExchange. 这通常是替您填充的。 保留默认值。 -
选择添加。
-
继续验证连接。
验证连接(联合连接)
-
返回到Workfront Fusion浏览器选项卡,其中连接面板仍处于打开状态。
-
选择保存。
- 如果一切设置正确,连接验证成功,您可以继续设置模块。
- 如果验证失败,面板将保持打开状态并显示错误。 请更正Microsoft Entra ID中的问题,然后再次选择“保存”。 您不需要重新创建连接,并且主题不会更改。
故障排除
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| 连接验证失败,客户端无效或请求错误 | Microsoft Entra ID无法将令牌与联合凭据进行匹配。 检查颁发者是否刚好为https://oidc.automations.adobe.com,没有尾随斜杠,并且主题标识符的字符对字符与Workfront Fusion中显示的主题相同。 从其他连接复制的主题是最常见的原因。 |
| 连接验证,但API调用返回403 | 该身份值得信任,但应用程序没有您调用所需的Microsoft Graph权限。 返回到授予API权限,添加所需的应用程序权限,并授予管理员同意。 |
| 您无法添加其他联合凭据 | 您已达到该应用程序注册的20个联合凭据的限制。 注册其他应用程序并创建针对该应用程序的更多连接。 |
Microsoft SharePoint模块及其字段
配置Microsoft SharePoint Online模块时,Workfront Fusion会显示以下列出的字段。 除了这些以外,还可能会显示其他Microsoft SharePoint Online字段,具体取决于应用程序或服务中的访问级别等因素。 模块中的加粗标题表示必填字段。
如果您看到字段或功能上方的映射按钮,可使用它为该字段设置变量和函数。 有关详细信息,请参阅将信息从一个模块映射到另一个模块。
驱动器项目
创建文件
此模块会返回并在SharePoint中创建文件。 此模块的性能优于创建文件(旧版)模块。
创建文件(旧版)
此模块在SharePoint中创建文件。
为了提高性能,我们建议使用创建文件模块。
创建文件夹
此操作模块在SharePoint中创建新文件夹。
获取文件
此操作模块可检索指定的SharePoint文件。
获取文件夹
此模块已检索有关指定文件夹的详细信息
更新文件夹或文件
此操作模块更新文件夹或文件的元数据
监视文件夹项目
当您选择的文件夹中更新了某个项目时,此触发器模块会启动一个方案。
项目
复制项目
此操作模块复制SharePoint列表中的现有项目。
创建项
此操作模块在SharePoint列表中创建新项目。
删除项
此操作模块删除SharePoint列表中的现有项目。
获取项目
此操作模块返回指定项的数据。
获取详细信息
此模块从指定的URL获取项目详细信息。
列表项
此操作模块检索指定列表中所有项目的列表。
移动项
此操作模块复制SharePoint列表中的现有项目。
更新项
此操作模块更新SharePoint列表中的现有项目。
关注项目(已计划)
此触发器模块会在创建或修改项目时启动方案。
列表
创建列表
此操作模块可在SharePoint中创建新列表。
获取列表
此操作模块返回指定列表的数据。
列表列表
此操作模块检索指定站点中所有项目的列表。
观看列表
此触发器模块会在创建或修改列表时启动方案。
页面(Beta)
beta版本的API可能会发生更改。 不支持在生产应用程序中使用这些API。获取页面
此操作模块返回指定页面的数据。
列表页面
此模块可检索所有页面的列表。
发布页面
此操作模块发布所选页面的最新版本。
关注页面
此触发器模块会在指定网站上修改页面时启动方案。
网站
获取站点
此操作模块返回指定站点的数据。
搜索站点
此操作模块按您指定的参数搜索站点。
其他
获取更改
此模块可检索在SharePoint文件夹中所做的添加、更新和删除。
进行API调用
此模块允许您执行自定义 API 调用。
监控事件
在SharePoint中添加、更新或删除项目时,此即时触发模块会启动一个场景。