Utilizzare le API di pianificazione dei progetti V1 con Power Automate

  • Articolo

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 mostra 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 PssCreateV1. Per un esempio che utilizza l'API PssCreateV2, vedi Utilizzare le API di pianificazione del progetto V2 con Power Automate.

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

  1. Creare un trigger Power Apps
  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. Inizializzare una variabile per l'ID del bucket di progetto
  7. Creare un bucket di progetto
  8. Inizializzare una variabile per il numero di attività
  9. Inizializzare una variabile per l'ID attività di progetto
  10. Continua finché
  11. Impostare un'attività di progetto
  12. Creare un'attività di progetto
  13. Creare un'assegnazione di risorsa
  14. Diminuire una variabile
  15. Rinominare un'attività di progetto
  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 Power Apps

  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.

    Aggiunta di un 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.

    Selezione di un'operazione.

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

    Ridenominazinoe di un passaggio.

  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 dell'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. Nel campo Progetto, dalla finestra di dialogo Contenuto dinamico, seleziona msdyn_CreateProjectV1Response ProjectId.

Passaggio 6: Inizializzare una variabile per l'ID del bucket 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 Inizializzare l'ID del bucket di Project.
  5. Nel campo Nome immetti id bucket project.
  6. Nel campo Tipo seleziona Stringaa.
  7. Nel campo Valore immetti @{guid()}.

Passaggio 7: Creare un bucket di progetto

  1. Nel flusso, seleziona Aggiungi un'azione.

  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 Crea bucket.

    1. Nel campo Nome azione, seleziona msdyn_PssCreateV1.

  6. Nel campo Entità immetti le seguenti informazioni sui parametri.

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

    Ecco una spiegazione dei parametri:

    • @@odata.type – Il nome dell'entità. Ad esempio, immetti "Microsoft.Dynamics.CRM.msdyn_projectbucket".
    • msdyn_projectbucketid: l'ID univoco del bucket di progetto. Il valore deve essere impostato da una variabile dinamica dal passaggio 6.
    • 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: il nome bucket del progetto.

  7. Per il campo OperationSetId, seleziona msdyn_CreateOperationSetV1Response OperationSetId nella finestra di dialogo Contenuto dinamico.

Passaggio 8: 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 9: 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 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: Creare un'attività di progetto

Segui questi passaggi per creare un'attività di progetto con un ID univoco che appartiene al progetto corrente e al bucket di progetto che hai creato.

  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 Crea attività di progetto.

  5. Nel campo Nome azione, seleziona msdyn_PssCreateV1.

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

    Ecco una spiegazione dei parametri:

    • @@odata.type – Il nome dell'entità. Ad esempio, immetti "Microsoft.Dynamics.CRM.msdyn_projecttask".
    • msdyn_projecttaskid – 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 è lo stesso utilizzato per impostare msdyn_projectbucketid nel 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 – Stato del collegamento. Ad esempio, immetti "192350000".

  7. Per il campo OperationSetId, seleziona msdyn_CreateOperationSetV1Response OperationSetId nella finestra di dialogo Contenuto dinamico.

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 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 Crea assegnazione.

  5. Nel campo Nome azione, seleziona msdyn_PssCreateV1.

  6. Nel campo Entità 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']})"
}

  7. Per il campo OperationSetId, seleziona msdyn_CreateOperationSetV1Response OperationSetId nella finestra di dialogo Contenuto dinamico.

Passaggio 14: Diminuire una variabile

  1. Nel flusso, seleziona Nuovo passaggio.
  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: Rinominare un'attività di progetto

  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 Rinomina attività di progetto.

  5. Nel campo Nome azione, seleziona msdyn_PssUpdateV1.

  6. Nel campo Entità immetti le seguenti informazioni sui parametri.

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

  7. Per il campo OperationSetId, seleziona msdyn_CreateOperationSetV1Response OperationSetId 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