HR-liitin
HR-liitin
Tässä käyttötapauksessa kuvataan tuotteistettu HR-liitin, jota käytetään käyttäjä- ja työsuhdejaksotietojen tuomiseen IGA-ratkaisuun. Tuotteistettu HR-liitin voi lukea tietoja XML-, CSV- tai JSON-tiedostomuodoista, jotka asiakas vie HR-järjestelmästä.
Käyttötapauksen kuvaus
Tämä käyttötapaus on saatavilla vain IGA Growth- ja Enterprise-paketeissa.
Huomaa, että tuotteistetulla HR-liittimellä voidaan vain lukea tietoja. Jos tietojen kirjoittaminen on tarpeen, suositellaan käytettäväksi Efecte Integration Servicesiä (tai vastaavaa integraatioalustaa).
| Kuvaus | |
Yleiskuvaus |
Tässä käyttötapauksessa kuvataan, miten käyttäjät ja heidän työsuhdejaksonsa tuodaan tuotteistetun HR-liittimen avulla. |
Toimijat |
IGA-ratkaisu |
Edellytykset |
Asiakas on toimittanut ennalta määritetyn JSON-, CSV- tai XML-tiedoston sovittuun sijaintiin, josta integraatio voi lukea sen ja aloittaa käyttäjä- ja työsuhdejaksotietojen tuonnin IGA-ratkaisuun. |
Tulos |
Käyttäjä- ja siihen liittyvät työsuhdejaksotiedot luetaan IGA-ratkaisuun. IGA-ratkaisu voi käynnistää käyttäjän elinkaaren hallintaan tai muihin käyttötapauksiin liittyviä työnkulkuja. |
Toimintaketju |
|
Liittyvät tietokortit |
IGA Work Period |
Määritysmuutokset
Asiakas voi valita nämä määritykset ilman, että ne vaikuttavat projektin aikatauluun tai työarvioihin.
1. Unique ID
Asiakas voi valita, käytetäänkö käyttäjien Unique ID -tunnisteena työntekijänumeroa vai henkilötunnusta
2. Aikataulutus
Asiakas voi määrittää aikataulutusjärjestyksen, kunhan edellinen tiedosto on tuotu.
3. Validointi
Asiakas voi määrittää pakolliset ja valinnaiset attribuutit. Huomaa, että Unique ID on aina pakollinen.
Laajennusmahdollisuudet
Nämä laajennusmahdollisuudet edellyttävät aina Efecten konsulttien tarkastusta, ennen kuin toteutuksesta ja työarvioista voidaan sopia.
1. Asiakas voi käyttää liitintä myös organisaatioyksiköiden, kustannuspaikkojen ja nimikkeiden lukemiseen.
Miten HR-liitin toimii?
Yleiskatsaus
HR-liitin käyttää Efecte Provisioning Enginea (Custom Script -liitin) tietojen lukemiseen tiedostosta. Liitintä käytetään vain tietojen lukemiseen IGA-ratkaisuun.
1. Liitin käyttää aikataulutettuun provisiointitehtävään määritettyjä lisäargumentteja tiedoston löytämiseen polusta (jos lisäargumentti puuttuu, prosessi pysähtyy)
2. Tiedostot muunnetaan JSON-muotoon (dict) ja tallennetaan JSON-muodossa
3. Jokainen tiedosto voidaan ajaa täytenä (full) tai osittaisena (partial) ajona
4. Osittainen ajo vertaa tietoja aina arkistoituun tiedostoon (jos arkistotiedosto puuttuu, prosessi pysähtyy)
5. Validointitiedostoa käytetään tarkistamaan, että jokainen rivi (objekti) sisältää pakolliset kentät, ja se antaa varoituksia, jos valinnaisia kenttiä puuttuu
6. Liitin tuo IGA-ratkaisuun IGA Admin Taskin, joka sisältää virheet sekä arkistoidut ja tuodut rivit sisältävät JSON-tiedostot, kun tuonti on suoritettu.
Liittimen tiedostoista,
| Tiedosto | Kuvaus |
| error_(data_type)_archive.json | Tallentaa rivit, jotka eivät läpäisseet validointia ajon aikana. Näitä rivejä ei tuoda IGA-ratkaisuun. Tiedosto ylikirjoitetaan jokaisella ajolla. |
| IGAConnector.py | Liittimen skripti |
| (data_type_archive.json | Tallentaa kaikki ajetun tiedoston rivit, sekä kelvolliset että virheelliset. Tiedosto ylikirjoitetaan jokaisella ajolla. |
| ./logs/3_output.json | Sisältää rivit, jotka läpäisivät validoinnin ja jotka tulee tuoda IGA-ratkaisuun |
| ./data/backup | Sisältää esimerkkitiedostot JSON-, XML- ja CSV-muodoille |
| translation.json |
1. Käytetään raporttitapausten kääntämiseen annetulle kielelle. 2. Uusia kieliä voidaan lisätä lisäämällä "language", esim. "de" tai "en", kaikkien tapausten alle avaimella "text". Jokaisella raporttitapauksella tulee olla uusi kieli, muuten liitin ajautuu virheeseen. 3. Tietyn kielen käyttämiseksi lisäargumenteissa tarvitaan avain "language", jonka arvo löytyy tiedostosta translation.json |
Tiedoston luominen HR-järjestelmästä
Tuotteistettu HR-liitin odottaa, että tiedosto luodaan HR-järjestelmästä seuraavan logiikan mukaisesti.
| Logiikka | Lisätietoa |
| Kaikki käyttäjät, joilla on aktiivinen työsuhdejakso (tai -jaksoja) | Käyttäjät valitaan työsuhdejakson päivämäärien perusteella |
| Kaikki käyttäjät, joilla on aktiivinen työsuhdejakso tulevaisuudessa | Kuukausi eteenpäin |
| Kaikki käyttäjät, joilla on aktiivinen työsuhdejakso menneisyydessä | Kuukausi taaksepäin; tätä tarvitaan, jos käyttäjän tietoihin tehdään muutoksia sen jälkeen, kun työsuhde on jo päättynyt. |
| Käyttäjät järjestetään Unique ID -tunnisteen perusteella | Unique ID voi olla joko työntekijänumero tai henkilötunnus. |
| Viimeisimmän päivityksen aikaleima | Käyttäjät voidaan valita viimeisimmän päivityksen aikaleiman perusteella, mutta tarkista asiakkaan HR-asiantuntijalta, mitkä muutokset päivittävät aikaleiman. |
Parametrit, validointi ja poikkeukset
Parametrit
HR-liitin käyttää seuraavia parametreja,
| Parametri | Kuvaus | Pakollinen / valinnainen arvo |
| file_path | Polku ja tiedostokuvio, josta tiedosto löytyy. | Pakollinen |
| data_type | Arvot: costcenter, organization, title tai workperiod. | Pakollinen |
| run_type |
Run type määrittää, verrataanko tietoja edelliseen tiedostoon. Arvot: full load tai partial, oletus on partial |
Valinnainen |
| update_limit |
Kuinka monta päivitystä IGA-ratkaisuun sallitaan. Jos tuonti havaitsee, että päivityksiä olisi tulossa enemmän kuin update_limit-arvon verran objekteja, se pysäyttää käsittelyn ennen päivitysten tekemistä ja kirjaa lokiin ERROR-viestin, joka päättyy vakiotekstiin: "Stopping ETL Worker process". |
Pakollinen |
| override_update_limit | Ohittaa päivitysrajan, jos päivitysten määrä on suurempi kuin annettu raja. Arvot true tai false, oletus on false. | Valinnainen |
| minimum_row_count | Kuinka monta riviä tiedostossa tulee olla vähintään. | Valinnainen |
| webapi_user | ESM-käyttäjä raportin luomista varten. Vaatii luonti- ja päivitysoikeudet IGA Admin Taskiin. | Pakollinen |
| webapi_password | Salasana ESM:n webapi_user-käyttäjälle | Pakollinen |
| webapi_url | URL-osoite ESM-ympäristöön. | Pakollinen |
| report_template_code | Kohdemallin koodi. | Pakollinen |
| report_folder_code | Kohdekansion koodi. | Pakollinen |
| debug | Ottaa käyttöön debug-lokituksen. Arvot true tai false, oletus on false. | Valinnainen |
Validointi
HR-liitin validoi seuraavat attribuutit; poikkeukset on lueteltu toisessa taulukossa
| Attribuutti | Pakollinen / valinnainen |
| Last Name | Pakollinen |
| First Name |
Pakollinen |
| Social Security Number |
Pakollinen |
| Employee ID |
Pakollinen |
| Employment start date |
Pakollinen |
| Title ID |
Pakollinen |
| Manager ID |
Pakollinen |
| Organization Unit ID |
Pakollinen |
| Spoken Name | Valinnainen |
| Second Name |
Valinnainen |
| Employment End Date |
Valinnainen |
| Employment type |
Valinnainen |
| Is User Manager? |
Valinnainen |
| Title |
Valinnainen |
| Manager Name |
Valinnainen |
| User Type |
Valinnainen |
| Cost Center |
Valinnainen |
| Organizational Unit Name | Valinnainen |
Poikkeukset ja IGA Admin Taskit
HR-liitin luo IGA Administration Taskin, jos jokin seuraavista poikkeuksista ilmenee,
| Poikkeus | Kuvaus | IGA Adminin toimenpiteet |
| Tiedostoa ei vastaanoteta tai se on tyhjä, integraatio luo IGA Admin Taskin | IGA Admin Task luodaan IGA Adminin tarkastettavaksi | IGA Admin selvittää, onko olemassa syy, miksi tiedostoa ei luoda HR-järjestelmästä tai miksi tiedosto on tyhjä. |
| Käyttäjältä puuttuu Unique ID |
Käyttäjät, joilla on Unique ID, tuodaan, ja niille käyttäjille, joiden tiedoista puuttui tietoa, luodaan IGA Admin Task manuaalista tarkistusta varten. |
Käyttäjän Unique ID tulee syöttää HR-järjestelmään, tiedosto luodaan uudelleen ja provisiointitehtävä ajetaan manuaalisesti |
| Aikataulutetusta provisiointitehtävästä (tyyppi ETL-worker) puuttuu lisäargumentteja |
Pakolliset lisäargumentit ovat: file_path data_type update_limit webapi_user webapi_password webapi_url report_template_code |
Lisäargumentit tulee lisätä aikataulutettuun provisiointitehtävään, ja IGA Module Adminin tulee ajaa tehtävä uudelleen. |
| Arkistotiedosto puuttuu | Arkistotiedoston löytyminen on pakollista, jotta osittainen ajo voi valmistua | IGA Admin Task ongelman ratkaisemiseksi puuttuvan tiedoston osalta. |
| Pakollinen kenttä (objekti) tai kentän arvo puuttuu | Rivi estetään ja tuonti viimeistellään; yksittäinen rivi jätetään käsittelyn ulkopuolelle | IGA Admin näkee liittimen raportista (IGA Admin Task), jos rivejä on estetty. Tieto tulee lisätä lähdejärjestelmään, tiedosto luoda uudelleen ja ajo suorittaa uudelleen. |
| Päivitysraja (update_limit) ylittyy | Tuonti keskeytetään (ei ajeta). | IGA Adminille luodaan IGA Admin Task ongelman ratkaisemiseksi. IGA Module Adminin tulee ajaa tehtävä uudelleen. |
| Rivien vähimmäismäärä ei ylity | Tuonti keskeytetään (ei ajeta). | IGA Adminille luodaan IGA Admin Task ongelman ratkaisemiseksi. IGA Module Adminin tulee ajaa tehtävä uudelleen. |
Suhteet ja määritysohjeet
Suhteet muihin käyttötapauksiin,
Suhteet muihin tietokortteihin,
Määritysohjeet,
Custom Backend -tehtävän luominen
Tuotteistettu HR-liitin edellyttää, että EPE Custom Backend on määritetty ESM:ään.
- Kirjaudu ESM:ään pääkäyttäjänä ja siirry Administrator-sivustolle
- Valitse IGA -välilehti
- Luo uusi Custom Backend -tehtävä
- Täytä vaaditut kentät ja testaa ajo. Esimerkiksi
Esimerkki parametreista:
{"objectGUID_field_name":"objectGUID", "sftp_server_fqdn":"transfer.xx.com", "sftp_server_ssh_port_number":"22", "sftp_username":"username_here", "sftp_password":"username_here", "sftp_remote_path_data":"/sftp/data", "sftp_remote_path_archive":"/sftp/archive", "file_path":"./data/HRconnector_file*.csv", "data_type":"workperiod", "run_type":"full", "update_limit": 10, "override_update_limit":true, "minimum_row_count": 3, "webapi_user": "username_here", "webapi_password": "username_here", "webapi_url":"https://baseline.efectecloud-dev.com", "report_template_code":"IGAWorkflowTaskInformation", "report_folder_code":"iga_tasks", "debug": true}
Katso tarkempi tekninen kuvaus HR-liittimestä
https://docs.efecte.com/configure-connectors/hr-connector-import
Table of Contents