# Oktul Regex Field for Jira

Jira väljad, mis täidavad end vormi põhjal ja lubavad ainult sinu vormingut.

Kaks kohandatud välja tüüpi, üherealine ja vormindatud lõik. Need täidavad end loomise vaates, portaali päringuvormil ja üleminekul Smart Value'de põhjal, mis toovad inimese, kuupäeva, ruumi ja vormi teised väljad, ning järgivad neid välju sisestamise ajal. Iga väärtust kontrollib Jira iga salvestamise juures välja konteksti reeglite järgi. Range sisestusega lisab telefoninumbri väli riigikoodi ja tühikud ise.

- **Toode:** Jira Cloud
- **Versioon:** v3.1.0
- **Dokumentatsioon:** https://oktul.com/docs/plugins/regex-field/
- **Video:** https://oktul.com/et/videos/regex-field/

## Jira väli ei oska end vormi põhjal täita ega oma vormingut hoida

### Jira väli avaneb ühe kindla vaikeväärtusega

See ei saa alata teataja nime, ruumi või kokkuvõttesse just kirjutatuga. Inimesed kirjutavad uuesti, mida vorm juba teab, ja automaatikareegel saab välja täita alles siis, kui pilet on olemas.

### Koodid ja telefoninumbrid tulevad igas vormingus

Ühes väärtuses on tühikud, teises sidekriipsud, kolmandas riigikood. JQL ei leia neid usaldusväärselt ja automaatikareegel ei saa nende põhjal tegutseda.

### Töövoo valideerija ei näe importi ega REST API-t

Jira enda tekstiväljadel pole vormingu- ega pikkusereeglit. Valideerija kontrollib ainult üleminekul, nii et REST API või impordi kaudu kirjutatud väärtus läheb sellest mööda.

### Jira kontrollib väärtust iga kirjutamise juures, olenemata kirjutajast

Oktul Regex Field for Jira lisab väljatüübid, mis täidavad end vormi põhjal ja millel on oma reeglid. Jira kontrollib neid välja enda valideerimises. Üherealine väli oskab valed märgid ka sisestamisel keelata.

## Neli asja, mida väljad teevad

Iga reegel seatakse välja konteksti kaupa, nii et üks väli võib eri projektides järgida eri reegleid.

### Eeltäitmine

Väli avaneb täidetuna loomise vaates, portaali päringuvormil ja üleminekul. Selle mall kasutab Smart Value'sid: inimene, kuupäev, ruum, piletitüüp ja vormi mis tahes teine väli. https://oktul.com/docs/plugins/regex-field/prefill/

### Valideerimisreeglid

Lihtsad reeglid seavad pikkuse, vormingu nagu 999-9999, lubatud märgid, ning selle, millega väärtus algab, lõpeb või mida see sisaldab. Täpsem on üks regulaaravaldis, mida brauser ja Jira loevad ühtemoodi. Ettevaateid ja tagasiviiteid ei toetata. https://oktul.com/docs/plugins/regex-field/configure/#rules-simple

### Range sisestus

Range sisestusega ei saa reeglitega lubamata märke sisestada ja kindlad märgid lisatakse ise. Vormingu 999-9999 korral saab sisestusest 1234567 väärtus 123-4567 ja kleebitud väärtus vormindatakse samamoodi. https://oktul.com/docs/plugins/regex-field/configure/#input-single-line-only

### Vormindatud lõik

Lõiguväli kasutab Atlassiani enda redaktorit ning kontrollib oma lihtteksti pikkuse, lubatud märkide või mustri järgi. Portaali päringuvormil on see lihtne tekstikast, sest kliendiportaal ei paku rakendustele Jira vormindatud teksti redaktorit. https://oktul.com/docs/plugins/regex-field/configure/#show-the-paragraph-field-under-description

### Väärtused, mida agent leiab täpselt

Kui välja kõigil väärtustel on üks kuju, leiab tehisintellekti agent, JQL-päring või automaatikareegel need ära arvamata. Jira lükkab kõik muu igal salvestamisel tagasi, ka automaatikast ja REST API-st tulevad kirjutised. Rakendus ei käita ühtegi tehisintellekti mudelit ega saada midagi ühelegi mudelile.

### Kõik võimalused

**Reeglid**

- [Lihtsad reeglid](https://oktul.com/docs/plugins/regex-field/configure/#rules-simple)
- [Regulaaravaldised](https://oktul.com/docs/plugins/regex-field/configure/#rules-advanced)
- [Veateade](https://oktul.com/docs/plugins/regex-field/configure/#error-message)
- [Ulatus ja piirangud](https://oktul.com/docs/plugins/regex-field/configure/#scope-and-limits)

**Sisestus**

- [Range sisestus](https://oktul.com/docs/plugins/regex-field/configure/#input-single-line-only)
- [Lõik kirjelduse all](https://oktul.com/docs/plugins/regex-field/configure/#show-the-paragraph-field-under-description)

**Eeltäitmine**

- [Mida mall sisaldada võib](https://oktul.com/docs/plugins/regex-field/prefill/#what-a-template-can-hold)
- [Hoia sünkroonis](https://oktul.com/docs/plugins/regex-field/prefill/#keep-in-sync)
- [Kus väli täitub](https://oktul.com/docs/plugins/regex-field/prefill/#where-it-fills-in)

**Jira**

- [Automaatika ja töövood](https://oktul.com/docs/plugins/regex-field/configure/#automation-and-workflows)

## Võrdlus teiste Jira regulaaravaldise väljadega

Iga rida on üks funktsioon. Rakendus saab linnukese ainult siis, kui teeb kõike, mida rida kirjeldab. Kui ta teeb sellest osa, on lahtris kirjas, mis puudu jääb.

| Funktsioon | Oktul Regex Field for Jira (Oktul) | [RegEx & Picker Fields](https://marketplace.atlassian.com/apps/1237076/regex-custom-fields) (MOY Apps) | [Custom Fields Suite](https://marketplace.atlassian.com/apps/1224654/multilevel-select-for-jira-cascading-select-custom-field) (Appsvio) |
| --- | --- | --- | --- |
| Tasuta | Jah | Ei | Ei |
| Runs on Atlassian | Jah | Jah | Jah |
| Täitub vormilt ise | Jah | Ei | Osaliselt: Eraldi kirjutuskaitstud väli |
| Vormindab kirjutamise ajal | Jah | Ei | Ei |
| Vormindatud tekst reeglitega | Jah | Ei | Ei |
| Töötab klientide portaalis | Jah | Jah | Jah |

Kontrollitud 21.10.2026 iga toote avaldatud dokumentatsiooni ja Marketplace'i kirje põhjal. Kriips tähendab, et funktsiooni pole kummaski. Kui mõni rida ei vasta enam tegelikkusele, kirjuta aadressile hello@oktul.com ja kontrollime selle üle.

- **Tasuta:** Atlassian Marketplace'is igas saidi suuruses tasuta, kõigi võimalustega ja ilma tasulise väljaandeta. Kuidas Regex Field seda teeb: https://oktul.com/docs/plugins/regex-field/
- **Runs on Atlassian:** Märk, mille Atlassian annab Marketplace'i kirjes rakenduse kaupa neile rakendustele, mis hoiavad andmeid ainult Atlassiani sees ega deklareeri väliseid hoste. Kuidas Regex Field seda teeb: https://oktul.com/docs/plugins/regex-field/privacy/#4-where-the-data-is-stored
- **Täitub vormilt ise:** Väli avaneb täidetuna kasutaja, kuupäeva, ruumi ja vormi teiste väljade põhjal ning järgib neid välju, kui inimesed kirjutavad. Kuidas Regex Field seda teeb: https://oktul.com/docs/plugins/regex-field/prefill/
- **Vormindab kirjutamise ajal:** Märke, mida reeglid ei luba, ei saa sisestada, ning fikseeritud märgid, näiteks sidekriipsud või riigikood, lisatakse inimese eest. Kuidas Regex Field seda teeb: https://oktul.com/docs/plugins/regex-field/configure/#input-single-line-only
- **Vormindatud tekst reeglitega:** Vormindatud tekstiväli Atlassiani enda redaktoris, mille lihtteksti kontrollitakse pikkuse, lubatud märkide või mustri järgi. Kuidas Regex Field seda teeb: https://oktul.com/docs/plugins/regex-field/configure/
- **Töötab klientide portaalis:** Kliendid täidavad välja, kui esitavad Jira Service Managementi portaalis päringu, ja reeglid kehtivad ka seal. Kuidas Regex Field seda teeb: https://oktul.com/docs/plugins/regex-field/prefill/#where-it-fills-in

## Hind võrreldes alternatiividega

USD kuus ühe pilvesaidi kohta, üks instants, iga rakenduse Atlassian Marketplace'i hinnakirja järgi seisuga 21.10.2026. Oktuli tasulised rakendused on kuni 10 kasutajaga tasuta ja Atlassian esitab arve saidi enda Atlassiani arvel.

| Rakendus | Tootja | Kasutaja kohta, 11–100 kasutajat | 100 kasutajat | 1000 kasutajat | 10 000 kasutajat |
| --- | --- | --- | --- | --- | --- |
| Oktul Regex Field for Jira | Oktul | Tasuta | Tasuta | Tasuta | Tasuta |
| [RegEx & Picker Fields](https://marketplace.atlassian.com/apps/1237076/regex-custom-fields) | MOY Apps | 0,25 USD | 25,00 USD | 250,00 USD | 2175,00 USD |

- Odavam kui RegEx & Picker Fields igas suuruses kuni 10 000 kasutajani.

**Miks.** Tasuta, ja igal saidil on kõik võimalused: reeglid, range sisestus, lõiguväli, JQL-otsing ja eeltäitmine. Tasulist väljaannet pole.

## Sinu turvaülevaatuseks

**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/)

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

[Loe hinnangut STAR-registris](https://cloudsecurityalliance.org/star/registry/oktul-ou/services/oktul-regex-field-for-jira)

## Testid, mille iga uus versioon peab läbima

- **Automaattesti:** 555. Mustrite parser, range sisestus, iga lihtne reegel, redaktorid ja seadete vaade.
- **Testikomplekti:** 20. Üks neist käivitab Jira valideerimisavaldised ise ja võrdleb neid brauseri kontrollidega.

## Rakenduste paigaldamine toimub toote kaudu, mida juba haldad

1. **Paigalda Marketplace'ist** Saidi administraator paigaldab selle ja kinnitab kuus õigust, igaüks allpool koos põhjusega. Kaks neist on Jira seadistuse õigused, mida Jira nõuab välja reeglite lugemiseks.
2. **Loo väli** Ava Jira seadetes Fields ja loo väli tüübiga Oktul Regex Field (üherealine) või Oktul Regex Field (lõik). Väli lubab mis tahes väärtust, kuni sellel on reegel.
3. **Sea reeglid** Vali välja konteksti seadetes Lihtne või Täpsem ja proovi väärtusi enne salvestamist testkastis. Kast nimetab iga reegli, mida väärtus rikub.
4. **Kirjuta teade** Kirjuta, milline on õige väärtus, või jäta vaiketeade, mida igaüks näeb oma keeles.

## Platvorm ja ühilduvus

- **Toode:** Jira Cloud ja Jira Service Management Cloud
- **Platvorm:** Atlassian Forge
- **Keeled:** Inglise ja eesti
- **Andmete residentsus:** Sinu saidi oma

## Peamised küsimused teistelt administraatoritelt

### Kuidas täita Jira välju dünaamiliselt portaalis või loomise vaates?

Oktul Regex Fieldi tüüpi väljaga. Kirjuta välja konteksti eeltäitmisse mall Smart Value'dega: {{user.displayName}}, {{user.email}}, {{user.accountId}}, {{today}}, {{today.iso}}, {{now}}, {{project.key}}, {{project.name}} ja {{issueType.name}}. Vormi mis tahes teist välja saab kasutada id või nime järgi, näiteks {{summary}}, {{customfield_10070}} või {{Kulukeskus}}, ja samuti osa selle väärtusest, näiteks {{Reporter.emailAddress}}. Väli täitub loomise vaates, portaali päringuvormil ja üleminekul. See järgib nimetatud välju, kuni inimene seda muudab, ja jääb tühjaks, kui väärtus rikuks selle reegleid. See täidab oma välja, mitte Jira teisi välju. Assetsi välju ei saa veel kasutada, sest Jira ei anna ühtki neist rakenduse UI-muudatusele (FRGE-2079).

### Kuidas kontrollida Jira tekstivälja regulaaravaldisega?

Jira Cloudi enda tekstiväljadel regulaaravaldise reeglit pole. Loo väli tüübiga Oktul Regex Field (üherealine), ava selle konteksti seaded, vali Täpsem ja sisesta muster. Seejärel kontrollib Jira iga väärtust salvestamisel, olgu see vaatest, REST API-st, impordist või automaatikast, ning näitab sinu teadet, kui väärtus ei sobi.

### Kas Jira väli oskab telefoninumbrit või koodi sisestamise ajal vormindada?

Jah, üherealine väli oskab. Sea vorming, näiteks 999-9999, ja lülita sisse range sisestus. Sobimatud märgid keelatakse ja kindlad märgid lisatakse ise, nii et 1234567 muutub kujule 123-4567. Range sisestus töötab seal, kus Jira näitab rakenduse redaktorit. Jira Forms, mobiilirakendused ja impordid kasutavad tavalist tekstikasti ning reeglid kehtivad seal salvestamisel.

### Mida uus väli lubab?

Kõike, kuni sellel on reegel. See, kas väli on kohustuslik, jääb Jira enda seadeks Required.

### Kas välju saab JQL-iga otsida?

Jah, nagu teisi tekstivälju, operaatoritega =, ~ ja IS EMPTY. Lõiguvälja lihtteksti otsitakse .text abil, nii ei leita kunagi kogemata vorminduse järgi.

### Kui palju see maksab?

Mitte midagi. Rakendus on Marketplace'is tasuta ja igal saidil on kõik võimalused: reeglid, range sisestus, lõiguväli, JQL-otsing ja eeltäitmine.

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

Rakendus ei salvesta midagi enda tarbeks. Väljade väärtusi ja reegleid hoiab Jira nagu iga kohandatud välja puhul.

### Kust saan abi?

Esita päring Oktuli abikeskuses või kirjuta aadressil support@oktul.com. Mõlemal juhul tekib viitenumbriga päring.

---

## 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/