PPM Express (versão prévia)
O PPM Express é um Software de Gerenciamento de Portfólio de Projetos Online. O conector do PPM Express permite que você recupere informações sobre as entidades (Project, Idea, Task, Key Date, Resource) do seu locatário do PPM Express, bem como crie novas ou atualize as existentes.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte do PPM Express |
| URL | https://ppm.express/contact-us/ |
| support@ppm.express |
| Metadados do conector | |
|---|---|
| Publicador | PPM Express Corporation |
| Website | https://ppm.express |
| Política de privacidade | https://ppm.express/privacy-policy |
| Categorias | Gestão de empresas; Business Intelligence |
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave de API | secureString | O token de acesso pessoal do PPM Express | Verdade |
| Região do Locatário | cadeia | A região em que o locatário do PPM Express está hospedado | Verdade |
| Nome do locatário | cadeia | O nome do locatário | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Atualizar um desafio |
Atualiza um desafio existente |
| Atualizar um estágio de ideia |
Atualiza um estágio de ideia |
| Atualizar um projeto |
Atualiza os campos de projeto especificados |
| Atualizar um recurso |
Atualiza um recurso |
| Atualizar uma data de chave |
Atualiza uma data de chave |
| Atualizar uma ideia |
Atualiza uma ideia existente |
| Atualizar uma tarefa |
Atualiza uma tarefa |
| Criar um desafio |
Cria um novo desafio |
| Criar um projeto |
Cria um novo projeto |
| Criar um recurso |
Cria um recurso |
| Criar uma data de chave |
Cria uma nova data de chave |
| Criar uma ideia |
Cria uma nova ideia para o desafio especificado |
| Criar uma tarefa |
Cria uma tarefa para o projeto especificado |
| Obter campos |
Obtém informações de campos para a entidade especificada(por exemplo, Project, Idea, Resource etc) |
| Obter lista de datas-chave |
Obtém a lista de todas as datas de chave para o projeto especificado |
| Obter lista de desafios |
Obtém todos os desafios |
| Obter lista de ideias |
Obtém todas as ideias ou para o desafio especificado |
| Obter lista de projetos |
Obtém a lista de todos os projetos |
| Obter lista de recursos |
Obtém a lista de todos os recursos |
| Obter lista de tarefas |
Obtém a lista de todas as tarefas do projeto especificado |
| Obter o usuário atual |
Obtém informações atuais de usuário e token |
| Obter um desafio |
Obtém um desafio existente por Id |
| Obter um projeto |
Obtém uma ID de Informações do Projeto |
| Obter um recurso |
Obtém um recurso por Id |
| Obter uma data de chave |
Obtém uma informação de data de chave por Id |
| Obter uma ideia |
Obtém uma ideia existente por Id |
| Obter uma tarefa |
Obtém uma tarefa por ID e por Projeto |
Atualizar um desafio
Atualiza um desafio existente
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do desafio
|
id | True | uuid |
O identificador exclusivo do desafio |
Retornos
Atualizar um estágio de ideia
Atualiza um estágio de ideia
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da ideia
|
id | True | uuid |
O identificador exclusivo da ideia |
|
Estágio de Ideias
|
stage | string |
Estágio da Ideia |
Retornos
- Corpo
- IdeaResponseResponse
Atualizar um projeto
Atualiza os campos de projeto especificados
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do projeto
|
id | True | uuid |
O identificador exclusivo do projeto |
Retornos
- Corpo
- ProjectResponseResponse
Atualizar um recurso
Atualiza um recurso
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do recurso
|
id | True | uuid |
O identificador exclusivo do recurso |
Retornos
- Corpo
- ResourceResponseResponse
Atualizar uma data de chave
Atualiza uma data de chave
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do projeto
|
id | True | uuid |
O identificador exclusivo do projeto |
|
KeyDate Id
|
keyDateId | True | uuid |
O identificador exclusivo do KeyDate |
Retornos
- Corpo
- KeyDateResponseResponse
Atualizar uma ideia
Atualiza uma ideia existente
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da ideia
|
id | True | uuid |
O identificador exclusivo da ideia |
Retornos
- Corpo
- IdeaResponseResponse
Atualizar uma tarefa
Atualiza uma tarefa
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do projeto
|
id | True | uuid |
O identificador exclusivo do projeto |
|
ID da tarefa
|
taskId | True | uuid |
O identificador exclusivo da tarefa |
Retornos
- Corpo
- TaskResponseResponse
Criar um desafio
Criar um projeto
Criar um recurso
Criar uma data de chave
Cria uma nova data de chave
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do projeto
|
id | True | uuid |
O identificador exclusivo do projeto |
Retornos
- Corpo
- KeyDateResponseResponse
Criar uma ideia
Cria uma nova ideia para o desafio especificado
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do desafio
|
challengeId | uuid |
A ID do desafio à qual a ideia pertence |
Retornos
- Corpo
- IdeaResponseResponse
Criar uma tarefa
Cria uma tarefa para o projeto especificado
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do projeto
|
id | True | uuid |
O identificador exclusivo do projeto |
Retornos
- Corpo
- TaskResponseResponse
Obter campos
Obtém informações de campos para a entidade especificada(por exemplo, Project, Idea, Resource etc)
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Entidade
|
entity | True | string |
Nome da entidade |
Retornos
- Corpo
- FieldResponseList
Obter lista de datas-chave
Obtém a lista de todas as datas de chave para o projeto especificado
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do projeto
|
id | True | uuid |
O identificador exclusivo do projeto |
Retornos
Obter lista de desafios
Obter lista de ideias
Obtém todas as ideias ou para o desafio especificado
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do desafio
|
challengeId | uuid |
Especificar a ID do desafio |
Retornos
- Corpo
- IdeaResponseListResponse
Obter lista de projetos
Obtém a lista de todos os projetos
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
|
object |
Retornos
Obter lista de recursos
Obtém a lista de todos os recursos
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
|
object |
Retornos
Obter lista de tarefas
Obtém a lista de todas as tarefas do projeto especificado
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do projeto
|
id | True | uuid |
O identificador exclusivo do projeto |
Retornos
- Corpo
- TaskResponseListTask
Obter o usuário atual
Obtém informações atuais de usuário e token
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
|
object |
Retornos
- Corpo
- MeResponseResponse
Obter um desafio
Obtém um desafio existente por Id
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do desafio
|
id | True | uuid |
O identificador exclusivo do desafio |
Retornos
Obter um projeto
Obtém uma ID de Informações do Projeto
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do projeto
|
id | True | uuid |
O identificador exclusivo do projeto |
Retornos
- Corpo
- ProjectResponseResponse
Obter um recurso
Obtém um recurso por Id
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do recurso
|
id | True | uuid |
O identificador exclusivo do recurso |
Retornos
- Corpo
- ResourceResponseResponse
Obter uma data de chave
Obtém uma informação de data de chave por Id
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do projeto
|
id | True | uuid |
O identificador exclusivo do projeto |
|
KeyDate Id
|
keyDateId | True | uuid |
O identificador exclusivo do KeyDate |
Retornos
- Corpo
- KeyDateResponseResponse
Obter uma ideia
Obtém uma ideia existente por Id
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da ideia
|
id | True | uuid |
O identificador exclusivo da ideia |
Retornos
- Corpo
- IdeaResponseResponse
Obter uma tarefa
Obtém uma tarefa por ID e por Projeto
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do projeto
|
id | True | uuid |
O identificador exclusivo do projeto |
|
ID da tarefa
|
taskId | True | uuid |
O identificador exclusivo da tarefa |
Retornos
- Corpo
- TaskResponseResponse
Gatilhos
| Gatilho de webhook |
Quando uma operação é executada em uma entidade no PPM Express |
Gatilho de webhook
Quando uma operação é executada em uma entidade no PPM Express
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Tipos de evento
|
eventTypes | True | array of string |
Selecione os eventos a serem ouvidos |
|
Nome
|
name | string |
Nome do cabeçalho personalizado |
|
|
Value
|
value | string |
Valor do cabeçalho personalizado |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
WebhookId
|
WebhookId | string | |
|
MessageId
|
MessageId | string | |
|
Dados
|
Data | object |
Definições
ChallengeAttributes
Campos de desafio (por exemplo, {"Nome": "Meu Nome", "Descrição": "TBD"})
ChallengeResponse
Detalhes do desafio
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | uuid |
ID do desafio |
|
Attributes
|
attributes | ChallengeAttributes |
Campos de desafio (por exemplo, {"Nome": "Meu Nome", "Descrição": "TBD"}) |
ChallengeResponseListResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | array of ChallengeResponse |
ChallengeResponseResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | ChallengeResponse |
Detalhes do desafio |
FieldResponse
Detalhes do campo
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Key
|
key | string |
Chave de campo |
|
Rótulo de campo
|
label | string |
Rótulo do campo |
|
Tipo de campo
|
type | string |
Tipo do campo |
|
É MultiChoice
|
isMultiChoice | boolean |
É multicodice de campo |
|
É ReadOnly
|
isReadonly | boolean |
É campo somente leitura |
|
Configurações de campo
|
settings | object |
Configurações personalizadas para o campo |
FieldResponseList
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Fields
|
data | array of FieldResponse |
Lista de campos para a entidade selecionada |
IdeaAttributes
Campos de ideia (por exemplo, {"Nome": "Meu Nome", "Descrição": "TBD"})
IdeaResponse
Detalhes da ideia
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da ideia
|
id | uuid |
A ID exclusiva da Ideia |
|
Attributes
|
attributes | IdeaAttributes |
Campos de ideia (por exemplo, {"Nome": "Meu Nome", "Descrição": "TBD"}) |
|
Votos
|
votes | integer |
Número de votos para a ideia |
IdeaResponseListResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Ideias
|
data | array of IdeaResponse |
Lista de ideias |
IdeaResponseResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | IdeaResponse |
Detalhes da ideia |
KeyDateAttributes
Campos de Data da Chave (por exemplo, {"Nome": "Meu Nome", "Descrição": "TBD"})
KeyDateResponse
Detalhes da Data da Chave
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
KeyDate Id
|
id | uuid |
Identificador exclusivo da Data da Chave |
|
Campos KeyDate
|
attributes | KeyDateAttributes |
Campos de Data da Chave (por exemplo, {"Nome": "Meu Nome", "Descrição": "TBD"}) |
|
Tipo de origem
|
sourceType | SourceType |
Tipo de fonte de dados |
KeyDateResponseListResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | array of KeyDateResponse |
KeyDateResponseResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | KeyDateResponse |
Detalhes da Data da Chave |
MeResponse
Detalhes do utilizador
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Identificação de usuário
|
id | uuid |
Identificador exclusivo do usuário |
|
Conta de logon
|
logonAccount | string |
Conta de Logon do Usuário |
|
Email
|
string |
Email do Usuário |
|
|
símbolo
|
token | TokenInfo |
MeResponseResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | MeResponse |
Detalhes do utilizador |
ProjectAttributes
Campos de projeto (por exemplo, {"Name": "My Name", "Description": "TBD"})
ProjectResponse
Detalhes do projeto
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID do projeto
|
id | uuid |
Identificador exclusivo do projeto |
|
Campos do Project
|
attributes | ProjectAttributes |
Campos de projeto (por exemplo, {"Name": "My Name", "Description": "TBD"}) |
ProjectResponseListResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Projetos
|
data | array of ProjectResponse |
Lista de projetos |
ProjectResponseResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | ProjectResponse |
Detalhes do projeto |
ResourceAttributes
Campos de recurso (por exemplo, {"Nome": "Meu Nome", "Descrição": "TBD"})
ResourceResponse
Detalhes do recurso
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Identificador de recurso exclusivo
|
id | uuid |
ID do recurso |
|
Campos de recursos
|
attributes | ResourceAttributes |
Campos de recurso (por exemplo, {"Nome": "Meu Nome", "Descrição": "TBD"}) |
ResourceResponseListResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Recursos
|
data | array of ResourceResponse |
Lista de recursos |
ResourceResponseResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | ResourceResponse |
Detalhes do recurso |
Tipo de Fonte
BaselineData
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
date
|
date | date-time | |
|
startDate
|
startDate | date-time | |
|
data de vencimento
|
dueDate | date-time | |
|
duration
|
duration | integer | |
|
Esforço
|
effort | double | |
|
originalEstimate
|
originalEstimate | double |
TaskAttributes
Campos de tarefa (por exemplo, {"Nome": "Meu Nome", "Descrição": "TBD"})
TaskResponse
Detalhes de tarefa
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
ID da tarefa
|
id | uuid |
Identificador de tarefa exclusivo |
|
Campos de tarefa
|
attributes | TaskAttributes |
Campos de tarefa (por exemplo, {"Nome": "Meu Nome", "Descrição": "TBD"}) |
|
Tipo de origem
|
sourceType | SourceType |
Tipo de fonte de dados |
|
linha de base
|
baseline | BaselineData |
TaskResponseListTask
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Tasks
|
data | array of TaskResponse |
Lista de tarefas |
TaskResponseResponse
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
dados
|
data | TaskResponse |
Detalhes de tarefa |
TokenInfo
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Token Id
|
id | uuid |
Identificador de token exclusivo |
|
Nome do token
|
name | string |
Nome do Token de API |
|
Data de validade do token
|
expirationDate | date-time |
Data de validade do Token de API |
|
Escopos
|
scopes | array of string |
Matriz de ações permitidas |