# Work Item Selector for Jira Cloud

Võimalda kasutajatel valida pileteid Jira päringukeele (JQL) alusel.

Ühe- või mitmikvalikuga väli, mis pakub ainult neid pileteid, mille JQL-päring tagastab, ja see JQL võib kasutada dünaamilisi väärtusi nii väljal muudatusi tegeva kasutaja kui ka pileti kohta, millel väli asub. Rakendus toetab täpsemat otsingut, automatsioone, töövoo valideerimist ja Jira olemasolevat piletite linkimist, kõike seda Atlassiani disainiga.

- **Host:** Jira Cloud
- **Version:** v3.0.0
- **Documentation:** https://oktul.com/docs/plugins/work-item-selector/install/

## Olemasolev piletite linkimine nõuab lingi tüüpi ja pakub kasutajale iga piletit, mida kasutaja näeb.

Jira enda piletite linkimine on kogu instantsi skoobiga. Pileteid omavahel linkides on võimalik seost luua iga pileti vahel mida kasutajal on õigus näha ning ei ole võimalik piirata seoste kogust. Tihtipeale on instantsides kümneid tuhandeid pileteid, mis tekitab otsinguprobleemi ja vähendab kasutajakogemust.

Ainus võimalus seni oli kasutada sedasama linki ja loota, et see toimib. Puudu oli väli, mille otsingu ulatus on välja, mitte instantsi põhine.

## Neli asja, mida see teeb ja sisseehitatud link ei tee.

Igat välja on võimalik individuaalselt konfigureerida, ilma et peaks kokku leppima globaalsetes seadistustes. Kaks välja ühel piletil võivad käituda täiesti erinevalt. Seadistuste tegemiseks on administraatorile mõeldud loomulikud seadistuskohad ehk väljade seadistamine toimub juba tuttava välja konteksti all, töövoo validaatorite lisamine töövoo seadistuse all ja automatiseerimine olemasoleva Automation saki all projektis.

### Sea otsingu ulatus JQL-iga

Jira administraator seab JQL-i iga välja kontekstis ja see JQL võib kasutada dünaamilisi väärtusi nii väljal muudatusi tegeva kasutaja kui ka pileti enda kohta, millel väli asub.

### Näita välju, mis teevad valiku selgeks

Üks kuni seitse veergu valitud pileti kaartidel: töö tüüp, võti, kokkuvõte, prioriteet, olek, omanik ja kohandatud väljad. Piisav, et kasutaja eristaks kaht sarnast piletit kumbagi avamata.

### Loetav ja muudetav ülejäänud Jirast

Automatsiooni tegevused seavad välja väärtuse ja rakendus lisab JQL-funktsioonid, nii, et välja saab filtreerida, tahvlile panna ja raporteerida üle projektide nagu iga teist Jira andmet. Väli võimaldab olemasoleva automaatikaga väärtuste muutmist, lisaks lisab välja spetsiifilised smart value'd ehk dünaamilised väärtused mille abil saab välja väärtust lugeda ja automatiseerda. Lisaks lisab rakendus Jirasse JQL funktsioonid, mille abil on võimalik erinevaid seoseid piletite vahel hõlbsamalt otsida ja filtreerida.

### Nõua välja täitmist enne staatuse muudatust

Töövoo valideerija peatab staatuse muudatuse seni, kuni valik vastab sinu seatud reeglitele: valik on tehtud, valitud piletid on lubatud staatustes, need kuuluvad lubatud projektidesse ja valik ei tekita ringseost tagasi sama pileti juurde. Administraator kirjutab ise teate, mida blokeeritud kasutaja näeb.

## Iga samm toimub tootes, mida sa niikuinii haldad.

1. **Paigalda Marketplace'ist** Paigaldamine ja seadistusvaated on needsamad Atlassiani omad, mida sa juba kasutad. Pole vaja midagi ise majutada, sest rakendus töötab Forge'il sinu Atlassian Cloudi saidi sees.
2. **Loo väli** Jira administraator loob välja valides soovitud tüübi: Work Item Selector (Single Select) või Work Item Selector (Multi Select).
3. **Määra skoop välja kontekstis** Millist JQL-i väli otsib, millised veerud ilmuvad valitud piletitel ja kas väli arvestab kasutaja õigusi või ignoreerib neid. Kõik see Jira enda seadetes.
4. **Lisa väli ekraanile** Seaded, siis Work items, siis ekraaniskeemid, mida vastavad töötüübid kasutavad, täpselt nii nagu iga teise Jira kohandatud välja puhul.

## Peamine toode ja ühilduvus.

- **Peamine toode:** Jira Cloud
- **Platvorm:** Atlassian Forge
- **Automatsioon:** Toetatud
- **Andmete asukoht:** Sinu enda keskkonnas

## Midagi ei lahku sinu Atlassiani keskkonnast.

Rakendus töötab sinu Atlassian Cloudi keskkonna sees ja väärtused, mida see salvestab, jäävad sinna. Meie ega ükski kolmas osapool ei saa neid lugeda.

- **Andmete väljumine:** Puudub.
- **Andmete talletamine:** Andmed talletatakse eksklusiivselt sinu instantsil
- **Oktuli osalus:** Oktul ei saa kuidagi kokku puutuda Sinu andmetega
- **Alltöötlejad:** Puuduvad
- **Analüütika või telemeetria:** Ei koguta

**Õigus / Milleks see on**

- `read:jira-work` — Käivita JQL-i skoobi päring ja loe välju, mida iga pileti kaart kuvab.
- `write:jira-work` — Salvesta valik, hoia seoste indeksit ja hoia Jira enda piletite link sammus.
- `read:jira-user` — Kuva omaniku ja teised kasutajaveerud avataridena.
- `manage:jira-configuration` — Loe välja konteksti seadistust ja saidi väljade kataloogi. See on kõige laiem õigus ja privaatsuspoliitika selgitab, miks see pole veel kitsam variant.
- `storage:app` — Talleta iga välja konteksti oma seadistus.
- `read:cmdb-object:jira` — Lahenda Assetsi objekt selle nimetuseks, et seda saaks veeruna kuvada. Iga päring on vabatahtlik ja ebaõnnestub vaikselt, seega Assetsita saiti see ei puuduta.
- `read:servicedesk-request` — Tuvasta kliendina, millised päringud on selle inimese omad Jira Service Managementi portaalis, sest portaali kliendil pole Jira rakenduse ligipääsu.

**Runs on Atlassian.** Atlassian annab selle märgi rakenduse kaupa rakendustele, mis salvestavad andmeid ainult Atlassiani sees ja ei deklareeri väliseid õigusi.

[Mida programm nõuab](https://developer.atlassian.com/platform/marketplace/runs-on-atlassian/)

**CSA STAR Level 1.** See rakendus on kantud Cloud Security Alliance'i STAR-registrisse tasemel 1. See on enesehindamine: täitsime CAIQ Lite'i küsimustiku, kõik 138 küsimust, ja avaldasime selle kõigile lugemiseks.

[Loe hinnangut STAR-registris](https://cloudsecurityalliance.org/star/registry/oktul-llc/services/work-item-selector-for-jira-cloud-issue-picker)

## Mis töötab enne selle rakenduse ilmumist.

- **Automatiseeritud testi:** 843. Käivitatakse igal väljalaskel, sh turvatestid.
- **Testikomplekti:** 36. Käitumine, seadistus, õigused ja sisendi käsitlus.
- **Piletit välja kohta:** 100. Piir tuleb Atlassian Forge'i platvormist, mitte meilt.

## Piirangud, kohe funktsiooni kõrval, mida need piiravad.

Kui mõni neist on sinu seadistuse jaoks oluline, on parem see siit leida kui pärast paigaldamist.

### Mitu piletit mahub ühele väljale?

Kuni 100. Piir tuleb Atlassian Forge'i platvormist, mitte meie valikust. Kui sinu kasutusjuhul on vaja rohkem kui 100 ühel väljal, see rakendus seda ei tee.

### Kas see töötab Data Centeris või Serveris?

Ei. See on Forge-rakendus ja Forge on ainult Cloud. Data Centeri versiooni pole ja seda pole ka tegevuskavas.

### Miks välja rippmenüü näitab lihtteksti, mitte ikoone?

Sest Atlassiani UI Kiti Select aktsepteerib valiku väärtusena ainult stringi, seega ei saa töö tüübi ikooni, oleku silti ega avatari menüü sees joonistada. Veerud on selle asemel ühendatud keskpunktiga. Rikkalikum kujundus ilmub valitud pileti kaartidel, kus komponent seda võimaldab. See on hind Atlassiani enda komponentide kasutamise eest kohandatud liidese asemel, et säilitada Atlassiani disaini.

### Kas JQL-i ulatus on õiguste piir?

Mitte omaette. JQL määrab, milliseid pileteid väli pakub, mitte seda, mida kasutajal on lubatud näha. Administraator saab välja konteksti seada nii, et see arvestab iga kasutaja õigusi, ja kui see nii seatud ei ole, näeb iga kasutaja iga piletit, mille JQL tagastab, olenemata tema enda õigustest.

## Mida administraatorid enne paigaldamist küsivad.

### Kes peab selle paigaldama?

Organisatsiooni administraator, Atlassian Marketplace'i kirje pealt. Kuna rakendus ei deklareeri väliseid õigusi, pole väliste andmete nõusolekuekraani. Forge-rakendusel võib pärast paigaldust kuluda kuni minut, enne kui see kogu saidil kättesaadavaks muutub.

### Mis juhtub meie andmetega, kui me rakenduse eemaldame?

Eemaldamine kustutab välja tüübi ja sellel salvestatud väärtused koos sellega, täpselt nagu iga teise Jira kohandatud väljaga. See on Jira käitumine, mitte meie oma, ja me ei saa neid pärast taastada, mistõttu dokumentatsioon soovitab need enne eksportida.

### Kas see asendab Jira enda piletite linke?

Ei. See on kohandatud väli nende kõrval, nii et olemasolevad lingid töötavad edasi ja midagi pole vaja migreerida. Kasuta sisseehitatud linki, kui soovid otsingut üle kogu keskkonna, ja seda välja, kui ulatus peab olema välja, mitte keskkonna omadus.

### Kas seda rakendust toetatakse ka siis, kui Atlassian platvormi muudab?

Jah, just seda tugi katabki. Probleemid lähevad meie Help Centeri kaudu, kus päring saab viite ja teenustaseme kokkuleppe (SLA), mis vastamisaega mõõdab, ja sama kanal võtab vastu ka funktsioonisoovid ja demode broneeringud.

---

## Väljaandja

- Oktul OÜ (Oktul LLC)
- Oktul OÜ · Registrikood 17589681 · Tallinn, Harjumaa, Eesti
- Email: hello@oktul.com
- Web: https://oktul.com/
- Atlassian Marketplace: https://marketplace.atlassian.com/vendors/534484195
- English: https://oktul.com/