Bagikan melalui

Menginstal dan mengkonfigurasi Connected Field Service untuk Azure IoT Hub

  • Artikel

Ikuti langkah-langkah dalam artikel ini untuk mengkonfigurasi Connected Field Service untuk digunakan dengan Azure IoT Hub.

Catatan

Time Series Insights tidak akan digunakan lagi setelah Maret 2025. Connected Field Service sedang bertransisi ke Azure Data Explorer. Informasi lebih lanjut tentang transisi akan segera hadir.

Prasyarat

  • Dynamics 365 Field Service diinstal.

  • Anda memiliki peran keamanan Administrator Sistem dan Administrator IoT.

  • Anda memiliki langganan Azure aktif dengan hak istimewa untuk membuat sumber daya dan layanan.

  • Anda telah membuat pendaftaran aplikasi untuk Azure Time Series Insights di portal Microsoft Azure dan memiliki ID Aplikasi (klien) dan ID Objek. Tambahkan Rahasia Klien dan catat nilainya. Anda memerlukan nilai-nilai ini beberapa kali dalam prosedur ini.

Tip

Gambar yang menyertakan ikon yang terlihat seperti ini: dapat diperluas untuk menampilkan lebih banyak detail. Pilih gambar untuk meluaskannya. Untuk menutupnya, tekan tombol Esc.

Menyebarkan sumber daya Connected Field Service dan Azure dari template ARM

Gunakan template Azure Resource Management (Azure Resource Manager) untuk menyebarkan Azure IoT Hub dan menghubungkannya ke lingkungan Field Service Anda.

  1. Pilih Sebarkan ke Azure di halaman https://github.com/microsoft/Dynamics-365-Connected-Field-Service-Deployment.

  2. pilih langganan Azure Anda.

  3. Pilih grup sumber daya atau buat grup sumber daya.

  4. Atur wilayah ke wilayah yang sama dengan lingkungan Field Service Anda.

    Cuplikan layar template Azure Resource Manager untuk menyebarkan IoT Hub for Connected Field Service.

  5. Masukkan nama unik organisasi Anda dan URL organisasi lingkungan Field Service.

  6. Pilih sumber daya opsional yang ingin Anda sebarkan.

    • Pilih Deploy Simulator (opsional) untuk menguji dan memvalidasi skenario IoT dengan data sampel.
    • Pilih Azure Time Series Insights (opsional) untuk mengaktifkan visualisasi pembacaan perangkat dan petak peta ringkasan.
    • Pilih Sebarkan SQL Server untuk (opsional) Power BI dan masukkan server SQL dan info masuk untuk membuat laporan Power BI Anda sendiri.

  7. Pilih Tinjau + buat.

Pastikan penyebaran selesai sebelum Anda melanjutkan.

Membuat instans penyedia IoT

  1. Masuk ke Dynamics 365 dan buka aplikasi Connected Field Service.

  2. Di Connected Field Service, buka area pengaturan .

  3. Pilih Penyedia, lalu pilih Baru.

  4. Masukkan informasi berikut:

    Cuplikan layar instans penyedia IoT Hub baru dengan data sampel.

    • Nama: Nama grup sumber daya di Azure tempat Anda menyebarkan sumber daya IoT
    • Penyedia IoT: Penyedia IoT untuk IoT Hub
    • Id Instans Penyedia: Nama sumber daya IoT Hub yang Anda sebarkan ke grup sumber daya Anda di Azure
    • URL: URL gambaran umum untuk grup sumber daya di portal Microsoft Azure; misalnya, https://portal.azure.com/[tenant_id]/subscriptions/[subscription_id]/resourceGroups/[resource_group_name]/overview.

  5. Pilih Simpan.

Anda sekarang perlu memperbarui pengaturan untuk instans penyedia baru.

  1. Di area Pengaturan, pilih Pengaturan IoT Pengaturan>Penyedia IoT.

    Cuplikan layar halaman Pengaturan IoT.

  2. Untuk Penyedia IoT Default, pilih instans penyedia IoT yang Anda buat.

  3. Pilih Simpan &; Tutup.

  4. Untuk langkah selanjutnya, temukan baris Instans Penyedia IoT di msdyn_iotproviderinstance tabel dan salin GUID.

Menyiapkan IoT titik akhir

Untuk langkah ini, Anda perlu mengetahui nama host untuk Bus Layanan Namespace yang disebarkan ke grup sumber daya Anda.

  1. Power Platform Unduh CLI dan instal.

  2. Buka CLI dan luncurkan menggunakan Plugin Registration Tool (PRT) perintah pac tool prt.

  3. Di jendela PRT, pilih Buat Koneksi Baru.

  4. Di Tampilkan daftar organisasi yang tersedia, pilih Office 365.

  5. Pilih Tampilkan daftar organisasi yang tersedia, lalu pilih Perlihatkan Tingkat Lanjut.

  6. Pilih wilayah lingkungan Field Service Anda, masukkan kredensial Field Service Anda, lalu pilih login.

    Jika Anda memiliki akses ke beberapa organisasi Dynamics 365, pilih nama organisasi yang ingin Anda ajak bekerja sama.

Sekarang Anda perlu memperbarui layanan Pesan IoT titik akhir.

  1. Setelah Anda tersambung ke organisasi, temukan dan pilih Layanan Pesan IoT titik akhir.

  2. Pilih Perbarui.

  3. Untuk NameSpace Address, masukkan nama host Bus Layanan Namespace di Alat Pendaftaran Plug-in, diawali dengan sb://; misalnya, sb://myServiceBusNamespace.servicebus.windows.net.

  4. Di sumber daya Bus Layanan Namespace, buka Antrean dan temukan antrean dengan nama yang berakhiran dengan -crm. Salin nama lengkap dan masukkan sebagai # topik Nama di Alat Pendaftaran Plug-in.

  5. Untuk Format Pesan, pilih XML.

  6. Di sumber daya Bus Layanan Namespace, buka Kebijakan>akses bersama RootManageSharedAccessKey.

  7. Salin nama dan tempel di Nama Kunci SaS.

  8. Salin kunci utama dan tempel di Kunci SAS.

  9. Pilih Simpan.

    Cuplikan layar halaman Pendaftaran titik akhir Layanan.

Mengotorisasi koneksi aplikasi Azure

  1. Masuk ke akun Azure Anda dan buka portal Microsoft Azure.

  2. Buka Grup Sumber Daya dan temukan grup sumber daya tempat Anda menyebarkan IoT Hub.

  3. Pilih dan edit sumber daya Koneksi API commondataservice.

  4. Di bawah Umum, pilih Edit Koneksi API, lalu pilih Otorisasi .

  5. Masuk dengan kredensial Dynamics 365 yang Anda gunakan untuk masuk ke lingkungan Connected Field Service Anda.

    Mereka mungkin berbeda dari info masuk yang Anda gunakan untuk masuk ke portal Microsoft Azure.

  6. Pilih Simpan.

Perbarui devicerules.json

Pekerjaan Analisis Aliran yang disebarkan ke grup sumber daya Anda mengacu pada file bernama devicerules.json. File ini menentukan aturan yang membuat Pemberitahuan IoT saat Anda menggunakan simulator perangkat opsional.

Untuk menggunakan aturan, upload devicerules.json file. Anda harus mereproduksi struktur direktori yang tepat agar pemberitahuan sampel berfungsi.

  1. Unduh file dari devicerules.jsonrepositori GitHub.

  2. Buka grup sumber daya di portal admin Azure dan pilih akun penyimpanan yang disebarkan ke grup sumber daya Anda.

  3. Pilih Kontainer, lalu buat kontainer yang disebut devicerules.

  4. Buka kontainer devicerules baru dan pilih Unggah.

  5. Telusuri dan pilih devicerules.json.

  6. Perluas bagian Tingkat Lanjut. Di bidang Unggah ke folder , masukkan 2016-05-30, lalu pilih Unggah.

  7. Buka folder 2016-05-30 baru dan pilih Unggah.

  8. Telusuri dan pilih devicerules.json.

  9. Perluas bagian Tingkat Lanjut. Di bidang Unggah ke folder , masukkan 22-40, lalu pilih Unggah.

Mulai pekerjaan Azure Stream Analytics

  1. Di portal Microsoft Azure, buka Grup Sumber Daya dan temukan grup sumber daya tempat Anda menyebarkan IoT Hub.

  2. Pilih setiap pekerjaan Analisis Aliran dan dari tab Gambaran Umum , pilih Mulai.

Selamat! Anda sekarang siap untuk meneruskan data antara Azure IoT Hub dan Dynamics 365 untuk menggunakan Connected Field Service.

Menyiapkan koneksi Azure Time Series Insights

Gunakan Azure Time Series Insights untuk membuat visualisasi. Untuk langkah ini, Anda perlu mengetahui ID Penyewa Azure Anda.

  1. Di Dynamics 365, buka aplikasi Connected Field Service.

  2. Luncurkan alat pengembang browser dan buka konsol.

  3. Ketik atau tempel skrip berikut di konsol dan jalankan. Ganti Value parameter dengan ID Penyewa Azure Anda.

var req = {};

req.getMetadata = function () {
return {
boundParameter: null,
parameterTypes: {
"Key": {
"typeName": "Edm.String",
"structuralProperty": 1
},
"Value": {
"typeName": "Edm.String",
"structuralProperty": 1
},
},
operationType: 0,
operationName: "msdyn_IoTSetConfiguration"
};
};

req["Key"]="TSI_PLUGIN_AZURE_TENANT_ID";
req["Value"]="REPLACE";

Xrm.WebApi.online.execute(req).then( 
function (data) { 
console.log("Success Response Status: " + data.status);
}, 
function (error) { 
console.log("Error: " + error.message);
}
);

  1. Jalankan skrip lagi. Kali ini, ganti Key dengan dan TSI_PLUGIN_CLIENT_APPLICATION_ID dengan Value ID Klien Aplikasi dari pendaftaran aplikasi Time Series Insights yang Anda buat sebagai prasyarat.

  2. Jalankan skrip sekali lagi. Kali ini, ganti Key dengan dan TSI_PLUGIN_CLIENT_SECRET dengan Value Rahasia Klien dari pendaftaran aplikasi Time Series Insights yang Anda buat sebagai prasyarat.

  3. Jalankan skrip berikut, menggunakan URL Time Series Insights Anda dan GUID baris instans penyedia IoT di tabel msdyn_iotproviderinstance untuk instans penyedia IoT yang Anda buat sebelumnya.

var data = {"msdyn_timeseriesinsightsurl": "Enter Data Access FQDN found on Time Series Insights environment overview"};
Xrm.WebApi.updateRecord("msdyn_iotproviderinstance", "Copy the value for msdyn_iotproviderinstanceid from the json object returned with the API call https://[your-environment-name].crm.dynamics.com/api/data/v9.2/msdyn_iotproviderinstances", data);

(Opsional) Menyiapkan simulator

Simulator memungkinkan Anda menguji Connected Field Service tanpa perlu menyambungkan perangkat keras fisik. Perangkat dan data IoT yang disimulasikan membantu Anda memahami bagian-bagian sistem yang berkontribusi untuk mengubah data IoT menjadi perintah kerja.

Untuk langkah ini, Anda memerlukan URL simulator dan kunci utama untuk iothubowner kebijakan.

Dapatkan kunci akses

  1. Masuk ke akun Azure Anda dan buka portal Microsoft Azure.

  2. Buka Grup Sumber Daya dan temukan grup sumber daya tempat Anda menyebarkan IoT Hub.

  3. Pilih hub IoT.

  4. Pilih Kebijakan akses bersama, lalu salin kunci utama untuk iothubowner.

    Cuplikan layar kebijakan akses bersama sumber daya Azure IoT Hub untuk iothubowner, dengan kunci utama disorot.

Dapatkan URL simulator

  1. Di grup sumber daya portal Microsoft Azure tempat Anda menyebarkan IoT Hub, pilih jenis sumber daya App Service yang dimulai dengan Simulator dan salin URL di sudut kanan atas.

  2. Tempelkan URL ke bilah alamat browser Anda dan muat halaman.

  3. Pilih Koneksi.

  4. Masukkan nama host dari sumber daya IoT Hub dan iothubowner sebagai nama kebijakan. Di bidang Kunci , tempelkan kunci utama yang Anda salin sebelumnya.

    Cuplikan layar jendela 'Konfigurasikan koneksi' di Azure.

  5. Pastikan Status koneksi tersambung lalu tutup jendela koneksi.

Kirim perintah uji menggunakan simulator. Misalnya, pilih suhu dan tingkatkan di atas 70 derajat. Simulator diprogram sebelumnya untuk membuat peringatan IoT jika suhu naik di atas 70 derajat.

Langkah berikutnya