共用方式為

Project Online

Project Online 是 Microsoft 的專案組合管理 （PPM） 和日常工作的彈性線上解決方案。 Project Online 透過 Office 365 提供，可讓組織快速開始使用強大的專案管理功能，以規劃、排定優先順序和管理專案和專案組合投資 - 幾乎可以從任何裝置上。

此連接器適用於以下產品和區域：

服務 Class Regions
副駕駛工作室 標準 所有 Power Automate 區域
邏輯應用程式 標準 所有 Logic Apps 區域
Power Apps 標準 所有 Power Apps 區域
Power Automate（自動化服務） 標準 所有 Power Automate 區域
連絡人​​
名稱 Microsoft
URL Microsoft LogicApps 支援
Microsoft Power Automate 支援
Microsoft Power Apps 支援
連接器中繼資料
Publisher 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，請流覽 [設定->我的 PWA] 網站 ，以取得有效的 PWA URL。 例如：https://sampletenant.sharepoint.com/teams/sampleteam

您現在已準備好開始使用此整合。

已知問題與限制

  1. Project Online 工作不會傳回 '資源名稱' 屬性，因為後端服務的 REST API 本身不會傳回它。
  2. 所有觸發器每次執行最多可以傳回 10 個項目。 如果有更多資料可用，且這是 V2 觸發程序，則觸發程序會再次執行，而不會延遲。

節流限制

名稱 呼叫 續約期間
每個連線的 API 呼叫 100 60 秒

動作

列出專案

列出專案線上網站中的專案。
列出工作

列出專案中已發佈的任務。
取得專案摘要工作

取得指定專案的專案摘要任務。
建立新任務

在您的專案中建立新任務。
建立新專案

在專案線上網站中建立新專案。
建立新資源

在您的 Project Online 網站中建立企業資源。
清單專案

在您的專案線上網站中依識別碼列出專案。
簽入並發佈專案

簽入並發佈您網站中的現有專案。
結帳專案

取出您網站中的現有專案。

列出專案

作業識別碼：
ListProjects

列出專案線上網站中的專案。

參數

名稱 機碼 必要 類型 Description
根網站網址
 siteUrl True uri

專案網站的根網站 URL （範例： https://sampletenant.sharepoint.com/teams/sampleteam ）。

傳回

專案線上清單專案回應模型

身體
ProjectsWrapper

列出工作

作業識別碼：
ListTasks

列出專案中已發佈的任務。

參數

名稱 機碼 必要 類型 Description
根網站網址
 siteUrl True uri

專案網站的根網站 URL （範例： https://sampletenant.sharepoint.com/teams/sampleteam ）。
專案編號
 project_id True string

專案中用於擷取工作的唯一識別碼。
篩選查詢
 $filter string

ODATA 篩選查詢，以限制傳回的專案 （例如 Id eq 'task-guid'）。
選取查詢
 $select string

OData 選取要傳回資料行的資料行查詢。 範例：id、名稱

傳回

Project 線上清單任務回應模型

身體
TasksWrapper

取得專案摘要工作

作業識別碼：
GetProjectSummaryTask

取得指定專案的專案摘要任務。

參數

名稱 機碼 必要 類型 Description
根網站網址
 siteUrl True uri

專案網站的根網站 URL （範例： https://sampletenant.sharepoint.com/teams/sampleteam ）。
專案編號
 project_id True string

要擷取的專案的唯一ID

傳回

Project Online 伺服器工作

身體
Task

建立新任務

作業識別碼：
CreateTask

在您的專案中建立新任務。

參數

名稱 機碼 必要 類型 Description
根網站網址
 siteUrl True uri

專案網站的根網站 URL （範例： https://sampletenant.sharepoint.com/teams/sampleteam ）。
專案編號
 project_id True string

要新增任務的專案的唯一ID。
任務名稱
 Name True string

要建立的新任務名稱
任務筆記
 Notes string

新任務的附註
任務開始日期
 Start date-time

任務的開始日期
任務工期
 Duration string

任務的持續時間。 例如（1 小時、2 天或 3 周）

傳回

Project Online 伺服器工作

身體
Task

建立新專案

作業識別碼：
CreateProject

在專案線上網站中建立新專案。

參數

名稱 機碼 必要 類型 Description
根網站網址
 siteUrl True uri

專案網站的根網站 URL （範例： https://sampletenant.sharepoint.com/teams/sampleteam ）。
專案名稱
 Name True string

要建立的新專案名稱
專案描述
 Description string

要建立的新專案的描述
專案開始日期
 Start date-time

新專案的開始日期

傳回

Project Online 專案模型

身體
Project

建立新資源

作業識別碼：
CreateResource

在您的 Project Online 網站中建立企業資源。

參數

名稱 機碼 必要 類型 Description
根網站網址
 siteUrl True uri

專案網站的根網站 URL （範例： https://sampletenant.sharepoint.com/teams/sampleteam ）。
資源名稱
 Name True string

要建立的新資源名稱
資源是否在預算中
 IsBudget boolean

資源是否計入預算
資源是一般的
 IsGeneric boolean

資源是一般的
資源是否處於非作用中狀態
 IsInactive boolean

資源是否處於非作用中狀態

傳回

Project Online 企業資源模型

身體
EnterpriseResource

清單專案

作業識別碼：
ListProject

在您的專案線上網站中依識別碼列出專案。

參數

名稱 機碼 必要 類型 Description
根網站網址
 siteUrl True uri

專案網站的根網站 URL （範例： https://sampletenant.sharepoint.com/teams/sampleteam ）。
專案編號
 project_id True string

要擷取的專案的唯一ID
選取查詢
 $select string

OData 選取要傳回資料行的資料行查詢。 範例：id、名稱

傳回

Project Online 專案模型

身體
Project

簽入並發佈專案

作業識別碼：
PublishProject

簽入並發佈您網站中的現有專案。

參數

名稱 機碼 必要 類型 Description
根網站網址
 siteUrl True uri

專案網站的根網站 URL （範例： https://sampletenant.sharepoint.com/teams/sampleteam ）。
專案編號
 project_id True string

要簽入之專案的唯一識別碼。

傳回

response
object

結帳專案

作業識別碼：
CheckoutProject

取出您網站中的現有專案。

參數

名稱 機碼 必要 類型 Description
根網站網址
 siteUrl True uri

專案網站的根網站 URL （範例： https://sampletenant.sharepoint.com/teams/sampleteam ）。
專案編號
 project_id True string

要簽出之專案的唯一ID。

傳回

response
object

觸發程序

建立新任務時

建立新任務時觸發流程。
建立新專案時

每當建立新專案時觸發流程。
建立新專案時 （V2） （預覽版）

每當建立新專案時觸發流程。
建立新工作時 （V2） （預覽版）

建立新任務時觸發流程。
建立新資源時

建立新資源時觸發新流程。
建立新資源時 （V2） （預覽版）

建立新資源時觸發新流程。
發佈專案時

每當發佈專案時觸發流程。
發佈專案時 （V2） （預覽版）

每當發佈專案時觸發流程。

建立新任務時

作業識別碼：
OnNewTask

建立新任務時觸發流程。

參數

名稱 機碼 必要 類型 Description
根網站網址
 siteUrl True uri

專案網站的根網站 URL （範例： https://sampletenant.sharepoint.com/teams/sampleteam ）。

傳回

在新的任務回應模型上線上專案

身體
TriggerTasksWrapper

建立新專案時

作業識別碼：
OnNewProject

每當建立新專案時觸發流程。

參數

名稱 機碼 必要 類型 Description
根網站網址
 siteUrl True uri

專案網站的根網站 URL （範例： https://sampletenant.sharepoint.com/teams/sampleteam ）。

傳回

Project Online 關於新的專案回應模型。

身體
TriggerProjectsWrapper

建立新專案時 （V2） （預覽版）

作業識別碼：
OnNewProjectV2

每當建立新專案時觸發流程。

參數

名稱 機碼 必要 類型 Description
根網站網址
 siteUrl True uri

專案網站的根網站 URL （範例： https://sampletenant.sharepoint.com/teams/sampleteam ）。
選取查詢
 $select True string

OData 選取要傳回資料行的資料行查詢。

傳回

Project Online 關於新的專案回應模型。

身體
TriggerProjectsWrapper

建立新工作時 （V2） （預覽版）

作業識別碼：
OnNewTaskV2

建立新任務時觸發流程。

參數

名稱 機碼 必要 類型 Description
根網站網址
 siteUrl True uri

專案網站的根網站 URL （範例： https://sampletenant.sharepoint.com/teams/sampleteam ）。
選取查詢
 $select True string

OData 選取要傳回資料行的資料行查詢。

傳回

在新的任務回應模型上線上專案

身體
TriggerTasksWrapper

建立新資源時

作業識別碼：
OnNewResource

建立新資源時觸發新流程。

參數

名稱 機碼 必要 類型 Description
根網站網址
 siteUrl True uri

專案網站的根網站 URL （範例： https://sampletenant.sharepoint.com/teams/sampleteam ）。

傳回

Project Online 關於新的資源回應模型。

身體
TriggerResourcesWrapper

建立新資源時 （V2） （預覽版）

作業識別碼：
OnNewResourceV2

建立新資源時觸發新流程。

參數

名稱 機碼 必要 類型 Description
根網站網址
 siteUrl True uri

專案網站的根網站 URL （範例： https://sampletenant.sharepoint.com/teams/sampleteam ）。
選取查詢
 $select True string

OData 選取要傳回資料行的資料行查詢。

傳回

Project Online 關於新的資源回應模型。

身體
TriggerResourcesWrapper

發佈專案時

作業識別碼：
OnProjectPublished

每當發佈專案時觸發流程。

參數

名稱 機碼 必要 類型 Description
根網站網址
 siteUrl True uri

專案網站的根網站 URL （範例： https://sampletenant.sharepoint.com/teams/sampleteam ）。

傳回

Project Online 關於新的專案回應模型。

身體
TriggerProjectsWrapper

發佈專案時 （V2） （預覽版）

作業識別碼：
OnProjectPublishedV2

每當發佈專案時觸發流程。

參數

名稱 機碼 必要 類型 Description
根網站網址
 siteUrl True uri

專案網站的根網站 URL （範例： https://sampletenant.sharepoint.com/teams/sampleteam ）。
選取查詢
 $select True string

OData 選取要傳回資料行的資料行查詢。

傳回

Project Online 關於新的專案回應模型。

身體
TriggerProjectsWrapper

定義

觸發項目包裝器

Project Online 關於新的專案回應模型。

名稱 路徑 類型 Description
傳回的專案
 value array of TriggerProject

傳回的觸發專案清單。

觸發項目

Project Online 專案模型

名稱 路徑 類型 Description
專案開始日期
 ProjectStartDate date-time

已核准專案開始的日期時間。
專案結束日期
 ProjectFinishDate date-time

已核准專案完成的日期時間。
建立日期
 ProjectCreatedDate date-time

專案的建立日期時間。
專案編號
 ProjectId string

專案的唯一識別碼。
上次修改日期
 ProjectModifiedDate date-time

上次儲存專案的日期時間。
專案類型
 ProjectType integer

專案的型別。
專案名稱
 ProjectName string

項目的名稱。
最後發佈日期
 ProjectLastPublishedDate date-time

專案上次發佈的日期時間。
專案負責人
 ProjectOwnerName string

專案的擁有者。
專案完成百分比
 ProjectPercentCompleted integer

專案的完成百分比。
專案完成工時百分比
 ProjectPercentWorkCompleted integer

專案完成的工作百分比。
專案加班成本
 ProjectOvertimeCost string

專案的加班成本。
專案加班工作
 ProjectOvertimeWork string

項目的加班工作。

觸發資源包裝函式

Project Online 關於新的資源回應模型。

名稱 路徑 類型 Description
傳回的資源
 value array of TriggerResource

傳回的觸發程式資源清單。

觸發資源

資源 線上資源模型。

名稱 路徑 類型 Description
資源標識碼
 ResourceId string

資源的唯一識別碼。
基本行事曆
 ResourceBaseCalendar string

資源的基本行事曆類型。
資源預約類型
 ResourceBookingType integer

資源的預約類型
可以資源等級
 ResourceCanLevel boolean

資源等級可以
每次使用資源成本
 ResourceCostPerUse string

每次使用資源的成本
資源建立日期
 ResourceCreatedDate date-time

資源的建立日期
資源最早可從
 ResourceEarliestAvailableFrom date-time

資源的最早可用日期
資源電子郵件
 ResourceEmailAddress string

資源的電子郵件地址
資源初始化
 ResourceInitials string

資源的縮寫
資源是否作用中w
 ResourceIsActive boolean

新資源是否作用中
資源是一般的
 ResourceIsGeneric boolean

新資源是否為一般
最新可用資源
 ResourceLatestAvailableTo date-time

資源可用的最新日期
資源上次修改日期
 ResourceModifiedDate date-time

資源的上次修改日期
資源名稱
 ResourceName string

資源名稱
資源狀態名稱
 ResourceStatsuName string

資源的狀態名稱
資源類型
 ResourceType integer

資源類型
資源類型描述
 TypeDescription string

資源類型的描述
資源類型名稱
 TypeName string

資源的類型名稱

觸發任務包裝

在新的任務回應模型上線上專案

名稱 路徑 類型 Description
傳回的任務
 value array of TriggerTask

傳回的觸發程式工作清單

觸發任務

任務在線任務模型

名稱 路徑 類型 Description
專案編號
 ProjectId string

建立任務之專案的ID
工作標識碼
 TaskId string

新工作的標識碼
專案名稱
 ProjectName string

建立任務的專案名稱
任務名稱
 TaskName string

新工作的名稱
任務建立日期
 TaskCreatedDate date-time

新任務的建立日期
任務上次修改日期
 TaskModifieddate date-time

新任務的上次修改日期
任務開始日期
 TaskStartDate date-time

新任務的開始日期
任務完成日期
 TaskFinishDate date-time

新任務的完成日期
任務摘要
 TaskPriority integer

新任務的優先順序
工作處於作用中狀態
 TaskIsActive boolean

任務是否仍處於作用中狀態

專案

Project Online 專案模型

名稱 路徑 類型 Description
核准的開始日期
 ApprovedStart date-time

核准的專案開始時間
核准結束日期
 ApprovedEnd date-time

核准的專案結束時間
退房日期
 CheckedOutDate date-time

專案出庫的時間
結帳說明
 CheckOutDescription string

專案出庫時使用的說明
結帳編號
 CheckOutId string

專案簽出的標識碼
建立日期
 CreatedDate date-time

專案的建立日期
專案編號
 Id string

專案的標識碼
已簽出
 IsCheckedOut boolean

如果專案目前已出庫使用，則為 True
最後發布日期
 ProjectLastPublishedDate date-time

專案的最後發佈日期
最後發布日期
 LastPublishedDate date-time

專案的最後發佈日期
上次儲存日期
 LastSavedDate date-time

儲存專案的最後日期
最佳化工具決策
 OptimizerDecision integer

專案最佳化工具決策號碼
規劃師決策
 PlannerDecision integer

專案規劃器決策編號
專案類型
 ProjectType integer

專案類型
專案名稱
 Name string

專案名稱
專案識別碼
 ProjectIdentifier string

專案識別碼
Win proj version
 WinprojVersion string

專案版本

專案包裝器

專案線上清單專案回應模型

名稱 路徑 類型 Description
傳回的專案
 value array of Project

傳回的專案清單

企業資源

Project Online 企業資源模型

名稱 路徑 類型 Description
可以資源等級
 CanLevel boolean

可以資源等級
資源代碼
 Code string

資源代碼
資源成本應計
 CostAccrual integer

資源成本應計
資源成本中心
 CostCenter string

資源成本中心
資源建立時間
 Created date-time

資源建立時間
預設預訂類型
 DefaultBookingType integer

資源預設預約類型
Email
 Email string

資源電子郵件地址
外部ID
 ExternalId string

資源外部識別碼
資源群組
 Group string

資源所屬的群組
租用日期
 HireDate date-time

資源的租用日期
資源識別碼
 Id string

資源識別碼
Resouce 縮寫
 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

Project 線上清單任務回應模型

名稱 路徑 類型 Description
傳回的任務
 value array of Task

傳回的工作清單

任務

Project Online 伺服器工作

名稱 路徑 類型 Description
任務建立日期
 Created date-time

任務的建立日期
任務上次修改日期
 Modified date-time

任務的上次修改日期
任務開始日期
 Start date-time

任務的開始日期
任務完成日期
 Finish date-time

任務的完成日期
任務排程開始日期
 ScheduledStart date-time

任務的排程開始日期
任務排程完成日期
 ScheduledFinish date-time

任務的排程完成日期
任務名稱
 Name string

任務的名稱
工作標識碼
 Id string

任務的 ID
任務優先順序
 Priority integer

任務的優先順序層級
任務完成百分比
 PercentComplete integer

任務完成百分比
任務筆記
 Notes string

有關任務的描述註釋
任務聯絡人
 Contact string

任務的聯絡地址
是里程碑任務
 IsMilestone boolean

指出任務是否為里程碑

物件

這是類型 'object'。