Menggunakan API Jadwal proyek V1 dengan Power Automate

Berlaku untuk: Operasi Proyek Terintegrasi dengan ERP, Inti Operasi Proyek

Artikel ini menjelaskan alur sampel yang menunjukkan cara membuat rencana proyek lengkap menggunakan Microsoft Power Automate, cara membuat Rangkaian Operasi, dan cara memperbarui entitas. Contohnya memperlihatkan cara membuat proyek, anggota tim proyek, Rangkaian Operasi, tugas proyek, dan penugasan sumber daya. Artikel ini juga menjelaskan cara memperbarui entitas dan menjalankan Kumpulan Operasi.

Contoh dalam artikel ini menggunakan API PssCreateV1. Untuk contoh yang menggunakan API PssCreateV2, lihat API jadwal Proyek V2 dengan Power Automate.

Berikut adalah daftar lengkap langkah-langkah yang didokumentasikan dalam alur sampel dalam artikel ini:

Membuat Power Apps pemicu
Membuat proyek
Menginisialisasi variabel untuk anggota tim
Membuat anggota tim generik
Membuat Kumpulan Operasi
Menginisialisasi variabel untuk ID Wadah Proyek
Membuat Wadah proyek
Inisialisasi variabel untuk jumlah tugas
Menginisialisasi variabel untuk ID tugas proyek
Lakukan sampai
Menetapkan tugas proyek
Membuat tugas proyek
Membuat penugasan sumber daya
Mengurangi variabel
Mengganti nama tugas proyek
Menjalankan Set Operasi

Asumsi

Artikel ini mengasumsikan bahwa Anda memiliki pengetahuan dasar tentang Dataverse platform, alur cloud, dan API Jadwal Proyek. Untuk informasi selengkapnya, lihat bagian Referensi nanti di artikel ini.

Buat alur

Pilih lingkungan

Anda tidak dapat membuat alur Power Automate dalam lingkungan Anda.

Buka https://flow.microsoft.com, dan gunakan kredensial administrator Anda untuk masuk.
Di sudut kanan atas, pilih Lingkungan.
Di daftar menurun, pilih lingkungan tempat Dynamics 365 Project Operations diinstal.

Membuat solusi

Ikuti langkah-langkah ini untuk membuat alur sadar solusi. Dengan membuat alur sadar solusi, Anda dapat dengan lebih mudah mengekspor alur tersebut untuk menggunakannya nanti.

Pada panel navigasi, pilih Solusi.
Pada halaman Solusi , pilih Solusi baru.
Dalam kotak dialog Solusi baru, atur bidang yang diperlukan, lalu pilih Buat.

Langkah 1: Buat pemicu Power Apps

Pada halaman Solusi , pilih solusi yang Anda buat, lalu pilih Baru.
Di panel kiri, pilih Otomatisasi alur cloudalur cloudInstan >.>>
Di bidang Nama alur, masukkan Jadwalkan Alur Demo API.
Dalam daftar Pilih cara memicu alur ini, pilih Power Apps. Bila Anda membuat pemicu Power Apps, logika akan sesuai dengan Anda sebagai penulis. Untuk contoh dalam artikel ini, biarkan parameter input kosong untuk tujuan pengujian.
Pilih Buat.

Langkah 2: Buat proyek

Ikuti langkah berikut untuk membuat proyek sampel.

Dalam alur yang Anda buat, pilih Langkah Baru.
Dalam kotak dialog Pilih operasi , di bidang pencarian, masukkan lakukan tindakan yang tidak terikat. Kemudian, pada tab Tindakan , pilih operasi dalam daftar hasil.
Dalam langkah baru, pilih elipsis (...), lalu pilih Ganti Nama.
Ganti nama langkahBuat Proyek.
Di bidang Nama Tindakan , pilih msdyn_CreateProjectV1.
Di bawah bidang msdyn_subject , pilih Tambahkan konten dinamis.
Pada tab Ekspresi , di bidang fungsi, masukkan concat('Nama proyek - ',utcNow()).
Pilih OK.

Langkah 3: Inisialisasi variabel untuk anggota tim

Dalam alur, pilih Langkah baru.
Dalam kotak dialog Pilih operasi , di bidang pencarian, masukkan inisialisasi variabel. Kemudian, pada tab Tindakan , pilih operasi dalam daftar hasil.
Dalam langkah baru, pilih elipsis (...), lalu pilih Ganti Nama.
Ganti nama anggota tim langkahInit.
Di bidang Nama , masukkan TeamMemberAction.
Di bidang Jenis , pilih String.
Di bidang Nilai , masukkan msdyn_CreateTeamMemberV1.

Langkah 4: Buat anggota tim generik

Dalam alur, pilih Langkah baru.
Dalam kotak dialog Pilih operasi , di bidang pencarian, masukkan lakukan tindakan yang tidak terikat. Kemudian, pada tab Tindakan , pilih operasi dalam daftar hasil.
Dalam langkah baru, pilih elipsis (...), lalu pilih Ganti Nama.
Ganti nama langkahBuat Anggota Tim.
Untuk bidang Nama Tindakan, pilih TeamMemberAction di kotak dialog Konten dinamis.
Di bidang Parameter Tindakan , masukkan informasi parameter berikut.
```
{
    "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"
    }
} 
```
Berikut penjelasan parameternya:
- @@odata.type – Nama entitas. Misalnya, masukkan "Microsoft.Dynamics.CRM.msdyn_projectteam".
- msdyn_projectteamid – Kunci utama dari ID tim proyek. Nilai adalah ekspresi GUID (pengidentifikasi unik global). ID dibuat dari tab ekspresi.
- msdyn_project@odata.bind – ID proyek dari proyek yang memiliki. Nilainya adalah konten dinamis yang berasal dari respons langkah "Buat Proyek". Pastikan Anda memasukkan jalur lengkap dan menambahkan konten dinamis di antara tanda induk. Tanda kutip diperlukan. Misalnya, masukkan "/msdyn_projects(ADD DYNAMIC CONTENT)".
- msdyn_name – Nama anggota tim. Misalnya, masukkan "ScheduleAPIDemoTM1".

Langkah 5: Buat Set Operasi

Dalam alur, pilih Langkah baru.
Dalam kotak dialog Pilih operasi , di bidang pencarian, masukkan lakukan tindakan yang tidak terikat. Kemudian, pada tab Tindakan , pilih operasi dalam daftar hasil.
Dalam langkah baru, pilih elipsis (...), lalu pilih Ganti Nama.
Ganti nama langkahBuat Kumpulan Operasi.
Di bidang Nama Tindakan, pilih tindakan kustom msdyn_CreateOperationSetV1 Dataverse .
Di bidang Deskripsi , masukkan ScheduleAPIDemoOperationSet.
Di bidang Proyek , dari kotak dialog Konten dinamis, pilih msdyn_CreateProjectV1Response ProjectId.

Langkah 6: Inisialisasi variabel untuk ID Wadah Proyek

Dalam alur, pilih Langkah baru.
Dalam kotak dialog Pilih operasi , di bidang pencarian, masukkan inisialisasi variabel. Kemudian, pada tab Tindakan , pilih operasi dalam daftar hasil.
Dalam langkah baru, pilih elipsis (...), lalu pilih Ganti Nama.
Ganti nama ID wadah proyek langkahInit.
Di bidang Nama , masukkan ID wadah proyek.
Di bidang Jenis , pilih String.
Di bidang Nilai , enter@ {guid()}.

Langkah 7: Buat Wadah proyek

Dalam alur, pilih Tambahkan tindakan.
Dalam kotak dialog Pilih operasi , di bidang pencarian, masukkan lakukan tindakan yang tidak terikat. Kemudian, pada tab Tindakan , pilih operasi dalam daftar hasil.
Dalam Langkah, pilih elipsis (...), lalu pilih Ganti nama.
Ganti nama langkahBuat wadah.
1. Di bidang Nama Tindakan , pilih msdyn_PssCreateV1.
Di bidang Entitas , masukkan informasi parameter berikut.
```
{
    "@@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']})"
}
```
Berikut penjelasan parameternya:
- @@odata.type – Nama entitas. Misalnya, masukkan "Microsoft.Dynamics.CRM.msdyn_projectbucket".
- msdyn_projectbucketid – ID unik proyek wadah. Nilai harus diatur dari variabel dinamis dariLangkah 6.
- msdyn_name – nama wadah proyek.
- msdyn_project@odata.bind – ID proyek dari proyek yang memiliki. Nilainya adalah konten dinamis yang berasal dari respons langkah "Buat Proyek". Pastikan Anda memasukkan jalur lengkap dan menambahkan konten dinamis di antara tanda induk. Tanda kutip diperlukan. Misalnya, masukkan "/msdyn_projects(ADD DYNAMIC CONTENT)".
Untuk bidang OperationSetId , pilih msdyn_CreateOperationSetV1Response OperationSetId di kotak dialog Konten dinamis.

Langkah 8: Inisialisasi variabel untuk jumlah tugas

Dalam alur, pilih Langkah baru.
Dalam kotak dialog Pilih operasi , di bidang pencarian, masukkan inisialisasi variabel. Kemudian, pada tab Tindakan , pilih operasi dalam daftar hasil.
Dalam langkah baru, pilih elipsis (...), lalu pilih Ganti Nama.
Ganti nama LangkahInit Jumlah tugas.
Di bidang Nama , masukkan jumlah tugas.
Di bidang Jenis , pilih Bilangan Bulat.
Di bidang Nilai , masukkan 5.

Langkah 9: Inisialisasi variabel untuk ID tugas proyek

Dalam alur, pilih Langkah baru.
Dalam kotak dialog Pilih operasi , di bidang pencarian, masukkan inisialisasi variabel. Kemudian, pada tab Tindakan , pilih operasi dalam daftar hasil.
Dalam langkah baru, pilih elipsis (...), lalu pilih Ganti Nama.
Ganti nama langkahInit ProjectTaskID.
Di kolom Nama , masukkan msdyn_projecttaskid.
Di bidang Jenis , pilih String.
Untuk bidang Nilai , masukkan guid() di pembuat ekspresi.

Langkah 10: Lakukan sampai

Dalam alur, pilih Langkah baru.
Dalam kotak dialog Pilih operasi , di bidang pencarian, masukkan do until. Kemudian, pada tab Tindakan , pilih operasi dalam daftar hasil.
Atur nilai pertama dalam pernyataan kondisional ke variabel jumlah tugas dari kotak dialog Konten dinamis.
Atur kondisi menjadi kurang dari sama dengan.
Atur nilai kedua dalam pernyataan kondisional ke 0.

Langkah 11: Tetapkan tugas proyek

Dalam alur, pilih Tambahkan tindakan.
Dalam kotak dialog Pilih operasi , di bidang pencarian, masukkan set variabel. Kemudian, pada tab Tindakan , pilih operasi dalam daftar hasil.
Dalam langkah baru, pilih elipsis (...), lalu pilih Ganti Nama.
Ganti nama tugas proyek langkah tetap.
Di bidang Nama , pilih msdyn_projecttaskid.
Untuk bidang Nilai , masukkan guid() di pembuat ekspresi.

Langkah 12: Buat tugas proyek

Ikuti langkah-langkah ini untuk membuat tugas proyek yang memiliki ID unik milik proyek saat ini dan wadah proyek yang Anda buat.

Dalam alur, pilih Langkah baru.
Dalam kotak dialog Pilih operasi , di bidang pencarian, masukkan lakukan tindakan yang tidak terikat. Kemudian, pada tab Tindakan , pilih operasi dalam daftar hasil.
Dalam Langkah, pilih elipsis (...), lalu pilih Ganti nama.
Ganti nama tugas langkahBuat Proyek.
Di bidang Nama Tindakan , pilih msdyn_PssCreateV1.
Di bidang Entitas , masukkan informasi parameter berikut.
```
{
    "@@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)}"
}
```
Berikut penjelasan parameternya:
- @@odata.type – Nama entitas. Misalnya, masukkan "Microsoft.Dynamics.CRM.msdyn_projecttask".
- msdyn_projecttaskid – ID unik tugas. Nilai harus diatur ke variabel dinamis dari msdyn_projecttaskid.
- msdyn_project@odata.bind – ID proyek dari proyek yang memiliki. Nilainya adalah konten dinamis yang berasal dari respons langkah "Buat Proyek". Pastikan Anda memasukkan jalur lengkap dan menambahkan konten dinamis di antara tanda induk. Tanda kutip diperlukan. Misalnya, masukkan "/msdyn_projects(ADD DYNAMIC CONTENT)".
- msdyn_subject – Nama tugas apa pun.
- msdyn_projectbucket@odata.bind – Wadah proyek yang berisi tugas. Nilainya sama dengan yang digunakan untuk mengatur msdyn_projectbucketid pada langkah "Buat wadah". Pastikan Anda memasukkan jalur lengkap dan menambahkan konten dinamis di antara tanda induk. Tanda kutip diperlukan. Misalnya, masukkan "/msdyn_projectbuckets(TAMBAHKAN KONTEN DINAMIS)".
- msdyn_start – Konten dinamis untuk tanggal mulai. Misalnya, besok direpresentasikan sebagai "addDays(utcNow(), 1)".
- msdyn_scheduledstart – Tanggal mulai yang dijadwalkan. Misalnya, besok direpresentasikan sebagai "addDays(utcNow(), 1)".
- msdyn_scheduleend – Tanggal akhir yang dijadwalkan. Pilih tanggal di masa mendatang. Misalnya, tentukan "addDays(utcNow(), 5)".
- msdyn_LinkStatus – Status tautkan. Misalnya, masukkan "192350000".
Untuk bidang OperationSetId , pilih msdyn_CreateOperationSetV1Response OperationSetId di kotak dialog Konten dinamis.

Langkah 13: Membuat penetapan sumber daya

Dalam alur, pilih Tambahkan tindakan.
Dalam kotak dialog Pilih operasi , di bidang pencarian, masukkan lakukan tindakan yang tidak terikat. Kemudian, pada tab Tindakan , pilih operasi dalam daftar hasil.
Dalam Langkah, pilih elipsis (...), lalu pilih Ganti nama.
Ganti nama langkahBuat tugas.
Di bidang Nama Tindakan , pilih msdyn_PssCreateV1.

Di bidang Entitas , masukkan informasi parameter berikut.

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

Untuk bidang OperationSetId , pilih msdyn_CreateOperationSetV1Response OperationSetId di kotak dialog Konten dinamis.

Langkah 14: Kurangi variabel

Dalam alur, pilih Langkah baru.
Dalam kotak dialog Pilih operasi , di bidang pencarian, masukkan variabel dekresi. Kemudian, pada tab Tindakan , pilih operasi dalam daftar hasil.
Di bidang Nama , pilih jumlah tugas.
Di bidang Nilai , masukkan 1.

Langkah 15: Mengganti nama tugas proyek

Dalam alur, pilih Langkah baru.
Dalam kotak dialog Pilih operasi , di bidang pencarian, masukkan lakukan tindakan yang tidak terikat. Kemudian, pada tab Tindakan , pilih operasi dalam daftar hasil.
Dalam Langkah, pilih elipsis (...), lalu pilih Ganti nama.
Ganti nama tugas langkahGanti Nama Proyek.
Di bidang Nama Tindakan , pilih msdyn_PssUpdateV1.