Usar APIs de agendamento do projeto V1 com o Power Automate

Aplica-se a: Project Operations para cenários baseados em recursos/não estocados, Implantação leve – gerenciar faturamento pro forma

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

O exemplo neste artigo usa a API PssCreateV1. Para obter um exemplo que use a API PssCreateV2, consulte APIs de agendamento do projeto V2 com o Power Automate.

Aqui esta é uma lista completa das etapas documentadas no fluxo de amostra neste artigo:

1. Criar um gatilho do Power Apps
2. Criar um projeto
3. Inicializar uma variável para o membro da equipe
4. Criar um membro da equipe genérico
5. Criar um Conjunto de Operações
6. Inicializar uma variável para a ID do bucket do projeto
7. Criar um bucket do projeto
8. Inicializar uma variável para o número de tarefas
9. Inicializar uma variável para a ID da tarefa do projeto
10. Fazer até
11. Definir uma tarefa do projeto
12. Criar uma tarefa do projeto
13. Criar uma atribuição de recurso
14. Diminuir uma variável
15. Renomear uma tarefa do projeto
16. Executar um Conjunto de Operações

Suposições

Este artigo pressupõe que você tenha um conhecimento básico da plataforma Dataverse, dos fluxos da nuvem e da API do agendamento de projetos. Para obter mais informações, consulte a seção Referências mais adiante neste artigo.

Criar um fluxo

Selecionar um ambiente

Você pode criar o fluxo do Power Automate em seu ambiente.

1. Vá para https://flow.microsoft.com e use suas credenciais de administrador para entrar.
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 estas etapas para criar um fluxo com reconhecimento de solução. Ao criar um fluxo com reconhecimento de solução, você pode exportar o fluxo com mais facilidade para usá-lo posteriormente.

1. No painel de navegação, 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 obrigatórios e selecione Criar.

Etapa 1: Criar um gatilho do Power Apps

1. Na página Soluções, selecione a solução que você criou e selecione Novo.
2. No painel esquerdo, selecione Fluxos da nuvem>Automação>Fluxo da nuvem>Instantâneo.
3. No campo Nome do fluxo, insira Fluxo de Demonstração da API de Agendamento.
4. Na lista Escolher como disparar este fluxo, selecione Power Apps. Quando você cria um gatilho do Power Apps, a lógica depende de você como autor. Para o exemplo neste artigo, deixe os parâmetros de entrada em branco para fins de teste.
5. Selecione Criar.

Etapa 2: criar um projeto

Siga estas etapas para criar um projeto de amostra.

1. No fluxo que você criou, selecione Nova etapa.

   

2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, insira executar uma ação não associada. Então, na guia Ações, selecione a operação na lista de resultados.

   

3. Na nova etapa, selecione as reticências (…) e Renomear.

   

4. Renomeie a etapa Criar Projeto.

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

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

7. Na guia Expressão, no campo de função, insira concat('Project name - ',utcNow()).

8. Selecione OK.

Etapa 3: Inicializar uma variável para o membro da equipe

1. No fluxo, selecione Nova etapa.
2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, insira inicializar variável. Então, na guia Ações, selecione a operação na lista de resultados.
3. Na nova etapa, selecione as reticências (…) e Renomear.
4. Renomeie a etapa Inicializar membro da equipe.
5. No campo Nome, insira TeamMemberAction.
6. No campo Tipo, selecione Cadeia de caracteres.
7. No campo Valor, insira msdyn_CreateTeamMemberV1.

Etapa 4: Criar um membro da equipe genérico

1. No fluxo, selecione Nova etapa.

2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, insira executar uma ação não associada. Então, na guia Ações, selecione a operação na lista de resultados.

3. Na nova etapa, selecione as reticências (…) e Renomear.

4. Renomeie a etapa Criar Membro da Equipe.

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

6. No campo Parâmetros da Ação, insira 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"
       }
   } 
   

   Aqui está uma explicação dos parâmetros:

   • @@odata.type – o nome da entidade. Por exemplo, insira "Microsoft.Dynamics.CRM.msdyn_projectteam".
   • msdyn_projectteamid – a chave primária da ID da equipe do projeto. O valor é uma expressão de identificador global exclusivo (GUID). A ID é gerada a partir da guia de expressão.
   • msdyn_project@odata.bind – a ID do projeto do projeto proprietário. O valor é o conteúdo dinâmico obtido da resposta da etapa "Criar projeto". Certifique-se de inserir o caminho completo e adicionar conteúdo dinâmico entre os parênteses. As aspas são obrigatórias. Por exemplo, insira "/msdyn_projects(ADD DYNAMIC CONTENT)".
   • msdyn‑name – o nome do membro da equipe. Por exemplo, insira "ScheduleAPIDemoTM1".

Etapa 5: Criar um Conjunto de Operações

1. No fluxo, selecione Nova etapa.
2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, insira executar uma ação não associada. Então, na guia Ações, selecione a operação na lista de resultados.
3. Na nova etapa, selecione as reticências (…) e Renomear.
4. Renomeie a etapa Criar um Conjunto de Operações.
5. No campo Nome da Ação, selecione a ação personalizada msdyn_CreateOperationSetV1 do Dataverse.
6. No campo Descrição, insira ScheduleAPIDemoOperationSet.
7. No campo Projeto, na caixa de diálogo Conteúdo dinâmico, selecione msdyn_CreateProjectV1Response ProjectId.

Etapa 6: Inicializar uma variável para ID do bucket do projeto

1. No fluxo, selecione Nova etapa.
2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, insira inicializar variável. Então, na guia Ações, selecione a operação na lista de resultados.
3. Na nova etapa, selecione as reticências (…) e Renomear.
4. Renomeie a etapa Inicializar ID do bucket do projeto.
5. No campo Nome, insira ID do bucket do projeto.
6. No campo Tipo, selecione Cadeia de caracteres.
7. No campo Valor, insira @{guid()}.

Etapa 7: Criar um bucket do projeto

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

2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, insira executar uma ação não associada. Então, na guia Ações, selecione a operação na lista de resultados.

3. Na etapa, selecione as reticências (…) e Renomear.

4. Renomeie a etapa Criar Bucket.

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

6. No campo Entidade, insira as seguintes informações de parâmetros.

   {
       "@@odata.type": "Microsoft.Dynamics.CRM.msdyn_projectbucket",
       "msdyn_projectbucketid": "@{variables('project bucket id')}",
       "msdyn_name": "ScheduleAPIDemoBucket1",
       "msdyn_project@odata.bind": "/msdyn_projects(@{outputs('Create_Project')?['body/ProjectId']})",
   }
   

   Aqui está uma explicação dos parâmetros:

   • @@odata.type – o nome da entidade. Por exemplo, insira "Microsoft.Dynamics.CRM.msdyn_projectbucket".
   • msdyn_projectbucketid – A ID exclusiva do bucket do projeto. O valor deve ser definido a partir da variável dinâmica da etapa 6.
   • msdyn_project@odata.bind – a ID do projeto do projeto proprietário. O valor é o conteúdo dinâmico obtido da resposta da etapa "Criar projeto". Certifique-se de inserir o caminho completo e adicionar conteúdo dinâmico entre os parênteses. As aspas são obrigatórias. Por exemplo, insira "/msdyn_projects(ADD DYNAMIC CONTENT)".
   • msdyn_name – o nome do bucket do projeto.

7. No campo OperationSetId, selecione msdyn_CreateOperationSetV1Response OperationSetId na caixa de diálogo Conteúdo dinâmico.

Etapa 8: Inicializar uma variável para o número de tarefas

1. No fluxo, selecione Nova etapa.
2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, insira inicializar variável. Então, na guia Ações, selecione a operação na lista de resultados.
3. Na nova etapa, selecione as reticências (…) e Renomear.
4. Renomeie a etapa Inicializar Número de tarefas.
5. No campo Nome, insira número de tarefas.
6. No campo Tipo, selecione Inteiro.
7. No campo Valor, insira 5.

Etapa 9: Inicializar uma variável para a ID da tarefa do projeto

1. No fluxo, selecione Nova etapa.
2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, insira inicializar variável. Então, na guia Ações, selecione a operação na lista de resultados.
3. Na nova etapa, selecione as reticências (…) e Renomear.
4. Renomeie a etapa Inicializar ProjectTaskID.
5. No campo Nome, insira msdyn_projecttaskid.
6. No campo Tipo, selecione Cadeia de caracteres.
7. Para o campo Valor, insira guid() no Construtor de Expressões.

Etapa 10: Fazer até

1. No fluxo, selecione Nova etapa.
2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, insira fazer até. Então, na guia Ações, selecione a operação na lista de resultados.
3. Defina o primeiro valor na instrução condicional para a variável número de tarefas da caixa de diálogo Conteúdo dinâmico.
4. Defina a condição como menor ou igual a.
5. Defina o segundo valor na instrução condicional como 0.

Etapa 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, insira definir variável. Então, na guia Ações, selecione a operação na lista de resultados.
3. Na nova etapa, selecione as reticências (…) e Renomear.
4. Renomeie a etapa Definir Tarefa do Projeto.
5. No campo Nome, selecione msdyn_projecttaskid.
6. Para o campo Valor, insira guid() no Construtor de Expressões.

Etapa 12: Criar uma tarefa do projeto

Siga estas etapas para criar uma tarefa do projeto com uma ID exclusiva que pertence ao projeto atual e ao bucket do projeto que você criou.

1. No fluxo, selecione Nova etapa.

2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, insira executar uma ação não associada. Então, na guia Ações, selecione a operação na lista de resultados.

3. Na etapa, selecione as reticências (…) e Renomear.

4. Renomeie a etapa Criar Tarefa do Projeto.

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

6. No campo Entidade, insira 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(@{variables('project bucket id')})",
       "msdyn_start": "@{addDays(utcNow(), 1)}",
       "msdyn_scheduledstart": "@{utcNow()}",
       "msdyn_scheduledend": "@{addDays(utcNow(), 5)}"
   }
   

   Aqui está uma explicação dos parâmetros:

   • @@odata.type – o nome da entidade. Por exemplo, insira "Microsoft.Dynamics.CRM.msdyn_projecttask".
   • msdyn_projecttaskid – a ID exclusiva da tarefa. O valor deve ser definido para uma variável dinâmica de msdyn_projecttaskid.
   • msdyn_project@odata.bind – a ID do projeto do projeto proprietário. O valor é o conteúdo dinâmico obtido da resposta da etapa "Criar projeto". Certifique-se de inserir o caminho completo e adicionar conteúdo dinâmico entre os parênteses. As aspas são obrigatórias. Por exemplo, insira "/msdyn_projects(ADD DYNAMIC CONTENT)".
   • msdyn_subject – qualquer nome de tarefa.
   • msdyn_projectbucket@odata.bind – o bucket do projeto que contém as tarefas. O valor é o mesmo usado para definir o msdyn_projectbucketid na etapa "Criar bucket". Certifique-se de inserir o caminho completo e adicionar conteúdo dinâmico entre os parênteses. As aspas são obrigatórias. Por exemplo, insira "/msdyn_projectbuckets(ADICIONAR CONTEÚDO DINÂMICO)".
   • msdyn_start – conteúdo dinâmico para a data de início. Por exemplo, amanhã é representado como "addDays(utcNow(), 1)".
   • msdyn_scheduledstart – a data de início agendada. Por exemplo, amanhã é representado como "addDays(utcNow(), 1)".
   • msdyn_scheduleend – a data de término agendada. Selecione uma data no futuro. Por exemplo, especifique "addDays(utcNow(), 5)".
   • msdyn_LinkStatus – o status do link. Por exemplo, insira "192350000".

7. No campo OperationSetId, selecione msdyn_CreateOperationSetV1Response OperationSetId na caixa de diálogo Conteúdo dinâmico.

Etapa 13: Criar uma atribuição de recurso

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

2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, insira executar uma ação não associada. Então, na guia Ações, selecione a operação na lista de resultados.

3. Na etapa, selecione as reticências (…) e Renomear.

4. Renomeie a etapa Criar Atribuição.

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

6. No campo Entidade, insira 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']})"
   }
   

7. No campo OperationSetId, selecione msdyn_CreateOperationSetV1Response OperationSetId na caixa de diálogo Conteúdo dinâmico.

Etapa 14: Diminuir uma variável

1. No fluxo, selecione Nova etapa.
2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, insira diminuir variável. Então, na guia Ações, selecione a operação na lista de resultados.
3. No campo Nome, selecione número de tarefas.
4. No campo Valor, insira 1.

Etapa 15: Renomear uma tarefa do projeto

1. No fluxo, selecione Nova etapa.

2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, insira executar uma ação não associada. Então, na guia Ações, selecione a operação na lista de resultados.

3. Na etapa, selecione as reticências (…) e Renomear.

4. Renomeie a etapa Renomear Tarefa do Projeto.

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

6. No campo Entidade, insira as seguintes informações de parâmetros.

   {
       "@@odata.type": "Microsoft.Dynamics.CRM.msdyn_projecttask",
       "msdyn_projecttaskid": "@{variables('msdyn_projecttaskid')}",
       "msdyn_subject": "ScheduleDemoTask1-UpdatedName"
   }
   

7. No campo OperationSetId, selecione msdyn_CreateOperationSetV1Response OperationSetId na caixa de diálogo Conteúdo dinâmico.

Etapa 16: Executar um Conjunto de Operações

1. No fluxo, selecione Nova etapa.
2. Na caixa de diálogo Escolher uma operação, no campo de pesquisa, insira executar uma ação não associada. Então, na guia Ações, selecione a operação na lista de resultados.
3. Na etapa, selecione as reticências (…) e Renomear.
4. Renomeie a etapa Executar um Conjunto de Operações.
5. No campo Nome da Ação, selecione msdyn_ExecuteOperationSetV1.
6. No campo OperationSetId, selecione msdyn_CreateOperationSetV1Response OperationSetId na caixa de diálogo Conteúdo dinâmico.

Referências

• Visão geral de como integrar fluxos com o Dataverse - Power Automate
• Use APIs de agendamento do Project para realizar operações com entidades de Agendamento
• Visão geral dos fluxos da nuvem - Power Automate
• Visão geral dos fluxos com reconhecimento de solução - Power Automate