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 Description
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

Type of data source

Source type
string

BaselineData

Name Path Type Description
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