Memetakan aliran data industri ke properti aset - AWS IoT SiteWise
Menetapkan alias properti (konsol)Menetapkan alias properti ()AWS CLI

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Memetakan aliran data industri ke properti aset

Anda dapat menentukan alias properti pada properti aset. Ini membantu Anda mengidentifikasi properti aset saat Anda menelan atau mengambil data aset. Jika aset Anda memiliki properti pengukuran, Anda dapat menentukan alias properti untuk memetakan aliran data Anda ke properti pengukuran tersebut.

Proses ini mengharuskan Anda mengetahui alias properti Anda.

  • Jika Anda menelan data dari server OPC UA menggunakan sumber data OPC UA di gateway SiteWise Edge, alias properti Anda adalah jalur ke variabel di bawah node Objects, dimulai dengan. /

    contoh

    Jika jalur ke variabel Anda adalahcompany/windfarm/3/turbine/7/temperature, maka alias properti Anda adalah/company/windfarm/3/turbine/7/temperature.

    Untuk informasi selengkapnya tentang arsitektur informasi OPC UA, lihat Pemetaan Model Informasi dan Spasi Alamat di Referensi Online OPC UA.

    Catatan

    • Jika Anda mengonfigurasi awalan aliran data untuk sumber OPC UA Anda, Anda harus menyertakan awalan tersebut dalam alias properti untuk semua aliran data dari sumber tersebut.

      contoh

      Jika /RentonWA adalah awalan, maka alias sebelumnya adalah. /RentonWA/company/windfarm/3/turbine/7/temperature

    • Alias properti dapat berisi hingga 1.000 byte. OPCJalur variabel UA dapat berisi hingga 4.096 byte. Saat ini, AWS IoT SiteWise tidak mendukung pengambilan data dari variabel OPC UA dengan jalur panjang.

  • Jika Anda menelan data dari server Modbus menggunakan sumber TCP data Modbus di gateway SiteWise Edge, alias properti Anda adalah:

    Modbus register set tag name

    Gunakan nilai ini untuk mengirim data dari register ini yang disetel ke properti aset.

  • Jika Anda menyerap data dari sumber lain, seperti menggunakan AWS IoT aturan atau API, Anda harus menentukan alias properti Anda. Anda dapat menentukan sistem penamaan alias properti yang berlaku untuk konfigurasi perangkat Anda. Misalnya, jika Anda menelan data dari AWS IoT berbagai hal, Anda dapat menyertakan nama benda dalam alias properti untuk mengidentifikasi aliran data secara unik. Untuk informasi lebih lanjut tentang contoh ini, lihat tutorial Menelan data dari AWS IoT hal-hal.

Alias properti harus unik dalam Wilayah dan AWS akun. AWS IoT SiteWise mengembalikan kesalahan jika Anda menetapkan alias properti ke salah satu yang sudah ada di properti aset lain.

Jika Anda memiliki beberapa sumber OPC UA dengan jalur aliran data yang identik, tambahkan awalan ke setiap jalur sumber untuk membentuk alias unik. Untuk informasi selengkapnya, lihat OPCSumber data UA.

catatan

Bagian ini menjelaskan cara mengatur alias properti untuk properti pengukuran. Untuk informasi selengkapnya tentang cara menyetel alias properti untuk properti status alarm eksternal, lihatPetakan aliran status alarm eksternal.

Menetapkan alias properti (konsol)

Anda dapat menggunakan AWS IoT SiteWise konsol untuk menyetel alias untuk properti aset.

Untuk menyetel alias properti (konsol)

  1. Navigasikan ke konsol AWS IoT SiteWise tersebut.

  2. Di panel navigasi, pilih Aset.

  3. Pilih aset yang ingin Anda tetapkan alias properti.

    Tip

    Anda dapat memilih ikon panah untuk memperluas hierarki aset untuk menemukan aset Anda.

  4. Pilih Edit.

  5. Temukan properti yang ingin Anda atur alias, lalu masukkan alias properti.

    AWS IoT SiteWise Tangkapan layar halaman “Edit aset” dengan alias properti yang disorot.

  6. Pilih Simpan.

Menetapkan alias properti ()AWS CLI

Gunakan AWS Command Line Interface (AWS CLI) untuk menetapkan alias untuk properti aset.

Anda harus mengetahui aset assetId dan properti Anda propertyId untuk menyelesaikan prosedur ini. Anda juga dapat menggunakan ID eksternal. Jika Anda membuat aset dan tidak mengetahuinyaassetId, gunakan ListAssetsAPIuntuk mencantumkan semua aset untuk model tertentu. Gunakan DescribeAssetoperasi untuk melihat properti aset Anda termasuk propertiIDs.

Gunakan UpdateAssetPropertyoperasi, untuk memetakan aliran data ke properti aset Anda. Tentukan parameter berikut:

  • assetId— ID aset atau ID eksternal. Untuk informasi selengkapnya, lihat Referensi objek dengan eksternal IDs di AWS IoT SiteWise Panduan Pengguna.

  • propertyId— ID properti aset atau ID eksternal.

  • propertyAlias— Jalur aliran data ke alias ke properti.

  • propertyNotificationState— Status pemberitahuan nilai properti: ENABLED atauDISABLED. Tentukan status notifikasi properti yang ada saat Anda memperbarui alias properti. Anda dapat mengambil status notifikasi yang ada dengan DescribeAssetPropertyoperasi.

    Jika Anda menghilangkan parameter ini, status notifikasi baru adalahDISABLED. Untuk informasi selengkapnya tentang pemberitahuan properti, lihatBerinteraksi dengan AWS layanan lain.

Untuk menetapkan alias properti ()AWS CLI

  1. Jalankan perintah berikut untuk mengambil status notifikasi properti saat ini. Ganti asset-id and property-id dengan properti aset tersebutIDs.

    aws iotsitewise describe-asset-property \
  --asset-id asset-id \
  --property-id property-id

    Operasi mengembalikan respons yang berisi rincian properti aset dalam format berikut. Status pemberitahuan properti ada assetProperty.notification.state di JSON objek.

    {
  "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
  "assetName": "Wind Turbine 7",
  "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
  "assetProperty": {
    "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
    "name": "Wind Speed",
    "notification": {
      "topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
      "state": "ENABLED"
    },
    "dataType": "DOUBLE",
    "unit": "m/s",
    "type": {
      "measurement": {}
    }
  }
}

  2. Jalankan perintah berikut untuk mengatur alias properti aset. Ganti property-alias dengan alias properti dan notification-state dengan status notifikasi, atau hilangkan --property-notification-state untuk menonaktifkan notifikasi. Anda dapat memperbarui unit aset secara opsional dengan yang baru unit dan--property-unit.

    aws iotsitewise update-asset-property \
  --asset-id asset-id \
  --property-id property-id \
  --property-alias property-alias \
  --property-notification-state notification-state \
  --property-unit unit

  3. Untuk memverifikasi alias telah disetel, jalankan perintah berikut untuk mengambil detail properti. Ganti asset-id and property-id dengan properti aset tersebutIDs.

    aws iotsitewise describe-asset-property \
  --asset-id asset-id \
  --property-id property-id

    Operasi mengembalikan respons yang berisi rincian properti aset dalam format berikut. Alias properti ada assetProperty.alias di JSON objek dan diatur ke myAlias dalam contoh ini.

    {
  "assetId": "a1b2c3d4-5678-90ab-cdef-22222EXAMPLE",
  "assetName": "Wind Turbine 7",
  "assetModelId": "a1b2c3d4-5678-90ab-cdef-11111EXAMPLE",
  "assetProperty": {
    "alias": "myAlias",
    "id": "a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
    "name": "Wind Speed",
    "notification": {
      "topic": "$aws/sitewise/asset-models/a1b2c3d4-5678-90ab-cdef-11111EXAMPLE/assets/a1b2c3d4-5678-90ab-cdef-22222EXAMPLE/properties/a1b2c3d4-5678-90ab-cdef-33333EXAMPLE",
      "state": "ENABLED"
    },
    "dataType": "DOUBLE",
    "unit": "m/s",
    "type": {
      "measurement": {}
    }
  }
}