Azure IoT Hub için Connected Field Service'i yükleme ve yapılandırma

Connected Field Service'ı Azure IoT Hub ile kullanılacak şekilde ayarlamak için bu makaledeki adımları izleyin.

• Adım 1: ARM şablonundan Connected Field Service ve Azure kaynaklarını dağıtma
• 2. Adım: IoT sağlayıcı örneği oluşturun
• 3. Adım: IoT uç noktası ayarlama
• 4. Adım: Azure uygulama bağlantısını yetkilendirin
• Adım 5: devicerules.json dosyasını güncelleştirme
• Adım 6: Azure Akış Analizi işlerini başlatma
• 7. Adım: Azure Time Series Insights bağlantısını kurun
• Adım 8: (İsteğe bağlı) Simülatörü kurun

Not

Time Series Insights, Mart 2025'ten sonra kullanım dışı bırakılacak. Connected Field Service, Azure Veri Gezgini'ne geçiş yapıyor. Geçiş hakkında daha fazla bilgi yakında gelecek.

Önkoşullar

• Dynamics 365 Field Service yüklü.

• System Yönetici ve IoT Yönetici güvenlik rollerine sahipsiniz.

• Kaynak ve hizmet oluşturma ayrıcalıklarına sahip etkin bir Azure aboneliğiniz var.

• Azure portalında Azure Time Series Insights için bir uygulama kaydı oluşturdunuz ve Uygulama (istemci) Kimliğine ve Nesne Kimliğine sahipsiniz. Bir Gizli Anahtar ekleyin ve değeri kaydedin. Bu prosedürde bu değerlere birden çok kez ihtiyacınız vardır.

İpucu

Şuna benzer bir simge içeren resimler: , daha fazla ayrıntı göstermek için genişletilebilir. Genişletilecek görüntüyü seçin. Kapatmak için ESC tuşuna basın.

ARM şablonundan Connected Field Service ve Azure kaynaklarını dağıtma

Azure IoT Hub'ı dağıtmak ve bunu Field Service ortamınıza bağlamak için bir Azure Kaynak Yönetimi (Azure Resource Manager) şablonu kullanın.

1. https://github.com/microsoft/Dynamics-365-Connected-Field-Service-Deployment sayfasında Azure'ye Dağıt'ı seçin.

2. Azure aboneliği seçin.

3. Bir kaynak grubu seçin veya oluşturun.

4. Bölgeyi alan hizmeti ortamınızla aynı bölgeye ayarlayın.

   

5. Kuruluşunuzun benzersiz adını ve Field Service ortamınının kuruluş URL'sini girin.

6. Dağıtmak istediğiniz isteğe bağlı kaynakları seçin.

   • Simülatörü Dağıt (isteğe bağlı) öğesini seçerek örnek verilerle IoT senaryolarını test edin ve doğrulayın.
   • Azure Time Series Insights (isteğe bağlı) öğesini seçerek cihaz okumalarının ve özet kutucuklarının görselleştirilmesini sağlayın.
   • Power BI için SQL Server'ı dağıt (isteğe bağlı) öğesini seçin ve Power BI'da kendi raporlarınızı oluşturmak için SQL server ve kimlik bilgilerini girin.

7. İncele ve oluştur'u seçin.

Devam etmeden önce dağıtımın tamamlandığından emin olun.

Bir IoT sağlayıcı örneği oluşturun

1. Dynamics 365'te oturum açın ve Connected Field Service uygulamasını açın.

2. Connected Field Service'te Ayarlar alanına gidin.

3. Sağlayıcılar seçeneğini ve ardından Yeni seçeneğini belirleyin.

4. Aşağıdaki bilgileri girin:

   

   • İsim: Azure'da IoT kaynaklarını dağıttığınız kaynak grubunun adı
   • IoT Sağlayıcı: IoT Hub için IoT sağlayıcısı
   • Sağlayıcı Örnek Kimliği: Azure'daki kaynak grubunuza dağıttığınız IoT Hub kaynağının adı
   • URL: Azure portalındaki kaynak grubuna yönelik genel bakışın URL'si; örneğin, https://portal.azure.com/[tenant_id]/subscriptions/[subscription_id]/resourceGroups/[resource_group_name]/overview.

5. Kaydet'i seçin.

Artık yeni sağlayıcı örneğinin ayarlarını güncellemeniz gerekiyor.

1. Ayarlar bölümünde, IoT Ayarları>IoT Sağlayıcısı Ayarları'nı seçin.

   

2. Varsayılan IoT Sağlayıcısı için, oluşturduğunuz IoT sağlayıcı örneğini seçin.

3. Kaydet ve Kapat'ı seçin.

4. Daha sonraki bir adım için, msdyn_iotproviderinstance tablosundaki IoT Sağlayıcı Örneği satırını bulun ve GUID'yi kopyalayın.

IoT uç noktası ayarlama

Bu adım için, kaynak grubunuza dağıtılan Service Bus Ad Alanı'nın ana bilgisayar adını bilmeniz gerekir.

1. Power Platform CLI indirip yükleyin.

2. CLI'yi açın ve pac tool prt komutunu kullanarak Plugin Registration Tool (PRT) başlatın.

3. PRT penceresinde, Yeni bağlantı oluştur'u seçin.

4. Kullanılabilir kuruluşların listesini görüntüle'de Office 365 seçin.

5. Kullanılabilir kuruluşların listesini görüntüle'yi ve ardından Gelişmişi Göster'i seçin.

6. Field Service ortamınızın bölgesini seçin, Field Service kimlik bilgilerinizi girin ve ardından Oturum Aç'ı seçin.

   Birden fazla Dynamics 365 kuruluşuna erişiminiz varsa birlikte çalışmak istediğiniz kuruluşun adını seçin.

Artık uç nokta IoT Mesaj hizmetini güncellemeniz gerekiyor.

1. Kuruluşa bağlandıktan sonra IoT Mesajı hizmet uç noktasını bulup seçin.

2. Güncelleştir'i seçin.

3. Ad Alanı Adresi için, Eklenti Kayıt Aracında Service Bus Ad Alanının ana bilgisayar adını sb:// önekiyle girin; örneğin, sb://myServiceBusNamespace.servicebus.windows.net.

4. Service Bus Ad Alanı kaynağında, Kuyruklar'a gidin ve adı -crm ile biten kuyruğu bulun. Tam adı kopyalayın ve Plug-in Registration Tool'da Konu Adı olarak girin.

5. İleti Biçimi için XML seçin.

6. Service Bus Ad Alanı kaynağında, Paylaşılan erişim ilkeleri>RootManageSharedAccessKey öğesine gidin.

7. Adı kopyalayıp SaS Anahtar Adı'na yapıştırın.

8. Birincil anahtarı kopyalayın ve SAS Anahtarına yapıştırın.

9. Kaydet'i seçin.

   

Azure uygulama bağlantısını yetkilendirin

1. Azure hesabınızda oturum açın ve Azure portalına gidin.

2. Kaynak Grupları'na gidin ve IoT Hub'ı dağıttığınız kaynak grubunu bulun.

3. API Bağlantısı kaynağı commondataservice'i seçin ve düzenleyin.

4. Genel sekmesi altından API Bağlantısını Düzenle'yi ve ardından Yetkilendir'i seçin.

5. Connected Field Service ortamınızda oturum açmak için kullandığınız Dynamics 365 kimlik bilgileriyle oturum açın.

   Azure portalında oturum açmak için kullandığınız kimlik bilgilerinden farklı olabilirler.

6. Kaydet'i seçin.

devicerules.json dosyasını güncelleştirme

Kaynak grubunuza dağıtılan Stream Analytics işi devicerules.json adlı bir dosyaya başvuruyor. Bu dosya, isteğe bağlı cihaz simülatörünü kullanırken IoT Uyarıları oluşturan bir kuralı tanımlar.

Kuralı kullanmak için devicerules.json dosyasını yükleyin. Örnek uyarının çalışması için dizin yapısını tam olarak yeniden oluşturmanız gerekir.

1. GitHub deposundan çözümü devicerules.json dosyasını indirin.

2. Azure yönetim portalında kaynak grubunu açın ve kaynak grubunuzu dağıtılan depolama hesabını seçin.

3. Kapsayıcılar'ı seçin ve ardından devicerules adında bir kapsayıcı oluşturun.

4. devicerules yeni kapsayıcısını açın ve Yükle'yi seçin.

5. devicerules.jsonöğesine göz atın ve seçin.

6. Gelişmiş bölümünü genişletin. Klasöre yükle alanına 2016-05-30 yazın ve ardından Yükle'yi seçin.

7. 2016-05-30 yeni klasörünü açın ve Yükle'yi seçin.

8. devicerules.jsonöğesine göz atın ve seçin.

9. Gelişmiş bölümünü genişletin. Klasöre yükle alanına 22-40 yazın ve ardından Yükle'yi seçin.

Azure Akış Analizi işlerini başlatma

1. Azure portalında, Kaynak Gruplarına gidin ve IoT Hub'ı dağıttığınız kaynak grubunu bulun.

2. Her Stream Analytics işini seçin ve Genel Bakış sekmesinden Başlat'ı seçin.

Tebrikler! Artık Connected Field Service kullanmak için Azure IoT Hub ile Dynamics 365 arasında veri aktarmaya hazırsınız.

Azure Time Series Insights bağlantısını kurun

Görsel öğeler oluşturmak için Azure Time Series Insights kullanın. Bu adım için Azure kiracı kimliğinizi bilmeniz gerekir.

1. Dynamics 365'te Connected Field Service uygulamasını açın.

2. Tarayıcı geliştirici araçlarını başlatın ve konsola gidin.

3. Aşağıdaki betiği konsola yazın veya yapıştırın ve çalıştırın. Value parametresini Azure kiracı kimliğinizle değiştirin.

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. Betiki tekrar çalıştırın. Bu sefer, Key öğesini TSI_PLUGIN_CLIENT_APPLICATION_ID ile ve Value öğesini Time Series Insights uygulaması kaydından ön koşul olarak oluşturduğunuz Uygulama İstemci Kimliği ile değiştirin.

2. Komut dosyasını bir kez daha çalıştırın. Bu sefer, Key öğesini TSI_PLUGIN_CLIENT_SECRET ile ve Value öğesini Time Series Insights uygulaması kaydından ön koşul olarak oluşturduğunuz Gizli Dizi ile değiştirin.

3. Daha önce oluşturduğunuz IoT sağlayıcı örneği için msdyn_iotproviderinstance tablosunda Time Series Insights URL'nizi ve IoT sağlayıcı örnek satırının GUID'sini kullanarak aşağıdaki betiği çalıştırın.

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);

(İsteğe bağlı) Simülatörü kurun

Simülatör, fiziksel donanımı bağlamanıza gerek kalmadan Connected Field Service'i test etmenize olanak tanır. Simüle edilmiş IoT cihazları ve verileri, sistemin IoT verilerinin iş emirlerine dönüştürülmesine katkıda bulunan kısımlarını anlamanıza yardımcı olur.

Bu adım için iothubowner politikasının simülasyon URL'sine ve birincil anahtarına ihtiyacınız var.

Erişim anahtarını alma

1. Azure hesabınızda oturum açın ve Azure portalına gidin.

2. Kaynak Grupları'na gidin ve IoT Hub'ı dağıttığınız kaynak grubunu bulun.

3. IoT hub seçeneğini belirleyin.

4. Paylaşılan erişim ilkeleri'ni seçin ve ardından iothubowner öğesinin birincil anahtarını kopyalayın.

   

Simülatör URL'sini alın

1. IoT Hub'ı dağıttığınız Azure portalı kaynak grubunda, Simulator ile başlayan App Service kaynak türünü seçin ve sağ üst köşedeki URL'yi kopyalayın.

2. URL'yi tarayıcınızın adres çubuğuna yapıştırın ve sayfayı yükleyin.

3. Bağlantı'yı seçin.

4. IoT Hub kaynağındaki ana bilgisayar adını ve politika adı olarak iothubowner öğesini girin. Anahtar alanına daha önce kopyaladığınız birincil anahtarı yapıştırın.

   

5. Bağlantı durumununBağlı olduğundan emin olun ve ardından bağlantı penceresini kapatın.

Simülatörü kullanarak bir test komutu gönderin. Örneğin, sıcaklığı seçin ve 70 derecenin üstüne yükseltin. Simülatör, sıcaklık 70 derecenin üzerindeyse IoT uyarısı oluşturmak için önceden programlanmıştır.

Sonraki adımlar

• Cihazları kaydetme
• Cihaz verilerini al
• Cihaz okumalarını görselleştirme