Öğretici: örnek bir istemci uygulaması kullanarak Azure dijital TWINS grafiği oluşturma

Bu öğreticide, modeller, TWINS ve ilişkiler kullanarak Azure dijital TWINS 'de bir grafik oluşturacaksınız. Bu öğretici için araç, bir Azure dijital TWINS örneğiyle etkileşime yönelik örnek komut satırı istemci uygulamasıdır . İstemci uygulaması, bir istemci uygulaması koduiçinde yazılmış olana benzerdir.

Bu örneği, model yükleme, TWINS oluşturma ve değiştirme ve ilişki oluşturma gibi temel Azure dijital TWINS eylemlerini gerçekleştirmek için kullanabilirsiniz. Ayrıca, Azure dijital TWINS API 'Leri hakkında bilgi edinmek ve örnek projeyi istediğiniz gibi değiştirerek kendi komutlarınızı uygulamayı yapmak için Örneğin koduna bakabilirsiniz.

Bu öğreticide,...

Önkoşullar

Bu öğreticide yer alan adımları tamamlamak için öncelikle aşağıdaki önkoşulları tamamlamanız gerekir.

Azure aboneliğiniz yoksa başlamadan önce ücretsiz bir hesap oluşturun.

Gerekli kaynakları al

Bu öğreticiyi tamamlamak için geliştirme Visual Studio 2019, sürüm 16.5 veya sonraki bir sürümünü yükleyin. Daha eski bir sürümünüz zaten yüklüyse makinenize Visual Studio Yükleyicisi uygulamasını açabilir ve yüklemenizi güncelleştirmek için istemleri takip edin.

Öğretici, C# ile Azure Digital Twins bir örnek proje tarafından yönlendirildi. Örnek bağlantıya giderek ve başlığın altındaki Koda gözat düğmesini seçerek makinenize örnek projeyi alın. Bu sizi örnekler için GitHub, kod düğmesini ve ardından ZIP'i indir'i seçerek .zip olarak indirebilirsiniz.

Bu, .zip olarak makinenize bir digital-twins-samples-master.zip. Klasörün sıkıştırması açın ve dosyaları ayıklar.

Örnek Azure Digital Twins hazırlama

Bu makalede Azure Digital TWINS ile çalışmak için önce bir Azure dijital TWINS örneği ayarlamanız gerekir. Ayrıca, kullanmak için gerekli izinlere de ihtiyacınız vardır. Zaten ayarlanmış bir Azure dijital TWINS örneğiniz varsa, bunun yerine kullanabilirsiniz.

Aksi takdirde, örnek ayarlama ve kimlik doğrulamabölümündeki yönergeleri izleyin. Yönergeler, her adımı başarıyla tamamladığınızı doğrulamanıza yardımcı olacak bilgiler içerir.

Örneğinizi ayarladıktan sonra, aşağıdaki değerleri unutmayın. Örneğe daha sonra bağlanmak için bu değerlere ihtiyacınız olacak:

• Örneğin ana bilgisayar adı. Ana bilgisayar adını Azure Portal bulabilirsiniz.
• Örneği oluşturmak için kullandığınız Azure aboneliği . Adı veya KIMLIĞI çalışır durumda. Aboneliğinizi, Azure Portalörneğinizin genel bakış sayfasında bulabilirsiniz.

Örnek projeyi yapılandırma

Ardından, Azure dijital TWINS örneğinizle etkileşime girebilen bir örnek istemci uygulaması ayarlayın.

Makinenizde daha önce Azure dijital TWINS uçtan uca örneklerden indirdiğiniz dosyaya gidin (ve henüz yapmadıysanız dosyayı ayıklayın.)

Klasörün içindeyken AdtSampleApp adresine gidin. Visual Studio 2019 ' de AdtE2ESample. sln 'yi açın.

Visual Studio 'da, dosyayı Düzenle penceresinde açmak için dosya üzerinde Sampleclientapp > appsettings.js seçin. Bu, projeyi çalıştırmak için gerekli yapılandırma değişkenlerine sahip bir önceden ayarlanmış JSON dosyası işlevi görür.

Dosya gövdesinde, instanceUrl Azure Digital TWINS örnek ana bilgisayar adı URL 'siyle değiştirin (aşağıda gösterildiği gibi ana bilgisayar adının önüne https:// ekleyerek).

{
  "instanceUrl": "https://<your-Azure-Digital-Twins-instance-host-name>"
}

Dosyayı kaydedin ve kapatın.

Sonra, Sampleclientapp' i oluştururken dosyayı çıkış dizinine kopyalamak üzere appsettings.js yapılandırın. Bunu yapmak için dosya üzerindeappsettings.js sağ seçin ve Özellikler' i seçin. Özellikler denetçisinde, Çıkış Dizinine Kopyala özelliğini arayın. Daha önceden bu değere ayarlanmamışsa değeri kopyalamak için değiştirin.

Öğreticide kullanmaya devam etmek için AdtE2ESample projesini Visual Studio 'da açık tutun.

Yerel Azure kimlik bilgilerini ayarlama

Bu örnek Azure.Identity , yerel makinenizde çalıştırdığınızda Azure dijital TWINS örneğiyle kullanıcıların kimliğini doğrulamak için DefaultAzureCredential (kitaplığın parçası) kullanır. İstemci uygulamasının Azure dijital TWINS ile kimlik doğrulaması yapabilme yolları hakkında daha fazla bilgi için bkz. uygulama kimlik doğrulama kodu yazma.

İle DefaultAzureCredential , örnek, yerel ortamınızda, yerel bir Azure CLI veya Visual Studio ya da Visual Studio Code bir Azure oturum açma gibi kimlik bilgilerini arar. Bu nedenle, örnek için kimlik bilgilerini ayarlamak üzere bu mekanizmalardan biri aracılığıyla yerel olarak Azure 'da oturum açmanız gerekir.

Kod örneğini çalıştırmak için Visual Studio 'Yu veya Visual Studio Code kullanıyorsanız, Bu düzenleyicide Azure dijital TWINS örneğinize erişmek için kullanmak istediğiniz Azure kimlik bilgileriyle oturum açtığınızdan emin olun.

Aksi takdirde, Yerel Azure CLI 'yı yükleyebilir, makinenizde bir komut istemi başlatabilir ve az login Azure hesabınızda oturum açmak için komutunu çalıştırabilirsiniz. Oturum açtıktan sonra, kod örneğinizi çalıştırdığınızda otomatik olarak oturumunuzu açmanız gerekir.

Örnek projeyi çalıştırma

Artık uygulama ve kimlik doğrulaması ayarlanmış olduğuna göre, araç çubuğunda bu düğmeyi kullanarak projeyi çalıştırın:

Bir konsol penceresi açılır, kimlik doğrulama işlemi gerçekleştirebilir ve bir komut için bekler.

Aşağıda, proje konsolunun nasıl göründüğü hakkında bir ekran görüntüsü verilmiştir:

Uygulamanın başarıyla çalıştığını onayladıktan sonra, uygulamayı şimdilik çalıştırmayı durdurmak için konsol penceresini kapatın. Makaleyi makalenin ilerleyen kısımlarında daha sonra çalıştırabileceksiniz.

DTDL ile fiziksel ortam modelleme

Artık Azure Digital TWINS örneği ve örnek uygulama ayarlanmış olduğuna göre, senaryonun bir grafiğini oluşturmaya başlayabilirsiniz.

Azure dijital TWINS çözümü oluşturmanın ilk adımı, ortamınız için ikizi modellerini tanımlıyor.

Modeller, nesne odaklı programlama dillerinde sınıflarla benzerdir; Bunlar, daha sonra izlemek ve örneklendirilecek dijital TWINS için Kullanıcı tanımlı şablonlar sağlar. Bunlar, dijital TWINS tanım dili (DTDL) adlı JSON benzeri bir dilde yazılır ve bir ikizi özellikleri, telemetri, ilişki ve bileşen tanımlayabilir.

AdtE2ESample projesinin açık olduğu Visual Studio pencerenizde, AdtSampleApp\SampleClientApp\Models klasörüne gitmek için Çözüm Gezgini bölmesini kullanın. Bu klasör örnek modeller içerir.

Dosyayı Düzenle penceresinde açmak için oda. JSON ' u seçin ve aşağıdaki yollarla değiştirin:

1. Bu modelin daha güncel bir sürümünü sağladıklarını belirtmek için sürüm numarasını güncelleştirin. Değerin sonundaki 1 @id değerini 2 olarak değiştirerek bunu yapın. Geçerli sürüm numarasından daha büyük bir sayı de çalışacaktır.

2. Bir özelliği düzenleyin. HumidityÖzelliğin adını Humidtylevel (veya isterseniz farklı bir şekilde değiştirin. Humidtylevel' dan farklı bir şey kullanırsanız, kullandığınız şeyi hatırlayın ve öğretici genelinde Humidtylevel yerine bunu kullanmaya devam edin).

3. Özellik ekleyin. 15. HumidityLevel satırda sonlanan özelliğin altında, Odaya bir özellik eklemek için aşağıdaki kodu yapıştırın RoomName :

   ,{
     "@type": "Property",
     "name": "RoomName",
     "schema": "string"
   }
   

4. Ilişki ekleyin. RoomNameAz önce eklediğiniz özelliğin altında, bu tür bir ikizi oluşturmak için aşağıdaki kodu yapıştırın.

   ,{
     "@type": "Relationship",
     "name": "contains"
   }
   

İşiniz bittiğinde, güncelleştirilmiş modelin eşleşmesi gerekir:

{
    "@id": "dtmi:example:Room;2",
    "@type": "Interface",
    "displayName": "Room",
    "contents": [
      {
        "@type": "Property",
        "name": "Temperature",
        "schema": "double"
      },
      {
        "@type": "Property",
        "name": "HumidityLevel",
        "schema": "double"
      }
      ,{
        "@type": "Property",
        "name": "RoomName",
        "schema": "string"
      }
      ,{
        "@type": "Relationship",
        "name": "contains"
      }
    ],
    "@context": "dtmi:dtdl:context;2"
  }

Taşımadan önce dosyayı kaydettiğinizden emin olun.

Azure dijital twıns 'e Upload modeller

Modelleri tasarladıktan sonra Azure dijital TWINS örneğinizi yüklemeniz gerekir. Bunun yapılması, Azure dijital TWINS hizmeti örneğinizi kendi özel etki alanı sözlüğinizle yapılandırır. Modelleri karşıya yükledikten sonra, bunları kullanan ikizi örnekleri oluşturabilirsiniz.

1. Önceki bölümde yer alan oda. json dosyasını düzenledikten sonra konsol uygulamasını yeniden çalıştırmaya başlayın.

2. Proje konsolu penceresinde, farklı türlerde TWINS oluşturmak için bir sonraki bölümde kullanacağınız bir kat modeliyle birlikte güncelleştirilmiş Oda modelinizi karşıya yüklemek için aşağıdaki komutu çalıştırın.

   CreateModels Room Floor
   

   Çıktı, modellerin başarıyla oluşturulduğunu göstermelidir.

3. Komutu çalıştırarak modellerin oluşturulduğunu doğrulayın GetModels true . Bu komut, Azure dijital TWINS örneğinizi karşıya yüklenmiş tüm modellerin tam bilgilerini yazdırır. Sonuçlarda düzenlenmiş Oda modelini arayın:

   

Hatalar

Örnek uygulama, hizmetten gelen hataları da işler.

CreateModelsİkinci bir kez karşıya yüklediğiniz modellerden birini yeniden karşıya yüklemeyi denemek için komutu yeniden çalıştırın:

CreateModels Room

Modellerin üzerine yazılamaz, bu komut şimdi bir hizmet hatası döndürüyor. Mevcut modellerin nasıl silineceği hakkındaki ayrıntılar için bkz. DTDL modellerini yönetme.

Response 409: Service request failed.
Status: 409 (Conflict)

Content:
{"error":{"code":"ModelAlreadyExists","message":"Could not add model dtmi:example:Room;2 as it already exists. Use Model_List API to view models that already exist. See the Swagger example.(http://aka.ms/ModelListSwSmpl)"}}

Headers:
Strict-Transport-Security: REDACTED
Date: Wed, 20 May 2020 00:53:49 GMT
Content-Length: 223
Content-Type: application/json; charset=utf-8

Dijital ikizleri oluşturma

Artık bazı modeller Azure dijital TWINS örneğinizi karşıya yüklediğinize göre, model tanımlarına göre dijital TWINS oluşturabilirsiniz. Dijital TWINS, iş ortamınızdaki varlıkları, bir gruptaki algılayıcılar gibi şeyler, bir bina içindeki odalar veya bir otomobilde ışıklar temsil eder.

Dijital bir ikizi oluşturmak için CreateDigitalTwin komutunu kullanın. İkizi 'in temel aldığı modele başvurmanız gerekir ve isteğe bağlı olarak modeldeki tüm özellikler için başlangıç değerlerini tanımlayabilir. Bu aşamada herhangi bir ilişki bilgisi iletmeniz gerekmez.

1. Daha önce güncelleştirdiğiniz Oda modeline ve başka bir model, kata göre birkaç TWINS oluşturmak için bu kodu çalışan proje konsolunda çalıştırın. Odanın üç özelliği olduğunu anımsayın, bu sayede bu özelliklerin başlangıç değerleriyle bağımsız değişkenler sağlayabilirsiniz. (Özellik değerlerini başlatmak genel olarak isteğe bağlıdır, ancak bu öğretici için gereklidir.)

   CreateDigitalTwin dtmi:example:Room;2 room0 RoomName string Room0 Temperature double 70 HumidityLevel double 30
   CreateDigitalTwin dtmi:example:Room;2 room1 RoomName string Room1 Temperature double 80 HumidityLevel double 60
   CreateDigitalTwin dtmi:example:Floor;1 floor0
   CreateDigitalTwin dtmi:example:Floor;1 floor1
   

   Bu komutların çıktısı, TWINS 'nin başarıyla oluşturulduğunu göstermelidir.

   

2. Komutu çalıştırarak TWINS 'nin oluşturulduğunu doğrulayabilirsiniz Query . Bu komut, içerdiği tüm dijital TWINS için Azure dijital TWINS örneğinizi sorgular. Sonuçlarda room0, room1, floor0 ve Floor1 TWINS ' i arayın.

Dijital ikizi değiştirme

Ayrıca, oluşturduğunuz bir ikizi özelliklerini de değiştirebilirsiniz.

1. Room0's RoomName öğesini "Room0" iken "PresidentialSuite" olarak değiştirmek için bu komutu çalıştırın:

   UpdateDigitalTwin room0 add /RoomName string PresidentialSuite
   

   Çıktı, ikizi başarıyla güncelleştirildiğini göstermelidir.

2. Room0'un bilgilerini görmek için bu komutu çalıştırarak güncelleştirmeyi başarılı bir şekilde doğrulayabilirsiniz:

   GetDigitalTwin room0
   

   Çıktı, güncelleştirilmiş adı yansıtmalıdır.

İlişkiler ekleyerek bir grafik oluşturma

Daha sonra, bu TWINS arasında bir ikizi grafiğinebağlanmak için bazı ilişkiler oluşturabilirsiniz. İkizi grafikleri tüm ortamı temsil etmek için kullanılır.

Bir ikizi arasında oluşturabileceğiniz ilişki türleri, daha önce yüklediğiniz modeller içinde tanımlanır. Taban için model tanımı , katörlerin içerir adlı bir ilişki türüne sahip olabildiğine göre, her bir tabandan içerdiği ilgili odaya bir Contains-Type ilişkisi oluşturulmasını mümkün kılan bir tür ilişkiye sahip olabilir.

Bir ilişki eklemek için CreateRelationship komutunu kullanın. İlişkinin geldiği ikizi, ilişki türü ve ilişkinin bağlandığı ikizi belirtin. Son olarak, ilişkiye benzersiz bir KIMLIK verin.

1. Daha önce oluşturduğunuz her bir tabandan bir "Contains" ilişkisini karşılık gelen odaya ikizi eklemek için aşağıdaki kodu çalıştırın. İlişkiler relationship0 ve relationship1 olarak adlandırılır.

   CreateRelationship floor0 contains room0 relationship0
   CreateRelationship floor1 contains room1 relationship1
   

   İpucu

   Ayrıca , taban modeldeki ilişki, iki dize özellikleriyle da tanımlanmıştır ownershipUser ve ownershipDepartment Bu sayede, ilişkileri oluştururken bunların başlangıç değerleriyle birlikte bağımsız değişkenler de sağlayabilirsiniz. Bu özelliklerin başlangıç değerlerini de belirten relationship0 oluşturmak için yukarıdaki komutun alternatif bir sürümü aşağıda verilmiştir:

   CreateRelationship floor0 contains room0 relationship0 ownershipUser string MyUser ownershipDepartment string myDepartment
   

   Bu komutların çıktısı, ilişkilerin başarıyla oluşturulduğunu onaylar:

   

2. İlişkileri, Azure dijital TWINS örneğiniz içindeki ilişkileri yazdıracak olan aşağıdaki komutlardan biriyle doğrulayabilirsiniz.

   • Her bir tabandan gelen tüm ilişkileri görmek için (ilişkiyi bir taraftan görüntüleme):

     GetRelationships floor0
     GetRelationships floor1
     

   • Her odaya ulaşan tüm ilişkileri görmek için ("diğer" taraftan ilişkiyi görüntüleme):

     GetIncomingRelationships room0
     GetIncomingRelationships room1
     

   • Bu ilişkileri tek tek aramak için KIMLIĞE göre:

     GetRelationship floor0 relationship0
     GetRelationship floor1 relationship1
     

Bu öğreticide ayarladığınız TWINS ve ilişkiler aşağıdaki kavramsal grafiği oluşturur:

Ortam sorularını yanıtlamak için ikizi grafiğini sorgulama

Azure dijital TWINS 'in ana özelliği, ortamınız hakkında soruları yanıtlamak için ikizi grafınızı kolayca ve verimli bir şekilde sorgulayabilir .

Örnek ortamla ilgili bazı sorulara yanıt vermek için çalışan proje konsolunda aşağıdaki komutları çalıştırın.

1. Ortamınızdaki Azure dijital TWINS 'te gösterilen tüm varlıklar nelerdir? (tümünü sorgula)

   Query
   

   Bu komut, ortamınızı bir bakışta almanıza olanak sağlar ve her şeyin Azure dijital TWINS 'in içinde olmasını istediğiniz şekilde gösterildiğinden emin olun. Bu komutun sonucu, her dijital ikizi ayrıntılarını içeren bir çıktıdır. İşte bir alıntı:

   

   İpucu

   Örnek projede, Query ek bağımsız değişken içermeyen komutu ' nin eşdeğeridir Query SELECT * FROM DIGITALTWINS . Sorgu API 'lerini veya CLI komutlarınıkullanarak örneğinizdeki tüm TWINS 'leri sorgulamak için, daha uzun (tamamlanmış) sorguyu kullanın.

2. Ortammdaki tüm odalar nelerdir? (modele göre sorgu)

   Query SELECT * FROM DIGITALTWINS T WHERE IS_OF_MODEL(T, 'dtmi:example:Room;2')
   

   Hangi bilgilerin temsil edildiği hakkında daha ayrıntılı bilgi edinmek için sorgunuzu belirli bir türden TWINS ile kısıtlayabilirsiniz. Bunun sonucu, room0 ve room1 gösterir, ancak floor0 veya Floor1 göstermez ( Odalar olmadığından, bu olduklarından).

   

3. Floor0 üzerindeki tüm odalar nelerdir? (ilişkiye göre sorgulama)

   Query SELECT room FROM DIGITALTWINS floor JOIN room RELATED floor.contains where floor.$dtId = 'floor0'
   

   TWINS 'in nasıl bağlı olduğu hakkında bilgi edinmek veya sorgunuzu belirli bir alanla kısıtlamak için grafiğinizde ilişkiler temelinde sorgulama yapabilirsiniz. Yalnızca room0 floor0, bu nedenle sonuçtaki tek yer.

   

4. 75 üzerinde sıcaklık olan ortammdaki tüm TWINS nedir? (özelliğe göre sorgu)

   Query SELECT * FROM DigitalTwins T WHERE T.Temperature > 75
   

   Ortamınızda dikkat etmeniz gerekebilecek aykırı değerleri bulma dahil olmak üzere çeşitli soruları yanıtlamak için, özellikleri temel alarak grafik sorgulama yapabilirsiniz. Diğer karşılaştırma işleçleri ( < , > , = veya ! =) de desteklenir. room1, 80 sıcaklığını içerdiğinden burada sonuçlarda görüntülenir.

   

5. 75 üzerindeki sıcaklığa sahip floor0 üzerindeki tüm odalar nelerdir? (bileşik sorgu)

   Query SELECT room FROM DIGITALTWINS floor JOIN room RELATED floor.contains where floor.$dtId = 'floor0' AND IS_OF_MODEL(room, 'dtmi:example:Room;2') AND room.Temperature > 75
   

   SQL gibi önceki sorguları,, gibi birleşik işleçler kullanarak da birleştirebilirsiniz AND OR NOT . Bu sorgu AND , önceki ikizi sıcaklıklar hakkında daha belirgin bir sorgu oluşturmak için kullanır. Sonuç artık yalnızca, floor0 üzerinde olan 75 üzerinde sıcaklık olan odaları (Bu durumda, bunlardan hiçbiri) içerir. Sonuç kümesi boş.

   

Kaynakları temizleme

Bu Öğreticiyi tamamladıktan sonra, ne yapmak istediğinize bağlı olarak kaldırmak istediğiniz kaynakları seçebilirsiniz.

• Sonraki öğreticiye devam etmeyi planlıyorsanız, bu Azure dijital TWINS örneğini ve yapılandırılmış örnek uygulamayı bir sonraki öğreticide kullanmaya devam etmek için burada ayarladığınız kaynakları koruyabilirsiniz

• Azure dijital TWINS örneğini kullanmaya devam etmek, ancak tüm modellerini, TWINS ve ilişkilerini temizlemek istiyorsanız, örnek uygulama DeleteAllTwins ve komutlarını kullanarak, DeleteAllModels örneğiniz içindeki TWINS ve modelleri temizleyebilirsiniz.

• Bu öğreticide oluşturduğunuz kaynaklara ihtiyacınız yoksa az group delete komutuyla Azure Digital Twins örneğini ve diğer tüm kaynakları bu makaleden silebilirsiniz. Bu, kaynak grubunun yanı sıra bir kaynak grubunda yer alan tüm Azure kaynaklarını siler.

  Önemli

  Silinen kaynak grupları geri alınamaz. Kaynak grubu ve içindeki tüm kaynaklar kalıcı olarak silinir. Yanlış kaynak grubunu veya kaynakları yanlışlıkla silmediğinizden emin olun.

  komutunu Azure Cloud Shellve kaynak grubunu ve içerdiği her şeyi silmek için aşağıdaki komutu çalıştırın.

  az group delete --name <your-resource-group>
  

Yerel makinenizden proje klasörünü de silmek isteyebilirsiniz.

Sonraki adımlar

Bu öğreticide, örnek bir istemci uygulaması kullanarak Örneğinizde bir grafik oluşturarak Azure Digital TWINS ile çalışmaya başladıysanız. Bir grafik oluşturmak için modeller, dijital TWINS ve ilişkiler oluşturdunuz. Ayrıca, Azure dijital TWINS 'in bir ortam hakkında ne tür sorular yanıtlayabileceklerini öğrenmek için grafikte bazı sorgular da çalıştırdınız.

Azure dijital TWINS 'i diğer Azure hizmetleriyle birleştirerek veri odaklı, uçtan uca bir senaryoyu tamamlamaya yönelik sonraki öğreticiye geçin: