Share via


PPM Express (Preview)

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

Creates new Challenge

Returns

Create a Key Date

Creates a new Key Date

Parameters

Name Key Required Type Description
Project Id
id True uuid

The unique identifier of the project

Returns

Create a Project

Creates a new Project

Returns

Create a Resource

Creates a Resource

Returns

Create a Task

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

Create an Idea

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

Get a Challenge

Gets an existing Challenge by Id

Parameters

Name Key Required Type Description
Challenge Id
id True uuid

The unique identifier of the challenge

Returns

Get a Key Date

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

Get a Project

Gets a Project Info by Id

Parameters

Name Key Required Type Description
Project Id
id True uuid

The unique identifier of the project

Returns

Get a Resource

Gets a Resource by Id

Parameters

Name Key Required Type Description
Resource Id
id True uuid

The unique identifier of the resource

Returns

Get a Task

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

Get an Idea

Gets an existing Idea by Id

Parameters

Name Key Required Type Description
Idea Id
id True uuid

The unique identifier of the idea

Returns

Get Challenges List

Gets all Challenges

Returns

Get current user

Gets current user and token information

Parameters

Name Key Required Type Description
object

Returns

Get fields

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

Get Ideas List

Gets All Ideas or for the specified challenge

Parameters

Name Key Required Type Description
Challenge Id
challengeId uuid

Specify the challenge id

Returns

Get Key Dates List

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

Get Projects List

Gets list of all projects

Parameters

Name Key Required Type Description
object

Returns

Get Resources List

Gets List of all Resources

Parameters

Name Key Required Type Description
object

Returns

Get Tasks List

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

Update a Challenge

Updates an existing Challenge

Parameters

Name Key Required Type Description
Challenge Id
id True uuid

The unique identifier of the challenge

Returns

Update a Key Date

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

Update a Project

Updates the specified Project fields

Parameters

Name Key Required Type Description
Project Id
id True uuid

The unique identifier of the project

Returns

Update a Resource

Updates a Resource

Parameters

Name Key Required Type Description
Resource Id
id True uuid

The unique identifier of the resource

Returns

Update a Task

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

Update an Idea

Updates an existing Idea

Parameters

Name Key Required Type Description
Idea Id
id True uuid

The unique identifier of the idea

Returns

Update an Idea Stage

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

Triggers

Webhook Trigger

When an operation is performed on an entity in PPM Express

Webhook Trigger

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