PPM Express (Preview)

Reference

PPM Express is an Online Project Portfolio Management Software. Connector to PPM Express allows you to retrieve information about the entities (Project, Idea, Task, Key Date, Resource) from your PPM Express tenant, as well as to create new or update existing ones.

This connector is available in the following products and regions:

Service	Class	Regions
Logic Apps	Standard	All Logic Apps regions except the following: - Azure Government regions - Azure China regions - US Department of Defense (DoD)
Power Automate	Premium	All Power Automate regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD)
Power Apps	Premium	All Power Apps regions except the following: - US Government (GCC) - US Government (GCC High) - China Cloud operated by 21Vianet - US Department of Defense (DoD)

Contact
Name	PPM Express Support
URL	https://ppm.express/contact-us/
Email	support@ppm.express

Connector Metadata
Publisher	PPM Express Corporation
Website	https://ppm.express
Privacy policy	https://ppm.express/privacy-policy
Categories	Business Management;Business Intelligence

Creating a connection

The connector supports the following authentication types:


Default	Parameters for creating connection.	All regions	Not shareable

Default

Applicable: All regions

Parameters for creating connection.

This is not shareable connection. If the power app is shared with another user, another user will be prompted to create new connection explicitly.

Name	Type	Description	Required
API Key	securestring	The personal access token for PPM Express	True
Tenant Region	string	The region your PPM Express tenant is hosted on	True
Tenant Name	string	The tenant name	True

Throttling Limits

Name	Calls	Renewal Period
API calls per connection	100	60 seconds

Actions

Create a Challenge	Creates new Challenge
Create a Key Date	Creates a new Key Date
Create a Project	Creates a new Project
Create a Resource	Creates a Resource
Create a Task	Creates a Task for the specified Project
Create an Idea	Creates a new Idea for the specified challenge
Get a Challenge	Gets an existing Challenge by Id
Get a Key Date	Gets a Key Date Info by Id
Get a Project	Gets a Project Info by Id
Get a Resource	Gets a Resource by Id
Get a Task	Gets a Task by Id and by Project
Get an Idea	Gets an existing Idea by Id
Get Challenges List	Gets all Challenges
Get current user	Gets current user and token information
Get fields	Gets fields information for specified entity(e.g. Project, Idea, Resource etc)
Get Ideas List	Gets All Ideas or for the specified challenge
Get Key Dates List	Gets List of all Key Dates for the specified project
Get Projects List	Gets list of all projects
Get Resources List	Gets List of all Resources
Get Tasks List	Gets List of all Tasks for the specified Project
Update a Challenge	Updates an existing Challenge
Update a Key Date	Updates a Key Date
Update a Project	Updates the specified Project fields
Update a Resource	Updates a Resource
Update a Task	Updates a Task
Update an Idea	Updates an existing Idea
Update an Idea Stage	Updates an Idea Stage

Create a Challenge

Operation ID:: ChallengesCreate

Creates new Challenge

Returns

Body: ChallengeResponseResponse

Create a Key Date

Operation ID:: ProjectsKeyDatesCreate

Creates a new Key Date

Parameters

Name	Key	Required	Type	Description
Project Id	id	True	uuid	The unique identifier of the project

Returns

Body: KeyDateResponseResponse

Create a Project

Operation ID:: ProjectsCreate

Creates a new Project

Returns

Body: ProjectResponseResponse

Create a Resource

Operation ID:: ResourcesCreate

Creates a Resource

Returns

Body: ResourceResponseResponse

Create a Task

Operation ID:: ProjectsTasksCreate

Creates a Task for the specified Project

Parameters

Name	Key	Required	Type	Description
Project Id	id	True	uuid	The unique identifier of the project

Returns

Body: TaskResponseResponse

Create an Idea

Operation ID:: IdeasCreate

Creates a new Idea for the specified challenge

Parameters

Name	Key	Required	Type	Description
Challenge Id	challengeId		uuid	The challenge id which idea is belonging to

Returns

Body: IdeaResponseResponse

Get a Challenge

Operation ID:: ChallengesGet

Gets an existing Challenge by Id

Parameters

Name	Key	Required	Type	Description
Challenge Id	id	True	uuid	The unique identifier of the challenge

Returns

Body: ChallengeResponseResponse

Get a Key Date

Operation ID:: ProjectsKeyDatesGet

Gets a Key Date Info by Id

Parameters

Name	Key	Required	Type	Description
Project Id	id	True	uuid	The unique identifier of the project
KeyDate Id	keyDateId	True	uuid	The unique identifier of the KeyDate

Returns

Body: KeyDateResponseResponse

Get a Project

Operation ID:: ProjectsGet

Gets a Project Info by Id

Parameters

Name	Key	Required	Type	Description
Project Id	id	True	uuid	The unique identifier of the project

Returns

Body: ProjectResponseResponse

Get a Resource

Operation ID:: ResourcesGet

Gets a Resource by Id

Parameters

Name	Key	Required	Type	Description
Resource Id	id	True	uuid	The unique identifier of the resource

Returns

Body: ResourceResponseResponse

Get a Task

Operation ID:: ProjectsTasksGetTask

Gets a Task by Id and by Project

Parameters

Name	Key	Required	Type	Description
Project Id	id	True	uuid	The unique identifier of the project
Task Id	taskId	True	uuid	The unique identifier of the task

Returns

Body: TaskResponseResponse

Get an Idea

Operation ID:: IdeasGet

Gets an existing Idea by Id

Parameters

Name	Key	Required	Type	Description
Idea Id	id	True	uuid	The unique identifier of the idea

Returns

Body: IdeaResponseResponse

Get Challenges List

Operation ID:: ChallengesGetAll

Gets all Challenges

Returns

Body: ChallengeResponseListResponse

Get current user

Operation ID:: MeGet

Gets current user and token information

Parameters

Name	Key	Required	Type	Description
			object

Returns

Body: MeResponseResponse

Get fields

Operation ID:: FieldsGet

Gets fields information for specified entity(e.g. Project, Idea, Resource etc)

Parameters

Name	Key	Required	Type	Description
Entity	entity	True	string	Entity name

Returns

Body: FieldResponseList

Get Ideas List

Operation ID:: IdeasGetAll

Gets All Ideas or for the specified challenge

Parameters

Name	Key	Required	Type	Description
Challenge Id	challengeId		uuid	Specify the challenge id

Returns

Body: IdeaResponseListResponse

Get Key Dates List

Operation ID:: ProjectsKeyDatesGetAll

Gets List of all Key Dates for the specified project

Parameters

Name	Key	Required	Type	Description
Project Id	id	True	uuid	The unique identifier of the project

Returns

Body: KeyDateResponseListResponse

Get Projects List

Operation ID:: ProjectsGetAll

Gets list of all projects

Parameters

Name	Key	Required	Type	Description
			object

Returns

Body: ProjectResponseListResponse

Get Resources List

Operation ID:: ResourcesGetAll

Gets List of all Resources

Parameters

Name	Key	Required	Type	Description
			object

Returns

Body: ResourceResponseListResponse

Get Tasks List

Operation ID:: ProjectsTasksGetAll

Gets List of all Tasks for the specified Project

Parameters

Name	Key	Required	Type	Description
Project Id	id	True	uuid	The unique identifier of the project

Returns

Body: TaskResponseListTask

Update a Challenge

Operation ID:: ChallengesUpdate

Updates an existing Challenge

Parameters

Name	Key	Required	Type	Description
Challenge Id	id	True	uuid	The unique identifier of the challenge

Returns

Body: ChallengeResponseResponse

Update a Key Date

Operation ID:: ProjectsKeyDatesUpdate

Updates a Key Date

Parameters

Name	Key	Required	Type	Description
Project Id	id	True	uuid	The unique identifier of the project
KeyDate Id	keyDateId	True	uuid	The unique identifier of the KeyDate

Returns

Body: KeyDateResponseResponse

Update a Project

Operation ID:: ProjectsUpdate

Updates the specified Project fields

Parameters

Name	Key	Required	Type	Description
Project Id	id	True	uuid	The unique identifier of the project

Returns

Body: ProjectResponseResponse

Update a Resource

Operation ID:: ResourcesUpdate

Updates a Resource

Parameters

Name	Key	Required	Type	Description
Resource Id	id	True	uuid	The unique identifier of the resource

Returns

Body: ResourceResponseResponse

Update a Task

Operation ID:: ProjectsTasksUpdate

Updates a Task

Parameters

Name	Key	Required	Type	Description
Project Id	id	True	uuid	The unique identifier of the project
Task Id	taskId	True	uuid	The unique identifier of the task

Returns

Body: TaskResponseResponse

Update an Idea

Operation ID:: IdeasUpdate

Updates an existing Idea

Parameters

Name	Key	Required	Type	Description
Idea Id	id	True	uuid	The unique identifier of the idea

Returns

Body: IdeaResponseResponse

Update an Idea Stage

Operation ID:: IdeasChangeStage

Updates an Idea Stage

Parameters

Name	Key	Required	Type	Description
Idea Id	id	True	uuid	The unique identifier of the idea
Idea Stage	stage		string	Stage of Idea

Returns

Body: IdeaResponseResponse

Triggers

Webhook Trigger

When an operation is performed on an entity in PPM Express

Webhook Trigger

Operation ID:: WebhookTrigger

When an operation is performed on an entity in PPM Express

Parameters

Name	Key	Required	Type	Description
Event Types	eventTypes	True	array of string	Select the events to listen to
Name	name		string	Custom header name
Value	value		string	Custom header value

Returns

Name	Path	Type
WebhookId	WebhookId	string
MessageId	MessageId	string
Data	Data	object

Definitions

ChallengeAttributes

Challenge fields (e.g. {"Name": "My Name", "Description": "TBD"})

ChallengeResponse

Challenge details

Name	Path	Type	Description
id	id	uuid	Challenge Id
Attributes	attributes	ChallengeAttributes	Challenge fields (e.g. {"Name": "My Name", "Description": "TBD"})

ChallengeResponseListResponse

Name	Path	Type	Description
data	data	array of ChallengeResponse

ChallengeResponseResponse

Name	Path	Type	Description
data	data	ChallengeResponse	Challenge details

FieldResponse

Field details

Name	Path	Type	Description
Key	key	string	Field key
Field Label	label	string	Label of the field
Field Type	type	string	Type of the field
Is MultiChoice	isMultiChoice	boolean	Is Field multichoice
Is ReadOnly	isReadonly	boolean	Is Field readonly
Field Settings	settings	object	Custom settings for the field

FieldResponseList

Name	Path	Type	Description
Fields	data	array of FieldResponse	List of fields for selected entity

IdeaAttributes

Idea fields (e.g. {"Name": "My Name", "Description": "TBD"})

IdeaResponse

Idea details

Name	Path	Type	Description
Idea Id	id	uuid	The Idea unique Id
Attributes	attributes	IdeaAttributes	Idea fields (e.g. {"Name": "My Name", "Description": "TBD"})
Votes	votes	integer	Number of votes for idea

IdeaResponseListResponse

Name	Path	Type	Description
Ideas	data	array of IdeaResponse	List of Ideas

IdeaResponseResponse

Name	Path	Type	Description
data	data	IdeaResponse	Idea details

KeyDateAttributes

Key Date fields (e.g. {"Name": "My Name", "Description": "TBD"})

KeyDateResponse

Key Date details

Name	Path	Type	Description
KeyDate Id	id	uuid	Key Date unique identifier
KeyDate fields	attributes	KeyDateAttributes	Key Date fields (e.g. {"Name": "My Name", "Description": "TBD"})
Source type	sourceType	SourceType	Type of data source

KeyDateResponseListResponse

Name	Path	Type	Description
data	data	array of KeyDateResponse

KeyDateResponseResponse

Name	Path	Type	Description
data	data	KeyDateResponse	Key Date details

MeResponse

User details

Name	Path	Type	Description
User Id	id	uuid	User unique identifier
Logon Account	logonAccount	string	User Logon Account
Email	email	string	User Email
token	token	TokenInfo

MeResponseResponse

Name	Path	Type	Description
data	data	MeResponse	User details

ProjectAttributes

Project fields (e.g. {"Name": "My Name", "Description": "TBD"})

ProjectResponse

Project details

Name	Path	Type	Description
Project Id	id	uuid	Unique Project Identifier
Project fields	attributes	ProjectAttributes	Project fields (e.g. {"Name": "My Name", "Description": "TBD"})

ProjectResponseListResponse

Name	Path	Type	Description
Projects	data	array of ProjectResponse	List of projects

ProjectResponseResponse

Name	Path	Type	Description
data	data	ProjectResponse	Project details

ResourceAttributes

Resource fields (e.g. {"Name": "My Name", "Description": "TBD"})

ResourceResponse

Resource details

Name	Path	Type	Description
Unique Resource Identifier	id	uuid	Resource Id
Resources fields	attributes	ResourceAttributes	Resource fields (e.g. {"Name": "My Name", "Description": "TBD"})

ResourceResponseListResponse

Name	Path	Type	Description
Resources	data	array of ResourceResponse	List of resources

ResourceResponseResponse

Name	Path	Type	Description
data	data	ResourceResponse	Resource details

SourceType

Type of data source

Source type: string

BaselineData

Name	Path	Type
date	date	date-time
startDate	startDate	date-time
dueDate	dueDate	date-time
duration	duration	integer
effort	effort	double
originalEstimate	originalEstimate	double

TaskAttributes

Task fields (e.g. {"Name": "My Name", "Description": "TBD"})

TaskResponse

Task details

Name	Path	Type	Description
Task Id	id	uuid	Unique Task Identifier
Task fields	attributes	TaskAttributes	Task fields (e.g. {"Name": "My Name", "Description": "TBD"})
Source type	sourceType	SourceType	Type of data source
baseline	baseline	BaselineData

TaskResponseListTask

Name	Path	Type	Description
Tasks	data	array of TaskResponse	List of tasks

TaskResponseResponse

Name	Path	Type	Description
data	data	TaskResponse	Task details

TokenInfo

Name	Path	Type	Description
Token Id	id	uuid	Unique Token Identifier
Token Name	name	string	Name of the API Token
Token Expiration Date	expirationDate	date-time	Expiration date of the API Token
Scopes	scopes	array of string	Array of Allowed Actions

共用方式為

PPM Express (Preview)

Creating a connection

Default

Throttling Limits

Actions

Create a Challenge

Returns

Create a Key Date

Parameters

Returns

Create a Project

Returns

Create a Resource

Returns

Create a Task

Parameters

Returns

Create an Idea

Parameters

Returns

Get a Challenge

Parameters

Returns

Get a Key Date

Parameters

Returns

Get a Project

Parameters

Returns

Get a Resource

Parameters

Returns

Get a Task

Parameters

Returns

Get an Idea

Parameters

Returns

Get Challenges List

Returns

Get current user

Parameters

Returns

Get fields

Parameters

Returns

Get Ideas List

Parameters

Returns

Get Key Dates List

Parameters

Returns

Get Projects List

Parameters

Returns

Get Resources List

Parameters

Returns

Get Tasks List

Parameters

Returns

Update a Challenge

Parameters

Returns

Update a Key Date

Parameters

Returns

Update a Project

Parameters

Returns

Update a Resource

Parameters

Returns

Update a Task

Parameters

Returns

Update an Idea

Parameters

Returns