SARTORIUS Sim Api -ohjelmiston käyttöopas

SARTORIUS Sim Api -ohjelmisto

Tekniset tiedot

• Tuotteen nimi: SimApi Guide
• Julkaisupäivä: 5
• Tarkoitus: Antaa tietoja Umetrics Suite -tuotteille

Tuotteen käyttöohjeet

SimApisin esittely

• SimApisia käytetään tietojen hakemiseen projektin luomista ja mallin rakentamista varten Umetrics Suite -tuotteissa.

SimApisin hankkiminen

• Saadaksesi SimApis, katso virallista dokumentaatiota tai ota yhteyttä asiakastukeen.

SimApi-ominaisuudet

• SimApis tarjoaa reaaliaikaista tietoa seurantaa, ohjausta ja mallin rakentamista varten SIMCA- ja SIMCA-online-palveluissa.

Vain nykyinen tiedonkäyttö

• On suositeltavaa käyttää vain nykyistä tietoa ja välttää historiallisia tietoja parhaan suorituskyvyn saavuttamiseksi.

Valmistaudutaan SimApi-asennukseen

• Varmista ennen asennusta, että järjestelmäsi täyttää käyttöoppaassa määritellyt vähimmäisvaatimukset.

SimApin asentaminen

• Asenna SimApi järjestelmääsi noudattamalla käyttöohjeen vaiheittaisia ​​ohjeita.

Asetetaan SimApi SIMCA:lle

• Määritä SimApi-asetukset SIMCA:ssa annettujen ohjeiden mukaisesti.

SimApin määrittäminen SIMCA-onlinea varten

• Määritä SimApi reaaliaikaista tiedonhakua ja takaisinkirjoitusta varten SIMCA-onlinessa.

Testaus ja vianetsintä

• Suorita asennuksen jälkeen testaus varmistaaksesi oikean toiminnan. Jos ongelmia ilmenee, katso käyttöoppaan vianetsintäosaa.

Testaus SIMCA-onlinesta

• Testaa SimApi-integraatiota SIMCA-onlinesta varmistaaksesi tietojen haun.

Vianetsintä Login avulla Files

• Käytä SimApi-lokia file tunnistaa ja ratkaista asennus- tai käyttöongelmat.

Palvelutilin määritys

• Varmista saumattoman toiminnan varmistamiseksi SIMCA-online-palvelutilin oikea konfigurointi.

Tekniset tiedot

• Katso SimApisista yksityiskohtaiset tekniset tiedot käyttöoppaan osiosta 7.

SimApisin esittely

• SimApi on ohjelmistoliitäntä Umetrics® Suite -ohjelmiston ja tietolähteen välillä. SimApin ensisijainen tarkoitus on toimittaa tietoja SIMCA®-online- tai SIMCA®-verkkoon.
• Sartorius Stedim Data Analytics AB kehittää SimApisia useille eri tietolähteille, kuten prosessihistorioitsijoille ja yleiskäyttöisille tietokantoille.
• Tämä asiakirja näyttää, mikä SimApi on ja kuinka sitä käytetään Umetrics Suite -tuotteissa. Opit suunnittelemaan ja asentamaan SimApin, vianmäärityksen ja asennuksen testaamisen. Viimeinen luku sisältää kehittäjille suunnattuja SimApisin teknisiä yksityiskohtia.

SimApin tarkoitus: toimittaa tietoja Umetrics Suite -tuotteille

• SimApin ensisijainen tarkoitus on toimittaa tietoja SIMCA-onlinelle tai SIMCA:lle tietolähteestä. Tietolähde ei ole osa SIMCA-onlinea, mutta se voi olla prosessihistorioitsija tai muu järjestelmä, joka säilyttää ja hallinnoi tietoja.
• SimApi paljastaa solmuhierarkian, joka vastaa a:n kansioita file järjestelmä. Jokainen solmu voi sisältää muita solmuja tai tags. A tag vastaa muuttujaa. Näitä varten tags, tietoja voi saada. Kuvassa a tag, Temp, valittu solmussa
• BakersYeastControlGood tietolähteessä SIMCA-onlinessa. Se näyttää myös uusimmat arvot, jotka on otettu tietolähteestä.

SimApi-käyttö Umetrics Suitessa

• Työpöytäohjelmisto SIMCA voi käyttää SimApia datan hakemiseen projektin luomista ja mallin rakentamista varten seuraavan kuvan mukaisesti.
• SIMCA-online käyttää SimApisia saadakseen tietoja reaaliajassa seurantaa ja ohjausta varten sekä kirjoittaakseen tietoja takaisin tietolähteeseen. Seuraava kuva näyttää missä SimApi on järjestelmässä, joka koostuu tietolähteestä, SIMCA-online-palvelimesta ja asiakkaista.

Yleisesti käytetty SimApis

• Yleisimmin käytetyt SimApit ovat:
• PI AF SimApi Aveva (entinen OSIsoft) PI-järjestelmiin yhdistämiseen.
• OPC UA SimApi
• ODBC SimApi – yleiseen pääsyyn tietokantoihin, kuten SQL Server tai Oracle
• Kaikki saatavilla olevat SimApit ja niiden ominaisuudet on lueteltu kohdassa 3.

DBMaker SimApi simulointitiedoille

• DBMaker on SIMCA-online-palvelinasennuksen mukana toimitettu sovellus. Se simuloi tietolähdettä, kuten prosessihistorioitsijaa, käyttämällä esiladattua tietotaulukkoa, jossa havainnot toimitetaan yksitellen SIMCA-onlinelle DBMaker SimApin kautta.
• DBMakeria käytetään vain esittelytarkoituksiin, eikä sitä voida käyttää tuotannossa tietolähteen reaaliaikaisten tietojen kanssa. Katso sisäänrakennetusta ohjeesta lisätietoja DBMakerista.

Lisädokumentaatio

• Tämä asiakirja on yksi joukosta aiheeseen liittyviä asiakirjoja, joista jokaisella on erilainen painopiste ja kohdeyleisö:

Lähde	Mitä	Jossa
SIMCA verkossa web sivu	Esittelytiedot ja lataukset	sartorius.com/umetrics-simca- verkossa

SIMCA-online ReadMe ja Installation.pdf	Asennus ja SIMCA- online-demotietojen käytön aloittaminen	Asennuspakkauksessa file
SIMCA-online käyttöönottoopas	Esittelee SIMCA-online-toiminnallisuuden, tuo sen kontekstiin muiden Umetrics Suite -ohjelmistojen kanssa, kuvaa onnistuneen käyttöönoton vaatimukset ja parhaat käytännöt sekä vaiheittaiset asennusohjeet.	sartorius.com/umetrics-simca- verkossa
SimApi-opas	SimApi-asennusten valmistelu ja suorittaminen, mukaan lukien vianetsintä. Sisältää myös teknisiä yksityiskohtia SimApisista kehittäjille.	sartorius.com/umetrics-simapi
SimApi käyttöoppaat	Jokaisen julkaistun SimApin dokumentaatio, jossa on ominaisuuksia, asennusohjeita ja konfigurointitietoja.	sartorius.com/umetrics-simapi
SIMCA-online tekninen opas	Tekninen referenssi SIMCA-online-palvelimen asennuksen suunnitteluun, vianmääritykseen ja SIMCA-onlinen toiminnan perusteelliseen käyttöön.	sartorius.com/umetrics-simca-verkossa
SIMCA-verkko-ohje	Web-pohjainen ohje SIMCA-onlinen käyttöön ja SIMCA-onlinen toimintaan.	Itse ohjelmistossa ja edelleen sartorius.com/umetrics-simca
SIMCA verkossa Web Asiakkaan asennusopas	Kuvaa SIMCA-onlinen asennuksen Web Asiakas.	sartorius.com/umetrics-simca-verkossa
Umetris-tietokanta	Haettavissa oleva tietokanta, joka sisältää artikkeleita jokaisesta julkaistusta ohjelmistoversiosta, teknisistä artikkeleista ja tunnetuista Umetrics Suite -tuotteiden ongelmista.	sartorius.com/umetrics-kb
SIMCA ohje/käyttöopas	Kuinka käyttää työpöydän SIMCA:ta projektien luomiseen ja mallintamiseen.	SIMCA:ssa ja edelleen sartorius.com/umetrics-simca
Tukea web sivu	Kuinka saada teknistä tukea.	sartorius.com/umetrics-support

Tekninen tuki

• Sartoriuksen online-tukitiimi vastaa SimApisia koskeviin teknisiin kysymyksiin ja voi myös välittää SimApisin parannuspyynnöt asianmukaisille henkilöille. Lisätietoja osoitteessa sartorius.com/umetrics-support.

SimApisin hankkiminen

• Tarjoamme saatavilla olevien SimApisten dokumentaatiota ja linkkejä asennusohjelmiin osoitteessa sartorius.com/umetrics-simapi.
• Jokainen SimApi on dokumentoitu sen käyttöoppaassa.
• SimApi-opas, jota luet ei,w täydentää näitä tietoja SimApilla, jotka täydentävät tietoja SimApin suunnittelusta, asennuksesta ja vianetsinnästä.

SimApi-ominaisuudet

• Kaikki tietolähteet eivät ole samanlaisia. SimApin ei tarvitse toteuttaa kaikkia spesifikaation toimintoja. Näistä syistä eri SimApit tarjoavat erilaisia ​​toimintoja. Seuraavassa matriisissa on lueteltu käytettävissä olevat SimApit ja niiden ominaisuudet.
• Ominaisuudet selitetään alla. Huomaa, että taulukossa on erilliset sarakkeet, jotka osoittavat, mitkä ominaisuudet ovat käytettävissä SIMCA-onlinessa ja SIMCA:ssa.

Ominaisuus	Tarkoitus	SIMCA-verkkokäyttö	SIMCA:n käyttö
Nykyiset tiedot	Lue yksittäinen havainto uusimmalla arvolla tietolähteestä.	Reaaliaikainen normaali suoritus	–
Historialliset tiedot	Lue useita havaintoja kerralla tietolähteen historiallisilla tiedoilla.	Ota kiinni ja ennusta menneitä tietoja, luo projekteja käyttämällä File > Uusi	Ohjattu tietokannan tuontitoiminto prosessitietojen tuomiseksi mallin luomista varten.
Diskreetti data	Lue laboratorio-/IPC-tiedot tietolähteestä. Paljon havaintoja erää kohden.	Eräprojekteihin, joissa on erillistä tiedonhakua varten määritettyjä vaiheita tai eräehtoja.	–
Erätiedot	Lue eräehdot ja lopulliset laatuattribuutit (tai	Eräehdot tai paikallinen keskitys.	Ohjattu tietokannan tuontitoiminto eräehtojen lukemiseen

Ominaisuus	Tarkoitus	SIMCA-verkkokäyttö	SIMCA:n käyttö
	muut MES-tyyppiset tiedot). Yksi havainto erää kohden.		erätason mallin luominen.
Eräsolmu	Määritä aloitusaika ja lopetusaika (tyhjänä aktiiviselle erälle) tietylle erälle. Luettele kaikki erät, jotka olivat olemassa tietyllä aikavälillä.	Vaaditaan eräkokoonpanojen suorittamiseen.	Ohjattu tietokannan tuontitoiminto valitaksesi tuotavat erät.
Kirjoita takaisin – jatkuva data	Kirjoita jatkuvat tiedot, kuten ennusteet, takaisin tietolähteeseen.	Kirjoita takaisin tiedot erän kehitystasolta Control Advisorille tai jatkuville konfiguroinneille	–
Kirjoita takaisin – diskreetti	Kirjoita erillinen data, kuten ennusteet, takaisin tietolähteeseen.	Kirjoita takaisin erämäärityksille erän kehitystasolla erillistä tiedonhakua varten määritettyjen vaiheiden osalta	–
Kirjoita takaisin – erätiedot	Kirjoita takaisin erätason tiedot, kuten ennusteet tai lopulliset laatuattribuutit, tietolähteeseen.	Kirjoita takaisin erämäärityksiä varten erätasolla	–
Solmuhierarkia	SimApi tukee solmuhierarkiaa, kuten a file järjestelmä. Jokainen solmu voi sisältää tags ja muut solmut. Hierarkian ansiosta on helpompi hallita suurta määrää solmuja ja tags.	Tuettu kaikissa paikoissa tags käytetään.
Array tag laajennus	Joukko tag tallentaa useita arvoja. SimApi laajentaa joukkoa tag monille yksilöille tags, yksi jokaiselle taulukon elementille.	Tuettu missä tags käytetään jatkuvaan dataan. Jokainen laajeni tag on kartoitettava muuttujaan SIMCA-projektissa.
Useita tietolähteitä	SimApi voi muodostaa yhteyden useampaan kuin yhteen tietolähteeseen tai tukee useita itsensä esiintymiä yksittäisillä asetuksilla ja lokilla files jokaiselle tapaukselle.	Yhdistä useisiin samanlaisiin tietolähteisiin.	–
Yhteyden joustavuus	Jos SimApi katkaisee yhteyden tietolähteeseen, se yrittää muodostaa yhteyden uudelleen automaattisesti.	SimApia ei tarvitse käynnistää uudelleen yhteyden muodostamiseksi tietolähteeseen.	–
Kehitetty talon sisällä	SimApi on kehittänyt, tarjoaa ja tukee

Vain nykyistä tietoa ilman historiallisia tietoja ei suositella

• Jotkut SimApit, erityisesti OPC DA, tukevat vain nykyisten tietojen lukemista, eivät historiallisten tietojen lukemista.
• SimApia, joka tukee vain nykyistä dataa, ei voida käyttää työpöydän SIMCA:ssa, koska se ei pysty lukemaan historiallisia tietoja, joiden pohjalta mallit voidaan rakentaa.
• SIMCA-onlinea varten suosittelemme vahvasti tietolähdettä ja SimApia, jotka tarjoavat paitsi nykyisen tiedon reaaliaikaista suorittamista varten, myös historiallisia tietoja, jotta voidaan ennustaa ja saada aikaisemmat tiedot. SIMCA-online vaihtaa automaattisesti reaaliaikaisten tietojen ja historiallisten tietojen välillä tarpeen mukaan, eikä tätä voi kytkeä pois päältä.
• Tietolähde, joka tarjoaa vain nykyistä tietoa, mutta ei historiatietoja, voi toimia jatkuvissa projekteissa SIMCA-onlinessa, mutta eräprojekteissa tarvitaan historiatietoja.

Valmistaudutaan SimApi-asennukseen

• Tässä osiossa kuvataan tärkeitä tietoja SimApin onnistuneesta asennuksesta.

64-bittinen tai 32-bittinen SimApis

• Jokaisesta SimApista on 32- ja 64-bittinen versio.
• SIMCA-online ja SIMCA ovat 64-bittisiä ja vaativat 64-bittiset SimApis-versiot. Vanha 32-bittinen SimApis on edelleen saatavilla vanhemmille asennuksille.

Tukin sijainti file ja asetukset

• SimApi tallentaa lokinsa files piilotetussa Program Data -kansiossa1:
  %programdata%\Umetrics\SimApi, jossa %programdata% liittyy tietokoneesi todelliseen kansioon. Se on oletuksena C:\ProgramData.
• Jokainen SimApi käyttää yleensä omaa lokiaan file, joka samoin kuin SIMCA-online-palvelimen loki file sisältää enemmän tai vähemmän tietoja lokitason asetuksesta riippuen. Tämä file on hyödyllinen vianetsinnässä. loki file on nimetty
  .log missä on SimApi, jota olet asentamassa, esimample PIAFSimApi. Katso myös seuraava osa SIMCA-online SimApi -esiintymien nimistä.
• Tämä kansio sisältää myös SimApi-asetukset XML-muodossa file nimetty .xml.
• Useimmissa SimApeissa on graafiset käyttöliittymät, jotka muuttavat xml:n asetuksia file, mutta joillekin syötät muutokset suoraan XML:ään file tekstieditorilla, kuten Notepadilla. Katso kunkin SimApin käyttöopas.

File nimet, kun nimettyjä esiintymiä käytetään SIMCA-onlinen kanssa

• SIMCA-onlinessa jokainen SimApi-ilmentymä saa oman kokoonpanonsa file ja kirjaudu file työskentelemään kunkin SimApin useiden esiintymien kanssa. Näiden nimet files on jälkiliitteenä ilmentymän nimi, joka on annettu SimApi-välilehdellä SIMCA-online Server Options -valintaikkunassa.
• Seuraava example näyttää näiden nimet files, missä on korvattava SimApi-nimellä.
• Määrityksen nimi, joka annetaan ilmentymän lisäyksen yhteydessä: OmegaServer
• Kokoonpano file nimi: OmegaServer.xml
• Loki file nimi: OmegaServer.log
• Huomaa, että yleinen file .log file on edelleen luotu. Tämä loki file sisältää merkintöjä, joita ei teknisistä syistä voida ohjata lokiin file tapauksista..
• Tämä kansio on oletusarvoisesti piilotettu Windowsissa. Nähdäksesi sen sisään File Explorer määrität sen näyttämään piilossa files. Huomaa, että voit navigoida piilotettuun kansioon kirjoittamalla osoitteen File Explorerin osoitepalkki.
• Huomaa, että SIMCA ei tue useita SimApin esiintymiä ja käyttää siksi nimiä ilman ilmentymän nimeä yllä kuvatulla tavalla.

Verkon suunnittelu

• Sinun tulisi sijoittaa SIMCA-online-palvelin lähelle verkon tietolähdettä. Tämä varmistaa nopean yhteyden SIMCA-onlinen ja sen tietolähteen välillä.
• Verkkolaitteet voivat häiritä SIMCA-onlinen ja tietolähteen välistä yhteyttä.

Käyttäjätilit ja tietolähteen käyttöoikeudet

• Tietolähteet hallitsevat yleensä pääsyä tietoihinsa. Tämä tehdään yleensä käyttäjätunnuksilla ja salasanoilla, mutta IP-osoite- tai DNS-pohjaisia ​​rajoituksia voidaan myös käyttää (esim.ample PI Trusts in Aveva PI System).
• Käyttäjätunnus ja salasana voidaan antaa tietolähteelle eri tavoilla:
• SimApi ajetaan sen käyttäjän Windows-käyttäjänä, joka käyttää palvelintietokoneen SIMCA- tai SIMCA-online-palvelutiliä. SimApi voi muodostaa yhteyden tietolähteeseen tämän tilin avulla. Näin toimivat OPC I ja PI SimApi sekä ODBC, jos et anna valtuustietoja määrittäessäsi sitä.
• Yleiseen ODBC:hen voit käyttää ODBC Data Sources Administrator -sovellusta, joka löytyy Windowsin Käynnistä-kohdasta.
• Jotkut tietokantatoimittajat tarjoavat omia ajureita ja työkaluja tietokantoilleen. Oracle-tietokannat, esimample, käytä Oracle Data Access Componentsia (ODAC).
• Joissakin SimApeissa, kuten PI AF:ssä ja ODBC:ssä, on määritysikkunat, jotka tallentavat salatut valtuustiedot SimApi XML -kokoonpanoon. file.
• PI:llä on myös useita suojausvaihtoehtoja saatavilla PI-palvelintietokoneen PI-järjestelmänhallintatyökaluissa. Lue lisää PI AF SimApi -käyttöoppaasta. Tämä opas on hyödyllinen, vaikka käytät vanhempaa OSIsoft PI SimApi.
• OPC DA ja HDA käyttävät DCOM:ia siirtona tietolähteen ja SimApin välillä. DCOM on määritetty Component Services -työkalulla (DCOMCNFG.EXE) Windowsissa ja käyttää Windows-todennusta.
• Vanhemmassa OSIsoft PI SimApissa (ei uudemmassa AF SimApissa) OSIsoft AboutPI-SDK -sovellusta (PISDKUtility.exe) käytetään yhteyden muodostamiseen PI-palvelimeen.

Tietolähteen liitettävyyden tarkistaminen
Kun haluat asentaa SimApin tietokoneeseen, voi olla hyödyllistä varmistaa yhteys kyseisestä tietokoneesta tietolähteeseen toisella työkalulla:

• Windowsin ODBC-tietolähteitä käytetään yleisen ODBC:n määrittämiseen ja testaamiseen. Huomaa, että tästä työkalusta on kaksi versiota 64-bittisissä Windowsissa: yksi 32-bittisille sovelluksille ja toinen 64-bittisille sovelluksille. Käytä Test Data Source -painiketta ohjatun ODBC-määritystoiminnon lopussa vahvistaaksesi yhteyden tietokantaan. Suosittelemme, että määrität tietolähteesi järjestelmän DSN:iksi.
• Tietokantakohtainen yhteystyökalu tietokannan toimittajalta, kuten Oracle Data Access Components.
• PI System Explorerin avulla voidaan testata yhteyttä PI AF -palvelimeen. Se on osa PI AF Client -ohjelmaa, joka on PI AF SimApin ennakkoedellytys.
• Unified Automationin OPC UA Expert – UaExpert on monikäyttöinen testiasiakasohjelma OPC UA -palvelimille.
• PI-SDK-sovellusta (PISDKUtility.exe) voidaan käyttää liitettävyyden testaamiseen ja view kaikki virheilmoitukset, jotka on voitu kirjata lokiin, kun SIMCA-online yrittää muodostaa yhteyden PI-palvelimeen. Tätä käytetään vain vanhemmassa OSIsoft SimApissa, ei PIAF:ssä.
• PI-järjestelmänhallintatyökaluja käytetään PI-palvelintietokoneessa vianmääritykseen siltä puolelta. esimample, etsiä tietoturvaongelmia, jotka estävät pääsyn SIMCA-online-palvelimelta. Lisätietoja PI-järjestelmän vianmäärityksestä tässä YouTube-videossa.
• Excelillä voidaan hakea tietoja ODBC-yhteydestä ja useimmista muista järjestelmistä, kun sopiva laajennus on asennettu.
• Matrikon OPC Explorer for Ior HDA (nämä ovat erillisiä työkaluja) voidaan käyttää OPC-yhteyden testaamiseen, ja Matrikon OPC Analyzeria voidaan käyttää OPC-yhteysongelmien diagnosointiin. Lataa nämä ilmaiset työkalut osoitteesta https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (DInd HDA:lle) OPC Training Institutesta web sivuston avulla käyttäjät voivat helposti diagnosoida viestintä- ja tietoturvaongelmat ja korjata ne välittömästi napin painalluksella. Kaikki tämä voidaan tehdä ilman, että sinun tarvitsee koskaan opetella määrittämään DCOM

SimApin asentaminen

Näin asennat SimApin tietokoneeseen:

1. Lue asentamasi SimApin käyttöopas. Se sisältää SimApin yksityiskohtia, jotka täydentävät nyt luettavia yleisiä ohjeita.
2. Asenna ja määritä kaikki SimApi-käyttöoppaassa mainitut edellytykset (esimamptietokantaohjaimet tai SDK:t)
3. Asenna SimApi suorittamalla asennusohjelma. Asenna 64-bittinen (x64) tai 32-bittinen (x86) versio, joka vastaa ohjelmistoa, jossa käytät sitä.
4. Määritä SimApi SIMCA-onlinessa tai SIMCA:ssa seuraavissa osissa kuvatulla tavalla ja katso käytettävissä olevien asetusten kuvaukset SimApin käyttöoppaasta.
5. Käynnistä SIMCA-online-palvelin. Huomaa, että tämä voi viedä aikaa, koska kun SimApi alustetaan, se luettelee kaikki tags tietolähteessä.
6. Testaa SimApi hankkimalla tietoja. SIMCA-online-tilassa voit käyttää File > Pura kohdassa 6.1 kuvatulla tavalla.
7. Jos SimApi ei toimi odotetulla tavalla, katso SimApi-loki files vianetsintää varten ja SimApi-käyttöoppaaseen.

SimApin asettaminen käytettäväksi SIMCA:ssa

Näin käytät SimApia SIMCA:ssa:

1.  Aloita tietokannan tuonti jollakin seuraavista tavoista:
   • a. Uuden projektin luominen SIMCA:ssa: File > Uusi tavallinen projekti tai uusi eräprojekti. Valitse Aloitus-välilehdestä Tietokannasta.
   • b. Tietojoukon tuominen olemassa olevaan SIMCA-projektiin: Tietojoukosta avoimen SIMCA-projektin Tiedot-välilehdellä.
2. Napsauta Lisää uusi tietolähde
3. Valitse yhteystyypiksi SimApi, napsauta …-painiketta ja etsi .dll asennuskansiossa ja napsauta Avaa.
4. Napsauta Configure ja katso yksittäisen SimApi-käyttöoppaan ohjeet asetusten tekemiseen.
5. Napsauta Testaa tietolähteen yhteyttä varmistaaksesi, että voit muodostaa yhteyden tietokantaan. Tämä voi kestää kauan, jos niitä on useita tags tietolähteessä.
6. Viimeistele määritys napsauttamalla OK.
7. Katso SIMCA-ohjeesta kuinka käsitellä tuotuja tietoja.

SimApin asettaminen käytettäväksi SIMCA-onlinessa

• Tärkeää: SimApin käyttäminen edellyttää SIMCA-online-palvelinlisenssiä. SIMCA-onlinen demoasennus ei salli SimApisin käyttöä.
• Voit lisätä SimApin järjestelmään suorittamalla SIMCA-online Server Options -palvelimen palvelintietokoneessa. Opi yksityiskohtaiset vaiheet SICMA-online-ohjeaiheesta Lisää ja määritä SimApi palvelimelle.
• Vinkki: Jos teet muutoksia SimApiin, voit käynnistää sen uudelleen erikseen Palvelinasetuksista käynnistämättä koko palvelinta uudelleen.
• Jos haluat määrittää useita tämän SimApin esiintymiä, toista yllä olevat vaiheet ja käytä kullekin esiintymälle yksilöllisiä nimiä. Lue lisää eri lokeista ja määrityksistä files tapauksille 4.2.

SimApin testaus ja vianetsintä

• Tämä luku käsittelee SimApi-asennuksen testaamista ja vianetsintää.

SimApin testaus SIMCA-onlinesta

• Kun SIMCA-online-palvelin on käynnistetty onnistuneesti, voit testata SimApi SIMCA-onlinessa (jos palvelin ei käynnisty, katso 6.2):
• Kirjaudu sisään palvelimelle SIMCA-online-asiakassovelluksessa ja siirry kohtaan Pura File -välilehti. Extract auttaa sinua testaamaan SimApia hankkimalla tietoja sen kautta:
• SimApin solmut ("kansiot") näkyvät vasemmassa ruudussa. Tags valitun solmun kohdalla näkyvät oikeassa yläkulmassa.
• Nykyiset tiedot voidaan testata nopeasti yksinkertaisesti napsauttamalla view> päällä tags jotka tarjoavat jatkuvaa prosessidataa (katso kuvakaappaus)
• Napsauta solmua hiiren kakkospainikkeella löytääksesi erät tietyn ajanjakson sisällä. Solmun on oltava eräsolmu, joka tuntee erät.
• Valitse tags Pura-kohdassa ja napsauta Seuraava ja viimeistele ohjattu toiminto saadaksesi tiedot käyttämällä erilaisia ​​tiedonhakutapoja: nykyiset, historialliset, erätiedot ja erilliset tiedot.
• Vertaa poimittuja tietoja siihen, mitä näet tietolähteessäsi sen työkalujen avulla. Lue lisää SimApin kaikkien ominaisuuksien testaamisesta ja validoinnista versiossa 7.13.

Tee SimApi-ongelmien vianmääritys SimApi-lokin avulla file

• Jos palvelin ei käynnisty, SimApi ei toimi odotetulla tavalla tai purku epäonnistuu, sinun on katsottava SimApi-lokia file joka kertoo, mikä ongelma on. Ota käyttöön virheenkorjaustason kirjaus SimApi-lokissa saadaksesi täydelliset tiedot. Katso 4.2.
• Huomautus: SIMCA-online-palvelimen lokit eivät ole niin hyödyllisiä tässä. Ne näyttävät kuinka palvelin latasi ja alusti SimApin, mutta SimApi-kohtaiset tiedot ovat sen lokissa file.

Käytä oikeaa SIMCA-online-palvelutiliä

• Kun testaat pääsyä tietolähteeseen, muista, että olet kirjautunut sisään tietynä käyttäjänä palvelintietokoneelle (yleensä oma käyttäjätili Windows-toimialueessa), mutta SIMCA-online-palvelinpalvelutili on eri tili, oletuksena LocalSystem, jolla on erilaiset käyttöoikeudet kuin käyttäjätililläsi.
• Tästä syystä ei ole harvinaista, että testit toimivat tililläsi, mutta SIMCA-online ei pysty muodostamaan yhteyttä tietolähteeseen.
• Tämän ongelman ratkaisemiseksi SIMCA-online-palvelinpalvelun käyttämälle tilille on myönnettävä käyttöoikeus. Yleensä vaihdat LocalSystemin tietyksi toimialueen palvelutiliksi ja myönnät tälle tilille oikeudet. Huomaa, että tämä ei päde, jos SimApi käyttää tunnistetietoja, jotka on asetettu SimApi-kokoonpanossa, koska nämä tunnistetiedot ovat ensisijaisia.

SimApisin tekniset tiedot

• Tämä luku sisältää teknisiä yksityiskohtia SimApin toiminnasta. Se on suunnattu pääasiassa kehittäjille, jotka haluavat ymmärtää SimApisin toteuttamaan SimApin tietolähteeseen.
• Kehittäjien tulee myös lukea tämän asiakirjan aiemmat osat saadakseen johdannon SimApisiin ja ominaisuuksien korkean tason kuvauksiin.

Milloin SimApin kehittämistä kannattaa harkita ja milloin ei?

Ennen kuin harkitset SimApin kehittämistä tietolähteelle:

1. Tutki, onko sinulla jo SimApi, jota voit käyttää. Ehkä voit ottaa käyttöön jonkin tietolähteesi ominaisuuden käyttääksesi jotakin olemassa olevista SimApeista, kuten OPC UA.
2. Käy tämä asiakirja ja sen viitteet huolellisesti läpi ja tutki, täyttääkö tietolähteesi vaatimukset: esimampSen on oltava riittävän nopea, ja sen on annettava nykyisten tietojen lisäksi myös historiallisia tietoja.

• Näistä syistä emme suosittele SimApin kehittämistä, joka muodostaa yhteyden matalan tason laitteistoihin tai instrumentteihin. On parempi liittää nämä instrumentit prosessihistorioitsijaan, kuten Aveva PI Systemiin, ja antaa sen saada tietoja instrumentista ja historioida se. Sitten PIAF SimApia voidaan käyttää tietojen hankkimiseen PI:stä Umetrics-tuotteeseen.

SimApi-kehitys ja SimApi-spesifikaatio

• SimApi-spesifikaatio, SimApi-v2, sisältää dokumentaation kaikista SimApin C-toiminnoista, jotka SimApi DLL:n on toteutettava, sekä ohjeita SimApin kehittämiseen.
• SimApin käyttöönotto C:llä tai C++:lla on useimmissa tapauksissa tarpeettoman alhaista.
• Suositeltu ja helpompi tapa ottaa SimApi käyttöön on perustaa se Examptarjoamamme leSimApi-lähdekoodi. Se on example SimApi-toteutus, joka käsittelee C-rajapinnan ja kääntää sen.NET Frameworkiksi, jossa varsinainen toteutus tehdään. Siinä on myös kehyskoodi kirjaamista, asetuksia, konfigurointikäyttöliittymää ja muuta kehyskoodia varten.
• SimApin kehittämiseksi kehittäjätiimi tarvitsee kokemusta Windows-kehityksestä, .NET Frameworkista, C:stä tai C++:sta. Edellytetään myös hyvää tietolähteen tuntemista, johon SimApin tulee muodostaa yhteys, koska SimApin tarkoitus on kääntää tietopyynnöt SIMCA-onlinesta tai SIMCA:sta tietolähteen API:lle. SimApi-toteutus ei ole koskaan kertaluonteinen projekti, vaan vaatii yleensä jatkuvaa tukea ja satunnaista ylläpitoa.

Tietojen lukeminen tai kirjoittaminen

• SimApin päätehtävänä on tarjota dataa tietolähteestä. Tätä kutsutaan lukutiedoksi.
• Useimmat SimApi-toteutukset tukevat myös tietojen kirjoittamista. Tämä tarkoittaa tietojen kirjoittamista takaisin SimApin kautta tietolähteeseen. Tietojen kirjoittaminen on valinnainen ominaisuus SIMCA-onlinessa.

Tags ja Solmut

• A tag on tietolähteen sarakkeen tai "muuttujan" tunniste. A tagnimeä käytetään tunnistamaan tag. Solmun sisällä olevien nimien on oltava yksilöllisiä. SIMCA-online 18 on ensimmäinen versio, joka tukee solmua, joka sisältää alisolmun ja tag samalla nimellä. esimample: solmulla Parent voi olla alisolmu nimeltä Erä ja a tag nimeltään Erä.
• Solmu on kontti tags. Solmu voi sisältää myös muita solmuja, samoin kuin a file järjestelmässä on kansioita kansioissa.
• Kuten a file järjestelmä, solmu ja tag nimet voidaan yhdistää täydelliseksi poluksi, joka yksilöi a tag. The tag polkuja käytetään SIMCA-onlinessa tai SIMCA:ssa valittaessa tags käyttää. A tag polku alkaa SimApi-ilmentymän nimellä, jota seuraa solmurakenne, ja päättyy sanaan tag nimi, jokainen kohde erotettuna kaksoispisteellä (:). esimample “:ODBCSQLServer:Node:SensorTag1".

SimApi luettelee tags ja solmut käynnistyksen yhteydessä

• SimApi-toteutus selaa palvelimelta solmuja ja tags tietolähteessä, kun SimApi alustetaan ja pitää niistä kirjaa niin, että eri SimApi-toiminnot, joita käytetään luetteloimiseen tags ja solmu voidaan toteuttaa.
• SimApin alustus ei tapahdu vain palvelimen käynnistyksen yhteydessä, vaan käyttäjä voi myös käynnistää sen uudelleen SIMCA-onlinessa Refresh SimApi -toiminnolla.

Kirjainkoon herkkyys tag- ja solmujen nimet

• Tag nimet ja solmujen nimet ovat isoja ja pieniä kirjaimia eroteltuja.
• Siten a tag nimeltään "tag1" ei ole sama kuin "Tag1", koska "T" on erilainen. Suosittelemme olemaan käyttämättä tags tai solmujen nimet, jotka eroavat vain kirjaimessa.

Jatkuva prosessisolmu 

• Kun solmu sisältää tags jatkuvalla prosessidatalla sitä voidaan kutsua prosessisolmuksi. Seuraavat kaksi kuvakaappausta esittävät taulukkomuodossa prosessisolmun datan ja sen jälkeen kuvan, joka näyttää miltä solmu näyttää valittaessa tags SIMCA-onlinessa.

Jatkuvan prosessin solmujen on oltava riippumattomia eristä, ajoista tai ajasta

• Toimiakseen hyvin SimApissa solmun on oltava riippumaton eristä, suorituksista tai ajasta. Tietyn erän tai aika-alueen dataa sisältävä solmu ei toimisi hyvin SIMCA-onlinessa, koska projektin konfiguraatio voisi silloin lukea vain kyseisen erän tietoja, eikä sitä käytetä muihin eriin.
• Sen sijaan solmu tulee yhdistää yhteen tai useampaan fyysiseen yksikköön prosessissa, jossa mittaukset suoritetaan.

Erän tunnus tag vaaditaan jatkuvan prosessin solmuissa eräprojektin suorittamiseen

• Jokaisella jatkuvalla prosessilla on oltava a tag (muuttuja), jolla on kunkin havainnon erätunniste. SIMCA tai SIMCA-online käyttää tätä erätunnistetta tietääkseen, mihin erään kukin havainto kuuluu.
• $BatchID tag 7.4.3:n kuvakaappauksissa on sellainen example.
  Vaikka ei vaadita, on suositeltavaa, että sinulla on a tag prosessisolmussa, joka näyttää prosessin nykyisen vaiheen tai vaiheen. Tämä tag voidaan sitten käyttää vaiheen suoritusolosuhteissa SIMCA-onlinessa tai SIMCA:ssa dataa tuottaessa. Arvoja tälle tag voi olla esimample "vaihe1", "puhdistus", "vaihe2".

Eräkontekstisolmu

• Eräsolmu on solmu, joka seuraa eriä; niiden erätunnisteet, alkamisajat ja lopetusajat. Se on vaatimus eräprojektin suorittamiselle SIMCA-onlinessa. Tietolähteellä voi olla useampi kuin yksi eräsolmu, joka paljastaa erät eri tavoin. Käyttäjä valitsee eräsolmun, joka koskee hänen sovellusta. Tämä example paljastaa erät, jotka kattavat kaksi eri yksikköä:
• /Tehdas1 – erät, joiden käyttöikä on koottu sekä Unit1:n että Unit2:n ajalle.
• /Tehdas1/Yksikkö1 – erät, joiden käyttöikä on vain yksikössä 1
• /Tehdas1/Yksikkö2 – erät, joiden käyttöikä on vain yksikössä 2
• Jos tietolähteessäsi ei ole eräsolmua, voit käyttää SIMCA-onlinen Batch Context Generatoria. Katso sisäänrakennettu ohje.
• Valinnaiset erätiedot
• Eräsolmu voi sisältää myös erädataa; tiedot, joista on vain yksi havainto koko erästä. Huomaa se tags Erädatan kanssa ei tarvitse olla solmussa, jolla on kaikki eräsolmun toiminnot. Riittää, että SimApi tukee erätietojen lukemista tags. Lue lisää erätiedoista kohdassa 7.6.
• Tässä on examperäsolmun le:
• Huomautus: Yllä oleva kuvakaappaus on otettu DBMakerista, joka on mukana SIMCA-onlinessa. Jos haluat nähdä tämän itse DBMakerissa, napsauta View Bakers Yeast -tietokannan Data-painike näyttää kaksi ikkunaa, joista toinen on eräsolmu ja toinen prosessitiedot.

Tietotyypit: numeeriset tiedot, tekstitiedot ja puuttuvat tiedot

• Jokaiselle tag, SimApi tukee kolmenlaisia ​​tietoja: numeerista, tex-, t- ja puuttuvaa dataa:
• Numeeriset tiedot ovat tyypillisesti prosessiparametrien todellisia arvoja, esimample 6.5123. SimApi pystyy käsittelemään vain 32-bittisiä yhden tarkkuuden liukulukuarvoja. Yhden tarkkuuden liukulukumuoto -Wikipedia. Kaikki muut tietolähteen numeeriset tietotyypit tulee muuntaa kelluviksi. Sellaisenaan ne voivat käsitellä sekä suuria että pieniä arvoja, mutta vain noin 6 tai 7 merkitsevää numeroa. Lue lisää teknisestä oppaasta.
• Tämä voi johtaa tarkkuuden menettämiseen suurten kokonaislukujen tai reaalilukujen kohdalla, jotka ovat sekä suuria että joissa on desimaalit. Katso lisätietoja teknisestä oppaasta.
• Teksti-/merkkijonotietoja käytetään erätunnuksille, vaiheen suoritusolosuhteille tai laadullisille muuttujille. Tekstin arvot tag tiedot ovat isojen ja pienten kirjainten välisiä. Tämä tarkoittaa, että arvo "juoksu" ei ole sama kuin
  "JUOKSEN". SimApi ei tue suoraan päivämäärä-aikamuuttujia, mutta ne voidaan palauttaa merkkijonona muodossa VV-KK-PP HH:MM (esim.ample “2020-09-07 13:45”).
• Puuttuvat arvot tarkoittavat, että palautettavaa arvoa ei ole, eli tietoja ei ole.
• Palautettava tyyppi riippuu SimApi-toteutuksesta. SimApi tietää tietolähteen tiedoista ja sen pitäisi palauttaa parhaiten sopiva tietotyyppi.

Kolme tiedonhakutapaa: Jatkuva, Batc,h ja Diskreetti

• SimApi-spesifikaatio määrittelee kolme tiedonhakutapaa, eli. kolmella eri tavalla SimApi voi toimittaa tietoja tags tietolähteessä (tai toiseen suuntaan: kirjoita tiedot tags tietolähteessä).
• Jatkuva tiedonhaku – tämä tarkoittaa jatkuvasti ja peräkkäin luettua tietoa havaintokohtaisesti erän tai prosessin kehittyessä. Tiedot luetaan nykyiselle ajalle tai tietylle alueelle säännöllisin väliajoin havaintojen välillä. esimample, kaikki tiedot välillä 09:00:00 - 10:00:00 sampjohti 60 sekunnin välein, mikä johti 61 havaintoon, kun päätepisteet ovat mukana.
• Erätietojen haku – tämä viittaa yhteen havaintoon, jossa on tietoja koko erästä (ei liity tiettyyn erääntymiseen tai aikapisteeseen). Eräattribuutit ja paikalliset keskitystiedot luetaan erätietoina SIMCA-onlinessa. Eräehdot luetaan yleensä myös erätietoina (ellei niitä ole määritetty erillistä tiedonhakua varten).
• Diskreetti tiedonhaku – diskreetti data voi koostua useista havainnoista useille maturille. Mutta toisin kuin jatkuva data, diskreettiä dataa ei lueta peräkkäin, vaan kaikki tiedot kerralla erän tietylle vaiheelle. Dataa ei tarvitse jakaa maturiteettimuuttujan säännöllisin välein. Kaikki tiedot luetaan uudelleen joka kerta, kun tietoja pyydetään, määritetyllä aikavälillä.
• Kaikille annetuille tag tietoja voidaan pyytää missä tahansa kolmesta tilasta, mutta tyypillisesti SimApi tukee vain yhtä näistä tiloista yksilölle tag. Samoin se on sallittua sekoittaa tags solmun sisällä, mutta tyypillisesti kaikki tags tietyssä solmussa tukevat samaa tiedonhakutapaa.
• Jatkuville tiedoille (mutta ei erä- tai erillistiedoille2) voidaan pyytää ajankohtaisia ​​tietoja tai historiallisia tietoja, jotka ovat seuraavan osan aiheena.
• Kaikki SimApit eivät tue kaikkia tiloja. Katso yllä oleva ominaisuusmatriisi ja SimApi web sivulta lisätietoja.

Nykyiset ja historialliset jatkuvat tiedot SimApin kautta

• Jatkuva data tarkoittaa prosessitietoa, joka muuttuu ajan myötä.

Nykyiset tiedot

• Nykyisten tietojen lukeminen tarkoittaa, että tietolähteeltä kysytään viimeisimmät arvot tags kysymisen yhteydessä. Huomaa, että tässä ei käytetä ulkoisen tietolähteen aikaa.
• Nykyisinä tietoina luetut tiedot SIMCA-online näyttää reaaliaikaisina tietoina. Tästä syystä on tärkeää, että tietolähteessä ei ole tarpeettomia viiveitä. Nykyisten tietojen tulee olla mahdollisimman tuoreita toimiakseen hyvin SIMCA-onlinessa.
• Tietolähde voi käyttää tietojaan tiedoista ja arvojen voimassaoloajasta ja päättää palauttaa puuttuvat tiedot, kun tietyn ajankohdan raakadata on liian vanha. esimample: tietoja pyydetään klo 15:00:00, mutta viimeisin tietopiste tietolähteessä on klo 03:00:00. Tässä tapauksessa tiedot ovat 12 tuntia vanhoja, joten SimApi saattaa päättää palauttaa puuttuvan arvon (ei tietoja).

Historialliset tiedot

• Historiallisten tietojen lukeminen tarkoittaa, että tietolähteeltä kysytään yhden tai useamman arvot tags tietylle ajanjaksolle tietyllä aikavälillä havaintojen välillä. Huomaa, että tässä datalähteen paikallista aikaa käytetään tietojen etsimiseen. Siksi aikasynkronointi tietolähteen ja palvelimien välillä on tärkeää.
• Historiallinen data koostuu datamatriisista. SimApi-toteutuksen tehtävänä on pyytää tietoja tietolähteestä, ja sampanna se määritetyllä aikavälillä ja muodosta palautettavan datan matriisi:
• Joskus tietolähteessä itsessään on aggregointitoimintoja käsiteltyjen tietojen palauttamiseksi tai sampling-funktiot, joiden avulla voidaan palauttaa oikeat tiedot.
• Muiden tietolähteiden osalta SimApin on pyydettävä kaikki tiedot ajanjaksolta ja sitten sample oikeat havainnot matriisin rakentamiseen.
• Tiedot on palautettava aikajaksolta, vaikka aikavälillä ei ehkä olisikaan raakadataa, mutta vain juuri ennen aloitusaikaa. esimample: dataa on tietolähteessä aikapisteissä 10 ja 20. SimApi pyytää tietoja ajalle 15 ja 17. Tässä tapauksessa SimApin tulee palauttaa aikapisteen 10 arvot, mutta timestamped ajalla 15 ja 17, koska nämä olivat tuoreimmat datapisteet tuohon aikaan. Arvot kohteelle tags hetkellä 10 kutsutaan raja-arvoiksi pyydetylle alueelle. Raja-arvojen syvemmälle selvittämiseksi, katso esimampUA:n osa 11: Historiallinen käyttöoikeus – 6.4.3 ReadRawModifiedDetails rakenne
  (opcfoundation.org)
• Interpolaatiota ei tule koskaan käyttää tulevien ajankohtien arvojen laskemiseen, koska tiedot eivät vastaa reaaliajassa luettuja tietoja. Exilleample edellisestä luettelosta: jos 15 ja 17 tiedot interpoloidaan käyttämällä kohtien 10 ja 20 arvoja, ne käyttäisivät tehokkaasti arvoja tulevaisuudesta, mikä ei ole sallittua.
• Tietolähde voi käyttää tietojaan tiedoista ja arvojen voimassaoloajasta ja päättää palauttaa puuttuvat tiedot, kun tietyn ajankohdan raakadata on liian vanha. esimample: tietoja pyydetään klo 15:00:00, mutta viimeisin tietopiste tietolähteessä on klo 03:00:00. Tässä tapauksessa tiedot ovat 12 tuntia vanhoja, joten SimApi saattaa päättää palauttaa puuttuvan arvon (ei tietoja).

Huomautus: SIMCA-online ei tyypillisesti pyydä enempää kuin sata havaintoa yhdessä kutsussa normaalin projektin toteutuksen aikana. Kun teet otteen SIMCA-onlinessa tai ajettaessa työpöydän SIMCA:ta, voidaan tehdä suurempia tietopyyntöjä. Nämä voivat kestää kauan, mikä on odotettavissa.

Nykyisten ja historiallisten tietojen on vastattava toisiaan

• Joskus voi esiintyä eroja, kun dataa luetaan reaaliaikaisena nykyisenä datana tai historiallisena datana. Tämä aiheuttaa ongelmia SIMCA-onlinessa, koska palvelin vaihtaa automaattisesti nykyisten ja historiallisten tietojen välillä tarpeen mukaan.

Matala latenssi tiedonkeruu

• Kun SIMCA-online käyttää tietolähdettä reaaliajassa, on tärkeää, että tietolähteen tiedot ovat ajan tasalla. Tietolähteen tiedonhankinnassa ei saa olla tarpeettomia viiveitä. Jatkuvat prosessitiedot kaikille muuttujille on oltava saatavilla samaan aikaan jokaista havaintoa varten. Joidenkin muuttujien osalta myöhässä saapuvia tietoja SIMCA-online ei poimi.

Tiedot voidaan lukea milloin tahansa 

• Kun SIMCA-online pyytää arvoa a tag ajan t osalta se saa arvon tietolähteestä ajankohdasta t tai viimeisimmän havainnon tietolähteestä ennen aikaa t, tai interpoloidun arvon ajalle t. Siten palvelin saa aina arvon joka kerta, kun se pyytää, vaikka havaintoa tästä tarkasta ajankohdasta ei ehkä ole tietolähteessä.
• AikaisinampSimApissa olevat numerot ovat aina UTC. SIMCA-online-asiakkaat ja SIMCA esittävät ajan paikallisena aikana.

Langoitus 

• SimApin käyttäjä kutsuu oletusarvoisesti SimApia yhdellä säikeellä. Tämä pätee kaikkiin SIMCA-versioihin ja SIMCA-online versioon 17 asti.
• SIMCA-online 18 tukee ominaisuuslippua, joka ottaa käyttöön monisäikeisen käytön SimApin kautta. Lue lisää ohjeaiheesta Samanaikainen SimApi-käyttö.
• Tämä tarkoittaa, että SimApisin tulee valmistautua monisäikeiseen, jos mahdollista, tekemällä SimApi-toteutussäikeestä turvallinen ja dokumentoida tämä ja kaikki huomiot SimApin käyttäjille.

Loki file

• SimApin tulee kirjata lokinsa toiminnot, virheilmoitukset ja varoitukset file auttamaan vianetsintää. Käytä eri lokitasoja ilmaisemaan kirjauksen tärkeyttä.
• On suositeltavaa kirjata "Ei käytössä" ominaisuuksille, joita ei ole otettu käyttöön SimApissa.

Virheiden käsittely

• Kun SimApi ei pysty täyttämään tietolähteen pyyntöä, se voi käsitellä tämän ongelman kahdella tavalla; palauttamalla puuttuvia arvoja (ei tietoja) tai ilmoittamalla SimApi-virheestä:
• Puuttuvien arvojen palauttaminen soittajalle ja onnistumisesta ilmoittaminen antaa soittajalle mahdollisuuden jatkaa normaalisti (mutta tietysti ilman dataa). Tämä on suositeltava käytäntö osittaisille virheille, kuten silloin, kun tietoja voidaan saada joistakin, mutta ei kaikista, tags pyynnöstä.
• SimApi-virheestä ilmoittaminen mahdollistaa soittajan (esimampSIMCA-online-palvelimelta) nähdäksesi tämän välittömästi ja toimiaksesi. Tämä on suositeltava käytäntö pyynnöille, jotka epäonnistuvat kokonaan eivätkä voi palauttaa tietoja ollenkaan.
• SIMCA-online käsittelee puuttuvat arvot tai virhekoodit eri tavalla, kuten SIMCA-online Technical Guide -oppaassa on kuvattu.

SimApin suorituskykyvaatimukset

• SimApin toimintoja käytetään tietojen hankkimiseen.
• Jos tietojen käyttö on hidasta, SimApi ei toimi hyvin, mikä tämä example näyttää: Jos SIMCA-online pyytää tietoja joka sekunti, mutta sen saaminen kestää kaksi sekuntia, SIMCA-online-palvelin ei koskaan pysy perässä reaaliajassa, vaan jää asteittain yhä enemmän jäljessä.
• Alaosissa näytämme kuinka SIMCA ja SIMCA-online käyttävät tiedonsiirtoon liittyviä SimApi-toimintoja ja kuinka usein SimApi-toimintoja kutsutaan. Tämä voi auttaa määrittämään suorituskykyvaatimuksia SimApi-toteutukselle.

SIMCA:n SimApi-toimintojen käyttö

• Kun työpöydän SIMCA tai muut offline-tuotteet käyttävät SimApia tietojen hankkimiseen, nämä pyynnöt koskevat eriä ja prosessitietoja tietyn ajanjakson muuttujajoukolle.
• Koska käyttäjä käynnistää nämä pyynnöt manuaalisesti, niitä ei tapahdu kovin usein eivätkä aiheuta merkittävää kuormitusta tietolähteelle.
• Näitä SimApi-toimintoja käytetään tietojen hankkimiseen:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

SIMCA-onlinen SimApi-toimintojen käyttö

• SIMCA-onlinea käytetään prosessin reaaliaikaiseen seurantaan, ja siksi se pyytää tietoja SimApin kautta säännöllisin väliajoin. Lyhin käytettävissä oleva suoritusväli on 1 sekunti. Joku tosielämän exampsuoritusvälit ovat 10 s, 1 minuutti tai 10 minuuttia.
• Palvelimella voi olla useita projekteja käynnissä samanaikaisesti.
• Vähentääkseen API-kutsujen määrää SimApin kautta palvelin optimoi tietopyynnöt ryhmittelemällä useita samanaikaisia ​​pienempiä pyyntöjä yhdeksi suuremmaksi pyynnöksi kaikille muuttujille samanaikaisesti (lisätietoja ohjeaiheesta "Optimoitu tietolähteiden lukeminen parantaa suorituskykyä").
• Palvelimen suoritusalgoritmi toimii näin, kun se pyytää tietoja käyttämällä alla lueteltuja SimApi-toimintoja:
• Kaikki vaiheet, jotka suoritetaan samalla aikavälillä, on ryhmitelty yhdeksi SimApi-kutsuksi puheluiden määrän vähentämiseksi. Palvelin lukee uusimmat tiedot kaikista muuttujista, joita kaikki mallit käyttävät, jotka jakavat intervallin, eli tämä kutsu johtaa laajaan datariviin, jota kaikki projektit käyttävät.
  • simapi2_connectionReadCurrentData
• Jokaisessa eräprojektissa palvelimen on myös tiedettävä, mitkä erät ovat aktiivisia. Tämän on myös tapahduttava aina, kun projekti suoritetaan:
  • simapi2_nodeGetActiveBatches
  • simapi2_nodeGetBatchTimes kutsutaan harvemmin.
• Lisäksi SIMCA-online vaatii myös historiatietoja. Näitä pyyntöjä tapahtuu vain tarvittaessa, kuten ennen SIMCA-onlinen käynnistystä alkaneen erän alkua tai kun palvelin on jäämässä jälkeen ja sen on luettava tietolohko:
  • simapi2_connectionReadHistoricalDataEx
• Vaihtoehtoisesti jotkin projektikokoonpanot käyttävät ominaisuuksia, jotka käyttävät erädataa tai erillistä dataa, mikä johtaa SimApi-kutsuihin:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• Vaihtoehtoisesti jotkin projektikokoonpanot käyttävät takaisinkirjoitusta työntämään tiedot takaisin tietolähteeseen:
  • simapi2_connectionWriteHistoricalDataEx (ja vastaavat erätiedon funktiot, erilliset tiedot)
• On tärkeää, että jokainen kutsu datan saamiseksi oleviin ydintoimintoihin, readCurrentData, getActiveBatches/getBatchTimes, on nopea, eikä se ole laskennallisesti vaikeaa itse tietolähteelle, kun otetaan huomioon, kuinka usein SIMCA-online voi kutsua näitä toimintoja.

SimApi-tietojen testaus ja validointi

• Tämä osio käsittelee SimApin testaamista sen varmistamiseksi, että siitä palautetut tiedot vastaavat itse tietolähteen tietoja. Tällaisten testien suorittaminen on tärkeää SimApi-toteutuksen luomisen tai muuttamisen jälkeen tai kun tietolähteen API muuttuu.
• Käytännössä tietojen validointi tehdään SIMCA-onlinen ja sen Extract-toiminnon avulla, jolloin data noudetaan tietolähteestä SimApin kautta ja verrataan sitten tietolähteen raakatietoihin. Desktop SIMCA:ta ei voi käyttää SimApin reaaliaikaisten ominaisuuksien testaamiseen.

Valmistelut ja vaatimukset

• Jotkut kohteet ovat valinnaisia, mutta ne voidaan suorittaa, jos testaus sisältää sen:

1. Asenna SIMCA-online tuotteen zip-pakkauksessa olevan ReadMe- ja Installation Guide.pdf -tiedoston ohjeiden mukaisesti.
2. Hanki lisenssi SIMCA-online-palvelimelle ja asenna se. SimApi ei toimi ilman lisenssiä. SIMCA-online-tietokannan artikkelissa kerrotaan, kuinka tuotteen käyttöoikeus myönnetään. esimample: SIMCA-online 18 (sartorius.com)
3. Asenna ja määritä SimApi, jota haluat testata. Katso tämän asiakirjan luvut 4–5 ja tietyn SimApin käyttöopas.
   • a. Valinnainen: varmista, että käyttöopas on ajan tasalla ja oikea.
4. Varmista, että sinulla on tietolähdettä varten työkalu, jonka avulla voit vertailla SimApi-tietoja.
5. Kirjaudu SIMCA-online-työpöytäohjelmassa SIMCA-online-palvelimellesi ja käytä File > Pura saadaksesi tietoja SimApin kautta.
6. Valinnainen, jos testausalue sisältää sen: poista SimApi testauksen jälkeen ja tarkista se files poistetaan.

Mitä testata

• Luvun 3 ominaisuusmatriisi listaa kaikki mahdolliset ominaisuudet, mutta tietty SimApi-toteutus voi tukea vain osajoukkoa. Sinun tulisi testata kaikkia tietyn SimApin toteuttamia ominaisuuksia.
• Seuraavat testit ovat yhteisiä useimmille SimApi-toteutuksille:
• Todennus käyttäjätunnuksilla ja salasanoilla
• Testaa SimApin kokoonpanon eri asetuksia
• Solmuhierarkia: Solmut ja tags SimApin paljastamat ovat oikein.
  • Siellä täytyy olla a tag paljastetaan kaikille "muuttujille", joiden pitäisi olla saatavilla SimApin kautta. Esimamples: prosessimittaukset, lasketut arvot, vakiot.
• Yhteyden joustavuus: jos tietolähde ei ole käytettävissä, tämä aiheuttaa varoituksia tai virheitä lokissa file, mutta yhteys tietolähteeseen muodostetaan uudelleen automaattisesti, kun tietolähde on saatavilla.
• Useita esiintymiä: kaksi esiintymää voidaan määrittää ja käyttää itsenäisesti ja samanaikaisesti erillisillä lokeilla files.
• Nykyiset tiedot: poimi nykyiset tiedot kohteelle tags. Varmista, että tiedot ovat viimeisimpiä tunnettuja arvoja tietolähteestä tai ne puuttuvat huonon laadun tai liian vanhojen tietojen vuoksi.
  • Poimi tiedot 10 sekunnin välein (tai niin) minuutin ajan.
• Historialliset jatkuvat tiedot: poimi historialliset tiedot kohteelle tags.
  • Käytä aikaväliä, joka vastaa nykyisten tietojen purkamista. Varmista, että nykyiset tiedot vastaavat historiallisia tietoja ja tietolähteen raakatietoja.
  • Kokeile eri aikajaksoja ja sampling-intervalleissa, varmista, että tiedot vastaavat tietolähdettä.
  • Yritä poimia tietoja 1 sekunnin välein, mikä on lyhin mahdollinen samplingin väli.
  • Kokeile erityyppisiä tags tietolähteessä (prosessimuuttujat jne.) varmistaen, että tiedot täsmäävät.
  • Huomautus: SIMCA-online voi jakaa yhden suuren historiatietopyynnön useisiin pienempiin osiin. Tämä näkyy SimApi-lokissa.
• Varmista, että SimApi toimii tekstidatan, numeeristen tietojen ja puuttuvien tietojen kanssa.
• SimApi-loki file. Varmista, että loki sisältää järkeviä merkintöjä.
• Eräsolmu: napsauta solmua hiiren kakkospainikkeella ja valitse Etsi erät.
  • Tarkista erien nimet, aloitusajat ja lopetusajat.
  • Kokeile aktiivista erää, joka on käynnissä tietolähteessä. Sillä ei pitäisi olla loppumisaikaa SimApin kautta.
• Prosessisolmun erätunniste tag. Jos SimApissa on eräsolmutoiminto (katso edellinen luettelomerkki), sillä on oltava myös erätunniste tag täsmäytysprosessidatasolmussa. Dataa tätä varten tag tulee olla erän tunniste (erän nimi). Näitä tietoja tarvitaan eräprojektien tunnistamiseen, mihin erään tietorivi kuuluu.

Riippuen siitä, tukeeko SimApi sitä, saatat haluta myös testata:

• Erätietoja käyttämällä File > Pura.
• Diskreettiä dataa käyttämällä File > Pura. Huomautus: erillisten tietojen testaamiseen File > Pura solmu, eräsolmun ja erillisen datasolmun on oltava samassa SimApissa (kun SIMCA-online suorittaa projekteja, ne voivat olla eri SimApeista).
• Kirjoita takaisin – tietoerän työntäminen tietolähteeseen. Tämän testaamiseksi sinun on määritettävä projektin konfiguraatio SIMCA-onlinessa, jotta datavektorit voidaan kirjoittaa takaisin tietolähteeseen. Suorita sitten projekti SIMCA-onlinessa ja tarkista data, joka on kirjoitettu takaisin tietolähteeseen.
• Jatkuvat tiedot konfiguroidaan Evolution Write Back -sivulla projektin kokoonpanossa.
• Diskreetti tiedot konfiguroidaan samalla sivulla, mutta vain erillistä tiedonhakua varten määritettyä vaihetta varten.
• Erätiedot eräkirjoituksesta takaisin

LISÄTIEDOT

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Ruotsi
• Puhelin: + 46 90-18 48 00
• www.sartorius.com
• Näiden ohjeiden sisältämät tiedot ja luvut vastaavat alla ilmoitettua versiopäivää.
• Sartorius pidättää oikeuden tehdä muutoksia laitteen tekniikkaan, ominaisuuksiin, spesifikaatioihin ja suunnitteluun ilman ennakkoilmoitusta. Maskuliinisia tai feminiinisiä muotoja käytetään helpottamaan luettavuutta näissä ohjeissa ja ne osoittavat aina samanaikaisesti kaikkia sukupuolia.
  Tekijänoikeushuomautus:
• Nämä ohjeet, mukaan lukien kaikki komponentit, ovat tekijänoikeuden suojaamia.
• Mikään tekijänoikeuslain rajojen ylittävä käyttö ei ole sallittua ilman lupaamme.
• Tämä koskee erityisesti uudelleenpainamista, kääntämistä ja editointia käytetystä mediatyypistä riippumatta.

FAQ

• K: Mikä on SimApisin tarkoitus?
  • V: SimApisin päätarkoitus on tarjota dataa Umetrics Suite -tuotteille projektin luomista ja mallin rakentamista varten.
• K: Kuinka voin ratkaista SimApi-asennuksen ongelmia?
  • V: Voit tehdä vianmäärityksen testaamalla SIMCA-onlinesta ja tarkistamalla SimApi-lokin fileja varmistamalla oikean palvelutilin kokoonpanon.