Atlassian Jira Cloud -yhdistin
Atlassian Jira Cloud integrointi
Atlassian Jira Cloud -yhdistin
Atlassian Jira Cloud integrointi
Atlassian Jira Cloud -yhdistin
Atlassian Jira Cloud -yhdistintä (entinen Jira Connector) käytetään tietojen (käyttäjä, ryhmät, tiketti) lukemiseen ja kirjoittamiseen asiakkaan Atlassian Jira Cloud -ratkaisuun.
Atlassian Jira Cloud -liitin vaatii konfiguroinnin asiakkaan käyttötapauksen mukaan, ja periaatteessa konfiguroinnissa on kolme (3) vaihetta:
- Yhdistimen määrittäminen – mahdollistaa yhdistimen yhteyden muodostamisen asiakkaan Atlassian Jira Cloud
- Ajoitetun tehtävän määrittäminen – käytetään, kun tietoja luetaan asiakkaan Atlassian Jira Cloud
- Tapahtuman määrittäminen - tehtävää käytetään, kun tietoja kirjoitetaan asiakkaan Atlassian Jira Cloud
- Myös työnkulun orkestrointisolmut on konfiguroitava.
- Myös työnkulun orkestrointisolmut on konfiguroitava.

2024.2 ja uudemmat ohjeet
Yleiset toiminnot
Liittimet - yleiset toiminnot
Liittimet - yleiset toiminnot
Tässä artikkelissa kuvataan yleisiä toimintoja natiivien liittimien hallintaan ratkaisussa. Kaikkia natiiveja liittimiä hallitaan samasta liittimien hallintakäyttöliittymästä.
Huomaa, että jokaiselle liittimelle on omat kuvauksensa, joissa liittimen toiminnot ja konfigurointiohjeet on kuvattu yksityiskohtaisesti.
Päästäkseen liittimien hallintaan käyttäjällä on oltava järjestelmänvalvojan tason oikeudet asiakkaan alustan määrityksiin. Kun käyttöoikeudet on myönnetty oikein, liittimien välilehti tulee näkyviin ja käyttäjä voi hallita liittimiä.

Vasen valikko
Liittimien hallinta on jaettu neljään välilehteen:

- Yleiskatsaus – natiivien liittimien luomiseen ja päivittämiseen. Järjestelmänvalvoja voi nähdä niiden tilan, tyypin ja kuinka monta ajoitettua tai tapahtumatehtävää niihin liittyy.
- Todennus – todennustehtävien luomiseen ja päivittämiseen. Todennuksen Pro tarvitaan, jotta Secure Access voi määrittää, mitkä asiakkaiden loppukäyttäjät voivat käyttää Matrix42 Core , Pro and IGA -kirjautumissivua.
- Lokit – Native Connector- ja Secure Access -lokien lataamiseen käyttöliittymästä.
- Asetukset – yleiset asetukset natiiveille liittimille ja Secure Access , mukaan lukien lokinkirjauksen ja valvonnan ympäristötyyppi.
Liittimien yleiskatsausvälilehti
Yleiskatsaussivulta käyttäjä voi helposti ja nopeasti nähdä kaikkien liittimien tilan.

Yläpalkki:
- Natiiviliittimien (EPE) tila
- Vihreä teksti osoittaa, että Native Connectors on verkossa. Kaikki tarvittavat palvelut ovat toiminnassa.
- Punainen teksti osoittaa, että natiiviliittimissä on ongelma, eivätkä kaikki palvelut ole käynnissä.
- Secure Access tila ( ESA )
- Vihreä teksti osoittaa, että Secure Access on verkossa. Kaikki tarvittavat palvelut ovat käytettävissä.
- Punainen teksti osoittaa, että Secure Access on ongelma eikä mikään palvelut ole käynnissä.
- Natiiviliittimien versionumero näkyy oikeassa yläkulmassa
Listanäkymän yläpalkki:

- Uusi liitin - avaa uuden ikkunan uuden liittimen lisäämistä ja määrittämistä varten
- Poista yhdistin(et) - työnkulkuviittaukset lasketaan ja näkyviin tulee ponnahdusikkuna poiston vahvistamiseksi (huomaa, että viittausten laskeminen voi kestää useita sekunteja)
- Vienti - Ylläpitäjä voi viedä yhden tai useamman liittimen (ja tehtävän) ympäristöstä. Yleensä käytetään liittimien ja liittimien (ja tehtävien) viemiseen testiympäristöstä tuotantoympäristöön. Natiivien liittimien salaiset tiedot on suojattu salasanalla.
- Tuonti – Ylläpitäjä voi tuoda yhden tai useamman liittimen (ja tehtävän) ympäristöön. Yleensä käytetään liittimien (ja tehtävien) tuomiseen testistä tuotantoympäristöön.
- Ylläpitäjä ei voi tuoda tietoja vanhasta EPE-käyttöliittymästä (vanhempi kuin 2024.1) uuteen. Lähde- ja kohdeympäristöjen versioiden on oltava samat.
- Tuonti epäonnistuu, jos määritykset (mallit, määritteet) eivät ole samat – esimerkiksi jos jokin määrite puuttuu.
- Jos tuot jotain, jolla on samat liittimen tiedot, se yhdistetään olemassa olevan liittimen alle.
- Päivitä – Ylläpitäjä voi päivittää yhdistinnäkymän napsauttamalla painiketta .
Yleiskatsaus luettelonäkymässä,

- Valitse liittimet - Valitse yksi liitin napsauttamalla liitinrivin edessä olevaa valintaruutua tai napsauta otsikkorivin valintaruutua, jolloin kaikki liittimet valitaan.
- Id - Liittimen automaattisesti luotu yksilöllinen tunnus. Sitä ei voi muokata tai muuttaa.
- Tila - ilmaisee ajoitetun tehtävän tilan
-
Vihreä valintamerkki - Tehtävä suoritetaan ilman virheitä
-
Punainen risti - Tehtävä on suoritettu, mutta on tapahtunut virhe
-
Harmaa kello - Tehtävää ei ole vielä suoritettu, odotetaan ajoitusta -
Oranssi - yhdessä tehtävistä on ongelma
- Ei arvoa - Ajoitettu tehtäväpohjainen tieto puuttuu
-
- Nimi - Liittimen nimi lisätty liittimen asetuksiin. Yhden tietolähteen kokoonpanoa sisältävän liittimen yksilöllinen nimi.
- Tyyppi - osoittaa kohde-/lähdejärjestelmän
- Ajoitettu - kertoo, kuinka monta ajoitettua tehtävää on määritetty
- Tapahtuma - kertoo, kuinka monta tapahtumatehtävää on määritetty
- Hallitse
- Kynäkuvake - avaa yhdistimen asetukset (yhdistimen rivin kaksoisnapsauttaminen avaa myös asetukset)
- Paperikuvake - kopioi liittimen
- Pysäytä - työnkulkuviittaukset lasketaan ja näkyviin tulee ponnahdusikkuna poiston vahvistamiseksi
- Haku - Käyttäjä voi hakea liitintä kirjoittamalla hakusanan vastaavaan kenttään. Haku voidaan tehdä kentistä Tunnus, Tila, Nimi, Tyyppi, Aikataulutettu ja Tapahtuma.
Ajoitetun tehtävän tiedot (napsauta yhdistimen edessä olevaa nuolta)
Kun napsautat yhdistinrivin alussa olevaa nuolta, kaikki asiaankuuluvat ajoitetut tehtävät ja tapahtumatehtävät tulevat näkyviin.

Yläpalkki ajoitetuille tehtäville
- Uusi tehtävä - avaa uuden tehtävän määrityssivun
- Poista tehtävä(t) - poistaa valitut tehtävät järjestelmästä, eikä niitä voida enää palauttaa.
- Päivitä - päivitä ajoitettujen tehtävien näkymä
- Haku – käyttäjä voi hakea tehtäviä kirjoittamalla hakusanan vastaavaan kenttään, kuten Tunnus, Nimi, Käytössä tai Poiminnan/Lataamisen tila.
Ajoitettujen tehtävien luettelonäkymä

- Valitse tehtävä(t) - Valitse poistettava tehtävä luettelonäkymästä rastittamalla se.
- Id - Tehtävän yksilöllinen tunniste. Luodaan automaattisesti, eikä sitä voi muuttaa.
- Nimi - Tehtävän nimi lisätty tehtäväasetuksiin, tehtävän yksilöivä nimi.
- Käytössä - Näyttää, onko tehtävä ajoitettu vai ei
-
Vihreä valintamerkki - Tehtävä on ajoitettu
-
Punainen Risti - Tehtävää ei ole ajoitettu
-
- Poiminnan tila – Näyttää kohdehakemistosta/järjestelmästä poimitun tiedon tilan
-
Vihreä valintamerkki - tiedot on purettu onnistuneesti
-
Punainen risti - tiedot on poimittu virheellisesti tai poiminta epäonnistui
-
Kello - Tehtävä odottaa suoritusta
-
- Lataustila - Näyttää datan viennin tilan JSON-tiedostosta asiakkaan ratkaisuun
-
Vihreä valintamerkki - tiedot on tuotu onnistuneesti asiakkaan ratkaisuun
-
Punainen risti - tietojen tuonnissa on virheitä tai tuonti epäonnistui
-
- Hallitse
- Kynäkuvake - avaa tehtävän asetukset omaan ikkunaansa (tehtävärivin kaksoisnapsauttaminen avaa myös tehtävän asetukset)
- Paperikuvake - kopioi tehtävän
- Kellokuvake - avaa tehtävähistorianäkymän
- Pysäytä - poista tehtävä, ponnahdusikkuna avautuu poiston vahvistamiseksi
Ajoitettujen tehtävien historianäkymä
Napsauttamalla ajoitettujen tehtävien rivillä olevaa kellokuvaketta saat näkyviin ajoituksen historian.

Katseluhistorian yläpalkki
- Päivitä - päivittää ajoitetun tehtävän tilan. Tämä ei vaikuta tehtävään, vaan päivittää käyttöliittymän näyttämään tehtävän suorituksen uusimmat tiedot.
Ajoitettujen tehtävien historian luettelonäkymä
- Rivin väri ilmaisee tilan
-
Vihreä - tehtävä suoritettu onnistuneesti
-
Punainen - suorituksen aikana tapahtui virhe
-
- Suoritustunnus – ajoitetun tehtävärivin yksilöivä tunnus
- Suunniteltu purkuaika - milloin seuraava purku hakemistosta/sovelluksesta on ajoitettu tapahtumaan
- Poiminnan valmistumisaika - milloin poiminta valmistui
- Purkamisen tila - hakemistosta/sovelluksesta haettavien tietojen tila
- Kuorman aloitusaika - milloin seuraava lataus asiakkaalle on ajoitettu tapahtumaan
- Kuormauksen valmistumisaika - milloin kuormitus on valmis
- Lataustila - tiedon lataustila asiakasratkaisuun
Ajoitettujen tehtävien tilan luettelonäkymä
- Todellinen aloitusaika - todellisen aloituksen aikaleima
- Käyttäjätiedosto - JSON-tiedosto, joka sisältää hakemistosta/sovelluksesta luetut käyttäjätiedot
- Ryhmätiedosto - JSON-tiedosto, joka sisältää hakemistosta/sovelluksesta luetut ryhmätiedot
- Yleinen tiedosto - JSON-tiedosto, joka sisältää hakemistosta/sovelluksesta luettuja yleisiä tietoja
- Poimi tiedot - yksityiskohtaisia tietoja tietojen lukemisesta hakemistosta/sovelluksesta
- Lataustiedot - yksityiskohtaiset tiedot tietojen lataamisesta asiakkaille Matrix42 Core , Pro and IGA -ratkaisussa
Ajoitetun tehtävän muokkausikkuna
Ajoitetun tehtävän määritykset voidaan avata napsauttamalla kynäkuvaketta tai kaksoisnapsauttamalla tehtäväriviä.
Vasemmanpuoleinen valikko ja ominaisuudet vaihtelevat valittujen asetusten mukaan, joten tarkemmat ohjeet tehtävien muokkaamiseen löytyvät liittimen kuvauksesta, mutta kaikille ajoitetuille tehtäville on yhteisiä toimintoja, jotka on kuvattu alla.

Tehtävän tallentaminen
Jos tehtävästä puuttuu pakollisia tietoja, hiiren vieminen tallennuspainikkeen päälle näyttää, mitkä ominaisuudet ovat vielä tyhjiä.
Yläpalkki ajoitetun tehtävän muokkaamista varten
- Suorita tehtävä manuaalisesti - ylläpitäjä voi suorittaa tehtävän manuaalisesti määritetyn aikataulun ulkopuolella
- Pysäytä tehtävä - ylläpitäjä voi pysäyttää parhaillaan käynnissä olevan ajoitetun tehtävän. Tehtävä pysäytetään ja sen tilaksi muutetaan pysäytetty. Se odottaa tässä tilassa seuraavaa ajastusta.
- Tyhjennä datavälimuisti - Käyttäjien ja ryhmien seuraavan käyttöönoton datavälimuisti tyhjennetään. Tämä tarkoittaa, että seuraava suoritus suoritetaan ensimmäisenä suorituksena.
- Oletusarvoisesti tyhjennämme välimuistin joka päivä klo 00:00 UTC
- Jos haluat tyhjentää välimuistin eri aikoina, sen on määritettävä jokin eri arvo isäntätiedostossa 'custom.properties'.
- EPE-välimuisti tyhjennetään myös, kun EPE käynnistetään uudelleen, koko ympäristö käynnistetään uudelleen tai EPE-määrityksiä on muutettu.
Tapahtuman tehtävän tiedot
Kun napsautat yhdistinrivin alussa olevaa nuolta, kaikki asiaankuuluvat ajoitetut tehtävät ja tapahtumatehtävät tulevat näkyviin.

Tapahtumatehtävien yläpalkki
- Uusi tehtävä - avaa uuden tapahtumatehtävän määrityssivun
- Poista tehtävä(t) - poistaa valitut tehtävät, näkyviin tulee ponnahdusikkuna poiston vahvistamiseksi
- Päivitä – päivittää tapahtuman tehtävänäkymän
- Näytä työnkulkuviittaukset - laskee tehtäviin liittyvät työnkulkujen suhteet ja tilat. Tämä on erittäin hyödyllistä, jos et tiedä, mistä työnkuluista tapahtumapohjaisia tehtäviä käytetään.
Tapahtumatehtävien luettelonäkymä
- Valitse tehtävä(t) - Valitse poistettava tehtävä luettelonäkymästä rastittamalla se.
- Id - Tehtävän yksilöllinen tunniste. Luodaan automaattisesti, eikä sitä voi muuttaa.
- Nimi - Tehtävän nimi lisätty tehtäväasetuksiin, tehtävän yksilöivä nimi.
- Työnkulkusuhteet
- Kysymysmerkki näyttää ponnahdusikkunan, jossa on yksityiskohtaisia tietoja viitteestä
- Työnkulun tila
- Ei käytössä - Ei yhteyksiä työnkulkuun
- Käytössä - Työnkulku(t) on liitetty tehtävään, tehtävää ei voi poistaa
- Hallitse
- Kynäkuvake - avaa tehtävän asetukset omaan ikkunaan
- Paperikuvake - kopioi tehtävän
- Pysäytä-kuvake - poistaa tehtävän, näkyviin tulee ponnahdusikkuna poiston vahvistamiseksi
Tapahtumatehtävän muokkausikkuna
Tapahtumatehtävän määritykset voidaan avata napsauttamalla kynäkuvaketta tai kaksoisnapsauttamalla tehtäväriviä.
Vasemmanpuoleinen valikko ja ominaisuudet vaihtelevat valittujen asetusten mukaan, joten tarkemmat ohjeet muokkaustehtäviin löytyvät liittimen kuvauksesta, mutta kaikille tapahtumatehtäville on yhteisiä toimintoja, jotka on kuvattu alla.

Muokkaa tapahtumaa -tehtäväikkuna
- Tehtävän käyttö, muokattavissa? - tämä tulee näkyviin, kun olemassa olevan tehtävän muokkaaminen ja tehtävän käyttötyypin muuttaminen rikkoo työnkulut
- Määritysten tyyppi, muokattavissa? - Tämä tulee näkyviin, kun muokataan olemassa olevaa tehtävää ja määritysten tyypin muuttaminen rikkoo työnkulut
Tehtävän tallentaminen
Jos tehtävästä puuttuu pakollisia tietoja, hiiren vieminen tallennuspainikkeen päälle näyttää, mitkä ominaisuudet ovat vielä tyhjiä.
Todennus-välilehti
Matrix42 Core , Pro and IGA ratkaisujen todennus määritetään todennusvälilehdeltä. Huomaa, että vain osa liittimistä (hakemistoliittimet) tukee todennusta, joten todennustehtäviä ei ole mahdollista luoda kaikille käytettävissä oleville liittimille.

Yläpalkki todennusta varten
- Uusi liitin - avaa uuden ikkunan uuden liittimen määrittämiseen (huomaa, että kaikki liittimet eivät tue todennusta)
- Poista yhdistin(et) - poistaa valitut tehtävät, näkyviin tulee ponnahdusikkuna poiston vahvistamiseksi
- Vienti - käyttäjä voi viedä yhden tai useamman tehtävän ympäristöstä. Yleensä käytetään tehtävien vientiin testiympäristöstä tuotantoympäristöön. EPE-liittimet on suojattu salasanalla.
- Huomaa, että todennustehtävien aluetta ei viedä, se on määritettävä manuaalisesti tuonnin jälkeen.
- Tuonti - käyttäjä voi tuoda yhden tai useamman tehtävän ympäristöön. Yleensä käytetään tehtävien tuomiseen testistä tuotantoympäristöön.
- Päivitä – päivittää todennustehtävien näkymän
Todennuksen yleiskatsauksen luettelonäkymä
- Valitse liittimet - Valitse yksi liitin napsauttamalla liitinrivin edessä olevaa valintaruutua tai napsauta otsikkorivin valintaruutua, jolloin kaikki liittimet valitaan.
- Id - Liittimen automaattisesti luotu yksilöllinen tunnus. Sitä ei voi muokata tai muuttaa.
- Nimi - Liittimen nimi lisätty liittimen asetuksiin. Yhden tietolähteen kokoonpanoa sisältävän liittimen yksilöllinen nimi.
- Tyyppi - osoittaa kohde-/lähdejärjestelmän
- Määrä - kertoo, kuinka monta todennustehtävää on määritetty
- Hallitse
- Kynäkuvake - avaa todennustehtävän asetukset omaan ikkunaansa
- Paperikuvake - kopioi tehtävän
- Pysäytä-kuvake - poistaa valitun tehtävän
Todennustehtävän tiedot
Kun napsautat yhdistinrivin alussa olevaa nuolta, kaikki asiaankuuluvat ajoitetut ja tapahtumatehtävät tulevat näkyviin.

Yläpalkki todennuksen yleiskatsaukseen
- Luo uusi tehtävä - avaa uuden todennustehtävän määrityssivun
- Poista tehtävä(t) - poistaa valitut tehtävät, näkyviin tulee ponnahdusikkuna poiston vahvistamiseksi
- Päivitä – päivittää todennustehtävien näkymän
Listanäkymä todennuksen yleiskatsaukseen,
- Valitse tehtävä(t) - Valitse poistettava tehtävä luettelonäkymästä rastittamalla se.
- Id - Tehtävän yksilöllinen tunniste. Luodaan automaattisesti, eikä sitä voi muuttaa.
- Nimi - Tehtävän nimi lisätty tehtäväasetuksiin, tehtävän yksilöivä nimi.
- Hallitse
- Kynäkuvake - avaa tehtävän asetukset omaan ikkunaansa (tehtävärivin kaksoisnapsauttaminen avaa myös asetusikkunan)
- Paperikuvake - kopioi tehtävän
- Pysäytä-kuvake - poistaa tehtävän, näkyviin tulee ponnahdusikkuna poiston vahvistamiseksi
Lokit-välilehti
Lokit-välilehdellä voi ladata käyttöliittymästä Native Connector- ja Secure Access -lokeja yksityiskohtaista vianmääritystä varten.

- epe-master -lokit - sisältää varoitus-, virhe- ja virheilmoituksia natiiveista liittimistä sekä tietoa siitä, kuinka kauan tehtäviin liittyviä toimia on suoritettu.
- epe-worker-ad lokit - Sisältää Active Directory -liittimen tilan tiedot (mitä Native Connector lataa asiakkaan Matrix42 Core , Pro and IGA ratkaisuun). Jos valinta on tyhjä, hakemisto ei ole käytössä tässä ympäristössä.
- epe-worker-azure -lokit - sisältää Entra ID :n tilatiedot (mitä Native Connector lataa asiakkaan Matrix42 Core , Pro and IGA ratkaisuun). Jos valinta on tyhjä, hakemisto ei ole käytössä tässä ympäristössä.
- epe-worker-ldap lokit - sisältää LDAP:n tilatiedot (mitä Native Connector lataa asiakkaan Matrix42 Core , Pro and IGA ratkaisuun). Jos valinta on tyhjä, hakemisto ei ole käytössä tässä ympäristössä.
- epe-laukaisujen lokit - sisältää tietoa EPE-laukaisuista
- datapump-itsm-l ogs - Sisältää tietoa datan viennistä asiakkaille Matrix42 Core , Pro and IGA ratkaisuissa.
- esa -lokit - Sisältää tietoa Secure Access -todennuksesta.
Asetukset-välilehti
Asetukset-välilehtiä käytetään yhdistimiä sisältävien ympäristöjen valvontaan.

- Ympäristötyyppi - on pakollinen valinta ja tietoja käytetään esimerkiksi hälytyksen kriittiseen määrittelyyn.
- Testi – valitse tämä, kun ympäristöäsi käytetään testiympäristönä
- Pro d - valitse tämä, kun ympäristöäsi käytetään tuotantoympäristönä
- Demo – valitse tämä, kun ympäristöäsi käytetään demo- tai harjoitusympäristönä
- Kehittäjä – valitse tämä, kun ympäristöäsi käytetään kehitysympäristönä
Mitä me valvomme?
- Aikataulun mukaisen provisioinnin epäonnistumiset (tietojen poimiminen, tietojen vienti ESM:ään, vanhentuneet varmenteet, virheelliset salasanat, virheellinen hakukanta/suodatin, virheelliset määritykset jne.)
- Tapahtumapohjaisen provisioinnin epäonnistumiset ( AD / Azure kirjoittaminen jne. epäonnistuu)
- Tapahtumapohjainen valmistelu – mitä liittimiä käytetään tietojen kirjoittamiseen sovelluksiin/hakemistoihin.
- ESA yli kymmenen epäonnistunutta kirjautumisyritystä yhdelle käyttäjälle viimeisen kolmen päivän aikana
- Ympäristötyyppi - on pakollinen valinta ja tietoja käytetään esimerkiksi hälytyksen kriittiseen määrittelyyn.
Tietojen migraatiot
Älä napsauta ”Siirrä attribuuttimääritykset” tai ”Siirrä työnkulut”, ellei Matrix42 pyydä sinua tekemään niin.
Jira Cloud -liittimen määrittäminen
Uuden Jira-liittimen luominen
Käyttöönoton määrittämiseen tarvitset pääsyn Efecte Platformin määrityskonsoliin.
1. Avaa Efecte-hallinta-alue (ratassymboli).
2. Avaa Yhdistimet-näkymä.
3. Valitse Uusi yhdistin 
4. Valitse tietolähteen tyypiksi Atlassian Jira

5. Täytä Jira- ratkaisuun liittyvät tiedot
- Liittimen nimi – anna liittimellesi käyttäjäystävällinen nimi (nimeä voi muuttaa jälkikäteen)
- Isännän URL-osoite - isäntäosoite, jota käytetään yhteyden muodostamiseen Efecte-ratkaisuun
- Käyttäjänimi - Jiran tekninen käyttäjätunnus
- Käyttöoikeustunnus -

6. Täytä Efecte- ratkaisuun liittyvät tiedot
- Web API -käyttäjä - Efecte-ratkaisun Web API -käyttäjätunnus
- Luettelo kaikista Efecten paikallisista käyttäjistä
- Web API -salasana - Efecte solutions Web API -käyttäjien salasana

7. Tallenna liittimen tiedot.
7. Kun olet tallentanut liittimen tiedot, voit painaa testaa yhteyttä -painiketta ja testata, voiko liitin muodostaa yhteyden kohde-Efecte-ratkaisuun.
9. Jos muokkaat olemassa olevien liittimien tietoja, muista tallentaa muutokset ja testata yhteyttä sen jälkeen.
Ajoitetun tehtävän määrittäminen tietojen lukemista varten
Jira-liitintä käytetään käyttäjä-, ryhmä- ja tikettitietojen lukemiseen Jirasta, ja se konfiguroidaan Efecten alustalla luomalla aikataulutettuja liitintehtäviä.
Uuden ajoitettuun tehtävään perustuvan tehtävän luominen
Aikataulutettujen liitäntätehtävien määrittämiseen tarvitset pääsyn Efecte Platformin määrityskonsoliin. Huom! Jos liitäntää ei ole luotu, sinun on ensin luotava ”uusi liitäntä” ja sen jälkeen voit luoda uusia tehtäviä.
1. Avaa Efecte Platformin määritysnäkymä (ratassymboli).
2. Avaa Yhdistimet-näkymä.
3. Valitse ajoitettujen tehtävien yhdistin ja valitse uusi tehtävä

4. Määritä tehtävän ajoitus (suoritetaanko ajoitettu tehtävä säännöllisesti ja miten). Valitse ajoitusjärjestys, joka riippuu siitä, kuinka paljon dataa luetaan asiakkaalle Efecte-ratkaisussa.

5. Täytä tehtävän tiedot
- Täytä ajoitettuun tehtävään yksilöivä nimi. Huomaa, että nimeä ei voi muuttaa jälkikäteen.
- Tehtävän käyttö osoittaa, että kyseessä on tehtävä, jota käytetään tietojen lukemiseen tai kirjoittamiseen. Huomaa, että jos tapahtumatyyppiä muutetaan jälkikäteen, se voi rikkoa työnkulut.
- Yhdistämistyyppi riippuu siitä, minkä tyyppistä tietoa hakemistosta luetaan.
- Identiteetti ja käyttöoikeudet – käytetään, kun Jira-käyttäjien ja -ryhmien tietoja luetaan sovelluksesta
- Yksittäinen (vain identiteetti) – käytetään, kun asiakkaiden Jira-tiedoista luetaan vain Jira-käyttäjän tietoja.
- Yksittäinen (vain käyttöoikeus) – käytetään, kun asiakkaiden Jira-tiedoista luetaan vain Jira-ryhmän tietoja
- Yleiset (yksi mallipohja) – käytetään, kun muita Jira-kohteita luetaan asiakkaiden Jirasta, kuten esimerkiksi tarinoita, tukipyyntöjä, bugeja jne.
- Jira-kysely -

6. Täytä virhetiedot. Valinnaiset virheiden käsittelyasetukset. Jos ajoitettu tehtävä epäonnistuu, Efecte-ratkaisuun voidaan luoda datakortti, joka näyttää virheen. Jos virheasetukset on määritetty, järjestelmänvalvojan ei tarvitse tarkistaa ajoitettujen tehtävien tilaa manuaalisesti.
- Virhemalli - Valitse datakortin malli, joka luodaan, jos datan luvun aikana ilmenee virheitä (yhteys tietolähteisiin, aikakatkaisut jne.).
- Vikakansio - Valitse kansio, johon vikatietokortti on tallennettu.
- Virheattribuutti – Valitse attribuutti, johon virhemallissa virhetiedot tallennetaan.

7. Täytä vastaavuudet
Kohdemallin ja -kansion, datasourceid:n ja yksilöllisen id:n arvot on pakko asettaa. Näitä arvoja käytetään datan tunnistamiseen asiakkaiden Jira- ja Efecte-ratkaisujen välillä.
- Kohdemalli – Valitse malli määrittääksesi attribuuttimääritykset
- Kohdekansio - Valitse kansio kansioluettelosta. Luetteloa rajataan vastaamaan yhteensopivuutta valitun mallin kanssa.
- Voit asettaa lisää Jirasta luettavia määritteitä valitsemalla Uusi attribuutti.
- Ominaisuusmääritykset
- Efecte-mallin attribuutti - mihin attribuuttiin Efecte-hakemistossa attribuutti on yhdistetty.
- Jira-attribuutti – mikä Jiran attribuutti on yhdistetty Efecteen

8. Tallenna tehtävä Tallenna-painikkeella. Jos joitakin pakollisia ominaisuuksia puuttuu, tallennuspainike näkyy harmaana ja se näyttää asetuksista puuttuvat tiedot.

9. Olet nyt määrittänyt aikatauluun perustuvan yhdistintehtävän lukemaan tietoja Jirasta ratkaisuusi
- Voit nyt odottaa, kunnes tehtävä aloitetaan aikataulun mukaisesti tai
- Suorita tehtävä manuaalisesti – painiketta napsauttamalla tehtävä määritetään ajoitettavaksi alkamaan välittömästi. Yleensä testiajoihin tai jos et halua muuttaa aikatauluasetuksia, mutta haluat suorittaa tehtävän nyt.
Tapahtumatehtävän määrittäminen datan kirjoittamista varten
Tapahtumatehtävää käytetään kirjoitettaessa dataa asiakkaille Atlassian Jira Cloud -ratkaisussa. Kaikki tapahtumapohjaisiin tehtäviin liittyvät määritykset tehdään Matrix42 Core , Pro tai IGA alustalla.
- Avaa alustan määritysnäkymä (ratassymboli).
- Avaa yhdistinnäkymä
- Valitse liitin, joka käyttää tapahtumatehtävää
- Valitse oikean liittimen alta ”uusi tehtävä”.

4. Täytä tehtävän tiedot
- Tehtävän nimi - Anna tehtävälle nimi, se näytetään tapahtumapohjaisessa tehtävänäkymässä.
- On hyvä käytäntö nimetä tehtävä tavalla, joka kuvaa sen tarkoitusta.
- Tehtävän käyttö osoittaa, että kyseessä on tehtävä, jota käytetään datan lukemiseen tai datan kirjoittamiseen. Muutosta voidaan tehdä jälkikäteen, mutta sitä ei suositella, jos tapahtumatehtävä on käytössä. Se rikkoo työnkulut.
- Yhdistämismääritysten tyyppi riippuu siitä, minkä tyyppisiä tietoja hakemistosta luetaan. Identiteettiyhdistämismääritykset näytetään tämän asetuksen perusteella.
- Identiteetti ja käyttöoikeudet – käytetään, kun Jira-käyttäjien ja -ryhmien tiedot kirjoitetaan sovellukseen
- Yksittäinen (vain identiteetti) – käytetään, kun vain Jira-käyttäjätiedot kirjoitetaan
- Yksittäinen (vain käyttöoikeus) – käytetään, kun asiakkaiden Jira-tiedoista luetaan vain Jira-ryhmän tietoja
- Yleiset (yksi mallipohja) – käytetään, kun muita Jira-kohteita luetaan asiakkaiden Jirasta, kuten esimerkiksi tarinoita, tukipyyntöjä, bugeja jne.

5. Täytä suojaustiedot
Tätä tietoa tarvitaan, jos käyttäjän luontiprosessi työnkulussa on liitetty tehtävään.
- Ensimmäisen kirjautumisen salasana - Oletussalasana, joka on sama kaikille käyttäjille. Työnkulussa luodaan satunnainen salasana, ja se on yleensä yksilöllinen.
- Oletussalasana / kirjoita alla olevaan kenttään
- Oletussalasana - Kirjoita oletussalasana, joka on sama kaikille käyttäjille ja vastaa salasanan hakemistovaatimuksia. Huomaa, että merkkien määrä ei vastaa salasanan todellista pituutta.
- Satunnainen salasana / luonti työnkulussa
- Luotu salasana
- Oletussalasana / kirjoita alla olevaan kenttään

6. Määritä vastaavuudet
- Kohdemalli – Valitse malli määrittääksesi attribuuttimääritykset
- Kohdekansio - Valitse kansio kansioluettelosta. Luetteloa rajataan vastaamaan yhteensopivuutta valitun mallin kanssa.
- Ominaisuusmääritykset
- Efecte-mallin attribuutti - mihin attribuuttiin Efecte-hakemistossa attribuutti on yhdistetty.
- Hakemiston attribuutti - mikä Jiran attribuutti on yhdistetty Efecteen
- Lisää uusi ominaisuus - Voit asettaa lisää ominaisuuksia, jotka luetaan Jirasta valitsemalla Uusi ominaisuus -painikkeen.
Esimerkiksi tässä on käytössä yleiset määritykset ja Efecte luo tikettejä Jiralle

8. Tallenna valmistelutehtävä “tallenna”-painikkeella. Jos pakollisia tietoja puuttuu, et voi tallentaa tehtävää ja tallennuspainike näyttää puuttuvat tiedot.

9. Seuraava vaihe on määrittää työnkulku käyttämään tätä tapahtumapohjaista tehtävää. Efecte Platformin työnkulkumoottorista on mahdollista suorittaa asiakkaiden Jira-palveluihin liittyviä provisiointitoimintoja. Tämä tarkoittaa, että mitä tahansa käytettävissä olevien orkestrointisolmujen toimintaa voidaan suorittaa missä tahansa työnkulun vaiheessa.
Työnkulkuviitteet näkyvät liittimen yleiskatsaussivulla.

Kaksisuuntaisen liittimen määrittäminen
Kaksisuuntaisen liittimen konfigurointi edellyttää, että työnkulun orkestrointisolmut ja sekä ajoitetut että tapahtumapohjaiset tehtävät on konfiguroitu Efecte-ratkaisuun. Tässä luvussa on skenaarioesimerkkejä siitä, miten kaksisuuntainen liitin konfiguroidaan Efecte-ratkaisun ja Jira Cloud välille.
Skenaario 1.
Efecte luo tiketin asiakkaalle Jiraan tiketin tyypin perusteella ja Jira lähettää tiketin takaisin tilan perusteella.
- Luo Efectelle yleinen tapahtumapohjainen tehtävä tikettien luomista varten, esimerkiksi tässä on tapahtumapohjainen tehtävä, joka käyttää tikettimallia

- Luo Efectessä tikettimallin työnkulku, joka määrittää säännöt sille, milloin tiketti menee Jiralle. Esimerkiksi tässä on työnkulku, joka lähettää tiketin Jiralle, kun tila on Uusi, tyyppi on Tapaus ja tukiryhmä on Ohjelmistotiimi.

- Tämän jälkeen, jotta saat tilan takaisin Efectelle, tarvitset ajoitetun tehtävän, joka lukee Jira-pyyntöjen tilan takaisin Efectelle. Esimerkiksi tässä ajoitettu tehtävä lukee Jira-ongelmia, joilla on Efecten projektin tukipyynnöt ja joiden tila on Valmis.
Skenaario 2.
Efecte luo tiketin asiakkaalle Jiraan ja päivittää olemassa olevan tiketin Jirassa muuttuneilla tiedoilla (kuvauskenttä on päivitetty).
- Luo Efectelle yleinen tapahtumapohjainen tehtävä tikettien luomista varten, esimerkiksi tässä on tapahtumapohjainen tehtävä, joka käyttää tikettimallia

- Luo Efectessä tikettimallin työnkulku, joka määrittää säännöt sille, milloin tiketti menee Jiralle. Esimerkiksi tässä on työnkulku, joka lähettää tiketin Jiralle, kun tila on Uusi, tyyppi on Tapaus ja tukiryhmä on Ohjelmistotiimi.

- Tämän jälkeen, jotta saat kuvauksen takaisin Efectelle, tarvitset ajoitetun tehtävän, joka lukee Jira-pyyntöjen kuvauksen takaisin Efectelle. Esimerkiksi tässä ajoitettu tehtävä lukee Jira-ongelmia, joilla on projektin Efecte-tikettejä ja joiden tila ei ole Valmis.

Skenaario 3.
Efecte luo manuaalisen käyttöoikeuspyynnön tikettinä Jiralle, ja tilanmuutoksen perusteella se lähetetään takaisin Efectelle.
- Luo Efectelle yleinen tapahtumapohjainen tehtävä tikettien luomista varten. Tässä on esimerkiksi tapahtumapohjainen tehtävä, joka käyttää IGA hallintatehtävämallia.

- Luo IGA -hallinnon tehtävämallille Efectessä työnkulku, joka määrittää säännöt sille, milloin tehtävä menee Jiraan. Esimerkiksi tässä on työnkulku, joka lähettää tehtävän Jiraan, kun tila on Avoin ja tehtävän kategoria on Manuaalinen käyttöoikeus.

- Tämän jälkeen, jotta saat tilan takaisin Efectelle, tarvitset ajoitetun tehtävän, joka lukee Jira-pyyntöjen tilan takaisin Efectelle. Esimerkiksi tässä ajoitettu tehtävä lukee Jira-ongelmia, joilla on Efecten projektin tukipyynnöt ja joiden tila on Valmis.
2024.1 ja vanhempien versioiden ohjeet
Ajoitetun tehtävän määrittäminen
1. Avaa Efecte-hallinta-alue (ratassymboli) oikeassa yläkulmassa. 
2. Avaa IGA näkymä

3. Valitse Lisää uusi tehtävä

4. Valitse Atlassian Jira Lisää uusi tehtävä -luettelosta 
Huomautus! Määritystyypin on oltava Identiteetti ja käyttöoikeudet, jos kohteena ovat Jira-käyttäjät ja -ryhmät. Jos tarvitaan Jira-ongelmia, käytä Yleinen-vaihtoehtoa.
5. Täytä valmistelutehtävän yksilöllinen nimi
6. Valitse Web API -käyttäjä ja kirjoita salasana
7. Valitse virhemalli ja attribuutti, jota käytetään mahdollisten valmistelun aikana tapahtuvien virheiden (yhteys tietolähteisiin, aikakatkaisut jne.) varalta.
8. Valitse aikataulutusjärjestys, joka riippuu siitä, kuinka paljon dataa luetaan asiakkaan Efecte-ratkaisuun

9. Täytä Pro -osio, jossa määritellään yhteyden tiedot ja yksilöivä tunniste.
10. Täytä attribuuttien yhdistämisosio. Huomautus! Sisältö vaihtelee riippuen siitä, minkä arvon olet valinnut Yhdistämismäärityksen tyyppi -kentässä .

11. Tallenna valmistelutehtävä yläpalkista
12. Olet nyt määrittänyt aikataulun mukaisen valmistelutehtävän ja voit
- Testiyhteys
- Suorita tehtävä manuaalisesti
13. Jos tehtävä suoritetaan manuaalisesti ( suorita tehtävä manuaalisesti ) tai se suoritetaan aikataulun mukaisesti, tehtävän tilaa voidaan tarkastella Pura/Lataa tila -välilehdellä.
Tapahtumapohjaisen tehtävän määrittäminen
1. Avaa Efecte-hallinta-alue (ratassymboli) oikeassa yläkulmassa.

2. Avaa IGA näkymä

3. Valitse Lisää uusi tehtävä

4. Valitse Atlassian Jira Lisää uusi tehtävä -luettelosta 
5. Valitse Pro Tapahtumapohjainen valmistelu ja siirry hakemistoon -kohtaiset ohjeet
6. Täytä valmistelutehtävän yksilöllinen nimi 
7. Täytä Pro -osio, jossa määritellään yhteyden tiedot ja yksilöivä tunniste.
8. Täytä attribuuttien yhdistämisosio. Huom! Sisältö vaihtelee riippuen siitä, minkä arvon olet valinnut Yhdistämismäärityksen tyyppi -kentässä .
- Voit asettaa lisäattribuutteja valitsemalla Lisää mukautettu ominaisuus.
- On mahdollista määrittää, mitkä ominaisuustiedot kirjoitetaan Jiraan.
- Jiraa kohti voi olla useita eri tarkoituksia varten tehtäviä.

9. Tallenna valmistelutehtävä yläpalkista
10. Olet nyt määrittänyt aikataulun mukaisen valmistelutehtävän ja voit
- Testiyhteys
11. Seuraava vaihe on määrittää työnkulku käyttämään tätä tapahtumapohjaista tehtävää.
- Efecte Service Management -alustan työnkulkumoottorista on mahdollista suorittaa Jiraan liittyviä provisiointitoimia. Tämä tarkoittaa, että mitä tahansa käytettävissä olevista toiminnoista voidaan suorittaa missä tahansa työnkulun vaiheessa.
Työnkulun aktiviteetit
Efecte Provisioning Engine (EPE) tarjoaa mahdollisuudet ohjata seuraavia toimintoja Jiralle.
Lisää käyttäjä ryhmään

Yllä olevassa kuvassa Person-attribuutin konfiguraation tulisi osoittaa mallipohjaan, josta orkestrointisolmu löytää käyttäjän tiedot (yleensä IGA tili). Role-attribuutti on konfiguroitava määrittämään, mistä orkestrointisolmu löytää käytettävissä olevat roolit (hakemistoryhmät, joista käyttäjä tulisi poistaa). ”Rooli-attribuutissa” voi olla määritettynä yksi tai useita attribuuttiryhmiä. Käytettävissä olevien rekisteröityjen hakemistotehtävien luettelo noudetaan EPE-pääpalvelimelta.
Poikkeusten käsittely:
- Solmun tulos on "Valmis"-tilassa vain, jos kaikkien käyttäjien ryhmäjäsenyydet on päivitetty onnistuneesti. Jos esimerkiksi käyttäjä on poistettu onnistuneesti viidestä kuudesta ryhmästä, solmun tulos on "Poikkeus"-tilassa.
- Tästä syystä sekä identiteetin että käyttöoikeuden JSON-kentän distinguishedName-määritykset ovat pakollisia. Jos määritystä ei löydy, orkestrointisolmu siirtää sen tilaan ”Poikkeus”.
- Käyttäjän poistaminen ryhmästä, johon hän ei kuulu, epäonnistuu.
- Käyttäjän lisääminen ryhmään, johon hän jo kuuluu, epäonnistuu.
- Tiedot käyttäjän ryhmäjäsenyyden onnistuneesta/epäonnistuneesta päivityksestä löytyvät lokeista.
- Pro ja ryhmäjäsenyyden poikkeukset ovat valinnaisia ominaisuuksia tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää nämä ominaisuudet käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana ilmenee poikkeuksia.
Luo käyttäjä

Uuden käyttäjän luontisolmu lukee attribuutit kyseisiltä datakorteilta ja suorittaa API kutsunsa Jiralle. Luodun yksikön tunnus (Created Entity Id) tulee täyttää attribuutilla, joka sisältää uuden käyttäjän accountID-arvon.
Uuden käyttäjän salasanan luomiseen ensimmäistä kirjautumista varten on kaksi tapaa.
- Määritä oletussalasana Pro Task -määritysnäkymässä
- Käyttäjät käyttävät tätä salasanaa vain, kun he kirjautuvat järjestelmään ensimmäistä kertaa.
- Satunnaisen salasanan luominen työnkulussa ja sen valitseminen, mihin identiteettikartoituksen datakortin attribuuttiin se kirjoitettiin
- Mahdollisuus valita, onko salasana vaihdettava ensimmäisen kirjautumisen yhteydessä vai ei. Järjestelmänvalvojat voivat tehdä tämän valinnan suoraan työnkulun käyttäjäluonnin orkestrointisolmussa.
- Loppukäyttäjälle voidaan antaa ensimmäisen kirjautumisen salasana eri tavoilla. Asiakkaan tarpeista riippuen on mahdollista käyttää työnkulun toimintoja salasanan lähettämiseen suoraan loppukäyttäjälle sähköpostitse tai tekstiviestitse. Toinen vaihtoehto on lähettää ensimmäisen kirjautumisen salasana esimiehelle, joka toimittaa sen loppukäyttäjälle. EPE:n orkestrointisolmu itsessään EI tarjoa tätä toimintoa, se on määriteltävä muualla.
Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.
Luo ryhmä

Ylläpitäjät valitsevat oikean Jira-kohteen ja voivat tarkastella sen määrityksiä. Uuden ryhmän orkestrointisolmun luonti lukee attribuutit kyseisiltä datakorteilta ja suorittaa API kutsun Jiralle.
Luodun yksikön tunnus -attribuutti yhdistetään Efectessä olevaan attribuuttiin, joka sisältää uuden ryhmän groupID-arvon.
Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.
Poista ryhmä

Ylläpitäjät valitsevat oikean Jira-kohteen ja voivat tarkastella sen määrityksiä. Ryhmäorkestrointisolmun poistaminen lukee attribuutit kyseisiltä datakorteilta ja suorittaa API kutsu Jiraan.
Rooliryhmän attribuutti on yhdistettävä Efectessä attribuuttiin, joka sisältää poistettavan ryhmän groupID-arvon.
Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.
Poista käyttäjä

Ylläpitäjät valitsevat oikean Jira-kohteen ja voivat tarkastella sen määrityksiä. Käyttäjäorkestrointisolmun poistaminen lukee attribuutit kyseisiltä datakorteilta ja suorittaa API kutsu Jiraan.
Person-attribuutti* on yhdistettävä Efectessä attribuuttiin, joka sisältää poistettavan käyttäjän AccountId-arvon.
Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.
Poista käyttäjä ryhmästä

Yllä olevassa kuvassa järjestelmänvalvojat voivat valita oikean Jira-kohteen.
Person-attribuutin* on oltava yhdistetty Efectessä attribuuttiin, joka sisältää ryhmästä poistettavan käyttäjän AccountId-arvon.
Rooliattribuutti* on yhdistettävä Efectessä attribuuttiin, joka sisältää käyttäjältä poistettavan ryhmän groupID-arvon.
Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.
Luo Jira-tiketti

Yllä olevassa kuvassa ylläpitäjät voivat valita oikean Jira-kohteen. Kohde on valittavissa niille epetask-kohteille, jotka sisältävät vähintään attribuutit datasourceid, issuetype, project ja summary. Esimerkiksi

Pro on valinnainen ominaisuus tässä työnkulkusolmussa. Järjestelmänvalvojat voivat määrittää tämän ominaisuuden käyttöön siten, että poikkeuksia voidaan kirjoittaa, jos valmistelutoimintojen aikana on poikkeuksia.
Tunnetut rajoitukset
Kommenttien lukeminen Atlassian Jira Cloud Matrix42 Core , Pro tai IGA ratkaisuun
Jos yrität lukea kommentteja suoraan Matrix42 Core , Pro tai IGA -datakortin kommenttiattribuuttiin, kommentit kopioituvat jokaisen ajoitetun tehtävän suorituksen yhteydessä.
Sen sijaan, että lukisit kommentit suoraan comments-attribuuttiin, sinun on käytettävä helper temp -attribuuttia, johon yhdistät Jira-kommentit. Ja päivitettävä varsinaiset kommentit kyseisen temp-attribuutin arvon perusteella, jos varsinainen comments-attribuutti ei vielä sisällä kyseistä kommenttia. Tämä voidaan tehdä Matrix42 ydin- ja ammattialustan mukautustyökaluilla. Ota yhteyttä Matrix42 konsultteihin saadaksesi tarkempia tietoja tästä.
Vianmääritys
Tässä luvussa kuvataan vianmääritysvaihtoehtoja,
- Jos käytetään vikamallia, tarkista oikea datakortti
- Tarkista ajoitettujen tehtävien historia liitinten hallinnasta
- Tarkista Efecte Provisioning Engine lokit