Meddalwedd SARTORIUS Sim Api

Manylebau

• Enw'r Cynnyrch: Canllaw SimApi
• Dyddiad cyhoeddi: Medi 5, 2024
• Pwrpas: Darparu data i gynhyrchion Umetrics Suite

Cyfarwyddiadau Defnydd Cynnyrch

Cyflwyniad i SimApis

• Defnyddir SimApis i adalw data ar gyfer creu prosiectau ac adeiladu modelau mewn cynhyrchion Umetrics Suite.

Cael SimApis

• I gael SimApis, cyfeiriwch at y ddogfennaeth swyddogol neu cysylltwch â chymorth cwsmeriaid am gymorth.

Nodweddion SimApi

• Mae SimApis yn darparu data amser real ar gyfer monitro, rheoli ac adeiladu modelau yn SIMCA a SIMCA-ar-lein.

Dim ond Defnydd Data Cyfredol

• Argymhellir defnyddio data cyfredol yn unig ac osgoi data hanesyddol ar gyfer y perfformiad gorau posibl.

Paratoi ar gyfer Gosodiad SimApi

• Cyn gosod, sicrhewch fod eich system yn bodloni'r gofynion sylfaenol a nodir yn y canllaw defnyddiwr.

Gosod SimApi

• Dilynwch y cyfarwyddiadau cam wrth gam a ddarperir yn y llawlyfr defnyddiwr i osod y SimApi ar eich system.

Sefydlu SimApi ar gyfer SIMCA

• Ffurfweddwch y gosodiadau SimApi yn SIMCA yn unol â'r canllawiau a ddarperir.

Sefydlu SimApi ar gyfer SIMCA-ar-lein

• Sefydlu'r SimApi ar gyfer gweithrediadau adalw ac ysgrifennu data amser real yn SIMCA-ar-lein.

Profi a Datrys Problemau

• Ar ôl gosod, cynnal profion i sicrhau ymarferoldeb priodol. Yn achos problemau, cyfeiriwch at yr adran datrys problemau yn y canllaw defnyddiwr.

Profi gan SIMCA-ar-lein

• Profwch integreiddiad SimApi o SIMCA-ar-lein i wirio adalw data.

Datrys Problemau gyda Log Files

• Defnyddiwch log SimApi file i nodi a datrys unrhyw broblemau gosod neu weithredol.

Ffurfweddu Cyfrif Gwasanaeth

• Sicrhau cyfluniad cywir y cyfrif gwasanaeth ar-lein SIMCA ar gyfer gweithrediad di-dor.

Manylion Technegol

• Cyfeiriwch at adran 7 y canllaw defnyddiwr i gael gwybodaeth dechnegol fanwl am SimApis.

Cyflwyniad i SimApis

• Rhyngwyneb meddalwedd rhwng meddalwedd Umetrics® Suite a ffynhonnell ddata yw SimApi. Prif ddiben SimApi yw darparu data i SIMCA®-online neu SIMCA®.
• Mae Sartorius Stedim Data Analytics AB yn datblygu SimApis ar gyfer llawer o wahanol ffynonellau data, megis haneswyr prosesau a chronfeydd data pwrpas cyffredinol.
• Mae'r ddogfen hon yn dangos beth yw SimApi, a sut mae'n cael ei ddefnyddio mewn cynhyrchion Umetrics Suite. Byddwch yn dysgu sut i gynllunio ar gyfer SimApi a'i osod, sut i ddatrys problemau a sut i brofi'ch gosodiad. Mae'r bennod olaf yn cynnwys manylion technegol SimApis sydd wedi'u hanelu at ddatblygwyr.

Pwrpas SimApi: darparu data i gynhyrchion Umetrics Suite

• Prif ddiben SimApi yw darparu data i SIMCA-ar-lein neu SIMCA o ffynhonnell ddata. Nid yw'r ffynhonnell ddata yn rhan o SIMCA-ar-lein ond gall fod yn hanesydd proses neu system arall sy'n cadw ac yn rheoli'r data.
• Mae SimApi yn datgelu hierarchaeth o nodau, sy'n cyfateb i ffolderi yn a file system. Gall pob nod gynnwys nodau eraill, neu tags. A tag yn cyfateb i newidyn. Ar gyfer y rhain tags, gellir cael data. Mae'r llun yn dangos a tag, Temp, a ddewiswyd yn y nôd
• BakersYeastControlGood mewn ffynhonnell ddata yn SIMCA-ar-lein. Mae hefyd yn dangos y gwerthoedd diweddaraf a gymerwyd o'r ffynhonnell ddata.

Defnydd SimApi yn y Gyfres Umetrics

• Gall y meddalwedd bwrdd gwaith SIMCA ddefnyddio SimApi i adalw data ar gyfer creu prosiectau ac adeiladu modelau fel y dengys y llun canlynol.
• Mae SIMCA-online yn defnyddio SimApis i gael data mewn amser real ar gyfer monitro a rheoli, yn ogystal ag ysgrifennu data yn ôl i'r ffynhonnell ddata. Mae'r llun canlynol yn dangos lle mae'r SimApi mewn system sy'n cynnwys ffynhonnell ddata, gweinydd ar-lein SIMCA, a chleientiaid.

SimApis a ddefnyddir yn gyffredin

• Y SimApis a ddefnyddir amlaf yw:
• Y PI AF SimApi ar gyfer cysylltu ag Aveva (OSIsoft gynt) PI Systems.
• Yr OPC UA SimApi
• Yr ODBC SimApi – ar gyfer mynediad cyffredinol i gronfeydd data fel SQL Server neu Oracle
• Mae'r holl SimApis sydd ar gael wedi'u rhestru ynghyd â'u nodweddion ym mharagraff 3.

Y DBMaker SimApi ar gyfer data efelychu

• Mae DBMaker yn gymhwysiad a ddarperir gyda gosodiad gweinydd ar-lein SIMCA. Mae'n efelychu ffynhonnell ddata, fel hanesydd proses, trwy ddefnyddio tabl data wedi'i lwytho ymlaen llaw lle darperir arsylwadau fesul un i SIMCA-ar-lein trwy'r DBMaker SimApi.
• Dim ond at ddibenion arddangos y defnyddir DBMaker ac ni ellir ei ddefnyddio wrth gynhyrchu data byw o ffynhonnell ddata. Gweler y cymorth adeiledig i ddysgu mwy am DBMaker.

Dogfennaeth ychwanegol

• Mae’r ddogfen hon yn un o gyfres o ddogfennau cysylltiedig, pob un â ffocws a chynulleidfa darged wahanol:

Ffynhonnell	Beth	Lle
SIMCA-ar-lein web tudalen	Gwybodaeth ragarweiniol a lawrlwythiadau....	sartorius.com/umetrics-simca- ar-lein

SIMCA-online ReadMe and Installation.pdf	Gosod a sut i ddechrau gyda data demo ar-lein SIMCA	Yn y zip gosod file
Canllaw Gweithredu ar-lein SIMCA	Yn amlinellu ymarferoldeb ar-lein SIMCA, yn ei roi mewn cyd-destun â meddalwedd Umetrics Suite arall, yn disgrifio gofynion ac arferion gorau ar gyfer defnydd llwyddiannus, a chyfarwyddiadau gosod cam wrth gam.	sartorius.com/umetrics-simca- ar-lein
Canllaw SimApi	Paratoi ar gyfer gosodiadau SimApi a'u perfformio, gan gynnwys datrys problemau. Mae hefyd yn cynnwys manylion technegol ar SimApis i ddatblygwyr.	sartorius.com/umetrics-simapi
Canllawiau Defnyddwyr SimApi	Dogfennaeth ar gyfer pob SimApi cyhoeddedig gyda nodweddion, cyfarwyddiadau gosod, a manylion ffurfweddu.	sartorius.com/umetrics-simapi
Canllaw Technegol ar-lein SIMCA	Cyfeirnod technegol ar gyfer cynllunio gosodiadau gweinydd ar-lein SIMCA, datrys problemau, a manwl sut mae SIMCA-ar-lein yn gweithio.	sartorius.com/umetrics-simca-ar-lein
Cymorth ar-lein SIMCA	Web- cymorth seiliedig ar sut i ddefnyddio SIMCA-ar-lein a sut mae SIMCA-ar-lein yn gweithio.	Yn y meddalwedd ei hun, ac ymlaen sartorius.com/umetrics-simca
SIMCA-ar-lein Web Canllaw Gosod Cleient	Yn disgrifio gosod y SIMCA-ar-lein Web Cleient.	sartorius.com/umetrics-simca-ar-lein
Sylfaen wybodaeth Umetrics	Cronfa ddata chwiliadwy gydag erthyglau am bob fersiwn meddalwedd a ryddhawyd, erthyglau technegol, a materion hysbys mewn cynhyrchion Umetrics Suite.	sartorius.com/umetrics-kb
Cymorth/canllaw defnyddiwr SIMCA	Sut i ddefnyddio SIMCA bwrdd gwaith ar gyfer creu prosiectau a data modelu.	Yn SIMCA ac ymlaen sartorius.com/umetrics-simca
Cefnogaeth web tudalen	Sut i gael cymorth technegol.	sartorius.com/umetrics-support

Cefnogaeth dechnegol

• Mae tîm cymorth ar-lein Sartorius yn ateb cwestiynau technegol am SimApis a gallant hefyd anfon ceisiadau am wella SimApis ymlaen at y bobl briodol. Dysgwch fwy yn sartorius.com/umetrics-support.

Cael SimApis

• Rydym yn darparu dogfennaeth ar gyfer SimApis sydd ar gael a dolenni i raglenni gosod yn sartorius.com/umetrics-simapi.
• Mae pob SimApi wedi'i ddogfennu yn ei Ganllaw Defnyddiwr.
• Mae Canllaw SimApi, yr ydych yn ei ddarllen na, yn ategu'r wybodaeth honno gyda SimApi yn ategu gwybodaeth o ran cynllunio, gosod a datrys problemau SimApi.

Nodweddion SimApi

• Nid yw pob ffynhonnell ddata yn debyg. Nid oes angen i SimApi weithredu'r holl swyddogaethau yn y fanyleb. Am y rhesymau hyn, mae gwahanol SimApis yn cynnig gwahanol swyddogaethau. Mae'r matrics canlynol yn rhestru SimApis sydd ar gael a'u nodweddion.
• Esbonnir y nodweddion isod. Sylwch fod gan y tabl golofnau ar wahân i ddangos pa nodweddion sydd ar gael yn SIMCA-ar-lein a SIMCA yn y drefn honno.

Nodwedd	Pwrpas	Defnydd ar-lein SIMCA	Defnydd SIMCA
Data cyfredol	Darllenwch arsylwad sengl gyda'r gwerth diweddaraf o'r ffynhonnell ddata.	Cyflawni arferol amser real	–
Data hanesyddol	Darllenwch lawer o arsylwadau ar unwaith gyda data hanesyddol o'r ffynhonnell ddata.	Dal i fyny a rhagfynegi data'r gorffennol, creu prosiectau gan ddefnyddio File > Newydd	Dewin Mewnforio Cronfa Ddata i fewnforio data proses ar gyfer creu modelau.
Data arwahanol	Darllen data labordy/IPC o'r ffynhonnell ddata. Llawer o arsylwadau fesul swp.	Ar gyfer prosiectau swp gyda chyfnodau neu amodau swp wedi'u ffurfweddu ar gyfer adalw data arwahanol.	–
Data swp	Darllenwch amodau swp a phriodoleddau ansawdd terfynol (neu	Amodau swp neu ganoli lleol.	Dewin Mewnforio Cronfa Ddata i ddarllen amodau swp ar gyfer

Nodwedd	Pwrpas	Defnydd ar-lein SIMCA	Defnydd SIMCA
	data math MES arall). Un arsylwad fesul swp.		creu model lefel swp.
Nod swp	Nodwch yr amser cychwyn a'r amser gorffen (gwag ar gyfer swp gweithredol) ar gyfer swp penodol. Rhifwch bob swp a fodolai mewn ystod amser.	Yn ofynnol ar gyfer gweithredu ffurfweddiadau swp.	Dewin Mewnforio Cronfa Ddata i ddewis sypiau i'w mewnforio.
Ysgrifennwch yn ôl – data parhaus	Ysgrifennu data parhaus, fel rhagfynegiadau, yn ôl i'r ffynhonnell ddata.	Ysgrifennu data yn ôl o'r lefel esblygiad swp, ar gyfer Cynghorydd Rheoli neu ar gyfer ffurfweddiadau parhaus	–
Ysgrifennwch yn ôl – arwahanol	Ysgrifennwch ddata arwahanol, fel rhagfynegiadau, yn ôl i ffynhonnell y data.	Ysgrifennwch yn ôl am ffurfweddiadau swp ar lefel esblygiad swp ar gyfer cyfnodau wedi'u ffurfweddu ar gyfer adalw data arwahanol	–
Ysgrifennwch yn ôl – data swp	Ysgrifennu data lefel swp yn ôl, megis rhagfynegiadau neu briodoleddau ansawdd terfynol, i'r ffynhonnell ddata.	Ysgrifennwch yn ôl ar gyfer cyfluniad swp ar lefel y swp	–
Hierarchaeth nodau	Mae'r SimApi yn cefnogi hierarchaeth o nodau, yn debyg i a file system. Gall pob nod gynnwys tags a nodau eraill. Mae'r hierarchaeth yn ei gwneud hi'n haws rheoli nifer fawr o nodau a tags.	Wedi'i gefnogi ym mhob man lle tags yn cael eu defnyddio.
Arae tag ehangu	Arae tag yn storio gwerthoedd lluosog. Mae'r SimApi yn ehangu'r arae tag i lawer o unigolion tags, un ar gyfer pob elfen yn yr arae.	Cefnogwyd lle tags yn cael eu defnyddio ar gyfer data parhaus. Ehangodd pob un tag rhaid ei fapio i newidyn yn y prosiect SIMCA.
Ffynonellau data lluosog	Gall y SimApi gysylltu â mwy nag un ffynhonnell ddata neu gefnogi achosion lluosog ohono'i hun gyda gosodiadau a log unigol files ar gyfer pob achos.	Cysylltwch â sawl ffynhonnell ddata wahanol o'r un math.	–
Gwydnwch cysylltiad	Os daw'r SimApi yn ddatgysylltu o'r ffynhonnell ddata, bydd yn ceisio ailsefydlu'r cysylltiad yn awtomatig.	Nid oes rhaid ailgychwyn y SimApi i ailsefydlu cysylltiadau â'r ffynhonnell ddata.	–
Wedi'i ddatblygu'n fewnol	Mae'r SimApi yn cael ei ddatblygu, ei ddarparu a'i gefnogi gan

Dim ond data cyfredol, heb ddata hanesyddol, ni argymhellir

• Mae rhai SimApis, yn enwedig OPC DA, yn cefnogi darllen data cyfredol yn unig, ac nid data hanesyddol.
• Ni ellir defnyddio SimApi sydd ond yn cefnogi data cyfredol yn SIMCA bwrdd gwaith, oherwydd ni fydd yn gallu darllen data hanesyddol i adeiladu'r modelau arnynt.
• Ar gyfer SIMCA-ar-lein, rydym yn argymell yn gryf ffynhonnell ddata a SimApi sy'n darparu nid yn unig data cyfredol ar gyfer gweithredu amser real, ond hefyd data hanesyddol i allu rhagweld a dal i fyny data blaenorol. Mae SIMCA-ar-lein yn newid yn awtomatig rhwng data amser real a data hanesyddol yn ôl yr angen ac ni ellir diffodd hwn.
• Gall ffynhonnell ddata sydd ond yn darparu data cyfredol, ond nid data hanesyddol, weithio ar gyfer prosiectau parhaus yn SIMCA-ar-lein, ond ar gyfer prosiectau swp, mae angen data hanesyddol.

Paratoi ar gyfer gosodiad SimApi

• Mae'r adran hon yn disgrifio gwybodaeth bwysig ar gyfer gosod SimApi yn llwyddiannus.

SimApis 64-did neu 32-did

• Mae fersiynau 32-bit a 64-bit o bob SimApi.
• Mae SIMCA-online a SIMCA yn 64-did ac angen yr amrywiadau SimApis 64-did. Mae'r SimApis 32-did etifeddiaeth yn dal ar gael ar gyfer gosodiadau hŷn.

Lleoliad ar gyfer log file a gosodiadau

• Mae SimApi yn storio ei log files yn y ffolder Data Rhaglen cudd1:
  %programdata%\Umetrics\SimApi, lle mae %programdata% yn mapio i'r ffolder go iawn ar eich cyfrifiadur. Mae'n rhagosodedig i C: \ProgramData.
• Mae pob SimApi fel arfer yn defnyddio ei log ei hun file, sy'n debyg i log gweinydd ar-lein SIMCA file yn cynnwys mwy neu lai o ddata yn dibynnu ar osodiad lefel log. hwn file yn ddefnyddiol ar gyfer datrys problemau. Y log file yn cael ei enwi
  .log lle yw'r SimApi yr ydych yn gosod, ar gyfer example PIAFSimApi. Gweler hefyd yr adran nesaf ar gyfer enwau enghreifftiau SimApi ar-lein SIMCA.
• Mae'r ffolder hwn hefyd yn cynnwys gosodiadau SimApi mewn XML file enwir .xml.
• Mae gan y mwyafrif o SimApis ryngwynebau defnyddwyr graffigol sy'n newid y gosodiadau yn yr xml file, ond i rai rydych chi'n nodi'r newidiadau yn uniongyrchol yn yr XML file gyda golygydd testun, fel Notepad. Gweler y canllaw defnyddiwr ar gyfer pob SimApi.

File enwau pan ddefnyddir enghreifftiau a enwir gyda SIMCA-ar-lein

• Yn SIMCA-ar-lein, mae pob enghraifft SimApi yn cael ei ffurfweddiad ei hun file a log file i weithio gydag achosion lluosog o bob SimApi. Enwau y rhai hyn files yn cael eu hatodi gan enw'r enghraifft fel y'i rhoddir ar y tab SimApi yn y deialog SIMCA-Online Server Options deialog.
• Mae'r cynampMae le yn dangos enwau'r rhain files, lle angen ei ddisodli gyda'r enw SimApi.
• Enw cyfluniad a roddir pan ychwanegir yr enghraifft: OmegaServer
• Cyfluniad file enw: OmegaGweinydd.xml
• Log file enw: OmegaServer.log
• Sylwch fod y generig file .log file yn dal i gael ei greu. Mae'r log hwn file yn cynnwys cofnodion na ellir eu cyfeirio at y log am resymau technegol file o'r achosion..
• Mae'r ffolder hon wedi'i chuddio yn Windows yn ddiofyn. I'w weld yn File Explorer chi ffurfweddu ei ddangos cudd files. Sylwch y gallwch lywio i ffolder cudd trwy deipio cyfeiriad i mewn File Bar cyfeiriad Explorer.
• Sylwch nad yw SIMCA yn cefnogi achosion lluosog o'r SimApi, ac felly mae'n defnyddio'r enwau heb enw enghraifft fel y disgrifir uchod.

Cynllunio rhwydwaith

• Dylech leoli'r gweinydd ar-lein SIMCA yn agos at y ffynhonnell ddata yn y rhwydwaith. Mae hyn yn sicrhau cysylltiad cyflym rhwng SIMCA-ar-lein a'i ffynhonnell ddata.
• Gall offer rhwydweithio ymyrryd â'r cysylltiad rhwng SIMCA-ar-lein a'r ffynhonnell ddata.

Cyfrifon defnyddwyr a chaniatadau ffynhonnell data

• Mae ffynonellau data fel arfer yn rheoli mynediad at eu data. Gwneir hyn fel arfer gydag enwau defnyddwyr a chyfrineiriau ond gellir defnyddio cyfyngiadau sy'n seiliedig ar gyfeiriad IP neu DNS hefyd (ar gyfer cynample Ymddiriedolaethau DP yn System DP Aveva).
• Gellir darparu'r enw defnyddiwr a'r cyfrinair i'r ffynhonnell ddata mewn gwahanol ffyrdd:
• Mae SimApi yn cael ei redeg fel defnyddiwr Windows y defnyddiwr sy'n rhedeg SIMCA bwrdd gwaith neu'r cyfrif gwasanaeth ar-lein SIMCA ar gyfrifiadur y gweinydd. Gall y SimApi gysylltu â'r ffynhonnell ddata gan ddefnyddio'r cyfrif hwn. Dyma sut mae'r OPC I, a'r PI SimApi yn gweithio, ac ODBC os nad ydych chi'n darparu tystlythyrau wrth ei ffurfweddu.
• Ar gyfer ODBC generig gallwch ddefnyddio cymhwysiad Gweinyddwr Ffynonellau Data ODBC a geir ar Start yn Windows.
• Mae rhai darparwyr cronfeydd data yn darparu eu gyrwyr a'u hoffer eu hunain ar gyfer eu cronfeydd data. Cronfeydd data Oracle, ar gyfer cynample, defnyddiwch y Cydrannau Mynediad Data Oracle (ODAC).
• Mae gan rai SimApis, megis PI AF ac ODBC, ddeialogau cyfluniad sy'n storio'r tystlythyrau wedi'u hamgryptio yng nghyfluniad SimApi XML file.
• Mae gan PI hefyd amryw o opsiynau diogelwch ar gael yn yr Offer Rheoli System PI ar y cyfrifiadur gweinydd DP. Darllenwch fwy yn y Canllaw Defnyddiwr PI AF SimApi. Mae'r canllaw hwn yn ddefnyddiol hyd yn oed os ydych chi'n defnyddio'r OSIsoft PI SimApi hŷn.
• Mae OPC DA a HDA yn defnyddio DCOM fel y cludiant rhwng ffynhonnell ddata a SimApi. Mae DCOM wedi'i ffurfweddu gyda'r offeryn Gwasanaethau Cydran (DCOMCNFG.EXE) yn Windows ac mae'n defnyddio dilysiad Windows.
• Ar gyfer y PI OSIsoft hŷn SimApi (nid yr AF SimApi mwy newydd), defnyddir y cymhwysiad OSIsoft AboutPI-SDK (PISDKUtility.exe) i sefydlu'r cysylltiad â'r gweinydd PI.

Gwirio cysylltedd ffynhonnell data
Pan fyddwch chi eisiau gosod SimApi ar gyfrifiadur, gall fod yn ddefnyddiol gwirio'r cysylltedd o'r cyfrifiadur hwnnw i'r ffynhonnell ddata gydag offeryn arall:

• Defnyddir Ffynonellau Data ODBC yn Windows i ffurfweddu a phrofi ODBC generig. Sylwch fod dwy fersiwn o'r offeryn hwn ar Windows 64-bit: un ar gyfer cymwysiadau 32-bit ac un ar gyfer 64-bit. Defnyddiwch y botwm Test Data Source ar ddiwedd dewin cyfluniad ODBC i wirio cysylltedd i'r gronfa ddata. Rydym yn argymell eich bod yn ffurfweddu eich ffynonellau data fel DSNs System.
• Offeryn cysylltu cronfa ddata-benodol gan ddarparwr y gronfa ddata, megis Cydrannau Mynediad Data Oracle.
• Gellir defnyddio PI System Explorer i brofi cysylltedd â gweinydd PI AF. Mae'n rhan o'r Cleient PI AF sy'n rhagofyniad ar gyfer y PI AF SimApi.
• Arbenigwr OPC UA o Awtomatiaeth Unedig - Mae UaExpert yn gleient prawf traws-lwyfan ar gyfer gweinyddwyr OPC UA.
• Gellir defnyddio'r cymhwysiad PI-SDK (PISDKUtility.exe) i brofi cysylltedd ac i view unrhyw negeseuon gwall a allai fod wedi'u cofnodi pan fydd SIMCA-online yn ceisio cysylltu â'r gweinydd DP. Dim ond ar gyfer yr OSIsoft SimApi hŷn y defnyddir hwn, nid PIAF.
• Defnyddir Offer Rheoli System DP ar y cyfrifiadur gweinydd DP ar gyfer datrys problemau o'r ochr honno. Am gynample, i chwilio am faterion diogelwch sy'n atal mynediad o'r gweinydd ar-lein SIMCA. Dysgwch fwy am ddatrys problemau system DP yn y fideo YouTube hwn.
• Gellir defnyddio Excel i gael data o gysylltiad ODBC a'r rhan fwyaf o systemau eraill pan osodir ategyn addas.
• Gellir defnyddio Matrikon OPC Explorer ar gyfer Ior HDA (mae'r rhain yn offer ar wahân) i brofi cysylltedd OPC, a gellir defnyddio Matrikon OPC Analyzer i wneud diagnosis o faterion cysylltedd OPC. Lawrlwythwch yr offer rhad ac am ddim hyn o https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (ar gyfer DInd HDA) o Sefydliadau Hyfforddi'r OPC's web safle “yn galluogi defnyddwyr i wneud diagnosis hawdd o broblemau cyfathrebu a diogelwch, a'u hatgyweirio ar unwaith gyda gwthio botwm. Gellir gwneud hyn i gyd heb orfod dysgu sut i ffurfweddu DCOM"

Gosod SimApi

Dyma sut i osod SimApi ar gyfrifiadur personol:

1. Darllenwch y Canllaw Defnyddiwr ar gyfer y SimApi rydych chi'n ei osod. Mae'n cynnwys manylion ar gyfer y SimApi hwnnw sy'n ategu'r cyfarwyddiadau cyffredinol rydych chi'n eu darllen nawr.
2. Gosod a ffurfweddu unrhyw ragofynion a grybwyllir yng Nghanllaw Defnyddiwr SimApi (ar gyfer exampgyda gyrwyr cronfa ddata neu SDKs)
3. Rhedeg y rhaglen gosod i osod y SimApi. Gosodwch y fersiwn 64-bit (x64) neu'r fersiwn 32-bit (x86) sy'n cyd-fynd â'r feddalwedd y byddwch chi'n ei rhedeg.
4. Ffurfweddwch y SimApi yn SIMCA-online neu SIMCA fel y disgrifir yn yr adrannau canlynol a chyfeiriwch at ganllaw defnyddiwr y SimApi am ddisgrifiadau o'r gosodiadau sydd ar gael.
5. Dechreuwch y gweinydd ar-lein SIMCA. Sylwch y gall hyn gymryd amser, oherwydd pan fydd y SimApi yn cael ei gychwyn, bydd yn rhifo'r cyfan tags yn y ffynhonnell ddata.
6. Profwch y SimApi trwy gael rhywfaint o ddata. Ar gyfer SIMCA-ar-lein, gallwch ddefnyddio File > Darn fel y disgrifir yn 6.1.
7. Os bydd y SimApi yn methu â gweithio yn ôl y disgwyl, cyfeiriwch at log SimApi files ar gyfer datrys problemau, ac i ganllaw defnyddiwr SimApi.

Sefydlu'r SimApi i'w ddefnyddio yn SIMCA

Dyma sut i ddefnyddio'r SimApi yn SIMCA:

1.  Dechreuwch fewnforio'r gronfa ddata yn un o'r ffyrdd canlynol:
   • a. I greu prosiect newydd yn SIMCA: File > Prosiect Rheolaidd Newydd neu Brosiect Swp Newydd. Dewiswch O gronfa ddata ar y tab Cartref.
   • b. I fewnforio set ddata mewn prosiect sy'n bodoli eisoes yn SIMCA: O set ddata ar dab Data prosiect SIMCA agored.
2. Cliciwch Ychwanegu ffynhonnell ddata newydd
3. Dewiswch SimApi fel y math o gysylltiad, cliciwch ar y botwm ...-a lleolwch y .dll yn y ffolder gosod, a chliciwch ar Agor.
4. Cliciwch Ffurfweddu a chyfeiriwch at y Canllaw Defnyddiwr SimApi unigol sut i wneud y gosodiadau.
5. Cliciwch ar y cysylltiad ffynhonnell data Profi i wirio y gallwch gysylltu â'r gronfa ddata. Gall hyn gymryd amser hir os oes llawer tags yn y ffynhonnell ddata.
6. Cliciwch OK i gwblhau'r ffurfweddiad.
7. Cyfeiriwch at help SIMCA am sut i weithio gyda data a fewnforiwyd.

Sefydlu'r SimApi i'w ddefnyddio yn SIMCA-ar-lein

• Pwysig: Er mwyn gallu defnyddio SimApi, mae angen trwydded gweinydd ar-lein SIMCA. Nid yw gosodiad demo o SIMCA-online yn caniatáu defnyddio SimApis.
• I ychwanegu SimApi at y system, rydych chi'n rhedeg Opsiynau Gweinyddwr SIMCA ar-lein ar y cyfrifiadur gweinydd. Dysgwch y camau manylion yn y pwnc cymorth ar-lein SICMA Ychwanegu a ffurfweddu SimApi ar y gweinydd.
• Awgrym: Os gwnewch newidiadau ar gyfer SimApi, gallwch ailgychwyn y SimApi hwnnw ar wahân i Opsiynau Gweinydd heb ailgychwyn y gweinydd cyfan.
• I ffurfweddu achosion lluosog o'r SimApi hwn, ailadroddwch y camau uchod a defnyddiwch enwau unigryw ar gyfer pob achos. Darllenwch fwy am y gwahanol log a ffurfweddiad files ar gyfer yr achosion yn 4.2.

Profi a datrys problemau SimApi

• Mae'r bennod hon yn ymwneud â phrofi a datrys problemau gosodiad SimApi.

Profi SimApi o SIMCA-ar-lein

• Unwaith y bydd y gweinydd SIMCA-ar-lein wedi'i gychwyn yn llwyddiannus gallwch brofi eich SimApi yn SIMCA-ar-lein (os nad yw'r gweinydd yn cychwyn, gweler 6.2):
• Mewngofnodwch i'r gweinydd yn y cleient SIMCA-lein, a llywio i Detholiad ar y File tab. Mae Extract yn eich helpu i brofi'r SimApi trwy gael data trwyddo:
• Mae nodau (“ffolderi”) y SimApi yn cael eu harddangos yn y blwch chwith. Tags ar gyfer y nod a ddewiswyd yn cael eu harddangos top-dde.
• Gellir profi data cyfredol yn gyflym trwy glicio view> ymlaen tags sy'n darparu data proses barhaus (gweler y sgrinlun)
• De-gliciwch ar nod i Dod o hyd i sypiau o fewn ystod amser. Rhaid i'r nod fod yn nod swp sy'n gwybod am sypiau.
• Dewiswch tags yn Detholiad a chliciwch Nesaf a gorffen y dewin i gael data gan ddefnyddio'r gwahanol ddulliau o adalw data: data cyfredol-, hanesyddol-, swp- a data arwahanol.
• Cymharwch y data a echdynnwyd â'r hyn a welwch yn eich ffynhonnell ddata gan ddefnyddio ei offer. Dysgwch fwy am brofi a dilysu holl nodweddion SimApi yn 7.13.

Datrys problemau SimApi gan ddefnyddio log SimApi file

• Os nad yw'r gweinydd yn cychwyn, nid yw'r SimApi yn gweithio yn ôl y disgwyl neu mae'r detholiad yn methu, mae angen i chi ymgynghori â log SimApi file sy'n dweud wrthych beth yw'r broblem. Galluogi logio lefel Debug yn y log SimApi i gael manylion llawn. Gweler 4.2.
• Sylwch: nid yw logiau gweinydd ar-lein SIMCA mor ddefnyddiol yma. Byddant yn dangos sut y cafodd y SimApi ei lwytho a'i gychwyn gan y gweinydd, ond mae manylion penodol SimApi yn ei log file.

Defnyddiwch y cyfrif gwasanaeth ar-lein SIMCA cywir

• Pan fyddwch yn profi mynediad i'r ffynhonnell ddata, cofiwch eich bod wedi mewngofnodi fel defnyddiwr penodol ar y cyfrifiadur gweinydd (fel arfer eich cyfrif defnyddiwr eich hun mewn parth Windows), ond bod cyfrif gwasanaeth gweinydd ar-lein SIMCA yn gyfrif gwahanol, yn ddiofyn LocalSystem, sydd â hawliau mynediad gwahanol o'i gymharu â'ch cyfrif defnyddiwr.
• Am y rheswm hwn, nid yw'n anghyffredin bod profion yn gweithio pan fyddant yn cael eu rhedeg fel eich cyfrif, ond bod SIMCA-online yn methu â chysylltu â'r ffynhonnell ddata.
• I ddatrys y mater hwn, rhaid caniatáu mynediad ar gyfer y cyfrif a ddefnyddir gan wasanaeth gweinydd ar-lein SIMCA. Yn nodweddiadol, rydych chi'n newid LocalSystem i gyfrif gwasanaeth parth penodol, ac yn rhoi hawliau i'r cyfrif hwn. Sylwch nad yw hyn yn berthnasol os yw'r SimApi yn defnyddio tystlythyrau sydd wedi'u gosod yn y ffurfweddiad SimApi oherwydd bod y rhinweddau hyn yn cael blaenoriaeth.

Manylion technegol ar SimApis

• Mae'r bennod hon yn rhoi manylion technegol ar sut mae SimApi yn gweithio. Mae wedi'i anelu'n bennaf at ddatblygwyr sydd am ddeall SimApis i weithredu SimApi ar gyfer ffynhonnell ddata.
• Dylai datblygwyr hefyd ddarllen rhannau cynharach y ddogfen hon i gael cyflwyniad i SimApis ac i'r disgrifiadau lefel uchel o nodweddion.

Pryd i ystyried datblygu SimApi a phryd i beidio?

Cyn ystyried datblygu SimApi ar gyfer ffynhonnell ddata:

1. Ymchwiliwch i weld a oes SimApi eisoes y gallwch ei ddefnyddio. Efallai y gallwch chi alluogi rhywfaint o nodwedd yn eich ffynhonnell ddata i ddefnyddio un o'r SimApis presennol, fel OPC UA.
2. Ewch drwy'r ddogfen hon a'i chyfeirnodau yn ofalus ac archwiliwch a yw'ch ffynhonnell ddata yn bodloni gofynion: ar gyfer example, mae angen iddo fod yn ddigon cyflym, darparu nid yn unig data cyfredol, ond hefyd data hanesyddol.

• Am y rhesymau hyn, nid ydym yn argymell datblygu SimApi sy'n cysylltu â chaledwedd neu offerynnau lefel isel. Mae'n well cysylltu'r offerynnau hynny â hanesydd proses fel Aveva PI System, a gadael iddo gael data o'r offeryn, a'i hanesio. Yna gellir defnyddio'r PIAF SimApi i gael data o PI i'r cynnyrch Umetrics.

Datblygiad SimApi a manyleb SimApi

• Mae manyleb SimApi, SimApi-v2, yn cynnwys dogfennaeth ar gyfer yr holl swyddogaethau C yn y SimApi y mae angen i DLL SimApi eu gweithredu yn ogystal â rhywfaint o ganllawiau ar sut i ddatblygu SimApi.
• Mae gweithredu SimApi gan ddefnyddio C neu C++ yn y rhan fwyaf o achosion ar lefel ddiangen o isel.
• Y ffordd hawsaf a argymhellir o weithredu SimApi yw ei seilio ar yr Exampcod ffynhonnell leSimApi a ddarparwn. Mae'n gynample SimApi gweithredu sy'n trin y C-rhyngwyneb ac yn ei gyfieithu into.NET Fframwaith lle mae'r gweithredu gwirioneddol yn cael ei wneud. Mae ganddo hefyd god fframwaith ar gyfer logio, gosodiadau, cyfluniad GUI, a chod fframwaith arall.
• I ddatblygu SimApi, mae'r tîm o ddatblygwyr angen profiad mewn datblygu Windows, .NET Framework, C, neu C++. Mae angen gwybodaeth dda hefyd o'r ffynhonnell ddata y dylai'r SimApi gysylltu â hi, oherwydd pwrpas SimApi yw trosi ceisiadau data o SIMCA-ar-lein neu SIMCA i API y ffynhonnell ddata. Nid yw gweithrediad SimApi byth yn brosiect unwaith ac am byth, ond fel arfer mae angen cefnogaeth barhaus a gwaith cynnal a chadw achlysurol.

Darllen neu ysgrifennu data

• Mae gan SimApi y brif dasg o ddarparu data o ffynhonnell ddata. Cyfeirir at hyn fel data darllen.
• Mae'r rhan fwyaf o weithrediadau SimApi hefyd yn cefnogi ysgrifennu data. Mae hyn yn golygu ysgrifennu data yn ôl trwy'r SimApi i'r ffynhonnell ddata. Mae ysgrifennu data yn nodwedd ddewisol yn SIMCA-ar-lein.

Tags a Nodau

• A tag yw dynodwr colofn neu “newidyn” mewn ffynhonnell ddata. A tagdefnyddir enw i adnabod y tag. Rhaid i enwau o fewn nod fod yn unigryw. SIMCA-online 18 yw'r fersiwn gyntaf i gefnogi nod sy'n cynnwys is-nodyn a tag gyda'r un enw. Am gynample: y nôd Gallai fod gan riant is-nodyn o'r enw Swp ac a tag o'r enw Swp.
• Cynhwysydd o tags. Gall nod hefyd gynnwys nodau eraill, yn debyg i sut a file mae gan y system ffolderi mewn ffolderi.
• Fel mewn a file system, y nôd a tag gellir cyfuno enwau i lwybr llawn sy'n nodi'n unigryw a tag. Mae'r tag defnyddir llwybrau yn SIMCA-online neu SIMCA wrth ddewis tags i ddefnyddio. A tag mae'r llwybr yn dechrau gydag enw enghraifft SimApi wedi'i ddilyn gan y strwythur nodau, ac yn gorffen gyda'r tag enw, pob eitem wedi'i wahanu â cholon (:). Am gynample “:ODBCSQLServer:Nôd:SynhwyryddTag1”.

Mae'r SimApi yn rhifo tags a nodau wrth gychwyn

• Mae gweithrediad SimApi yn pori'r gweinydd am nodau a tags yn y ffynhonnell ddata pan fydd y SimApi yn cael ei gychwyn ac yn cadw golwg arnynt fel bod y gwahanol swyddogaethau SimApi a ddefnyddir ar gyfer rhifo tags a gellir gweithredu nod.
• Nid yw cychwyniad SimApi yn digwydd wrth gychwyn y gweinydd yn unig ond gall defnyddiwr yn SIMCA-ar-lein ei ail-sbarduno hefyd gyda'r swyddogaeth Adnewyddu SimApi.

Sensitifrwydd achos o tag- ac enwau nodau

• Tag mae enwau ac enwau nodau yn hynod sensitif.
• Felly, a tag o'r enw “tagNid yw 1” yr un peth â “Tag1” oherwydd achos gwahanol y “T”. Rydym yn argymell yn erbyn defnyddio tags neu enwau nodau sy'n gwahaniaethu rhag ofn yn unig.

Nod proses barhaus 

• Pan fydd nod yn cynnwys tags gyda data proses barhaus, gellir cyfeirio ato fel nod proses. Mae'r ddau sgrinlun canlynol yn dangos cynrychiolaeth tabl o nod proses gyda data ac yna llun yn dangos sut mae'r nod yn edrych wrth ddewis tags yn SIMCA-ar-lein.

Rhaid i nodau proses barhaus fod yn annibynnol ar sypiau, rhediadau neu amser

• Er mwyn gweithio'n dda mewn SimApi rhaid i nod fod yn annibynnol ar sypiau, rhediadau, neu amser. Ni fyddai cael nod sy'n cynnwys data ar gyfer swp neu ystod amser benodol yn gweithio'n dda yn SIMCA-ar-lein oherwydd dim ond data ar gyfer y swp hwnnw y gallai cyfluniad y prosiect wedyn ei ddarllen ac ni ddylid ei ddefnyddio ar gyfer sypiau eraill.
• Yn lle hynny, dylid mapio nod i un neu fwy o unedau ffisegol yn y broses lle mae mesuriadau'n cael eu perfformio.

ID swp tag sy'n ofynnol mewn nodau proses barhaus ar gyfer gweithredu prosiectau swp

• Rhaid i bob proses barhaus gael a tag (newidyn) dal y dynodwr swp ar gyfer pob arsylwad. Defnyddir y dynodwr swp hwn gan SIMCA neu SIMCA-online i wybod i ba swp y mae pob arsylwad yn perthyn.
• Mae'r $ BatchID tag yn y sgrinluniau yn 7.4.3 yn gynample.
  Er nad yw'n ofynnol, argymhellir cael a tag yn y nod proses sy'n dangos cam neu gam presennol y broses. hwn tag gellir ei ddefnyddio wedyn mewn amodau gweithredu fesul cam yn SIMCA-ar-lein neu yn SIMCA wrth fewnforio data. Gwerthoedd am hyn tag gall fod ar gyfer cynampgyda “cam 1”, “glanhau”, “cam 2”.

Nod cyd-destun swp

• Nod swp yw nôd sy'n cadw golwg ar sypiau; eu swp dynodwyr, amserau cychwyn, ac amseroedd gorffen. Mae'n ofyniad ar gyfer gweithredu prosiectau swp yn SIMCA-ar-lein. Gall ffynhonnell ddata gael mwy nag un nod swp sy'n datgelu sypiau mewn gwahanol ffyrdd. Mae'r defnyddiwr yn dewis y nod swp sy'n berthnasol i'w gymhwysiad ef neu hi. Mae'r cynampMae le yn datgelu sypiau sy'n rhychwantu dwy uned wahanol:
• /Ffatri 1 – sypiau ag oes agregedig dros Uned 1 ac Uned 2.
• /Ffatri1/Uned1 – sypiau gydag oes yn Uned 1 yn unig
• /Ffatri1/Uned2 – sypiau gydag oes yn Uned 2 yn unig
• Os nad oes gennych nod swp yn eich ffynhonnell ddata, gallwch ddefnyddio'r Swp-Cyd-destun Generator yn SIMCA-ar-lein. Gweler y cymorth adeiledig.
• Data swp dewisol
• Gall nod swp hefyd gynnwys data swp; data nad oes ond un arsylwad ar ei gyfer ar gyfer y swp cyfan. Sylwch ar hynny tags gyda data swp nid oes angen iddo fod mewn nod sydd â swyddogaeth lawn nod swp. Mae'n ddigon bod y SimApi yn cefnogi darllen data swp ar gyfer y tags. Dysgwch fwy am ddata swp yn 7.6.
• Dyma gynample o nod swp:
• Nodyn: Cymerwyd y sgrinlun uchod o DBMaker, wedi'i bwndelu â SIMCA-online. I weld hyn eich hun yn DBMaker, cliciwch ar y View Botwm data ar gronfa ddata Bakers Yeast i arddangos dwy ffenestr, un ohonynt yw'r nod swp, a'r llall yw data'r broses.

Mathau o ddata: data rhifiadol, data testun, a data coll

• Ar gyfer pob un tag, gall SimApi gefnogi tri math o ddata: rhifiadol, testun, t ac ar goll:
• Mae data rhifiadol fel arfer yn werthoedd real o baramedrau proses, ar gyfer example 6.5123. Dim ond gwerthoedd pwynt arnawf trachywiredd sengl 32-did y gall y SimApi eu trin. Fformat pwynt arnofio manylder sengl - Wicipedia. Dylid trosi pob math arall o ddata rhifiadol mewn ffynhonnell ddata i arnofio. Fel y cyfryw, gallant ymdrin â gwerthoedd mawr a bach ond gyda dim ond tua 6 neu 7 digid arwyddocaol. Dysgwch fwy yn y Canllaw Technegol.
• Gall hyn arwain at golli cywirdeb ar gyfer cyfanrifau mawr neu ar gyfer rhifau real sy'n fawr ac sydd â degolion. Am ragor o wybodaeth, gweler y Canllaw Technegol.
• Defnyddir data testun/llinyn ar gyfer IDau swp, amodau gweithredu cyfnod neu ar gyfer newidynnau ansoddol. Y gwerthoedd ar gyfer testun tag data yn sensitif i achosion. Mae hyn yn golygu nad yw'r gwerth “rhedeg” yr un peth â
  “Rhedeg”. Nid yw'r SimApi yn cefnogi newidynnau amser dyddiad yn uniongyrchol, ond gellir eu dychwelyd fel llinyn wedi'i fformatio fel YY-MM-DD HH:MM (ar gyfer cynample “2020-09-07 13:45”).
• Mae gwerthoedd coll yn golygu nad oes unrhyw werth i'w ddychwelyd, hy dim data.
• Mae pa fath sy'n cael ei ddychwelyd hyd at weithrediad SimApi. Mae SimApi yn gwybod am y data yn y ffynhonnell ddata a dylai ddychwelyd y math o ddata sy'n cyd-fynd orau.

Tri dull o adalw data: Parhaus, Batc,h a Discrete

• Mae manyleb SimApi yn diffinio tri dull adalw ar gyfer data, hy,. tair ffordd wahanol y gall SimApi ddarparu data ohonynt tags mewn ffynhonnell data (neu i'r cyfeiriad arall: ysgrifennu data i tags mewn ffynhonnell ddata).
• Adalw data’n barhaus – mae hyn yn cyfeirio at ddata a ddarllenir yn barhaus, ac yn ddilyniannol, arsylwi fesul arsylw wrth i’r swp neu’r broses ddatblygu. Darllenir data ar gyfer yr amser presennol, neu ar gyfer ystod benodol, yn rheolaidd rhwng arsylwadau. Am gynample, yr holl ddata rhwng 09:00:00 a 10:00:00 samparwain bob 60 eiliad, gan arwain at 61 o arsylwadau pan fydd pwyntiau diwedd yn gynhwysol.
• Adalw data swp - mae hyn yn cyfeirio at arsylwad sengl gyda data ar gyfer swp cyfan (nad yw'n gysylltiedig ag aeddfedrwydd neu bwynt amser penodol). Mae priodoleddau swp a data canoli lleol yn cael eu darllen fel data swp yn SIMCA-ar-lein. Mae amodau swp fel arfer yn cael eu darllen fel data swp hefyd (oni bai eu bod wedi'u ffurfweddu ar gyfer adalw data arwahanol).
• Adalw data arwahanol – gall data arwahanol gynnwys nifer o arsylwadau ar gyfer llawer o aeddfedrwydd. Ond yn wahanol i ddata parhaus, nid yw data arwahanol yn cael ei ddarllen yn ddilyniannol ond yn hytrach yr holl ddata ar unwaith ar gyfer cyfnod penodol o swp. Nid oes angen gosod bylchau rheolaidd rhwng y data a'r newidyn aeddfedrwydd. Mae'r holl ddata yn cael ei ail-ddarllen bob tro y gofynnir am y data, ar yr egwyl ffurfweddu.
• Ar gyfer unrhyw a roddir tag gellir gofyn am ddata mewn unrhyw un o'r tri modd, ond yn nodweddiadol bydd SimApi ond yn cefnogi un o'r dulliau hyn ar gyfer unigolyn tag. Yn yr un modd, caniateir iddo gymysgu tags o fewn nod, ond yn nodweddiadol i gyd tags o fewn nod penodol cefnogi'r un modd o adalw data.
• Ar gyfer data parhaus (ond nid ar gyfer data swp neu arwahanol2), gellir gwneud ceisiadau am ddata cyfredol neu ddata hanesyddol sef testun yr adran nesaf.
• Nid yw pob SimApis yn cefnogi pob dull. Gweler y matrics nodwedd uchod a'r SimApi web tudalen am fanylion.

Data parhaus cyfredol a hanesyddol trwy SimApi

• Mae data parhaus yn cyfeirio at ddata proses sy'n newid dros amser.

Data cyfredol

• Mae darllen data cyfredol yn golygu gofyn i'r ffynhonnell ddata am y gwerthoedd diweddaraf o tags ar adeg gofyn. Sylwch nad yw amser y ffynhonnell ddata allanol yn cael ei ddefnyddio yma.
• Y data a ddarllenir fel data cyfredol yw'r hyn y bydd SIMCA-ar-lein yn ei ddangos fel data byw. Am y rheswm hwn, mae'n bwysig nad oes unrhyw oedi diangen yn ffynhonnell y data. Dylai data cyfredol fod mor ddiweddar â phosibl i weithio'n dda yn SIMCA-ar-lein.
• Gall y ffynhonnell ddata ddefnyddio ei gwybodaeth o ddata a pha mor hir y mae gwerthoedd yn ddilys a phenderfynu dychwelyd data coll pan fo'r data crai ar gyfer pwynt amser yn rhy hen. Am gynample: gofynnir am ddata am 15:00:00 ond y pwynt data diweddaraf yn y ffynhonnell ddata yw o 03:00:00. Yn yr achos hwn mae'r data yn 12 awr oed felly efallai y bydd y SimApi yn penderfynu dychwelyd gwerth coll (dim data).

Data hanesyddol

• Mae darllen data hanesyddol yn golygu gofyn i'r ffynhonnell ddata am werthoedd o un neu fwy tags ar gyfer ystod amser benodol gyda chyfnod penodol rhwng arsylwadau. Sylwch mai dyma amser lleol y ffynhonnell ddata a ddefnyddir i ddod o hyd i'r data. Felly, mae cydamseru amser rhwng ffynhonnell ddata a gweinyddwyr yn bwysig.
• Mae data hanesyddol yn cynnwys matrics o ddata. Mater i weithrediad SimApi yw gofyn am y data o'r ffynhonnell ddata, ac aampei osod ar y cyfwng penodedig a llunio'r matrics o ddata i ddychwelyd:
• Weithiau mae gan y ffynhonnell ddata ei hun swyddogaethau agregu i ddychwelyd data wedi'i brosesu, neu sampswyddogaethau ling, y gellir eu defnyddio i ddychwelyd y data cywir.
• Ar gyfer ffynonellau data eraill, rhaid i'r SimApi ofyn am yr holl ddata yn yr ystod amser ac yna sampgyda'r arsylwadau cywir i adeiladu'r matrics.
• Rhaid dychwelyd data ar gyfer ystod amser, er efallai nad oes data crai yn yr ystod amser, ond dim ond ychydig cyn yr amser cychwyn. Am gynample: mae data yn bodoli yn y ffynhonnell ddata ar bwyntiau amser 10 a 20. Mae'r SimApi yn gofyn am ddata ar gyfer amser 15 a 17. Yn yr achos hwn, dylai'r SimApi ddychwelyd y gwerthoedd ar gyfer pwynt amser 10 ond yr amser mwyafamped fel amser 15 a 17 gan mai'r rhain oedd y pwyntiau data diweddaraf ar yr adegau hynny. Y gwerthoedd ar gyfer tags ar amser cyfeirir at 10 fel gwerthoedd terfyn ar gyfer yr ystod y gofynnir amdani. Am esboniad dyfnach o werthoedd terfynau, gweler am exampgyda'r ddogfennaeth ar gyfer Ffiniau Dychwelyd yn AU Rhan 11: Mynediad Hanesyddol – 6.4.3 Strwythur ReadRawModifiedDetails
  (opcfoundation.org)
• Ni ddylid byth defnyddio rhyngosod i gyfrifo gwerthoedd ar gyfer pwyntiau amser yn y dyfodol, oherwydd ni fydd data yn cyfateb i'r hyn a ddarllenir mewn amser real fel data cyfredol. Ar gyfer y cynampo'r bwled blaenorol: pe bai data ar gyfer 15 ac 17 yn cael eu rhyngosod gan ddefnyddio'r gwerthoedd ar gyfer eitem 10 ac 20, byddent yn defnyddio gwerthoedd o'r dyfodol i bob pwrpas, na chaniateir.
• Gall y ffynhonnell ddata ddefnyddio ei gwybodaeth o ddata a pha mor hir y mae gwerthoedd yn ddilys a phenderfynu dychwelyd data coll pan fydd y data crai ar gyfer pwynt amser wedi mynd heibio. Am gynample: gofynnir am ddata ar gyfer 15:00:00 ond y pwynt data diweddaraf yn y ffynhonnell ddata yw o 03:00:00. Yn yr achos hwn, mae'r data yn 12 awr oed felly efallai y bydd y SimApi yn penderfynu dychwelyd gwerth coll (dim data).

Nodyn: Fel arfer nid yw SIMCA-ar-lein yn gofyn am fwy na chant o arsylwadau mewn un alwad yn ystod gweithrediad arferol y prosiect. Wrth wneud echdynnu yn SIMCA-ar-lein, neu wrth redeg SIMCA bwrdd gwaith, gellir gwneud ceisiadau mwy am ddata. Gall y rhain gymryd amser hir, sydd i'w ddisgwyl.

Rhaid i ddata cyfredol a data hanesyddol gyfateb

• Weithiau gall fod gwahaniaethau pan ddarllenir data fel data cyfredol amser real neu ddata hanesyddol. Mae hyn yn achosi problemau yn SIMCA-ar-lein oherwydd bod y gweinydd yn newid yn awtomatig rhwng data cyfredol a hanesyddol yn ôl yr angen.

Caffael data hwyrni isel

• Pan ddefnyddir ffynhonnell ddata gan SIMCA-ar-lein mewn amser real, mae'n bwysig bod y data yn y ffynhonnell ddata yn gyfredol. Ni ddylai fod unrhyw oedi diangen wrth gaffael data yn y ffynhonnell ddata. Rhaid i ddata proses barhaus ar gyfer pob newidyn fod ar gael ar yr un pryd ar gyfer pob arsylwad. Ni fydd data sy'n dod i mewn yn hwyr ar gyfer rhai newidynnau yn cael ei gasglu gan SIMCA-ar-lein.

Gellir darllen data ar unrhyw adeg 

• Pan fydd SIMCA-ar-lein yn gofyn am werth a tag ar gyfer amser t bydd yn derbyn y gwerth o'r ffynhonnell ddata o amser t, neu'r arsylwad diweddaraf yn y ffynhonnell ddata cyn amser t, neu werth rhyngosodedig ar gyfer amser t. Felly, bydd y gweinydd bob amser yn cael gwerth bob tro y mae'n gofyn amdano, er efallai na fydd arsylwad ar gyfer yr union bwynt amser hwn yn bodoli yn y ffynhonnell ddata.
• Amserlenamps yn y SimApi bob amser yn UTC. Mae cleientiaid ar-lein SIMCA a SIMCA yn cyflwyno'r amser fel amser lleol.

Edafu 

• Mae'r SimApi, yn ddiofyn, yn cael ei alw gan edefyn sengl gan ddefnyddiwr y SimApi. Mae hyn yn wir ar gyfer pob fersiwn SIMCA a SIMCA-ar-lein hyd at fersiwn 17.
• Mae SIMCA-online 18 yn cefnogi baner nodwedd i droi mynediad aml-edau ymlaen trwy SimApi. Darllenwch fwy yn y pwnc cymorth Mynediad cydamserol SimApi.
• Mae hyn yn golygu y dylai SimApis baratoi ar gyfer aml-edau, os yn bosibl, trwy wneud yr edefyn gweithredu SimApi yn ddiogel, a dogfennu hyn ac unrhyw ystyriaethau ar gyfer defnyddwyr y SimApi.

Log file

• Dylai SimApi gofnodi gweithredoedd, negeseuon gwall a rhybuddion i'w log file i helpu i ddatrys problemau. Defnyddiwch y lefelau log gwahanol i ddangos pwysigrwydd y logio.
• Argymhellir logio “Heb ei weithredu” ar gyfer nodweddion nad ydynt wedi'u gweithredu mewn SimApi.

Trin gwall

• Pan na all SimApi gyflawni cais o'r ffynhonnell ddata gall drin y broblem hon mewn un o ddwy ffordd; trwy ddychwelyd gwerthoedd coll (dim data) neu drwy nodi gwall SimApi:
• Mae dychwelyd gwerthoedd coll i'r galwr a dangos llwyddiant yn caniatáu i'r galwr barhau fel arfer (ond wrth gwrs heb unrhyw ddata). Mae hwn yn arfer a argymhellir ar gyfer gwallau rhannol megis pryd y gellid cael data ar gyfer rhai, ond nid pob un, tags mewn cais.
• Mae arwyddo gwall SimApi yn caniatáu i'r galwr (ar gyfer cynampgyda gweinydd ar-lein SIMCA) i weld hyn ar unwaith ac i weithredu. Mae hwn yn arfer a argymhellir ar gyfer ceisiadau sy'n methu'n llwyr ac na allant ddychwelyd unrhyw ddata o gwbl.
• Mae SIMCA-ar-lein yn ymdrin â gwerthoedd coll neu godau gwall yn wahanol, fel y disgrifir yng Nghanllaw Technegol ar-lein SIMCA.

Gofynion perfformiad SimApi

• Defnyddir y swyddogaethau yn y SimApi i gael data.
• Os yw mynediad data yn araf, ni fydd y SimApi yn gweithio'n dda y mae hyn yn gynample yn dangos: Os yw SIMCA-lein yn gofyn am ddata bob eiliad, ond ei fod yn cymryd dwy eiliad i'w gael, ni fydd y gweinydd ar-lein SIMCA byth yn gallu cadw i fyny mewn amser real ond yn mynd yn gynyddol ar ei hôl hi.
• Yn yr isadrannau byddwn yn dangos sut mae SIMCA a SIMCA-ar-lein yn defnyddio'r swyddogaethau mynediad data SimApi a pha mor aml y bydd swyddogaethau SimApi yn cael eu galw. Gall hyn helpu i osod gofynion perfformiad ar gyfer gweithrediad SimApi.

Defnydd SIMCA o swyddogaethau SimApi

• Pan fydd SIMCA bwrdd gwaith neu gynhyrchion all-lein eraill yn defnyddio SimApi i gael data, bydd y ceisiadau hyn am sypiau a phrosesu data ar gyfer set o newidynnau o fewn ystod amser benodol.
• Gan fod y ceisiadau hyn yn cael eu cychwyn â llaw gan ddefnyddiwr, nid ydynt yn digwydd yn aml iawn ac nid ydynt yn achosi llwyth sylweddol i ffynhonnell ddata.
• Defnyddir y swyddogaethau SimApi hyn i gael y data:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

Defnydd SIMCA-online o swyddogaethau SimApi

• Defnyddir SIMCA-ar-lein ar gyfer monitro proses mewn amser real, ac felly mae'n gofyn am ddata drwy'r SimApi yn rheolaidd. Y cyfwng gweithredu byrraf y gellir ei ddefnyddio yw 1 eiliad. Mae rhai o'r byd go iawn exampllai y cyfnodau cyflawni yw 10 s, 1 munud, neu 10 munud.
• Gall gweinydd gael llawer o brosiectau yn rhedeg ar yr un pryd.
• Er mwyn lleihau nifer y galwadau API trwy'r SimApi, mae'r gweinydd yn optimeiddio ceisiadau data trwy grwpio llawer o geisiadau llai cydamserol yn un cais mwy ar gyfer pob newidyn ar yr un pryd (dysgwch fwy yn y pwnc cymorth 'Mae darllen wedi'i optimeiddio o ffynonellau data yn gwella perfformiad').
• Mae algorithm gweithredu'r gweinydd yn gweithio fel hyn pan fydd yn gofyn am ddata gan ddefnyddio'r swyddogaethau SimApi a restrir isod:
• Mae pob cam sy'n gweithredu ar yr un egwyl yn cael eu grwpio yn un alwad SimApi i leihau nifer y galwadau. Mae'r gweinydd yn darllen y data diweddaraf ar gyfer yr holl newidynnau a ddefnyddir gan yr holl fodelau sy'n rhannu'r cyfwng, hy, bydd yr alwad hon yn arwain at res data eang a ddefnyddir wedyn gan bob prosiect.
  • simapi2_connectionReadCurrentData
• Ar gyfer pob prosiect swp mae angen i'r gweinydd hefyd wybod pa sypiau sy'n weithredol. Mae angen i hyn ddigwydd hefyd bob tro y bydd prosiect yn gweithredu:
  • simapi2_nodeGetActiveBatches
  • Mae simapi2_nodeGetBatchTimes yn cael ei alw'n llai aml.
• Yn ogystal, mae SIMCA-ar-lein hefyd angen data hanesyddol. Dim ond pan fo angen y bydd y ceisiadau hyn yn digwydd, megis dal i fyny ar ddechrau swp a ddechreuodd cyn i SIMCA-online ddechrau, neu pan fydd y gweinydd ar ei hôl hi ac angen darllen bloc o ddata:
  • simapi2_connectionReadHistoricalDataEx
• Yn ddewisol, mae rhai cyfluniad prosiect yn defnyddio nodweddion sy'n defnyddio data swp neu ddata arwahanol sy'n arwain at alwadau SimApi i:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• Yn ddewisol, mae rhai cyfluniadau prosiect yn defnyddio ysgrifennu yn ôl i wthio data yn ôl i'r ffynhonnell ddata:
  • simapi2_connectionWriteHistoricalDataEx (a swyddogaethau cyfatebol ar gyfer data swp, data arwahanol)
• Mae'n bwysig bod pob galwad i'r swyddogaethau craidd ar gyfer cael data, readCurrentData, getActiveBatches/getBatchTimes, yn gyflym ac nid yw hynny'n anodd yn gyfrifiadol i'r ffynhonnell ddata ei hun, o ystyried pa mor aml y gall SIMCA-ar-lein alw'r swyddogaethau hynny.

Profi a dilysu data SimApi

• Mae'r adran hon yn ymwneud â phrofi SimApi i wirio bod y data a ddychwelwyd ohono yn cyfateb i ddata yn y ffynhonnell ddata ei hun. Mae cynnal profion fel hyn yn bwysig ar ôl creu neu newid gweithrediad SimApi, neu pan fydd API ffynhonnell ddata yn newid.
• Yn ymarferol, mae dilysu data yn cael ei wneud gan ddefnyddio SIMCA-online a'i swyddogaeth Extract i dynnu data o'r ffynhonnell ddata trwy'r SimApi ac yna cymharu â'r data crai yn y ffynhonnell ddata. Ni ellir defnyddio SIMCA bwrdd gwaith i brofi agweddau amser real SimApi.

Paratoadau a gofynion

• Mae rhai eitemau yn ddewisol ond gellir eu perfformio os yw cwmpas eich profion yn ei gynnwys:

1. Gosod SIMCA-ar-lein fel y disgrifir yn ReadMe a Installation Guide.pdf sy'n dod yn y sip cynnyrch.
2. Sicrhewch drwydded ar gyfer y gweinydd ar-lein SIMCA iddo a'i osod. Ni fydd y SimApi yn gweithio heb drwydded. Mae'r erthygl sylfaen wybodaeth ar gyfer SIMCA-ar-lein yn dangos sut i drwyddedu'r cynnyrch. Am gynampLe: SIMCA-ar-lein 18 (sartorius.com)
3. Gosod a ffurfweddu'r SimApi rydych chi am ei brofi. Cyfeiriwch at benodau 4 – 5 yn y ddogfen hon a chanllaw defnyddiwr y SimApi penodol.
   • a. Dewisol: gwnewch yn siŵr bod y canllaw defnyddiwr yn gyfredol ac yn gywir.
4. Sicrhewch fod gennych offeryn ar gyfer eich ffynhonnell ddata y gallwch ei ddefnyddio i gymharu data SimApi ag ef.
5. Yn y cleient bwrdd gwaith ar-lein SIMCA, mewngofnodwch i'ch gweinydd ar-lein SIMCA a defnyddiwch File > Detholiad i gael data trwy'r SimApi.
6. Dewisol os yw'ch cwmpas profi yn ei gynnwys: ar ôl gorffen y profion, dadosodwch y SimApi a'i wirio files yn cael eu tynnu.

Beth i'w brofi

• Mae'r matrics nodwedd ym mhennod 3 yn rhestru'r holl nodweddion posibl, ond gall gweithrediad SimApi penodol gefnogi is-set yn unig. Dylech brofi'r holl nodweddion sy'n cael eu gweithredu gan y SimApi a roddir.
• Mae'r profion canlynol yn gyffredin i'r rhan fwyaf o weithrediadau SimApi:
• Dilysu gydag enwau defnyddwyr a chyfrineiriau
• Profwch y gosodiadau amrywiol yn ffurfweddiad y SimApi
• Hierarchaeth nodau: Y nodau a tags a ddatguddir gan y SimApi yn gywir.
  • Rhaid cael a tag yn agored ar gyfer yr holl “newidynnau” a ddylai fod ar gael trwy'r SimApi. Examples: mesuriadau proses, gwerthoedd cyfrifedig, cysonion.
• Gwydnwch cysylltu: os nad yw'r ffynhonnell ddata ar gael mae hyn yn arwain at rybuddion neu wallau yn y log file, ond bod y cysylltiad â'r ffynhonnell ddata yn cael ei ailsefydlu'n awtomatig pan fydd y ffynhonnell ddata ar gael.
• Achosion lluosog: y gellir ffurfweddu dau achos a'u defnyddio'n annibynnol ac ar yr un pryd, gyda logiau ar wahân files.
• Data cyfredol: echdynnu data cyfredol ar gyfer tags. Sicrhewch mai data yw'r gwerthoedd hysbys diwethaf o'r ffynhonnell ddata, neu ar goll oherwydd ansawdd gwael neu pan fo data'n rhy hen.
  • Tynnu data bob 10 eiliad (tua) am funud.
• Data parhaus hanesyddol: echdynnu data hanesyddol ar gyfer tags.
  • Defnyddiwch yr ystod amser sy'n cyfateb pan wnaethoch echdynnu data cyfredol. Gwirio bod data cyfredol yn cyfateb i ddata hanesyddol, a'r data crai yn y ffynhonnell ddata.
  • Rhowch gynnig ar wahanol ystodau amser ac sampcyfyngau ling, gwirio bod y data yn cyfateb i'r ffynhonnell data.
  • Ceisiwch echdynnu data bob 1 s, sef yr s byrraf posiblampegwyl ling.
  • Rhowch gynnig ar wahanol fathau o tags yn y ffynhonnell ddata (newidynnau proses, ac ati), gan sicrhau bod data'n cyfateb.
  • Sylwer: Gall SIMCA-ar-lein rannu un cais data hanesyddol mawr yn sawl darn llai. Bydd hyn i'w weld yn log SimApi.
• Gwiriwch fod y SimApi yn gweithio gyda data testun, data rhifol, a data coll.
• Log SimApi file. Gwiriwch fod y log yn cynnwys cofnodion rhesymol.
• Nod swp: de-gliciwch nod a gwnewch Darganfod sypiau.
  • Gwirio enwau sypiau, amseroedd cychwyn, amseroedd gorffen ar gyfer sypiau.
  • Rhowch gynnig ar swp gweithredol sy'n rhedeg yn y ffynhonnell ddata. Ni ddylai gael amser gorffen trwy'r SimApi.
• Dynodwr swp nod proses tag. Os oes gan y SimApi swyddogaeth nod swp (gweler bwled blaenorol), rhaid iddo hefyd gael dynodwr swp tag yn nod data'r broses baru. Data ar gyfer hyn tag dylai fod y dynodwr swp (enw swp). Mae angen y data hwn ar gyfer swp-brosiectau er mwyn nodi i ba swp y mae rhes o ddata yn perthyn.

Yn dibynnu a yw'r SimApi yn ei gefnogi, efallai y byddwch hefyd am brofi:

• Defnyddio data swp File > Dyfyniad.
• Defnyddio data arwahanol File > Dyfyniad. Nodyn: i brofi data arwahanol gyda File > Tynnwch y nod, rhaid i'r nod swp a'r nod data arwahanol fod yn yr un SimApi (pan fydd SIMCA-online yn gweithredu prosiectau, gallant fod o wahanol SimApis).
• Ysgrifennwch yn ôl – gwthio swp data i'r ffynhonnell ddata. I brofi hyn, rhaid i chi ffurfweddu ffurfweddiad prosiect yn SIMCA-ar-lein i ysgrifennu fectorau data yn ôl i'r ffynhonnell ddata. Yna gweithredwch y prosiect yn SIMCA-ar-lein a gwiriwch y data sydd wedi'i ysgrifennu yn ôl yn y ffynhonnell ddata.
• Mae data parhaus wedi'i ffurfweddu ar dudalen Evolution Write Back yng nghyfluniad y prosiect.
• Mae data arwahanol wedi'i ffurfweddu ar yr un dudalen, ond dim ond ar gyfer cam sydd wedi'i ffurfweddu ar gyfer adalw data arwahanol.
• Data swp o'r Swp Ysgrifennu yn ôl

MWY O WYBODAETH

• Sartorius Stedim Dadansoddeg Data AB Östra Strandgatan 24 903 33 Umeå Sweden
• Ffôn: +46 90-18 48 00
• www.sartorius.com
• Mae'r wybodaeth a'r ffigurau a gynhwysir yn y cyfarwyddiadau hyn yn cyfateb i'r dyddiad fersiwn a nodir isod.
• Mae Sartorius yn cadw'r hawl i wneud newidiadau i dechnoleg, nodweddion, manylebau a dyluniad yr offer heb rybudd. Defnyddir ffurfiau gwrywaidd neu fenywaidd i hwyluso darllenadwyedd yn y cyfarwyddiadau hyn a dynodi pob rhyw ar yr un pryd bob amser.
  Hysbysiad hawlfraint:
• Mae'r cyfarwyddiadau hyn, gan gynnwys yr holl gydrannau, wedi'u diogelu gan hawlfraint.
• Ni chaniateir unrhyw ddefnydd y tu hwnt i derfynau’r gyfraith hawlfraint heb ein caniatâd ni.
• Mae hyn yn arbennig o berthnasol i ailargraffu, cyfieithu a golygu, ni waeth pa fath o gyfrwng a ddefnyddir.

FAQ

• C: Beth yw pwrpas SimApis?
  • A: Prif bwrpas SimApis yw darparu data i gynhyrchion Umetrics Suite ar gyfer creu prosiectau ac adeiladu modelau.
• C: Sut alla i ddatrys problemau gyda gosodiad SimApi?
  • A: Gallwch chi ddatrys problemau trwy brofi o SIMCA-ar-lein, gan wirio log SimApi file, a sicrhau cyfluniad cyfrif gwasanaeth cywir.

Dogfennau / Adnoddau

Meddalwedd SARTORIUS Sim Api [pdfCanllaw Defnyddiwr Meddalwedd Sim Api, Meddalwedd Api, Meddalwedd

Cyfeiriadau

• Llawlyfr Defnyddiwr