Work Items

Work Items upravlja tipizirane delovne elemente – epic, feature, story, task, bug – z obveznim modelom stanj, tipiziranimi razmerji, zgodovino in urejevalnikom, ki sočasne spremembe zavrne, namesto da bi jih zlil. To je osrednji paket zbirke: table, poizvedbe in nadzorna plošča dobijo elemente od tu. Namenjen je sodelujočim v projektu, ki delo zajemajo in ga premikajo naprej.

Prvi koraki

Hitri začetek: ustvarjanje prvega delovnega elementa – najkrajša pot do prvega rezultata, v treh korakih.

Ustvarite element → Nastavite razmerje → Shranite posnetek v wiki

Pogosta opravila

Kaj želite	Za koga	Kje to naredite	Navodilo
ustvariti delovni element	sodelujoči v projektu	`do=wkdoworkitems_new` na strani projekta	Namen
urediti delovni element	sodelujoči v projektu	`do=wkdoworkitems_edit`	Namen
nastaviti razmerje med dvema elementoma	sodelujoči v projektu	urejevalnik	Razmerja: zadošča ena smer
razumeti, zakaj je shranjevanje zavrnjeno	sodelujoči v projektu	–	Sočasnost
shraniti element kot stran wikija	sodelujoči v projektu	urejevalnik	Posnetki v wikiju
ugotoviti, zakaj nekdo ne sme urejati	upravitelji	–	Pravice
videti elemente kot kartice	sodelujoči v projektu	–	Boards

Odprt delovni element ima zgoraj tip in številko, desno Shrani in skok v Azure DevOps. Zavihki ločijo polja, povezave in zgodovino; levo je opis, desno lastnosti, ki jih spremenite brez menjave strani.

Namen

Tipizirani delovni elementi z obveznim modelom stanj in tipiziranimi razmerji, poleg tega urejevalnik s preverjanjem pravic, zgodovino in optimističnim preverjanjem sočasnosti ter izvoz posnetka, ki v wikiju pusti samostojno berljivo stran.

To je osrednji paket zbirke DWDO: Boards, Queries in Dashboard od tu dobijo svoje elemente, stanja, tipe in polja. Brez tega vtičnika drugi trije nimajo česa prikazati.

Delovni element vedno pripada projektu (glejte DevOps Core); ta meja se uveljavlja, ne predpostavlja. Shranjevanje zagotavlja Vtičnik DevOps Storage.

Razmerja: zadošča ena smer

Razmerja so tipizirana, pri usmerjenem razmerju pa je treba navesti samo eno smer – nasprotna smer se zapiše samodejno. Povezava se tako z obeh koncev bere pravilno, ne da bi kdo isto stvar vnašal dvakrat.

Pred vsakim zapisom varovalo preveri in zavrne:

razmerje elementa s samim seboj
krog
par, ki ga besedišče razmerij ne dovoljuje

Sočasnost: zavrnitev namesto zlivanja

Shranjevanje, katerega izhodišče se je medtem spremenilo, je zavrnjeno, namesto da bi prepisalo delo nekoga drugega. Preverjata se dva signala: oznaka različice in prstni odtis polj.

Samodejnega zlivanja namenoma ni. Zlivanje prostih besedilnih polj ustvari besedilo, ki ga ni napisal nihče. Zavrnitev skupaj s seznamom polj, ki so se dejansko spremenila, je pošten odgovor – nato odloči človek.

Koda, ki zavrnitev obravnava, sporoči spremenjena polja in shranjevanja ne ponovi s svežim izhodiščem; to bi bilo natanko tisto prepisovanje, ki ga preverjanje preprečuje.

Posnetki v wikiju

Opis je mogoče izvoziti kot stran wikija, kadar naj bo berljiv sam zase. Povzetek revizije ima pri tem predpono, privzeto [WI].

Posnetek je izvoz, ne pogled v živo. Ko se delovni element spremeni, se posnetek ne posodobi.

Nastavitve

Nastavitev	Privzeto	Pomen
`historylimit`	`100`	Vrstice revizijske sledi v pogledu zgodovine. Omejuje prikaz, ne zapisovanja
`enabledirtyguard`	`1`	Opozorilo ob neshranjenih spremembah; zgolj izboljšava, brez skripta izostane samo opozorilo
`descrawmode`	`escape`	Zaščita opisa v posnetkih: `escape` ali `nowiki`
`exportsummaryprefix`	`[WI]`	Predpona povzetka revizije izvoženih strani
`maxrenderpeers`	`200`	Zgornja meja prikazanih razmerij in podrejenih elementov

descrawmode zahteva odločitev, ne privzete vrednosti. Katera vrednost je pravilna, je odvisno od tega, ali so opisi zaupanja vredna proza ali poljubno besedilo, ki se ne sme razlagati kot oznake. Nastavitev učinkuje ob izvozu: že izvožene strani ohranijo svojo obliko, ko jo spremenite.

maxrenderpeers je prav tako zaščita pred preobremenitvijo kot meja prikaza. Element s stotinami neposrednih sosedov navadno kaže na manjkajočo vmesno raven, ne na prenizko mejo.

Pravice

Vsako opravilo preveri pripadnost projektu. Množična opravila imajo lastno zagotovilo, ker je seznam oznak prav mesto, kjer bi tuja oznaka neopazno zdrsnila skozi.
Vsaka sprememba ima izvajalca, zato jo je v revizijski sledi mogoče pripisati.

Predpogoji

PHP 8.2 ali novejši.
Core, DevOps Core za kontekst projekta in vloge, Vtičnik DevOps Storage za delovne elemente, razmerja, revizijsko sled in nastavitve.
Sprememba sheme ni potrebna – priloženi repozitoriji že zagotavljajo vse, kar ta vtičnik uporablja.
Projekt mora obstajati že prej.

Meje

Samodejnega zlivanja ni, izrecno – glejte zgoraj.
maxrenderpeers skrajša prikaz, ne podatkov.
Opozorilo ob neshranjenih spremembah potrebuje skripte. Brez skripta obrazec deluje enako; manjka samo opozorilo.
Posnetki se ne posodabljajo sami.

Podatki o paketu

Vtičnik: wkdoworkitems
Imenski prostor: lib/plugins/wkdoworkitems/
Avtor: Wolfgang van der Stille Wolfgang.van.der.Stille@gmail.com (The White Knight Labs)
Licenca: GPL 2