Project Online
Project Online 是一种灵活的在线解决方案，适用于项目组合管理（PPM）和Microsoft的日常工作。 Project Online 通过 Office 365 交付，使组织能够快速开始使用强大的项目管理功能，从几乎任何设备上任意位置规划、确定项目和项目组合投资的优先级和管理项目和项目组合投资。
此连接器在以下产品和区域中可用：
| 服务 | Class | 区域 |
|---|---|---|
| Copilot Studio | 标准 | 所有 Power Automate 区域 |
| 逻辑应用程序 | 标准 | 所有 逻辑应用区域 |
| Power Apps | 标准 | 所有 Power Apps 区域 |
| Power Automate | 标准 | 所有 Power Automate 区域 |
| 联系人 | |
|---|---|
| Name | Microsoft |
| URL |
Microsoft LogicApps 支持 Microsoft Power Automate 支持 Microsoft Power Apps 支持 |
| 连接器元数据 | |
|---|---|
| 发布者 | Microsoft |
| 网站 | https://products.office.com/project/project-management-software |
若要使用此集成，需要访问有权访问 Project Online 网站的帐户。 若要建立连接，请选择“ 登录”。 系统将提示你提供Microsoft登录名，按照屏幕的其余部分创建连接。
每个作都需要 Project Online 站点的根网站 URL。 在大多数情况下，导航到 Project Online 网站时，可以在浏览器地址栏中找到此 URL。 URL 应属于 sharepoint.com 域，应为 PWA （Project Web App） 类型。 如果通过https://project.microsoft.com/网站使用 Project Online，请访问 Settings-My>PWA 网站以获取有效的 PWA URL。 例如 https://sampletenant.sharepoint.com/teams/sampleteam
现在，你已准备好开始使用此集成。
已知问题和限制
- Project Online 任务不会返回“资源名称”属性，因为它不是由后端服务的 REST API 本身返回的。
- 每个运行最多可以返回 10 个项的所有触发器。 如果更多数据可用，这是 V2 触发器，则触发器将再次运行，且不会延迟。
限制
| 名称 | 调用 | 续订期 |
|---|---|---|
| 每个连接的 API 调用数 | 100 | 60 秒 |
操作
| 列出任务 |
列出项目中的已发布任务。 |
| 列出项目 |
按 ID 列出项目在线网站中的项目。 |
| 列出项目 |
列出项目联机网站中的项目。 |
| 创建新任务 |
在项目中创建新任务。 |
| 创建新资源 |
在 Project Online 站点中创建企业资源。 |
| 创建新项目 |
在项目联机网站中创建新项目。 |
| 签入和发布项目 |
签入并发布网站中的现有项目。 |
| 签出项目 |
签出网站中的现有项目。 |
| 获取项目摘要任务 |
获取给定项目的项目摘要任务。 |
列出任务
列出项目中的已发布任务。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
根网站 URL
|
siteUrl | True | uri |
项目网站的根网站 URL （示例： https://sampletenant.sharepoint.com/teams/sampleteam ） 。 |
|
项目 ID
|
project_id | True | string |
要提取任务的项目的唯一 ID。 |
|
筛选查询
|
$filter | string |
ODATA 筛选器查询，用于限制返回的条目（例如 Id eq 'task-guid'）。 |
|
|
选择“查询”
|
$select | string |
OData 选择要返回的列的查询。 示例：ID、名称 |
返回
项目联机列表任务响应模型
- Body
- TasksWrapper
列出项目
按 ID 列出项目在线网站中的项目。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
根网站 URL
|
siteUrl | True | uri |
项目网站的根网站 URL （示例： https://sampletenant.sharepoint.com/teams/sampleteam ） 。 |
|
项目 ID
|
project_id | True | string |
要提取的项目的唯一 ID |
|
选择“查询”
|
$select | string |
OData 选择要返回的列的查询。 示例：ID、名称 |
返回
Project Online 项目模型
- Body
- Project
列出项目
列出项目联机网站中的项目。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
根网站 URL
|
siteUrl | True | uri |
项目网站的根网站 URL （示例： https://sampletenant.sharepoint.com/teams/sampleteam ） 。 |
返回
项目联机列表项目响应模型
- Body
- ProjectsWrapper
创建新任务
在项目中创建新任务。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
根网站 URL
|
siteUrl | True | uri |
项目网站的根网站 URL （示例： https://sampletenant.sharepoint.com/teams/sampleteam ） 。 |
|
项目 ID
|
project_id | True | string |
要向其添加任务的项目的唯一 ID。 |
|
任务名称
|
Name | True | string |
要创建的新任务的名称 |
|
任务说明
|
Notes | string |
用于新任务的备注 |
|
|
任务开始日期
|
Start | date-time |
任务的开始日期 |
|
|
任务持续时间
|
Duration | string |
任务的持续时间。 例如（1h、2d 或 3w） |
返回
Project Online Server 任务
- Body
- Task
创建新资源
在 Project Online 站点中创建企业资源。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
根网站 URL
|
siteUrl | True | uri |
项目网站的根网站 URL （示例： https://sampletenant.sharepoint.com/teams/sampleteam ） 。 |
|
资源名称
|
Name | True | string |
要创建的新资源的名称 |
|
预算中的资源
|
IsBudget | boolean |
是否在预算中考虑资源 |
|
|
资源泛型
|
IsGeneric | boolean |
资源泛型 |
|
|
资源处于非活动状态
|
IsInactive | boolean |
资源处于非活动状态 |
返回
Project Online Enterprise 资源模型
- Body
- EnterpriseResource
创建新项目
在项目联机网站中创建新项目。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
根网站 URL
|
siteUrl | True | uri |
项目网站的根网站 URL （示例： https://sampletenant.sharepoint.com/teams/sampleteam ） 。 |
|
项目名称
|
Name | True | string |
要创建的新项目的名称 |
|
项目说明
|
Description | string |
要创建的新项目的说明 |
|
|
项目开始日期
|
Start | date-time |
新项目的开始日期 |
返回
Project Online 项目模型
- Body
- Project
签入和发布项目
签入并发布网站中的现有项目。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
根网站 URL
|
siteUrl | True | uri |
项目网站的根网站 URL （示例： https://sampletenant.sharepoint.com/teams/sampleteam ） 。 |
|
项目 ID
|
project_id | True | string |
要签入的项目的唯一 ID。 |
返回
- response
- object
签出项目
签出网站中的现有项目。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
根网站 URL
|
siteUrl | True | uri |
项目网站的根网站 URL （示例： https://sampletenant.sharepoint.com/teams/sampleteam ） 。 |
|
项目 ID
|
project_id | True | string |
要签出的项目的唯一 ID。 |
返回
- response
- object
获取项目摘要任务
获取给定项目的项目摘要任务。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
根网站 URL
|
siteUrl | True | uri |
项目网站的根网站 URL （示例： https://sampletenant.sharepoint.com/teams/sampleteam ） 。 |
|
项目 ID
|
project_id | True | string |
要提取的项目的唯一 ID |
返回
Project Online Server 任务
- Body
- Task
触发器
| 创建新任务时 |
创建新任务时触发流。 |
| 创建新任务时 （V2） （预览版） |
创建新任务时触发流。 |
| 创建新资源时 |
创建新资源时触发新流。 |
| 创建新资源时 （V2） （预览版） |
创建新资源时触发新流。 |
| 创建新项目时 |
每当创建新项目时，就会触发流。 |
| 创建新项目时 （V2） （预览版） |
每当创建新项目时，就会触发流。 |
| 发布项目时 |
每当发布项目时，就会触发流。 |
| 发布项目时 （V2） （预览版） |
每当发布项目时，就会触发流。 |
创建新任务时
创建新任务时触发流。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
根网站 URL
|
siteUrl | True | uri |
项目网站的根网站 URL （示例： https://sampletenant.sharepoint.com/teams/sampleteam ） 。 |
返回
在新任务响应模型中联机进行项目
- Body
- TriggerTasksWrapper
创建新任务时 （V2） （预览版）
创建新任务时触发流。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
根网站 URL
|
siteUrl | True | uri |
项目网站的根网站 URL （示例： https://sampletenant.sharepoint.com/teams/sampleteam ） 。 |
|
选择“查询”
|
$select | True | string |
OData 选择要返回的列的查询。 |
返回
在新任务响应模型中联机进行项目
- Body
- TriggerTasksWrapper
创建新资源时
创建新资源时触发新流。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
根网站 URL
|
siteUrl | True | uri |
项目网站的根网站 URL （示例： https://sampletenant.sharepoint.com/teams/sampleteam ） 。 |
返回
新资源响应模型上的 Project Online。
创建新资源时 （V2） （预览版）
创建新资源时触发新流。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
根网站 URL
|
siteUrl | True | uri |
项目网站的根网站 URL （示例： https://sampletenant.sharepoint.com/teams/sampleteam ） 。 |
|
选择“查询”
|
$select | True | string |
OData 选择要返回的列的查询。 |
返回
新资源响应模型上的 Project Online。
创建新项目时
每当创建新项目时，就会触发流。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
根网站 URL
|
siteUrl | True | uri |
项目网站的根网站 URL （示例： https://sampletenant.sharepoint.com/teams/sampleteam ） 。 |
返回
新项目响应模型上的 Project Online。
创建新项目时 （V2） （预览版）
每当创建新项目时，就会触发流。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
根网站 URL
|
siteUrl | True | uri |
项目网站的根网站 URL （示例： https://sampletenant.sharepoint.com/teams/sampleteam ） 。 |
|
选择“查询”
|
$select | True | string |
OData 选择要返回的列的查询。 |
返回
新项目响应模型上的 Project Online。
发布项目时
每当发布项目时，就会触发流。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
根网站 URL
|
siteUrl | True | uri |
项目网站的根网站 URL （示例： https://sampletenant.sharepoint.com/teams/sampleteam ） 。 |
返回
新项目响应模型上的 Project Online。
发布项目时 （V2） （预览版）
每当发布项目时，就会触发流。
参数
| 名称 | 密钥 | 必需 | 类型 | 说明 |
|---|---|---|---|---|
|
根网站 URL
|
siteUrl | True | uri |
项目网站的根网站 URL （示例： https://sampletenant.sharepoint.com/teams/sampleteam ） 。 |
|
选择“查询”
|
$select | True | string |
OData 选择要返回的列的查询。 |
返回
新项目响应模型上的 Project Online。
定义
TriggerProjectsWrapper
新项目响应模型上的 Project Online。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
返回的项目
|
value | array of TriggerProject |
返回的触发器项目列表。 |
TriggerProject
Project Online 项目模型
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
项目开始日期
|
ProjectStartDate | date-time |
已批准项目的开始日期。 |
|
项目结束日期
|
ProjectFinishDate | date-time |
已批准项目的完成日期时间。 |
|
创建日期
|
ProjectCreatedDate | date-time |
项目的创建日期时间。 |
|
项目 ID
|
ProjectId | string |
项目的唯一 ID。 |
|
上次修改日期
|
ProjectModifiedDate | date-time |
上次保存项目的日期/时间。 |
|
项目类型
|
ProjectType | integer |
项目的类型。 |
|
项目名称
|
ProjectName | string |
项目的名称。 |
|
上次发布日期
|
ProjectLastPublishedDate | date-time |
上次发布的项目的日期时间。 |
|
项目负责人
|
ProjectOwnerName | string |
项目的所有者。 |
|
项目完成百分比
|
ProjectPercentCompleted | integer |
项目的完成百分比。 |
|
已完成项目工时百分比
|
ProjectPercentWorkCompleted | integer |
项目完成工时百分比。 |
|
项目加班成本
|
ProjectOvertimeCost | string |
项目的加班成本。 |
|
项目加班工时
|
ProjectOvertimeWork | string |
项目的加班工时。 |
TriggerResourcesWrapper
新资源响应模型上的 Project Online。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
返回的资源
|
value | array of TriggerResource |
返回的触发器资源列表。 |
TriggerResource
资源联机资源模型。
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
资源 ID
|
ResourceId | string |
资源的唯一 ID。 |
|
基准日历
|
ResourceBaseCalendar | string |
资源的基日历类型。 |
|
资源预订类型
|
ResourceBookingType | integer |
资源的预订类型 |
|
资源级别
|
ResourceCanLevel | boolean |
资源级别 |
|
每次使用的资源成本
|
ResourceCostPerUse | string |
资源的每次使用成本 |
|
资源创建日期
|
ResourceCreatedDate | date-time |
创建资源的日期 |
|
最早可用的资源
|
ResourceEarliestAvailableFrom | date-time |
资源的最早可用性日期 |
|
资源电子邮件
|
ResourceEmailAddress | string |
资源的电子邮件地址 |
|
资源缩写
|
ResourceInitials | string |
资源的 Initals |
|
资源是否处于活动状态
|
ResourceIsActive | boolean |
新资源是否处于活动状态 |
|
资源泛型
|
ResourceIsGeneric | boolean |
新资源泛型 |
|
资源最新可用
|
ResourceLatestAvailableTo | date-time |
资源可用的最后日期 |
|
上次修改的资源日期
|
ResourceModifiedDate | date-time |
资源的上次修改日期 |
|
资源名称
|
ResourceName | string |
资源的名称 |
|
资源状态名称
|
ResourceStatsuName | string |
资源的状态名称 |
|
资源类型
|
ResourceType | integer |
资源类型 |
|
资源类型说明
|
TypeDescription | string |
资源类型的说明 |
|
资源类型名称
|
TypeName | string |
资源的类型名称 |
TriggerTasksWrapper
在新任务响应模型中联机进行项目
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
返回的任务
|
value | array of TriggerTask |
返回的触发器任务列表 |
TriggerTask
任务联机任务模型
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
项目 ID
|
ProjectId | string |
在其中创建任务的项目的 ID |
|
任务 ID
|
TaskId | string |
新任务的 ID |
|
项目名称
|
ProjectName | string |
在其中创建任务的项目的名称 |
|
任务名称
|
TaskName | string |
新任务的名称 |
|
任务创建日期
|
TaskCreatedDate | date-time |
新任务的创建日期 |
|
上次修改的任务日期
|
TaskModifieddate | date-time |
新任务的上次修改日期 |
|
任务开始日期
|
TaskStartDate | date-time |
新任务的开始日期 |
|
任务完成日期
|
TaskFinishDate | date-time |
完成新任务的日期 |
|
任务摘要
|
TaskPriority | integer |
新任务的优先级 |
|
任务处于活动状态
|
TaskIsActive | boolean |
任务是否仍处于活动状态 |
项目
Project Online 项目模型
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
已批准的开始日期
|
ApprovedStart | date-time |
已批准的项目开始时间 |
|
已批准的结束日期
|
ApprovedEnd | date-time |
已批准的项目结束时间 |
|
签出日期
|
CheckedOutDate | date-time |
签出项目的时间 |
|
签出说明
|
CheckOutDescription | string |
项目签出的说明 |
|
签出 ID
|
CheckOutId | string |
项目签出的 ID |
|
创建日期
|
CreatedDate | date-time |
项目的创建日期 |
|
项目 ID
|
Id | string |
项目的 ID |
|
已签出
|
IsCheckedOut | boolean |
如此 如果项目当前已签出 |
|
上次发布日期
|
ProjectLastPublishedDate | date-time |
项目上次发布日期 |
|
上次发布日期
|
LastPublishedDate | date-time |
项目上次发布日期 |
|
上次保存的日期
|
LastSavedDate | date-time |
保存项目的上次日期 |
|
优化器决策
|
OptimizerDecision | integer |
项目优化器决策编号 |
|
Planner 决策
|
PlannerDecision | integer |
项目规划器决策编号 |
|
项目类型
|
ProjectType | integer |
项目的类型 |
|
项目名称
|
Name | string |
项目的名称 |
|
项目标识符
|
ProjectIdentifier | string |
项目标识符 |
|
Win proj 版本
|
WinprojVersion | string |
项目版本 |
ProjectsWrapper
项目联机列表项目响应模型
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
返回的项目
|
value | array of Project |
返回的项目列表 |
EnterpriseResource
Project Online Enterprise 资源模型
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
资源级别
|
CanLevel | boolean |
资源级别 |
|
资源代码
|
Code | string |
资源代码 |
|
资源成本累算
|
CostAccrual | integer |
资源成本累算 |
|
资源成本中心
|
CostCenter | string |
资源成本中心 |
|
资源创建时间
|
Created | date-time |
资源创建时间 |
|
默认预订类型
|
DefaultBookingType | integer |
资源默认预订类型 |
|
Email
|
string |
资源电子邮件地址 |
|
|
外部 ID
|
ExternalId | string |
资源外部 ID |
|
资源组
|
Group | string |
属于哪个资源的组 |
|
雇佣日期
|
HireDate | date-time |
资源的雇佣日期 |
|
资源 ID
|
Id | string |
资源 ID |
|
Resouce initials
|
Initials | string |
资源缩写 |
|
资源处于活动状态
|
IsActive | boolean |
资源处于活动状态 |
|
是预算
|
IsBudget | boolean |
是否对资源成本进行预算 |
|
已签出
|
IsCheckedOut | boolean |
是否已签出资源 |
|
是泛型
|
IsGeneric | boolean |
资源泛型 |
|
是团队
|
IsTeam | boolean |
团队的资源部分 |
|
材料标签
|
MaterialLabel | string |
资源材料标签 |
|
上次修改时间
|
Modified | date-time |
上次修改资源的时间 |
|
资源名称
|
Name | string |
资源名称 |
|
资源拼音
|
Phonetics | string |
资源的拼音发音 |
|
资源类型
|
ResourceType | integer |
资源类型 |
|
终止日期
|
TerminationDate | date-time |
资源终止日期 |
TasksWrapper
项目联机列表任务响应模型
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
返回的任务
|
value | array of Task |
返回的任务列表 |
任务
Project Online Server 任务
| 名称 | 路径 | 类型 | 说明 |
|---|---|---|---|
|
任务创建日期
|
Created | date-time |
任务的创建日期 |
|
上次修改的任务日期
|
Modified | date-time |
任务的上次修改日期 |
|
任务开始日期
|
Start | date-time |
任务的开始日期 |
|
任务完成日期
|
Finish | date-time |
任务的完成日期 |
|
任务计划开始日期
|
ScheduledStart | date-time |
任务的计划开始日期 |
|
任务计划完成日期
|
ScheduledFinish | date-time |
任务的计划完成日期 |
|
任务名称
|
Name | string |
任务的名称 |
|
任务 ID
|
Id | string |
任务的 ID |
|
任务优先级
|
Priority | integer |
任务的优先级 |
|
任务完成百分比
|
PercentComplete | integer |
任务完成百分比 |
|
任务说明
|
Notes | string |
有关任务的说明说明 |
|
任务联系人
|
Contact | string |
任务的联系人地址 |
|
是里程碑任务
|
IsMilestone | boolean |
指示任务是否为里程碑 |
对象
这是类型“object”。