Menambahkan transformasi ke jenis
Panduan ini menjelaskan cara menambahkan transformasi ke jenis tertentu di Manufacturing Data Engine (MDE).
Memilih transformasi
Ada beberapa transformasi yang tersedia di MDE. Paket konfigurasi default menyediakan dua transformasi yang dapat dikaitkan dengan salah satu Jenis yang tersedia dalam paket konfigurasi default tersebut:
- Transformasi Perubahan Peristiwa Grup: Transformasi ini memantau kolom apa pun dalam Tag atau grup Tag dan menghasilkan peristiwa setiap kali nilai yang dipantau berubah di salah satu Tag tersebut. Transformasi ini dapat dikaitkan dengan Jenis Arketipe apa pun.
- Transformasi Pengelompokan Jendela: Transformasi ini menerapkan fungsi Pengelompokan Jendela ke semua Tag dari suatu Jenis. Pengelompokan Jendela mengacu pada ringkasan beberapa rekaman selama jangka waktu tertentu dalam satu rekaman. Transformasi Pengelompokan Jendela dapat dikaitkan dengan Jenis Arketipe apa pun. Transformasi ini dapat meringkas rekaman Tag dari 1 menit hingga 60 menit. Hasil Transformasi adalah pesan mentah yang berisi nilai ringkasan untuk ekspresi nilai selama jangka waktu yang dipilih.
Paket konfigurasi default menyediakan Class Pesan, Parser, dan Jenis yang diperlukan untuk memproses pesan mentah yang dikeluarkan oleh kedua transformasi ini. Dua Jenis yang disediakan untuk memproses pesan mentah yang dihasilkan oleh setiap Transformasi adalah sebagai berikut:
group-event-change-records: Jenis tujuan untuk pesan output Transformasi Perubahan Peristiwa Grup.window-transformation-records: Jenis tujuan untuk pesan output Transformasi Pengelompokan Jendela.
Untuk mengaktifkan Transformasi, Transformasi yang ditentukan harus dipilih di antarmuka web Jenis atau dikaitkan dengan Jenis menggunakan endpoint Configuration API.
Mencantumkan transformasi yang tersedia
Untuk menjelajahi daftar transformasi yang tersedia di sistem MDE mana pun, ikuti langkah-langkah berikut:
REST
Ada endpoint Configuration Manager API khusus untuk mencantumkan transformasi yang tersedia:
GET /configuration/v1/transformations
Endpoint ini menampilkan JSON berikut dengan Transformasi yang tersedia dan kemampuannya:
{
"transformations": [
{
"name": "eventChange",
"displayName": "MDE Event Change",
"description": "Monitors the value of one or more tag that has a common group key. Fires an event whenever any of the contributing tags changes its value",
"disabled": false,
"sample": {
"keyExpression": {
"displayName": "Key Expression",
"description": "A SpEL expression that extracts the group key from the MDE message.proto which groups one or more tags as one unit whose values will be monitored for a change. The key must evaluate to a string",
"value": "#message['tagName']"
},
"valueExpression": {
"displayName": "Value Expression",
"description": "A SpEL expression that extracts the value from the MDE message.proto to be monitored for a change. The value must evaluate to a string",
"value": "#message['data']['numeric'].toString()"
}
}
},
{
"name": "window",
"displayName": "MDE Numeric Value Windowing",
"description": "Create a periodic stats event that provides values such as average, min, and max for an expression that extracts a numeric value from the tag messages",
"disabled": false,
"sample": {
"durationMinutes": {
"displayName": "Window Duration in Minutes",
"description": "A positive integer that represents how long the window will summarize events before producing the summary tag, this is in the granularity of minutes and it cannot be higher than 2 hours",
"value": "1"
},
"valueExpression": {
"displayName": "Value Expression",
"description": "A SpEL expression that extracts the value from the MDE message.proto to be used as the numeric value of the tags that will be summarized. The value must evaluate to a number, and it's internally out",
"value": "#message['data']['numeric']"
},
"id": {
"displayName": "Window Unique ID",
"description": "A unique ID that represents this instance of the window transformation, this should be unique if you are adding multiple instances of the window transformation to the same type",
"value": "1-min-window"
}
}
}
]
}
Konsol
Menggunakan antarmuka web, di bagian 'Jenis', buka Edit versi jenis menu untuk jenis tertentu dan luaskan bagian Transformasi & koneksi panel.
Mengaitkan transformasi ke Jenis
Mengaitkan Jenis yang ada ke Transformasi yang tersedia akan mengubah semua Tag dari Jenis tersebut. Hasil transformasi akan di-ingest sebagai Tag baru di MDE Jenis yang Ditransformasi. Nama Tag yang ditransformasi memiliki nama baru yang berasal dari Nama Tag asli dan nama transformasi.
Berikut langkah-langkah untuk mengaitkan Jenis ke Transformasi:
REST
Untuk mengaitkan transformasi ke Jenis tertentu, panggil PATCH
metode di endpoint Configuration Manager API ini:
PATCH /configuration/v1/types/TYPE_NAME/versions/VERSION_NUMBER
Isi permintaan harus berisi daftar Transformasi yang akan dilampirkan ke Jenis dan nilai untuk Parameter Konfigurasinya:
{
"transformations": [
{
"window": {
"id": "WINDOW_TRANSFORMATION_IDE",
"durationMinutes": WINDOW_TRANSFORMATION_MINUTES,
"valueExpression": "VALUE_EXPRESSION_VALUE"
}
},
{
"eventChange": {
"keyExpression": "KEY_EXPRESSION_VALUE",
"valueExpression": "VALUE_EXPRESSION_VALUE"
}
}
]
}
Ganti item berikut dalam panggilan contoh sebelumnya:
TYPE_NAME: nama Jenis yang akan diubah.VERSION_NUMBER: versi Jenis yang akan diubah.
Ganti item berikut di Isi untuk mengonfigurasi Transformasi Jendela:
WINDOW_TRANSFORMATION_ID: ID unik transformasi yang juga akan dilampirkan ke nama tag asli setelah diproses oleh transformasi.WINDOW_TRANSFORMATION_MINUTES: durasi, dalam menit, jendela yang akan diterapkanVALUE_EXPRESSION_VALUE: elemen proto tag yang akan dipantau sebagai kolom nilai. Untuk tag default numerik adalah#message['data']['numeric'].
Ganti item berikut di Isi untuk mengonfigurasi Transformasi Perubahan Peristiwa:
KEY_EXPRESSION_VALUE: elemen dalam proto tag yang digunakan untuk mengelompokkan tag yang harus dipantau bersama. Untuk memantau satu tag harus#message['tagName']VALUE_EXPRESSION_VALUE: elemen dalam proto tag yang digunakan untuk memantau perubahan nilai. Harus di-resolve keString. Dalam a tag default numerik adalah#message['data']['numeric'].toString().
Konsol
Untuk mengaitkan Transformasi ke Jenis, buka bagian antarmuka web 'Edit versi jenis' di tab 'Jenis'.
Luaskan bagian 'Transformasi & koneksi':
Untuk menambahkan Transformasi , pilih transformasi yang diperlukan dari daftar lalu klik 'TAMBAHKAN':
Kemudian, berikan parameter yang diperlukan dan klik 'SIMPAN':
Untuk Transformasi Jendela , parameternya adalah:
WINDOW_TRANSFORMATION_ID: ID unik transformasi yang juga akan dilampirkan ke nama tag asli setelah diproses oleh transformasi.WINDOW_TRANSFORMATION_MINUTES: durasi, dalam menit, jendela yang akan diterapkanVALUE_EXPRESSION_VALUE: elemen proto tag yang akan dipantau sebagai kolom nilai. Untuk tag default numerik adalah#message['data']['numeric'].
Untuk Transformasi Perubahan Peristiwa , parameternya adalah:
KEY_EXPRESSION_VALUE: elemen dalam proto tag yang digunakan untuk mengelompokkan tag yang harus dipantau bersama. Untuk memantau satu tag harus#message['tagName']VALUE_EXPRESSION_VALUE: elemen dalam proto tag yang digunakan untuk memantau perubahan nilai. Harus di-resolve keString. Dalam a tag default numerik adalah#message['data']['numeric'].toString().