Ndewo, unu niile. Anyị na-eji nwayọọ nwayọọ na-apụta site na onyinyo ma na-aga n'ihu na usoro isiokwu gbasara ngwaahịa anyị. Mgbe gara aga nyochaa akụkọ, anyị nwetara ọtụtụ nzaghachi (nke kachasị mma), aro na akụkọ ahụhụ. Taa, anyị ga-egosi TestMace na-arụ ọrụ na ị ga-enwe ike ịghọta ụfọdụ atụmatụ nke ngwa anyị. Maka imikpu zuru oke, ana m adụ gị ọdụ ka ị rụtụ aka na akwụkwọ anyị na http://docs-ru.testmace.com. Yabụ, ka anyị gaa!

ọnọdụ

Ka anyị malite na banality. Ngwa ahụ dị ma nwalee n'ezie na nyiwe atọ - Linux, Windows, MacOS. Ị nwere ike ibudata installer maka OS ị nwere mmasị na ya webụsaịtị anyị. Maka ndị ọrụ Linux ọ ga-ekwe omume ịwụnye ngwugwu snap. Anyị nwere olile anya na Ụlọ Ahịa Microsoft na Ụlọ Ahịa Ngwa ga-abịarute ya n'oge na-adịghị anya (Ọ dị mkpa? Gịnị ka i chere?).

Ọnọdụ nnwale

Anyị họọrọ ọnọdụ ọkọlọtọ a dị ka isiokwu ule anyị:

Nbanye: onye ọrụ - admin, paswọọdụ - paswọọdụ
tinye ọhụrụ ntinye
Ka anyị lelee na agbakwunyere ndekọ ahụ nke ọma

Anyị ga-anwale na https://testmace-quick-start.herokuapp.com/. Nke a bụ ihe nkịtị json-ihe nkesa, zuru oke maka ịnwale ngwa ndị dị otú ahụ. Anyị gbakwụnyere ikike site token n'okporo ụzọ json-sava niile wee mepụta usoro nbanye iji nweta akara ngosi a. Anyị ga-aga nke ọma, jiri nwayọọ nwayọọ na-emeziwanye ọrụ anyị.

Ịmepụta ọrụ na ịgbalị ịmepụta otu n'enweghị ikike

Mbụ, ka anyị mepụta ọrụ ọhụrụ (File->Ihe oru ohuru). Ọ bụrụ na ị na-ebupụta ngwa a na nke mbụ, ọrụ ọhụrụ ga-emeghe ozugbo. Mbụ, ka anyị gbalịa ime arịrịọ ka ịmepụta ndekọ ọhụrụ (ọ bụrụ na ịmepụta ndekọ dị na-enweghị ikike). Họrọ ihe dị na menu onodu ihe ọnụ Project Tinye ọnụ -> Arịrịọ Nzọụkwụ. Tọọ aha ọnụ na mepụta-post. N'ihi ya, a ga-emepụta oghere ọhụrụ na osisi ahụ na taabụ maka ọnụ ọnụ a ga-emeghe. Ka anyị tọọ paramita arịrịọ ndị a:

Ụdị arịrịọ: POST
url: https://testmace-quick-start.herokuapp.com/posts
Rịọ ozu: json nwere uru {"title": "New testmace quick start post"}
Ọ bụrụ na ịmere ihe niile nke ọma, interface ahụ ga-adị ka nke a:

Otú ọ dị, ọ bụrụ na anyị na-agbalị imezu arịrịọ ahụ, ihe nkesa ahụ ga-eweghachite koodu 401 na enweghị ikike anyị agaghị enweta ihe ọ bụla na ihe nkesa a. Ọfọn, n'ozuzu, dị ka a tụrụ anya ya).

Na-agbakwụnye arịrịọ ikike

Dịka ekwurula, anyị nwere njedebe POST /login, nke na-ewere json dị ka akụkụ arịrịọ nke ụdị: {"username": "<username>", "password": "<password>"}ebe username и password (ọzọ, site na paragraf mmeghe n'elu) nwere ihe ọ pụtara admin и password n'otu n'otu. Na nzaghachi, njedebe njedebe a na-alaghachi json dị ka {"token": "<token>"}. Anyị ga-eji ya maka ikike. Ka anyị mepụta Arịrịọ Nzọụkwụ ọnụ na aha banye, ga-eme ihe dị ka nna ochie Project ọnụ Iji ịdọrọ-na-dobe, bugharịa ọnụ e nyere n'ime osisi dị elu karịa ọnụ mepụta-post. Ka anyị tọọ paramita ndị a na arịrịọ emepụtara ọhụrụ:

Ụdị arịrịọ: POST
url: https://testmace-quick-start.herokuapp.com/login
Rịọ ozu: json nwere uru {"username": "admin", "password": "password"}

Ka anyị mee arịrịọ ahụ wee nweta koodu narị abụọ na akara ngosi na nzaghachi. Ihe dị ka nke a:

Ndozigharị: iwepu mbiputegharị ngalaba

Ruo ugbu a ejikọtaghị arịrịọ ndị ahụ n'ime otu edemede. Ma nke a abụghị nanị drawback. Ọ bụrụ na ị na-ele anya nke ọma, ị ga-achọpụta na ọ dịkarịa ala, a na-emegharị ngalaba ahụ na arịrịọ abụọ ahụ. Adịghị mma. Oge erugo imegharị akụkụ a nke edemede n'ọdịnihu, mgbanwe ga-enyere anyị aka na nke a.

Na mkpokọta nke mbụ, mgbanwe dị iche iche na-arụ otu ọrụ ahụ dị na ngwaọrụ ndị ọzọ yiri ya na asụsụ mmemme - na-ewepụ mbiputegharị, ịba ụba ọgụgụ, wdg. Ị nwere ike ịgụkwu gbasara mgbanwe na akwụkwọ anyị. N'okwu a, anyị ga-achọ mgbanwe ndị ọrụ.

Ka anyị kọwapụta mgbanwe na ọkwa ọnụ Project domain nwere ihe ọ pụtara https://testmace-quick-start.herokuapp.com. Maka nke a, ọ dị mkpa

Mepee taabụ na ọnụ ọnụ a wee pịa akara ngosi mgbako dị n'elu aka nri
Pịa na + gbakwunye mgbanwe
Tinye aha agbanwe agbanwe na uru
N'ọnọdụ anyị, mkparịta ụka nwere mgbanwe agbakwunyere ga-adị ka nke a:

Ọ DỊ MMA. Ugbu a, n'ihi ihe nketa, anyị nwere ike iji mgbanwe a na ụmụ nke ọkwa akwụkwụ ọ bụla. N'ọnọdụ anyị, ndị a bụ nodes banye и mepụta-post. Iji jiri mgbanwe na mpaghara ederede, ịkwesịrị ide ${<variable_name>}. Dịka ọmụmaatụ, a na-atụgharị url nbanye ka ọ bụrụ ${domain}/login, otu maka mepụta-post node url ga-adị ka ${domain}/posts.

Ya mere, n'ụkpụrụ DRY na-eduzi, anyị emeela ka ọnọdụ ahụ dịkwuo mma.

Chekwaa akara ngosi na mgbanwe

Ebe anyị na-ekwu maka mgbanwe, ka anyị gbasaa ntakịrị na isiokwu a. N'oge a, ọ bụrụ na nbanye nke ọma, anyị na-enweta site na ihe nkesa ikike, nke anyị ga-achọ na arịrịọ ndị ọzọ. Ka anyị chekwaa akara ngosi a ka ọ bụrụ mgbanwe. N'ihi na A ga-ekpebi uru nke mgbanwe ahụ n'oge a na-eme ihe ederede, anyị na-eji usoro pụrụ iche maka nke a - mgbanwe mgbanwe.

Mbụ, ka anyị mee arịrịọ nbanye. Na taabụ Ebugharị zaa, bugharịa cursor n'elu token na menu onodu (nke a na-akpọ ma ọ bụ jiri bọtịnụ òké aka nri ma ọ bụ site na ịpị bọtịnụ ...) họrọ ihe ahụ. Kenye na mgbanwe. Mkparịta ụka ga-apụta na mpaghara ndị a:

Ụzọ - kedu akụkụ nke azịza a na-ewere (n'ọnọdụ anyị ọ bụ body.token)
Uru dị ugbu a - kedu uru dị n'akụkụ ụzọ (n'ọnọdụ anyị nke a bụ uru akara)
Aha mgbanwe - aha nke agbanwe ebe Uru dị ugbu a a ga-echekwa ya. N'ọnọdụ anyị ọ ga-abụ token
ọnụ - n'ime ndị nna ochie ka a ga-emepụta mgbanwe Aha mgbanwe. Ka anyị họrọ Project

Mkparịta ụka emechara dị ka nke a:

Ugbu a, mgbe ọ bụla a na-egbu osisi ahụ banye mgbanwe mgbanwe token a ga-eji uru ọhụrụ emelite site na nzaghachi. A ga-echekwa mgbanwe a na ya Project ọnụ na, ekele maka ihe nketa, ga-adị maka ụmụ ụmụ.

Iji nweta mgbanwe dị ike, ị ga-ejirịrị arụnyere n'ime mgbanwe $dynamicVar. Dịka ọmụmaatụ, iji nweta akara ngosi echekwara, ịkwesịrị ịkpọ ${$dynamicVar.token}.

Anyị na-ebufe akara ikike n'ime arịrịọ

N'ime usoro ndị gara aga, anyị nwetara akara ikike na ihe anyị ga-eme bụ ịgbakwunye nkụnye eji isi mee Authorization nwere ihe ọ pụtara Bearer <tokenValue> na arịrịọ niile chọrọ ikike, gụnyere mepụta-post. Enwere ụzọ dị iche iche isi mee nke a:

Jiri aka detuo token ma gbakwunye nkụnye eji isi mee ikike na arịrịọ nke mmasị. Usoro a na-arụ ọrụ, mana iji ya na-ejedebe naanị na arịrịọ nke ụdị "mere na tụfuo". Ọdịghị mma maka mmezu nke edemede ugboro ugboro
Jiri ọrụ ahụ ikike.
Jiri nkụnye eji isi mee

Iji usoro nke abụọ dị ka ihe doro anya, ma n'ihe gbasara isiokwu a, usoro a bụ ... enweghị mmasị. Ọfọn, n'ezie: usoro ikike gbakwunyere mwepu maara gị nke ọma site na ngwaọrụ ndị ọzọ (ọbụlagodi na anyị nwere ihe ndị dị ka ihe nketa ikike) na o yighị ka ọ ga-ajụ ajụjụ.

Ihe ọzọ bụ ndabara nkụnye eji isi mee! Na nkenke, ndị nkụnye eji isi mee nke ndabara na-eketa nkụnye eji isi mee HTTP nke etinyere na arịrịọ a na ndabara ma ọ bụrụ na enwereghị nkwarụ. N'iji ọrụ a, ị nwere ike, dịka ọmụmaatụ, mejuputa ikike omenala ma ọ bụ wepụ naanị mbịgharị na edemede. Ka anyị jiri njirimara a nyefee akara n'ime nkụnye eji isi mee.

Na mbụ, anyị jiri akọ chekwaa akara ahụ na mgbanwe dị ike $dynamicVar.token na Project ọnụ larịị. Naanị ihe fọdụrụ bụ ime ihe ndị a:

Kọwaa aha ndabara Authorization nwere ihe ọ pụtara Bearer ${$dynamicVar.token} na Project ọnụ larịị. Iji mee nke a, na Project interface nke ọnụ, ị ga-emepe a dialog na ndabara isiokwu (bọtịnụ Isi ihe n'akụkụ aka nri elu) ma tinye aha kwekọrọ. Mkparịta ụka nwere ụkpụrụ juru eju ga-adị ka nke a:
Gbanyụọ nkụnye eji isi mee ihe site na arịrịọ nbanye. Nke a bụ ihe kwere nghọta: n'oge nbanye, anyị enwebeghị akara ma anyị ga-etinye ya na arịrịọ a. Ya mere, na nbanye interface nke arịrịọ na taabụ Isi ihe na mpaghara Ketara eketa gbanyụọ nkụnye eji isi mee ikike.

Ọ gwụla. Ugbu a, a ga-agbakwunye nkụnye eji ikike ikike na arịrịọ niile bụ ụmụaka nke ọnụ ụlọ ọrụ ahụ, ewezuga ọnụ ụzọ nbanye. Ọ na-apụta na n'oge a anyị enweelarị ederede dị njikere na ihe anyị ga-eme bụ ịmalite ya. Ị nwere ike ịme edemede ahụ site na ịhọrọ Run n'ime menu onodu onodu oru ngo.

Na-enyocha izi ezi nke okike post

N'oge a, edemede anyị nwere ike ịbanye ma jiri akara ikike mepụta biputere. Agbanyeghị, anyị kwesịrị ijide n'aka na post e mepụtara ọhụrụ nwere aha ziri ezi. Ya bụ, n'eziokwu, naanị ihe fọdụrụ bụ ime ihe ndị a:

Ziga arịrịọ iji nweta ozi site na id,
Lelee na aha enwetara n'aka ihe nkesa ahụ dabara aha ezitere mgbe ị na-eke ọkwa

Ka anyị leba anya na nzọụkwụ mbụ. Ebe ọ bụ na a na-ekpebi uru id n'oge a na-eme ihe ederede, ịkwesịrị ịmepụta mgbanwe dị ike (ka anyị kpọọ ya). postId) site na ọnụ mepụta-post na Project ọnụ larịị. Anyị amaralarị otu esi eme nke a, naanị rụtụ aka na ngalaba Chekwaa akara ngosi na mgbanwe. Naanị ihe fọdụrụ bụ ịmepụta arịrịọ iji nweta akwụkwọ ozi site na iji id a. Iji mee nke a, ka anyị mepụta RequestStep nweta-post na usoro ndị a:

Ụdị arịrịọ: GET
URL: ${domain}/posts/${$dynamicVar.postId}

Iji mejuputa nzọụkwụ nke abụọ, ọ dị anyị mkpa ịmara Nkwenye eriri. Ọnụ nkwuputa bụ ọnụ na-enye gị ohere ide ndenye ego maka arịrịọ akọwapụtara. Ọnụ nkwuputa ọ bụla nwere ike ịnwe ọtụtụ nkwenye (nleba anya). Ị nwere ike ịgụ karịa maka ụdị nkwuputa niile sitere na anyị akwụkwọ. Anyị ga-eji Compare nkwuputa ya na onye ọrụ equal. Enwere ụzọ dị iche iche iji mepụta nkwupụta:

Ogologo. Jiri aka mepụta ọnụ nkwuputa site na menu onodu nke ọnụ ụzọ arịrịọ arịrịọ. Na ọnụ nkwuputa nke emepụtara, gbakwunye nkwenye nke mmasị wee dejupụta ubi.
Ngwa ngwa. Mepụta ọnụ nkwuputa yana nkwuputa sitere na nzaghachi ọnụ RequestStep site na iji menu onodu

Ka anyị jiri usoro nke abụọ mee ihe. Nke a bụ ihe ọ ga-adị ka ikpe anyị.

Maka ndị na-aghọtaghị, nke a bụ ihe na-eme:

Rịọ arịrịọ n'ọnụ ọnụ nweta-post
Na taabụ Ebugharị zaa, kpọọ menu onodu wee họrọ Mepụta nkwuputa -> Tụlee -> nhata

Ekele, anyị ekepụtala ule mbụ anyị! Dị mfe, ọ́ bụghị ya? Ugbu a, ị nwere ike na-agba ọsọ script kpamkpam na-enwe n'ihi na ya. Naanị ihe fọdụrụ bụ imegharị ya ntakịrị wee wepụ ya title n'ime mgbanwe dị iche. Mana anyị ga-ahapụrụ gị nke a ka ọrụ ụlọ)

nkwubi

N'ime ntuziaka a, anyị mepụtara ọnọdụ zuru oke ma n'otu oge ahụ nyochaa ụfọdụ njirimara nke ngwaahịa anyị. N'ezie, anyị ejighị ọrụ niile na n'isiokwu ndị na-esonụ anyị ga-enye nkọwa zuru ezu nke ike nke TestMace. Nọrọ na-ekiri!

PS Maka ndị dị umengwụ imegharị usoro niile, anyị ejirila obiọma dekọọ ebe nchekwa na oru ngo si n'isiokwu. Ị nwere ike iji ya mepee ya File -> Mepee oru ngo wee họrọ folda Project.

isi: www.habr.com

TestMace. Mmalite ngwa ngwa