Atlassian Jira Cloud -liitin

Learn how to configure the Atlassian Jira Cloud Connector to synchronize your Jira tickets, users, groups and permissions

+ More

Atlassian Jira Cloud -liitin

Yksi saatavilla olevista Native Connectors -liittimistä on Atlassian Jira Cloud -liitin, joka on tarkoitettu käytettäväksi integroitaessa Matrix42 Pro/IGA Atlassian Jira Cloud -instanssiin. Tapahtumapohjaista Jira-liitintehtävää käytetään, kun dataa kirjoitetaan Matrix42 Pro/IGA -alustalta Jiraan. Ajastettuun tehtävään perustuvaa Jira-liitintehtävää käytetään, kun suuria määriä dataa luetaan Jira Cloud -alustalta Matrix42 Pro/IGA:han. Ratkaisun ylläpitäjät voivat määrittää yhteyden kohde-Jira Cloudiin Native Connectors -ylläpitokäyttöliittymän kautta. Prosessit voidaan ajaa tapahtumapohjaisesti Visual Workflow Automationin laukaisemina.

Atlassian Jira Cloud -liitin vaatii määrityksen asiakkaan käyttötapauksen mukaisesti, ja periaatteessa määrityksessä on kolme (3) vaihetta:

Liittimen määrittäminen – mahdollistaa liittimen yhteyden muodostamisen asiakkaan Atlassian Jira Cloudiin
Ajastetun tehtävän määrittäminen – käytetään, kun dataa luetaan asiakkaan Atlassian Jira Cloudista
Tapahtumatehtävän määrittäminen – käytetään, kun dataa kirjoitetaan asiakkaan Atlassian Jira Cloudiin
1. Myös työnkulun orkestrointisolmut on määritettävä

Yleisiä käyttötapauksia ovat:

Jira-tikettien luominen ESM-alustan incidenttien perusteella Jiraan
Jira-tikettien tuonti Jirasta ESM-alustalle
Kommenttien siirtäminen ESM-alustan ja Jiran välillä
Ratkaisutiedon siirtäminen ESM-alustan ja Jiran välillä
Jira-käyttäjien luominen ja poistaminen
Jira-ryhmien luominen ja poistaminen
Käyttäjien lisääminen ja poistaminen Jira-ryhmistä

Yleiset toiminnot

Connectors - general functionalities

In this article are described general functionalities for managing native connectors in solution. All Native Connectors are managed from the same connector management UI.

Notice that there are separate descriptions for each connector, where connector specific functionalities and configuration instructions are described in detailed level.

To be able to access connector management, user needs to have admin level permissions to customers Platform configuration. When accesses are granted correctly, Connector tab will be visible and user can manage connectors.

Connector management is divided into four tabs:

Overview - for creating and updating Native Connectors. The Admin User can see their status, type and how many scheduled or event tasks are associated with them.
Authentication - for creating and updating authentication tasks. Provisioning task for authentication is needed for Secure Access to be able to define which Customers end-users can access to Matrix42 Core, Pro and IGA login page.
Logs - for downloading Native Connector and Secure Access logs from UI.
Settings - general settings for Native Connectors and Secure Access, including environment type for logging and monitoring.

In release 26.2 left menu was moved to be on top of page as top menu. It also now contains new Certificates tab, for handling Native Connectors and Secure Access LDAP and HTTPS traffic certificates.

Connectors overview tab

From overview page, user can easily and quickly see status for all connectors.

Top bar:

Connectors
- Green indicates that Native Connectors is online. All the needed services are up and running.
- Red indicates that there is a problem with Native Connectors, all the services are not running.
Authentication (Secure Access)
- Green indicates that Secure Access is online. All the needed services are up and running.
- Red indicates that there is a problem with Secure Access, all the services are not running.
Native Connectors version number is displayed in top right corner

Top bar for list view:

New connector - opens new window for adding and configuring new connector
Remove connector(s) - workflow references are calculated and pop-up window appears to confirm removal (notice that calculating references can take several seconds)
Export - Admin can export one or more connectors (and tasks) from the environment. Usually used for exporting connectors and connectors (and tasks) from test to prod. Native connectors secret information is password protected.
Import - Admin can import one or more connectors (and tasks) to the environment. Usually used for importing connectors (and tasks) from test to prod.
- Admin cannot import from old EPE UI (Older than 2024.1) to the new one. Source and target environments must have same version.
- Import will fail if the configuration (templates, attributes) is not the same - for example when some attribute is missing
- If a connector with the same details already exists in the environment, the import process detects this and informs the admin that the connector already exists. The existing connector is not modified or renamed.
Refresh - Admin can refresh connectors list view by clicking the Refesh button.

List view for overview,

Select connector(s) - Select one connector by clicking check box in front of the connector row or clicking check box in the header row will select all connectors
Id - Automatically generated unique ID of the connector. Cannot be edited or changed.
Status - indicates scheduled task status

Green double check mark - Task is executed without any errors
Red triangle -Task is executed, but there have been error
Grey line - Tasks are not executed yet
Orange - one or more of the tasks has a problem
No value - Scheduled based-task is missing
Name - Connector name added to connector settings. Unique name of the connector holding configuration for one data source
Type - indicates target / source system
Scheduled - informs how many scheduled tasks are configured
Event - informs how many event tasks are configured
Manage
- Pen icon - opens connector settings (double-clicking the connector row, also opens settings)
- Paper icon - copies the connector
- Stop - workflow references are calculated and pop-up window appears to confirm removal
Search - User can search connector by entering the search term in the corresponding field . Id, Status, Name, Type, Scheduled and Event fields can be searched.

Scheduled task information (click arrow front of the connector)

When clicking arrow at the beginning of the connector row, all related scheduled and event tasks are shown

Top bar for scheduled tasks

New task - opens configuration page for new task
Remove task(s) - removes the selected task(s) from the system and they cannot be recovered anymore.
Refresh - refresh scheduled-based tasks view
Search - user can search task by entering the search term in the corresponding field for Id, name, enabled, extract/load status.

List view for scheduled tasks

Select task(s) - Select task to be deleted from the list view by ticking.
Id - Unique ID of the task. Generated automatically and cannot be changed.
Name - Task name added to task settings, unique name of the task.
Scheduling - Displays is the task scheduled or not
- Green calendar mark - Task is scheduled
- Grey line - Task is not scheduled
Extract status - Displays status of data extraction from the target directory/system
- Green double check mark - data is extracted successfully
- Red triangle - data is extracted with error(s) or extraction is failed
- Grey line - Extract has not been executed yet
- Black gears - Extraction is ongoing
Load status - Displays status of data export from json-file to customers solution
- Green double check mark - data is imported successfully to customers solution
- Red triangle - data is imported with error(s) or import is failed
- Grey line - Data load has not been executed yet
- Black gears - Load is ongoing
Manage

Pen icon - opens task settings in own window (double-clicking the task row also opens task settings)
Paper icon - copies the task
Move icon - move task under some different connector, pop-up window opens to select target connector
Run icon - run task manually once, pop-up window opens to confirm the run
Clock icon - opens task history view
Minus icon - remove task, pop-up window opens to confirm the removal

Scheduled task history view

By clicking the clock icon in the scheduled task row, history for scheduling will be shown.

It shows maximum 500 previous task runs.

Top bar for view history

Refresh - refreshes scheduled task status. This doesn't affect task, this only updates UI to show latest information of task run.

List view for scheduled task history

Color of the row is indicating status
- Green double check mark - execution successful
- Red triangle - execution failed (hover red icon to see more detailed error)
Execution ID - unique ID for the scheduled task row
Extract status - status for fetching data from the directory/application
Load status - status for loading information to customers solution
Scheduled start time - when next extract from the directory/application is scheduled to happen
Extract actual start time - when extract was started
Extract actual end time - when extract ended
Load actual start time - when load actually started
Load actual end time - when load actually ended

Task run details

Download Group file - JSON file containing group information read from the directory/application
Download Users file - JSON file containing user information read from the directory/application
Download Generic file - JSON file containing generic information read from the directory/application
Download All Failed Data Cards - JSON file containing failed objects
Load overview - detailed information about loading the information to customers Matrix42 Pro and IGA solution
Log data - part of logs. Full logs can be downloaded from Logs tab

Edit window for scheduled task

Configuration for scheduled task can be opened by clicking pen icon or double-clicking the task row.

Left menu and attributes varies according to selected options and therefore more detailed instructions for editing tasks can be found from the connector description, but there are common functionalities for all scheduled tasks which are described below.

Saving the task

In case mandatory information is missing from the task, hoovering mouse on top of the save button will show which attributes are still empty.

Top bar for edit scheduled task

Run task manually - admin can run task manually out side of the defined scheduling
Stop task - admin can stop scheduled-based task which is currently running. Task will be stopped and status is changed to be stopped. It waits in this state until the next timing occurs.
Clear data cache - Data cache for the next provisioning of Users and Groups will be cleared. It means that next run is run as first time run.
- By default, we clear the cache everyday at 00:00 UTC
- If you want to clear the cache at different time, then it has to specify some different value in host file 'custom.properties'.
- EPE Cache is also cleared when EPE is restarted, whole environment is restarted, EPE mappings have been changed

Event task information

When clicking arrow at the beginning of the connector row, all related scheduled and event tasks are shown

Top bar for event tasks

New task - opens configuration page for new event task
Remove task(s) - removes selected task(s), pop-up window appears to confirm the removal
Refresh - refreshes event tasks view
Show workflow references - calculates task related workflow relations and statuses. This is very useful if you don't know from which workflows event-based tasks are used.

List view for event tasks

Select task(s) - Select task to be deleted from the list view by ticking.
Id - Unique ID of the task. Generated automatically and cannot be changed.
Name - Task name added to task settings, unique name of the task.
Workflow relations
- Question mark shows pop-up window with detailed information about the reference
Workflow status
- Not used - No relations to workflow
- In use - Workflow(s) attached to task, task cannot be removed
Manage
- Pen icon - opens task settings
- Paper icon - copies the task
- Move icon - moves task under different connector, pop-up window opens to select target connector
- Stop icon - removes the task, pop-up window appears to confirm the removal

Edit window for event task

Configuration for event task can be opened by clicking pen icon or double-clicking the task row.

Task name - Descriptive name for task so you recognize it
Task usage - Allow editing checkbox. When unchecked, the current task usage value is displayed in read-only form without edit indicators, so the configuration state is easy to read. Check the box to make the field editable, note that changing the task usage type on an existing task will break workflows
Mappings type - Allow editing checkbox. When unchecked, the current mappings type value is displayed in read-only form without edit indicators. Check the box to make the field editable, note that changing the mappings type on an existing task will break workflows

Saving the task

In case mandatory information is missing from the task, hovering mouse on top of the save button will show which attributes are still empty.

Authentication tab

Authentication for Matrix42 Core, Pro and IGA solutions are configured from authentication tab, notice that only some of the connectors (directory connectors) are supporting authentication, so its not possible to create authentication tasks to all available connectors.

Top bar for authentication

New connector - opens new window for configuring new connector (notice that not all connectors are supporting authentication)
Remove connector(s) - removes selected task(s), pop-up window appears to confirm the removal
Export - user can export one or more tasks from the environment. Usually used for exporting tasks from test to prod. EPE connectors are password protected.
- Note that Realm for authentication tasks is not exported, you need to set that manually after importing
Import - user can import one or more tasks to the environment. Usually used for importing task from test to prod.
Refresh - refreshes authentication tasks view

List view for authentication overview

Select connector(s) - Select one connector by clicking check box in front of the connector row or clicking check box in the header row will select all connectors
Id - Automatically generated Unique ID of the connector. Cannot be edited or changed.
Name - Connector name added to connector settings. Unique name of the connector holding configuration for one data source
Type - indicates target / source system
Count - informs how many authentication tasks are configured
Manage
- Pen icon - opens authentication task setting in own window
- Paper icon - copies the task
- Stop icon - removes selected task

Authentication task information

When clicking arrow at the beginning of the connector row, all related scheduled and event tasks are shown

Top bar for authentication overview

Create new task - opens configuration page for new authentication task
Remove task(s) - removes selected task(s), pop-up window appears to confirm the removal
Refresh - refreshes authentication tasks view

List view for authentication overview,

Select task(s) - Select task to be deleted from the list view by ticking.
Id - Unique ID of the task. Generated automatically and cannot be changed.
Name - Task name added to task settings, unique name of the task.
Manage
- Pen icon- opens task settings in own window (double-clicking the task row, also opens settings window)
- Paper icon - copies the task
- Stop icon - removes the task, pop-up window appears to confirm the removal

Logs tab

Logs tab is for downloading Native Connector and Secure Access logs from UI for detailed troubleshooting.

epe-master logs - contains warning, debug and error level messages about Native Connectors and info how long task actions has been taken.
epe-worker-ad logs - contains extract data status of Active Directory connector (what Native Connector is loading to to customers Matrix42 Pro and IGA solution). If selection is empty, it means that directory is not in use in this environment.
epe-worker-azure logs - contains extract data status of Entra ID (what Native Connector is loading to to customers Matrix42 Pro and IGA solution). If selection is empty, it means that directory is not in use in this environment.
epe-worker-ldap logs - contains extract data status of LDAP (what Native Connector is loading to to customers Matrix42 Pro and IGA solution). If selection is empty, it means that directory is not in use in this environment.
epe-launcher logs - contains information about EPE launches
datapump-itsm logs - Contains information about data export to customers Matrix42 Pro and IGA solution.
esa logs - Contains information about Secure Access authentication.

Settings tab

Settings tabs is used for monitoring environments with connectors.

After changing configurations, remember to save changes from bottom right corner Save -button.

Environment type - is mandatory to be in selected and information is used for example defining alert critically.
- Test - select this when your environment is used as testing environment
- Prod - select this when your environment is used as production environment
- Demo - select this when your environment is used as demo or training environment
- Dev - select this when your environment is used as development environment

What we are monitoring?

Failures in scheduled based provisioning (extracting data, exporting data to ESM, outdated certificates, incorrect passwords, incorrect search base/filter, incorrect mappings, etc.)
Failures in event based provisioning (fail to write to AD/Azure, etc.)
Event-based provisioning - which connectors are used for writing data towards applications/directories.
ESA more than ten failed login attempts to one user in past 3 days
Environment type - is mandatory to be in selected and information is used for example defining alert critically.

Show logs - when ON, logs can be seen from Logs tab on UI

Automate Secure Access Certificate reloading - when ON, Secure Access will automatically reboot at 03:00 UTC if there are new certificates that needs to be taken into use.

Data migrations - Do not click “Migrate attribute mappings” or “Migrate workflows”, if not requested to do so by Matrix42.

Yleisiä ohjeita ajastetuille tehtäville

How to Create New Scheduled Task to import data

For configuring scheduled-based provisioning task, you will need access to Administration / Connectors tab.

1. Open the Administration area (a cogwheel symbol).

2. Open Connectors view.

3. Choose Connector for Scheduled-based task and select New Task
Note! If connector is not created, you have to choose first New connector and after that New task.

4. Continue with connector specific instructions: Native Connectors

Should I use Incremental, Full or Both?

Scheduled task can be either Incremental or Full -type.

Do not import permissions with AD and LDAP incremental task

Incremental task has issue with permissions importing. At the moment it is recommended not to import group memberships with incremental scheduled task.

On Microsoft Active Directory and OpenLDAP connectors, remove this mapping on incremental task:

Setting on Scheduled tasks:

Incremental type is supported only for Microsoft Active Directory, LDAP and Microsoft Graph API (formerly known as Entra ID) Connectors.

Incremental type means, that Native Connectors (EPE) fetches data from source system, using changed timestamp information, so it fetches only data which is changed or added after previous incremental task run.

When Incremental type task is run for very first time, it does a full fetch (and it marks the current timestamp to EPE database), thereafter, task uses that timestamp to ask the data source for data that changed since that timestamp (and then EPE updates the timestamp to EPE database for next task run). Clearing task cache doesn't affect this timestamp, so Incremental task is always incremental after first run.

Full type is supported for all Connectors.

Full type import fetches always all data (it's configured to fetch) from source system, on every run.

Tasks internal cache

Both Full and Incremental type tasks use also Task cache in EPE, which makes certain imports faster and lighter for M42 system.

Beginning from version 2026.1.1

Tasks internal cache clean scheduling was moved from properties file to Task UI.

With that change you can now also decide per scheduled task when internal cache is cleared, or if it's not cleared at all. In normal situations cache is recommended to be cleared at some point to guarantee correct data on datacards. If template and imported data doesn't contain references, cache can be cleared quite rarely. With references, it's recommended to clear cache daily or weekly to guarantee correct data on datacards.

Versions before 2026.1.1

By default that task cache is cleared ad midnight UTC time. When cache is cleared, next import after that is run without caching used to reason if data fetched should be pushed to ESM, all fetched data is pushed to ESM. But after that, next task runs until next time cache is cleared, are using EPE cache to determine if fetched data needs to be pushed to ESM or not.

You can configure at what time of day task cache is emptied, by changing global setting in EPE datapump configuration:

/opt/epe/datapump-itsm/config/custom.properties

which is by default set to: clearCacheHours24HourFormat=0

You can also clear cache many times a day, but that needs to be thinked carefully, as it has impact on overall performance as EPE will push changes to ESM, that probably are already there, example(do not add spaces to attribute value): clearCacheHours24HourFormat=6,12

After changing this value, reboot EPE datapump container to take change into use.

Recommendations

Have always by default Full type scheduled task.

If you want to fetch changes to data fetched already by full task, more frequently than you can run full task, add also incremental task. Usually incremental task is not needed.

Recommended Scheduling Sequence

Recommended scheduling sequence, depends how much data is read from Customers system/directory to the Matrix42 Core, Pro or IGA solution and is import Incremental or Full.

Examples for scheduling,

Total amount of users	Total amount of groups	Full load sequence	Incremental load sequence
< 500	< 1000	Every 30 minutes if partial load is not used Four (4) times a day if partial load is used	Every 10 minutes
< 2000	< 2000	Every 60 minutes, if partial load is not used Four (4) times a day if partial load is used	Every 15 minutes
< 5000	< 3000	Every four (4) hours, if partial load is not used Twice a day if partial load is used	Every 15 minutes
< 10 000	< 5000	Maximum imports twice a day, no matter if partial load is or is not used	Every 30 minutes
< 50 000	< 7000	Maximum import once a day, no matter if partial load is or is not used	Every 60 minutes
Over 50 000	Over 7000	There might be a need for another EPE-worker, please contact Product Owner	Separately evaluated

Please note that if there are several tasks running at the same time you may need more EPE-workers. The tasks should be scheduled at different times and can be completed according to the table above. However, if there are more than 6 tasks running at the same time, the number of epeworkers should be increased. It's best practice not to schedule tasks to run at same time, if possible.

Recommendations related to performance
If the amount fo data to be imported is over 10000 concider these things:
Adjust log level of ESM and DATAPUMP to ERROR-level, to lowe the amount of logging during task run
Have as few as possible automations starting immediately for imported datacards (listeners, handlers, workflows), as those make ESM to take longer time handling new datacards.

Set removed accounts and entitlements status removed/disabled

With this functionality, you can mark account and entitlement status to e.g. Deleted or Disabled, when account or entitlement is removed from source system. Starting from version 2025.3 you can also set status to generic objects (not only to accounts/identities and entitlements/groups).

For version 2025.3 and newer

In version 2025.3 these settings are moved from properties files to Task UI. Also you can now set these settings for Generic objects, which have not been possible before this version.

There is separate configuration for each scheduled task, and for all mapping types. Here is example of this config on task:

Unique check added on 26.2 version

When this Set value for deleted objects option is enabled, at least one of the attributes mapped to the unique id must also be marked as Unique on the target template. If none of the mapped attributes are unique, the task cannot be saved and the message "Unique id must be mapped to at least one unique attribute of template" is shown.

For version 2025.2 and older

This functionality is available for “full” type scheduled tasks.

Settings are on datapump dockers configuration file. To change those parameter values, you need to set those in /opt/epe/datapump-itsm/config/custom.properties file.

Configuration

To enable disabling functionality, datapump config should have these parameters set to true:

disable.unknown.esm.users=true
disable.unknown.esm.groups=true

Those 2 parameters are false by default in 2024.2 and 2025.1 versions. In 2025.2 and newer version those are true by default.

Next are these parameters:

personTemplateStatusCodeAttributeKey=accountStatus
personTemplateStatusAttributeDisabledValueKey=Deleted
groupTemplateStatusCodeAttributeKey=status
groupTemplateStatusAttributeDisabledValueKey=5 - Removed

First two attributes should point to the DatacardHiddenState attribute in the User template, and tell which value should be send there when the user is deleted.

By default its accountStatus and Value 5 - Removed on IGA Account template.

All these needs to match with the attribute configuration:

Same thing applies for the next two paramaters, but its for Groups.'

If you need to change those parameters in properties file, do changes in Datapump container to file: /opt/epe/datapump-itsm/config/custom.properties and those changes will then survive over container reboot and will be copied on reboot to /opt/epe/datapump-itsm/config/application.properties.

Description

Tasks save their __taskid__ shown as Task Id mapping in the UI to the datacards, its then used to determine if the datacard was added by this task. In case there are multiple tasks with different sets of users.

This field was previously used as datasourceid, but since we moved to the model where connector can have multiple tasks its identifier cannot be used anymore, thats why the field was repurposed as taskid instead.

Taking users as an example, when task runs ESM is asked for the list of users that have its taskid in Task Id mapping field, and doesn't have a personTemplateStatusAttributeDisabledValueKey value in the personTemplateStatusCodeAttributeKey

This result is then compared to what the task fetched, and the datacards of users that were not fetched have their personTemplateStatusattribute set to value specified in the config - 5 - Removedby default.

Example log below shows described process and informs that one user was removed.

Same thing applies to groups but groupTemplateStatusattributes are used instead.

Notes

Feature works only with full fetch scheduled tasks..
No support for generic templates yet, only identity and access
When migrating from the previous versions where datasourceid was still used it needs to run at least once to set its taskid’s in the datacards first.
EPE identifies Disabled users or groups as the ones that were removed from the AD, at the present we do not support statuses related to the entity beign active or not.
EPE does not enable users back on its own.
If more than one tasks fetches the same users or groups it may overwrite the taskid in the datacard depending on which task ran last. It is suggested that many full type tasks are not fetching same user or group.
Always do configuration file changes to custom.properties, do not change only application.properties as those changes are lost on container reboot if you have not done same changes to custom.properties.

Jira Cloud -liittimen määrittäminen

Miten luoda uusi Jira-liitin

Provisioinnin määrittämiseksi tarvitset pääsyn Matrix42 Pro/IGA Platform -määrityskonsoliin.

1. Avaa ylläpitoalue (hammasratassymboli).
2. Avaa Connectors-näkymä.
3. Valitse New connector

4. Valitse Data Source -tyyppi Atlassian Jira Cloud

5. Täytä seuraavat tiedot koskien Jira -ratkaisua

Connector name – anna liittimelle helppokäyttöinen nimi (nimen voi muuttaa myöhemmin). Jira-liittimen host-URL:n tulisi olla muodossa: https://instancename.atlassian.net
Host URL – isäntäosoite, jota käytetään yhteyden muodostamiseen Efecte-ratkaisuun
User name – käyttäjä, joka loi Access tokenin (Jira-palvelutilejä ei tueta)
Access token – Access tokenit ovat voimassa enintään yhden vuoden (Jiran puolen rajoitus), joten muista dokumentoida, milloin tunnus vanhenee, jotta muistat luoda uuden tunnuksen ja määrittää sen Jira-yhteyteen ennen sen vanhenemista. Lisätietoja:https://support.atlassian.com/atlassian-account/docs/manage-api-tokens-for-your-atlassian-account/
- Access token -arvo on Jira-käyttäjän API-tunnuksen arvo
WebAPI user – Efecte-ratkaisun WebAPI-käyttäjätunnus
- Luettelo kaikista Efecten paikallisista käyttäjistä
WebAPI password – Efecte-ratkaisun WebAPI-käyttäjän salasana

6. Tallenna liittimen tiedot.

7. Kun olet tallentanut liittimen tiedot, avaa liitin uudelleen ja napsauta test connection-painiketta nähdäksesi, saako liitin yhteyden kohde-Efecte-ratkaisuun.

8. Kun yhteys onnistuu, voit jatkaa ajastetun tehtävän ja/tai tapahtumapohjaisen tehtävän luomiseen

Vaiheittaiset ohjeet ajastetun tehtävän luomiseen

Atlassian Jira Cloud -liitintä käytetään käyttäjä-, ryhmä- ja tikettitietojen lukemiseen Jirasta, ja se määritetään Matrix42 Pro/IGA -alustalla luomalla ajastettuun tehtävään perustuva liitintehtävä.

Miten luoda uusi ajastettuun tehtävään perustuva tehtävä

Ajastettuun tehtävään perustuvan liitintehtävän määrittämiseksi tarvitset pääsyn Efecte Platform -määrityskonsoliin. Huomaa! Jos liitintä ei ole vielä luotu, sinun on ensin luotava ”new connector”, minkä jälkeen voit luoda uusia tehtäviä.

1. Avaa Matrix42 Pro/IGA Platform -määritysnäkymä (hammasratassymboli).
2. Avaa Connectors-näkymä.
3. Valitse liitin ajastettua tehtävää varten ja valitse + new task

4. Määritä tehtävän ajastus (ajetaanko ajastettu tehtävä säännöllisesti ja miten). Valitse ajastusväli sen mukaan, kuinka paljon dataa Jirasta luetaan.

5. Täytä tehtävän tiedot

Anna ajastetulle tehtävälle yksilöllinen nimi; huomaa, että nimeä ei voi muuttaa myöhemmin.
Task usage ilmaisee, käytetäänkö tehtävää datan lukemiseen vai kirjoittamiseen. Huomaa, että jos tapahtumatyyppiä muutetaan myöhemmin, se voi rikkoa työnkulut.
Mappings type riippuu siitä, minkä tyyppistä tietoa luetaan
- Identity and access rights – käytetään, kun sovelluksesta luetaan Jira-käyttäjä- ja ryhmätietoja
- Single (identity only) – käytetään, kun asiakkaan Jirasta luetaan vain Jira-käyttäjätietoja
- Single (access right only) – käytetään, kun asiakkaan Jirasta luetaan vain Jira-ryhmätietoja
- Generic (one template) – käytetään, kun asiakkaan Jirasta luetaan muita Jira-kohteita, kuten esimerkiksi storyjä, tikettejä, bugeja jne.
Jira query – on hyvä käytäntö testata Jira-kysely (JQL) varsinaisessa Jira-järjestelmässä ennen sen käyttöä tehtävän määrityksessä.
Katso myös Jiran dokumentaatio:
https://support.atlassian.com/jira-service-management-cloud/docs/use-advanced-search-with-jira-query-language-jql/
https://www.atlassian.com/software/jira/guides/jql/cheat-sheet#key-jql-functions

6. Täytä failure-tiedot. Valinnaiset asetukset virheenkäsittelyä varten; jos ajastettu tehtävä epäonnistuu, se voi luoda Matrix42 Pro/IGA -ratkaisuun tietokortin, joka näyttää virheen. Jos failure-asetukset on määritetty, ylläpitäjän ei tarvitse manuaalisesti tarkistaa ajastettujen tehtävien tilaa.

Failure template – valitse tietokortin malli, joka luodaan, jos datan luvun aikana tapahtuu virheitä (yhteys tietolähteisiin, aikakatkaisut jne.)
Failure folder – valitse kansio, johon failure-tietokortti tallennetaan.
Failure attribute – valitse attribuutti, johon virhetiedot tallennetaan failure-mallissa.

7. Täytä mappaukset

On pakollista määrittää target template ja -folder, datasourceid sekä yksilölliset id-arvot, joita käytetään datan tunnistamiseen asiakkaan Jiran ja Efecte-ratkaisun välillä.

Target template – valitse malli attribuuttimappausten määrittämiseksi
Valitse malli attribuuttimappausten määrittämiseksi
Target folder – valitse kansio luettelosta. Luettelo rajataan vastaamaan valittua mallia.

Data Source Type mapping – valinnainen. Jos se on asetettu, se kirjoittaa liittimen tyypin kyseiseen attribuuttiin.
Task Id mapping – tehtävän id-numero kirjoitetaan tähän attribuuttiin. Oikea valittava attribuutti riippuu mallisi määrityksestä. Tämän on oltava ei-yksilöllinen attribuutti.
Set value to datacard fo object deleted from source system – tämä toiminto otetaan käyttöön valitsemalla valintaruutu. Kun objekti, joka on aiemmin luettu Jirasta Matrix42 Pro/IGA -ratkaisuun, poistetaan Jirasta, ajastettu tehtävä huomaa poiston ja merkitsee kyseisen tietokortin valitun attribuutin halutulla arvolla. Tätä voidaan käyttää esimerkiksi Status-attribuutin asettamiseen arvoon Deleted. Tämä attribuutin nimi ja arvo on määritettävä mallisi määrityksen mukaisesti.
Attribute mappings
1. External attribute – mikä Jiran attribuutti luetaan
2. Local attribute – mihin Matrix42 Pro- ja IGA-attribuuttiin attribuutti mapataan
Lisää attribuutteja attribuuttimappauksiin valitsemalla New attribute

8. Tallenna tehtävä Save-painikkeesta. Jos joitakin pakollisia attribuutteja puuttuu, save-painike näkyy harmaana, ja se näyttää, mitä asetuksista puuttuu.

9. Olet nyt määrittänyt ajastettuun tehtävään perustuvan liitintehtävän, joka lukee dataa Jirasta ratkaisuusi

Voit nyt odottaa, että tehtävä käynnistyy ajastuksen mukaisesti, tai
Run task manually – painiketta napsauttamalla tehtävä ajastetaan käynnistymään heti. Yleensä käytetään testiajoihin tai kun ei haluta muuttaa ajastusasetuksia, mutta halutaan ajaa tehtävä nyt.

10. Jos tehtävä suoritetaan manuaalisesti (”Run task” napsautettu) tai se ajetaan ajastuksen mukaisesti, tehtävän tilaa voi tarkastella View history:

Vaiheittaiset ohjeet tapahtumapohjaisen tehtävän luomiseen

1. Avaa Matrix42 Pro/IGA -ylläpitoalue (hammasratassymboli) oikeasta yläkulmasta.

2. Avaa Connectors -näkymä

3. Valitse Atlassian Jira Cloud Connector kohdasta Overview and Event-based tasks ja painike + New Task

4. Anna provisiointitehtävälle yksilöllinen nimi

Mapping type -arvon on oltava Generic Template, kun käsitellään muita objektityyppejä (esimerkiksi tikettejä) kuin käyttäjiä ja ryhmiä.

5. Täytä attribute mapping -osio.

Huomaa! Sisältö vaihtelee sen mukaan, minkä arvon olet valinnut Mappings type -kenttään.

Target Template – malli, joka sisältää datan, jonka haluat lähettää Jiraan (tai hakea Jirasta)

Target Folder – kansio, joka sisältää datan, jonka haluat lähettää Jiraan (tai hakea Jirasta)

On mahdollista määrittää lisäattribuutteja valitsemalla ”New Attribute”, kirjoittamalla sitten attribuutin nimi ja hyväksymällä se napsauttamalla ”Add item”. Tämä on erittäin hyödyllistä, jos olet lisännyt Jiraan omia mukautettuja attribuutteja.

On mahdollista määrittää, mikä attribuuttitieto kirjoitetaan Jiraan.
Jiraa varten voi olla useita provisiointitehtäviä eri tarkoituksiin.
Jira-tiketin lisäämiseksi on määritettävä vähintään issueType, project ja summary; Jira-määrityksestäsi riippuen mahdollisesti myös muita attribuutteja. Varmista tarvittavat attribuutit Jira-järjestelmästä.

7. Tallenna provisiointitehtävä Save-painikkeesta

8. Seuraava vaihe on määrittää työnkulku käyttämään tätä tapahtumapohjaista tehtävää. Matrix42 Pro/IGA Service Management -alustan työnkulkumoottorista on mahdollista suorittaa provisiointitoimintoja Jiraa kohti. Tämä tarkoittaa, että mitä tahansa saatavilla olevaa toimintoa voidaan ajaa missä tahansa vaiheessa työnkulkua ”Orchestration”-solmun avulla.

Esimerkki Orchestration-solmun asetuksista Jiralle:

Kaksisuuntaisen liittimen määrittäminen

Kaksisuuntaisen liittimen määrittäminen edellyttää, että työnkulun orkestrointisolmut sekä ajastettu ja tapahtumapohjainen tehtävä on määritetty Matrix42 Pro/IGA -ratkaisuun. Tässä luvussa on skenaarioesimerkkejä siitä, miten kaksisuuntainen liitin määritetään Matrix42 Pro/IGA -ratkaisun ja Jira Cloudin välille.

Skenaario 1.

Matrix42 Pro/IGA luo tiketin asiakkaan Jiraan tikettityypin perusteella, ja Jira lähettää tiketin takaisin tilan perusteella.

Luo Generic Event-based task kohteeseen Matrix42 Pro/IGA tikettien luomiseksi, esimerkiksi tässä on tapahtumapohjainen tehtävä, joka käyttää ticket-mallia
Luo työnkulku Ticket-malliin kohteessa Matrix42 Pro/IGA, joka määrittää säännöt sille, milloin tiketti menee Jiraan, esimerkiksi tässä on työnkulku, joka lähettää tiketin Jiraan, kun tila on New, tyyppi on Incident ja tukiryhmä on Software team
Tämän jälkeen, jotta tila saadaan takaisin kohteeseen Matrix42 Pro/IGA tarvitset ajastetun tehtävän, joka lukee Jira-pyyntöjen tilan takaisin kohteeseen Matrix42 Pro/IGA. Esimerkiksi tässä ajastettu tehtävä, joka lukee Jira-tiketit, joiden projekti on ”Efecte tickets” ja tila on Completed

Skenaario 2.

Matrix42 Pro/IGA luo tiketin asiakkaan Jiraan ja päivittää olemassa olevaa tikettiä Jirassa muuttuneilla tiedoilla (description-kenttä on päivitetty).

Luo Generic Event-based task kohteeseen Matrix42 Pro/IGA tikettien luomiseksi, esimerkiksi tässä on tapahtumapohjainen tehtävä, joka käyttää ticket-mallia
Luo työnkulku Ticket-malliin kohteessa Matrix42 Pro/IGA, joka määrittää säännöt sille, milloin tiketti menee Jiraan, esimerkiksi tässä on työnkulku, joka lähettää tiketin Jiraan, kun tila on New, tyyppi on Incident ja tukiryhmä on Software team
Tämän jälkeen, jotta kuvaus saadaan takaisin kohteeseen Matrix42 Pro/IGA tarvitset ajastetun tehtävän, joka lukee Jira-pyyntöjen kuvauksen takaisin kohteeseen Matrix42 Pro/IGA. Esimerkiksi tässä ajastettu tehtävä, joka lukee Jira-tiketit, joiden projekti on ”Efecte tickets” ja tila ei ole Completed

Skenaario 3.

Matrix42 Pro/IGA luo manuaalisen käyttöoikeuspyynnön tikettinä Jiraan, ja tilamuutoksen perusteella se lähetetään takaisin Matrix42 Pro/IGA:han.

Luo Generic Event-based task kohteeseen Matrix42 Pro/IGA tikettien luomiseksi, esimerkiksi tässä on tapahtumapohjainen tehtävä, joka käyttää IGA Administration task -mallia
Luo työnkulku IGA Administration task -malliin kohteessa Matrix42 Pro/IGA, 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 Open ja tehtävän kategoria on Manual access
Tämän jälkeen, jotta tila saadaan takaisin kohteeseen Matrix42 Pro/IGA tarvitset ajastetun tehtävän, joka lukee Jira-pyyntöjen tilan takaisin kohteeseen Matrix42 Pro/IGA. Esimerkiksi tässä ajastettu tehtävä, joka lukee Jira-tiketit, joiden projekti on ”Efecte tickets” ja tila on Completed

Työnkulun toiminnot

Efecte Provisioning Engine (EPE) tarjoaa mahdollisuuden orkestroida seuraavat toiminnot Jiraan.

Add User to Group

Yllä olevassa kuvassa Person-attribuutin määrityksen tulisi osoittaa malliin, josta orkestrointisolmu löytää käyttäjän tiedot (yleensä IGA account). Role-attribuutti on määritettävä osoittamaan, mistä orkestrointisolmu löytää käytettävissä olevat roolit (hakemistoryhmät, joista käyttäjä tulisi poistaa). ”Role attribute” -kentässä voi olla määritettynä yksi tai useampi attribuuttiryhmä. Luettelo käytettävissä olevista rekisteröidyistä hakemistotehtävistä haetaan EPE-masterilta.

Poikkeusten käsittely:

Solmun tulos on tilassa ”Completed” vain, jos käyttäjän kaikki ryhmäjäsenyydet päivitetään onnistuneesti. Jos esimerkiksi käyttäjä poistetaan onnistuneesti viidestä kuudesta ryhmästä, solmun tulos on tilassa ”Exception”.
Tästä syystä distinguishedName-JSON-kentän mappaus vaaditaan sekä Identity- että Access Right -mappauksille. Jos mappausta ei löydy, orkestrointisolmun tulos on ”Exception”-tilassa.
Yritys poistaa käyttäjä ryhmästä, johon hän ei kuulu, päättyy virheeseen.
Yritys lisätä käyttäjä ryhmään, johon hän jo kuuluu, päättyy virheeseen.
Tiedot käyttäjän ryhmäjäsenyyden onnistuneesta/epäonnistuneesta päivityksestä löytyvät lokeista.
Provisioning- ja ryhmäjäsenyyspoikkeukset ovat valinnaisia ominaisuuksia tässä työnkulun solmussa. Ylläpitäjät voivat ottaa nämä ominaisuudet käyttöön, jolloin poikkeukset voidaan kirjoittaa, jos provisiointitoimintojen aikana ilmenee poikkeuksia.

Create user

Uuden käyttäjän luova orkestrointisolmu lukee attribuutit kyseisistä tietokorteista ja suorittaa API-kutsun Jiraan. Created Entity Id -kenttään tulisi täyttää attribuutti, joka sisältää uuden käyttäjän accountID-arvon.

Uuden käyttäjän ensimmäisen kirjautumisen salasanan luomiseen on kaksi tapaa.

Määritä ”Default”-salasana Provisioning Task -määritysnäkymässä
- Tätä salasanaa käyttäjät käyttävät vain kirjautuessaan järjestelmään ensimmäistä kertaa
Satunnaisen salasanan luominen työnkulussa ja sen valitseminen, mihin Identity Mapping -tietokortin attribuuttiin se kirjoitetaan
Mahdollisuus valita, onko salasana vaihdettava ensimmäisellä kirjautumisella vai ei. Ylläpitäjät voivat tehdä tämän valinnan suoraan työnkulun User Creation -orkestrointisolmusta.
Ensimmäisen kirjautumisen salasanan toimittamiseen loppukäyttäjälle on eri tapoja. Asiakkaan tarpeiden mukaan voidaan käyttää työnkulun toimintoja salasanan lähettämiseksi suoraan loppukäyttäjälle sähköpostitse tai tekstiviestillä. 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, vaan se on määritettävä muualla.

Provisioning exception on valinnainen ominaisuus tässä työnkulun solmussa. Ylläpitäjät voivat ottaa tämän ominaisuuden käyttöön, jolloin poikkeukset voidaan kirjoittaa, jos provisiointitoimintojen aikana ilmenee poikkeuksia.

Create Group

Ylläpitäjät valitsevat oikean Jira ”Target”-arvon ja voivat tarkastella määritystä. Uuden ryhmän luova orkestrointisolmu lukee attribuutit kyseisistä tietokorteista ja suorittaa API-kutsun Jiraan.

Created Entity Id -attribuutti mapataan Efecten attribuuttiin, joka sisältää uuden ryhmän groupID-arvon.

Delete Group

Ylläpitäjät valitsevat oikean Jira ”Target”-arvon ja voivat tarkastella määritystä. Ryhmän poistava orkestrointisolmu lukee attribuutit kyseisistä tietokorteista ja suorittaa API-kutsun Jiraan.

Role group attribute on mapattava Efecten attribuuttiin, joka sisältää poistettavan ryhmän groupID-arvon.

Delete User

Ylläpitäjät valitsevat oikean Jira ”Target”-arvon ja voivat tarkastella määritystä. Käyttäjän poistava orkestrointisolmu lukee attribuutit kyseisistä tietokorteista ja suorittaa API-kutsun Jiraan.

Person attribute* on mapattava Efecten attribuuttiin, joka sisältää poistettavan käyttäjän AccountId-arvon.

Remove User from Group

Yllä olevassa kuvassa ylläpitäjät voivat valita oikean Jira ”Target”-arvon.

Person attribute* on mapattava Efecten attribuuttiin, joka sisältää ryhmästä poistettavan käyttäjän AccountId-arvon

Role attribute* on mapattava Efecten attribuuttiin, joka sisältää käyttäjältä poistettavan ryhmän groupID-arvon.

Create Jira Ticket

Yllä olevassa kuvassa ylläpitäjät voivat valita oikean Jira ”Target”-arvon. Target on valittavissa niille epe-tehtäville, jotka sisältävät vähintään attribuutit datasourceid, issuetype, project ja summary. Esimerkiksi

Tunnetut rajoitukset

Kommenttien lukeminen Atlassian Jira Cloudista Matrix42 Pro- tai IGA-ratkaisuun

Jos yrität lukea kommentteja suoraan comments-attribuuttiin Matrix42 Pro- tai IGA-tietokorttiin, kommentit kahdentuvat jokaisella ajastetun tehtävän ajokerralla.

Sen sijaan, että kommentit luettaisiin suoraan comments-attribuuttiin, on käytettävä apuna väliaikaista temp-attribuuttia, johon Jira-kommentti mapataan. Varsinaisia kommentteja päivitetään tämän temp-attribuutin arvon perusteella, jos varsinainen comments-attribuutti ei vielä sisällä kyseistä kommenttia. Tämä voidaan tehdä Matrix42 Core- ja Pro-alustan mukautustyökaluilla. Ota yhteyttä Matrix42-konsultteihin saadaksesi tarkempia tietoja siitä, miten tämä tehdään.

Vianmääritys

Tässä luvussa kuvataan vianmääritysvaihtoehtoja,

Jos failure-mallia käytetään, tarkista virhetiedot oikeasta tietokortista
Tarkista ajastetun tehtävän historia liitinhallinnasta
Tarkista Matrix42 Native Connectors -lokit; ne löytyvät Connectors-välilehdeltä, Logs-osiosta
Tarkista FAQ-dokumentit

Table of Contents

Contact Us

Atlassian Jira Cloud -liitin

Contact Us

Palveluhallinta

Identity Governance and Administration (IGA)

Alusta

Julkaisutiedot M42 Professionalille, IGA:lle ja konversationaaliselle tekoälylle

Muu materiaali

Palvelut

Atlassian Jira Cloud -liitin

Learn how to configure the Atlassian Jira Cloud Connector to synchronize your Jira tickets, users, groups and permissions

Atlassian Jira Cloud -liitin

Yleiset toiminnot

Yleiset toiminnot

Connectors - general functionalities

Left menu

Connectors overview tab

Scheduled task information (click arrow front of the connector)

Scheduled task history view

Edit window for scheduled task

Event task information

Edit window for event task

Authentication tab

Authentication task information

Logs tab

Settings tab

Yleisiä ohjeita ajastetuille tehtäville

Yleisiä ohjeita ajastetuille tehtäville

How to Create New Scheduled Task to import data

For configuring scheduled-based provisioning task, you will need access to Administration / Connectors tab.

Should I use Incremental, Full or Both?

Do not import permissions with AD and LDAP incremental task

Tasks internal cache

Beginning from version 2026.1.1

Versions before 2026.1.1

Recommendations

Recommended Scheduling Sequence

Recommended scheduling sequence, depends how much data is read from Customers system/directory to the Matrix42 Core, Pro or IGA solution and is import Incremental or Full.

Set removed accounts and entitlements status removed/disabled

For version 2025.3 and newer

Unique check added on 26.2 version

For version 2025.2 and older

Configuration

Description

Notes

Jira Cloud -liittimen määrittäminen

Miten luoda uusi Jira-liitin

Vaiheittaiset ohjeet ajastetun tehtävän luomiseen

Miten luoda uusi ajastettuun tehtävään perustuva tehtävä

Vaiheittaiset ohjeet tapahtumapohjaisen tehtävän luomiseen

Kaksisuuntaisen liittimen määrittäminen

Työnkulun toiminnot

Add User to Group

Create user

Create Group

Delete Group

Delete User

Remove User from Group

Create Jira Ticket

Tunnetut rajoitukset

Kommenttien lukeminen Atlassian Jira Cloudista Matrix42 Pro- tai IGA-ratkaisuun

Vianmääritys

Related Articles