PPM Express （預覽版）

PPM Express 是一款在線項目組合管理軟件。 PPM Express 連接器可讓您從 PPM Express 租用戶擷取實體（專案、構想、任務、關鍵日期、資源）的相關資訊，以及建立新的或更新現有的實體。

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

服務	Class	Regions
副駕駛工作室	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
邏輯應用程式	標準	所有 Logic Apps 區域，但下列區域除外： - Azure Government 區域 - Azure 中國區域 - 美國國防部（DoD）
Power Apps	進階	除下列區域外的所有 Power Apps 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）
Power Automate（自動化服務）	進階	除下列區域外的所有 Power Automate 區域： - 美國政府（GCC） - 美國政府（海灣合作委員會高中） - 由 21Vianet 營運的中國雲 - 美國國防部（DoD）

連絡人
名稱	PPM Express 支援
URL	https://ppm.express/contact-us/
Email	support@ppm.express

連接器中繼資料
Publisher	PPM快遞公司
網站	https://ppm.express
隱私策略	https://ppm.express/privacy-policy
類別	商業管理;商業智慧

正在建立連線

連接器支援下列驗證類型：


預設值	建立連線的參數。	所有區域	不可共享

預設

適用：所有地區

建立連線的參數。

這不是可共用的連線。如果 Power App 與其他使用者共用，系統會明確提示其他使用者建立新連線。

名稱	類型	Description	為必填項目
API 金鑰	securestring	PPM Express 的個人存取權杖	對
租用戶區域	字串	PPM Express 租用戶裝載的區域	對
租客名稱	字串	租用戶名稱	對

節流限制

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

動作

創造一個想法	為指定的挑戰創建一個新構想
創造挑戰	創造新的挑戰
取得任務	依識別碼和專案取得任務
取得專案	依 ID 取得專案資訊
取得專案清單	取得所有專案的清單
取得工作清單	取得指定專案的所有任務清單
取得想法清單	獲得所有想法或針對指定挑戰
取得挑戰清單	獲得所有挑戰
取得欄位	獲取指定實體的字段信息（例如項目、想法、資源等）
取得目前的使用者	取得目前使用者和權杖資訊
取得資源	依識別碼取得資源
取得資源清單	取得所有資源的清單
取得關鍵日期	通過 id 獲取關鍵日期信息
取得關鍵日期清單	取得指定專案的所有關鍵日期清單
建立任務	為指定的專案建立任務
建立專案	建立新專案
建立資源	建立資源
建立關鍵日期	建立新的關鍵日期
得到一個想法	依 ID 取得現有的構想
接受挑戰	取得 Id 的現有挑戰
更新任務	更新任務
更新專案	更新指定的專案欄位
更新挑戰	更新現有挑戰
更新構想	更新現有構想
更新構想階段	更新構想階段
更新資源	更新資源
更新關鍵日期	更新關鍵日期

創造一個想法

作業識別碼：: IdeasCreate

為指定的挑戰創建一個新構想

參數

名稱	機碼	必要	類型	Description
挑戰編號	challengeId		uuid	挑戰 ID 屬於哪個想法

傳回

身體: IdeaResponseResponse

創造挑戰

作業識別碼：: ChallengesCreate

創造新的挑戰

傳回

身體: ChallengeResponseResponse

取得任務

作業識別碼：: ProjectsTasksGetTask

依識別碼和專案取得任務

參數

名稱	機碼	必要	類型	Description
專案編號	id	True	uuid	專案的唯一識別碼
任務標識符	taskId	True	uuid	工作的唯一識別碼

傳回

身體: TaskResponseResponse

取得專案

作業識別碼：: ProjectsGet

依 ID 取得專案資訊

參數

名稱	機碼	必要	類型	Description
專案編號	id	True	uuid	專案的唯一識別碼

傳回

身體: ProjectResponseResponse

取得專案清單

作業識別碼：: ProjectsGetAll

取得所有專案的清單

參數

名稱	機碼	必要	類型	Description
			object

傳回

身體: ProjectResponseListResponse

取得工作清單

作業識別碼：: ProjectsTasksGetAll

取得指定專案的所有任務清單

參數

名稱	機碼	必要	類型	Description
專案編號	id	True	uuid	專案的唯一識別碼

傳回

身體: TaskResponseListTask

取得想法清單

作業識別碼：: IdeasGetAll

獲得所有想法或針對指定挑戰

參數

名稱	機碼	必要	類型	Description
挑戰編號	challengeId		uuid	指定挑戰標識碼

傳回

身體: IdeaResponseListResponse

取得挑戰清單

作業識別碼：: ChallengesGetAll

獲得所有挑戰

傳回

身體: ChallengeResponseListResponse

取得欄位

作業識別碼：: FieldsGet

獲取指定實體的字段信息（例如項目、想法、資源等）

參數

名稱	機碼	必要	類型	Description
實體	entity	True	string	實體名稱

傳回

身體: FieldResponseList

取得目前的使用者

作業識別碼：: MeGet

取得目前使用者和權杖資訊

參數

名稱	機碼	必要	類型	Description
			object

傳回

身體: MeResponseResponse

取得資源

作業識別碼：: ResourcesGet

依識別碼取得資源

參數

名稱	機碼	必要	類型	Description
資源標識碼	id	True	uuid	資源的唯一識別碼

傳回

身體: ResourceResponseResponse

取得資源清單

作業識別碼：: ResourcesGetAll

取得所有資源的清單

參數

名稱	機碼	必要	類型	Description
			object

傳回

身體: ResourceResponseListResponse

取得關鍵日期

作業識別碼：: ProjectsKeyDatesGet

通過 id 獲取關鍵日期信息

參數

名稱	機碼	必要	類型	Description
專案編號	id	True	uuid	專案的唯一識別碼
KeyDate Id	keyDateId	True	uuid	KeyDate 的唯一識別碼

傳回

身體: KeyDateResponseResponse

取得關鍵日期清單

作業識別碼：: ProjectsKeyDatesGetAll

取得指定專案的所有關鍵日期清單

參數

名稱	機碼	必要	類型	Description
專案編號	id	True	uuid	專案的唯一識別碼

傳回

身體: KeyDateResponseListResponse

建立任務

作業識別碼：: ProjectsTasksCreate

為指定的專案建立任務

參數

名稱	機碼	必要	類型	Description
專案編號	id	True	uuid	專案的唯一識別碼

傳回

身體: TaskResponseResponse

建立專案

作業識別碼：: ProjectsCreate

建立新專案

傳回

身體: ProjectResponseResponse

建立資源

作業識別碼：: ResourcesCreate

建立資源

傳回

身體: ResourceResponseResponse

建立關鍵日期

作業識別碼：: ProjectsKeyDatesCreate

建立新的關鍵日期

參數

名稱	機碼	必要	類型	Description
專案編號	id	True	uuid	專案的唯一識別碼

傳回

身體: KeyDateResponseResponse

得到一個想法

作業識別碼：: IdeasGet

依 ID 取得現有的構想

參數

名稱	機碼	必要	類型	Description
構想識別碼	id	True	uuid	構想的唯一識別碼

傳回

身體: IdeaResponseResponse

接受挑戰

作業識別碼：: ChallengesGet

取得 Id 的現有挑戰

參數

名稱	機碼	必要	類型	Description
挑戰編號	id	True	uuid	挑戰的唯一識別碼

傳回

身體: ChallengeResponseResponse

更新任務

作業識別碼：: ProjectsTasksUpdate

更新任務

參數

名稱	機碼	必要	類型	Description
專案編號	id	True	uuid	專案的唯一識別碼
任務標識符	taskId	True	uuid	工作的唯一識別碼

傳回

身體: TaskResponseResponse

更新專案

作業識別碼：: ProjectsUpdate

更新指定的專案欄位

參數

名稱	機碼	必要	類型	Description
專案編號	id	True	uuid	專案的唯一識別碼

傳回

身體: ProjectResponseResponse

更新挑戰

作業識別碼：: ChallengesUpdate

更新現有挑戰

參數

名稱	機碼	必要	類型	Description
挑戰編號	id	True	uuid	挑戰的唯一識別碼

傳回

身體: ChallengeResponseResponse

更新構想

作業識別碼：: IdeasUpdate

更新現有構想

參數

名稱	機碼	必要	類型	Description
構想識別碼	id	True	uuid	構想的唯一識別碼

傳回

身體: IdeaResponseResponse

更新構想階段

作業識別碼：: IdeasChangeStage

更新構想階段

參數

名稱	機碼	必要	類型	Description
構想識別碼	id	True	uuid	構想的唯一識別碼
創意階段	stage		string	構思階段

傳回

身體: IdeaResponseResponse

更新資源

作業識別碼：: ResourcesUpdate

更新資源

參數

名稱	機碼	必要	類型	Description
資源標識碼	id	True	uuid	資源的唯一識別碼

傳回

身體: ResourceResponseResponse

更新關鍵日期

作業識別碼：: ProjectsKeyDatesUpdate

更新關鍵日期

參數

名稱	機碼	必要	類型	Description
專案編號	id	True	uuid	專案的唯一識別碼
KeyDate Id	keyDateId	True	uuid	KeyDate 的唯一識別碼

傳回

身體: KeyDateResponseResponse

觸發程序

Webhook 觸發器

在 PPM Express 中對實體執行作業時

Webhook 觸發器

作業識別碼：: WebhookTrigger

在 PPM Express 中對實體執行作業時

參數

名稱	機碼	必要	類型	Description
事件類型	eventTypes	True	array of string	選取要收聽的事件
名稱	name		string	自訂標頭名稱
價值觀	value		string	自訂標頭值

傳回

名稱	路徑	類型
WebhookId	WebhookId	string
訊息標識符	MessageId	string
資料	Data	object

定義

挑戰屬性

挑戰欄位（例如 {“Name”： “My Name”， “Description”： “TBD”}）

挑戰回應

挑戰詳細資料

名稱	路徑	類型	Description
識別碼	id	uuid	挑戰編號
Attributes	attributes	ChallengeAttributes	挑戰欄位（例如 {“Name”： “My Name”， “Description”： “TBD”}）

挑戰回應清單回應

名稱	路徑	類型	Description
資料	data	array of ChallengeResponse

挑戰回應回應

名稱	路徑	類型	Description
資料	data	ChallengeResponse	挑戰詳細資料

現場回應

欄位詳細資料

名稱	路徑	類型	Description
Key	key	string	欄位索引鍵
欄位標籤	label	string	欄位的標籤
欄位類型	type	string	欄位類型
是多選	isMultiChoice	boolean	欄位是多項選擇
是唯讀	isReadonly	boolean	欄位是否為唯讀
欄位設定	settings	object	欄位的自訂設定

欄位回應清單

名稱	路徑	類型	Description
Fields	data	array of FieldResponse	所選實體的欄位清單

IdeaAttributes

構想欄位（例如 {“Name”： “My Name”， “description”： “待定”}）

想法回應

想法細節

名稱	路徑	類型	Description
構想識別碼	id	uuid	Idea 唯一 ID
Attributes	attributes	IdeaAttributes	構想欄位（例如 {“Name”： “My Name”， “description”： “待定”}）
Votes	votes	integer	構思的投票數

IdeaResponseListResponse

名稱	路徑	類型	Description
想法	data	array of IdeaResponse	想法清單

IdeaResponse回應

名稱	路徑	類型	Description
資料	data	IdeaResponse	想法細節

KeyDate屬性

關鍵日期欄位（例如 {“Name”： “My Name”， “Description”： “TBD”}）

KeyDate回應

關鍵日期詳細資料

名稱	路徑	類型	Description
KeyDate Id	id	uuid	關鍵日期專屬識別碼
KeyDate 欄位	attributes	KeyDateAttributes	關鍵日期欄位（例如 {“Name”： “My Name”， “Description”： “TBD”}）
來源類型	sourceType	SourceType	資料來源類型

KeyDateResponseList回應

名稱	路徑	類型	Description
資料	data	array of KeyDateResponse

KeyDateResponse回應

名稱	路徑	類型	Description
資料	data	KeyDateResponse	關鍵日期詳細資料

我的回應

使用者詳細資料

名稱	路徑	類型	Description
使用者 ID	id	uuid	使用者唯一識別碼
登入帳戶	logonAccount	string	使用者登入帳戶
Email	email	string	用戶電子郵件
Token	token	TokenInfo

我回應回應

名稱	路徑	類型	Description
資料	data	MeResponse	使用者詳細資料

專案屬性

專案欄位（例如 {“Name”： “My Name”， “Description”： “TBD”}）

專案回應

專案詳細資料

名稱	路徑	類型	Description
專案編號	id	uuid	唯一專案識別碼
專案欄位	attributes	ProjectAttributes	專案欄位（例如 {“Name”： “My Name”， “Description”： “TBD”}）

專案回應清單回應

名稱	路徑	類型	Description
專案	data	array of ProjectResponse	項目列表

專案回應回應

名稱	路徑	類型	Description
資料	data	ProjectResponse	專案詳細資料

資源屬性

資源欄位（例如 {“Name”： “My Name”， “description”： “TBD”}）

資源回應

資源詳細資料

名稱	路徑	類型	Description
唯一資源識別碼	id	uuid	資源標識碼
資源欄位	attributes	ResourceAttributes	資源欄位（例如 {“Name”： “My Name”， “description”： “TBD”}）

ResourceResponseList回應

名稱	路徑	類型	Description
Resources	data	array of ResourceResponse	資源清單

ResourceResponse回應

名稱	路徑	類型	Description
資料	data	ResourceResponse	資源詳細資料

來源類型

資料來源類型

來源類型: string

基準資料

名稱	路徑	類型
date	date	date-time
startDate	startDate	date-time
截止日期	dueDate	date-time
duration	duration	integer
投入量	effort	double
originalEstimate	originalEstimate	double

任務屬性

任務欄位（例如 {“Name”： “My Name”， “description”： “TBD”}）

任務回應

作業詳細資料

名稱	路徑	類型	Description
任務標識符	id	uuid	唯一任務標識符
任務欄位	attributes	TaskAttributes	任務欄位（例如 {“Name”： “My Name”， “description”： “TBD”}）
來源類型	sourceType	SourceType	資料來源類型
基準	baseline	BaselineData

任務回應清單任務

名稱	路徑	類型	Description
任務	data	array of TaskResponse	任務清單

TaskResponse回應

名稱	路徑	類型	Description
資料	data	TaskResponse	作業詳細資料

代幣資訊

名稱	路徑	類型	Description
權杖 ID	id	uuid	唯一權杖識別碼
權杖名稱	name	string	API 權杖的名稱
代幣到期日	expirationDate	date-time	API 權杖的到期日
Scopes	scopes	array of string	允許動作的陣列

共用方式為

PPM Express （預覽版）

正在建立連線

預設

節流限制

動作

創造一個想法

參數

傳回

創造挑戰

傳回

取得任務

參數

傳回

取得專案

參數

傳回

取得專案清單

參數

傳回

取得工作清單

參數

傳回

取得想法清單

參數

傳回

取得挑戰清單

傳回

取得欄位

參數

傳回

取得目前的使用者

參數

傳回

取得資源

參數

傳回

取得資源清單

參數

傳回

取得關鍵日期

參數

傳回

取得關鍵日期清單

參數

傳回

建立任務

參數

傳回

建立專案

傳回

建立資源

傳回

建立關鍵日期

參數

傳回

得到一個想法

參數

傳回

接受挑戰

參數

傳回

更新任務

參數

傳回

更新專案

參數

傳回

更新挑戰

參數

傳回

更新構想

參數

傳回

更新構想階段

參數

傳回

更新資源

參數

傳回