Utilizar APIs de agenda do Projeto V2 com o Power Automate

Aplica-se A: Project Operations para cenários baseados em recursos/não armazenados, implementação Lite — negócio para faturação pró-forma

Este artigo descreve um fluxo de amostra que mostra como criar um plano de projeto completo com o Microsoft Power Automate, como criar um Conjunto de Operações e como atualizar uma entidade. O exemplo mostra como criar um projeto, membro da equipa do projeto, Conjuntos de Operações, tarefas de projeto e atribuições de recursos. Este artigo explica também como atualizar uma entidade e executar um Conjunto de Operações.

O exemplo neste artigo utiliza a API PssCreateV2. Para um exemplo que utiliza a API PssCreateV1, consulte Utilizar APIs de agenda do Projeto V1 com o Power Automate.

Segue-se uma lista completa dos passos documentados no fluxo de amostra neste artigo:

1. Criar um acionador PowerApps
2. Criar um projeto
3. Iniciar uma variável para o membro da equipa
4. Criar um mebro de equipa genérico
5. Criar um Conjunto de operações
6. Criar um registo de projeto
7. Iniciar uma variável para o número de tarefas
8. Iniciar uma variável para o ID de tarefas do projeto
9. Inicializar uma matriz
10. Fazer até
11. Definir uma tarefa do projeto
12. Adicionar uma tarefa à matriz
13. Criar uma atribuição de recursos
14. Reduzir uma variável
15. Adicionar Tarefas e Atribuições ao Conjunto de Operações
16. Executar um Conjunto de operações

Suposições

Este artigo supõe que tem conhecimentos básicos sobre a plataforma Dataverse, os fluxos de cloud e a API da Agenda do Projeto. Para mais informações, consulte a secção Referências mais à frente neste artigo.

Criar um fluxo

Selecionar um ambiente

É possível criar o fluxo Power Automate no seu ambiente.

1. Aceda a https://flow.microsoft.com e use as suas credenciais de administrador para iniciar sessão.
2. No canto superior direito, selecione Ambientes.
3. Na lista, selecione o ambiente em que o Dynamics 365 Project Operations está instalado.

Criar uma solução

Siga estes passos para criar um fluxo consciente da solução. Ao criar um fluxo consciente da solução, pode exportar mais facilmente o fluxo para o utilizar mais tarde.

1. No painel de navegação esquerdo, selecione Soluções.
2. Na página Soluções, selecione Nova solução.
3. Na caixa de diálogo Nova solução, defina os campos necessários e, em seguida, selecione Criar.

Passo 1: criar um acionador PowerApps

1. Na página Soluções, selecione a solução que criou e, em seguida, selecione Novo.
2. No painel esquerdo, selecione Fluxos de cloud>Automatização>Fluxo de cloud>Instantâneo.
3. No campo Nome do fluxo, introduza Fluxo de demonstração da API da agenda.
4. Na lista Escolher como acionar este fluxo, selecione Power Apps. Quando cria um acionador Power Apps, a lógica é da sua responsabilidade como autor. Para o exemplo neste artigo, deixe os parâmetros de entrada em branco para efeitos de teste.
5. Selecione Criar.

Passo 2: Criar um projeto

Siga estes passos para criar um projeto de amostra.

1. No fluxo que criou, selecione Novo passo.

   

2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, introduza Executar uma ação sem restrições . Em seguida, no separador Ações, selecione a operação na lista de resultados.

   

3. No novo passo, selecione as reticências (...) e, em seguida, selecione Renomear.

   

4. Renomear o passo Criar Projeto.

5. No campo Nome da Ação, selecione msdyn_CreateProjectV1.

6. Por baixo do campo msdyn_subject, selecione Adicionar conteúdo dinâmico.

7. No separador Expressão, no campo função, introduza concat('Nome do projeto - ',utcNow()).

8. Selecione OK.

Passo 3: iniciar uma variável para o membro da equipa

1. No fluxo, selecione Novo passo.
2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, introduza iniciar variável . Em seguida, no separador Ações, selecione a operação na lista de resultados.
3. No novo passo, selecione as reticências (...) e, em seguida, selecione Renomear.
4. Renomear o passo Iniciar membro da equipa.
5. No campo Nome, introduza TeamMemberAction.
6. No campo Tipo, selecione Cadeia.
7. No campo Valor, introduza msdyn_CreateTeamMemberV1.

Passo 4: criar um membro da equipa genérico

1. No fluxo, selecione Novo passo.

2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, introduza Executar uma ação sem restrições . Em seguida, no separador Ações, selecione a operação na lista de resultados.

3. No novo passo, selecione as reticências (...) e, em seguida, selecione Renomear.

4. Renomear o passo Criar membro da equipa.

5. Para o campo Nome da ação, selecione TeamMemberAction na caixa de diálogo Conteúdo dinâmico.

6. No campo Parâmetros de Ação, introduza as seguintes informações de parâmetros.

   {
       "TeamMember": {
           "@@odata.type": "Microsoft.Dynamics.CRM.msdyn_projectteam",
           "msdyn_projectteamid": "@{guid()}",
           "msdyn_project@odata.bind": "/msdyn_projects(@{outputs('Create_Project')?['body/ProjectId']})",
           "msdyn_name": "ScheduleAPIDemoTM1"
       }
   } 
   

   Eis uma explicação dos parâmetros:

   • @@odata.type – O nome da entidade. Por exemplo, introduza "Microsoft.Dynamics.CRM.msdyn_projectteam".
   • msdyn_projectteamid – A chave primária do ID da equipa de projeto. O valor é uma expressão de identificador exclusivo global (GUID). O ID é gerado a partir do separador Expressão.
   • msdyn_project@odata.bind – O ID de projeto do projeto proprietário. O valor tem conteúdo dinâmico, que vem da resposta do passo "Criar Projeto". Certifique-se de que introduz o caminho completo e adiciona conteúdo dinâmico entre os parênteses. São necessárias aspas. Introduza, por exemplo "/msdyn_projects(ADD DYNAMIC CONTENT)".
   • msdyn_name – O nome do membro da equipa. Introduza, por exemplo "ScheduleAPIDemoTM1".

Passo 5: criar um Conjunto de operações

1. No fluxo, selecione Novo passo.
2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, introduza Executar uma ação sem restrições . Em seguida, no separador Ações, selecione a operação na lista de resultados.
3. No novo passo, selecione as reticências (...) e, em seguida, selecione Renomear.
4. Renomear o passo Criar conjunto de operações.
5. No campo Nome da Ação, selecione a ação personalizada msdynCreateOperationSetV1 do Dataverse.
6. No campo Descrição, introduza ScheduleAPIDemoOperationSet.
7. Para o campo Projeto, selecione msdynCreateProjectV1Response ProjectId na caixa de diálogo Conteúdo dinâmico.

Passo 6: criar um registo de projeto

1. No fluxo, selecione Novo passo.
2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, introduza adicionar nova linha . Em seguida, no separador Ações, selecione a operação na lista de resultados.
3. No novo passo, selecione as reticências (...) e, em seguida, selecione Renomear.
4. Renomear o passo Criar registo.
5. No campo Nome da tabela, selecione Registos de projeto.
6. No campo Nome, introduza ScheduleAPIDemoBucket1.
7. No campo Projeto, introduza /msdyn_projects(.
8. Na caixa de diálogo Conteúdo dinâmico, selecione msdynCreateProjectV1Response ProjectId.
9. No campo Projeto, introduza ).

Passo 7: iniciar uma variável para o número de tarefas

1. No fluxo, selecione Novo passo.
2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, introduza iniciar variável . Em seguida, no separador Ações, selecione a operação na lista de resultados.
3. No novo passo, selecione as reticências (...) e, em seguida, selecione Renomear.
4. Renomear o passo Iniciar número de tarefas.
5. No campo Nome, introduza número de tarefas.
6. No campo Tipo, selecione Número inteiro.
7. No campo Valor, introduza 5.

Passo 8: iniciar uma variável para o ID de tarefas do projeto

1. No fluxo, selecione Novo passo.
2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, introduza iniciar variável . Em seguida, no separador Ações, selecione a operação na lista de resultados.
3. No novo passo, selecione as reticências (...) e, em seguida, selecione Renomear.
4. Renomear o passo Iniciar ProjectTaskID.
5. No campo Nome, introduza msdyn_projecttaskid.
6. No campo Tipo, selecione Cadeia.
7. Para o campo Valor, introduza guid() no construtor de expressões.

Passo 9: Inicializar uma matriz

1. No fluxo, selecione Novo passo.
2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, introduza iniciar variável . Em seguida, no separador Ações, selecione a operação na lista de resultados.
3. No novo passo, selecione as reticências (...) e, em seguida, selecione Renomear.
4. Renomear o passo Iniciar Matriz.
5. No campo Nome, introduza Tarefas e Atribuições.
6. No campo Tipo, selecione Matriz.

Passo 10: fazer até

1. No fluxo, selecione Novo passo.
2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, introduza fazer até . Em seguida, no separador Ações, selecione a operação na lista de resultados.
3. Defina o primeiro valor na instrução condicional com o número de tarefas variável da caixa de diálogo Conteúdo dinâmico.
4. Defina a condição para menos do que igual a.
5. Defina o segundo valor na instrução condicional como 0.

Passo 11: definir uma tarefa do projeto

1. No fluxo, selecione Adicionar uma ação.
2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, introduza definir variável . Em seguida, no separador Ações, selecione a operação na lista de resultados.
3. No novo passo, selecione as reticências (...) e, em seguida, selecione Renomear.
4. Renomear o passo Definir tarefa do projeto.
5. No campo Nome, selecione msdyn_projecttaskid.
6. Para o campo Valor, introduza guid() no construtor de expressões.

Passo 12: Adicionar uma tarefa à matriz

1. No fluxo, selecione Adicionar uma ação.

2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, introduza Acrescentar como matriz .

3. No passo, selecione as reticências (...) e, em seguida, selecione Renomear.

4. Mude o nome do passo Adicionar Tarefa à Matriz.

5. No campo Nome, selecione Tarefas e Atribuições.

6. No campo Valor, introduza as seguintes informações de parâmetros.

   {
       "@@odata.type": "Microsoft.Dynamics.CRM.msdyn_projecttask",
       "msdyn_projecttaskid": "@{variables('msdyn_projecttaskid')}",
       "msdyn_project@odata.bind": "/msdyn_projects(@{outputs('Create_Project')?['body/ProjectId']})",
       "msdyn_subject": "ScheduleAPIDemoTask1",
       "msdyn_projectbucket@odata.bind": "/msdyn_projectbuckets(@{outputs('Create_Bucket')?['body/msdyn_projectbucketid']})",
       "msdyn_start": "@{addDays(utcNow(), 1)}",
       "msdyn_scheduledstart": "@{utcNow()}",
       "msdyn_scheduledend": "@{addDays(utcNow(), 5)}",
       "msdyn_LinkStatus": "192350000"
   }
   

   Eis uma explicação dos parâmetros:

   • @@odata.type – O nome da entidade. Por exemplo, introduza "Microsoft.Dynamics.CRM.msdyn_projecttask".
   • msdyn_projecttaskid – O ID exclusivo da tarefa. O valor deve ser definido como uma variável dinâmica a partir de msdynprojecttaskid.
   • msdyn_project@odata.bind – O ID de projeto do projeto proprietário. O valor tem conteúdo dinâmico, que vem da resposta do passo "Criar Projeto". Certifique-se de que introduz o caminho completo e adiciona conteúdo dinâmico entre os parênteses. São necessárias aspas. Introduza, por exemplo "/msdyn_projects(ADD DYNAMIC CONTENT)".
   • msdyn_subject – Qualquer nome de tarefa.
   • msdyn_projectbucket@odata.bind – O registo de projeto que contém as tarefas. O valor tem conteúdo dinâmico, que vem da resposta do passo "Criar Registo". Certifique-se de que introduz o caminho completo e adiciona conteúdo dinâmico entre os parênteses. São necessárias aspas. Introduza, por exemplo "/msdyn_projectbuckets(ADD DYNAMIC CONTENT)".
   • msdyn_start – Conteúdo dinâmico para a data de início. Por exemplo, amanhã será representado como "addDays(utcNow(), 1)".
   • msdyn_scheduledstart – A data de início agendada. Por exemplo, amanhã será representado como "addDays(utcNow(), 1)".
   • msdyn_scheduleend – A data de fim agendada. Selecione uma data no futuro. Por exemplo, especifique "addDays(utcNow(), 5)".
   • msdyn_LinkStatus – A ligação para a configuração da faturação. Por exemplo, introduza "192350000" se não existir ligação à configuração da faturação ou "192350001" se a configuração da faturação estiver associada.

Passo 13: Criar uma atribuição de recursos

1. No fluxo, selecione Adicionar uma ação.

2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, introduza Acrescentar como Matriz .

3. No passo, selecione as reticências (...) e, em seguida, selecione Renomear.

4. Mude o nome do passo Adicionar Atribuição à Matriz.

5. No campo Nome, selecione Tarefas e Atribuições.

6. No campo Valor, introduza as seguintes informações de parâmetros.

   {
       "@@odata.type": "Microsoft.Dynamics.CRM.msdyn_resourceassignment",
       "msdyn_resourceassignmentid": "@{guid()}",
       "msdyn_name": "ScheduleAPIDemoAssign1",
       "msdyn_taskid@odata.bind": "/msdyn_projecttasks(@{variables('msdyn_projecttaskid')})",
       "msdyn_projectteamid@odata.bind": "/msdyn_projectteams(@{outputs('Create_Team_Member')?['body/TeamMemberId']})",
       "msdyn_projectid@odata.bind": "/msdyn_projects(@{outputs('Create_Project')?['body/ProjectId']})"
   }
   

Passo 14: reduzir uma variável

1. No fluxo, selecione Adicionar uma ação.
2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, introduza reduzir variável . Em seguida, no separador Ações, selecione a operação na lista de resultados.
3. No campo Nome, selecione número de tarefas.
4. No campo Valor, introduza 1.

Passo 15: Adicionar Tarefas e Atribuições ao Conjunto de Operações

1. No fluxo, selecione Novo passo.
2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, introduza Executar uma ação sem restrições . Em seguida, no separador Ações, selecione a operação na lista de resultados.
3. No passo, selecione as reticências (...) e, em seguida, selecione Renomear.
4. Mude o nome do passo Adicionar Tarefas e Atribuições ao Conjunto de Operações.
5. No campo Nome da Ação, selecione msdyn_PssCreateV2.
6. Para o campo OperationSetId, selecione msdyn_CreateOperationSetV1Response OperationSetId na caixa de diálogo Conteúdo dinâmico.
7. No campo EntityCollection, selecione Mudar entrada para Toda a Matriz.
8. Para o campo EntityCollection, selecione Tarefas e Atribuições na caixa de diálogo Conteúdo dinâmico.

Passo 16: executar um Conjunto de operações

1. No fluxo, selecione Novo passo.
2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, introduza Executar uma ação sem restrições . Em seguida, no separador Ações, selecione a operação na lista de resultados.
3. No passo, selecione as reticências (...) e, em seguida, selecione Renomear.
4. Renomear o passo Executar conjunto de operações.
5. No campo Nome da Ação, selecione msdyn_ExecuteOperationSetV1.
6. Para o campo OperationSetId, selecione msdyn_CreateOperationSetV1Response OperationSetId na caixa de diálogo Conteúdo dinâmico.

Referências

• Descrição geral de como integrar fluxos com o Dataverse - Power Automate
• Utilizar APIs de Agenda do Project para executar operações com entidades de Agendamento
• Vista global dos fluxos da cloud - Power Automate
• Visão geral dos fluxos conscientes da solução - Power Automate