ZEBRA P1131383-02 Stjórnun og gagnaskýrslur fyrir rafræna hitaskynjara

Upplýsingar um vöru

• Vöruheiti: Stjórnun og gagnaskýrslur fyrir rafræna hitaskynjara
• Leiðbeiningar fyrir þróunaraðila: P1131383-02EN Rev A
• Höfundarréttur: 2023/09/10
• Eiginlegar upplýsingar: Þessi handbók inniheldur einkaréttarupplýsingar Zebra Technologies Corporation og dótturfélaga þess (Zebra Technologies). Það er eingöngu ætlað til upplýsinga og notkunar aðila sem reka og viðhalda búnaðinum sem lýst er hér. Slíkar eignarréttarupplýsingar má ekki nota, afrita eða birta öðrum aðilum í öðrum tilgangi nema með skriflegu leyfi Zebra Technologies.
• Vörubætur: Stöðugar umbætur á vörum er stefna Zebra Technologies. Allar forskriftir og hönnun geta breyst án fyrirvara.
• Fyrirvari um ábyrgð: Zebra Technologies gerir ráðstafanir til að tryggja að útgefnar verkfræðiforskriftir og handbækur séu réttar; þó eiga sér stað villur. Zebra Technologies áskilur sér rétt til að leiðrétta allar slíkar villur og afsalar sér ábyrgð sem leiðir af þeim.

Notkunarleiðbeiningar fyrir vöru

Yfirview
Stjórnun og gagnaskýrslur fyrir rafræna hitaskynjara er hugbúnaðarverkfæri þróað af Zebra Technologies. Það gerir notendum kleift að stjórna og tilkynna gögn frá rafrænum hitaskynjurum.

Verkflæði
Verkflæðið fyrir notkun hugbúnaðartólsins er sem hér segir:

1. Skráðu tæki
2. Listi skynjara
3. Búðu til verkefni
4. Tengja skynjara við verkefni
5. Framkvæma verkefni
6. Stöðva verkefni

Skráning tæki
Til að skrá ZS300 skynjara með hugbúnaðarverkfærinu skaltu fylgja þessum skrefum:

1. Opnaðu hugbúnaðartólið á tölvunni þinni.
2. Tengdu ZS300 skynjarann ​​við tölvuna þína með meðfylgjandi USB snúru.
3. Smelltu á hnappinn „Skráða tæki“ í hugbúnaðartólinu.
4. Fylgdu leiðbeiningunum á skjánum til að ljúka skráningarferlinu.

Skráning á skynjara
Fylgdu þessum skrefum til að skrá ZS300 skynjarana sem eru tengdir hugbúnaðarverkfærinu:

1. Opnaðu hugbúnaðartólið á tölvunni þinni.
2. Smelltu á „List Sensors“ hnappinn í hugbúnaðartólinu.
3. Listi yfir tengda ZS300 skynjara mun birtast.

Að búa til verkefni
Til að búa til verkefni í hugbúnaðartólinu skaltu fylgja þessum skrefum:

1. Opnaðu hugbúnaðartólið á tölvunni þinni.
2. Smelltu á hnappinn „Búa til verkefni“ í hugbúnaðartólinu.
3. Sláðu inn upplýsingar um verkefnið, svo sem nafn, lýsingu og færibreytur.
4. Smelltu á hnappinn „Vista verkefni“ til að búa til verkefnið.

Að tengja skynjara við verkefni
Til að tengja skynjara við verkefni í hugbúnaðarverkfærinu skaltu fylgja þessum skrefum:

1. Opnaðu hugbúnaðartólið á tölvunni þinni.
2. Veldu viðkomandi verkefni af verkefnalistanum.
3. Smelltu á hnappinn „Tengdur skynjari“ í hugbúnaðartólinu.
4. Veldu skynjarann ​​sem þú vilt af skynjaralistanum.
5. Smelltu á hnappinn „Vista samband“ til að tengja skynjarann ​​við verkefnið.

Að framkvæma einfalt verkefni
Til að framkvæma einfalt verkefni með því að nota hugbúnaðartólið skaltu fylgja þessum skrefum:

1. Opnaðu hugbúnaðartólið á tölvunni þinni.
2. Veldu viðkomandi verkefni af verkefnalistanum.
3. Smelltu á hnappinn „Framkvæma verkefni“ í hugbúnaðartólinu.
4. Hugbúnaðurinn mun framkvæma verkefnið og veita niðurstöðurnar.

Stöðva verkefni
Til að stöðva verkefni sem er í gangi með því að nota hugbúnaðartólið skaltu fylgja þessum skrefum:

Opnaðu hugbúnaðartólið á tölvunni þinni.

1. Veldu verkefnið sem er í gangi af verkefnalistanum.
2. Smelltu á „Stöðva verkefni“ hnappinn í hugbúnaðartólinu.
3. Hugbúnaðurinn mun stöðva verkefnið og veita lokaniðurstöður.

Tæknilýsing

• Hugbúnaður: zebra.com/linkoslegal
• Höfundarréttur: zebra.com/copyright
• Einkaleyfi: ip.zebra.com
• Ábyrgð: zebra.com/warranty
• Enda Notendaleyfissamningur: zebra.com/eula

Algengar spurningar (algengar spurningar)

1. Sp.: Get ég notað þetta hugbúnaðarverkfæri með skynjurum frá öðrum framleiðendum?
   Svar: Nei, þetta hugbúnaðarverkfæri er sérstaklega hannað til að vinna með ZS300 skynjurum Zebra Technologies.
2. Sp.: Hvernig get ég fengið tæknilega aðstoð fyrir hugbúnaðartólið?
   A: Þú getur haft samband við tækniaðstoð Zebra Technologies í gegnum þeirra websíðuna eða með því að hringja í hjálparsíma þeirra.
3. Sp.: Get ég sérsniðið verkfæribreytur í hugbúnaðartólinu?
   A: Já, hugbúnaðarverkfærið gerir þér kleift að sérsníða verkfæri í samræmi við kröfur þínar
4. Sp.: Er til notendahandbók fyrir hugbúnaðartólið?
   A: Já, þessi textaútdráttur er hluti af notendahandbók hugbúnaðarverkfærsins. Þú getur vísað til þess fyrir nákvæmar leiðbeiningar og upplýsingar.

Leiðbeiningar verktaki

Höfundarréttur

• 2023/09/10
• ZEBRA og stílfærða Zebra-hausinn eru vörumerki Zebra Technologies Corporation, skráð í mörgum lögsagnarumdæmum um allan heim. Öll önnur vörumerki eru eign viðkomandi eigenda. ©2023 Zebra Technologies Corporation og/eða hlutdeildarfélög þess. Allur réttur áskilinn.
• Upplýsingar í þessu skjali geta breyst án fyrirvara. Hugbúnaðurinn sem lýst er í þessu skjali er útvegaður samkvæmt leyfissamningi eða trúnaðarsamningi. Einungis má nota eða afrita hugbúnaðinn í samræmi við skilmála þessara samninga.
• Fyrir frekari upplýsingar um lagalegar og eignarréttarlegar yfirlýsingar, vinsamlegast farðu á:
• HUGBÚNAÐUR: zebra.com/linkoslegal
• HÖFUNDARRETTUR: zebra.com/copyright
• MÖNTUR: ip.zebra.com
• ÁBYRGÐ: zebra.com/warranty
• LOKAnotendaleyfissamningur: zebra.com/eula

Notkunarskilmálar

Eignaréttaryfirlýsing

• Þessi handbók inniheldur einkaréttarupplýsingar Zebra Technologies Corporation og dótturfélaga þess („Zebra Technologies“). Það er eingöngu ætlað til upplýsinga og notkunar aðila sem reka og viðhalda búnaðinum sem lýst er hér. Slíkar eignarréttarupplýsingar má ekki nota, afrita eða birta öðrum aðilum í öðrum tilgangi nema með skriflegu leyfi Zebra Technologies.
• Vörubætur
  Stöðugar umbætur á vörum er stefna Zebra Technologies. Allar forskriftir og hönnun geta breyst án fyrirvara.
• Fyrirvari um ábyrgð
  Zebra Technologies gerir ráðstafanir til að tryggja að útgefnar verkfræðiforskriftir og handbækur séu réttar; þó eiga sér stað villur. Zebra Technologies áskilur sér rétt til að leiðrétta allar slíkar villur og afsalar sér ábyrgð sem leiðir af þeim.
• Takmörkun ábyrgðar
  Í engu tilviki skal Zebra Technologies eða einhver annar sem kemur að gerð, framleiðslu eða afhendingu meðfylgjandi vöru (þar á meðal vélbúnaði og hugbúnaði) vera ábyrgur fyrir tjóni af neinu tagi (þar á meðal, án takmarkana, afleidd tjóni, þ.mt tap á viðskiptahagnaði, rekstrarstöðvun eða tap á viðskiptaupplýsingum) sem stafar af notkun, afleiðingum notkunar eða vanhæfni til að nota slíka vöru, jafnvel þótt Zebra Technologies hafi verið tilkynnt um möguleika á slíkum skaða. Sum lögsagnarumdæmi leyfa ekki útilokun eða takmörkun á tilfallandi tjóni eða afleiddu tjóni, þannig að ofangreind takmörkun eða útilokun gæti ekki átt við um þig.

Yfirview

• Þessi handbók er fyrir forritara forrita sem samþætta gögn frá Zebra ZS300 skynjaranum.
• Stjórnun rafrænna hitaskynjara forritunarviðmóta (API) veitir möguleika á að stilla skynjara til notkunar. Þetta felur í sér að skrá skynjara, búa til verkefni, stilla skynjara, bæta skynjurum við verkefni, tengja auðkenni eigna við verkefni og stöðva verkefni.
• Gagnaskýrslur fyrir rafræna hitaskynjara API eru hönnuð til að veita gögn fyrir verkskýrslur. Sérhver skynjarlestur og fylgst með atburði sem eiga sér stað við notkun skynjara sem úthlutað er verkefnum er skráð og geymt í sjö ár.
• Þessi API gerir þér kleift að view þessi saga sem gerir þá gagnlegar til sátta og endanlegrar ráðstöfunar. Þetta sett af API er hannað til að veita gögn sem hægt er að nota til að búa til skýrslur eftir verkefni. Logbeiðnin er óunnin beiðni til langtímagagnageymslukerfisins.
• Sérhver hitalestur sem neminn fangar er skráður sem sérstakur atburður. Þetta þýðir að hver skynjari getur haft mörg þúsund atburði tengda sér. Kerfið fangar einnig aðra stóra atburði í notkun skynjarans. Forritaskilin bjóða upp á leið til að sía og blaðsíðugreina þessi gögn.

Verkflæði
Þessi tafla lýsir skrefum sem þarf til að fá einfalt notkunartilvik fyrir notkun Zebra hitaskynjara.

Skref	API	Athugasemdir
Skráðu skynjarann	POST / tæki/skynjara- skráningar	Notaðu raðnúmerið á skynjaranum.
Listaðu skynjara sem tengjast leigjanda	GET / tæki/umhverfis- skynjara	Staðfestu að skynjarinn hafi verið skráður. Valfrjálsar síur eru fáanlegar.
Búðu til verkefni	POST /umhverfismál/verkefni	Stilltu hitastigsupptökuþröskulda og upphafsaðferð. Endurtaktu fyrir hvert verkefni.
Búðu til a Webkrókaáskrift		Notandi fær aðeins einn Webkrókatilkynning á hvern skynjara fyrir hvert verkefni.
Tengdu skynjarann ​​við verkefnið	POST /environmental/tasks/ {taskId)/skynjarar	Notaðu verkefnakennið sem skilað var þegar verkefnið var búið til og skynjaraauðkennið sem var skilað þegar þú staðfestir skráningu skynjara. Endurtaktu fyrir hvern skynjara eða tengdu marga skynjara á sama tíma. Verkefnið byrjar þegar skynjarinn fær verkefnið.

Skref	API	Athugasemdir
Bættu eign við verkefni	POST/environmental/tasks/ {taskId}/assets	Notaðu verkefnakennið sem skilað var þegar verkið var búið til
Hættu verkefninu	POST /environmental/tasks/ {taskId}/stopp	Hættu að taka upp hitastig.
Sæktu upplýsingar um verkefnið	FÁ /umhverfismál/verkefni/ {taskId}	Notaðu Task ID sem skilað var þegar verkefnið var búið til.
Sækja öll verkefni	FÁ /umhverfismál/verkefni	Valfrjálsar síur eru fáanlegar.
Sæktu viðvörun fyrir verkefnið	FÁ /environmental/tasks/ {taskId}/alarms	Notaðu Task ID sem skilað var þegar verkefnið var búið til. Valfrjálsar síur eru fáanlegar.
Sæktu lestraratburðaskrá skynjara fyrir verkefnið	FÁ /data/environmental/tasks/ {taskId}/log	Notaðu Task ID sem skilað var þegar verkefnið var sett í geymslu. Ekki er víst að gögn séu tiltæk strax.

Að byrja

Í þessum hluta er greint frá tiltækum auðkenningaraðferðum sem þarf til að fá aðgang að öllum Zebra API.
ATH: Viðskiptavinalykillinn er stundum nefndur nokkrum nöfnum: App Key; Neytendalykill; eða viðskiptavinalykill. Í tilgangi þessarar handbókar munum við nota viðskiptavinalykil.

API auðkenning

• Aðgangur að öllum Zebra API þarf að vera auðkenndur. Það eru nokkrar aðferðir í boði fyrir auðkenningu með Zebra API. Þegar þú hefur fengið aðgang að rafrænu
• Hitaskynjara API, þú munt nota biðlaralykilinn þinn á forritasíðunni þinni (developer.zebra.com/user/apps) af Zebra Developer Portal. Það er mjög mikilvægt að þú geymir þennan lykil öruggan og öruggan frá kóðanum þínum, geymslum eða öðrum einstaklingum. Ekki gefa eða deila fullum lyklinum þínum með neinum.

Notaðu einfaldan lykil
Hægt er að sannvotta flest API með því að gefa upp biðlaralykilinn í hausunum undir apikey færibreytunni. Þetta er aðeins mælt fyrir fyrstu prófun og Proof of Concept vinnu. Þetta er óöruggasta aðferðin og ætti aldrei að nota utan stjórn framkvæmdaraðilans.

1. Smelltu   til að afrita biðlaralykilinn.
2. Farðu á viðkomandi API síðu.
3. Smelltu á Heimilda.
4. 4. Límdu viðskiptavinalykilinn í ApiKeyAuth textareitinn og smelltu á Heimilda.

OAuth viðskiptamannaskilríki

• Hægt er að búa til OAuth burðartákn með því að gefa upp biðlaralykilinn og biðlaraleyndarmál. Þú finnur viðskiptavinalykil og leyndarmál á appsíðunni á Zebra Developer Portal. Allur Zebra
• Handhafamerki endast í eina klukkustund en hægt er að endurnýja það með því að nota fyrra táknið. Viðskiptavinaskilríki veitingategund ætti aðeins að nota frá þjóni biðlaraforrits, aldrei beint frá biðlaraforriti þar sem það getur veitt opinn aðgang að lyklum viðskiptavinar.
• Búa til tákn: developer.zebra.com/apis/oauth-client-credentials
• Til að staðfesta skaltu hringja í API hér að ofan og fá tákn. Ef táknið kemur aftur með abc123 skaltu slá það inn í Gildi reitinn í Tiltækar heimildir valmynd og smelltu á Heimilda.

OAuth heimildarkóði

• Aðalaðferðin til að búa til viðskiptavinarsértækan burðarlykilinn er heimildarkóði styrktegundin. Þetta er venjulegur 3-legged OAuth sem notaður er í mörgum web umsóknir. Það er talin ein öruggasta aðferðin til að fá tákn. Öll Zebra Bearer tákn endast í eina klukkustund en hægt er að endurnýja þau með því að nota fyrra táknið.
• Gerð heimildarkóða er margþætt ferli. Fyrst vísarðu á IDP innskráninguna og gefur upp tilvísunar-URI. Eftir að viðskiptavinurinn hefur skráð sig inn mun IDP senda heimildarkóðann til URI viðskiptavinaforritsins. Heimildarkóðar endast í 10 sekúndur. Biðlaraforritið kallar á tákn API með kóðanum til að fá burðartákn.

Mynd 1 Verkflæði heimildakóða
Farðu til developer.zebra.com/apis/oauth-authorization-code-0 fyrir frekari upplýsingar um OAuth heimildarkóða.

Skráning tæki

Þessi hluti lýsir skrefunum til að skrá ZS300 skynjara í gegnum Zebra Developer Portal.

Skráning á ZS300 skynjara
Til að skrá ZS300 skynjara í Zebra Developer Portal:

• ZB200 Bridge eða Android v8.1 eða nýrra farsíma sem keyrir Android Sensor Discovery Service
• Aðgangur að Ethernet tengi og Ethernet snúru ef þú notar brú og það er enginn aðgangur að þráðlausu neti eða notandi notar ZSFinder.
• Einn eða fleiri ZS300 skynjarar.
• Viðskiptavinalykill

1. Farðu í Zebra Developer Portal á developer.zebra.com.
2. Skráðu þig inn á gáttina.
3. Farðu á Stjórnun rafrænna hitaskynjara API síðu.
4. Smelltu á Heimild og sláðu inn viðskiptavinalykilinn þinn.
5. Smelltu á Loka.
6. Stækkaðu POST/tæki/skynjara-skráningaraðferðarskjáinn.
7. Smelltu á Prófaðu það.
8. Sláðu inn raðnúmerið sem staðsett er á framhlið ZS300 skynjarans í JSON líkamanum.
9. Smelltu á Keyra. Ef vel tekst til birtist HTTP stöðukóði 200, svarhlutinn er tómur JSON meginmál og áætlað er að tækið verði skráð.
10. Haltu inni hnappinum framan á skynjaranum þar til gulbrún ljósdíóða blikkar. a Tækið skráir sig eftir eina eða tvær mínútur.
11.  Haltu áfram að skrá skynjarana.

Skráning á skynjara

Þessi hluti lýsir því hvernig á að skrá ZS300 skynjarana í gegnum Zebra Developer Portal.

Listi yfir ZS300 skynjara

Áður en eftirfarandi skref eru framkvæmd verður að skrá að minnsta kosti einn ZS300 skynjara.

1. Farðu á Stjórnun rafrænna hitaskynjara API síðu.
2. Smelltu á Heimild og sláðu inn viðskiptavinalykilinn þinn.
3. Smelltu á Loka.
4. Stækkaðu GET/tæki/umhverfisskynjara aðferðaskjáinn.
5. Smelltu á Prófaðu það.
6. Sláðu inn 0 í reitinn fyrir síðunúmer.
7. Sláðu inn 1 í reitnum fyrir síðustærð. Ef fleiri en einn skynjari er skráður skaltu slá inn viðeigandi númer.
8. Sláðu inn raðnúmer skynjarans í textasíureitinn.
9. Eyddu sjálfgefnum gildum í reitunum task_id, enrolled_after og enrolled_before ef þeirra er ekki þörf.
10. Smelltu á Keyra. Ef vel tekst til er svaraðal með HTTP stöðukóða upp á 200 skilað. JSON meginmál er innifalið í svarinu sem inniheldur upplýsingar um skynjarann ​​sem nú er skráður.
    ATH: Stundum getur 327.67 hitastigið birst í reitnum Síðasti hitastig. Það er ógildur lestur. Þegar skynjari kemur út úr djúpsvefninum tekur hann við
    mínútu áður en hún hefst samplanga. Á þessum tíma hefur skynjarinn ekki gilt hitastig, þannig að gildið 7FFF er notað sem gefur hitastigið 327.67.
11. Vistaðu auðkenni skynjarans fyrir næsta skref.

Að búa til verkefni

Þessir hlutir lýsir því hvernig á að búa til verkefni í gegnum Zebra Developer Portal

1. Farðu á Stjórnun rafrænna hitaskynjara API síðu.
2. Smelltu á Heimild og sláðu inn viðskiptavinalykilinn þinn.
3. Smelltu á Loka.
4. Stækkaðu POST/umhverfis-/verkefnisaðferðarskjáinn.
5. Smelltu á Prófaðu það.
6. Sláðu inn sample JSON í reitnum Request Object.
7. Sláðu inn einstakt nafn í nafnareitinn.
8. Smelltu á Keyra. Ef vel tekst til er svar með HTTP stöðukóða upp á 200 skilað. Auðkenni verks er skilað í svarhlutanum.

Að tengja skynjara við verkefni

Þessi hluti lýsir því hvernig á að tengja ZS300 skynjara við verkefni í gegnum Zebra Developer Portal.

Að tengja skynjara við verkefni

Auðkenni skráðs skynjara verður að vera tiltækt áður en þú reynir eftirfarandi aðferð. ATH: Notandinn getur tengt marga skynjara við verkefni í einu

1. Stækkaðu POST/environmental/task/{taskId}/sensors aðferðaskjáinn.
2. Smelltu á Prófaðu það.
3. Sláðu inn skilað verkauðkenni í reitnum taskId slóð.
4. Sláðu inn skilað skynjaraauðkenni frá Listing the Sensor í Sensor ID fylki í Request Object reitnum.
5. Smelltu á Keyra. Ef vel tekst til er svar með HTTP stöðukóða upp á 200 skilað. JSON hlutur með sensor_id og sensor_task_id tengingunni er skilað.
6. Ýttu á hnappinn á skynjaranum og haltu honum inni í 10 sekúndur þar til ljósdíóðan blikkar appelsínugult. Eftir að skynjarinn blikkar grænt er verkefnið hafið.
   ATH: Ef skynjaraljósið blikkar ekki grænt skaltu færa skynjarann ​​nær brúnni.

Að framkvæma einfalt verkefni

Þessi hluti lýsir því hvernig á að framkvæma einfalt verkefni í gegnum Zebra Developer Portal.

Stöðva verkefni

Að minnsta kosti einn ZS300 skynjara verður að vera skráður, búið til verkefni og einn eða fleiri skynjara tengda verkefni áður en farið er í eftirfarandi aðferð.

1. Endurtaktu ferlið Listing the skynjara.
2.  Athugaðu að stöðureitur skynjarans er SENSOR_STATUS_STOPPED.
   ATH: Ef þú endurtekur aðferðina List the Sensors aftur breytist staðan í SENSOR_STATUS_ACTIVE.
3. Leyfðu verkefninu að keyra í að minnsta kosti fimm mínútur.
4. Færðu skynjarann ​​í mismunandi hitastig.
5. Eftir fimm mínútur skaltu stöðva verkefnið með því að stækka POST/environmental/tasks/{taskId}/stop gluggann.
6. Smelltu á Prófaðu það.
7. Sláðu inn taskId í slóðareitinn.
8. Smelltu á Keyra. Ef vel tekst til er svarhluti með HTTP stöðukóða upp á 200 skilað og verkefninu stöðvað. Þegar allir skynjarar sem tengjast verkefninu eru innan sviðs brúarinnar, þá er verkefnið stöðvað.
9. Endurtaktu ferlið Listing the Sensors til að ganga úr skugga um að stöðureiturinn hafi farið aftur í SENSOR_STATUS_STOPPED stöðuna og verkefnastaða skynjarans sé SENSOR_TASK_STATUS_COMPLETED.

Notar Webkrókur Áskriftir

Webkrókar gera rauntíma tilkynningar og gagnauppfærslur. Í stað þess að ein umsókn biðji aðra um að fá svar, a webhook er þjónusta sem gerir einu forriti kleift að senda gögn til annars um leið og tiltekinn atburður á sér stað.

Skilningur Webkrók Hugtök
Til að hjálpa þér að skilja betur innihaldið í þessari handbók útskýra eftirfarandi skilgreiningar Webkrókahugtök:

• Webkrókur: Ein viðburðarskilaboð. Zebra sendir a webkrókur við umsókn þína webkrókaáskriftarendapunktur. A webkrókurinn inniheldur JSON hleðslu í meginmálinu og lýsigögn í hausunum.
• Webkrókaáskrift: Þetta er viðvarandi gagnahlutur í forritinu þínu sem skilgreinir webkrókaáskriftarendapunktur. Þinn webHook áskrift ætti einnig að hafa rökfræði til að meðhöndla gögn sem verða send á endapunktinn þinn frá Zebra.
• Webkrókur Áskrift Endapunktur: Áfangastaðurinn sem Zebra sendir webkrókar fyrir tilgreindan atburð.
• Webkrókur hlustandi: Forrit sem veitir endapunkt fyrir a webkrókaáskrift sem hægt er að senda viðburðarskilaboð í.

Skilningur Webkrókar og API

API gera tvíhliða samskipti milli hugbúnaðarforrita. Beiðnir, einnig kallaðar skoðanakönnun, knýja áfram samskipti milli forritanna tveggja. Á hinn bóginn, webkrókaáskrift gerir kleift að deila gögnum í aðra áttina af völdum atburða frekar en beiðna. Á eftirfarandi tveimur myndum geturðu séð hvernig webkrókar virka og hvernig þeir geta veitt skilvirkari, hagkvæmari og tímanlegri gagnaaðgang en API skoðanakönnun.

Mynd 2 Könnun með API

Mynd 3    Webkrókar

Að mestu leyti, webHægt er að líta á króka sem undirmengi POST aðferðarinnar, eins og sýnt er á myndinni hér að neðan. Þetta er vegna þess webkrókar framkvæma POST-kall til API endapunkts sem þú setur upp í umhverfi þínu. Þegar þú setur upp þinn webkrókaáskrift, tilgreindu endapunktinn sem þú bjóst til sem staðinn sem gögnin verða birt þegar þau eru send.
Mynd 4 HTTP beiðni aðferðir

Að vita hvenær á að nota Webkrókar
Webkrókar eru einfaldað módel af samskiptum þannig að þú ættir að nota webkrókar þegar þú þarft eftirfarandi:

• Rauntíma einstefnusamskipti (frá uppruna til áfangastaðar)
• Óviðvarandi tengsl milli samskipta kerfanna tveggja
• Tafarlaust svar við atburði frá SaaS forriti sem styður webkrókar
• Notkun ýta líkansins til að ýta strax á uppfærslur
• Einn á einn samskipti
  Stjórna undantekningum: Þú þarft að stjórna öllum undantekningum sem eiga sér stað, svo sem sendingar sem falla utan skipulegra hitastigssviða.

Að búa til a Webkrókur Áskrift

Þessi hluti lýsir því hvernig á að búa til a webkrókar áskrift í gegnum Zebra Developer Portal í þeim tilgangi að fanga hitastigsferðir.
Þú verður að útvega netþjóni kyrrstæðan endapunkt sem hæfir HTTPS til að taka á móti gögnum frá Zebra. Endapunkturinn verður að:
ATH: Mælt er með því webkrókar eru búnir til eftir að verkefnið er búið til en áður en skynjarar eru tengdir verkefninu, annars getur viðvörun komið fyrir webkrókur hefur verið búinn til. Ef það gerist, þá webkrókstilkynning mun ekki berast.

• Samþykkja POST beiðnir. Zebra sendir gögn viðskiptavina á endapunktinn sem þú tilgreinir í POST beiðnum.
• Samþykkja JSON gögn. Zebra sendir gögn á JSON formi. Forritið/json innihaldsgerðin mun afhenda JSON farminn beint sem meginmál POST beiðninnar.
• Notaðu HTTPS. Zebra sendir hugsanlega viðkvæm gögn fyrir hönd viðskiptavina og HTTPS er fyrsta skrefið í að tryggja að gögn þeirra séu örugg.

Forkröfur

• Búðu til a webkrókendapunktur innan umsóknar þinnar
• Bættu við rökfræði til að takast á við Zebra atburði. Fyrir [PLATFORM eða SERVICE] áskrift, eru meðal annars: [TEMP DATA]
• Prófaðu þitt webkrók endapunktur til að staðfesta að það virki eins og búist var við

1. Gakktu úr skugga um að forritalykillinn þinn fyrir notkun þessa API sé tiltækur. Sjáðu Byrjunarhandbókina fyrir frekari upplýsingar.
2. Búðu til POST beiðni til api.zebra.com/v2/devices/environmental-sensors/event/subscription með líkama eins og eftirfarandi tdample. Vertu viss um að nota þinn eigin viðskiptavinalykil, leigjanda, webkrókurUrl og nafn áskriftar þinnar.
3.  Þín cURL ætti að líta svipað út og eftirfarandi tdample.
4. Þú færð 200 OK svar svipað og eftirfarandi dæmiample. Sjálfgefið er webHook áskrift hefst strax eftir stofnun hennar.
   Með því að nota GET aðferðina á sama API endapunkti geturðu staðfest þitt webkrækja áskrift með því að framkvæma GET beiðni til að skila öllum áskriftum þínum.

Byrjar a Webkrókur Áskrift
Svo lengi sem þú hefur virkni webhook áskrift geturðu hafið áskriftina hvenær sem er með því að taka eftirfarandi skref.

1. Sendu GET beiðni til api.zebra.com/v2/devices/environmental-sensors/event/subscription/:subscriptionId/byrjun. Þú þarft að gefa upp tiltekið áskriftaauðkenni sem þú vilt hætta sem leiðarbreytu. Vertu viss um að nota þinn eigin viðskiptavinalykil og leigjanda fyrir áskriftina þína.
2. Þín cURL ætti að líta svipað út og eftirfarandi tdample.
   Mynd 5 cURL að byrja a Webkrókur Áskrift Example
3. Ef áskriftin þín hófst með góðum árangri færðu tómt 200 OK svar.
4. Ef þú ert að reyna að hefja áskrift sem er í gangi færðu 409 Conflict svar vegna þess að þú getur ekki hafið áskrift sem er í gangi.

Stöðvun a Webkrókur Áskrift
Svo lengi sem þú hefur virkni webhook áskrift geturðu hætt áskriftinni hvenær sem er með því að gera eftirfarandi skref.

1. Sendu GET beiðni til api.zebra.com/v2/devices/environmental-sensors/event/subscription/:subscriptionId/stop Þú þarft að gefa upp tiltekið subscriptionId sem þú vilt stöðva sem slóðbreytu. Vertu viss um að nota þinn eigin viðskiptavinalykil og leigjanda fyrir áskriftina þína.
2. Þín cURL ætti að líta svipað út og eftirfarandi tdample.
   Mynd 6 cURL að hætta a Webkrókur Áskrift Example
3. Ef áskriftin þín hætti með góðum árangri færðu tómt 200 OK svar.
4. Ef þú ert að reyna að stöðva áskrift sem er hætt, færðu 409 Conflict svar vegna þess að þú getur ekki stöðvað áskrift sem er ekki í gangi.

Skilningur Webkrókur Outputs
Zebra getur gefið út webkrókar eru tvö gagnasnið.

• Standard Output
• Þessi framleiðsla inniheldur upplýsingar um skynjarann, verkefni, mikilvægan tímaamps, upplýsingar um hitastig og hvar frávikið var skráð. Tímabiliðamp vísar til tímansamp atburðarins, tímaritið Timestamp vísar til tímansamp þegar gögnunum var hlaðið upp.
  Mynd 7 Standard Webkrókur Output
• EPCIS úttak
  Þessi valkostur sýnir úttakið á GS1 EPCIS 2.0 sniði og gerir notandanum kleift að samþætta hitaviðvörun í EPCIS verkflæði.
  Mynd 8 EPCIS 2.0 Webkrókur Output

Birtir fulla atburðaskrá fyrir verkefnakenni

Þetta notkunartilvik gerir forriturum kleift að búa til ítarlegar skýrslur byggðar á öllu gagnasettinu úr verkefni. API fyrir þetta er Gagnaskýrslur fyrir rafræna hitaskynjara. Þú þarft fyrst að fá heimildartákn með einni af heimildaraðferðunum sem áður var lýst í þessari handbók.
Notkun þróunargáttarinnar gagnvirk skjöl
Eftirfarandi skref lýsa því hvernig á að nota Zebra Developer Portal gagnvirka skjölin.

1. Fáðu viðskiptavinalykilinn þinn af appsíðunni. Sjá Authentication-Simple Key fyrir frekari upplýsingar.
2. Farðu á skjalasíðuna á þróunargáttinni á developer.zebra.com/apis/analytics-and-reporting-temperature.
3. Smelltu á Heimilda.
4.  Límdu viðskiptavinalykilinn inn í reitinn sem er merktur ApiDeyAuth og smelltu á Heimilda.
5. Veldu /tasks/{taskId}/log endapunktinn til að fella niður skjölin.
6. Smelltu á Prófaðu það.
7. Sláðu inn verkefnakenni.
8. Smelltu á Framkvæma.
9.  Staðfestu að gagnasvarið sé svipað og svarið hér að neðan.

Flokkun, síun og síðuskipun
Lesa atburðaskrárþjónustan notar táknmiðaða blaðsíðugerð vegna hugsanlegs mjög mikils fjölda niðurstaðna. Sjálfgefin síðustærð er 100. Þú biður um fyrstu efnissíðuna og biður um stærð (fjöldi skynjunarviðburða) til að skila. Svör innihalda einnig tákn fyrir næstu síðu. Notaðu þennan tákn í næstu beiðni, mögulega með stærð, til að fá næsta sett af viðburðagögnum.

Notaðu API prófunartól
Eftirfarandi skref lýsa því hvernig á að nota API prófunartólið.

1. Farðu í uppáhalds API prófunartólið þitt. Fyrrverandiample neðan notar Postman, en einnig er hægt að nota önnur verkfæri.
2.  Sækja Yaml file frá þróunargáttinni.
3. Flytja inn Yaml file sem prófunarsvíta.
4. Breyttu taskID þannig að það sé gilt verkefni sem þú bjóst til. Afveljið upphafstíma og lokatíma.
5. Farðu á haus flipann og sláðu inn lykilapikey og virði apikey þinn frá skrefi 1.
6. Smelltu á Senda.
7. Staðfestu að svarið sé það sama og svarið sem þú fékkst í skrefi 0.
8. Breyttu upphafstíma og lokatíma eftir þörfum til að sía niðurstöðurnar innan ákveðins tímabils.
9. Í Postman, smelltu á Code Menu og veldu tungumálið fyrir forritið þitt.
10. Afritaðu og límdu kóðabútinn inn í forritskóðann þinn til að fullkomna samþættingu.

Að sækja AIDL Files

ZS300 ZSFinder appið styður Android Interface Definition Language (AIDL). Þetta gerir símtöl milli ZSFinder appsins og annarra Android forrita kleift.
AIDL skilgreinir viðmót sem útskýrir hvaða aðferðir eru tiltækar til að hringja í fjarstýringu. Viðskiptavinir bindast viðmótinu til að virkja samskipti. Þegar viðskiptavinurinn er bundinn við viðmótið getur hann hringt í ZSFinder appið. Þessi símtöl eru framkvæmd af ZSFinder appinu, sem leiðir til þess að annað hvort grípur til aðgerða eða skilar umbeðnum gögnum, svo sem gerð skynjara, rafhlöðustig, gagnaskrár eða viðvörunarstöðu.

Til að byrja:

1. Farðu á ZS300 stuðningssíðuna til að hlaða niður AIDL files. Þar á meðal eru Javadoc files sem innihalda heildar skjöl um studdu flokka og aðferðir.
2. Afritaðu alla AIDL pakkaskráruppbygginguna og AIDL files inn í app/src/main/aidl/ möppuna í biðlaraforritinu. Byrjaðu að byggja upp Android svo bekkurinn files er hægt að búa til. Flokkarnir verða ekki nothæfir fyrr en forritið hefur verið byggt.
3. Bættu eftirfarandi fyrirspurnarfærslu við AndroidManifest.xml inni í
   :

Android tækið verður að keyra ZSFinder APK með nauðsynlegum heimildum til að AIDL viðmótið virki rétt.

ATH: AIDL viðmótssímtöl ættu að fara fram á þræði sem er ekki notendaviðmót þannig að þau hafi ekki áhrif á afköst eða virkni forrita.

• Frekari upplýsingar um AIDL er að finna á developer.android.com/guide/components/aidl
• www.zebra.com

Skjöl / auðlindir

ZEBRA P1131383-02 Stjórnun og gagnaskýrslur fyrir rafræna hitaskynjara [pdfNotendahandbók P1131383-02 Stjórnun og gagnaskýrslur fyrir rafræna hitaskynjara, P1131383-02, Stjórnunar- og gagnaskýrslur fyrir rafræna hitaskynjara, Skýrslur fyrir rafræna hitaskynjara, fyrir rafræna hitaskynjara, rafræna hitaskynjara, hitaskynjara, skynjara

Heimildir

• Notendahandbók