Perangkat Lunak Sim Api SARTORIUS

Spesifikasi

• Nama Produk: Panduan SimApi
• Tanggal Rilis: 5 September 2024
• Tujuan: Menyediakan data ke produk Umetrics Suite

Petunjuk Penggunaan Produk

Pengantar SimApis

• SimApis digunakan untuk mengambil data untuk pembuatan proyek dan pembuatan model dalam produk Umetrics Suite.

Mendapatkan SimApis

• Untuk mendapatkan SimApis, lihat dokumentasi resmi atau hubungi dukungan pelanggan untuk bantuan.

Fitur SimApi

• SimApis menyediakan data waktu nyata untuk pemantauan, kontrol, dan pembangunan model di SIMCA dan SIMCA-online.

Hanya Penggunaan Data Saat Ini

• Disarankan untuk hanya menggunakan data terkini dan menghindari data historis demi kinerja optimal.

Mempersiapkan Instalasi SimApi

• Sebelum pemasangan, pastikan sistem Anda memenuhi persyaratan minimum yang ditentukan dalam panduan pengguna.

Memasang SimApi

• Ikuti petunjuk langkah demi langkah yang disediakan dalam panduan pengguna untuk menginstal SimApi pada sistem Anda.

Menyiapkan SimApi untuk SIMCA

• Konfigurasikan pengaturan SimApi di SIMCA sesuai dengan pedoman yang diberikan.

Menyiapkan SimApi untuk SIMCA-online

• Siapkan SimApi untuk pengambilan data real-time dan operasi penulisan kembali di SIMCA-online.

Pengujian dan Pemecahan Masalah

• Setelah pemasangan, lakukan pengujian untuk memastikan fungsionalitas yang tepat. Jika terjadi masalah, lihat bagian pemecahan masalah dalam panduan pengguna.

Pengujian dari SIMCA-online

• Uji integrasi SimApi dari SIMCA-online untuk memverifikasi pengambilan data.

Pemecahan Masalah dengan Log Files

• Gunakan log SimApi file untuk mengidentifikasi dan menyelesaikan masalah instalasi atau operasional.

Konfigurasi Akun Layanan

• Pastikan konfigurasi akun layanan SIMCA-online yang benar demi kelancaran operasi.

Detail Teknis

• Lihat bagian 7 panduan pengguna untuk informasi teknis mendalam tentang SimApis.

Pengantar SimApis

• SimApi adalah antarmuka perangkat lunak antara perangkat lunak Umetrics® Suite dan sumber data. Tujuan utama SimApi adalah untuk menyediakan data ke SIMCA®-online atau SIMCA®.
• Sartorius Stedim Data Analytics AB mengembangkan SimApis untuk berbagai sumber data, seperti riwayat proses dan basis data tujuan umum.
• Dokumen ini menunjukkan apa itu SimApi, dan bagaimana SimApi digunakan dalam produk Umetrics Suite. Anda akan mempelajari cara merencanakan dan memasang SimApi, cara memecahkan masalah, dan cara menguji pemasangan. Bab terakhir berisi rincian teknis SimApi yang ditujukan untuk pengembang.

Tujuan SimApi: menyediakan data ke produk Umetrics Suite

• Tujuan utama SimApi adalah menyediakan data ke SIMCA-online atau SIMCA dari suatu sumber data. Sumber data tersebut bukan bagian dari SIMCA-online, tetapi dapat berupa suatu proses historis atau sistem lain yang menyimpan dan mengelola data tersebut.
• SimApi memaparkan hierarki node, yang sesuai dengan folder dalam file sistem. Setiap node dapat berisi node lain, atau tags. A tag sesuai dengan variabel. Untuk ini tags, data dapat diperoleh. Gambar menunjukkan tag, Temp, dipilih di node
• BakersYeastControlGood dalam sumber data di SIMCA-online. Ia juga menunjukkan nilai terbaru yang diambil dari sumber data.

Penggunaan SimApi di Umetrics Suite

• Perangkat lunak desktop SIMCA dapat menggunakan SimApi untuk mengambil data guna pembuatan proyek dan pembuatan model seperti yang diilustrasikan pada gambar berikut.
• SIMCA-online menggunakan SimApi untuk memperoleh data secara real-time untuk pemantauan dan pengendalian, serta menulis kembali data ke sumber data. Gambar berikut menunjukkan lokasi SimApi dalam sistem yang terdiri dari sumber data, server SIMCA-online, dan klien.

SimApis yang umum digunakan

• SimApi yang paling banyak digunakan adalah:
• PI AF SimApi untuk menghubungkan ke Sistem PI Aveva (sebelumnya OSIsoft).
• OPC UA SimApi
• ODBC SimApi – untuk akses umum ke database seperti SQL Server atau Oracle
• Semua SimApis yang tersedia tercantum bersama fitur-fiturnya di paragraf 3.

DBMaker SimApi untuk data simulasi

• DBMaker adalah aplikasi yang disertakan dengan instalasi server SIMCA-online. Aplikasi ini mensimulasikan sumber data, seperti history proses, dengan menggunakan tabel data yang telah dimuat sebelumnya, tempat pengamatan diberikan satu per satu ke SIMCA-online melalui DBMaker SimApi.
• DBMaker hanya digunakan untuk tujuan demonstrasi dan tidak dapat digunakan dalam produksi dengan data langsung dari sumber data. Lihat bantuan bawaan untuk mempelajari lebih lanjut tentang DBMaker.

Dokumentasi tambahan

• Dokumen ini merupakan salah satu dari serangkaian dokumen terkait, masing-masing memiliki fokus dan target audiens yang berbeda:

Sumber	Apa	Di mana
SIMCA-online web halaman	Informasi pengantar dan unduhan	sartorius.com/umetrics-simca- on line

SIMCA-online ReadMe dan Instalasi.pdf	Instalasi dan cara memulai dengan SIMCA- data demo online	Di zip instalasi file
Panduan Implementasi SIMCA-online	Menguraikan fungsionalitas SIMCA-online, menaruhnya dalam konteks dengan perangkat lunak Umetrics Suite lainnya, menjelaskan persyaratan dan praktik terbaik untuk penerapan yang sukses, serta petunjuk instalasi langkah demi langkah.	sartorius.com/umetrics-simca- on line
Panduan SimApi	Mempersiapkan dan menjalankan instalasi SimApi, termasuk pemecahan masalah. Juga berisi rincian teknis tentang SimApi untuk pengembang.	sartorius.com/umetrics-simapi
Panduan Pengguna SimApi	Dokumentasi untuk setiap SimApi yang diterbitkan dengan fitur, petunjuk instalasi, dan spesifikasi konfigurasi.	sartorius.com/umetrics-simapi
Panduan Teknis SIMCA-online	Referensi teknis untuk perencanaan instalasi server SIMCA-online, pemecahan masalah, dan cara kerja SIMCA-online secara mendalam.	sartorius.com/umetrics-simca-on line
Bantuan SIMCA-online	WebBantuan berbasis web tentang cara menggunakan SIMCA-online dan cara kerja SIMCA-online.	Dalam perangkat lunak itu sendiri, dan di sartorius.com/umetrics-simca
SIMCA-online Web Panduan Instalasi Klien	Menjelaskan instalasi SIMCA-online Web Klien.	sartorius.com/umetrics-simca-on line
Basis pengetahuan Umetrics	Basis data yang dapat dicari dengan artikel tentang setiap versi perangkat lunak yang dirilis, artikel teknis, dan masalah yang diketahui dalam produk Umetrics Suite.	sartorius.com/umetrics-kb
Bantuan/panduan pengguna SIMCA	Cara menggunakan SIMCA desktop untuk membuat proyek dan memodelkan data.	Di SIMCA dan seterusnya sartorius.com/umetrics-simca
Mendukung web halaman	Cara mendapatkan dukungan teknis.	sartorius.com/umetrics-support

Dukungan teknis

• Tim dukungan online Sartorius menjawab pertanyaan teknis tentang SimApis dan juga dapat meneruskan permintaan untuk peningkatan SimApis kepada orang yang tepat. Pelajari lebih lanjut di sartorius.com/umetrics-support.

Mendapatkan SimApis

• Kami menyediakan dokumentasi untuk SimApis yang tersedia dan tautan ke program instalasi di sartorius.com/umetrics-simapi.
• Setiap SimApi didokumentasikan dalam Panduan Pengguna.
• Panduan SimApi yang sedang Anda baca sekarang, melengkapi informasi tersebut dengan informasi pelengkap SimApi terkait perencanaan, instalasi, dan pemecahan masalah SimApi.

Fitur SimApi

• Tidak semua sumber data sama. SimApi tidak perlu mengimplementasikan semua fungsi dalam spesifikasi. Karena alasan ini, SimApi yang berbeda menawarkan fungsionalitas yang berbeda. Matriks berikut mencantumkan SimApi yang tersedia dan fitur-fiturnya.
• Fitur-fiturnya dijelaskan di bawah ini. Perhatikan bahwa tabel tersebut memiliki kolom terpisah untuk menunjukkan fitur mana yang tersedia di SIMCA-online dan SIMCA.

Fitur	Tujuan	Penggunaan SIMCA-online	Penggunaan SIMCA
Data sekarang	Membaca satu pengamatan dengan nilai terkini dari sumber data.	Eksekusi normal waktu nyata	–
Data historis	Membaca banyak pengamatan sekaligus dengan data historis dari sumber data.	Mengejar dan memprediksi data masa lalu, membuat proyek menggunakan File > Baru	Panduan Impor Basis Data untuk mengimpor data proses untuk pembuatan model.
Data diskrit	Membaca data laboratorium/IPC dari sumber data. Banyak pengamatan per kelompok.	Untuk proyek batch dengan fase atau kondisi batch yang dikonfigurasi untuk pengambilan data diskret.	–
Data batch	Membaca kondisi batch dan atribut kualitas akhir (atau	Kondisi batch atau pemusatan lokal.	Wizard Impor Basis Data untuk membaca kondisi batch untuk

Fitur	Tujuan	Penggunaan SIMCA-online	Penggunaan SIMCA
	data tipe MES lainnya). Satu observasi per batch.		pembuatan model tingkat batch.
simpul batch	Tentukan waktu mulai dan waktu berakhir (kosong untuk batch aktif) untuk batch tertentu. Hitung semua batch yang ada dalam rentang waktu tertentu.	Diperlukan untuk eksekusi konfigurasi batch.	Panduan Impor Basis Data untuk memilih batch yang akan diimpor.
Tulis kembali – data berkelanjutan	Tulis data berkelanjutan, seperti prediksi, kembali ke sumber data.	Menulis kembali data dari tingkat evolusi batch, untuk Control Advisor atau untuk konfigurasi berkelanjutan	–
Tulis kembali – diskrit	Tulis data diskrit, seperti prediksi, kembali ke sumber data.	Menulis kembali untuk konfigurasi batch pada tingkat evolusi batch untuk fase yang dikonfigurasi untuk pengambilan data diskrit	–
Tulis kembali – data batch	Tulis kembali data tingkat batch, seperti prediksi atau atribut kualitas akhir, ke sumber data.	Tulis kembali untuk konfigurasi batch di tingkat batch	–
Hirarki simpul	SimApi mendukung hierarki node, mirip dengan file sistem. Setiap node dapat berisi tags dan node lainnya. Hirarki membuat lebih mudah untuk mengelola sejumlah besar node dan tags.	Didukung di semua tempat dimana tags digunakan.
Susunan tag ekspansi	Sebuah susunan tag menyimpan beberapa nilai. SimApi memperluas array tag terlalu banyak individu tags, satu untuk setiap elemen dalam array.	Didukung dimana tags digunakan untuk data berkelanjutan. Setiap data yang diperluas tag harus dipetakan ke variabel dalam proyek SIMCA.
Beberapa sumber data	SimApi dapat terhubung ke lebih dari satu sumber data atau mendukung beberapa contoh dirinya sendiri dengan pengaturan dan log individual files untuk setiap contoh.	Hubungkan ke beberapa sumber data berbeda yang jenisnya sama.	–
Ketahanan koneksi	Jika SimApi terputus dari sumber data, ia akan mencoba membangun kembali koneksi secara otomatis.	SimApi tidak perlu dihidupkan ulang untuk membangun kembali koneksi ke sumber data.	–
Dikembangkan di dalam negeri	SimApi dikembangkan, disediakan dan didukung oleh

Hanya data terkini, tanpa data historis, tidak direkomendasikan

• Beberapa SimApi, terutama OPC DA, hanya mendukung pembacaan data terkini dan tidak mendukung data historis.
• SimApi yang hanya mendukung data saat ini tidak dapat digunakan dalam SIMCA desktop, karena tidak akan dapat membaca data historis untuk membangun model.
• Untuk SIMCA-online, kami sangat menyarankan sumber data dan SimApi yang tidak hanya menyediakan data terkini untuk eksekusi waktu nyata, tetapi juga data historis untuk dapat memprediksi dan mengejar data masa lalu. SIMCA-online secara otomatis beralih antara data waktu nyata dan data historis sesuai kebutuhan dan ini tidak dapat dinonaktifkan.
• Sumber data yang hanya menyediakan data terkini, tetapi bukan data historis, dapat berfungsi untuk proyek berkelanjutan di SIMCA-online, tetapi untuk proyek batch, data historis diperlukan.

Mempersiapkan instalasi SimApi

• Bagian ini menjelaskan informasi penting untuk instalasi SimApi yang berhasil.

SimApis 64-bit atau 32-bit

• Ada versi 32-bit dan 64-bit dari setiap SimApi.
• SIMCA-online dan SIMCA adalah 64-bit dan memerlukan varian SimApis 64-bit. SimApis 32-bit yang lama masih tersedia untuk instalasi yang lebih lama.

Lokasi untuk log file dan pengaturan

• SimApi menyimpan lognya files di folder Data Program tersembunyi1:
  %programdata%\Umetrics\SimApi, di mana %programdata% dipetakan ke folder sebenarnya di komputer Anda. Secara default, folder tersebut adalah C:\ProgramData.
• Setiap SimApi biasanya menggunakan log-nya sendiri file, yang mirip dengan log server SIMCA-online file akan berisi lebih banyak atau lebih sedikit data tergantung pada pengaturan level log. Ini file berguna untuk pemecahan masalah. Log file bernama
  .log dimana adalah SimApi yang Anda instal, misalnyaample PIAFSimApi. Lihat juga bagian berikutnya untuk nama instans SimApi SIMCA-online.
• Folder ini juga berisi pengaturan SimApi dalam format XML file bernama File berformat .xml.
• Sebagian besar SimApi memiliki antarmuka pengguna grafis yang mengubah pengaturan dalam xml file, tetapi untuk beberapa Anda memasukkan perubahan langsung ke XML file dengan editor teks, seperti Notepad. Lihat panduan pengguna untuk setiap SimApi.

File nama ketika instance bernama digunakan dengan SIMCA-online

• Dalam SIMCA-online, setiap instance SimApi mendapatkan konfigurasinya sendiri file dan mencatat file untuk bekerja dengan beberapa contoh dari setiap SimApi. Nama-nama ini files diberi akhiran dengan nama instans seperti yang diberikan pada tab SimApi dalam dialog Opsi Server SIMCA-online.
• Berikut ini contohnyaample menunjukkan penamaan ini files, dimana perlu diganti dengan nama SimApi.
• Nama konfigurasi yang diberikan saat instance ditambahkan: OmegaServer
• Konfigurasi file nama: ServerOmega.xml
• Catatan file nama: OmegaServer.log
• Perhatikan bahwa generik file .catatan file masih dibuat. Log ini file berisi entri yang karena alasan teknis tidak dapat diarahkan ke log file dari kejadian-kejadian..
• Folder ini disembunyikan di Windows secara default. Untuk melihatnya di File Explorer Anda mengonfigurasinya untuk menunjukkan yang tersembunyi files. Perhatikan bahwa Anda dapat menavigasi ke folder tersembunyi dengan mengetikkan alamat di File Bilah alamat Explorer.
• Perhatikan bahwa SIMCA tidak mendukung beberapa contoh SimApi, dan oleh karena itu menggunakan nama tanpa nama contoh sebagaimana dijelaskan di atas.

Perencanaan jaringan

• Anda harus menempatkan server SIMCA-online di dekat sumber data dalam jaringan. Ini memastikan koneksi cepat antara SIMCA-online dan sumber datanya.
• Peralatan jaringan dapat mengganggu koneksi antara SIMCA-online dan sumber data.

Akun pengguna dan izin sumber data

• Sumber data biasanya mengontrol akses ke data mereka. Hal ini biasanya dilakukan dengan nama pengguna dan kata sandi, tetapi pembatasan berdasarkan alamat IP atau DNS juga dapat digunakan (misalnyaample PI Percaya pada Sistem Aveva PI).
• Nama pengguna dan kata sandi dapat diberikan ke sumber data dengan berbagai cara:
• SimApi dijalankan sebagai pengguna Windows dari pengguna yang menjalankan SIMCA desktop atau akun layanan SIMCA-online di komputer server. SimApi dapat terhubung ke sumber data menggunakan akun ini. Beginilah cara kerja OPC I, dan SimApi PI, dan ODBC jika Anda tidak memberikan kredensial saat mengonfigurasinya.
• Untuk ODBC generik, Anda dapat menggunakan aplikasi Administrator Sumber Data ODBC yang ditemukan di Mulai di Windows.
• Beberapa penyedia database menyediakan driver dan alat mereka sendiri untuk database mereka. Database Oracle, misalnyaample, gunakan Komponen Akses Data Oracle (ODAC).
• Beberapa SimApi, seperti PI AF dan ODBC, memiliki dialog konfigurasi yang menyimpan kredensial terenkripsi dalam konfigurasi SimApi XML file.
• PI juga memiliki berbagai opsi keamanan yang tersedia di PI System Management Tools pada komputer server PI. Baca selengkapnya di Panduan Pengguna PI AF SimApi. Panduan ini berguna meskipun Anda menggunakan OSIsoft PI SimApi yang lama.
• OPC DA dan HDA menggunakan DCOM sebagai transportasi antara sumber data dan SimApi. DCOM dikonfigurasi dengan alat Layanan Komponen (DCOMCNFG.EXE) di Windows dan menggunakan autentikasi Windows.
• Untuk OSIsoft PI SimApi yang lama (bukan AF SimApi yang lebih baru), aplikasi OSIsoft AboutPI-SDK (PISDKUtility.exe) digunakan untuk mengatur koneksi ke server PI.

Memverifikasi konektivitas sumber data
Saat Anda ingin memasang SimApi di komputer, ada baiknya memverifikasi konektivitas dari komputer tersebut ke sumber data dengan alat lain:

• Sumber Data ODBC di Windows digunakan untuk mengonfigurasi dan menguji ODBC generik. Perhatikan bahwa ada dua versi alat ini di Windows 64-bit: satu untuk aplikasi 32-bit dan satu untuk 64-bit. Gunakan tombol Uji Sumber Data di akhir panduan konfigurasi ODBC untuk memverifikasi konektivitas ke basis data. Kami sarankan Anda mengonfigurasi sumber data Anda sebagai DSN Sistem.
• Alat koneksi khusus basis data dari penyedia basis data, seperti Komponen Akses Data Oracle.
• PI System Explorer dapat digunakan untuk menguji konektivitas ke server PI AF. Ini adalah bagian dari PI AF Client yang merupakan prasyarat untuk PI AF SimApi.
• OPC UA Expert dari Unified Automation – UaExpert adalah klien pengujian lintas platform untuk server OPC UA.
• Aplikasi PI-SDK (PISDKUtility.exe) dapat digunakan untuk menguji konektivitas dan untuk view pesan kesalahan apa pun yang mungkin telah dicatat saat SIMCA-online mencoba terhubung ke server PI. Ini hanya digunakan untuk OSIsoft SimApi yang lebih lama, bukan PIAF.
• Alat Manajemen Sistem PI digunakan pada komputer server PI untuk pemecahan masalah dari sisi tersebut. Misalnyaample, untuk mencari masalah keamanan yang mencegah akses dari server SIMCA-online. Pelajari lebih lanjut tentang pemecahan masalah sistem PI dalam video YouTube ini.
• Excel dapat digunakan untuk memperoleh data dari koneksi ODBC dan sebagian besar sistem lainnya ketika plugin yang sesuai diinstal.
• Matrikon OPC Explorer untuk Ior HDA (ini adalah alat terpisah) dapat digunakan untuk menguji konektivitas OPC, dan Matrikon OPC Analyzer dapat digunakan untuk mendiagnosis masalah konektivitas OPC. Unduh alat gratis ini dari https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (untuk DInd HDA) dari Lembaga Pelatihan OPC web situs “memungkinkan pengguna untuk dengan mudah mendiagnosis masalah komunikasi dan keamanan, dan memperbaikinya secara instan dengan menekan sebuah tombol. Semua ini dapat dilakukan tanpa harus belajar mengonfigurasi DCOM“

Memasang SimApi

Berikut cara menginstal SimApi di PC:

1. Baca Panduan Pengguna untuk SimApi yang sedang Anda instal. Panduan ini berisi hal-hal spesifik untuk SimApi tersebut yang melengkapi petunjuk umum yang sedang Anda baca sekarang.
2. Instal dan konfigurasikan prasyarat apa pun yang disebutkan dalam Panduan Pengguna SimApi (misalnyaampdriver database atau SDK)
3. Jalankan program pengaturan untuk menginstal SimApi. Instal versi 64-bit (x64) atau 32-bit (x86) yang sesuai dengan perangkat lunak yang akan Anda gunakan.
4. Konfigurasikan SimApi di SIMCA-online atau SIMCA seperti yang dijelaskan di bagian berikut dan lihat panduan pengguna SimApi untuk deskripsi pengaturan yang tersedia.
5. Jalankan server SIMCA-online. Perlu dicatat bahwa ini dapat memakan waktu, karena ketika SimApi diinisialisasi, ia akan menghitung semua tags dalam sumber data.
6. Uji SimApi dengan memperoleh beberapa data. Untuk SIMCA-online, Anda dapat menggunakan File > Ekstrak seperti dijelaskan dalam 6.1.
7. Jika SimApi gagal bekerja seperti yang diharapkan, lihat log SimApi fileuntuk pemecahan masalah, dan ke panduan pengguna SimApi.

Menyiapkan SimApi untuk digunakan di SIMCA

Berikut cara menggunakan SimApi di SIMCA:

1.  Mulai impor basis data dengan salah satu cara berikut:
   • a. Untuk membuat proyek baru di SIMCA: File > Proyek Reguler Baru atau Proyek Batch Baru. Pilih Dari basis data pada tab Beranda.
   • b. Untuk mengimpor kumpulan data dalam proyek yang ada di SIMCA: Dari kumpulan data pada tab Data pada proyek SIMCA yang terbuka.
2. Klik Tambahkan sumber data baru
3. Pilih SimApi sebagai jenis koneksi, klik tombol … dan cari .dll di folder instalasi, dan klik Buka.
4. Klik Konfigurasi dan rujuk Panduan Pengguna SimApi masing-masing cara membuat pengaturan.
5. Klik Uji koneksi sumber data untuk memverifikasi bahwa Anda dapat terhubung ke database. Ini dapat memakan waktu lama jika ada banyak tags dalam sumber data.
6. Klik OK untuk menyelesaikan konfigurasi.
7. Lihat bantuan SIMCA untuk cara bekerja dengan data yang diimpor.

Menyiapkan SimApi untuk digunakan di SIMCA-online

• Penting: Untuk dapat menggunakan SimApi, diperlukan lisensi server SIMCA-online. Instalasi demo SIMCA-online tidak memperbolehkan penggunaan SimApi.
• Untuk menambahkan SimApi ke sistem, Anda menjalankan Opsi Server SIMCA-online di PC server. Pelajari langkah-langkah detail dalam topik bantuan SICMA-online Menambahkan dan mengonfigurasi SimApi di server.
• Kiat: Jika Anda membuat perubahan pada SimApi, Anda dapat memulai ulang SimApi tersebut secara terpisah dari Opsi Server tanpa memulai ulang seluruh server.
• Untuk mengonfigurasi beberapa instance SimApi ini, ulangi langkah-langkah di atas dan gunakan nama yang unik untuk setiap instance. Baca selengkapnya tentang log dan konfigurasi yang berbeda files untuk contoh pada 4.2.

Menguji dan memecahkan masalah SimApi

• Bab ini membahas tentang pengujian dan pemecahan masalah instalasi SimApi.

Menguji SimApi dari SIMCA-online

• Setelah server SIMCA-online berhasil dimulai, Anda dapat menguji SimApi Anda di SIMCA-online (jika server tidak dimulai, lihat 6.2):
• Masuk ke server di klien SIMCA-online, dan navigasikan ke Ekstrak pada File tab. Ekstrak membantu Anda menguji SimApi dengan memperoleh data melaluinya:
• Node (“folder”) SimApi ditampilkan di kotak sebelah kiri. Tags untuk node yang dipilih ditampilkan di kanan atas.
• Data terkini dapat diuji dengan cepat hanya dengan mengklik view> pada tags yang menyediakan data proses berkelanjutan (lihat tangkapan layar)
• Klik kanan pada node untuk Menemukan batch dalam rentang waktu tertentu. Node tersebut harus merupakan node batch yang mengetahui tentang batch.
• Memilih tags dalam Ekstrak dan klik Berikutnya dan selesaikan panduan untuk memperoleh data menggunakan berbagai mode pengambilan data: data terkini, historis, batch, dan diskret.
• Bandingkan data yang diekstrak dengan apa yang Anda lihat di sumber data Anda menggunakan alat-alatnya. Pelajari lebih lanjut tentang pengujian dan validasi semua fitur SimApi di 7.13.

Pecahkan masalah SimApi menggunakan log SimApi file

• Jika server tidak memulai, SimApi tidak berfungsi seperti yang diharapkan atau ekstraksi gagal, Anda perlu berkonsultasi dengan log SimApi file yang memberi tahu Anda apa masalahnya. Aktifkan pencatatan tingkat Debug di log SimApi untuk mendapatkan detail selengkapnya. Lihat 4.2.
• Catatan: log server SIMCA-online tidak begitu berguna di sini. Log tersebut akan menunjukkan bagaimana SimApi dimuat dan diinisialisasi oleh server, tetapi detail spesifik SimApi ada di log-nya. file.

Gunakan akun layanan SIMCA-online yang tepat

• Saat Anda menguji akses ke sumber data, ingatlah bahwa Anda masuk sebagai pengguna tertentu di komputer server (biasanya akun pengguna Anda sendiri di domain Windows), tetapi akun layanan server SIMCA-online adalah akun yang berbeda, secara default LocalSystem, yang memiliki hak akses berbeda dibandingkan dengan akun pengguna Anda.
• Karena alasan ini, tidak jarang pengujian berfungsi saat dijalankan sebagai akun Anda, tetapi SIMCA-online gagal terhubung ke sumber data.
• Untuk mengatasi masalah ini, akses harus diberikan untuk akun yang digunakan oleh layanan server SIMCA-online. Biasanya, Anda mengubah LocalSystem ke akun layanan domain tertentu, dan memberikan hak ke akun ini. Perhatikan bahwa ini tidak berlaku jika SimApi menggunakan kredensial yang ditetapkan dalam konfigurasi SimApi karena kredensial ini diutamakan.

Detail teknis tentang SimApis

• Bab ini memberikan rincian teknis tentang cara kerja SimApi. Bab ini terutama ditujukan kepada pengembang yang ingin memahami SimApi untuk mengimplementasikan SimApi sebagai sumber data.
• Pengembang juga harus membaca bagian awal dokumen ini untuk pengenalan SimApis dan deskripsi fitur tingkat tinggi.

Kapan sebaiknya mempertimbangkan pengembangan SimApi dan kapan tidak?

Sebelum mempertimbangkan pengembangan SimApi untuk sumber data:

1. Selidiki apakah sudah ada SimApi yang dapat Anda gunakan. Mungkin Anda dapat mengaktifkan beberapa fitur di sumber data Anda untuk menggunakan salah satu SimApi yang ada, seperti OPC UA.
2. Bacalah dengan saksama dokumen ini dan referensinya dan selidiki apakah sumber data Anda memenuhi persyaratan: misalnyaample, perlu cukup cepat, menyediakan tidak hanya data terkini, tetapi juga data historis.

• Karena alasan ini, kami tidak menyarankan pengembangan SimApi yang terhubung ke perangkat keras atau instrumen tingkat rendah. Lebih baik menghubungkan instrumen tersebut ke history proses seperti Aveva PI System, dan membiarkannya memperoleh data dari instrumen, dan mencatatnya. Kemudian SimApi PIAF dapat digunakan untuk memperoleh data dari PI ke produk Umetrics.

Pengembangan SimApi dan spesifikasi SimApi

• Spesifikasi SimApi, SimApi-v2, berisi dokumentasi untuk semua fungsi C dalam SimApi yang perlu diimplementasikan oleh DLL SimApi serta beberapa panduan tentang cara mengembangkan SimApi.
• Implementasi SimApi menggunakan C atau C++ dalam banyak kasus berada pada level yang sangat rendah.
• Cara yang direkomendasikan, dan lebih mudah, untuk mengimplementasikan SimApi adalah dengan mendasarkannya pada ExampKode sumber leSimApi yang kami sediakan. Ini adalah contohampImplementasi SimApi yang menangani antarmuka C dan menerjemahkannya ke dalam .NET Framework tempat implementasi sebenarnya dibuat. Ia juga memiliki kode kerangka kerja untuk pencatatan, pengaturan, GUI konfigurasi, dan kode kerangka kerja lainnya.
• Untuk mengembangkan SimApi, tim pengembang memerlukan pengalaman dalam pengembangan Windows, .NET Framework, C, atau C++. Pengetahuan yang baik tentang sumber data yang harus dihubungkan dengan SimApi juga diperlukan, karena tujuan SimApi adalah untuk menerjemahkan permintaan data dari SIMCA-online atau SIMCA ke API sumber data. Implementasi SimApi bukanlah proyek satu kali, tetapi biasanya memerlukan dukungan berkelanjutan dan pemeliharaan sesekali.

Membaca atau menulis data

• SimApi memiliki tugas utama menyediakan data dari suatu sumber data. Tugas ini disebut membaca data.
• Sebagian besar implementasi SimApi juga mendukung penulisan data. Ini berarti menulis kembali data melalui SimApi ke sumber data. Penulisan data merupakan fitur opsional dalam SIMCA-online.

Tags dan Node

• A tag adalah pengenal kolom atau “variabel” dalam sumber data. tagNama 's digunakan untuk mengidentifikasi tagNama dalam node harus unik. SIMCA-online 18 adalah versi pertama yang mendukung node yang berisi sub node dan tag dengan nama yang sama. Misalnyaample: node Parent mungkin memiliki sub node yang disebut Batch dan tag disebut Batch.
• Node adalah sebuah wadah tagsSebuah node juga dapat berisi node lain, sama seperti bagaimana sebuah node file sistem memiliki folder dalam folder.
• Seperti di dalam file sistem, simpul dan tag nama dapat digabungkan menjadi jalur lengkap yang mengidentifikasi secara unik tag. Itu tag jalur digunakan dalam SIMCA-online atau SIMCA saat memilih tags untuk menggunakan. Sebuah tag jalur dimulai dengan nama instance SimApi diikuti oleh struktur node, dan diakhiri dengan tag nama, setiap item dipisahkan dengan titik dua (:). Misalnyaampsaya “:ODBCSQLServer:Node:SensorTag1”.

SimApi menghitung tags dan node saat startup

• Implementasi SimApi menelusuri server untuk mencari node dan tags di sumber data saat SimApi diinisialisasi dan melacaknya sehingga berbagai fungsi SimApi yang digunakan untuk enumerasi tags dan node dapat diimplementasikan.
• Inisialisasi SimApi tidak hanya terjadi saat server dinyalakan, tetapi juga dapat dipicu kembali oleh pengguna di SIMCA-online dengan fungsionalitas Refresh SimApi.

Sensitivitas huruf besar/kecil tag- dan nama node

• Tag Nama dan nama node peka huruf besar/kecil.
• Oleh karena itu, sebuah tag ditelepon "tag1” tidak sama dengan “Tag1” karena huruf “T” berbeda. Kami tidak menyarankan penggunaan tags atau nama node yang berbeda hanya pada huruf besar/kecilnya saja.

Node proses berkelanjutan 

• Ketika sebuah node berisi tags dengan data proses yang berkelanjutan, maka dapat disebut sebagai simpul proses. Dua tangkapan layar berikut menunjukkan representasi tabel simpul proses dengan data diikuti oleh gambar yang menunjukkan bagaimana simpul tersebut terlihat saat dipilih tags di SIMCA-online.

Node proses berkelanjutan harus independen dari batch, proses, atau waktu

• Agar berfungsi dengan baik di SimApi, sebuah node harus independen dari batch, proses, atau waktu. Memiliki node yang berisi data untuk batch atau rentang waktu tertentu tidak akan berfungsi dengan baik di SIMCA-online karena konfigurasi proyek kemudian hanya dapat membaca data untuk batch tersebut dan tidak dapat digunakan untuk batch lainnya.
• Sebaliknya, suatu node harus dipetakan ke satu atau lebih unit fisik dalam proses di mana pengukuran dilakukan.

ID Kelompok tag diperlukan dalam node proses berkelanjutan untuk eksekusi proyek batch

• Setiap proses yang berkesinambungan harus memiliki tag (variabel) yang menyimpan pengenal kelompok untuk setiap pengamatan. Pengenal kelompok ini digunakan oleh SIMCA atau SIMCA-online untuk mengetahui kelompok mana yang termasuk dalam setiap pengamatan.
• ID $Batch tag di screenshot di 7.4.3 ada ex seperti ituampsaya.
  Meskipun tidak diwajibkan, namun disarankan untuk memiliki tag di simpul proses yang menunjukkan fase atau langkah proses saat ini. Ini tag kemudian dapat digunakan dalam kondisi eksekusi fase di SIMCA-online atau di SIMCA saat mengimpor data. Nilai untuk ini tag bisa untuk example “fase1”, “pembersihan”, “fase2”.

Node konteks batch

• Node batch adalah node yang melacak batch; pengidentifikasi batch, waktu mulai, dan waktu berakhir. Node ini merupakan persyaratan untuk pelaksanaan proyek batch di SIMCA-online. Sumber data dapat memiliki lebih dari satu node batch yang memaparkan batch dengan cara yang berbeda. Pengguna memilih node batch yang berlaku untuk aplikasinya. Node iniample memaparkan batch yang mencakup dua unit berbeda:
• /Factory1 – batch dengan masa pakai agregat pada Unit1 dan Unit2.
• /Factory1/Unit1 – batch dengan masa pakai hanya di Unit1
• /Factory1/Unit2 – batch dengan masa pakai hanya di Unit2
• Jika Anda tidak memiliki node batch di sumber data Anda, Anda dapat menggunakan Batch Context Generator di SIMCA-online. Lihat bantuan bawaan.
• Data batch opsional
• Node batch juga dapat berisi data batch; data yang hanya memiliki satu observasi untuk seluruh batch. Perhatikan bahwa tags dengan data batch tidak perlu berada di node yang memiliki fungsionalitas penuh dari node batch. Cukup jika SimApi mendukung pembacaan data batch untuk tagsPelajari lebih lanjut tentang data batch di 7.6.
• Ini adalah mantanample dari node batch:
• Catatan: Cuplikan layar di atas diambil dari DBMaker, dibundel dengan SIMCA-online. Untuk melihatnya sendiri di DBMaker, klik View Tombol data pada pangkalan data Ragi Roti untuk menampilkan dua jendela, yang satu adalah simpul batch, dan yang lainnya adalah data proses.

Tipe data: data numerik, data teks, dan data hilang

• Untuk setiap tag, SimApi dapat mendukung tiga jenis data: numerik, teks, dan hilang:
• Data numerik biasanya merupakan nilai riil dari parameter proses, misalnyaample 6.5123. SimApi hanya dapat menangani nilai floating point presisi tunggal 32-bit. Format floating point presisi tunggal -Wikipedia. Semua tipe data numerik lainnya dalam sumber data harus dikonversi ke float. Dengan demikian, mereka dapat menangani nilai besar dan kecil tetapi hanya dengan sekitar 6 atau 7 digit signifikan. Pelajari lebih lanjut dalam Panduan Teknis.
• Hal ini dapat menyebabkan hilangnya presisi untuk bilangan bulat besar atau bilangan riil yang besar dan memiliki desimal. Untuk informasi lebih lanjut, lihat Panduan Teknis.
• Data teks/string digunakan untuk ID batch, kondisi pelaksanaan fase, atau untuk variabel kualitatif. Nilai untuk teks tag data peka huruf besar/kecil. Ini berarti bahwa nilai “berjalan” tidak sama dengan
  “BERJALAN”. Variabel datetime tidak didukung secara langsung oleh SimApi, tetapi dapat dikembalikan sebagai string yang diformat sebagai YY-MM-DD HH:MM (misalnyaample “2020-09-07 13:45”).
• Nilai yang hilang berarti tidak ada nilai untuk dikembalikan, yaitu tidak ada data.
• Tipe yang dikembalikan bergantung pada implementasi SimApi. SimApi mengetahui data dalam sumber data dan harus mengembalikan tipe data yang paling sesuai.

Tiga mode pengambilan data: Kontinu, Batch, dan Diskrit

• Spesifikasi SimApi mendefinisikan tiga mode pengambilan data, yaitu tiga cara berbeda SimApi dapat menyediakan data dari tags di sumber data (atau ke arah lain: menulis data ke tags dalam sumber data).
• Pengambilan data berkelanjutan – ini mengacu pada pembacaan data secara terus-menerus, dan berurutan, pengamatan per pengamatan seiring dengan perkembangan batch atau proses. Data dibaca untuk waktu saat ini, atau untuk rentang tertentu, pada interval reguler di antara pengamatan. Misalnyaample, semua data antara 09:00:00 dan 10:00:00 sampdipimpin setiap 60 detik, menghasilkan 61 pengamatan saat titik akhir inklusif.
• Pengambilan data batch – ini merujuk pada satu observasi dengan data untuk seluruh batch (tidak terkait dengan jatuh tempo atau titik waktu tertentu). Atribut batch dan data pemusatan lokal dibaca sebagai data batch di SIMCA-online. Kondisi batch biasanya juga dibaca sebagai data batch (kecuali jika dikonfigurasi untuk pengambilan data diskret).
• Pengambilan data diskret – data diskret dapat terdiri dari beberapa observasi untuk banyak kematangan. Namun tidak seperti data kontinu, data diskret tidak dibaca secara berurutan melainkan semua data sekaligus untuk fase tertentu dari suatu batch. Data tidak perlu diberi jarak dengan interval reguler dari variabel kematangan. Semua data dibaca ulang setiap kali data diminta, pada interval yang dikonfigurasi.
• Untuk setiap hal yang diberikan tag data dapat diminta dalam salah satu dari tiga mode, tetapi biasanya SimApi hanya akan mendukung salah satu mode ini untuk individu tagDemikian pula diperbolehkan untuk mencampur tags dalam sebuah node, tapi biasanya semua tags dalam node tertentu mendukung mode pengambilan data yang sama.
• Untuk data berkelanjutan (tetapi tidak untuk data batch atau diskret2), permintaan dapat diajukan untuk data terkini atau data historis yang merupakan topik bagian berikutnya.
• Tidak semua SimApi mendukung semua mode. Lihat matriks fitur di atas dan SimApi web halaman untuk rinciannya.

Data berkelanjutan saat ini dan historis melalui SimApi

• Data berkelanjutan merujuk pada data proses yang berubah seiring waktu.

Data sekarang

• Membaca data terkini berarti meminta sumber data untuk memberikan nilai terbaru tags pada saat bertanya. Perhatikan bahwa waktu sumber data eksternal tidak digunakan di sini.
• Data yang dibaca sebagai data terkini adalah data yang akan ditampilkan oleh SIMCA-online sebagai data langsung. Oleh karena itu, penting agar tidak terjadi penundaan yang tidak perlu pada sumber data. Data terkini harus sebaru mungkin agar dapat berfungsi dengan baik di SIMCA-online.
• Sumber data dapat menggunakan pengetahuannya tentang data dan seberapa lama nilai valid dan memutuskan untuk mengembalikan data yang hilang ketika data mentah untuk suatu titik waktu sudah terlalu lama. Misalnyaample: data diminta pada pukul 15:00:00 tetapi titik data terbaru dalam sumber data berasal dari pukul 03:00:00. Dalam kasus ini, data tersebut berusia 12 jam sehingga SimApi dapat memutuskan untuk mengembalikan nilai yang hilang (tidak ada data).

Data historis

• Membaca data historis berarti meminta sumber data untuk memberikan nilai satu atau lebih tags untuk rentang waktu tertentu dengan interval tertentu antara pengamatan. Perhatikan bahwa di sini, waktu lokal sumber datalah yang digunakan untuk menemukan data. Oleh karena itu, sinkronisasi waktu antara sumber data dan server penting.
• Data historis terdiri dari matriks data. Implementasi SimApi harus meminta data dari sumber data, danampbiarkan pada interval yang ditentukan dan buat matriks data untuk mengembalikan:
• Terkadang sumber data itu sendiri memiliki fungsi agregasi untuk mengembalikan data yang diproses, atau sampfungsi ling yang dapat digunakan untuk mengembalikan data yang benar.
• Untuk sumber data lainnya, SimApi harus meminta semua data dalam rentang waktu dan kemudian sampmengambil pengamatan yang tepat untuk menyusun matriks.
• Data harus dikembalikan untuk rentang waktu tertentu, meskipun mungkin tidak ada data mentah dalam rentang waktu tersebut, tetapi hanya sebelum waktu mulai. Misalnyaample: data ada di sumber data pada titik waktu 10 dan 20. SimApi meminta data untuk waktu 15 dan 17. Dalam kasus ini, nilai untuk titik waktu 10 harus dikembalikan oleh SimApi tetapi timestampdicantumkan sebagai waktu 15 dan 17 karena ini merupakan titik data terbaru pada saat tersebut. Nilai untuk tags pada waktu 10 disebut sebagai nilai batas untuk rentang yang diminta. Untuk penjelasan lebih dalam tentang nilai batas, lihat misalnyaampbaca dokumentasi untuk returnBounds di UA Bagian 11: Akses Historis – 6.4.3 Struktur ReadRawModifiedDetails
  (opcfoundation.org)
• Interpolasi tidak boleh digunakan untuk menghitung nilai pada titik waktu mendatang, karena data tidak akan sesuai dengan apa yang terbaca secara real time sebagai data saat ini. Misalnya,ample dari poin sebelumnya: jika data untuk poin 15 dan 17 diinterpolasi menggunakan nilai untuk poin 10 dan 20, maka secara efektif mereka akan menggunakan nilai dari masa mendatang, yang mana hal ini tidak diperbolehkan.
• Sumber data dapat menggunakan pengetahuannya tentang data dan seberapa lama nilai valid dan memutuskan untuk mengembalikan data yang hilang ketika data mentah untuk suatu titik waktu sudah terlalu lama. Misalnyaample: data diminta untuk pukul 15:00:00 tetapi titik data terbaru dalam sumber data berasal dari pukul 03:00:00. Dalam kasus ini, data tersebut berusia 12 jam sehingga SimApi dapat memutuskan untuk mengembalikan nilai yang hilang (tidak ada data).

Catatan: SIMCA-online biasanya tidak meminta lebih dari seratus observasi dalam satu panggilan selama pelaksanaan proyek normal. Saat melakukan ekstraksi di SIMCA-online, atau saat menjalankan SIMCA desktop, permintaan data yang lebih besar dapat dilakukan. Permintaan ini dapat memakan waktu lama, yang memang sudah diharapkan.

Data saat ini dan data historis harus cocok

• Terkadang terdapat perbedaan saat data dibaca sebagai data terkini atau data historis. Hal ini menyebabkan masalah dalam SIMCA-online karena server secara otomatis beralih antara data terkini dan historis sesuai kebutuhan.

Akuisisi data latensi rendah

• Bila sumber data digunakan oleh SIMCA-online secara real-time, penting agar data dalam sumber data tersebut terkini. Tidak boleh ada penundaan yang tidak perlu dalam akuisisi data di sumber data tersebut. Data proses berkelanjutan untuk semua variabel harus tersedia pada waktu yang sama untuk setiap observasi. Data yang datang terlambat untuk beberapa variabel tidak akan diambil oleh SIMCA-online.

Data dapat dibaca kapan saja 

• Ketika SIMCA-online meminta nilai tag untuk waktu t, server akan menerima nilai dari sumber data sejak waktu t, atau pengamatan terbaru dalam sumber data sebelum waktu t, atau nilai yang diinterpolasi untuk waktu t. Dengan demikian, server akan selalu mendapatkan nilai setiap kali diminta, meskipun pengamatan untuk titik waktu yang tepat ini mungkin tidak ada dalam sumber data.
• Waktuampdalam SimApi selalu UTC. Klien SIMCA-online dan SIMCA menyajikan waktu sebagai waktu lokal.

Pemasangan benang 

• SimApi, secara default, dipanggil oleh satu thread oleh pengguna SimApi. Hal ini berlaku untuk semua versi SIMCA dan SIMCA-online hingga versi 17.
• SIMCA-online 18 mendukung fitur bendera untuk mengaktifkan akses multi-utas melalui SimApi. Baca selengkapnya di topik bantuan Akses SimApi serentak.
• Artinya SimApis harus bersiap untuk multi-threading, jika memungkinkan, dengan membuat thread implementasi SimApi aman, dan mendokumentasikan hal ini serta segala pertimbangan bagi pengguna SimApi.

Catatan file

• SimApi harus mencatat tindakan, pesan kesalahan dan peringatan ke lognya file untuk membantu pemecahan masalah. Gunakan berbagai tingkat log untuk menunjukkan pentingnya pencatatan.
• Disarankan untuk mencatat “Tidak diimplementasikan” untuk fitur yang belum diimplementasikan dalam SimApi.

Penanganan kesalahan

• Ketika SimApi tidak dapat memenuhi permintaan dari sumber data, ia dapat menangani masalah ini dengan salah satu dari dua cara; dengan mengembalikan nilai yang hilang (tidak ada data) atau dengan memberi sinyal kesalahan SimApi:
• Mengembalikan nilai yang hilang ke pemanggil dan menandakan keberhasilan memungkinkan pemanggil untuk melanjutkan seperti biasa (tetapi tentu saja tanpa data apa pun). Ini adalah praktik yang direkomendasikan untuk kesalahan parsial seperti ketika data dapat diperoleh untuk beberapa, tetapi tidak semua, tags dalam sebuah permintaan.
• Menandakan kesalahan SimApi memungkinkan pemanggil (misalnyaamp(le server SIMCA-online) untuk segera melihat hal ini dan mengambil tindakan. Ini adalah praktik yang direkomendasikan untuk permintaan yang gagal total dan tidak dapat mengembalikan data apa pun.
• SIMCA-online menangani nilai yang hilang atau kode kesalahan secara berbeda, seperti yang dijelaskan dalam Panduan Teknis SIMCA-online.

Persyaratan kinerja SimApi

• Fungsi dalam SimApi digunakan untuk memperoleh data.
• Jika akses data lambat, SimApi tidak akan bekerja dengan baik yang mana iniample menunjukkan: Jika SIMCA-online meminta data setiap detik, namun membutuhkan waktu dua detik untuk memperolehnya, server SIMCA-online tidak akan pernah mampu mengimbangi secara real-time tetapi akan semakin tertinggal.
• Di subbagian ini kami akan menunjukkan bagaimana SIMCA dan SIMCA-online menggunakan fungsi akses data SimApi dan seberapa sering fungsi SimApi akan dipanggil. Ini dapat membantu dalam menetapkan persyaratan kinerja untuk implementasi SimApi.

Penggunaan fungsi SimApi oleh SIMCA

• Ketika SIMCA desktop atau produk offline lainnya menggunakan SimApi untuk mendapatkan data, permintaan ini akan dilakukan secara batch dan memproses data untuk serangkaian variabel dalam rentang waktu tertentu.
• Karena permintaan ini dimulai secara manual oleh pengguna, permintaan ini tidak terjadi terlalu sering dan tidak menyebabkan beban signifikan pada sumber data.
• Fungsi SimApi ini digunakan untuk mendapatkan data:
• simapi2_nodeDapatkanBatchAktif
• simapi2_nodeDapatkanWaktuBatch
• simapi2_koneksiBacaDataHistorisEx

Penggunaan fungsi SimApi oleh SIMCA-online

• SIMCA-online digunakan untuk pemantauan proses secara real-time, dan karenanya meminta data melalui SimApi secara berkala. Interval eksekusi terpendek yang dapat digunakan adalah 1 detik. Beberapa contoh dunia nyataampInterval eksekusi adalah 10 detik, 1 menit, atau 10 menit.
• Sebuah server dapat menjalankan banyak proyek pada saat yang bersamaan.
• Untuk mengurangi jumlah panggilan API melalui SimApi, server mengoptimalkan permintaan data dengan mengelompokkan banyak permintaan kecil yang bersamaan menjadi satu permintaan yang lebih besar untuk semua variabel pada saat yang sama (pelajari lebih lanjut dalam topik bantuan 'Pembacaan yang dioptimalkan dari sumber data meningkatkan kinerja').
• Algoritma eksekusi server bekerja seperti ini saat meminta data menggunakan fungsi SimApi yang tercantum di bawah ini:
• Semua fase yang dijalankan pada interval yang sama dikelompokkan ke dalam satu panggilan SimApi untuk mengurangi jumlah panggilan. Server membaca data terbaru untuk semua variabel yang digunakan oleh semua model yang berbagi interval tersebut, yaitu, panggilan ini akan menghasilkan baris data yang luas yang kemudian digunakan oleh semua proyek.
  • simapi2_koneksiBacaDataSaatIni
• Untuk setiap proyek batch, server juga perlu mengetahui batch mana yang aktif. Hal ini juga perlu dilakukan setiap kali proyek dijalankan:
  • simapi2_nodeDapatkanBatchAktif
  • simapi2_nodeGetBatchTimes dipanggil lebih jarang.
• Selain itu, SIMCA-online juga memerlukan data historis. Permintaan ini hanya terjadi saat dibutuhkan, seperti mengejar ketertinggalan awal batch yang dimulai sebelum SIMCA-online dimulai, atau saat server tertinggal dan perlu membaca blok data:
  • simapi2_koneksiBacaDataHistorisEx
• Secara opsional, beberapa konfigurasi proyek menggunakan fitur yang menggunakan data batch atau data diskrit yang menghasilkan panggilan SimApi ke:
  • simapi2_koneksiBacaDataBatch
  • simapi2_koneksiBacaDiscreteEx
• Secara opsional, beberapa konfigurasi proyek menggunakan penulisan kembali untuk mendorong data kembali ke sumber data:
  • simapi2_connectionWriteHistoricalDataEx (dan fungsi terkait untuk data batch, data diskrit)
• Penting bahwa setiap panggilan ke fungsi inti untuk mendapatkan data, readCurrentData, getActiveBatches/getBatchTimes, cepat dan tidak sulit secara komputasi untuk sumber data itu sendiri, mengingat seberapa sering SIMCA-online memanggil fungsi tersebut.

Menguji dan memvalidasi data SimApi

• Bagian ini membahas pengujian SimApi untuk memverifikasi bahwa data yang dikembalikan cocok dengan data di sumber data itu sendiri. Menjalankan pengujian seperti ini penting setelah membuat atau mengubah implementasi SimApi, atau saat API sumber data berubah.
• Dalam praktiknya, validasi data dilakukan menggunakan SIMCA-online dan fungsi Ekstraknya untuk menarik data dari sumber data melalui SimApi dan kemudian membandingkannya dengan data mentah di sumber data. SIMCA Desktop tidak dapat digunakan untuk menguji aspek real-time dari SimApi.

Persiapan dan persyaratan

• Beberapa item bersifat opsional tetapi dapat dilakukan jika cakupan pengujian Anda mencakupnya:

1. Instal SIMCA-online seperti yang dijelaskan dalam ReadMe dan Installation Guide.pdf yang terdapat dalam zip produk.
2. Dapatkan lisensi untuk server SIMCA-online dan instal. SimApi tidak akan berfungsi tanpa lisensi. Artikel basis pengetahuan untuk SIMCA-online menunjukkan cara melisensikan produk. Misalnyaample: SIMCA-online 18 (sartorius.com)
3. Instal dan konfigurasikan SimApi yang ingin Anda uji. Lihat bab 4 – 5 dalam dokumen ini dan panduan pengguna SimApi tertentu.
   • a. Opsional: pastikan panduan pengguna terkini dan benar.
4. Pastikan Anda memiliki alat untuk sumber data Anda yang dapat digunakan untuk membandingkan data SimApi.
5. Di klien desktop SIMCA-online, masuk ke server SIMCA-online Anda dan gunakan File > Ekstrak untuk mendapatkan data melalui SimApi.
6. Opsional jika cakupan pengujian Anda mencakupnya: setelah menyelesaikan pengujian, hapus instalan SimApi dan verifikasi files dihapus.

Apa yang harus diuji?

• Matriks fitur dalam bab 3 mencantumkan semua fitur yang mungkin, tetapi implementasi SimApi tertentu mungkin hanya mendukung sebagian saja. Anda harus menguji semua fitur yang diimplementasikan oleh SimApi yang diberikan.
• Pengujian berikut ini umum dilakukan pada sebagian besar implementasi SimApi:
• Otentikasi dengan nama pengguna dan kata sandi
• Uji berbagai pengaturan dalam konfigurasi SimApi
• Hirarki Node: Node dan tags yang dipaparkan oleh SimApi sudah benar.
  • Harus ada tag diekspos untuk semua “variabel” yang seharusnya tersedia melalui SimApi.amples: pengukuran proses, nilai terhitung, konstanta.
• Ketahanan koneksi: jika sumber data tidak tersedia, hal ini akan menyebabkan peringatan atau kesalahan dalam log file, tetapi koneksi ke sumber data dibuat kembali secara otomatis saat sumber data tersedia.
• Beberapa contoh: dua contoh dapat dikonfigurasi dan digunakan secara independen dan bersamaan, dengan log terpisah files.
• Data saat ini: ekstrak data saat ini untuk tagsPastikan data merupakan nilai terakhir yang diketahui dari sumber data, atau hilang karena kualitasnya buruk atau jika data sudah terlalu lama.
  • Ekstrak data setiap 10 detik (atau lebih) selama satu menit.
• Data berkelanjutan historis: mengekstrak data historis untuk tags.
  • Gunakan rentang waktu yang sesuai saat Anda mengekstrak data terkini. Verifikasi bahwa data terkini sesuai dengan data historis dan data mentah dalam sumber data.
  • Cobalah rentang waktu dan s yang berbedaampinterval ling, verifikasi kecocokan data dengan sumber data.
  • Coba mengekstrak data setiap 1 detik, yang merupakan detik terpendek yang mungkinampselang waktu.
  • Cobalah berbagai jenis tags dalam sumber data (variabel proses, dll.), memastikan data cocok.
  • Catatan: SIMCA-online dapat membagi satu permintaan data historis yang besar menjadi beberapa bagian yang lebih kecil. Ini akan terlihat di log SimApi.
• Verifikasi bahwa SimApi berfungsi dengan data teks, data numerik, dan data yang hilang.
• Catatan SimApi fileVerifikasi bahwa log berisi entri yang wajar.
• Node batch: klik kanan pada node dan lakukan Temukan batch.
  • Verifikasi nama batch, waktu mulai, waktu berakhir untuk batch.
  • Coba batch aktif yang sedang berjalan di sumber data. Seharusnya tidak ada waktu berakhir melalui SimApi.
• Pengidentifikasi batch node proses tagJika SimApi memiliki fungsionalitas node batch (lihat poin sebelumnya), ia juga harus memiliki pengidentifikasi batch tag dalam simpul data proses pencocokan. Data untuk ini tag harus berupa pengidentifikasi batch (nama batch). Data ini diperlukan untuk proyek batch guna mengidentifikasi batch mana suatu baris data berada.

Bergantung pada apakah SimApi mendukungnya, Anda mungkin juga ingin menguji:

• Data batch menggunakan File > Ekstrak.
• Data diskrit menggunakan File > Ekstrak. Catatan: untuk menguji data diskrit dengan File > Ekstrak node, node batch dan node data diskret harus berada dalam SimApi yang sama (ketika SIMCA-online mengeksekusi proyek, keduanya dapat berasal dari SimApi yang berbeda).
• Menulis kembali – mendorong kumpulan data ke sumber data. Untuk mengujinya, Anda harus mengonfigurasi konfigurasi proyek di SIMCA-online untuk menulis kembali vektor data ke sumber data. Kemudian jalankan proyek di SIMCA-online dan periksa data yang ditulis kembali di sumber data.
• Data berkelanjutan dikonfigurasikan pada halaman Evolution Write Back dalam konfigurasi proyek.
• Data diskrit dikonfigurasi pada halaman yang sama, tetapi hanya untuk fase yang dikonfigurasi untuk pengambilan data diskrit.
• Data batch dari Batch Write back

INFO LEBIH LANJUT

• Analisis Data Sartorius Stedim AB Östra Strandgatan 24 903 33 Umeå Swedia
• Telepon: + 46 90-18 48 00
• www.sartorius.com
• Informasi dan angka yang terkandung dalam petunjuk ini sesuai dengan tanggal versi yang ditentukan di bawah ini.
• Sartorius berhak melakukan perubahan pada teknologi, fitur, spesifikasi, dan desain peralatan tanpa pemberitahuan. Bentuk maskulin atau feminin digunakan untuk memudahkan keterbacaan dalam instruksi ini dan selalu menunjukkan semua jenis kelamin secara bersamaan.
  Pemberitahuan hak cipta:
• Petunjuk ini, termasuk seluruh komponen, dilindungi oleh hak cipta.
• Penggunaan apa pun di luar batas undang-undang hak cipta tidak diizinkan tanpa persetujuan kami.
• Hal ini berlaku khususnya untuk pencetakan ulang, penerjemahan dan penyuntingan terlepas dari jenis media yang digunakan.

Tanya Jawab Umum

• T: Apa tujuan SimApis?
  • A: Tujuan utama SimApis adalah menyediakan data ke produk Umetrics Suite untuk pembuatan proyek dan pembuatan model.
• T: Bagaimana saya dapat memecahkan masalah pada instalasi SimApi?
  • A: Anda dapat memecahkan masalah dengan menguji dari SIMCA-online, memeriksa log SimApi file, dan memastikan konfigurasi akun layanan yang benar.

Dokumen / Sumber Daya

Perangkat Lunak Sim Api SARTORIUS [Bahasa Indonesia:] Panduan Pengguna Perangkat Lunak Sim Api, Perangkat Lunak Api, Perangkat Lunak

Referensi

• Panduan Pengguna