Праграмнае забеспячэнне SARTORIUS Sim Api

Тэхнічныя характарыстыкі

• Назва прадукту: SimApi Guide
• Дата выхаду: 5 верасня 2024 г
• Мэта: прадастаўленне даных для прадуктаў Umetrics Suite

Інструкцыя па ўжыванні прадукту

Уводзіны ў SimApis

• SimApis выкарыстоўваецца для атрымання даных для стварэння праектаў і пабудовы мадэляў у прадуктах Umetrics Suite.

Атрыманне SimApis

• Каб атрымаць SimApis, звярніцеся да афіцыйнай дакументацыі або звярніцеся па дапамогу ў службу падтрымкі.

Асаблівасці SimApi

• SimApis прадастаўляе дадзеныя ў рэжыме рэальнага часу для маніторынгу, кантролю і пабудовы мадэляў у SIMCA і SIMCA-online.

Толькі бягучае выкарыстанне даных

• Для аптымальнай прадукцыйнасці рэкамендуецца выкарыстоўваць толькі бягучыя даныя і пазбягаць гістарычных даных.

Падрыхтоўка да ўстаноўкі SimApi

• Перад устаноўкай пераканайцеся, што ваша сістэма адпавядае мінімальным патрабаванням, указаным у кіраўніцтве карыстальніка.

Ўстаноўка SimApi

• Каб усталяваць SimApi у вашай сістэме, выконвайце пакрокавыя інструкцыі ў кіраўніцтве карыстальніка.

Настройка SimApi для SIMCA

• Наладзьце параметры SimApi у SIMCA у адпаведнасці з інструкцыямі.

Настройка SimApi для SIMCA-online

• Наладзьце SimApi для аперацый пошуку дадзеных і іх запісу ў рэжыме рэальнага часу ў SIMCA-online.

Тэставанне і ліквідацыю непаладак

• Пасля ўстаноўкі правядзіце тэставанне, каб пераканацца ў належнай функцыянальнасці. У выпадку ўзнікнення праблем звярніцеся да раздзела па ліквідацыі непаладак у кіраўніцтве карыстальніка.

Тэставанне ад SIMCA-online

• Праверце інтэграцыю SimApi з SIMCA-online, каб праверыць атрыманне даных.

Ліквідацыю непаладак з Log Files

• Выкарыстоўвайце часопіс SimApi file для выяўлення і вырашэння любых праблем з устаноўкай або эксплуатацыяй.

Канфігурацыя ўліковага запісу службы

• Забяспечце правільную канфігурацыю ўліковага запісу службы SIMCA-online для бесперабойнай працы.

Тэхнічныя дэталі

• Звярніцеся да раздзела 7 кіраўніцтва карыстальніка для атрымання падрабязнай тэхнічнай інфармацыі аб SimApis.

Уводзіны ў SimApis

• SimApi - гэта праграмны інтэрфейс паміж праграмным забеспячэннем Umetrics® Suite і крыніцай даных. Асноўная мэта SimApi - прадастаўленне даных у SIMCA®-online або SIMCA®.
• Sartorius Stedim Data Analytics AB распрацоўвае SimApis для мноства розных крыніц даных, такіх як гісторыі працэсаў і базы даных агульнага прызначэння.
• Гэты дакумент паказвае, што такое SimApi і як ён выкарыстоўваецца ў прадуктах Umetrics Suite. Вы даведаецеся, як спланаваць і ўсталяваць SimApi, як ліквідаваць непаладкі і як праверыць сваю ўстаноўку. Апошняя глава змяшчае тэхнічныя падрабязнасці SimApis, арыентаваныя на распрацоўшчыкаў.

Прызначэнне SimApi: прадастаўленне даных прадуктам Umetrics Suite

• Асноўная мэта SimApi - прадастаўленне даных у SIMCA-online або SIMCA з крыніцы даных. Крыніца даных не з'яўляецца часткай SIMCA-online, але можа быць архіватарам працэсу або іншай сістэмай, якая захоўвае даныя і кіруе імі.
• SimApi паказвае іерархію вузлоў, якія адпавядаюць тэчкам у a file сістэма. Кожны вузел можа ўтрымліваць іншыя вузлы, або tags. А tag адпавядае зменнай. Для гэтых tags, дадзеныя можна атрымаць. На малюнку а tag, Temp, выбраны ў вузле
• BakersYeastControlGood у крыніцы даных у SIMCA-online. Ён таксама паказвае апошнія значэнні, узятыя з крыніцы даных.

Выкарыстанне SimApi у Umetrics Suite

• Настольнае праграмнае забеспячэнне SIMCA можа выкарыстоўваць SimApi для атрымання даных для стварэння праектаў і мадэлявання, як паказана на наступным малюнку.
• SIMCA-online выкарыстоўвае SimApis для атрымання даных у рэжыме рэальнага часу для маніторынгу і кантролю, а таксама для запісу даных у крыніцу даных. На наступным малюнку паказана, дзе SimApi знаходзіцца ў сістэме, якая складаецца з крыніцы даных, SIMCA-онлайн-сервера і кліентаў.

Звычайна выкарыстоўваецца SimApis

• Найбольш шырока выкарыстоўваюцца SimApis:
• PI AF SimApi для падлучэння да Aveva (раней OSIsoft) PI Systems.
• OPC UA SimApi
• ODBC SimApi - для агульнага доступу да баз дадзеных, такіх як SQL Server або Oracle
• Усе даступныя SimApis разам з іх функцыямі пералічаны ў параграфе 3.

DBMaker SimApi для дадзеных мадэлявання

• DBMaker - гэта дадатак, якое пастаўляецца разам з устаноўкай сервера SIMCA-online. Ён імітуе крыніцу даных, напрыклад, гісторыю працэсу, выкарыстоўваючы папярэдне загружаную табліцу даных, дзе назіранні адно за адным перадаюцца ў SIMCA-online праз DBMaker SimApi.
• DBMaker выкарыстоўваецца толькі ў дэманстрацыйных мэтах і не можа выкарыстоўвацца ў вытворчасці з жывымі дадзенымі з крыніцы даных. Глядзіце ўбудаваную дапамогу, каб даведацца больш пра DBMaker.

Дадатковая дакументацыя

• Гэты дакумент з'яўляецца адным з шэрагу звязаных дакументаў, кожны з якіх мае розную ўвагу і мэтавую аўдыторыю:

Крыніца	Што	дзе
SIMCA-онлайн web старонка	Уводная інфармацыя і загрузкі	sartorius.com/umetrics-simca- онлайн

SIMCA-online ReadMe і Installation.pdf	Ўстаноўка і як пачаць працу з SIMCA - онлайн-дэманстрацыйныя дадзеныя	Ва ўсталявальным zip file
Кіраўніцтва па ўкараненні SIMCA-online	Апісвае функцыянальнасць SIMCA-online, ставіць яе ў кантэкст з іншым праграмным забеспячэннем Umetrics Suite, апісвае патрабаванні і лепшыя практыкі для паспяховага разгортвання, а таксама пакрокавыя інструкцыі па ўсталёўцы.	sartorius.com/umetrics-simca- онлайн
Кіраўніцтва SimApi	Падрыхтоўка і выкананне ўстаноўкі SimApi, уключаючы ліквідацыю непаладак. Таксама змяшчае тэхнічную інфармацыю аб SimApis для распрацоўшчыкаў.	sartorius.com/umetrics-simapi
Кіраўніцтва карыстальніка SimApi	Дакументацыя для кожнага апублікаванага SimApi з характарыстыкамі, інструкцыямі па ўсталёўцы і асаблівасцямі канфігурацыі.	sartorius.com/umetrics-simapi
Інтэрнэт-тэхнічнае кіраўніцтва SIMCA	Тэхнічныя даведкі па планаванні ўстаноўкі сервера SIMCA-online, пошуку і ліквідацыі непаладак і падрабязныя звесткі аб тым, як працуе SIMCA-online.	sartorius.com/umetrics-simca-онлайн
Даведка SIMCA онлайн	Webдаведка аб тым, як карыстацца SIMCA-online і як працуе SIMCA-online.	У самім праграмным забеспячэнні і далей sartorius.com/umetrics-simca
SIMCA-онлайн Web Кіраўніцтва па ўстаноўцы кліента	Апісвае ўстаноўку SIMCA-online Web Кліент.	sartorius.com/umetrics-simca-онлайн
База ведаў Umetrics	Пошукавая база дадзеных з артыкуламі аб кожнай выпушчанай версіі праграмнага забеспячэння, тэхнічнымі артыкуламі і вядомымі праблемамі ў прадуктах Umetrics Suite.	sartorius.com/umetrics-kb
Даведка SIMCA/кіраўніцтва карыстальніка	Як выкарыстоўваць настольны SIMCA для стварэння праектаў і мадэлявання дадзеных.	У SIMCA і далей sartorius.com/umetrics-simca
Падтрымка web старонка	Як атрымаць тэхнічную падтрымку.	sartorius.com/umetrics-support

Тэхнічная падтрымка

• Служба онлайн-падтрымкі Sartorius адказвае на тэхнічныя пытанні аб SimApis, а таксама можа перасылаць запыты на паляпшэнне SimApis адпаведным людзям. Даведайцеся больш на sartorius.com/umetrics-support.

Атрыманне SimApis

• Мы прапануем дакументацыю для даступных SimApis і спасылкі на праграмы ўстаноўкі на sartorius.com/umetrics-simapi.
• Кожны SimApi задакументаваны ў кіраўніцтве карыстальніка.
• Кіраўніцтва SimApi, якое вы зараз чытаеце, дапаўняе гэтую інфармацыю дадатковай інфармацыяй SimApi, калі справа даходзіць да планавання, усталявання і ліквідацыі непаладак SimApi.

Асаблівасці SimApi

• Не ўсе крыніцы дадзеных аднолькавыя. SimApi не павінен рэалізаваць усе функцыі ў спецыфікацыі. Па гэтых прычынах розныя SimApis прапануюць розныя функцыянальныя магчымасці. Наступная матрыца пералічвае даступныя SimApis і іх функцыі.
• Асаблівасці тлумачацца ніжэй. Звярніце ўвагу, што ў табліцы ёсць асобныя слупкі, якія паказваюць, якія функцыі даступныя ў SIMCA-online і SIMCA адпаведна.

Асаблівасць	Прызначэнне	Карыстанне SIMCA-онлайн	Выкарыстанне SIMCA
Актуальныя дадзеныя	Прачытайце адно назіранне з самым апошнім значэннем з крыніцы даных.	Звычайнае выкананне ў рэжыме рэальнага часу	–
Гістарычныя звесткі	Чытайце шмат назіранняў адначасова з гістарычнымі дадзенымі з крыніцы даных.	Дагнаць і прагназаваць мінулыя дадзеныя, ствараць праекты з дапамогай File > Новы	Майстар імпарту базы дадзеных для імпарту дадзеных працэсу для стварэння мадэлі.
Дыскрэтныя дадзеныя	Счытвайце лабараторныя/IPC даныя з крыніцы даных. Шмат назіранняў за партыю.	Для пакетных праектаў з фазамі або пакетнымі ўмовамі, наладжанымі для дыскрэтнага пошуку даных.	–
Пакетныя дадзеныя	Прачытайце ўмовы партыі і канчатковыя атрыбуты якасці (або	Пакетныя ўмовы або мясцовае цэнтраванне.	Майстар імпарту базы даных для чытання пакетных умоў

Асаблівасць	Прызначэнне	Карыстанне SIMCA-онлайн	Выкарыстанне SIMCA
	іншыя даныя тыпу MES). Адно назіранне на партыю.		стварэнне мадэлі пакетнага ўзроўню.
Пакетны вузел	Укажыце час пачатку і час заканчэння (пусты для актыўнай партыі) для канкрэтнай партыі. Пералічыць усе партыі, якія існавалі ў дыяпазоне часу.	Патрабуецца для выканання пакетных канфігурацый.	Майстар імпарту базы даных для выбару партый для імпарту.
Адваротны запіс - бесперапынныя дадзеныя	Запіс бесперапынных даных, такіх як прагнозы, назад у крыніцу даных.	Запішыце дадзеныя з узроўню пакетнай эвалюцыі, для Control Advisor або для бесперапынных канфігурацый	–
Адказаць - дыскрэтна	Запіс дыскрэтных даных, такіх як прагнозы, назад у крыніцу даных.	Адваротны запіс для пакетных канфігурацый на ўзроўні пакетнай эвалюцыі для фаз, настроеных для дыскрэтнага пошуку даных	–
Адваротны запіс – пакетныя дадзеныя	Запіс даных на ўзроўні партыі, такіх як прагнозы або канчатковыя атрыбуты якасці, у крыніцу даных.	Запішыце для пакетнай канфігурацыі на ўзроўні пакета	–
Іерархія вузлоў	SimApi падтрымлівае іерархію вузлоў, аналагічна a file сістэма. Кожны вузел можа ўтрымліваць tags і іншыя вузлы. Іерархія палягчае кіраванне вялікай колькасцю вузлоў і tags.	Падтрымліваецца ва ўсіх месцах tags выкарыстоўваюцца.
Масіў tag пашырэнне	Масіў tag захоўвае некалькі значэнняў. SimApi пашырае масіў tag многім індывідуальным tags, па адным для кожнага элемента ў масіве.	Падтрымалі дзе tags выкарыстоўваюцца для бесперапынных дадзеных. Кожны пашыраны tag павінна быць адлюстравана ў зменнай у праекце SIMCA.
Некалькі крыніц даных	SimApi можа падключацца да больш чым адной крыніцы даных або падтрымлівае некалькі асобнікаў з індывідуальнымі наладамі і часопісам files для кожнага асобніка.	Падключайцеся да некалькіх розных аднатыпных крыніц даных.	–
Устойлівасць злучэння	Калі SimApi адключаецца ад крыніцы даных, ён паспрабуе аўтаматычна аднавіць злучэнне.	SimApi не трэба перазапускаць, каб аднавіць злучэнне з крыніцай даных.	–
Распрацаваны ўласнымі сіламі	SimApi распрацаваны, прадастаўляецца і падтрымліваецца

Толькі бягучыя даныя, без гістарычных даных, не рэкамендуецца

• Некаторыя SimApis, у прыватнасці OPC DA, падтрымліваюць толькі чытанне бягучых даных, а не гістарычных.
• SimApi, які падтрымлівае толькі бягучыя даныя, нельга выкарыстоўваць у настольнай SIMCA, таму што ён не зможа счытваць гістарычныя даныя, на аснове якіх можна будаваць мадэлі.
• Для SIMCA-online мы настойліва рэкамендуем крыніцу даных і SimApi, якія забяспечваюць не толькі бягучыя даныя для выканання ў рэжыме рэальнага часу, але і гістарычныя даныя, каб мець магчымасць прагназаваць і даганяць мінулыя даныя. SIMCA-online аўтаматычна пераключаецца паміж дадзенымі ў рэальным часе і гістарычнымі дадзенымі па меры неабходнасці, і гэта нельга адключыць.
• Крыніца даных, якая забяспечвае толькі бягучыя даныя, але не гістарычныя даныя, можа працаваць для бесперапынных праектаў у SIMCA-online, але для пакетных праектаў патрабуюцца гістарычныя даныя.

Падрыхтоўка да ўстаноўкі SimApi

• У гэтым раздзеле апісваецца важная інфармацыя для паспяховай устаноўкі SimApi.

64-разрадны або 32-разрадны SimApis

• Ёсць 32-разрадныя і 64-разрадныя версіі кожнага SimApi.
• SIMCA-online і SIMCA з'яўляюцца 64-разраднымі і патрабуюць 64-разрадных варыянтаў SimApis. Устарэлыя 32-разрадныя SimApis па-ранейшаму даступныя для старых установак.

Месца для часопіса file і налады

• SimApi захоўвае свой журнал files у схаванай тэчцы Program Data1:
  %programdata%\Umetrics\SimApi, дзе %programdata% суадносіцца з фактычнай папкай на вашым кампутары. Па змаўчанні гэта C:\ProgramData.
• Кожны SimApi звычайна выкарыстоўвае свой уласны часопіс file, які аналагічны часопісу сервера SIMCA-online file будзе ўтрымліваць больш ці менш даных у залежнасці ад налады ўзроўню часопіса. гэта file карысна для ліквідацыі непаладак. Бервяно file называецца
  .log дзе гэта SimApi, які вы ўсталёўваеце, напрыкладample PIAFSimApi. Таксама глядзіце ў наступным раздзеле імёны асобнікаў SIMCA-online SimApi.
• Гэтая тэчка таксама змяшчае налады SimApi у XML file названы .xml.
• Большасць SimApis маюць графічны карыстацкі інтэрфейс, які змяняе налады ў xml file, але для некаторых вы ўводзіце змены непасрэдна ў XML file з дапамогай тэкставага рэдактара, напрыклад, нататніка. Глядзіце кіраўніцтва карыстальніка для кожнага SimApi.

File імёны, калі названыя асобнікі выкарыстоўваюцца з SIMCA-online

• У SIMCA-online кожны асобнік SimApi атрымлівае ўласную канфігурацыю file і часопіс file для працы з некалькімі асобнікамі кожнага SimApi. Імёны гэтых files дапаўняюцца імем асобніка, якое пададзена на ўкладцы SimApi у дыялогавым акне опцый сервера SIMCA-online.
• Наступны выпрample паказвае імёны гэтых files, дзе трэба замяніць імем SimApi.
• Імя канфігурацыі, дадзенае пры даданні асобніка: OmegaServer
• Канфігурацыя file імя: OmegaServer.xml
• Журнал file імя: OmegaServer.log
• Звярніце ўвагу, што агульны file .log file яшчэ ствараецца. Гэта бервяно file змяшчае запісы, якія па тэхнічных прычынах не могуць быць накіраваны ў журнал file з выпадкаў..
• Гэтая тэчка схавана ў Windows па змаўчанні. Каб убачыць гэта ў File Правадыр, які вы наладжваеце, паказвае схаваны fileс. Звярніце ўвагу, што вы можаце перайсці да схаванай папкі, увёўшы адрас File Адрасная радок Правадыра.
• Звярніце ўвагу, што SIMCA не падтрымлівае некалькі асобнікаў SimApi і таму выкарыстоўвае імёны без назвы асобніка, як апісана вышэй.

Сеткавае планаванне

• Вы павінны размясціць сервер SIMCA-online побач з крыніцай даных у сетцы. Гэта забяспечвае хуткае злучэнне паміж SIMCA-online і яго крыніцай даных.
• Сеткавае абсталяванне можа перашкаджаць сувязі паміж SIMCA-online і крыніцай даных.

Уліковыя запісы карыстальнікаў і дазволы на крыніцу даных

• Крыніцы даных звычайна кантралююць доступ да сваіх даных. Звычайна гэта робіцца з дапамогай імёнаў карыстальнікаў і пароляў, але таксама можна выкарыстоўваць абмежаванні на аснове IP-адрасоў або DNS (напрыклад,ample PI Trusts у Aveva PI System).
• Імя карыстальніка і пароль можна перадаць крыніцы даных рознымі спосабамі:
• SimApi запускаецца як карыстальнік Windows карыстальніка, які запускае настольны SIMCA або ўліковы запіс службы SIMCA-online на серверным кампутары. SimApi можа падключацца да крыніцы даных з дапамогай гэтага ўліковага запісу. Вось як працуюць OPC I і PI SimApi, а таксама ODBC, калі вы не ўказваеце ўліковыя даныя пры яго канфігурацыі.
• Для агульнага ODBC вы можаце выкарыстоўваць прыкладанне ODBC Data Sources Administrator, якое знаходзіцца ў меню Пуск у Windows.
• Некаторыя пастаўшчыкі баз дадзеных прадастаўляюць уласныя драйверы і інструменты для сваіх баз дадзеных. Базы дадзеных Oracle, напрыкладample, выкарыстоўвайце кампаненты доступу да дадзеных Oracle (ODAC).
• Некаторыя SimApis, такія як PI AF і ODBC, маюць дыялогавыя вокны канфігурацыі, якія захоўваюць зашыфраваныя ўліковыя дадзеныя ў XML-канфігурацыі SimApi file.
• PI таксама мае розныя параметры бяспекі, даступныя ў PI System Management Tools на кампутары-серверы PI. Даведайцеся больш у кіраўніцтве карыстальніка PI AF SimApi. Гэта кіраўніцтва карысна, нават калі вы выкарыстоўваеце старую версію OSIsoft PI SimApi.
• OPC DA і HDA выкарыстоўваюць DCOM у якасці транспарту паміж крыніцай даных і SimApi. DCOM наладжваецца з дапамогай інструмента Component Services (DCOMCNFG.EXE) у Windows і выкарыстоўвае аўтэнтыфікацыю Windows.
• Для старой версіі OSIsoft PI SimApi (не навейшай AF SimApi) для наладжвання злучэння з серверам PI выкарыстоўваецца прыкладанне OSIsoft AboutPI-SDK (PISDKUtility.exe).

Праверка падключэння крыніцы даных
Калі вы хочаце ўсталяваць SimApi на камп'ютар, можа быць карысна праверыць падключэнне гэтага камп'ютара да крыніцы даных з дапамогай іншага інструмента:

• Крыніцы даных ODBC у Windows выкарыстоўваюцца для канфігурацыі і тэставання агульнага ODBC. Звярніце ўвагу, што ёсць дзве версіі гэтага інструмента для 64-разрадных Windows: адна для 32-разрадных праграм і адна для 64-разрадных. Выкарыстоўвайце кнопку «Праверыць крыніцу даных» у канцы майстра канфігурацыі ODBC, каб праверыць падключэнне да базы дадзеных. Мы рэкамендуем наладзіць крыніцы даных як сістэмныя DSN.
• Інструмент падлучэння да базы дадзеных ад пастаўшчыка базы дадзеных, напрыклад, Oracle Data Access Components.
• PI System Explorer можна выкарыстоўваць для праверкі падключэння да сервера PI AF. Гэта частка кліента PI AF, які з'яўляецца перадумовай для PI AF SimApi.
• OPC UA Expert ад Unified Automation - UaExpert - гэта кросплатформавы тэставы кліент для сервераў OPC UA.
• Прыкладанне PI-SDK (PISDKUtility.exe) можна выкарыстоўваць для праверкі падключэння і для view любыя паведамленні пра памылкі, якія маглі быць зарэгістраваны, калі SIMCA-online спрабуе падключыцца да сервера PI. Гэта выкарыстоўваецца толькі для старой версіі OSIsoft SimApi, а не для PIAF.
• Інструменты кіравання сістэмай PI выкарыстоўваюцца на кампутары сервера PI для ліквідацыі непаладак з гэтага боку. Напрыкладample, каб знайсці праблемы бяспекі, якія перашкаджаюць доступу з сервера SIMCA-online. Даведайцеся больш аб ліквідацыі непаладак сістэмы PI у гэтым відэа на YouTube.
• Excel можа быць выкарыстаны для атрымання даных з ODBC-злучэння і большасці іншых сістэм, калі ўсталяваны адпаведны плагін.
• Matrikon OPC Explorer для Ior HDA (гэта асобныя інструменты) можна выкарыстоўваць для праверкі падключэння OPC, а Matrikon OPC Analyzer можна выкарыстоўваць для дыягностыкі праблем з падключэннем OPC. Спампуйце гэтыя бясплатныя інструменты з https://www.matrikonopc.com/products/opc-desktop-tools/index.aspx
• OPC Rescue (для DInd HDA) ад навучальнага інстытута OPC web сайт «дазваляе карыстальнікам лёгка дыягнаставаць праблемы сувязі і бяспекі і імгненна ліквідаваць іх адным націскам кнопкі. Усё гэта можна зрабіць без неабходнасці вучыцца наладжваць DCOM"

Ўстаноўка SimApi

Вось як усталяваць SimApi на ПК:

1. Прачытайце Кіраўніцтва карыстальніка для SimApi, які вы ўсталёўваеце. Ён змяшчае спецыфіку гэтага SimApi, якая дапаўняе агульныя інструкцыі, якія вы зараз чытаеце.
2. Усталюйце і наладзьце любыя перадумовы, згаданыя ў Кіраўніцтве карыстальніка SimApi (напрыклад,ampдрайверы базы дадзеных або SDK)
3. Запусціце праграму ўстаноўкі, каб усталяваць SimApi. Усталюйце 64-разрадную (x64) або 32-разрадную (x86) версію, якая адпавядае праграмнаму забеспячэнню, у якім вы будзеце яго запускаць.
4. Наладзьце SimApi ў SIMCA-online або SIMCA, як апісана ў наступных раздзелах, і звярніцеся да кіраўніцтва карыстальніка SimApi для апісання даступных налад.
5. Запусціце сервер SIMCA-online. Звярніце ўвагу, што гэта можа заняць час, таму што пры ініцыялізацыі SimApi ён пералічыць усе tags у крыніцы даных.
6. Праверце SimApi, атрымаўшы некаторыя даныя. Для SIMCA-online вы можаце выкарыстоўваць File > Выняць, як апісана ў 6.1.
7. Калі SimApi не працуе належным чынам, звярніцеся да часопіса SimApi files для ліквідацыі непаладак і да кіраўніцтва карыстальніка SimApi.

Настройка SimApi для выкарыстання ў SIMCA

Вось як выкарыстоўваць SimApi у SIMCA:

1.  Пачніце імпарт базы дадзеных адным з наступных спосабаў:
   • a. Каб стварыць новы праект у SIMCA: File > Новы звычайны праект або новы пакетны праект. Абярыце З базы дадзеных на ўкладцы Галоўная.
   • b. Каб імпартаваць набор даных у існуючы праект у SIMCA: З набору даных на ўкладцы «Дадзеныя» адкрытага праекта SIMCA.
2. Націсніце Дадаць новую крыніцу даных
3. Выберыце SimApi у якасці тыпу злучэння, націсніце кнопку … і знайдзіце .dll у тэчцы ўстаноўкі і націсніце Адкрыць.
4. Націсніце «Наладзіць» і звярніцеся да асабістага Кіраўніцтва карыстальніка SimApi, як зрабіць налады.
5. Націсніце Праверыць злучэнне з крыніцай даных, каб пераканацца, што вы можаце падключыцца да базы дадзеных. Гэта можа заняць шмат часу, калі іх шмат tags у крыніцы даных.
6. Націсніце OK, каб завяршыць канфігурацыю.
7. Каб даведацца, як працаваць з імпартаванымі данымі, звярніцеся да даведкі SIMCA.

Настройка SimApi для выкарыстання ў SIMCA-online

• Важна: каб мець магчымасць выкарыстоўваць SimApi, патрабуецца ліцэнзія на сервер SIMCA-online. Дэманстрацыйная ўстаноўка SIMCA-online не дазваляе выкарыстоўваць SimApis.
• Каб дадаць SimApi у сістэму, вы запускаеце SIMCA-online Server Options на ПК-серверы. Азнаёмцеся з падрабязнымі крокамі ў тэме даведкі SICMA-online. Дадайце і наладзьце SimApi на серверы.
• Парада: калі вы ўносіце змены ў SimApi, вы можаце перазапусціць гэты SimApi асобна ад параметраў сервера без перазапуску ўсяго сервера.
• Каб наладзіць некалькі асобнікаў гэтага SimApi, паўтарыце апісаныя вышэй дзеянні і выкарыстоўвайце ўнікальныя імёны для кожнага асобніка. Даведайцеся больш пра розныя часопісы і канфігурацыі files для выпадкаў у 4.2.

Тэставанне і ліквідацыю непаладак SimApi

• У гэтай главе гаворка ідзе пра тэсціраванне і ліквідацыю непаладак пры ўсталёўцы SimApi.

Тэставанне SimApi з SIMCA-онлайн

• Пасля паспяховага запуску сервера SIMCA-online вы можаце праверыць SimApi у SIMCA-online (калі сервер не запускаецца, гл. 6.2):
• Увайдзіце на сервер у кліенце SIMCA-online і перайдзіце да Extract на File укладка. Extract дапамагае праверыць SimApi, атрымліваючы праз яго дадзеныя:
• Вузлы («тэчкі») SimApi адлюстроўваюцца ў левым полі. Tags для абранага вузла адлюстроўваюцца ўверсе справа.
• Бягучыя дадзеныя можна хутка праверыць, проста націснуўшы view> далей tags якія забяспечваюць бесперапынныя даныя працэсу (гл. скрыншот)
• Пстрыкніце правай кнопкай мышы на вузле, каб знайсці партыі ў дыяпазоне часу. Вузел павінен быць пакетным вузлом, які ведае пра пакеты.
• Выберыце tags у раздзеле «Выняць» і націсніце «Далей» і завяршыце працу майстра, каб атрымаць даныя з дапамогай розных рэжымаў пошуку даных: бягучых, гістарычных, пакетных і дыскрэтных.
• Параўнайце атрыманыя дадзеныя з тым, што вы бачыце ў сваёй крыніцы даных, выкарыстоўваючы яе інструменты. Даведайцеся больш аб тэставанні і праверцы ўсіх функцый SimApi у 7.13.

Вырашыце праблемы SimApi з дапамогай часопіса SimApi file

• Калі сервер не запускаецца, SimApi не працуе належным чынам або не атрымліваецца здабываць, неабходна пракансультавацца з журналам SimApi file які кажа вам, у чым праблема. Уключыце вядзенне журнала на ўзроўні адладкі ў журнале SimApi, каб атрымаць поўную інфармацыю. Глядзіце 4.2.
• Заўвага: журналы сервераў SIMCA-online тут не вельмі карысныя. Яны пакажуць, як SimApi быў загружаны і ініцыялізаваны серверам, але канкрэтныя дэталі SimApi знаходзяцца ў яго журнале file.

Выкарыстоўвайце правільны ўліковы запіс службы SIMCA-online

• Калі вы тэстуеце доступ да крыніцы даных, памятайце, што вы ўвайшлі ў сістэму як пэўны карыстальнік на камп'ютары-серверы (звычайна гэта ваш уласны ўліковы запіс карыстальніка ў дамене Windows), але што ўліковы запіс сэрвісу SIMCA-online з'яўляецца іншым уліковым запісам, па змаўчанні LocalSystem, які мае іншыя правы доступу ў параўнанні з вашым уліковым запісам карыстальніка.
• Па гэтай прычыне нярэдкія выпадкі, калі тэсты працуюць, калі запускаюцца ад вашага ўліковага запісу, але SIMCA-online не можа падключыцца да крыніцы даных.
• Для вырашэння гэтай праблемы неабходна прадаставіць доступ для ўліковага запісу, які выкарыстоўваецца сэрвісам сервера SIMCA-online. Як правіла, вы змяняеце LocalSystem на пэўны ўліковы запіс службы дамена і даяце правы гэтаму ўліковаму запісу. Звярніце ўвагу, што гэта не прымяняецца, калі SimApi выкарыстоўвае ўліковыя даныя, устаноўленыя ў канфігурацыі SimApi, таму што гэтыя ўліковыя даныя маюць прыярытэт.

Тэхнічныя падрабязнасці SimApis

• У гэтай главе даюцца тэхнічныя падрабязнасці таго, як працуе SimApi. У асноўным ён прызначаны для распрацоўшчыкаў, якія жадаюць зразумець SimApis, каб рэалізаваць SimApi для крыніцы даных.
• Распрацоўшчыкам таксама варта прачытаць папярэднія часткі гэтага дакумента, каб пазнаёміцца ​​з SimApis і апісаннямі функцый высокага ўзроўню.

Калі варта разглядаць магчымасць распрацоўкі SimApi, а калі не?

Перш чым разглядаць магчымасць распрацоўкі SimApi для крыніцы даных:

1. Даследуйце, ці ёсць ужо SimApi, які вы можаце выкарыстоўваць. Магчыма, вы можаце ўключыць некаторыя функцыі ў сваёй крыніцы даных, каб выкарыстоўваць адзін з існуючых SimApis, напрыклад OPC UA.
2. Уважліва праглядзіце гэты дакумент і спасылкі на яго і вывучыце, ці адпавядае ваша крыніца даных патрабаванням: напрыклад,ample, ён павінен быць дастаткова хуткім, прадастаўляць не толькі бягучыя, але і гістарычныя дадзеныя.

• Па гэтых прычынах мы не рэкамендуем распрацоўваць SimApi, які падключаецца да апаратнага забеспячэння або інструментаў нізкага ўзроўню. Лепш падключыць гэтыя прыборы да сістэмы гісторыі працэсаў, такой як Aveva PI System, і дазволіць ёй атрымліваць даныя з прыбора і захоўваць іх у гісторыі. Затым PIAF SimApi можна выкарыстоўваць для атрымання даных з PI у прадукт Umetrics.

Распрацоўка SimApi і спецыфікацыя SimApi

• Спецыфікацыя SimApi, SimApi-v2, утрымлівае дакументацыю для ўсіх C-функцый у SimApi, якія неабходна рэалізаваць у DLL SimApi, а таксама некаторыя інструкцыі па распрацоўцы SimApi.
• Рэалізацыя SimApi з дапамогай C або C++ у большасці выпадкаў адбываецца на залішне нізкім узроўні.
• Рэкамендуемы і больш просты спосаб рэалізаваць SimApi - заснаваць яго на ExampЗыходны код leSimApi, які мы прапануем. Гэта былыample рэалізацыя SimApi, якая апрацоўвае C-інтэрфейс і пераводзіць яго ў .NET Framework, дзе фактычная рэалізацыя. Ён таксама мае код рамкі для вядзення журналаў, налад, графічнага інтэрфейсу канфігурацыі і іншы код рамкі.
• Для распрацоўкі SimApi камандзе распрацоўшчыкаў неабходны вопыт у распрацоўцы Windows, .NET Framework, C або C++. Патрабуецца таксама добрае веданне крыніцы даных, да якой павінен падключыцца SimApi, таму што мэта SimApi заключаецца ў перакладзе запытаў даных з SIMCA-online або SIMCA у API крыніцы даных. Рэалізацыя SimApi ніколі не з'яўляецца аднаразовым праектам, але звычайна патрабуе пастаяннай падтрымкі і перыядычнага абслугоўвання.

Чытанне або запіс дадзеных

• Асноўная задача SimApi - прадастаўленне даных з крыніцы даных. Гэта называецца чытаннем даных.
• Большасць рэалізацый SimApi таксама падтрымлівае запіс дадзеных. Гэта азначае запіс дадзеных праз SimApi у крыніцу даных. Запіс дадзеных з'яўляецца дадатковай функцыяй у SIMCA-online.

Tags і Вузлы

• A tag з'яўляецца ідэнтыфікатарам слупка або «пераменнай» у крыніцы даных. А tagІмя выкарыстоўваецца для ідэнтыфікацыі tag. Імёны ўнутры вузла павінны быць унікальнымі. SIMCA-online 18 - гэта першая версія, якая падтрымлівае вузел, які змяшчае падвузел і tag з такой жа назвай. Напрыкладample: бацькоўскі вузел можа мець падвузел пад назвай Batch і a tag пад назвай Batch.
• Вузел - гэта кантэйнер tags. Вузел таксама можа ўтрымліваць іншыя вузлы, падобна таму, як a file сістэма мае папкі ў папках.
• Як у а file сістэма, вузел і tag імёны могуць быць аб'яднаны ў поўны шлях, які адназначна ідэнтыфікуе a tag. The tag шляхі выкарыстоўваюцца ў SIMCA-online або SIMCA пры выбары tags выкарыстоўваць. А tag шлях пачынаецца з імя асобніка SimApi, за якім ідзе структура вузла і заканчваецца на tag імя, кожны элемент падзелены двукроп'ем (:). Напрыкладample “:ODBCSQLServer:Node:SensorTag1”.

SimApi пералічвае tags і вузлы пры запуску

• Рэалізацыя SimApi праглядае сервер у пошуках вузлоў і tags у крыніцы дадзеных, калі SimApi ініцыялізуецца, і адсочвае іх, каб розныя функцыі SimApi, якія выкарыстоўваюцца для пераліку tags і вузел можа быць рэалізаваны.
• Ініцыялізацыя SimApi адбываецца не толькі пры запуску сервера, але і можа быць паўторна запушчана карыстальнікам у SIMCA-online з функцыяй Refresh SimApi.

Адчувальнасць да рэгістра tag- і імёны вузлоў

• Tag імёны і імёны вузлоў адчувальныя да рэгістра.
• Такім чынам, а tag называецца "tag1" не тое самае, што "Tag1” з-за рознага рэгістра літары “Т”. Мы рэкамендуем не выкарыстоўваць tags або імёны вузлоў, якія адрозніваюцца толькі рэгістрам.

Вузел бесперапыннага працэсу 

• Калі вузел змяшчае tags з бесперапыннымі дадзенымі працэсу, яго можна назваць вузлом працэсу. Наступныя два скрыншоты паказваюць таблічнае прадстаўленне вузла працэсу з дадзенымі, за якімі ідзе малюнак, які паказвае, як вузел выглядае пры выбары tags у SIMCA-online.

Вузлы бесперапыннага працэсу павінны быць незалежнымі ад партый, серый або часу

• Каб добра працаваць у SimApi, вузел павінен быць незалежным ад партый, прагонаў або часу. Наяўнасць вузла, які змяшчае даныя для пэўнай партыі або дыяпазону часу, не будзе добра працаваць у SIMCA-online, таму што канфігурацыя праекта можа счытваць даныя толькі для гэтай партыі і не можа выкарыстоўвацца для іншых партый.
• Замест гэтага вузел павінен быць супастаўлены з адной або некалькімі фізічнымі адзінкамі ў працэсе, дзе выконваюцца вымярэнні.

Ідэнтыфікатар партыі tag патрабуецца ў вузлах бесперапыннага працэсу для пакетнага выканання праекта

• Кожны бесперапынны працэс павінен мець a tag (пераменная), які змяшчае ідэнтыфікатар партыі для кожнага назірання. Гэты ідэнтыфікатар партыі выкарыстоўваецца SIMCA або SIMCA-online, каб даведацца, да якой партыі належыць кожнае назіранне.
• $BatchID tag на скрыншотах у 7.4.3 ёсць такі эксampле.
  Хоць гэта не абавязкова, рэкамендуецца мець a tag у вузле працэсу, які паказвае бягучую фазу або этап працэсу. гэта tag затым можа выкарыстоўвацца ва ўмовах фазавага выканання ў SIMCA-online або ў SIMCA пры імпарце даных. Каштоўнасці для гэтага tag можа быць напрample «фаза1», «ачыстка», «фаза2».

Пакетны кантэкстны вузел

• Пакетны вузел - гэта вузел, які адсочвае пакеты; іх ідэнтыфікатары пакетаў, час пачатку і час заканчэння. Гэта абавязковае патрабаванне для пакетнага выканання праекта ў SIMCA-online. Крыніца даных можа мець больш чым адзін пакетны вузел, які паказвае пакеты рознымі спосабамі. Карыстальнік выбірае пакетны вузел, які прымяняецца да яго ці яе прыкладання. Гэты былыample паказвае партыі, якія ахопліваюць дзве розныя адзінкі:
• /Factory1 – партыі з агульным часам жыцця як для Unit1, так і для Unit2.
• /Factory1/Unit1 – партыі з тэрмінам службы толькі ў Unit1
• /Factory1/Unit2 – партыі з тэрмінам службы толькі ў Unit2
• Калі ў вашай крыніцы даных няма пакетнага вузла, вы можаце выкарыстоўваць пакетны генератар кантэксту ў SIMCA-online. Глядзіце ўбудаваную дапамогу.
• Дадатковыя пакетныя даныя
• Пакетны вузел можа таксама ўтрымліваць пакетныя дадзеныя; даныя, для якіх ёсць толькі адно назіранне для ўсёй партыі. Звярніце ўвагу, што tags з пакетнымі дадзенымі неабавязкова знаходзіцца ў вузле, які мае поўную функцыянальнасць пакетнага вузла. Дастаткова, каб SimApi падтрымліваў чытанне пакетных дадзеных для tags. Даведайцеся больш пра пакетныя даныя ў 7.6.
• Вось былыampфайл пакетнага вузла:
• Заўвага: прыведзены вышэй скрыншот зроблены з DBMaker, у камплекце з SIMCA-online. Каб убачыць гэта самастойна ў DBMaker, націсніце View Кнопка "Даныя" ў базе дадзеных Bakers Yeast для адлюстравання двух вокнаў, адно з якіх з'яўляецца партыйным вузлом, а другое - дадзенымі працэсу.

Тыпы даных: лікавыя даныя, тэкставыя даныя і адсутныя даныя

• Для кожнага tag, SimApi можа падтрымліваць тры тыпы даных: лікавыя, tex,t і адсутныя:
• Лікавыя даныя звычайна ўяўляюць сабой рэальныя значэнні параметраў працэсу, напрыкладamp6.5123. SimApi можа апрацоўваць толькі 32-бітныя значэнні з плаваючай коскай адзінарнай дакладнасці. Фармат адзінарнай дакладнасці з плаваючай кропкай - Вікіпедыя. Усе іншыя лікавыя тыпы даных у крыніцы даных павінны быць пераўтвораны ў float. Такім чынам, яны могуць мець справу як з вялікімі, так і з малымі значэннямі, але толькі з 6 ці 7 значнымі лічбамі. Даведайцеся больш у Тэхнічным кіраўніцтве.
• Гэта можа прывесці да страты дакладнасці для вялікіх цэлых лікаў або для сапраўдных лікаў, якія адначасова з'яўляюцца вялікімі і маюць дзесятковыя знакі. Для атрымання дадатковай інфармацыі глядзіце Тэхнічнае кіраўніцтва.
• Тэкставыя/радковыя даныя выкарыстоўваюцца для ідэнтыфікатараў партыі, умоў выканання фазы або для якасных зменных. Значэнні для тэксту tag даныя адчувальныя да рэгістра. Гэта азначае, што значэнне "запуск" не тое самае, што
  «БЕГ». Зменныя даты і часу не падтрымліваюцца непасрэдна SimApi, але яны могуць быць вернуты ў выглядзе радка ў фармаце ГГ-ММ-ДД ГГ:ХМ (напрыклад,ample “2020-09-07 13:45”).
• Адсутнасць значэнняў азначае, што няма значэння для вяртання, г.зн., няма даных.
• Які тып вяртаецца, залежыць ад рэалізацыі SimApi. SimApi ведае пра даныя ў крыніцы даных і павінен вяртаць тып даных, які лепш за ўсё падыходзіць.

Тры рэжыму пошуку даных: бесперапынны, Batc,h і дыскрэтны

• Спецыфікацыя SimApi вызначае тры рэжыму пошуку даных, г.зн. трыма рознымі спосабамі, з якіх SimApi можа прадастаўляць даныя tags у крыніцы даных (ці ў іншым кірунку: запіс даных у tags у крыніцы даных).
• Бесперапынны пошук даных - гэта адносіцца да бесперапыннага чытання даных і паслядоўна, назіранне за назіраннем па меры развіцця партыі або працэсу. Даныя счытваюцца для бягучага часу або для пэўнага дыяпазону праз рэгулярныя інтэрвалы паміж назіраннямі. Напрыкладample, усе даныя з 09:00:00 да 10:00:00 сampвялі кожныя 60 секунд, што прывяло да 61 назірання, калі канчатковыя кропкі ўключна.
• Пакетны пошук даных - гэта адносіцца да аднаго назірання з дадзенымі для ўсёй партыі (не звязанай з пэўным тэрмінам сталасці або момантам часу). Пакетныя атрыбуты і дадзеныя лакальнага цэнтравання чытаюцца як пакетныя дадзеныя ў SIMCA-online. Пакетныя ўмовы звычайна таксама чытаюцца як пакетныя даныя (калі толькі яны не настроены для дыскрэтнага пошуку даных).
• Дыскрэтны пошук даных – дыскрэтныя даныя могуць складацца з некалькіх назіранняў для многіх тэрмінаў пагашэння. Але ў адрозненне ад бесперапынных даных, дыскрэтныя даныя не чытаюцца паслядоўна, а ўсе даныя адначасова для пэўнай фазы пакета. Даныя не павінны размяшчацца праз рэгулярныя інтэрвалы зменнай сталасці. Усе дадзеныя перачытваюцца кожны раз, калі яны запытваюцца, з наладжаным інтэрвалам.
• Для любой дадзенасці tag дадзеныя можна запытваць у любым з трох рэжымаў, але звычайна SimApi падтрымлівае толькі адзін з гэтых рэжымаў для асобнага чалавека tag. Гэтак жа дазваляецца змешваць tags у вузле, але звычайна ўсе tags у межах пэўнага вузла падтрымліваюць адзін і той жа рэжым пошуку даных.
• Для бесперапынных даных (але не для пакетных або дыскрэтных даных2) можна запытваць бягучыя даныя або гістарычныя даныя, што з'яўляецца тэмай наступнага раздзела.
• Не ўсе SimApis падтрымліваюць усе рэжымы. Глядзіце матрыцу функцый вышэй і SimApi web старонка для дэталяў.

Бягучыя і гістарычныя бесперапынныя даныя праз SimApi

• Бесперапынныя дадзеныя адносяцца да дадзеных працэсу, якія змяняюцца з цягам часу.

Актуальныя дадзеныя

• Чытанне бягучых даных азначае запыт у крыніцы даных аб апошніх значэннях tags у момант пытання. Звярніце ўвагу, што час знешняй крыніцы даных тут не выкарыстоўваецца.
• Дадзеныя, прачытаныя як бягучыя, - гэта тое, што SIMCA-online пакажа як жывыя даныя. Па гэтай прычыне важна, каб у крыніцы даных не было непатрэбных затрымак. Каб добра працаваць у SIMCA-online, бягучыя даныя павінны быць як мага больш свежымі.
• Крыніца даных можа выкарыстоўваць свае веды аб даных і аб тым, як доўга сапраўдныя значэнні, і вырашыць вярнуць адсутныя даныя, калі неапрацаваныя даныя для моманту часу занадта старыя. Напрыкладample: даныя запытваюцца ў 15:00:00, але самая свежая кропка даных у крыніцы даных - 03:00:00. У гэтым выпадку даныя 12-гадзіннай даўніны, таму SimApi можа вырашыць вярнуць адсутнае значэнне (няма даных).

Гістарычныя звесткі

• Чытанне гістарычных даных азначае запыт у крыніцы даных значэнняў аднаго або некалькіх tags для пэўнага перыяду часу з пэўным інтэрвалам паміж назіраннямі. Звярніце ўвагу, што тут для пошуку даных выкарыстоўваецца мясцовы час крыніцы даных. Такім чынам, важная сінхранізацыя часу паміж крыніцай даных і серверамі.
• Гістарычныя даныя складаюцца з матрыцы даных. Рэалізацыя SimApi павінна запытваць дадзеныя з крыніцы даных, і sampперадайце яго праз зададзены інтэрвал і пабудуйце матрыцу даных для вяртання:
• Часам сама крыніца даных мае функцыі агрэгацыі для вяртання апрацаваных даных, або sampфункцыі ling, якія можна выкарыстоўваць для вяртання патрэбных даных.
• Для іншых крыніц дадзеных SimApi павінен запытаць усе даныя ў дыяпазоне часу, а затым sample правільныя назіранні для пабудовы матрыцы.
• Дадзеныя павінны быць вернуты для дыяпазону часу, нават калі ў гэтым дыяпазоне можа не быць неапрацаваных даных, а толькі непасрэдна перад часам пачатку. Напрыкладample: дадзеныя існуюць у крыніцы даных у моманты часу 10 і 20. SimApi запытвае даныя для моманту часу 15 і 17. У гэтым выпадку значэнні для моманту часу 10 павінны быць вернуты SimApi, але timestampапублікаваны як час 15 і 17, паколькі гэта былі самыя апошнія кропкі даных на той момант. Значэнні для tags у момант часу 10 называюцца межавымі значэннямі для запытанага дыяпазону. Для больш глыбокага тлумачэння значэнняў межаў гл. напрыкладampле дакументацыя для returnBounds у UA Частка 11: Гістарычны доступ – 6.4.3 Структура ReadRawModifiedDetails
  (opcfoundation.org)
• Інтэрпаляцыя ніколі не павінна выкарыстоўвацца для разліку значэнняў для будучых момантаў часу, таму што даныя не будуць супадаць з тым, што чытаецца ў рэальным часе як бягучыя даныя. Для эксample з папярэдняга пункта: калі даныя для 15 і 17 павінны быць інтэрпаляваны з выкарыстаннем значэнняў для пунктаў 10 і 20, яны будуць эфектыўна выкарыстоўваць значэнні з будучыні, што недапушчальна.
• Крыніца даных можа выкарыстоўваць свае веды аб даных і аб тым, як доўга сапраўдныя значэнні, і вырашыць вярнуць адсутныя даныя, калі зыходныя даныя для пэўнага моманту занадта старыя. Напрыкладample: даныя запытваюцца за 15:00:00, але самая свежая кропка даных у крыніцы даных - 03:00:00. У гэтым выпадку даныя 12-гадзіннай даўніны, таму SimApi можа вырашыць вярнуць адсутнае значэнне (няма даных).

Заўвага: SIMCA-online звычайна не запытвае больш за сто назіранняў за адзін выклік падчас звычайнага выканання праекта. Пры выкананні экстракцыі ў SIMCA-online або пры запуску SIMCA для працоўнага стала можна зрабіць большы запыт даных. Гэта можа заняць шмат часу, што і варта было чакаць.

Бягучыя і гістарычныя даныя павінны супадаць

• Часам могуць быць адрозненні, калі даныя чытаюцца як бягучыя даныя ў рэжыме рэальнага часу або гістарычныя даныя. Гэта выклікае праблемы ў SIMCA-online, таму што сервер аўтаматычна пераключаецца паміж бягучымі і гістарычнымі дадзенымі па меры неабходнасці.

Атрыманне дадзеных з нізкай затрымкай

• Калі крыніца даных выкарыстоўваецца SIMCA-online у ​​рэжыме рэальнага часу, важна, каб даныя ў крыніцы даных былі актуальнымі. Не павінна быць непатрэбных затрымак пры атрыманні даных у крыніцы даных. Даныя бесперапыннага працэсу для ўсіх зменных павінны быць даступныя адначасова для кожнага назірання. Даныя, якія паступаюць са спазненнем для некаторых зменных, не будуць атрыманы SIMCA-online.

Дадзеныя можна прачытаць у любы час 

• Калі SIMCA-online запытвае значэнне a tag для часу t ён атрымае значэнне з крыніцы даных за час t, або апошняе назіранне ў крыніцы даных да часу t, або інтэрпаляванае значэнне для часу t. Такім чынам, сервер заўсёды будзе атрымліваць значэнне кожны раз, калі ён запытвае, нават калі назіранне для гэтага дакладнага моманту часу можа не існаваць у крыніцы даных.
• Часamps у SimApi заўсёды UTC. Кліенты SIMCA-online і SIMCA прадстаўляюць час як мясцовы.

Разьба 

• SimApi па змаўчанні выклікаецца адным патокам карыстальнікам SimApi. Гэта дакладна для ўсіх версій SIMCA і SIMCA-online да версіі 17.
• SIMCA-online 18 падтрымлівае функцыю для ўключэння шматструменнага доступу праз SimApi. Чытайце больш у тэме даведкі Паралельны доступ SimApi.
• Гэта азначае, што SimApis павінен падрыхтавацца да шматструменнасці, калі гэта магчыма, зрабіўшы паток рэалізацыі SimApi бяспечным, і дакументаваць гэта і любыя меркаванні для карыстальнікаў SimApi.

Журнал file

• SimApi павінен запісваць дзеянні, паведамленні пра памылкі і папярэджанні ў свой журнал file каб дапамагчы ў ліквідацыі непаладак. Выкарыстоўвайце розныя ўзроўні часопіса, каб паказаць важнасць запісу.
• Рэкамендуецца запісваць «Не рэалізавана» для функцый, якія не былі рэалізаваны ў SimApi.

Апрацоўка памылак

• Калі SimApi не можа выканаць запыт ад крыніцы даных, ён можа вырашыць гэтую праблему адным з двух спосабаў; вяртаючы адсутныя значэнні (няма дадзеных) або сігналізуючы пра памылку SimApi:
• Вяртанне адсутных значэнняў абаненту і сігналізацыя аб поспеху дазваляе абаненту працягваць у звычайным рэжыме (але, вядома, без якіх-небудзь даных). Гэта рэкамендаваная практыка для частковых памылак, напрыклад, калі даныя могуць быць атрыманы для некаторых, але не для ўсіх, tags у запыце.
• Паведамленне аб памылцы SimApi дазваляе абаненту (напрыклад,ampна серверы SIMCA-online), каб неадкладна ўбачыць гэта і дзейнічаць. Гэта рэкамендаваная практыка для запытаў, якія не выконваюцца цалкам і не могуць вярнуць ніякіх даных.
• SIMCA-online апрацоўвае адсутныя значэнні або коды памылак па-рознаму, як апісана ў Тэхнічным кіраўніцтве SIMCA-online.

Патрабаванні да прадукцыйнасці SimApi

• Функцыі ў SimApi выкарыстоўваюцца для атрымання даных.
• Калі доступ да даных павольны, SimApi не будзе працаваць належным чынамampLe паказвае: калі SIMCA-online запытвае даныя кожную секунду, але іх атрыманне займае дзве секунды, сервер SIMCA-online ніколі не зможа паспяваць за дадзенымі ў рэжыме рэальнага часу, але паступова адстае ўсё больш і больш.
• У падраздзелах мы пакажам, як SIMCA і SIMCA-online выкарыстоўваюць функцыі доступу да даных SimApi і як часта будуць выклікаць функцыі SimApi. Гэта можа дапамагчы ва ўсталяванні патрабаванняў да прадукцыйнасці для рэалізацыі SimApi.

Выкарыстанне SIMCA функцый SimApi

• Калі настольная SIMCA або іншыя аўтаномныя прадукты выкарыстоўваюць SimApi для атрымання даных, гэтыя запыты будуць для пакетаў і даных апрацоўкі для набору зменных у пэўным дыяпазоне часу.
• Паколькі гэтыя запыты ініцыююцца карыстальнікам уручную, яны адбываюцца не вельмі часта і не выклікаюць значнай нагрузкі на крыніцу даных.
• Гэтыя функцыі SimApi выкарыстоўваюцца для атрымання дадзеных:
• simapi2_nodeGetActiveBatches
• simapi2_nodeGetBatchTimes
• simapi2_connectionReadHistoricalDataEx

Выкарыстанне SIMCA-online функцый SimApi

• SIMCA-online выкарыстоўваецца для маніторынгу працэсу ў рэжыме рэальнага часу, і, такім чынам, ён запытвае даныя праз SimApi праз рэгулярныя прамежкі часу. Самы кароткі інтэрвал выканання, які можна выкарыстоўваць, складае 1 секунду. Некаторыя рэальныя былыяampінтэрвалы выканання складаюць 10 с, 1 хвіліну або 10 хвілін.
• На серверы можа працаваць шмат праектаў адначасова.
• Каб паменшыць колькасць выклікаў API праз SimApi, сервер аптымізуе запыты даных, групуючы мноства адначасовых меншых запытаў у адзіны большы запыт для ўсіх зменных адначасова (даведацца больш у тэме даведкі «Аптымізаванае чытанне з крыніц даных павышае прадукцыйнасць»).
• Алгарытм выканання сервера працуе наступным чынам, калі ён запытвае дадзеныя з дапамогай функцый SimApi, пералічаных ніжэй:
• Усе этапы, якія выконваюцца з аднолькавым інтэрвалам, групуюцца ў адзін выклік SimApi, каб паменшыць колькасць выклікаў. Сервер счытвае апошнія дадзеныя для ўсіх зменных, якія выкарыстоўваюцца ўсімі мадэлямі, якія падзяляюць інтэрвал, г.зн. гэты выклік прывядзе да шырокага радка даных, які потым выкарыстоўваецца ўсімі праектамі.
  • simapi2_connectionReadCurrentData
• Для кожнага пакетнага праекта сервер таксама павінен ведаць, якія пакеты актыўныя. Гэта таксама павінна адбывацца кожны раз, калі праект выконваецца:
  • simapi2_nodeGetActiveBatches
  • simapi2_nodeGetBatchTimes выклікаецца радзей.
• Акрамя таго, SIMCA-online таксама патрабуе гістарычных даных. Гэтыя запыты адбываюцца толькі пры неабходнасці, напрыклад, дагнаць пачатак пакета, які пачаўся да запуску SIMCA-online, або калі сервер адстае і яму трэба прачытаць блок даных:
  • simapi2_connectionReadHistoricalDataEx
• Дадаткова некаторыя канфігурацыі праектаў выкарыстоўваюць функцыі, якія выкарыстоўваюць пакетныя дадзеныя або асобныя дадзеныя, што прыводзіць да выклікаў SimApi да:
  • simapi2_connectionReadBatchData
  • simapi2_connectionReadDiscreteEx
• Неабавязкова некаторыя канфігурацыі праектаў выкарыстоўваюць зваротны запіс для вяртання дадзеных у крыніцу дадзеных:
  • simapi2_connectionWriteHistoricalDataEx (і адпаведныя функцыі для пакетных даных, дыскрэтных даных)
• Важна, каб кожны выклік асноўных функцый для атрымання даных, readCurrentData, getActiveBatches/getBatchTimes, быў хуткім і не з'яўляўся цяжкім з вылічэнняў для самой крыніцы даных, улічваючы, як часта SIMCA-online можа выклікаць гэтыя функцыі.

Тэставанне і праверка дадзеных SimApi

• Гэты раздзел прысвечаны тэсціраванню SimApi, каб пераканацца, што даныя, якія вяртаюцца з яго, супадаюць з дадзенымі ў самой крыніцы даных. Правядзенне падобных тэстаў важна пасля стварэння або змены рэалізацыі SimApi або пры змене API крыніцы даных.
• На практыцы праверка даных выконваецца з дапамогай SIMCA-online і яе функцыі Extract для атрымання даных з крыніцы даных праз SimApi і наступнага параўнання з неапрацаванымі данымі ў крыніцы даных. Настольная SIMCA не можа быць выкарыстана для тэставання аспектаў SimApi у рэальным часе.

Падрыхтоўка і патрабаванні

• Некаторыя пункты з'яўляюцца неабавязковымі, але іх можна выканаць, калі яны ўваходзяць у аб'ём вашага тэставання:

1. Усталюйце SIMCA-online, як апісана ў ReadMe і Installation Guide.pdf, які пастаўляецца ў zip-пакеце прадукту.
2. Атрымайце ліцэнзію на сервер SIMCA-online і ўсталюйце яго. SimApi не будзе працаваць без ліцэнзіі. Артыкул базы ведаў для SIMCA-online паказвае, як атрымаць ліцэнзію на прадукт. Напрыкладample: SIMCA-online 18 (sartorius.com)
3. Усталюйце і наладзьце SimApi, які вы хочаце праверыць. Звярніцеся да раздзелаў 4-5 гэтага дакумента і кіраўніцтва карыстальніка канкрэтнага SimApi.
   • a. Дадаткова: пераканайцеся, што кіраўніцтва карыстальніка актуальнае і правільнае.
4. Пераканайцеся, што ў вас ёсць інструмент для вашай крыніцы даных, які можна выкарыстоўваць для параўнання даных SimApi.
5. У настольным кліенце SIMCA-online увайдзіце на сервер SIMCA-online і выкарыстоўвайце File > Выняць для атрымання дадзеных праз SimApi.
6. Неабавязкова, калі гэта ўключае ваш аб'ём тэсціравання: пасля заканчэння тэсціравання выдаліце ​​SimApi і праверце яго files выдаляюцца.

Што праверыць

• Матрыца функцый у раздзеле 3 пералічвае ўсе магчымыя функцыі, але дадзеная рэалізацыя SimApi можа падтрымліваць толькі падмноства. Вы павінны праверыць усе функцыі, якія рэалізаваны дадзеным SimApi.
• Наступныя тэсты з'яўляюцца агульнымі для большасці рэалізацый SimApi:
• Аўтэнтыфікацыя з дапамогай імёнаў карыстальнікаў і пароляў
• Праверце розныя налады ў канфігурацыі SimApi
• Іерархія вузлоў: вузлы і tags выстаўленыя SimApi правільныя.
  • Павінен быць а tag адкрыты для ўсіх «зменных», якія павінны быць даступныя праз SimApi. напрыкладampфайлы: вымярэнні працэсаў, вылічаныя значэнні, канстанты.
• Устойлівасць злучэння: калі крыніца даных недаступная, гэта прыводзіць да папярэджанняў або памылак у журнале file, але злучэнне з крыніцай даных аднаўляецца аўтаматычна, калі крыніца даных становіцца даступнай.
• Некалькі экзэмпляраў: два экзэмпляры можна наладзіць і выкарыстоўваць незалежна і адначасова з асобнымі журналамі files.
• Бягучыя даныя: атрымаць бягучыя даныя для tags. Пераканайцеся, што даныя з'яўляюцца апошнімі вядомымі значэннямі з крыніцы даных або адсутнічаюць з-за дрэннай якасці або калі даныя занадта старыя.
  • Выманне дадзеных кожныя 10 секунд (або каля таго) на працягу хвіліны.
• Гістарычныя бесперапынныя даныя: атрымаць гістарычныя даныя для tags.
  • Выкарыстоўвайце дыяпазон часу, які адпавядае, калі вы вынялі бягучыя даныя. Пераканайцеся, што бягучыя даныя адпавядаюць гістарычным даным і неапрацаваным даным у крыніцы даных.
  • Паспрабуйце розныя часовыя дыяпазоны і сampлінг інтэрвалы, пераканайцеся, што даныя супадаюць з крыніцай даных.
  • Паспрабуйце здабываць даныя кожныя 1 с, што з'яўляецца максімальна кароткімampлінг інтэрвал.
  • Паспрабуйце розныя тыпы tags у крыніцы даных (зменныя працэсу і г.д.), пераканаўшыся, што даныя супадаюць.
  • Заўвага: SIMCA-online можа падзяліць адзін вялікі запыт гістарычных даных на некалькі меншых частак. Гэта будзе бачна ў часопісе SimApi.
• Пераканайцеся, што SimApi працуе з тэкставымі, лікавымі і адсутнымі дадзенымі.
• Часопіс SimApi file. Пераканайцеся, што часопіс змяшчае разумныя запісы.
• Пакетны вузел: пстрыкніце вузел правай кнопкай мышы і выканайце Знайсці пакеты.
  • Праверце назвы партый, час пачатку і заканчэння для партый.
  • Паспрабуйце актыўны пакет, які працуе ў крыніцы даных. Ён не павінен мець час заканчэння праз SimApi.
• Ідэнтыфікатар пакета вузла працэсу tag. Калі SimApi мае функцыянальнасць пакетнага вузла (гл. папярэдні пункт), ён таксама павінен мець ідэнтыфікатар пакета tag у вузле дадзеных супастаўлення працэсу. Дадзеныя для гэтага tag павінна быць ідэнтыфікатарам партыі (імя партыі). Гэтыя даныя патрабуюцца для пакетных праектаў, каб вызначыць, да якога пакета належыць радок даных.

У залежнасці ад таго, ці падтрымлівае SimApi, вы таксама можаце праверыць:

• Пакетнае выкарыстанне дадзеных File > Выняць.
• Выкарыстанне дыскрэтных дадзеных File > Выняць. Заўвага: для праверкі дыскрэтных даных з File > Выняць вузел, пакетны вузел і дыскрэтны вузел дадзеных павінны быць у адным SimApi (калі SIMCA-online выконвае праекты, яны могуць быць з розных SimApis).
• Адваротны запіс - перадача пакета даных у крыніцу даных. Каб праверыць гэта, вы павінны наладзіць канфігурацыю праекта ў SIMCA-online для запісу вектараў даных у крыніцу даных. Затым запусціце праект у SIMCA-online і праверце даныя, запісаныя назад у крыніцу даных.
• Бесперапынныя дадзеныя наладжваюцца на старонцы Evolution Write Back у канфігурацыі праекта.
• Дыскрэтныя даныя наладжваюцца на той жа старонцы, але толькі для этапу, наладжанага для атрымання дыскрэтных даных.
• Пакетныя дадзеныя з зваротнай пакетнай запісу

БОЛЬШ ІНФАРМАЦЫІ

• Sartorius Stedim Data Analytics AB Östra Strandgatan 24 903 33 Umeå Sweden
• Тэлефон: + 46 90-18 48 00
• www.sartorius.com
• Інфармацыя і лічбы, якія змяшчаюцца ў гэтых інструкцыях, адпавядаюць даце версіі, указанай ніжэй.
• Sartorius пакідае за сабой права ўносіць змены ў тэхналогію, характарыстыкі, спецыфікацыі і дызайн абсталявання без папярэдняга паведамлення. Формы мужчынскага і жаночага роду выкарыстоўваюцца для палягчэння чытальнасці ў гэтых інструкцыях і заўсёды адначасова абазначаюць усе роды.
  Паведамленне аб аўтарскім праве:
• Гэтыя інструкцыі, уключаючы ўсе кампаненты, абаронены аўтарскім правам.
• Любое выкарыстанне па-за межамі закона аб аўтарскім праве не дазваляецца без нашага дазволу.
• У прыватнасці, гэта датычыцца перадруку, перакладу і рэдагавання, незалежна ад тыпу носьбіта.

FAQ

• Пытанне: Якая мэта SimApis?
  • A: Асноўная мэта SimApis - прадастаўленне дадзеных прадуктам Umetrics Suite для стварэння праектаў і мадэлявання.
• Пытанне: Як я магу ліквідаваць праблемы з устаноўкай SimApi?
  • A: Вы можаце ліквідаваць непаладкі шляхам тэставання з SIMCA-онлайн, правяраючы часопіс SimApi file, а таксама забеспячэнне правільнай канфігурацыі ўліковага запісу службы.

Дакументы / Рэсурсы

Праграмнае забеспячэнне SARTORIUS Sim Api [pdfКіраўніцтва карыстальніка Праграмнае забеспячэнне Sim Api, праграмнае забеспячэнне API, праграмнае забеспячэнне

Спасылкі

• Кіраўніцтва карыстальніка