Utilizzare le API di pianificazione del progetto V2 con Power Automate

Si applica a: Project Operations per scenari basati su risorse/materiali non stoccati, Distribuzione lite: dalla transazione alla fatturazione proforma

Questo articolo descrive un flusso di esempio che mostra come creare una pianificazione del progetto completa utilizzando Microsoft Power Automate, come creare un set di operazioni e come aggiornare un'entità. L'esempio illustra come creare un progetto, un membro del team di progetto, set di operazioni, attività di progetto e assegnazioni di risorse. Questo articolo spiega anche come aggiornare un'entità ed eseguire un set di operazioni.

L'esempio in questo articolo usa l'API PssCreateV2. Per un esempio che utilizza l'API PssCreateV1, vedi Utilizzare le API di pianificazione del progetto V1 con Power Automate.

Ecco un elenco completo dei passaggi documentati nel flusso di esempio in questo articolo:

1. Creare un trigger PowerApps
2. Creare un progetto
3. Inizializzare una variabile per il membro del team
4. Creare un membro del team generico
5. Creare un set di opzioni
6. Creare un bucket di progetto
7. Inizializzare una variabile per il numero di attività
8. Inizializzare una variabile per l'ID attività di progetto
9. Inizializzare una matrice
10. Continua finché
11. Impostare un'attività di progetto
12. Aggiungere un'attività alla matrice
13. Creare un'assegnazione di risorsa
14. Diminuire una variabile
15. Aggiungere attività e assegnazioni al set di operazioni
16. Eseguire un set di opzioni

Presupposti

Questo articolo presuppone che tu abbia una conoscenza di base della piattaforma Dataverse, dei flussi cloud e delle API di pianificazione del progetto. Per ulteriori informazioni, vedi la sezione Riferimenti più avanti in questo articolo.

Crea un flusso

Seleziona un ambiente

È possibile creare il flusso Power Automate nell'ambiente.

1. Vai a https://flow.microsoft.com e usa le credenziali di amministratore per accedere.
2. Nell'angolo superiore destro seleziona Ambienti.
3. Nell'elenco, seleziona l'ambiente in cui Dynamics 365 Project Operations è installato.

Creare una soluzione

Segui questi passaggi per creare un flusso con riconoscimento della soluzione. Creando un flusso con riconoscimento della soluzione, puoi esportare più facilmente il flusso per usarlo in seguito.

1. Nel riquadro di spostamento, seleziona Soluzioni.
2. Nella pagina Soluzioni, seleziona Nuova soluzione.
3. Nella finestra di dialogo Nuova soluzione, imposta i campi obbligatori e quindi seleziona Crea.

Passaggio 1: Creare un trigger PowerApps

1. Nella pagina Soluzioni, sceglie la soluzione creata, quindi seleziona Nuovo.
2. Nel riquadro a sinistra, seleziona Flussi cloud>Automazione>Flusso cloud>Immediato.
3. Nel campo Nome flusso immetti Flusso demo API di pianificazione.
4. Nell'elenco Scegli come attivare questo flusso seleziona Power Apps. Quando crei un trigger Power Apps, la logica dipende da te in qualità di autore. Per l'esempio in questo articolo, lascia vuoti i parametri di input a scopo di test.
5. Seleziona Crea.

Passaggio 2: crea un progetto

Segui questi passaggi per creare un progetto di esempio.

1. Nel flusso che hai creato, seleziona Nuovo passaggio.

   

2. Nella finestra di dialogo Scegli un'operazione, nel campo di ricerca, immetti esegui un'azione non associata. Poi, sulla scheda Azioni seleziona l'operazione nell'elenco dei risultati.

   

3. Nel nuovo passaggio seleziona i puntini di sospensione (…), e quindi Rinomina.

   

4. Rinomina il passaggio Crea progetto.

5. Nel campo Nome azione, seleziona msdyn_CreateProjectV1.

6. Sotto il campo msdyn_subject, seleziona Aggiungi contenuto dinamico.

7. Sulla scheda Espressione, nel campo funzione, immetti concat ("Nome progetto - ",utcNow).

8. Seleziona OK.

Passaggio 3: Inizializzare una variabile per il membro del team

1. Nel flusso, seleziona Nuovo passaggio.
2. Nella finestra di dialogo Scegli un'operazione, nel campo di ricerca, immetti inizializza variabile. Poi, sulla scheda Azioni seleziona l'operazione nell'elenco dei risultati.
3. Nel nuovo passaggio seleziona i puntini di sospensione (…), e quindi Rinomina.
4. Rinomina il passaggio inizializza membro del team.
5. Nel campo Nome immetti TeamMemberAction.
6. Nel campo Tipo seleziona Stringaa.
7. Nel campo Valore immetti msdyn_CreateTeamMemberV1.

Passaggio 4: Creare un membro del team generico

1. Nel flusso, seleziona Nuovo passaggio.

2. Nella finestra di dialogo Scegli un'operazione, nel campo di ricerca, immetti esegui un'azione non associata. Poi, sulla scheda Azioni seleziona l'operazione nell'elenco dei risultati.

3. Nel nuovo passaggio seleziona i puntini di sospensione (…), e quindi Rinomina.

4. Rinomina il passaggio Crea membro del team.

5. Per il campo Nome azione seleziona TeamMemberAction nella la finestra di dialogo Contenuto dinamico.

6. Nel campo Parametri di azione immetti le seguenti informazioni sui parametri.

   {
       "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"
       }
   } 
   

   Ecco una spiegazione dei parametri:

   • @@odata.type: il nome dell'entità. Ad esempio, immetti "Microsoft.Dynamics.CRM.msdyn_projectteam".
   • msdyn_projectteamid: la chiave primaria dell'ID team di progetto. Il valore è un'espressione di identificatore univoco globale (GUID). L'ID viene generato dalla scheda Espressione.
   • msdyn_project@odata.bind: ID progetto del progetto proprietario. Il valore è il contenuto dinamico che deriva dalla risposta del passaggio "Crea progetto". Assicurati di inserire il percorso completo e di aggiungere il contenuto dinamico tra parentesi. Le virgolette sono obbligatorie. Ad esempio, immetti "/msdyn_projects(ADD DYNAMIC CONTENT)".
   • msdyn_name: nome del membro del team. Ad esempio, immetti "ScheduleAPIDemoTM1".

Passaggio 5: Creare un set di opzioni

1. Nel flusso, seleziona Nuovo passaggio.
2. Nella finestra di dialogo Scegli un'operazione, nel campo di ricerca, immetti esegui un'azione non associata. Poi, sulla scheda Azioni seleziona l'operazione nell'elenco dei risultati.
3. Nel nuovo passaggio seleziona i puntini di sospensione (…), e quindi Rinomina.
4. Rinomina il passaggio Crea set di operazioni.
5. Nel campo Nome azione seleziona l'azione personalizzata msdyn_CreateOperationSetV1 di Dataverse.
6. Nel campo Descrizione immetti ScheduleAPIDemoOperationSet.
7. Per il campo Progetto seleziona msdyn_CreateProjectV1Response ProjectId nella finestra di dialogo Contenuto dinamico.

Passaggio 6: Creare un bucket di progetto

1. Nel flusso, seleziona Nuovo passaggio.
2. Nella finestra di dialogo Scegli un'operazione, nel campo di ricerca, immetti aggiungi nuova riga. Poi, sulla scheda Azioni seleziona l'operazione nell'elenco dei risultati.
3. Nel nuovo passaggio seleziona i puntini di sospensione (…), e quindi Rinomina.
4. Rinomina il passaggio Crea bucket.
5. Nel campo Nome tabella, seleziona Bucket di progetto.
6. Nel campo Nome immetti ScheduleAPIDemoBucket1.
7. Nel campo Progetto immetti /msdyn_projects(.
8. Nella finestra di dialogo Contenuto dinamico seleziona msdyn_CreateProjectV1Response ProjectId.
9. Nel campo Progetto immetti ).

Passaggio 7: Inizializzare una variabile per il numero di attività

1. Nel flusso, seleziona Nuovo passaggio.
2. Nella finestra di dialogo Scegli un'operazione, nel campo di ricerca, immetti inizializza variabile. Poi, sulla scheda Azioni seleziona l'operazione nell'elenco dei risultati.
3. Nel nuovo passaggio seleziona i puntini di sospensione (…), e quindi Rinomina.
4. Rinomina il passaggio inizializzare numero di attività.
5. Nel campo Nome immetti numero di attività.
6. Nel campo Tipo seleziona Intero.
7. Nel campo Valore immettere 5.

Passaggio 8: Inizializzare una variabile per l'ID attività di progetto

1. Nel flusso, seleziona Nuovo passaggio.
2. Nella finestra di dialogo Scegli un'operazione, nel campo di ricerca, immetti inizializza variabile. Poi, sulla scheda Azioni seleziona l'operazione nell'elenco dei risultati.
3. Nel nuovo passaggio seleziona i puntini di sospensione (…), e quindi Rinomina.
4. Rinomina il passaggio inizializza ProjectTaskID.
5. Nel campo Nome immetti msdyn_projecttaskid.
6. Nel campo Tipo seleziona Stringaa.
7. Per il campo Valore immetti guid() nel generatore di espressioni.

Passaggio 9: inizializzare una matrice

1. Nel flusso, seleziona Nuovo passaggio.
2. Nella finestra di dialogo Scegli un'operazione, nel campo di ricerca, immetti inizializza variabile. Poi, sulla scheda Azioni seleziona l'operazione nell'elenco dei risultati.
3. Nel nuovo passaggio seleziona i puntini di sospensione (…), e quindi Rinomina.
4. Rinomina il passaggio inizializzare matrice.
5. Nel campo Nome immetti Attività e assegnazioni.
6. Nel campo Tipo seleziona Matrice.

Passaggio 10: Continua finché

1. Nel flusso, seleziona Nuovo passaggio.
2. Nella finestra di dialogo Scegli un'operazione, nel campo di ricerca, immetti continua finché. Poi, sulla scheda Azioni seleziona l'operazione nell'elenco dei risultati.
3. Imposta il primo valore nell'istruzione condizionale sulla variabile numero di attività dalla finestra di dialogo Contenuti dinamici.
4. Imposta la condizione su minore di o uguale a.
5. Imposta il secondo valore nell'istruzione condizionale su 0.

Passaggio 11: Impostare un'attività di progetto

1. Nel flusso, seleziona Aggiungi un'azione.
2. Nella finestra di dialogo Scegli un'operazione, nel campo di ricerca, immetti imposta variabile. Poi, sulla scheda Azioni seleziona l'operazione nell'elenco dei risultati.
3. Nel nuovo passaggio seleziona i puntini di sospensione (…), e quindi Rinomina.
4. Rinomina il passaggio imposta attività di progetto.
5. Nel campo Nome seleziona msdyn_projecttaskid.
6. Per il campo Valore immetti guid() nel generatore di espressioni.

Passaggio 12: aggiungere un'attività alla matrice

1. Nel flusso, seleziona Aggiungi un'azione.

2. Nella finestra di dialogo Scegli un'operazione, nel campo di ricerca, immetti Aggiungi a matrice.

3. Nel passaggio seleziona i puntini di sospensione (…), e quindi Rinomina.

4. Rinominare il passaggio Aggiungere attività a matrice.

5. Nel campo Nome seleziona Attività e assegnazioni.

6. Nel campo Valore immetti le seguenti informazioni sui parametri.

   {
       "@@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"
   }
   

   Ecco una spiegazione dei parametri:

   • @@odata.type: il nome dell'entità. Ad esempio, immetti "Microsoft.Dynamics.CRM.msdyn_projecttask".
   • msdyn_projecttaskid: l'ID univoco dell'attività. Il valore deve essere impostato su una variabile dinamica da msdyn_projecttaskid.
   • msdyn_project@odata.bind: ID progetto del progetto proprietario. Il valore è il contenuto dinamico che deriva dalla risposta del passaggio "Crea progetto". Assicurati di inserire il percorso completo e di aggiungere il contenuto dinamico tra parentesi. Le virgolette sono obbligatorie. Ad esempio, immetti "/msdyn_projects(ADD DYNAMIC CONTENT)".
   • : msdyn_subject: qualsiasi nome di attività.
   • msdyn_projectbucket@odata.bind: il bucket di progetto che contiene le attività. Il valore è il contenuto dinamico che deriva dalla risposta del passaggio "Crea bucket". Assicurati di inserire il percorso completo e di aggiungere il contenuto dinamico tra parentesi. Le virgolette sono obbligatorie. Ad esempio, immetti "/msdyn_projectbuckets(ADD DYNAMIC CONTENT)".
   • msdyn_start: contenuto dinamico per la data di inizio. Ad esempio, domani è rappresentato come "addDays(utcNow(), 1)".
   • msdyn_scheduledstart: data di inizio pianificata. Ad esempio, domani è rappresentato come "addDays(utcNow(), 1)".
   • msdyn_scheduleend: la data di fine pianificata. Seleziona una data futura. Ad esempio, specifica "addDays(utcNow(), 5)".
   • msdyn_LinkStatus: il collegamento alla configurazione della fatturazione. Ad esempio, immetti "192350000" se non è presente alcun collegamento alla configurazione della fatturazione o "192350001" se la configurazione della fatturazione è collegata.

Passaggio 13: Creare un'assegnazione di risorsa

1. Nel flusso, seleziona Aggiungi un'azione.

2. Nella finestra di dialogo Scegli un'operazione, nel campo di ricerca, immetti Aggiungi a matrice.

3. Nel passaggio seleziona i puntini di sospensione (…), e quindi Rinomina.

4. Rinominare il passaggio Aggiungere assegnazione a matrice.

5. Nel campo Nome seleziona Attività e assegnazioni.

6. Nel campo Valore immetti le seguenti informazioni sui parametri.

   {
       "@@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']})"
   }
   

Passaggio 14: Diminuire una variabile

1. Nel flusso, seleziona Aggiungi un'azione.
2. Nella finestra di dialogo Scegli un'operazione, nel campo di ricerca, immetti diminuire variabile. Poi, sulla scheda Azioni seleziona l'operazione nell'elenco dei risultati.
3. Nel campo Nome seleziona numero di attività.
4. Nel campo Valore immettere 1.

Passaggio 15: aggiungere attività e assegnazioni al set di operazioni

1. Nel flusso, seleziona Nuovo passaggio.
2. Nella finestra di dialogo Scegli un'operazione, nel campo di ricerca, immetti esegui un'azione non associata. Poi, sulla scheda Azioni seleziona l'operazione nell'elenco dei risultati.
3. Nel passaggio seleziona i puntini di sospensione (…), e quindi Rinomina.
4. Rinominare il passaggio aggiungere attività e assegnazioni al set di operazioni.
5. Nel campo Nome azione, seleziona msdyn_PssCreateV2.
6. Per il campo OperationSetId, seleziona msdyn_CreateOperationSetV1Response OperationSetId nella finestra di dialogo Contenuto dinamico.
7. Nel campo EntityCollection, seleziona Cambia input su intera matrice.
8. Per il campo EntityCollection seleziona Attività e assegnazioni nella finestra di dialogo Contenuto dinamico.

Passaggio 16: Eseguire un set di opzioni

1. Nel flusso, seleziona Nuovo passaggio.
2. Nella finestra di dialogo Scegli un'operazione, nel campo di ricerca, immetti esegui un'azione non associata. Poi, sulla scheda Azioni seleziona l'operazione nell'elenco dei risultati.
3. Nel passaggio seleziona i puntini di sospensione (…), e quindi Rinomina.
4. Rinomina il passaggio Esegui set di operazioni.
5. Nel campo Nome azione, seleziona msdyn_ExecuteOperationSetV1.
6. Per il campo OperationSetId, seleziona msdyn_CreateOperationSetV1Response OperationSetId nella finestra di dialogo Contenuto dinamico.

Riferimenti

• Panoramica su come integrare i flussi con Dataverse - Power Automate
• Utilizzare le API di pianificazione del progetto per eseguire operazioni con entità di pianificazione
• Panoramica dei flussi cloud - Power Automate
• Panoramica dei flussi con riconoscimento della soluzione - Power Automate