Aracılığıyla paylaş

Müşteri olarak sensör tümleştirmesi

  • Makale

İş ortağının verileri Tarım için Data Manager örneğine göndermeye başlamasını sağlamak için algılayıcı iş ortağıyla tümleştirme adımlarını izleyin.

Her algılayıcı iş ortağının, Tarım için Data Manager platformunda oluşturulmuş ve yayımlanmış kendi çok kiracılı Microsoft Entra uygulaması vardır. Platformda varsayılan olarak desteklenen sensör ortağı Davis Instruments'tır (sensorPartnerId: DavisInstruments).

Yerleşik sensör iş ortaklarını kullanmaya başlamak için algılayıcı iş ortağına onay vermeniz gerekir, böylece içinde görünmeye App Registrationsbaşlar. İzlemeniz gereken adımlar:

  1. "Genel Yönetici istrator" veya "Privileged Role Yönetici istrator" kimlik bilgilerini kullanarak Azure portalında oturum açın.

  2. Davis Instruments için bu bağlantıya tıklayarak onay sağlayın.

  3. İzin gözden geçirme sayfasında, Microsoft Entra uygulaması en düşük "kullanıcı profilini okuma" izni için istekte bulunur. Bu izin düzeyi, Tarım için Data Manager ile sensör tümleştirmesi için yeterlidir.

  4. Yönetici onayı vermek için "Kabul Et" düğmesine tıklayın.

  5. Şimdi, sayfadaki Tüm Uygulamalar sekmesinin App Registrations altına bakın Davis Instruments WeatherLink Data Manager for Agriculture Connector (resimde genel bir İş Ortağıyla gösterilmiştir).

    Screenshot showing the partners message.

  6. Erişim sağlamak istediğiniz iş ortağı uygulamasının Uygulama (istemci) kimliğini kopyalayın.

2. Adım: İş ortağı uygulamasına rol ataması ekleme

Sonraki adım, algılayıcı iş ortağı uygulamasına yetkilendirme sağlamak için Azure portalında roller atamaktır. Tarım için Data Manager, yetkilendirme isteklerini yönetmek için Azure RBAC kullanır.

Azure portalında oturum açın ve Tarım için Veri Yöneticisi kaynağını oluşturduğunuz Kaynak Grubunuz'a gidin.

Dekont

Kaynak grubu sekmesinin içinde, oluşturulan Tarım için Veri Yöneticisi kaynağını bulamazsanız gizli türleri göster onay kutusunu etkinleştirmeniz gerekir.

IAM (Kimlik Erişim Yönetimi) menü seçeneğini görüntüde gösterildiği gibi seçenek bölmesinin sol tarafında bulabilirsiniz:

Screenshot showing role assignment.

Rol ataması ekle'ye > tıklayın, bu eylem portalın sağ tarafında bir bölme açar ve açılan listeden rolü seçin:

  • AgFood Platform Algılayıcı İş Ortağı Katkıda Bulunanı - CRU (Oluşturma, Okuma, Güncelleştirme) işlemlerinde algılayıcılara özgü tüm ayrıcalıklara sahiptir.

Rol atamasını tamamlamak için aşağıdaki adımları uygulayın:

  1. Bahsedilen rolü seçin.

  2. Erişim atama bölümünde Kullanıcı, grup veya hizmet sorumlusu'na tıklayın.

  3. Algılayıcı iş ortağı Uygulama Adını veya Kimliğini Seç bölümüne yapıştırın (resimde gösterildiği gibi).

  4. Rolü atamak için Kaydet’e tıklayın.

Screenshot showing app selection for authorization.

Bu adım, algılayıcı iş ortağı uygulamasına Tarım kaynağı için Azure Data Manager'a erişim (atanan role göre) verilmesini sağlar.

3. Adım: Algılayıcı tümleştirmesini etkinleştirme

  1. Çağrıları başlatmadan önce algılayıcı tümleştirmesini etkinleştirmeniz gerekir. Bu adım, Tarım için Data Manager örneğinizde sensör tümleştirmesi için gerekli iç Azure kaynaklarını sağlar. Bunu yapmak için aşağıdaki armclient komutunu çalıştırabilirsiniz.

    armclient patch /subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.AgFoodPlatform/farmBeats/<farmbeats-instance-name>?api-version=2021-09-01-preview "{properties:{sensorIntegration:{enabled:'true'}}}"

    Örnek çıkış:

    {
  "id": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.AgFoodPlatform/farmBeats/<farmbeats-instance-name>",
  "type": "Microsoft.AgFoodPlatform/farmBeats",
  "sku": {
    "name": "A0"
  },
  "systemData": {
    "createdBy": "<customer-id>",
    "createdByType": "User",
    "createdAt": "2022-03-11T03:36:32Z",
    "lastModifiedBy": "<customer-id>",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2022-03-11T03:40:06Z"
  },
  "properties": {
    "instanceUri": "https://<farmbeats-instance-name>.farmbeats.azure.net/",
    "provisioningState": "Succeeded",
    "sensorIntegration": {
      "enabled": "True",
      "provisioningState": "**Creating**"
    },
    "publicNetworkAccess": "Enabled"
  },
  "location": "eastus",
  "name": "myfarmbeats"
}

  2. İşin tamamlanması birkaç dakika sürebilir. İşin durumunu öğrenmek için aşağıdaki armclient komutunu kullanabilirsiniz:

    armclient get /subscriptions/<subscription-id>/resourceGroups/<resource-group-name> /providers/Microsoft.AgFoodPlatform/farmBeats/<farmbeats-instance-name>?api-version=2021-09-01-preview

  3. Tamamlanmış durumu doğrulamak için provisioningState özniteliğine bakın. Durumun önceki adımda "Oluşturma" olan "Başarılı" olarak değiştirilmesi gerekir.

    Örnek çıkış:

    {
  "id": "/subscriptions/<subscription-id>/resourceGroups/<resource-group-name>/providers/Microsoft.AgFoodPlatform/farmBeats/<farmbeats-instance-name>",
  "type": "Microsoft.AgFoodPlatform/farmBeats",
  "sku": {
    "name": "A0"
  },
  "systemData": {
    "createdBy": "<customer-id>",
    "createdByType": "User",
    "createdAt": "2022-03-11T03:36:32Z",
    "lastModifiedBy": "<customer-id>",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2022-03-11T03:40:06Z"
  },
  "properties": {
    "instanceUri": "https://<customer-host-name>.farmbeats.azure.net/",
    "provisioningState": "Succeeded",
    "sensorIntegration": {
      "enabled": "True",
      "provisioningState": "**Succeeded**"
    },
    "publicNetworkAccess": "Enabled"
  },
  "tags": {
    "usage": "<sensor-partner-id>"
  },
  "location": "eastus",
  "name": "<customer-id>"
}

Algılayıcı tümleştirme adımı tamamlandıktan sonra sensör tümleştirme nesneleri oluşturabilirsiniz.

4. Adım: Tümleştirme nesnesi oluşturma

SensorPartnerIntegrations Belirli bir algılayıcı iş ortağı için tümleştirme nesnesi oluşturmak için koleksiyonu kullanın ve SensorPartnerIntegrations_CreateOrUpdate API'sine çağrı yapın. Bir algılayıcı iş ortağının her müşterisinin (örneğin: Davis) Tarım için Data Manager kaynağında benzersiz bir tümleştirme kimliği oluşturulması gerekir.

Değerlendirmeniz gereken iki farklı yol vardır:

  • Algılayıcı iş ortakları tarafından sağlanan algılayıcıların sahibi sizseniz sensör iş ortağıyla hesabınız için yalnızca bir tümleştirme nesnesi (ID) oluşturun.

  • Algılayıcılara son kullanıcılarınız (Çiftçiler/Perakendeciler/Tarımcılar) sahipse, her son kullanıcının algılayıcı iş ortağıyla kendi hesapları olduğundan her son kullanıcı için benzersiz bir tümleştirme nesnesi (ID) oluşturun.

API Uç Noktası: PATCH /sensor-partners/{sensorPartnerId}/integrations/{integrationID}

Onay bağlantısını isteyen bölüm, algılayıcı iş ortağı tümleştirme akışının bir parçasıdır. Bu onay bağlantısı, algılayıcı iş ortaklarının müşterinin hizmetin geçerli bir kullanıcısı olup olmadığını doğrulama yoludur. Algılayıcı tümleştirmesi onay anahtarına bağlıdır.

Algılayıcı ortağımız Davis Instruments , kurulumu etkinleştirmek ve onay bağlantısı istemek için bu kullanıcı arabirimini kullanır.

Algılayıcı iş ortakları, geçerliliği doğrulamak için API uç noktasını çağırır check-consent . Onay bağlantısı oluşturmak için API'yi kullanmanız SensorPartnerIntegrations_GenerateConsentLink ve (3) adımından oluşturulan tümleştirme kimliğini sağlamanız gerekir. Yanıt olarak consentLink adlı bir dize alırsınız. Bu dizeyi kopyalayın ve daha fazla doğrulama için algılayıcı iş ortağına sağlayın. Davis Instruments'ın algılayıcılarını kullanıyorsanız bu sayfadaki yönergeleri izleyin.

API Uç Noktası: PATCH /sensor-partners/{sensorPartnerId}/integrations/{integrationId}/: generate-consent-link

Bu adım, müşteri perspektifinden algılayıcı iş ortağı ekleme işleminin tamamlanmasını işaret eder. , Algılayıcı modeli, Cihaz modeli, Algılayıcılar ve Cihazlar oluşturmak için API uç noktalarınızı çağırmak için gerekli tüm bilgileri alın. İş ortakları artık her algılayıcı kimliği için oluşturulan bağlantı dizesi kullanarak algılayıcı olaylarını gönderebiliyor.

Son adım, algılayıcı olaylarını kullanmaya başlamaktır. Olayları kullanmadan önce, her algılayıcı kimliğini belirli bir Taraf Kimliği ve kaynağıyla (Alan, Mevsimsel Alan) eşlemeniz gerekir.

6. Adım: Algılayıcı eşlemesi oluşturma

SensorMappings Koleksiyonu kullanın, her algılayıcı için eşleme oluşturmak için API'ye çağrı SensorMappings_CreateOrUpdate yapın. Eşleme, algılayıcı kimliğini belirli bir PartyID ve bir kaynakla (alan, mevsimsel alan vb.) ilişkilendirmek dışında bir şey değildir. PartyID ve kaynaklar Tarım için Veri Yöneticisi sisteminde zaten mevcuttur. Bu ilişkilendirme, bir platform olarak kaynak ve taraf boyutunun ortak geometrisi etrafında veri bilimi modelleri oluşturmanızı sağlar. Her veri kaynağı (uydu, hava durumu, grup işlemleri) bir tarafa ve kaynağa bağlıdır. Bu eşleme nesnesini sensör düzeyinde kurarken, sensör verilerinden yararlanmak için tüm agronomik kullanım örneklerini güçlendirmiş olursunuz.

API Uç Noktası: PATCH /sensor-mappings/{sensorMappingId}

7. Adım: Algılayıcı olaylarını kullanma

API'ye SensorEvents çağrı SensorEvents_List yapmak ve algılayıcılarınız tarafından gönderilen verileri kullanmak için koleksiyonu kullanın. Aşağıdaki bilgileri sağlamanız gerekir

  • sensorId (verilerin gösterilmesini istediğiniz algılayıcıyı belirtir)
  • sensorPartnerId (bu verileri hangi algılayıcı ortağının gönderdiğini belirtir)
  • startDateTime &endDateTime (zaman aralığı filtreleri verilerin istenen zaman çizelgesine dilimlendiğinden emin olur)

API Uç Noktası: GET /sensor-events

Sonraki adımlar