# Oktul Work Item Macro for Confluence Näita Jira pileteid Confluence'i lehel, iga väli veeruna. Makro loetleb piletid, mille JQL-päring tagastab, lehele vajalikes veergudes ja näitab igaüht nii, nagu see on Jiras lehe avamise hetkel. Iga päring tehakse lehe lugeja nimel, nii et Jira otsustab, mida iga lugeja näeb. Assetsi objektid on kiipidena, Work Item Selectori väljad piletikaartidena ning tabel jõuab ka PDF- ja Wordi-eksporti. - **Toode:** Confluence Cloud - **Versioon:** v2.0.0 - **Dokumentatsioon:** https://oktul.com/docs/plugins/work-item-macro/install/ ## Confluence'i enda Jira makro jätab Assetsi objektid välja Teenuse- või varameeskonna olekuleht räägib asjadest, millele piletid viitavad: serveritest, sülearvutitest ja lepingutest, mida hoitakse Jira Service Managementi Assetsis. Confluence Cloudi sisseehitatud Jira makro Assetsi väljade väärtusi ei näita. Atlassian on selle kirja pannud ettepanekuna CONFCLOUD-80484, mis kogub huvi alates 2025. aasta jaanuarist. Möödapääs on Jira ekspordist kleebitud tabel. See on aegunud kleepimise hetkel ja näitab igale lugejale seda, mida nägi eksportija. ## Neli asja, mida makro Confluence'i lehel teeb Kõik seadistused on makrol endal, nii et kaks tabelit samal lehel võivad näidata eri pileteid, veerge ja valikuid. ### Iga Jira väli võib olla veerg Veeru valikus on iga saidi väli, ka kohandatud väljad ja teiste rakenduste väljad. Igal veerul on selle väljatüübi jaoks vajalikud kuvavalikud: olek märgise või tekstina, inimesed kaardi või nimena, kuupäevad kuupäeva või suhtelise ajana, arvud komakohtade ja ühikuga. ### Assetsi objektid kiipidena Assetsi väli näitab iga objekti selle objektitüübi ikooni, objektile viitava nime ja võtmega või sinu valitud atribuudiga. Oktul Work Item Selector for Jira väljad on samade piletikaartidena, mida see rakendus Jiras näitab. ### Tabel PDF-is, Wordis ja e-kirjas PDF- ja Wordi-eksport, lehe ajalugu ja teavituskirjad sisaldavad loendit Confluence'i tabelina, kuni 300 piletit. Lingid töötavad ka väljaspool Confluence'i. Eksport tehakse selle inimese nimel, kellele see koostatakse. ### Muuda pileteid lehelt lahkumata Advanced-versioonis muudavad lugejad välju otse tabelis: teksti, kuupäevi, valikuid, inimesi, hinnanguid, olekut, Assetsi objekte ja vormindatud teksti. Iga muudatus salvestatakse lugeja nimel, nii et Jira rakendab tema õigusi, ekraane ja valideerimist. ## Rakenduste paigaldamine toimub toote kaudu, mida juba haldad 1. **Paigalda Marketplace'ist** Rakendus paigaldatakse Confluence'i ja ühendatakse sama saidi Jiraga Atlassiani enda paigaldusaknas. See töötab täielikult Atlassian Forge'is. 2. **Lisa makro lehele** Muuda lehte ja kirjuta /oktul. Makro on Confluence'i enda lisamismenüüs. 3. **Kirjuta JQL-päring ja vali veerud** Iga JQL, mida Jira aktsepteerib, järjestus ORDER BY abil. Uus makro alustab veergudega Key, Summary ja Status. 4. **Luba soovi korral muutmine tabelis** Advanced-versioonis üks lüliti makro kohta (vaikimisi väljas) ja üks veeru kohta. ## Platvorm ja ühilduvus - **Toode:** Confluence Cloud - **Vajab ka:** Jira Cloudi samal saidil - **Platvorm:** Atlassian Forge - **Versioonid:** Standard ning muutmisega Advanced ## Midagi ei lahku sinu Atlassiani saidilt Makro loeb Jirat lehe vaataja nimel tema brauserist ega hoia midagi alles. Ainus salvestatud teave on iga makro seadistus, mida Confluence hoiab lehel. - **Andmete väljumine:** Puudub. Rakendus ei deklareeri väliseid hoste - **Andmete talletamine:** Makro seadistus sinu Confluence'i lehel - **Vahemälu:** Puudub. Iga lehe vaatamine loeb Jirat uuesti - **Oktuli taristu:** Puudub - **Alltöötlejad:** Ainult Atlassian, kes majutab rakendust Forge'is - **Analüütika või telemeetria:** Ei koguta **Õigus / Milleks see on** - `read:jira-work` — Käivitab makro JQL-päringu, loeb iga rea väljad ja laadib tabelis muutmiseks vajaliku. - `write:jira-work` — Salvestab tabelis tehtud muudatuse või olekumuutuse vaataja nimel, Advanced-versioonis. - `read:cmdb-object:jira` — Kuvab Assetsi objekti nime järgi ja otsib objekte tabelis muutmisel. - `read:cmdb-icon:jira` — Loeb Assetsi eelmääratud ikoonide nimed, et iga objekti kiip kuvaks oma ikooni. **Runs on Atlassian.** Atlassian annab selle märgi rakenduse kaupa nendele rakendustele, mis hoiavad andmeid ainult Atlassiani infrastruktuuril ega deklareeri väliseid hoste. [Mida programm nõuab](https://developer.atlassian.com/platform/marketplace/runs-on-atlassian/) ## Testid, mille iga väljalase peab läbima - **Automaattesti:** 277. Iga väljatüüp, muutmisviis ja ekspordi tee. - **Testikomplekti:** 9. Väljatüübid, laadimine, tabel, muutmine, eksport ja kuupäevad. - **Piletit ekspordis:** 300. Eksport peatub seal, et lõppeda Forge'i 25-sekundilise piiri sees. ## Peamised küsimused teistelt administraatoritelt ### Kes saab rakenduse paigaldada? Saidi administraator, Atlassian Marketplace'i lingilt. Rakendus paigaldatakse Confluence'i ja ühendatakse sama saidi Jiraga. Kuna rakendus ei deklareeri väliseid õigusi, pole väliste andmete jaoks nõusolekuekraani. Forge'i rakendusel võib pärast paigaldust kuluda kuni minut, enne kui see kättesaadavaks muutub. ### Kas see vajab Jirat? Jah. Jira Cloud peab olema Confluence'iga samal Atlassiani saidil ja rakendus mõlemaga ühendatud. Ilma Jirata saab makro lehele lisada, kuid tal pole pileteid, mida näidata. ### Kas lugeja näeb pileteid, mida ta Jiras avada ei tohi? Ei. Otsing tehakse lehe lugeja nimel tema Jira õigustega, nii et sama lehe kaks lugejat võivad näha eri ridu. Eksport ja teavituskirjad koostatakse selle inimese nimel, kellele need on mõeldud. ### Mida lisab Advanced-versioon? Muutmise otse tabelis. Lugejad muudavad välju tabelis enda nimel ning Jira rakendab iga muudatuse puhul nende õigusi, ekraane ja valideerimist. Muutmine on igas makros väljas, kuni lehe toimetaja selle sisse lülitab. Kõik muu on mõlemas versioonis. ### Mis juhtub meie andmetega, kui rakenduse eemaldame? Midagi ei kao, sest rakendus ei salvesta midagi enda juurde. Iga makro seadistus jääb oma lehele, kus Confluence seda hoiab. Piletid olid alati Jiras. ### Kas seda rakendust toetatakse ka siis, kui Atlassian platvormi muudab? Jah. Hoiame ennast pidevalt muudatustega kursis ja toetame muudatusi ökosüsteemis enne nende ametlikku väljalaset tänu partner staatusele. Kui sellegipoolest esineb probleeme või muresid, ootame vastavat teadet abikeskuse kaudu ja lahendame probleemi vastavalt teenustaseme kokkuleppele (SLA). --- ## Väljaandja - Oktul OÜ - Oktul OÜ · Registrikood 17589681 · Tallinn, Harjumaa, Eesti - E-post: hello@oktul.com - Veeb: https://oktul.com/ - Atlassian Marketplace: https://marketplace.atlassian.com/vendors/534484195 - LinkedIn: https://www.linkedin.com/company/oktul - YouTube: https://www.youtube.com/@OktulDevelopment - Inglise keeles: https://oktul.com/