SARTORIUS Sim Api Software

spésifikasi

• Ngaran produk: SimApi Guide
• Tanggal release: September 5, 2024
• Tujuan: Nyadiakeun data ka produk Umetrics Suite

Parentah Pamakéan Produk

Bubuka pikeun SimApis

• SimApis dianggo pikeun nyandak data pikeun nyiptakeun proyék sareng ngawangun modél dina produk Umetrics Suite.

Meunangkeun SimApis

• Pikeun ménta SimApis, tingal dokuméntasi resmi atawa kontak rojongan customer pikeun pitulung.

Fitur SimApi

• SimApis nyadiakeun data real-time pikeun monitoring, kontrol, jeung wangunan model di SIMCA jeung SIMCA-online.

Ngan Anggo Data Ayeuna

• Disarankeun make data ayeuna wungkul tur ulah data sajarah pikeun kinerja optimal.

Nyiapkeun pikeun Instalasi SimApi

• Saméméh pamasangan, pastikeun yén sistem Anjeun nyumponan sarat minimum nu geus ditangtukeun dina buku pituduh.

Masang SimApi

• Turutan parentah hambalan-demi-hambalan disadiakeun dina manual pamaké pikeun masang SimApi dina sistem Anjeun.

Nyetél SimApi pikeun SIMCA

• Konpigurasikeun setélan SimApi di SIMCA nurutkeun tungtunan disadiakeun.

Nyetel SimApi pikeun SIMCA-online

• Nyetél SimApi pikeun real-time dimeunangkeun data jeung nulis-balik operasi di SIMCA-online.

Nguji jeung ngungkulan

• Saatos instalasi, laksanakeun tés pikeun mastikeun fungsionalitas anu leres. Upami aya masalah, tingal bagian ngungkulan dina pituduh pangguna.

Nguji ti SIMCA-online

• Nguji integrasi SimApi ti SIMCA-online pikeun pariksa dimeunangkeun data.

Ngarengsekeun masalah sareng Log Files

• Paké log SimApi file pikeun ngaidentipikasi sareng ngabéréskeun masalah instalasi atanapi operasional.

Konfigurasi Akun Service

• Mastikeun konfigurasi bener tina akun layanan SIMCA-online pikeun operasi seamless.

Rincian Téknis

• Tingal bagian 7 tina pituduh pamaké pikeun inpo téknis jero ngeunaan SimApis.

Bubuka pikeun SimApis

• SimApi mangrupikeun antarmuka parangkat lunak antara parangkat lunak Umetrics® Suite sareng sumber data. Tujuan utama SimApi a nyadiakeun data ka SIMCA®-online atawa SIMCA®.
• Sartorius Stedim Data Analytics AB ngembangkeun SimApis pikeun seueur sumber data anu béda, sapertos sajarah prosés sareng pangkalan data tujuan umum.
• Dokumén ieu nunjukkeun naon SimApi, sareng kumaha éta dianggo dina produk Umetrics Suite. Anjeun bakal diajar kumaha ngarencanakeun, sareng masang SimApi, kumaha troubleshoot sareng kumaha nguji pamasangan anjeun. Bab ahir ngandung detil téknis SimApis anu ditujukeun pikeun pamekar.

Tujuan SimApi: nyadiakeun data ka produk Umetrics Suite

• Tujuan primér SimApi a nyadiakeun data ka SIMCA-online atawa SIMCA ti sumber data. Sumber data sanes bagian tina SIMCA-online tapi bisa mangrupa sajarah prosés atawa sistem séjén anu ngajaga tur ngatur data.
• A SimApi ngungkabkeun hiji hirarki titik, pakait jeung folder di a file sistem. Unggal titik bisa ngandung titik sejen, atawa tags. A tag pakait jeung variabel. Pikeun ieu tags, data bisa diala. Gambar nembongkeun a tag, Temp, dipilih dina titik
• BakersYeastControlGood dina sumber data dina SIMCA-online. Éta ogé nunjukkeun nilai panganyarna anu dicandak tina sumber data.

Pamakéan SimApi dina Umetrics Suite

• Parangkat lunak desktop SIMCA tiasa nganggo SimApi pikeun nyandak data pikeun nyiptakeun proyék sareng ngawangun modél sapertos gambar di handap ieu.
• SIMCA-online migunakeun SimApis pikeun ménta data sacara real-time pikeun monitoring jeung kontrol, kitu ogé nulis balik data ka sumber data. Gambar di handap ieu nunjukkeun dimana SimApi aya dina sistem anu diwangun ku sumber data, server SIMCA-online, sareng klien.

Biasa dianggo SimApis

• SimApis anu paling seueur dianggo nyaéta:
• The PI AF SimApi pikeun nyambungkeun ka Aveva (baheulana OSIsoft) PI Systems.
• OPC UA SimApi
• ODBC SimApi - pikeun aksés umum kana pangkalan data sapertos SQL Server atanapi Oracle
• Sadaya SimApis anu sayogi didaptarkeun sareng fitur-fiturna dina paragraf 3.

The DBMaker SimApi pikeun data simulasi

• DBMaker mangrupikeun aplikasi anu disayogikeun sareng pamasangan server SIMCA-online. Ieu simulates sumber data, kayaning a sajarah prosés, ku ngagunakeun tabel data preloaded mana observasi disadiakeun hiji-hiji ka SIMCA-online ngaliwatan DBMaker SimApi.
• DBMaker ngan ukur dianggo pikeun tujuan démo sareng henteu tiasa dianggo dina produksi sareng data langsung tina sumber data. Tempo bantuan diwangun-di pikeun leuwih jéntré ngeunaan DBMaker.

Dokuméntasi tambahan

• Dokumén ieu mangrupikeun salah sahiji sakumpulan dokumén anu aya hubunganana, masing-masing kalayan fokus sareng target pamiarsa anu béda:

Sumber	Naon	dimana
SIMCA-online web kaca	Inpormasi bubuka sareng undeuran	sartorius.com/umetrics-simca- online

SIMCA-online ReadMe sarta Installation.pdf	Instalasi jeung kumaha carana ngamimitian kalawan SIMCA- data demo online	Dina pos instalasi file
SIMCA-online Palaksanaan Guide	Outlines fungsionalitas SIMCA-online, nempatkeun eta dina konteks kalawan software Umetrics Suite séjén, ngajelaskeun sarat jeung prakték pangalusna pikeun deployment suksés, jeung parentah instalasi hambalan-demi-hambalan.	sartorius.com/umetrics-simca- online
Pituduh SimApi	Nyiapkeun sareng ngalaksanakeun pamasangan SimApi, kalebet ngungkulan. Ogé ngandung rinci teknis ngeunaan SimApis pikeun pamekar.	sartorius.com/umetrics-simpi
Pituduh Pamaké SimApi	Dokuméntasi pikeun unggal SimApi anu diterbitkeun kalayan fitur, petunjuk pamasangan, sareng spésifikasi konfigurasi.	sartorius.com/umetrics-simpi
SIMCA-online Téknis Guide	Rujukan teknis pikeun perencanaan instalasi server SIMCA-online, ngungkulan, tur di-jero kumaha SIMCA-online jalan.	sartorius.com/umetrics-simca-online
SIMCA-online pitulung	Web-bantuan dumasar kana kumaha carana make SIMCA-online tur kumaha SIMCA-online jalan.	Dina software sorangan, jeung saterusna sartorius.com/umetrics-simca
SIMCA-online Web Guide Instalasi klien	Ngajelaskeun pamasangan SIMCA-online Web Klién	sartorius.com/umetrics-simca-online
Dasar pangaweruh Umetrics	Database anu tiasa dipilarian sareng artikel ngeunaan unggal versi parangkat lunak anu dileupaskeun, artikel téknis, sareng masalah anu dipikanyaho dina produk Umetrics Suite.	sartorius.com/umetrics-kb
pitulung SIMCA / pituduh pamaké	Kumaha ngagunakeun SIMCA desktop pikeun nyiptakeun proyék sareng data modél.	Dina SIMCA jeung saterusna sartorius.com/umetrics-simca
Ngarojong web kaca	Kumaha kéngingkeun dukungan téknis.	sartorius.com/umetrics-support

Bantosan Téknis

• Tim pangrojong online Sartorius ngajawab patarosan téknis ngeunaan SimApis sareng ogé tiasa neraskeun pamundut pikeun ningkatkeun SimApis ka jalma anu cocog. Diajar langkung seueur di sartorius.com/umetrics-support.

Meunangkeun SimApis

• Urang nyadiakeun dokuméntasi pikeun sadia SimApis sarta tumbu ka program instalasi di sartorius.com/umetrics-simpi.
• Unggal SimApi didokumentasikeun dina Pituduh Pamakéna.
• The SimApi Guide, nu anjeun baca euweuh, w complements eta informasi jeung SimApi complementing informasi lamun datang ka SimApi tata, instalasi, jeung ngungkulan.

fitur SimApi

• Henteu sadayana sumber data sami. A SimApi teu kudu nerapkeun sagala fungsi dina spésifikasi. Kusabab ieu, SimApis anu béda nawiskeun pungsionalitas anu béda. Daptar matriks di handap ieu sayogi SimApis sareng fitur-fiturna.
• Fitur anu dipedar di handap. Perhatikeun yén tabél boga kolom misah pikeun nembongkeun fitur nu sadia dina SIMCA-online sarta SIMCA mungguh.

Fitur	Tujuan	pamakéan SIMCA-online	pamakéan SIMCA
data ayeuna	Baca observasi tunggal kalawan nilai panganyarna tina sumber data.	Real-time palaksanaan normal	–
data sajarah	Baca loba observasi sakaligus kalawan data sajarah ti sumber data.	Nyekel-up na prediksi data kaliwat, nyieun proyék ngagunakeun File > Anyar	Database Impor Wizard pikeun ngimpor data prosés pikeun nyiptakeun modél.
Data diskrit	Maca data laboratorium/IPC tina sumber data. Loba observasi per angkatan.	Pikeun proyék-proyék angkatan kalayan fase atanapi kaayaan bets dikonpigurasikeun pikeun dimeunangkeun data diskrit.	–
data bets	Baca kaayaan bets sareng atribut kualitas ahir (atanapi	Kaayaan bets atanapi centering lokal.	Database Impor Wizard pikeun maca kaayaan bets pikeun

Fitur	Tujuan	pamakéan SIMCA-online	pamakéan SIMCA
	data tipe MES séjén). Hiji observasi per angkatan.		kreasi modél tingkat angkatan.
node bets	Sebutkeun waktu mimiti jeung waktu ahir (kosong pikeun bets aktip) pikeun bets husus. Enumerate sadaya bets nu aya dina rentang waktu.	Diperlukeun pikeun palaksanaan konfigurasi bets.	Database Impor Wizard pikeun milih bets pikeun diimpor.
Tulis deui - data kontinyu	Tulis data kontinyu, sapertos prediksi, balik deui ka sumber data.	Tulis deui data tina tingkat évolusi angkatan, pikeun Control Advisor atanapi kanggo konfigurasi kontinyu	–
Tulis deui - diskrit	Tulis data diskrit, sapertos prediksi, balik deui ka sumber data.	Tulis deui pikeun konfigurasi bets dina tingkat évolusi angkatan pikeun fase dikonpigurasi pikeun dimeunangkeun data diskrit	–
Tulis deui - data angkatan	Tulis deui data tingkat angkatan, sapertos prediksi atanapi atribut kualitas ahir, kana sumber data.	Tulis deui pikeun konfigurasi bets dina tingkat bets	–
Hirarki titik	SimApi ngadukung hirarki titik, sami sareng a file sistem. Unggal titik tiasa ngandung tags jeung titik lianna. hirarki ngajadikeun leuwih gampang pikeun ngatur angka nu gede ngarupakeun titik jeung tags.	Dirojong di sadaya tempat dimana tags dipaké.
Array tag ékspansi	Hiji susunan tag nyimpen sababaraha nilai. The SimApi expands Asép Sunandar Sunarya tag ka loba individu tags, hiji keur unggal unsur dina Asép Sunandar Sunarya.	Dirojong dimana tags digunakeun pikeun data kontinyu. Masing ngalegaan tag kudu dipetakeun kana variabel dina proyék SIMCA.
Sababaraha sumber data	SimApi bisa nyambung ka leuwih ti hiji sumber data tunggal atawa ngarojong sababaraha instansi sorangan kalawan setelan individu jeung log files pikeun tiap conto.	Sambungkeun ka sababaraha sumber data anu sami.	–
Ketahanan sambungan	Lamun SimApi jadi dipegatkeun tina sumber data, éta bakal nyoba ngadegkeun deui sambungan otomatis.	SimApi teu kudu di-restart pikeun nyieun deui sambungan ka sumber data.	–
Dimekarkeun di-imah	SimApi dikembangkeun, disayogikeun sareng dirojong ku

Ngan data ayeuna, tanpa data sajarah, teu dianjurkeun

• Sababaraha SimApis, khususna OPC DA, ngan ukur ngadukung maca data ayeuna, sanés data sajarah.
• SimApi anu ngan ukur ngadukung data ayeuna henteu tiasa dianggo dina SIMCA desktop, sabab éta moal tiasa maca data sajarah pikeun ngawangun modél.
• Pikeun SIMCA-online, kami nyarankeun niatna sumber data na SimApi nu nyadiakeun teu ukur data ayeuna keur real-time palaksanaan, tapi ogé data sajarah pikeun bisa ngaduga jeung nyekel-up data kaliwat. SIMCA-online otomatis pindah antara data real-time jeung data sajarah sakumaha diperlukeun tur ieu teu bisa dipareuman.
• Sumber data anu ngan nyadiakeun data ayeuna, tapi teu data sajarah, tiasa dianggo pikeun proyék-proyék kontinyu dina SIMCA-online, tapi pikeun proyék-proyék bets, data sajarah diperlukeun.

Nyiapkeun pikeun instalasi SimApi

• bagian ieu ngajelaskeun informasi penting pikeun instalasi suksés a SimApi.

64-bit atanapi 32-bit SimApis

• Aya vérsi 32-bit sareng 64-bit unggal SimApi.
• SIMCA-online jeung SIMCA 64-bit sarta merlukeun 64-bit varian SimApis. SimApis 32-bit warisan masih sayogi pikeun pamasangan anu langkung lami.

Lokasi pikeun log file sareng suhunan

• A SimApi nyimpen log na files dina folder Data Program disumputkeun1:
  %programdata%\Umetrics\SimApi, dimana% programdata% peta kana polder nu sabenerna dina komputer Anjeun. Ieu standar pikeun C:\ProgramData.
• Unggal SimApi ilaharna ngagunakeun log sorangan file, nu sarupa jeung log server SIMCA-online file bakal ngandung leuwih atawa kurang data gumantung kana setelan tingkat log. Ieu file gunana pikeun ngungkulan. Log file ngaranna
  .log mana nyaeta SimApi nu Anjeun masang, pikeun exampjeung PIAFSimApi. Tempo ogé bagian hareup pikeun SIMCA-online SimApi ngaran conto.
• Polder ieu ogé ngandung setélan SimApi dina XML file ngaranna .xml.
• Seuseueurna SimApis gaduh antarmuka pangguna grafis anu ngarobih setélan dina xml file, tapi pikeun sababaraha anjeun ngasupkeun parobahan langsung dina XML file nganggo pangropéa téksu, sapertos Notepad. Tempo pituduh pamaké pikeun tiap SimApi.

File ngaran nalika ngaranna instansi dipaké kalawan SIMCA-online

• Dina SIMCA-online, unggal conto SimApi meunang konfigurasi sorangan file jeung log file pikeun digawe sareng sababaraha instansi unggal SimApi. Ngaran-ngaran ieu files anu suffixed ku nami conto sakumaha dirumuskeun dina tab SimApi dina dialog Pilihan Server SIMCA-online.
• Ex di handapample nembongkeun ngaran ieu files, dimana kudu diganti ku ngaran SimApi.
• Ngaran konfigurasi dibikeun nalika instance ditambahkeun: OmegaServer
• Konfigurasi file ngaran: OmegaServer.xml
• Log file ngaran: OmegaServer.log
• Catet yén generik file .log file masih dijieun. log ieu file ngandung éntri anu alesan teknis teu bisa diarahkeun ka log file tina conto..
• Polder ieu disumputkeun dina Windows sacara standar. Pikeun ningali éta di File Explorer anjeun ngonpigurasikeun éta nunjukkeun disumputkeun files. Catet yén anjeun tiasa napigasi ka polder disumputkeun ku ngetik alamatna File bar alamat Explorer urang.
• Catet yén SIMCA teu ngarojong sababaraha instansi tina SimApi, sarta ku kituna ngagunakeun ngaran tanpa ngaran conto sakumaha ditétélakeun di luhur.

Perencanaan jaringan

• Anjeun kedah milarian server SIMCA-online caket sareng sumber data dina jaringan. Ieu ensures sambungan gancang antara SIMCA-online jeung sumber data na.
• Alat-alat jaringan tiasa ngaganggu sambungan antara SIMCA-online sareng sumber data.

Akun pamaké sareng idin sumber data

• Sumber data ilaharna ngadalikeun aksés ka data maranéhanana. Ieu biasana dilakukeun nganggo nami pangguna sareng kecap akses tapi larangan IP-alamat atanapi basis DNS ogé tiasa dianggo (pikeun ex.ample PI Trusts dina Aveva PI System).
• Ngaran pamaké sareng kecap akses tiasa disayogikeun ka sumber data ku sababaraha cara:
• A SimApi dijalankeun salaku pamaké Windows tina pamaké ngajalankeun SIMCA desktop atawa akun layanan SIMCA-online dina komputer server. SimApi tiasa nyambung ka sumber data nganggo akun ieu. Ieu kumaha OPC I, sareng PI SimApi dianggo, sareng ODBC upami anjeun henteu masihan kapercayaan nalika ngonpigurasikeunana.
• Pikeun ODBC umum anjeun tiasa nganggo aplikasi Administrator Sumber Data ODBC anu aya dina Start dina Windows.
• Sababaraha panyadia pangkalan data nyayogikeun supir sareng alat sorangan pikeun pangkalan datana. Database Oracle, contonaample, ngagunakeun Oracle Data Aksés komponén (ODAC).
• Sababaraha SimApis, sapertos PI AF sareng ODBC, gaduh dialog konfigurasi anu nyimpen kredensial énkripsi dina konfigurasi XML SimApi. file.
• PI ogé boga rupa pilihan kaamanan sadia dina PI System Manajemén Pakakas dina komputer server PI. Baca leuwih dina PI AF SimApi Pituduh pamaké. Pituduh ieu mantuan sanajan anjeun make OSIsoft PI SimApi heubeul.
• OPC DA sareng HDA nganggo DCOM salaku angkutan antara sumber data sareng SimApi. DCOM dikonpigurasi ku alat Component Services (DCOMCNFG.EXE) dina Windows sareng nganggo auténtikasi Windows.
• Pikeun OSIsoft PI SimApi heubeul (sanes AF SimApi anyar), aplikasi OSIsoft AboutPI-SDK (PISDKUtility.exe) dipaké pikeun nyetél sambungan ka server PI.

Verifikasi konektipitas sumber data
Nalika anjeun badé masang SimApi dina komputer, éta tiasa mangpaat pikeun pariksa konektipitas tina komputer éta ka sumber data nganggo alat anu sanés:

• Sumber Data ODBC dina Windows dianggo pikeun ngonpigurasikeun sareng nguji ODBC generik. Catet yén aya dua vérsi alat ieu dina Windows 64-bit: hiji kanggo aplikasi 32-bit sareng hiji kanggo 64-bit. Anggo tombol Sumber Data Test dina tungtung wizard konfigurasi ODBC pikeun pariksa konektipitas ka pangkalan data. Kami nyarankeun yén anjeun ngonpigurasikeun sumber data anjeun salaku System DSNs.
• Alat konéksi khusus pangkalan data ti panyadia pangkalan data, sapertos Komponén Akses Data Oracle.
• PI System Explorer tiasa dianggo pikeun nguji konektipitas ka server PI AF. Éta mangrupikeun bagian tina PI AF Client anu mangrupikeun prasyarat pikeun PI AF SimApi.
• Ahli OPC UA ti Unified Automation - UaExpert mangrupikeun klien uji cross-platform pikeun server OPC UA.
• Aplikasi PI-SDK (PISDKUtility.exe) tiasa dianggo pikeun nguji konektipitas sareng ka view sagala pesen kasalahan nu bisa geus asup nalika SIMCA-online nyoba nyambung ka server pi. Ieu ngan dipaké pikeun OSIsoft SimApi heubeul, teu PIAF.
• Alat Manajemén Sistem PI dianggo dina komputer server PI pikeun ngungkulan ti sisi éta. Pikeun example, pikeun néangan masalah kaamanan nyegah aksés ti server SIMCA-online. Diajar langkung seueur ngeunaan ngungkulan sistem PI dina pidéo YouTube ieu.
• Excel tiasa dianggo pikeun nyandak data tina sambungan ODBC sareng seueur sistem anu sanés nalika plugin anu cocog dipasang.
• Matrikon OPC Explorer pikeun Ior HDA (ieu mangrupikeun alat anu misah) tiasa dianggo pikeun nguji konektipitas OPC, sareng Matrikon OPC Analyzer tiasa dianggo pikeun ngadiagnosa masalah konektipitas OPC. Unduh alat gratis ieu tina https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Nyalametkeun (pikeun DInd HDA) ti OPC Training Institute urang web situs "ngamungkinkeun pamaké pikeun gampang nangtukeun jenis panyakitna masalah komunikasi jeung kaamanan, sarta ngalereskeun aranjeunna instan ku push hiji tombol. Sadaya ieu bisa dipigawé tanpa kudu diajar ngonpigurasikeun DCOM "

Masang SimApi

Ieu kumaha carana masang SimApi dina PC:

1. Baca Buku Panduan pikeun SimApi anu anjeun pasang. Éta ngandung spésifik pikeun éta SimApi anu ngalengkepan paréntah umum anu anjeun baca ayeuna.
2. Pasang sareng konpigurasikeun sagala prasyarat anu disebatkeun dina Pituduh Pamaké SimApi (pikeun exampsupir database atanapi SDKs)
3. Jalankeun program pangaturan pikeun masang SimApi. Pasang versi 64-bit (x64) atanapi 32-bit (x86) anu cocog sareng parangkat lunak anu anjeun badé ngajalankeunana.
4. Ngonpigurasikeun SimApi di SIMCA-online atanapi SIMCA sakumaha ditétélakeun dina bagian handap tur tingal pituduh pamaké SimApi pikeun déskripsi ngeunaan setélan sadia.
5. Mimitian server SIMCA-online. Catet yén ieu tiasa nyandak waktos, sabab nalika SimApi ieu initialized, éta bakal enumerate sadayana tags dina sumber data.
6. Nguji SimApi ku meunangkeun sababaraha data. Pikeun SIMCA-online, Anjeun tiasa make File > Ekstrak sakumaha dijelaskeun dina 6.1.
7. Upami SimApi gagal jalan sakumaha anu diharapkeun, tingal log SimApi files pikeun ngungkulan, jeung ka pituduh pamaké SimApi.

Nyetél SimApi pikeun dianggo dina SIMCA

Kieu kumaha cara ngagunakeun SimApi dina SIMCA:

1.  Mimitian impor database ku salah sahiji cara ieu:
   • a. Pikeun nyieun proyék anyar dina SIMCA: File > Proyék Biasa Anyar atanapi Proyék Batch Anyar. Pilih Tina pangkalan data dina tab Imah.
   • b. Pikeun ngimpor set data dina proyék anu aya di SIMCA: Tina set data dina tab Data tina proyék SIMCA anu kabuka.
2. Klik Tambahkeun sumber data anyar
3. Pilih SimApi salaku jinis sambungan, klik tombol… .dll dina folder instalasi, teras klik Buka.
4. Klik Konpigurasikeun sarta tingal pituduh pamaké SimApi individu kumaha carana nyieun setelan.
5. Klik sambungan sumber data Test pikeun pariksa yen Anjeun bisa nyambung ka database. Ieu tiasa nyandak lila lamun aya loba tags dina sumber data.
6. Klik OK pikeun ngalengkepan konfigurasi.
7. Tingali kana pitulung SIMCA pikeun kumaha cara damel sareng data anu diimpor.

Nyetel SimApi pikeun pamakéan dina SIMCA-online

• penting: Pikeun bisa ngagunakeun SimApi a, lisénsi server SIMCA-online diperlukeun. A instalasi demo SIMCA-online teu ngidinan SimApis dipaké.
• Pikeun nambahkeun SimApi kana sistem, Anjeun ngajalankeun SIMCA-online Pilihan Server dina PC server. Diajar léngkah rinci dina topik pitulung SICMA-online Tambahkeun tur ngonpigurasikeun a SimApi dina server.
• Tip: Upami anjeun ngadamel parobihan pikeun SimApi, anjeun tiasa ngabalikan deui SimApi éta nyalira tina Pilihan Server tanpa ngamimitian deui sadayana server.
• Pikeun ngonpigurasikeun sababaraha instansi SimApi ieu, malikan deui léngkah-léngkah di luhur sareng nganggo nami unik pikeun unggal conto. Baca langkung seueur ngeunaan log sareng konfigurasi anu béda files pikeun instansi dina 4.2.

Nguji sareng ngungkulan SimApi

• Bab ieu ngeunaan nguji sareng ngungkulan pamasangan SimApi.

Nguji SimApi ti SIMCA-online

• Sakali server SIMCA-online geus dimimitian suksés anjeun tiasa nguji SimApi anjeun dina SIMCA-online (lamun server teu ngamimitian, tingali 6.2):
• Asup ka server dina klien SIMCA-online, tur napigasi ka nimba on File tab. Ékstrak ngabantosan anjeun nguji SimApi ku kéngingkeun data ngalangkungan éta:
• Titik ("polder") tina SimApi dipintonkeun dina kotak kénca. Tags pikeun titik nu dipilih dipintonkeun-katuhu luhur.
• Data ayeuna tiasa dites gancang ku ngaklik view> asup tags nu nyadiakeun data prosés kontinyu (tingali screenshot)
• Klik-katuhu dina titik pikeun Milarian bets dina rentang waktos. Titik kedah janten titik bets anu terang ngeunaan bets.
• Pilih tags dina nimba teras klik Salajengna tur rengse wizard pikeun ménta data ngagunakeun modus béda dimeunangkeun data: current-, historical-, bets- jeung data diskrit.
• Bandingkeun data sasari sareng naon anu anjeun tingali dina sumber data anjeun nganggo alatna. Diajar langkung seueur ngeunaan nguji sareng validasi sadaya fitur SimApi dina 7.13.

Troubleshoot masalah SimApi ngagunakeun log SimApi file

• Upami server henteu ngamimitian, SimApi henteu jalan sakumaha anu diharapkeun atanapi ékstrak gagal, anjeun kedah konsultasi ka log SimApi file nu ngabejaan Anjeun naon masalahna. Aktipkeun logging tingkat Debug dina log SimApi pikeun meunangkeun detil lengkep. Tingali 4.2.
• Catetan: log server SIMCA-online teu jadi mangpaat di dieu. Aranjeunna bakal nunjukkeun kumaha SimApi dimuat sareng diinisialisasi ku server, tapi detil khusus SimApi aya dina log na. file.

Paké akun layanan SIMCA-online katuhu

• Sawaktos Anjeun keur nguji aksés ka sumber data, inget yen anjeun asup salaku pamaké husus dina komputer server (ilaharna akun pamaké anjeun sorangan dina domain Windows), tapi yén akun layanan server SIMCA-online mangrupakeun akun béda, sacara standar LocalSystem, nu boga hak aksés béda dibandingkeun akun pamaké anjeun.
• Ku sabab kitu, teu ilahar yén tés dianggo nalika ngajalankeun sakumaha akun anjeun, tapi SIMCA-online gagal pikeun nyambung ka sumber data.
• Pikeun ngajawab masalah ieu, aksés kudu dibikeun ka akun nu dipaké ku layanan server SIMCA-online. Biasana, anjeun ngarobih LocalSystem ka akun jasa domain khusus, sareng masihan hak kana akun ieu. Catet yén ieu henteu dianggo upami SimApi nganggo kredensial anu disetél dina konfigurasi SimApi sabab kapercayaan ieu diutamakeun.

Rincian teknis ngeunaan SimApis

• Bab ieu masihan rinci téknis ngeunaan kumaha SimApi jalan. Utamana ditujukeun pikeun pamekar anu hoyong ngartos SimApis pikeun nerapkeun SimApi pikeun sumber data.
• Pamekar ogé kedah maca bagian samemehna tina dokumén ieu pikeun bubuka SimApis sareng déskripsi fitur tingkat luhur.

Iraha mertimbangkeun ngembangkeun SimApi sareng nalika henteu?

Sateuacan nimbangkeun ngembangkeun SimApi pikeun sumber data:

1. Parios upami tos aya SimApi anu tiasa dianggo. Panginten anjeun tiasa ngaktipkeun sababaraha fitur dina sumber data anjeun pikeun nganggo salah sahiji SimApis anu tos aya, sapertos OPC UA.
2. Taliti ngaliwat dokumén ieu sareng référénsina sareng nalungtik upami sumber data anjeun nyumponan sarat: contonaample, eta kudu jadi cukup gancang, nyadiakeun teu ngan data ayeuna, tapi ogé data sajarah.

• Ku sabab kitu, kami henteu nyarankeun ngembangkeun SimApi anu nyambung ka parangkat keras atanapi instrumen tingkat rendah. Éta leuwih alus pikeun nyambungkeun alat-alat eta ka sajarah prosés kayaning Aveva PI System, sarta ngantep éta ménta data ti instrumen, sarta historize eta. Lajeng PIAF SimApi bisa dipaké pikeun ménta data ti PI kana produk Umetrics.

Pangembangan SimApi sareng spésifikasi SimApi

• Spésifikasi SimApi, SimApi-v2, ngandung dokuméntasi pikeun sakabéh C-fungsi dina SimApi nu SimApi DLL perlu nerapkeun ogé sababaraha pituduh pikeun kumaha carana ngamekarkeun SimApi.
• Ngalaksanakeun SimApi nganggo C atanapi C ++ dina kalolobaan kasus dina tingkat anu teu perlu.
• Cara anu disarankeun, sareng langkung gampang, pikeun nerapkeun SimApi nyaéta ngadasarkeun kana Exampkode sumber leSimApi nu kami nyadiakeun. Éta mantanample palaksanaan SimApi nu handles C-interface tur narjamahkeun kana.NET Framework dimana palaksanaan sabenerna dijieun. Éta ogé ngagaduhan kode kerangka pikeun logging, setélan, GUI konfigurasi, sareng kode kerangka sanés.
• Pikeun ngembangkeun SimApi, tim pamekar peryogi pangalaman dina pamekaran Windows, .NET Framework, C, atanapi C++. pangaweruh alus ngeunaan sumber data nu SimApi kedah nyambung ka ogé diperlukeun, sabab tujuan hiji SimApi narjamahkeun requests data ti SIMCA-online atanapi SIMCA kana API tina sumber data. A palaksanaan SimApi pernah proyek hiji-off, tapi ilaharna merlukeun rojongan lumangsung sarta pangropéa occasional.

Maca atawa nulis data

• A SimApi boga tugas utama nyadiakeun data ti sumber data. Ieu disebut maca data.
• Paling palaksanaan SimApi ogé ngarojong data nulis. Ieu ngandung harti nulis balik data ngaliwatan SimApi ka sumber data. Nulis data mangrupa fitur pilihan dina SIMCA-online.

Tags jeung Nodes

• A tag mangrupa identifier kolom atawa "variabel" dina sumber data. A tag's name is used to identify the tag. Ngaran dina node kedah unik. SIMCA-online 18 mangrupa versi munggaran pikeun ngarojong hiji titik nu ngandung hiji sub titik na tag kalawan ngaran sarua. Pikeun example: titik Indungna bisa boga sub titik disebut bets na a tag disebut Batch.
• A node mangrupakeun wadah tina tags. Hiji titik ogé bisa ngandung titik séjén, sarupa kumaha a file Sistim boga polder dina polder.
• Kawas dina a file sistem, titik jeung tag ngaran bisa digabungkeun kana jalur pinuh nu uniquely ngaidentipikasi a tag. The tag jalur dipaké dina SIMCA-online atawa SIMCA lamun milih tags ngagunakeun. A tag jalur dimimitian ku ngaran conto SimApi dituturkeun ku titik-struktur, sarta ditungtungan make tag ngaran, unggal item dipisahkeun ku titik dua (:). Pikeun example ": ODBCSQLServer: Node: SensorTag1”.

The SimApi enumerates tags sareng titik nalika ngamimitian

• A palaksanaan SimApi ngotéktak server pikeun titik jeung tags dina sumber data nalika SimApi diinisialisasi sareng ngalacak aranjeunna supados rupa-rupa fungsi SimApi anu dianggo pikeun enumerasi. tags sareng titik tiasa dilaksanakeun.
• Initialization SimApi henteu lumangsung ngan dina ngamimitian server tapi ogé bisa ulang dipicu ku pamaké dina SIMCA-online kalawan fungsionalitas Anyarkeun SimApi.

Sensitipitas kasus tina tag- jeung ngaran titik

• Tag ngaran jeung ngaran titik sensitip leutik.
• Ku kituna, a tag disebut "tag1" henteu sami sareng "Tag1" kusabab kasus béda tina "T". Kami ngarékoméndasikeun ngalawan ngagunakeun tags atawa ngaran titik nu béda ngan bisi.

Node prosés kontinyu 

• Nalika titik ngandung tags kalawan data prosés kontinyu, bisa disebut salaku titik prosés. Dua Potret layar di handap ieu nunjukkeun perwakilan tabular tina titik prosés kalayan data anu dituturkeun ku gambar anu nunjukkeun kumaha tampilan titik nalika milih. tags di SIMCA-online.

Titik prosés kontinyu kudu bebas tina bets, ngajalankeun, atawa waktu

• Pikeun tiasa dianggo saé dina SimApi, hiji node kedah bebas tina bets, run, atanapi waktos. Gaduh titik nu ngandung data pikeun bets husus atawa rentang waktu iyeu moal jalan mun ogé dina SIMCA-online sabab konfigurasi proyék lajeng ngan bisa maca data pikeun bets nu teu dipaké pikeun bets séjén.
• Gantina, hiji titik kudu dipetakeun ka hiji atawa leuwih unit fisik dina prosés dimana pangukuran dipigawé.

ID bets tag diperlukeun dina titik prosés kontinyu pikeun palaksanaan proyék bets

• Unggal prosés kontinyu kudu boga a tag (variabel) nyekel identifier bets pikeun tiap observasi. identifier bets ieu dipaké ku SIMCA atanapi SIMCA-online uninga mana bets unggal observasi milik.
• The $BatchID tag dina Potret layar dina 7.4.3 nyaeta ex misalna hijiample.
  Bari teu diperlukeun, eta disarankeun pikeun mibanda a tag dina titik prosés nu nembongkeun fase ayeuna atawa hambalan prosés. Ieu tag lajeng bisa dipaké dina kaayaan palaksanaan fase di SIMCA-online atanapi di SIMCA nalika ngimpor data. Nilai pikeun ieu tag bisa keur example "fase1", "ngabersihan", "fase2".

titik konteks bets

• A titik bets mangrupakeun titik nu ngalacak bets; identifiers bets maranéhna, mimiti kali, sarta kali tungtung. Ieu sarat pikeun palaksanaan proyék bets di SIMCA-online. Sumber data tiasa gaduh langkung ti hiji titik bets anu ngungkabkeun bets ku cara anu béda. Pamaké milih titik bets anu lumaku pikeun aplikasina. Mantan ieuampLe ngungkabkeun bets anu bentang dua unit anu béda:
• /Factory1 -batches kalawan lifetimes aggregated leuwih duanana Unit1 jeung Unit2.
• / Factory1 / Unit1 - bets kalawan lifetimes di Unit1 wungkul
• / Factory1 / Unit2 - bets kalawan lifetimes di Unit2 wungkul
• Mun anjeun teu mibanda bets titik dina sumber data Anjeun, Anjeun tiasa make bets Konteks generator di SIMCA-online. Tempo bantuan diwangun-di.
• data bets pilihan
• A titik bets ogé bisa ngandung data bets; data nu aya ngan hiji observasi pikeun sakabéh bets. Catet éta tags kalawan data bets teu kudu dina titik nu boga pungsi pinuh ku titik bets. Ieu cukup yén SimApi ngarojong maca data bets pikeun tags. Diajar langkung seueur ngeunaan data angkatan dina 7.6.
• Di dieu téh urutample tina hiji titik bets:
• Catetan: Potret layar di luhur dicandak tina DBMaker, dibuntel sareng SIMCA-online. Pikeun ningali ieu sorangan dina DBMaker, klik dina View Tombol data dina database Bakers Ragi pikeun nembongkeun dua jandéla, salah sahiji nu titik bets, sarta séjén data prosés.

Jenis data: data numerik, data téks, jeung data leungit

• Pikeun unggal tag, SimApi tiasa ngadukung tilu jinis data: numerik, tex, t sareng leungit:
• Data numeris biasana nilai nyata tina parameter prosés, contonaampka 6.5123. SimApi ngan ukur tiasa ngadamel nilai floating point precision tunggal 32-bit. Single-precision floating-point format -Wikipedia. Sadaya jinis data numerik anu sanés dina sumber data kedah dirobih janten ngambang. Sapertos kitu, aranjeunna tiasa nganyahokeun nilai ageung sareng alit tapi ngan ukur 6 atanapi 7 digit anu signifikan. Diajar langkung seueur dina Pitunjuk Téknis.
• Ieu bisa ngakibatkeun leungitna precision pikeun integer badag atawa pikeun wilangan riil nu duanana badag sarta boga decimals. Kanggo inpo nu leuwih lengkep, tingali Guide Téknis.
• Data téks/string dipaké pikeun ID bets, kaayaan palaksanaan fase atawa pikeun variabel kualitatif. Nilai pikeun téks tag data anu case sensitive. Ieu ngandung harti yén nilai "ngajalankeun" teu sarua jeung
  "LUMPUR". Variabel Datetime teu dirojong langsung ku SimApi, tapi maranéhna bisa balik salaku string formatna salaku YY-MM-DD HH: MM (pikeun ex.ample “2020-09-07 13:45”).
• Nilai leungit hartina euweuh nilai balik, nyaéta, euweuh data.
• Jenis naon anu dipulangkeun dugi ka palaksanaan SimApi. A SimApi terang ngeunaan data dina sumber data sarta kudu balik tipe data nu fits pangalusna.

Tilu modus dimeunangkeun data: Kontinyu, Batc, h jeung Diskrit

• Spésifikasi SimApi ngahartikeun tilu modus dimeunangkeun pikeun data, nyaéta,. tilu cara béda SimApi bisa nyadiakeun data tina tags dina sumber data (atawa di arah séjén: nulis data ka tags dina sumber data).
• Dimeunangkeun data kontinyu - ieu nujul kana data dibaca terus, sarta sequentially, observasi per observasi sakumaha bets atawa prosés evolves. Data dibaca pikeun waktos ayeuna, atanapi kanggo rentang khusus, dina interval anu teratur antara observasi. Pikeun example, kabéh data antara 09:00:00 jeung 10:00:00 sampdipingpin unggal 60 detik, hasilna 61 observasi lamun titik tungtung inklusif.
• Dimeunangkeun data bets - ieu nujul kana observasi tunggal kalawan data pikeun sakabéh bets (teu pakait sareng kematangan husus atawa titik waktu). atribut bets sarta data centering lokal dibaca salaku data bets di SIMCA-online. Kaayaan bets biasana dibaca salaku data bets ogé (iwal aranjeunna dikonpigurasi pikeun dimeunangkeun data diskrit).
• Dimeunangkeun data diskrit - data diskrit bisa diwangun ku sababaraha observasi pikeun loba maturities. Tapi teu kawas data kontinyu, data diskrit teu dibaca sequentially tapi sakabéh data sakaligus pikeun fase husus tina hiji bets. Data henteu kedah dipasing kalayan interval anu teratur tina variabel kematangan. Sadaya data dibaca deui unggal waktos data dipénta, dina interval anu dikonpigurasikeun.
• Pikeun naon waé anu dipasihkeun tag Data tiasa dipénta dina salah sahiji tina tilu modeu, tapi biasana SimApi ngan ukur ngadukung salah sahiji modeu ieu pikeun individu. tag. Kitu ogé, éta diwenangkeun pikeun nyampur tags dina hiji titik, tapi biasana sadayana tags dina titik husus ngarojong mode sarua dimeunangkeun data.
• Pikeun data kontinyu (tapi teu bets- atanapi data2 diskrit), requests bisa dijieun pikeun data ayeuna atawa data sajarah nu topik tina bagian salajengna.
• Henteu sadayana SimApis ngadukung sadaya modeu. Ningali matriks fitur di luhur sareng SimApi web kaca pikeun detil.

Data kontinyu ayeuna sareng Historis ngaliwatan SimApi

• Data kontinyu ngarujuk kana ngolah data anu robih kana waktosna.

data ayeuna

• Maca data ayeuna hartina nanya ka sumber data pikeun nilai panganyarna tina tags dina waktu nanya. Perhatikeun yén waktos sumber data éksternal henteu dianggo di dieu.
• Data dibaca salaku data ayeuna naon SIMCA-online bakal nembongkeun salaku data hirup. Ku sabab kitu, hal anu penting yén teu aya reureuh teu perlu dina sumber data. data ayeuna kudu jadi panganyarna sabisa pikeun digawé ogé di SIMCA-online.
• Sumber data bisa ngagunakeun pangaweruh data na sabaraha lila nilai valid sarta mutuskeun pikeun balik data leungit lamun data atah pikeun titik waktu heubeul teuing. Pikeun example: data dipénta jam 15:00:00 tapi titik data panganyarna dina sumber data ti 03:00:00. Dina hal ieu data geus 12 jam heubeul jadi SimApi bisa mutuskeun pikeun balik nilai leungit (euweuh data).

data sajarah

• Maca data sajarah hartina nanya ka sumber data pikeun nilai hiji atawa leuwih tags pikeun rentang waktu husus kalawan interval husus antara observasi. Perhatikeun yén di dieu nya éta waktu lokal sumber data nu dipaké pikeun manggihan data. Ku alatan éta, sinkronisasi waktu antara sumber data jeung server penting.
• Data sajarah diwangun ku matriks data. Ieu nepi ka palaksanaan SimApi pikeun ménta data ti sumber data, jeung sample eta dina interval nu tangtu sarta ngawangun matrix data pikeun balik:
• Kadang-kadang sumber data sorangan boga fungsi aggregation pikeun mulangkeun data olahan, atawa sampfungsi ling, nu bisa dipaké pikeun mulangkeun data katuhu.
• Pikeun sumber data sejenna, SimApi kudu menta sakabeh data dina rentang waktu lajeng sample observasi katuhu pikeun ngawangun matrix.
• Data kudu dipulangkeun pikeun rentang waktu, sanajan meureun teu aya data atah dina rentang waktu, tapi ngan saméméh waktu mimiti. Pikeun example: data aya dina sumber data dina titik waktu 10 jeung 20. SimApi requests data pikeun waktu 15 jeung 17. Dina hal ieu, nilai pikeun timepoint 10 kudu balik ku SimApi tapi timestamped salaku waktos 15 sareng 17 saprak ieu mangrupikeun titik data anu paling anyar dina waktos éta. Nilai pikeun tags dina waktos 10 disebut salaku nilai wates pikeun rentang dipénta. Pikeun katerangan anu langkung jero ngeunaan nilai wates, tingali pikeun example dokuméntasi pikeun returnBounds di UA Bagian 11: Aksés sajarah - 6.4.3 ReadRawModifiedDetails struktur
  (opcfoundation.org)
• Interpolasi henteu kedah dianggo pikeun ngitung nilai pikeun titik waktos anu bakal datang, sabab data moal cocog sareng anu dibaca sacara real waktos salaku data ayeuna. Pikeun example tina bullet saméméhna: lamun data pikeun 15 jeung 17 ieu interpolasi ngagunakeun nilai pikeun item 10 jeung 20, aranjeunna bakal éféktif ngagunakeun nilai ti mangsa nu bakal datang, nu teu diwenangkeun.
• Sumber data bisa ngagunakeun pangaweruh data na sabaraha lila nilai valid sarta mutuskeun pikeun balik data leungit lamun data atah pikeun titik waktu geus heubeul. Pikeun example: data dipénta pikeun 15:00:00 tapi titik data panganyarna dina sumber data ti 03:00:00. Dina hal ieu, data geus 12 jam heubeul jadi SimApi bisa mutuskeun pikeun balik nilai leungit (euweuh data).

Catetan: SIMCA-online ilaharna teu menta leuwih ti saratus observasi dina hiji panggero salila palaksanaan proyék normal. Nalika ngalakukeun ekstrak dina SIMCA-online, atawa nalika ngajalankeun SIMCA desktop, requests badag data bisa dijieun. Ieu tiasa nyandak waktos anu lami, anu diperkirakeun.

Data ayeuna sareng data sajarah kedah cocog

• Kadang-kadang tiasa aya béda nalika data dibaca salaku data ayeuna atanapi data sajarah sacara real-time. Ieu ngabalukarkeun masalah dina SIMCA-online sabab server otomatis pindah antara data ayeuna jeung sajarah sakumaha diperlukeun.

akuisisi data latency low

• Lamun sumber data dipaké ku SIMCA-online sacara real-time, hal anu penting yén data dina sumber data ayeuna. Henteu kedah aya reureuh anu teu perlu dina akuisisi data dina sumber data. Data prosés kontinyu pikeun sakabéh variabel kudu sadia dina waktos anu sareng pikeun unggal observasi. Data nu datang dina telat pikeun sababaraha variabel moal dipulut ku SIMCA-online.

Data tiasa dibaca iraha waé 

• Nalika SIMCA-online menta nilai a tag pikeun waktu t eta bakal nampa nilai tina sumber data ti waktu t, atawa observasi panganyarna dina sumber data saméméh waktu t, atawa nilai interpolasi pikeun waktu t. Ku kituna, server bakal salawasna meunang nilai dina unggal waktu eta nanya, sanajan hiji observasi pikeun titik waktu pasti ieu bisa jadi teu aya dina sumber data.
• Waktosamps dina SimApi sok UTC. SIMCA-online klien tur SIMCA nampilkeun waktos sakumaha waktos lokal.

Threading 

• SimApi, sacara standar, disebut ku hiji benang ku pangguna SimApi. Ieu leres kanggo sadaya versi SIMCA sareng SIMCA-online dugi ka versi 17.
• SIMCA-online 18 ngarojong hiji bandéra fitur pikeun ngahurungkeun aksés multi-threaded ngaliwatan SimApi. Baca deui dina topik pitulung Aksés SimApi sakaligus.
• Ieu ngandung harti yén SimApis kedah nyiapkeun multi-threading, upami mungkin, ku nyieun thread palaksanaan SimApi aman, sarta dokumén ieu sareng sagala tinimbangan pikeun pamaké SimApi.

Log file

• SimApi kedah log tindakan, pesen kasalahan sareng peringatan kana log na file pikeun mantuan ngungkulan. Anggo tingkat log anu béda pikeun nunjukkeun pentingna logging.
• Disarankeun log "Teu dilaksanakeun" pikeun fitur anu teu acan dilaksanakeun dina SimApi a.

Kasalahan penanganan

• Nalika SimApi teu bisa minuhan pamundut ti sumber data eta tiasa ngadamel masalah ieu dina salah sahiji dua cara; ku mulangkeun nilai leungit (euweuh data) atawa ku sinyal kasalahan SimApi:
• Ngabalikeun nilai leungit ka panelepon jeung sinyal kasuksésan ngamungkinkeun panelepon neruskeun sakumaha normal (tapi tangtu tanpa data). Ieu mangrupikeun prakték anu disarankeun pikeun kasalahan parsial sapertos nalika data tiasa dicandak pikeun sababaraha, tapi henteu sadayana, tags dina pamundut.
• Sinyal kasalahan SimApi ngamungkinkeun nu nelepon (pikeun example server SIMCA-online) ningali ieu geuwat sarta meta. Ieu mangrupikeun prakték anu disarankeun pikeun pamundut anu gagal lengkep sareng henteu tiasa ngabalikeun data naon waé.
• SIMCA-online handles nilai leungit atawa Konci kasalahan béda, sakumaha dijelaskeun dina Guide Téknis SIMCA-online.

syarat kinerja SimApi

• Fungsi dina SimApi digunakeun pikeun meunangkeun data.
• Lamun aksés data slow, SimApi moal jalan ogé nu ex ieuample nempokeun: Mun SIMCA-online requests data unggal detik, tapi waktu nu diperlukeun dua detik pikeun ménta, bakal server SIMCA-online pernah bisa tetep nepi sacara real-time tapi progressively ragrag salajengna sarta salajengna balik.
• Dina sub-bagian kami bakal nunjukkeun kumaha SIMCA sareng SIMCA-online ngagunakeun aksés data fungsi SimApi sareng sabaraha sering fungsi SimApi bakal disebut. Ieu tiasa ngabantosan dina netepkeun syarat kinerja pikeun palaksanaan SimApi.

Pamakéan SIMCA ngeunaan fungsi SimApi

• Nalika SIMCA desktop atawa produk offline séjén ngagunakeun SimApi pikeun ménta data, requests ieu bakal bets sarta ngolah data pikeun susunan variabel dina rentang waktu nu tangtu.
• Kusabab pamundut ieu diprakarsai sacara manual ku pangguna, aranjeunna henteu sering pisan sareng henteu nyababkeun beban anu signifikan pikeun sumber data.
• Pungsi SimApi ieu dipaké pikeun meunangkeun data:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

pamakéan SIMCA-online ngeunaan fungsi SimApi

• SIMCA-online dipaké pikeun real-time ngawas prosés a, sarta ku kituna requests data ngaliwatan SimApi dina interval nu sarua. Interval palaksanaan anu paling pondok anu tiasa dianggo nyaéta 1 detik. Sababaraha ex dunya nyataampinterval palaksanaan nyaéta 10 s, 1 menit, atawa 10 menit.
• Server tiasa gaduh seueur proyék anu dijalankeun dina waktos anu sami.
• Pikeun ngurangan jumlah panggero API ngaliwatan SimApi, server ngaoptimalkeun requests data ku cara ngagolongkeun loba requests leutik babarengan kana hiji pamundut nu leuwih gede pikeun sakabéh variabel dina waktos anu sareng (diajar leuwih dina topik pitulung 'Dioptimalkeun bacaan tina sumber data ngaronjatkeun kinerja').
• Algoritma palaksanaan server tiasa sapertos kieu nalika nyuhunkeun data nganggo fungsi SimApi anu didaptarkeun di handap ieu:
• Sadaya fase anu dieksekusi dina interval anu sami dikelompokkeun kana sauran SimApi tunggal pikeun ngirangan jumlah telepon. Server maca data pangénggalna pikeun sadaya variabel anu dianggo ku sadaya modél anu ngabagi interval, nyaéta, panggero ieu bakal ngahasilkeun baris data anu lega anu teras dianggo ku sadaya proyék.
  • simapi2_connectionReadCurrentData
• Pikeun unggal proyék bets server ogé kudu nyaho bets nu aktip. Ieu ogé kedah kajantenan unggal waktos proyék dieksekusi:
  • simapi2_nodeGetActiveBatches
  • simapi2_nodeGetBatchTimes disebut kirang sering.
• Sajaba ti éta, SIMCA-online ogé merlukeun data sajarah. requests ieu lumangsung ngan lamun diperlukeun, kayaning nyekel up awal bets nu dimimitian saméméh SIMCA-online ieu dimimitian, atawa nalika server ragrag balik sarta perlu maca blok data:
  • simapi2_connectionReadHistoricalDataEx
• Opsional, sababaraha konfigurasi proyék nganggo fitur anu nganggo data bets atanapi data diskrit anu nyababkeun SimApi nelepon ka:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• Opsional, sababaraha konfigurasi proyék nganggo write-back pikeun nyorong data deui ka sumber data:
  • simapi2_connectionWriteHistoricalDataEx (sareng fungsi anu saluyu pikeun data bets, data diskrit)
• Kadé unggal nelepon ka fungsi inti pikeun meunangkeun data, readCurrentData, getActiveBatches / getBatchTimes, gancang jeung nu teu komputasi teuas pikeun sumber data sorangan, nunjukkeun sabaraha sering SIMCA-online bisa nelepon fungsi maranéhanana.

Nguji jeung validasi data SimApi

• Bagian ieu ngeunaan nguji hiji SimApi pikeun pariksa yen data balik ti dinya cocog data dina sumber data sorangan. Ngajalankeun tés sapertos ieu penting saatos nyiptakeun atanapi ngarobih palaksanaan SimApi, atanapi nalika API tina sumber data parobihan.
• Dina prakna, validasi data dilakukeun ngagunakeun SIMCA-online sareng fungsionalitas Extract pikeun narik data tina sumber data ngalangkungan SimApi teras ngabandingkeun sareng data atah dina sumber data. Desktop SIMCA teu bisa dipaké pikeun nguji aspék real-time tina hiji SimApi.

Persiapan jeung sarat

• Sababaraha item opsional tapi tiasa dilaksanakeun upami lingkup tés anjeun kalebet:

1. Install SIMCA-online sakumaha ditétélakeun dina ReadMe sarta Instalasi Guide.pdf nu asalna di pos produk.
2. Meunangkeun lisénsi pikeun SIMCA-online server eta tur masangkeunana. SimApi moal jalan tanpa lisénsi. Artikel dasar pangaweruh pikeun SIMCA-online nembongkeun kumaha carana lisénsi produk. Pikeun example: SIMCA-online 18 (sartorius.com)
3. Pasang sareng konpigurasikeun SimApi anu anjeun hoyong uji. Ningali bab 4 - 5 dina dokumén ieu sareng pituduh pangguna tina SimApi khusus.
   • a. Opsional: pastikeun pituduh pamake up-to-date sareng leres.
4. Pastikeun anjeun gaduh alat pikeun sumber data anjeun anu tiasa anjeun pake pikeun ngabandingkeun data SimApi.
5. Dina klien desktop SIMCA-online, asup ka server SIMCA-online anjeun sarta pamakéan File > Ekstrak pikeun meunangkeun data ngaliwatan SimApi.
6. Opsional upami wengkuan tés anjeun kalebet: saatos réngsé tés, cabut pamasangan SimApi sareng pariksa files dipiceun.

Naon pikeun nguji

• Matriks fitur dina bab 3 daptar sadaya fitur anu mungkin, tapi palaksanaan SimApi anu dipasihkeun ngan ukur ngadukung sawaréh. Anjeun kedah nguji sadaya fitur anu dilaksanakeun ku SimApi anu dipasihkeun.
• Tés di handap ieu umum pikeun kalolobaan palaksanaan SimApi:
• Auténtikasi nganggo nami pangguna sareng kecap akses
• Nguji rupa-rupa setélan dina konfigurasi tina SimApi
• hirarki titik: The titik jeung tags kakeunaan ku SimApi anu bener.
  • Kudu aya a tag kakeunaan pikeun sakabéh "variabel" nu kudu sadia ngaliwatan SimApi. Misalamples: ukuran prosés, nilai diitung, konstanta.
• Daya tahan sambungan: upami sumber data henteu sayogi, ieu nyababkeun peringatan atanapi kasalahan dina log file, tapi yén sambungan ka sumber data geus ulang otomatis lamun sumber data geus sadia.
• Sababaraha instansi: yén dua instansi tiasa dikonpigurasikeun sareng dianggo sacara mandiri sareng sakaligus, kalayan log anu misah files.
• data ayeuna: nimba data ayeuna keur tags. Pastikeun data mangrupa nilai panungtungan dipikawanoh ti sumber data, atawa leungit pikeun kualitas goréng atawa lamun data heubeul teuing.
  • Ékstrak data unggal 10 detik (atanapi langkung) sakedap.
• Data kontinyu sajarah: nimba data sajarah pikeun tags.
  • Paké rentang waktu nu cocog mun anjeun sasari data ayeuna. Pastikeun yén data ayeuna cocog sareng data sajarah, sareng data atah dina sumber data.
  • Coba rentang waktu béda jeung sampling interval, pariksa data cocog sumber data.
  • Coba nimba data unggal 1 s, nu mangrupakeun s shortest mungkinampinterval ling.
  • Coba rupa-rupa jinis tags dina sumber data (variabel prosés, jsb), mastikeun data cocog.
  • Catetan: SIMCA-online bisa ngabagi hiji pamundut data sajarah badag kana sababaraha sakumpulan leutik. Ieu bakal katingali dina log SimApi.
• Pastikeun yén SimApi tiasa dianggo sareng data téks, data numerik, sareng data anu leungit.
• SimApi log file. Pariksa yén log ngandung éntri anu wajar.
• Node bets: klik-katuhu hiji node jeung ngalakukeun Manggihan bets.
  • Pariksa nami bets, waktos mimiti, waktos tungtung pikeun bets.
  • Coba bets aktip anu dijalankeun dina sumber data. Sakuduna teu boga waktu tungtung ngaliwatan SimApi.
• Prosés node bets identifier tag. Upami SimApi ngagaduhan fungsionalitas titik angkatan (tingali bullet sateuacana), éta ogé kedah gaduh identifier bets. tag dina prosés cocog titik data. Data pikeun ieu tag kedah janten identifier bets (ngaran bets). Data ieu dipikabutuh pikeun proyék-proyék angkatan pikeun ngaidentipikasi mana bets baris data milik.

Gumantung kana upami SimApi ngadukung éta, anjeun ogé hoyong nguji:

• data bets ngagunakeun File > Ékstrak.
• Data diskrit ngagunakeun File > Ékstrak. Catetan: pikeun nguji data diskrit kalawan File > Ékstrak titik, titik bets jeung titik data diskrit kudu dina SimApi sarua (lamun SIMCA-online executes proyék, aranjeunna tiasa ti SimApis béda).
• Tulis deui - ngadorong bets data ka sumber data. Pikeun nguji ieu, anjeun kudu ngonpigurasikeun konfigurasi proyék di SIMCA-online pikeun nulis balik vektor data ka sumber data. Lajeng ngaéksekusi proyék di SIMCA-online tur pariksa data anu ditulis deui dina sumber data.
• Data kontinyu dikonpigurasi dina kaca Évolusi Tulis Balik dina konfigurasi proyék.
• Data diskrit geus ngonpigurasi dina kaca sarua, tapi ngan pikeun fase ngonpigurasi pikeun dimeunangkeun data diskrit.
• data bets ti bets Tulis deui

INFO LEUWIH

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Swédia
• Telepon: +46 90-18 48 00
• www.sartorius.com
• Inpormasi sareng inohong anu aya dina petunjuk ieu cocog sareng tanggal vérsi anu dijelaskeun di handap.
• Sartorius ngagaduhan hak pikeun ngarobih téknologi, fitur, spésifikasi sareng desain alat tanpa aya bewara. Bentuk maskulin atanapi feminin dianggo pikeun ngagampangkeun kabaca dina paréntah ieu sareng salawasna nunjukkeun sadaya jinis kelamin.
  Bewara hak cipta:
• Parentah ieu, kaasup sakabeh komponen, ditangtayungan ku hak cipta.
• Sagala pamakéan saluareun wates hukum hak cipta teu diwenangkeun tanpa persetujuan urang.
• Ieu lumaku hususna pikeun nyitak ulang, tarjamahan sareng ngédit henteu paduli jinis média anu dianggo.

FAQ

• P: Naon tujuan SimApis?
  • A: Tujuan utama SimApis nyaéta pikeun nyayogikeun data ka produk Umetrics Suite pikeun nyiptakeun proyék sareng ngawangun modél.
• Q: Kumaha carana abdi tiasa troubleshoot masalah sareng pamasangan SimApi?
  • A: Anjeun tiasa troubleshoot ku nguji ti SIMCA-online, pariksa log SimApi file, sareng mastikeun konfigurasi akun jasa anu leres.

Dokumén / Sumberdaya

SARTORIUS Sim Api Software [pdf] Pituduh pamaké Parangkat Lunak Sim Api, Parangkat Lunak Api, Parangkat Lunak

Rujukan

• Manual pamaké