Łącznik Atlassian Jira Cloud
Jak zintegrować się z Atlassian Jira Cloud
Łącznik Atlassian Jira Cloud
Jak zintegrować się z Atlassian Jira Cloud
Łącznik Atlassian Jira Cloud
Łącznik Atlassian Jira Cloud (dawniej Jira Connector) służy do odczytywania (użytkowników, grup, zgłoszeń) i zapisywania informacji w rozwiązaniu Atlassian Jira Cloud dla klientów.
Łącznik Atlassian Jira Cloud wymaga konfiguracji zgodnie z przypadkiem użycia klienta, a konfiguracja zasadniczo składa się z trzech (3) kroków:
- Konfiguruj łącznik — umożliwia łącznikowi nawiązanie połączenia z klientami Atlassian Jira Cloud
- Skonfiguruj zadanie zaplanowane — używane, gdy dane są odczytywane z chmury Atlassian Jira Cloud klienta
- Zadanie konfiguracji zdarzenia — używane, gdy dane są zapisywane w usłudze Atlassian Jira Cloud dla klientów
- Wymagana jest również konfiguracja węzłów koordynacji przepływu pracy
- Wymagana jest również konfiguracja węzłów koordynacji przepływu pracy

Instrukcje dotyczące wersji 2024.2 i nowszych
Ogólne funkcjonalności
Łączniki – funkcjonalności ogólne
Łączniki – funkcjonalności ogólne
W tym artykule opisano ogólne funkcje zarządzania natywnymi konektorami w rozwiązaniu. Wszystkimi natywnymi konektorami zarządza się z poziomu tego samego interfejsu użytkownika.
Należy zwrócić uwagę, że dla każdego złącza istnieją osobne opisy, w których szczegółowo opisano konkretne funkcjonalności złącza i instrukcje konfiguracji.
Aby uzyskać dostęp do zarządzania konektorami, użytkownik musi posiadać uprawnienia administratora do konfiguracji platformy klienta. Po prawidłowym przyznaniu dostępu, karta konektora będzie widoczna i użytkownik będzie mógł zarządzać konektorami.

Menu lewe
Zarządzanie złączami jest podzielone na cztery zakładki:

- Przegląd – do tworzenia i aktualizowania natywnych łączników. Użytkownik z uprawnieniami administratora może zobaczyć ich status, typ oraz liczbę zaplanowanych zadań lub zdarzeń z nimi powiązanych.
- Uwierzytelnianie – do tworzenia i aktualizowania zadań uwierzytelniania. Pro uwierzytelniania jest niezbędne, aby Secure Access mógł zdefiniować, którzy użytkownicy końcowi Klienta mają dostęp do strony logowania Matrix42 Core , Pro and IGA .
- Dzienniki - do pobierania dzienników Native Connector i Secure Access z interfejsu użytkownika.
- Ustawienia – ogólne ustawienia dla łączników natywnych i Secure Access , obejmujące typ środowiska do rejestrowania i monitorowania.
Karta przeglądu złączy
Na stronie przeglądu użytkownik może łatwo i szybko sprawdzić status wszystkich złączy.

Górny pasek:
- Status łączników natywnych (EPE)
- Zielony tekst oznacza, że Native Connectors jest online. Wszystkie potrzebne usługi są aktywne i działają.
- Czerwony tekst oznacza, że wystąpił problem z Native Connectors, wszystkie usługi nie są uruchomione.
- Status Secure Access ( ESA )
- Zielony tekst oznacza, że Secure Access jest online. Wszystkie potrzebne usługi są uruchomione i działają.
- Czerwony tekst oznacza, że wystąpił problem z Secure Access , żadna usługa nie jest uruchomiona.
- Numer wersji łączników natywnych wyświetlany jest w prawym górnym rogu
Górny pasek widoku listy:

- Nowy łącznik – otwiera nowe okno umożliwiające dodanie i skonfigurowanie nowego łącznika
- Usuń łącznik(i) — odniesienia do przepływu pracy zostaną obliczone i pojawi się okno dialogowe z prośbą o potwierdzenie usunięcia (należy pamiętać, że obliczanie odniesień może potrwać kilka sekund)
- Eksport – Administrator może wyeksportować jeden lub więcej konektorów (i zadań) ze środowiska. Zwykle używane do eksportowania konektorów i konektorów (i zadań) z testów do produkcji. Poufne informacje o konektorach natywnych są chronione hasłem.
- Import – Administrator może zaimportować jeden lub więcej konektorów (i zadań) do środowiska. Zazwyczaj używane do importowania konektorów (i zadań) z testów do produkcji.
- Administrator nie może importować ze starego interfejsu użytkownika EPE (starszego niż 2024.1) do nowego. Środowiska źródłowe i docelowe muszą mieć tę samą wersję.
- Import nie powiedzie się, jeśli konfiguracja (szablony, atrybuty) będzie inna – na przykład gdy brakuje jakiegoś atrybutu
- Jeśli importujesz coś z tymi samymi szczegółami łącznika, zostanie to scalone w ramach istniejącego łącznika
- Odśwież — administrator może odświeżyć widok łączników, klikając przycisk .
Widok listy w celu przeglądu,

- Wybierz złącze(a) — wybierz jedno złącze, klikając pole wyboru przed rzędem złącza lub klikając pole wyboru w rzędzie nagłówka, co spowoduje wybranie wszystkich złączy
- Identyfikator – automatycznie generowany, unikalny identyfikator łącznika. Nie można go edytować ani zmieniać.
- Status – wskazuje status zaplanowanego zadania
-
Zielony znacznik wyboru – zadanie zostało wykonane bez żadnych błędów
-
Czerwony krzyżyk – zadanie zostało wykonane, ale wystąpiły błędy
-
Szary zegar – zadanie nie zostało jeszcze wykonane, oczekiwanie na zaplanowanie -
Pomarańczowy - jedno z zadań ma problem
- Brak wartości — brak zaplanowanego zadania
-
- Nazwa – nazwa łącznika dodana do ustawień łącznika. Unikalna nazwa łącznika przechowującego konfigurację dla jednego źródła danych.
- Typ – wskazuje system docelowy/źródłowy
- Zaplanowane – informuje o liczbie skonfigurowanych zaplanowanych zadań
- Wydarzenie – informuje o liczbie skonfigurowanych zadań zdarzeń
- Zarządzać
- Ikona pióra – otwiera ustawienia łącznika (dwukrotne kliknięcie rzędu łączników również otwiera ustawienia)
- Ikona papieru - kopiuje złącze
- Zatrzymaj – odniesienia do przepływu pracy są obliczane i pojawia się okno dialogowe z prośbą o potwierdzenie usunięcia
- Wyszukiwanie – Użytkownik może wyszukiwać złącze, wpisując termin wyszukiwania w odpowiednim polu. Można wyszukiwać w polach Identyfikator, Status, Nazwa, Typ, Zaplanowane i Zdarzenie.
Informacje o zaplanowanym zadaniu (kliknij strzałkę z przodu łącznika)
Po kliknięciu strzałki na początku wiersza łącznika wyświetlane są wszystkie powiązane zadania zaplanowane i zdarzenia

Górny pasek zadań zaplanowanych
- Nowe zadanie – otwiera stronę konfiguracji nowego zadania
- Usuń zadanie(a) – usuwa wybrane zadanie(a) z systemu i nie będzie można ich już odzyskać.
- Odśwież – odśwież widok zadań opartych na harmonogramie
- Szukaj - użytkownik może wyszukiwać zadania, wpisując termin wyszukiwania w odpowiednim polu, aby określić identyfikator, nazwę, włączenie, status wyodrębnienia/załadowania.
Widok listy zaplanowanych zadań

- Wybierz zadanie(a) - Wybierz zadanie, które chcesz usunąć, z widoku listy, zaznaczając je.
- Id – unikalny identyfikator zadania. Generowany automatycznie i nie można go zmienić.
- Nazwa - Nazwa zadania dodana do ustawień zadania, unikalna nazwa zadania.
- Włączone – wyświetla, czy zadanie jest zaplanowane, czy nie
-
Zielony znacznik wyboru – zadanie jest zaplanowane
-
Czerwony krzyżyk – zadanie nie jest zaplanowane
-
- Status ekstrakcji – wyświetla status ekstrakcji danych z docelowego katalogu/systemu
-
Zielony znacznik wyboru – dane zostały pomyślnie wyodrębnione
-
Czerwony krzyżyk – dane zostały wyodrębnione z błędem(ami) lub wyodrębnienie nie powiodło się
-
Zegar - Zadanie oczekuje na wykonanie
-
- Status ładowania — wyświetla status eksportu danych z pliku JSON do rozwiązania klienta
-
Zielony znacznik wyboru – dane zostały pomyślnie zaimportowane do rozwiązania klienta
-
Czerwony krzyżyk – dane zostały zaimportowane z błędem(ami) lub import się nie powiódł
-
- Zarządzać
- Ikona pióra – otwiera ustawienia zadania w osobnym oknie (dwukrotne kliknięcie wiersza zadania również otwiera ustawienia zadania)
- Ikona papieru – kopiuje zadanie
- Ikona zegara – otwiera widok historii zadań
- Zatrzymaj - usuń zadanie, otwiera się okno pop-up z potwierdzeniem usunięcia
Widok historii zaplanowanych zadań
Po kliknięciu ikony zegara w wierszu zaplanowanego zadania zostanie wyświetlona historia harmonogramu.

Górny pasek historii wyświetleń
- Odśwież – odświeża status zaplanowanego zadania. Nie ma to wpływu na zadanie, aktualizuje jedynie interfejs użytkownika, aby wyświetlić najnowsze informacje o uruchomieniu zadania.
Widok listy dla historii zaplanowanych zadań
- Kolor wiersza wskazuje status
-
Zielony – zadanie wykonane pomyślnie
-
Czerwony – wystąpił błąd podczas wykonywania
-
- Identyfikator wykonania – unikalny identyfikator wiersza zaplanowanego zadania
- Planowany czas wyodrębniania – kiedy planowane jest następne wyodrębnianie z katalogu/aplikacji
- Czas zakończenia ekstrakcji – kiedy ekstrakcja została ukończona
- Status ekstrakcji – status pobierania danych z katalogu/aplikacji
- Czas rozpoczęcia ładowania – kiedy planowane jest kolejne ładowanie dla klientów
- Czas ukończenia ładowania – kiedy ładowanie zostało ukończone
- Status ładowania – status ładowania informacji do rozwiązania klienta
Widok listy dla statusu zaplanowanego zadania
- Rzeczywisty czas rozpoczęcia – znacznik czasu rzeczywistego rozpoczęcia
- Plik użytkownika – plik JSON zawierający informacje o użytkowniku odczytane z katalogu/aplikacji
- Plik grupy – plik JSON zawierający informacje o grupie odczytane z katalogu/aplikacji
- Plik ogólny — plik JSON zawierający ogólne informacje odczytane z katalogu/aplikacji
- Wyodrębnij informacje – szczegółowe informacje o odczycie informacji z katalogu/aplikacji
- Informacje o załadowaniu - szczegółowe informacje o załadowaniu informacji do klientów Matrix42 Core , Pro and IGA
Okno edycji zaplanowanego zadania
Konfigurację zadania zaplanowanego można otworzyć, klikając ikonę pióra lub klikając dwukrotnie wiersz zadania.
Menu po lewej stronie oraz atrybuty różnią się w zależności od wybranych opcji, dlatego bardziej szczegółowe instrukcje dotyczące edycji zadań można znaleźć w opisie łącznika. Istnieją jednak wspólne funkcjonalności dla wszystkich zaplanowanych zadań, które opisano poniżej.

Zapisywanie zadania
Jeśli w zadaniu brakuje obowiązkowych informacji, najechanie kursorem myszy na przycisk zapisywania pokaże, które atrybuty są nadal puste.
Górny pasek do edycji zaplanowanego zadania
- Uruchom zadanie ręcznie — administrator może uruchomić zadanie ręcznie poza zdefiniowanym harmonogramem
- Zatrzymaj zadanie – administrator może zatrzymać aktualnie uruchomione zadanie zaplanowane. Zadanie zostanie zatrzymane, a jego status zmieni się na zatrzymany. Zadanie będzie w tym stanie czekać do następnego momentu.
- Wyczyść pamięć podręczną danych – pamięć podręczna danych dla następnego uruchomienia użytkowników i grup zostanie wyczyszczona. Oznacza to, że następne uruchomienie zostanie wykonane tak samo jak pierwsze.
- Domyślnie pamięć podręczną czyścimy codziennie o godzinie 00:00 UTC
- Jeśli chcesz wyczyścić pamięć podręczną w innym czasie, musisz określić inną wartość w pliku hosta „custom.properties”.
- Pamięć podręczna EPE jest również czyszczona po ponownym uruchomieniu EPE, po ponownym uruchomieniu całego środowiska zmieniane są mapowania EPE
Informacje o zadaniu wydarzenia
Po kliknięciu strzałki na początku wiersza łącznika wyświetlane są wszystkie powiązane zadania zaplanowane i zdarzenia

Górny pasek zadań zdarzeń
- Nowe zadanie – otwiera stronę konfiguracji dla nowego zadania zdarzenia
- Usuń zadanie(a) – usuwa wybrane zadanie(a), pojawia się okno pop-up z prośbą o potwierdzenie usunięcia
- Odśwież – odświeża widok zadań zdarzeń
- Pokaż odwołania do przepływów pracy – oblicza relacje i statusy przepływów pracy związane z zadaniami. Jest to bardzo przydatne, jeśli nie wiesz, z których przepływów pracy pochodzą zadania oparte na zdarzeniach.
Widok listy zadań zdarzeń
- Wybierz zadanie(a) - Wybierz zadanie, które chcesz usunąć, z widoku listy, zaznaczając je.
- Id – unikalny identyfikator zadania. Generowany automatycznie i nie można go zmienić.
- Nazwa - Nazwa zadania dodana do ustawień zadania, unikalna nazwa zadania.
- Relacje przepływu pracy
- Znak zapytania wyświetla okno podręczne ze szczegółowymi informacjami o odniesieniu
- Status przepływu pracy
- Nieużywane – brak powiązań z przepływem pracy
- W użyciu — do zadania dołączono przepływ(y) pracy, zadania nie można usunąć
- Zarządzać
- Ikona pióra – otwiera ustawienia zadania w osobnym oknie
- Ikona papieru – kopiuje zadanie
- Ikona Stop – usuwa zadanie, pojawia się okno pop-up z prośbą o potwierdzenie usunięcia
Okno edycji zadania zdarzenia
Konfigurację zadania zdarzenia można otworzyć, klikając ikonę pióra lub klikając dwukrotnie wiersz zadania.
Menu po lewej stronie oraz atrybuty różnią się w zależności od wybranych opcji, dlatego bardziej szczegółowe instrukcje dotyczące edycji zadań można znaleźć w opisie łącznika. Istnieją jednak wspólne funkcjonalności dla wszystkich zadań zdarzeń, które opisano poniżej.

Edytuj okno zadania zdarzenia
- Użycie zadania, edytowalne? — pojawia się, gdy edycja istniejącego zadania i zmiana typu użycia zadania spowoduje przerwanie przepływów pracy
- Typ mapowania, edytowalny? - pojawia się, gdy edycja istniejącego zadania i zmiana typu mapowania spowoduje przerwanie przepływów pracy
Zapisywanie zadania
Jeśli w zadaniu brakuje obowiązkowych informacji, najechanie kursorem myszy na przycisk zapisywania pokaże, które atrybuty są nadal puste.
Karta uwierzytelniania
Uwierzytelnianie dla rozwiązań Matrix42 Core , Pro and IGA konfiguruje się na karcie uwierzytelniania. Należy pamiętać, że tylko niektóre łączniki (łączniki katalogowe) obsługują uwierzytelnianie, więc nie jest możliwe utworzenie zadań uwierzytelniania dla wszystkich dostępnych łączników.

Górny pasek do uwierzytelniania
- Nowy łącznik – otwiera nowe okno umożliwiające skonfigurowanie nowego łącznika (należy pamiętać, że nie wszystkie łączniki obsługują uwierzytelnianie)
- Usuń łącznik(i) – usuwa wybrane zadania, pojawia się okno pop-up z prośbą o potwierdzenie usunięcia
- Eksport – użytkownik może wyeksportować jedno lub więcej zadań ze środowiska. Zazwyczaj używane do eksportowania zadań z testów do produkcji. Złącza EPE są chronione hasłem.
- Należy pamiętać, że obszar zadań uwierzytelniania nie jest eksportowany, należy go ustawić ręcznie po zaimportowaniu
- Import – użytkownik może zaimportować jedno lub więcej zadań do środowiska. Zazwyczaj używane do importowania zadań z testów do produkcji.
- Odśwież – odświeża widok zadań uwierzytelniania
Widok listy do przeglądu uwierzytelniania
- Wybierz złącze(a) — wybierz jedno złącze, klikając pole wyboru przed rzędem złącza lub klikając pole wyboru w rzędzie nagłówka, co spowoduje wybranie wszystkich złączy
- Identyfikator – automatycznie generowany, unikalny identyfikator łącznika. Nie można go edytować ani zmieniać.
- Nazwa – nazwa łącznika dodana do ustawień łącznika. Unikalna nazwa łącznika przechowującego konfigurację dla jednego źródła danych.
- Typ – wskazuje system docelowy/źródłowy
- Liczba – informuje, ile zadań uwierzytelniania jest skonfigurowanych
- Zarządzać
- Ikona pióra – otwiera ustawienia zadania uwierzytelniania w osobnym oknie
- Ikona papieru – kopiuje zadanie
- Ikona Stop – usuwa wybrane zadanie
Informacje o zadaniu uwierzytelniania
Po kliknięciu strzałki na początku wiersza łącznika wyświetlane są wszystkie powiązane zadania zaplanowane i zdarzenia

Górny pasek do przeglądu uwierzytelniania
- Utwórz nowe zadanie – otwiera stronę konfiguracji dla nowego zadania uwierzytelniania
- Usuń zadanie(a) – usuwa wybrane zadanie(a), pojawia się okno pop-up z prośbą o potwierdzenie usunięcia
- Odśwież – odświeża widok zadań uwierzytelniania
Widok listy do przeglądu uwierzytelniania,
- Wybierz zadanie(a) - Wybierz zadanie, które chcesz usunąć, z widoku listy, zaznaczając je.
- Id – unikalny identyfikator zadania. Generowany automatycznie i nie można go zmienić.
- Nazwa - Nazwa zadania dodana do ustawień zadania, unikalna nazwa zadania.
- Zarządzać
- Ikona pióra – otwiera ustawienia zadania w osobnym oknie (dwukrotne kliknięcie wiersza zadania otwiera również okno ustawień)
- Ikona papieru – kopiuje zadanie
- Ikona Stop – usuwa zadanie, pojawia się okno pop-up z prośbą o potwierdzenie usunięcia
Karta dzienników
Karta dzienników umożliwia pobranie dzienników Native Connector i Secure Access z interfejsu użytkownika w celu przeprowadzenia szczegółowego rozwiązywania problemów.

- Dzienniki epe-master — zawierają ostrzeżenia, komunikaty debugowania i komunikaty o błędach dotyczące natywnych łączników, a także informacje o tym, jak długo trwały działania związane z zadaniami.
- Dzienniki epe-worker-ad – zawierają wyciąg danych o stanie konektora Active Directory (co Native Connector ładuje do klientów korzystających z rozwiązań Matrix42 Core , Pro and IGA ). Jeśli zaznaczenie jest puste, oznacza to, że katalog nie jest używany w tym środowisku.
- Dzienniki epe-worker-azure – zawierają status danych ekstraktu Entra ID (dane, które Native Connector ładuje do rozwiązań Matrix42 Core , Pro and IGA ). Jeśli zaznaczenie jest puste, oznacza to, że katalog nie jest używany w tym środowisku.
- Dzienniki epe-worker-ldap – zawierają status ekstrakcji danych LDAP (dane, które Native Connector ładuje do klientów korzystających z rozwiązań Matrix42 Core , Pro and IGA ). Jeśli zaznaczenie jest puste, oznacza to, że katalog nie jest używany w tym środowisku.
- Dzienniki epe-launcher – zawierają informacje o uruchomieniach EPE
- datapump-itsm logi - Zawiera informacje o eksporcie danych do rozwiązań klientów Matrix42 Core , Pro and IGA .
- esa logs - Zawiera informacje o uwierzytelnianiu Secure Access .
Karta Ustawienia
Karty ustawień służą do monitorowania środowisk z łącznikami.

- Typ środowiska - musi być wybrany i informacja ta jest wykorzystywana na przykład do krytycznego definiowania alertu.
- Test – wybierz tę opcję, jeśli Twoje środowisko jest używane jako środowisko testowe
- Pro d – wybierz tę opcję, jeśli Twoje środowisko jest używane jako środowisko produkcyjne
- Demo – wybierz tę opcję, jeśli Twoje środowisko jest używane jako demo lub środowisko szkoleniowe
- Dev – wybierz tę opcję, jeśli Twoje środowisko jest używane jako środowisko programistyczne
Co monitorujemy?
- Niepowodzenia w planowanym udostępnianiu (wyodrębnianie danych, eksportowanie danych do ESM, nieaktualne certyfikaty, nieprawidłowe hasła, nieprawidłowa baza wyszukiwania/filtr, nieprawidłowe mapowania itp.)
- Niepowodzenia w obsłudze zdarzeń (brak zapisu do AD / Azure itp.)
- Dostarczanie oparte na zdarzeniach – które łączniki są używane do zapisywania danych w aplikacjach/katalogach.
- ESA ponad dziesięć nieudanych prób logowania do jednego użytkownika w ciągu ostatnich 3 dni
- Typ środowiska - musi być wybrany i informacja ta jest wykorzystywana na przykład do krytycznego definiowania alertu.
Migracje danych
Nie klikaj opcji „Migruj mapowania atrybutów” ani „Migruj przepływy pracy”, jeśli nie zostaniesz o to poproszony przez Matrix42 .
Skonfiguruj łącznik Jira Cloud
Jak utworzyć nowy łącznik Jira
Aby skonfigurować provisioning, będziesz potrzebować dostępu do konsoli konfiguracji platformy Efecte.
1. Otwórz obszar administracji Efecte (symbol koła zębatego).
2. Otwórz widok Złącza.
3. Wybierz Nowy łącznik 
4. Wybierz typ źródła danych: Atlassian Jira

5. Uzupełnij informacje dotyczące rozwiązania Jira
- Nazwa złącza – nadaj złączu przyjazną nazwę (nazwę można później zmienić)
- Adres URL hosta – adres hosta, który będzie używany do łączenia się z rozwiązaniem Efecte
- Nazwa użytkownika – techniczna nazwa użytkownika z Jira
- Token dostępu -

6. Uzupełnij informacje dotyczące rozwiązania Efecte
- Użytkownik API internetowego — nazwa użytkownika API internetowego rozwiązania Efecte
- Lista wszystkich lokalnych użytkowników Efecte
- Hasło do API internetowego - Hasło użytkownika interfejsu API internetowego Efecte Solutions

7. Zapisz informacje o złączu.
7. Po zapisaniu szczegółów łącznika możesz nacisnąć przycisk testu połączenia i sprawdzić, czy łącznik może połączyć się z docelowym rozwiązaniem Efecte.
9. Jeśli edytujesz istniejące dane łącznika, pamiętaj, aby zapisać zmiany i przetestować połączenie.
Skonfiguruj zadanie zaplanowane do odczytu danych
Łącznik Jira służy do odczytywania informacji o użytkownikach, grupach i zgłoszeniach z Jira. Jest on konfigurowany z poziomu platformy Efecte poprzez tworzenie zadań łącznika opartych na harmonogramie.
Jak utworzyć nowe zadanie oparte na harmonogramie
Aby skonfigurować zaplanowane zadanie łącznika, potrzebny jest dostęp do konsoli konfiguracji platformy Efecte. Uwaga! Jeśli łącznik nie zostanie utworzony, należy najpierw utworzyć „nowy łącznik”, a następnie można tworzyć nowe zadania.
1. Otwórz widok konfiguracji platformy Efecte (symbol koła zębatego).
2. Otwórz widok Złącza.
3. Wybierz opcję „Connector” dla zadania opartego na harmonogramie i wybierz nowe zadanie

4. Zdefiniuj harmonogram zadania (czy i jak zaplanowane zadanie powinno być uruchamiane okresowo). Wybierz kolejność harmonogramowania, która zależy od ilości danych odczytywanych przez klientów.

5. Wypełnij szczegóły zadania
- Wpisz unikalną nazwę zadania dla zaplanowanego zadania. Pamiętaj, że nazwy tej nie można później zmienić.
- Użycie zadania wskazuje, że jest to zadanie służące do odczytu lub zapisu danych. Należy pamiętać, że późniejsza zmiana typu zdarzenia może spowodować przerwanie przepływów pracy.
- Typ mapowania zależy od typu informacji odczytywanej z katalogu
- Tożsamość i prawa dostępu – używane podczas odczytywania z aplikacji informacji o użytkownikach i grupach Jira
- Pojedynczy (tylko tożsamość) – używany, gdy z Jira klienta odczytywane są tylko informacje o użytkowniku Jira
- Pojedynczy (tylko prawo dostępu) – używany, gdy z Jira klientów odczytywane są tylko informacje o grupie Jira
- Ogólne (jeden szablon) – używane, gdy inne elementy Jira są odczytywane z Jira klienta, na przykład historie, zgłoszenia, błędy itp.
- Zapytanie Jira -

6. Uzupełnij informacje o błędach. Opcjonalne ustawienia obsługi błędów. Jeśli zaplanowane zadanie zakończy się niepowodzeniem, może utworzyć kartę danych w rozwiązaniu Efecte, która wyświetla błąd. Jeśli ustawienia błędów są zdefiniowane, administrator nie musi ręcznie sprawdzać statusu zaplanowanych zadań.
- Szablon błędu — wybierz szablon karty danych, który zostanie utworzony w przypadku wystąpienia błędów podczas odczytu danych (połączenie ze źródłami danych, przekroczenie limitu czasu itp.).
- Folder awarii – wybierz folder, w którym będzie przechowywana karta danych awarii.
- Atrybut awarii — wybierz atrybut, w którym w szablonie awarii mają być przechowywane informacje o błędzie.

7. Uzupełnij mapowania
Obowiązkowe jest ustawienie szablonu docelowego i folderu, identyfikatora źródła danych oraz unikalnych wartości identyfikatora, które służą do identyfikacji danych między klientami Jira i rozwiązaniem Efecte.
- Szablon docelowy — wybierz szablon, aby zdefiniować mapowania atrybutów
- Folder docelowy – wybierz folder z listy folderów. Lista jest zawężana w celu dopasowania do wybranego szablonu.
- Można ustawić dodatkowe atrybuty odczytywane z Jira, wybierając opcję Nowy atrybut
- Mapowania atrybutów
- Atrybut szablonu Efecte - do którego atrybutu w katalogu Efecte jest mapowany atrybut.
- Atrybut Jira — który atrybut z Jira jest mapowany na Efecte

8. Zapisz zadanie za pomocą przycisku Zapisz. Jeśli brakuje niektórych wymaganych atrybutów, przycisk Zapisz jest wyświetlany na szaro i wyświetla brakujące elementy w ustawieniach.

9. Skonfigurowałeś teraz zadanie łącznika oparte na harmonogramie, aby odczytać dane z Jira do swojego rozwiązania
- Teraz możesz poczekać, aż zadanie zostanie rozpoczęte zgodnie z harmonogramem lub
- Uruchom zadanie ręcznie – klikając przycisk, zadanie jest konfigurowane do natychmiastowego uruchomienia. Zazwyczaj w przypadku uruchomień testowych lub gdy nie chcesz zmieniać ustawień harmonogramu, ale chcesz uruchomić zadanie od razu.
Skonfiguruj zadanie zdarzenia do zapisu danych
Zadanie zdarzenia jest wykorzystywane podczas zapisywania danych w rozwiązaniu Atlassian Jira Cloud . Cała konfiguracja związana z zadaniami opartymi na zdarzeniach jest konfigurowana na platformie Matrix42 Core , Pro lub IGA .
- Otwórz widok konfiguracji platformy (symbol koła zębatego).
- Otwórz widok złączy
- Wybierz łącznik, który będzie korzystał z zadania zdarzenia
- Wybierz „nowe zadanie” pod właściwym łącznikiem

4. Wypełnij szczegóły zadania
- Nazwa zadania — podaj nazwę zadania, która będzie wyświetlana w widoku zadań opartych na zdarzeniach.
- Dobrą praktyką jest nadawanie zadaniu nazwy opisującej jego cel.
- Użycie zadania wskazuje, że jest to zadanie używane do odczytu lub zapisu danych. Można to później zmienić, ale nie jest to zalecane, jeśli zadanie zdarzenia jest w użyciu. Spowoduje to przerwanie przepływów pracy.
- Typ mapowania zależy od typu informacji odczytanych z katalogu. Wybory mapowania tożsamości są wyświetlane na podstawie tego ustawienia.
- Tożsamość i prawa dostępu – używane, gdy informacje o użytkownikach i grupach Jira są zapisywane w aplikacji
- Pojedynczy (tylko tożsamość) – używany, gdy zapisywane są tylko informacje o użytkowniku Jira
- Pojedynczy (tylko prawo dostępu) – używany, gdy z Jira klientów odczytywane są tylko informacje o grupie Jira
- Ogólne (jeden szablon) – używane, gdy inne elementy Jira są odczytywane z Jira klienta, na przykład historie, zgłoszenia, błędy itp.

5. Wypełnij informacje dotyczące bezpieczeństwa
Informacje te są potrzebne, jeśli proces tworzenia użytkownika w przepływie pracy jest dołączony do zadania.
- Hasło do pierwszego logowania - domyślne hasło, które jest takie samo dla wszystkich użytkowników. W trakcie pracy generowane jest losowe hasło, które zwykle jest unikalne.
- Domyślne hasło / wpisz w polu poniżej
- Hasło domyślne – wpisz hasło domyślne, które jest takie samo dla wszystkich użytkowników i spełnia wymagania dotyczące hasła w katalogu. Pamiętaj, że liczba znaków nie odzwierciedla rzeczywistej długości hasła.
- Losowe hasło / generuj w przepływie pracy
- Wygenerowane hasło
- Domyślne hasło / wpisz w polu poniżej

6. Zdefiniuj mapowania
- Szablon docelowy — wybierz szablon, aby zdefiniować mapowania atrybutów
- Folder docelowy – wybierz folder z listy folderów. Lista jest zawężana w celu dopasowania do wybranego szablonu.
- Mapowania atrybutów
- Atrybut szablonu Efecte - do którego atrybutu w katalogu Efecte jest mapowany atrybut.
- Atrybut katalogu – który atrybut z Jira jest mapowany na Efecte
- Dodaj nowy atrybut - Możliwe jest ustawienie dodatkowych atrybutów, które są odczytywane przez Jira, poprzez wybranie przycisku Nowy atrybut.
Na przykład tutaj używane są mapowania ogólne, a Efecte tworzy zgłoszenia do Jira

8. Zapisz zadanie provisioningowe za pomocą przycisku „Zapisz”. Jeśli brakuje jakichkolwiek obowiązkowych informacji, nie można zapisać zadania, a przycisk „Zapisz” wyświetli brakujące informacje.

9. Następnym krokiem jest skonfigurowanie przepływu pracy w celu wykorzystania tego zadania opartego na zdarzeniach. Z poziomu silnika przepływu pracy w platformie Efecte możliwe jest wykonywanie działań provisioningowych w odniesieniu do usług Jira klienta. Oznacza to, że dowolną z dostępnych aktywności węzłów orkiestracji można uruchomić w dowolnym momencie przepływu pracy.
Odniesienia do przepływów pracy są wyświetlane na stronie przeglądu łącznika,

Skonfiguruj złącze dwukierunkowe
Konfigurowanie dwukierunkowego konektora wymaga, aby węzły orkiestracji przepływu pracy oraz zadania zaplanowane i oparte na zdarzeniach były skonfigurowane w rozwiązaniu Efecte. W tym rozdziale przedstawiono przykładowe scenariusze konfiguracji dwukierunkowego konektora między rozwiązaniem Efecte a Jira Cloud .
Scenariusz 1.
Efecte tworzy dla klientów Jira zgłoszenie na podstawie typu zgłoszenia, a Jira odsyła zgłoszenie na podstawie statusu.
- Utwórz ogólne zadanie oparte na zdarzeniu w programie Efecte do tworzenia biletów. Na przykład tutaj jest zadanie oparte na zdarzeniu, które wykorzystuje szablon biletu.

- Utwórz szablon przepływu pracy do zgłoszenia w Efecte, który definiuje reguły dotyczące momentu, w którym zgłoszenie trafia do Jira. Na przykład tutaj jest przepływ pracy, który wysyła zgłoszenie do Jira, gdy status to Nowy, typ to Incydent, a grupa wsparcia to Zespół ds. oprogramowania.

- Następnie, aby przywrócić status do Efecte, potrzebne jest zaplanowane zadanie, które odczyta status żądań Jira do Efecte. Na przykład, tutaj zaplanowane zadanie odczytuje zgłoszenia Jira, które zawierają zgłoszenia projektu Efecte i mają status „Zakończone”.
Scenariusz 2.
Efecte tworzy zgłoszenie do klienta w Jira i aktualizuje istniejące zgłoszenie w Jira, wprowadzając zmienione informacje (pole opisu zostało zaktualizowane).
- Utwórz ogólne zadanie oparte na zdarzeniu w programie Efecte do tworzenia biletów. Na przykład tutaj jest zadanie oparte na zdarzeniu, które wykorzystuje szablon biletu.

- Utwórz szablon przepływu pracy do zgłoszenia w Efecte, który definiuje reguły dotyczące momentu, w którym zgłoszenie trafia do Jira. Na przykład tutaj jest przepływ pracy, który wysyła zgłoszenie do Jira, gdy status to Nowy, typ to Incydent, a grupa wsparcia to Zespół ds. oprogramowania.

- Następnie, aby przesłać opis do Efecte, potrzebne jest zaplanowane zadanie, które odczyta opis żądań Jira z powrotem do Efecte. Na przykład, tutaj zaplanowane zadanie odczytuje zgłoszenia Jira, które mają zgłoszenia projektu Efecte, a ich status to „Zakończone”.

Scenariusz 3.
Efecte tworzy ręczny wniosek o przyznanie uprawnień dostępu w formie zgłoszenia do Jira, a następnie na podstawie zmiany statusu jest on odsyłany do Efecte.
- Utwórz ogólne zadanie oparte na zdarzeniach w programie Efecte do tworzenia zgłoszeń. Na przykład tutaj jest zadanie oparte na zdarzeniach, które wykorzystuje szablon zadania administracji IGA

- Utwórz szablon zadania przepływu pracy dla administracji IGA w Efecte, który definiuje reguły dotyczące momentu, w którym zadanie trafia do Jira. Na przykład tutaj jest przepływ pracy, który wysyła zadanie do Jira, gdy jego status to Otwarte, a kategoria zadania to Dostęp ręczny.

- Następnie, aby przywrócić status do Efecte, potrzebne jest zaplanowane zadanie, które odczyta status żądań Jira do Efecte. Na przykład, tutaj zaplanowane zadanie odczytuje zgłoszenia Jira, które zawierają zgłoszenia projektu Efecte i mają status „Zakończone”.
Instrukcje dla wersji 2024.1 i starszych
Konfiguruj zadanie oparte na harmonogramie
1. Otwórz obszar Administracji Efektów (symbol koła zębatego) w prawym górnym rogu. 
2. Otwórz widok IGA

3. Wybierz Dodaj nowe zadanie

4. Wybierz Atlassian Jira z listy Dodaj nowe zadanie 
Uwaga! Typ mapowania musi być ustawiony na Tożsamość i uprawnienia dostępu, jeśli celem są użytkownicy i grupy Jira. Jeśli potrzebne są zgłoszenia Jira, należy użyć opcji Ogólne.
5. Wprowadź unikalną nazwę zadania provisioningowego
6. Wybierz użytkownika API sieci Web i wpisz hasło
7. Wybierz szablon awarii i atrybut, który będzie używany w przypadku wystąpienia błędów podczas udostępniania (połączenie ze źródłami danych, przekroczenie limitu czasu itp.).
8. Wybierz kolejność harmonogramowania, która zależy od ilości danych odczytywanych przez rozwiązanie Customers Efecte

9. Wypełnij sekcję Pro , w której definiujesz informacje dotyczące połączenia i jego unikalny identyfikator.
10. Wypełnij sekcję mapowania atrybutów. Uwaga! Zawartość będzie się różnić w zależności od wybranej wartości w polu „ Typ mapowania” .

11. Zapisz zadanie provisioningu z górnego paska
12. Skonfigurowałeś już zadanie provisioningu oparte na harmonogramie i możesz
- Połączenie testowe
- Uruchom zadanie ręcznie
13. Jeśli zadanie jest wykonywane ręcznie ( uruchamiane ręcznie ) lub zgodnie z harmonogramem, status zadania można sprawdzić na karcie Wyodrębnij/Załaduj status .
Konfiguruj zadanie oparte na zdarzeniach
1. Otwórz obszar Administracji Efektów (symbol koła zębatego) w prawym górnym rogu.

2. Otwórz widok IGA

3. Wybierz Dodaj nowe zadanie

4. Wybierz Atlassian Jira z listy Dodaj nowe zadanie 
5. Wybierz Pro dostarczania Dostarczanie oparte na zdarzeniach i Przenieś do instrukcji określonych dla katalogu
6. Wpisz unikalną nazwę zadania provisioningowego 
7. Wypełnij sekcję Pro , w której definiujesz informacje dotyczące połączenia i jego unikalny identyfikator.
8. Wypełnij sekcję mapowania atrybutów. Uwaga! Zawartość będzie się różnić w zależności od wybranej wartości w polu „ Typ mapowania” .
- Możliwe jest ustawienie dodatkowych atrybutów poprzez wybranie opcji Dodaj właściwość niestandardową.
- Można zdefiniować, które informacje o atrybutach będą zapisywane w Jira.
- W Jira może być realizowanych kilka zadań provisioningowych dla różnych celów.

9. Zapisz zadanie provisioningu z górnego paska
10. Skonfigurowałeś już zadanie dostarczania oparte na harmonogramie i możesz
- Połączenie testowe
11. Następnym krokiem jest skonfigurowanie przepływu pracy w celu wykorzystania tego zadania opartego na zdarzeniach.
- Z poziomu silnika przepływu pracy w platformie Efecte Service Management możliwe jest wykonywanie działań provisioningowych w Jira. Oznacza to, że dowolną z dostępnych aktywności można uruchomić w dowolnym momencie przepływu pracy.
Działania przepływu pracy
Efecte Provisioning Engine (EPE) zapewnia możliwość organizowania następujących działań w Jira.
Dodaj użytkownika do grupy

Na powyższej ilustracji konfiguracja atrybutu „Person” powinna wskazywać szablon, w którym węzeł orkiestracji znajduje dane użytkownika (zazwyczaj konto IGA ). Atrybut „Rola” musi zostać skonfigurowany, aby określić, gdzie węzeł orkiestracji znajduje dostępne role (grupy katalogów, z których użytkownik powinien zostać usunięty). W atrybucie „Rola” może być skonfigurowana jedna lub wiele grup atrybutów. Lista dostępnych zarejestrowanych zadań katalogowych jest pobierana z bazy danych EPE-master.
Obsługa wyjątków:
- Wynik węzła będzie w stanie „Zakończone” tylko wtedy, gdy wszystkie członkostwa użytkownika w grupach zostaną pomyślnie zaktualizowane. Na przykład, gdy użytkownik zostanie pomyślnie usunięty z 5 z 6 grup, wynik węzła będzie w stanie „Wyjątek”.
- W związku z tym wymagane jest mapowanie pola JSON „distributedName” zarówno dla tożsamości, jak i uprawnień dostępu. Jeśli mapowanie nie zostanie znalezione, węzeł orkiestracji przejdzie w stan „Wyjątek”.
- Próba usunięcia użytkownika z grupy, do której nie należy, zakończy się niepowodzeniem.
- Próba dodania użytkownika do grupy, do której już należy, zakończy się niepowodzeniem.
- Szczegóły dotyczące pomyślnej/nieudanej aktualizacji członkostwa użytkownika w grupie można znaleźć w dziennikach.
- Wyjątki Pro aprowizacji i członkostwa w grupie to opcjonalne właściwości w tym węźle przepływu pracy. Administratorzy mogą skonfigurować te właściwości w taki sposób, aby możliwe było zapisanie wyjątków w przypadku wystąpienia jakichkolwiek wyjątków podczas akcji aprowizacji.
Utwórz użytkownika

Węzeł orkiestracji tworzenia nowego użytkownika odczytuje atrybuty z odpowiednich kart danych i wykonuje wywołanie API do Jira. Identyfikator utworzonej jednostki powinien zostać wypełniony atrybutem zawierającym wartość accountID nowego użytkownika.
Istnieją dwa sposoby utworzenia hasła dla nowego użytkownika na potrzeby jego pierwszego logowania.
- Zdefiniuj hasło „domyślne” w widoku konfiguracji zadania Pro
- To hasło będzie używane przez użytkowników tylko wtedy, gdy zalogują się do systemu po raz pierwszy.
- Generowanie losowego hasła w przepływie pracy i wybór atrybutu, do którego na karcie danych mapowania tożsamości zostało ono zapisane
- Możliwość wyboru, czy hasło ma zostać zmienione przy pierwszym logowaniu. Administratorzy mogą dokonać tego wyboru bezpośrednio z węzła koordynacji tworzenia użytkowników w przepływie pracy.
- Istnieją różne sposoby podania hasła do pierwszego logowania użytkownika końcowego. W zależności od potrzeb klienta, możliwe jest wykorzystanie funkcji przepływu pracy do wysłania hasła bezpośrednio do użytkownika końcowego e-mailem lub SMS-em. Inną opcją jest wysłanie hasła do pierwszego logowania do menedżera, który je poda użytkownikowi końcowemu. Sam węzeł orkiestracji EPE NIE zapewnia tej funkcjonalności, należy ją zdefiniować w innym miejscu.
Wyjątek w Pro to opcjonalna właściwość w tym węźle przepływu pracy. Administratorzy mogą skonfigurować tę właściwość w trybie użycia, aby możliwe było zapisywanie wyjątków w przypadku wystąpienia jakichkolwiek wyjątków podczas akcji aprowizacji.
Utwórz grupę

Administratorzy wybierają właściwy „cel” w Jira i mogą przeglądać konfigurację. Węzeł orkiestracji tworzący nową grupę odczytuje atrybuty z odpowiednich kart danych i wykonuje wywołanie API do Jira.
Utworzony atrybut Entity Id jest mapowany na atrybut w Efecte, który zawiera wartość groupID nowej grupy.
Wyjątek w Pro to opcjonalna właściwość w tym węźle przepływu pracy. Administratorzy mogą skonfigurować tę właściwość w trybie użycia, aby możliwe było zapisywanie wyjątków w przypadku wystąpienia jakichkolwiek wyjątków podczas akcji aprowizacji.
Usuń grupę

Administratorzy wybierają właściwy „cel” w Jira i mogą przeglądać konfigurację. Usunięcie węzła orkiestracji grupy odczytuje atrybuty z odpowiednich kart danych i wykonuje wywołanie API do Jira.
Atrybut grupy ról musi zostać zamapowany na atrybut w programie Efecte zawierający wartość groupID grupy, która ma zostać usunięta.
Wyjątek w Pro to opcjonalna właściwość w tym węźle przepływu pracy. Administratorzy mogą skonfigurować tę właściwość w trybie użycia, aby możliwe było zapisywanie wyjątków w przypadku wystąpienia jakichkolwiek wyjątków podczas akcji aprowizacji.
Usuń użytkownika

Administratorzy wybierają właściwy „cel” w Jira i mogą przeglądać konfigurację. Usunięcie węzła orkiestracji użytkownika odczytuje atrybuty z odpowiednich kart danych i wykonuje wywołanie API do Jira.
Atrybut Person* musi zostać zamapowany na atrybut w Efecte zawierający wartość AccountId użytkownika, który ma zostać usunięty.
Wyjątek w Pro to opcjonalna właściwość w tym węźle przepływu pracy. Administratorzy mogą skonfigurować tę właściwość w trybie użycia, aby możliwe było zapisywanie wyjątków w przypadku wystąpienia jakichkolwiek wyjątków podczas akcji aprowizacji.
Usuń użytkownika z grupy

Na powyższej ilustracji administratorzy mogą wybrać właściwy „Cel” Jira.
Atrybut osoby* musi zostać zamapowany na atrybut w Efecte zawierający wartość AccountId użytkownika, który ma zostać usunięty z grupy
Atrybut roli* musi być mapowany na atrybut w Efecte zawierający wartość groupID grupy, która ma zostać usunięta z użytkownika.
Wyjątek w Pro to opcjonalna właściwość w tym węźle przepływu pracy. Administratorzy mogą skonfigurować tę właściwość w trybie użycia, aby możliwe było zapisywanie wyjątków w przypadku wystąpienia jakichkolwiek wyjątków podczas akcji aprowizacji.
Utwórz zgłoszenie Jira

Na powyższej ilustracji administratorzy mogą wybrać właściwy „cel” w Jira. Cel można wybrać dla tych epetask, które zawierają co najmniej atrybuty: datasourceid, issuetype, project i summary, na przykład.

Wyjątek w Pro to opcjonalna właściwość w tym węźle przepływu pracy. Administratorzy mogą skonfigurować tę właściwość w trybie użycia, aby możliwe było zapisywanie wyjątków w przypadku wystąpienia jakichkolwiek wyjątków podczas akcji aprowizacji.
Znane ograniczenia
Odczytywanie komentarzy z Atlassian Jira Cloud do rozwiązania Matrix42 Core , Pro lub IGA
Jeśli spróbujesz odczytać komentarze bezpośrednio do atrybutu komentarzy dla Matrix42 Core , Pro lub IGA datacard, komentarze zostaną zduplikowane przy każdym zaplanowanym uruchomieniu zadania.
Zamiast odczytywać te komentarze bezpośrednio do atrybutu komentarzy, należy użyć pomocniczego atrybutu tymczasowego, w którym mapuje się komentarz Jira. Aktualizuj rzeczywiste komentarze na podstawie wartości tego atrybutu tymczasowego, jeśli atrybut rzeczywistych komentarzy jeszcze go nie zawiera. Można to zrobić za pomocą narzędzi do personalizacji platformy Matrix42 Core i Pro. Skontaktuj się z konsultantami Matrix42 aby uzyskać bardziej szczegółowe informacje na temat tego, jak to zrobić.
Rozwiązywanie problemów
W tym rozdziale opisano opcje rozwiązywania problemów,
- W przypadku użycia szablonu awarii należy sprawdzić poprawność karty danych
- Sprawdź historię zaplanowanych zadań z poziomu zarządzania łącznikiem
- Sprawdź dzienniki modułu Efecte Provisioning Engine