Siirry pääsisältöön
Itse-tuonti API:n kautta

Kuinka suorittaa tietojen tuonti Teamtailoriin julkisen API:n kautta

Alexander Jarlenäs avatar
Tekijä: Alexander Jarlenäs
Päivitetty yli kuukausi sitten

1a. Onko se mahdollista?

On varmasti mahdollista tehdä tuonti itse. Tämä vaatii asiakkaalta teknistä ymmärrystä ja resursseja prosessin läpikäyntiin.

Tämä toteutetaan niin, että sisäisesti kirjoitatte skriptin, joka pystyy ottamaan tiedot olemassa olevasta tietokannasta, muuntamaan ne Teamtailorin käytössäolevaan muotoon ja lähettämään ne meille. Tämä voidaan tehdä joko ottamalla tiedot asiakkaan olemassa olevasta tietokannasta käyttäen API:a tai dokumentista.

Kaiken kaikkiaan tärkeintä on, että sisäisesti on resursseja ja henkilöitä, jotka pystyvät ymmärtämään dataa ja API:a.

1b. Pitäisikö minun tehdä se?

Tämä on paljon hankalampi kysymys - tässä tavassa on paljon hyviä ja huonoja puolia. Normaalisti tätä suositeltaisiin eritoten suurille yrityksille, joilla on enemmän resursseja tehdä tuonti itse API:lla sekä suurempi tarve nopeammalle ratkaisulle.

Hyvät puolet

  • Tuonti voidaan tehdä omalla aikataulullasi

  • Voit päättää jokaisesta attribuutista ja parametrista, joka tuodaan ja miltä sen pitäisi näyttää

  • Se on täysin ilmainen

  • Voimme tarjota tukea, miten API voi toimia

Huonot puolet

  • Edellyttää ainutlaatuisen skriptin luomista, joka voi kääntää tiedot yhdestä lähteestä Teamtailorin hyväksymään muotoon

  • Julkisella API:lla on rajoitus - 50 pyyntöä 10 sekunnissa, jolloin suuren tietokannan tuonti voi viedä paljon aikaa

  • Edellyttää hyvää ymmärrystä siitä, miten data ja API:t toimivat

2. Prosessi

  1. Teamtailorin datan ymmärtäminen

  2. Teamtailorin julkisen API:n ymmärtäminen

  3. Skriptin kirjoittaminen

Teamtailorilla on relaatiotietokantamalli, joka tarkoittaa, että objekteilla voi olla ainutlaatuisia ominaisuuksia ja suhteita muihin objekteihin. Näitä suhteita on kriittistä ymmärtää, jotta Teamtailorin toiminta selkeytyy.

Katsotaan Työhakemuksen malliin API-dokumentaatiossamme esimerkkinä

Kuten näet, siinä on Attribuutteja ja Suhteita.

Attribuutit sisältävät tiedon, joka on ainutlaatuinen tälle tietylle Työhakemukselle - kun se on luotu, jos se on lähteestä peräisin jne.

Suhteet sisältävät tiedon, joka ei ole ainutlaatuinen tälle työhakemukselle, mutta on olemassa sen ulkopuolella. Esimerkiksi jokaisella Työhakemuksella on hakija ja työpaikka -suhteet.

Nämä auttavat ymmärtämään paremmin, kuka on täyttänyt tämän työhakemuksen ja mille työpaikalle se on luotu.

Tämä on hyödyllistä, koska jos Hakijaan tai Työhakemuksessa tapahtuu muutoksia, Työhakemus pysyy toimivana, koska on olemassa vain linkki siihen. Se ei suoraan vaikuta kahden muun suhteen muutoksiin. Tämä tarkoittaa kuitenkin myös sitä, että tietyjen objektien luominen Teamtailorissa saattaa edellyttää useamman kuin yhden pyynnön.

Hakija-objekti

Useimmiten tuonnit tehdään hakijoiden tuomiseksi ja siksi on tärkeää ymmärtää, miten hakijaobjekti toimii ja mitä tietoja voidaan lisätä joko attribuutteina objektiin tai suhteina.

Kuten aiemmin mainittiin, Hakijaobjektilla on suhde Työhakemukseen, jos hakemus on aiemmin tehty, mutta on olemassa monia muitakin suhteita. Kaiken kaikkiaan hakijaobjekti on tärkein alusta.

Attribuutit

Täältä löytyvät perustiedot hakijasta - ennen kaikkea nimi, yhteystiedot, suostumustiedot ja muut sellaiset tiedot, jotka saattaisit haluta säilyttää hakijaprofiililla.

Kuitenkin saatat huomata, että joitakin muita tietoja ei löydy täältä - esimerkiksi ei ole kenttiä 'sukupuoli' tai 'ikä'. Tämä johtuu siitä, että Teamtailor toimii avoimen tietomallin mukaan. Perustiedot ovat täällä attribuuteissa, mutta lisätiedot on lisättävä joko mukautettuina kenttinä tai vastauksina.kysymyksiin

Suhde

Kuten tästä taulukosta näkyy, hakijalla voi olla monia erilaisia suhteita.

  • Liittyen tuontiin:

Kysymykset ja vastaukset sisältävät tietoja siitä, mihin kysymyksiin hakija on vastannut ja mitä vastauksia on annettu. Molemmat näistä ovat itsenäisiä objekteja hakijan ulkopuolella.

Mukautetut kentät sisältävät vastaukset kaikkiin aiemmin määritettyihin mukautettuihin kenttiin. Esimerkiksi, jos on olemassa mukautettu kenttä nimeltä ‘vanhempi’, niin hakijan arvo on ‘kyllä’ tai ‘ei’. Mukautettua kenttää käytetään samalla tavalla, mutta arvo on ainutlaatuinen ehdokkaalle. Mukautetun kenttäarvon (kyllä tai ei) tulee liittyä hakijaan ja mukautettuun kenttään (sukupuoli).

Kommentit voivat sisältää rekrytoijan syöttämää vapaamuotoista tietoa ja niitä voi lisätä myös API:n kautta. Tähän voi lisätä myös tietoa, joka ei sovi mihinkään muuhun, esimerkiksi ansioluettelon käännös.

  • Ei liity tuontiin:

Toiminnot sisältävät tiedot jokaisesta toimesta, joka on tehty hakijalle.

Lataukset sisältävät kaikki lisäasiakirjat, jotka ehdokas on lähettänyt.

Kumppanitulokset sisältävät kaikki tiedot, jotka olemme saaneet muista mahdollisista integraatioista, joita saatat käyttää, esimerkiksi testitulokset.

Osasto, rooli, alueet ja sijainnit sisältävät erilaisia tietoja siitä, mihin ehdokas on hakemassa - nämä periytyvät automaattisesti mistä tahansa työstä, johon he ovat hakeneet, eivätkä ole suoraan yhteydessä ehdokkaan sijaintiin.

2. Teamtailorin Julkinen API

Teamtailorin Julkinen API on suunniteltu JSON:API-määrityksen mukaisesti. Tämä tarkoittaa, että pääasiassa käytämme JSON-tietomuotoa viestinnässä API:n kautta. Dokumentaatio sisältää esimerkkejä tarvittaessa ja hyödyllisen kirjaston, joka voidaan tuoda Postmaniisi.

Tietojen tarkastelu

Kuten aiemmin selitettiin, Teamtailorilla on relaatiomalli, mikä tarkoittaa, että monet objektit ovat keskinäisessä suhteessa toisiinsa, mukaan lukien ehdokkaat ja heidän mukautetut kenttäarvonsa ja vastauksensa. Koska vain yksi uusi objekti voidaan luoda pyyntöä vastaan, tämä vaatii tietyn määrän pyyntöjä tehtäväksi jokaiselle ehdokkaalle.

Helpottaaksesi tätä, on mahdollista “avata” joitakin näistä suhteista vastauksessa lisäämällä sisällytä-parametrin. Esimerkiksi jos haluat tietää ehdokkaan mukautettujen kenttien arvot, voit lisätä pyyntöön ?include=custom-field-values, mikä lisää lisäosan datan alle nimeltä sisällytetty, joka sisältää kaikki tiedot yksittäisistä mukautetuista kenttäarvoista, jotka löytyvät kyseisestä suhteesta.

Tämä tarkoittaa myös sitä, että jokainen mukautettu kenttäarvo, vastaus tai muistiinpano (kommentti), joka lisätään ehdokkaalle, olisi lisättävä erillisenä pyyntönä.

Pyyntöjen rajoitus (rate limit)

Pyyntöjen rajoitus on 50 pyyntöä 10 sekunnissa, joten skript tauottuu, kun tämä raja saavutetaan tai pyynnöt on ajoitettava niin, ettei ne koskaan saavuteta tätä rajaa. Yleensä 300 ms viiveen lisääminen jokaisen pyynnön välille on hyvä tapa estää raja-arvon saavuttaminen.

3. Skriptin kirjoittaminen

Tässä on perusprosessi mukautettua tuontia varten:

  1. Lähetä ehdokas -kohdepiste - käytä tätä luodaksesi uuden hakijan. Jos on kaksoiskappaleita, ne yhdistetään oletuksena (jos ‘merge’-attribuutti on asetettu todeksi). Tämän tulisi sisältää hakijan perustiedot - nimi, sähköposti, puhelinnumero, kuva ja ansioluettelo.

  2. Jos ansioluetteloa tarvitaan, sinun on ensin ladattava se julkiselle palvelimelle vähintään 30 sekunniksi ja sitten annettava URL-osoite ansioluettelona. Lataamme ansioluettelon tiedoston näiden 30 sekunnin aikana, joten voit poistaa ne jälkeenpäin.

  3. Lähetä mukautettu kentän arvo -kohdepiste - käytä tätä lisätäksesi mukautettuja kentän arvoja hakijoille. Tarvitset hakijan tunnisteen ja mukautetun kentän tunnisteen ennen kuin teet tämän. Mukautettuja kenttiä voidaan luoda omalla endpointilla tai lisätä alustalla, kumpi vain on helpompaa.

  4. Lähetä vastauksen kohdepiste - käytä tätä lisätäksesi vastauksia kysymyksiin hakijan korttiin. Vastauksilla voi olla suhde työpaikkaan, mikäli kysymys liittyy eritoten kyseiseen työhön. Vastaukset ovat samankaltaisia kuin mukautetut kentän arvot, mutta ne on tarkoitettu joksikin, jonka ehdokas itse voi täyttää hakemuksen aikana, eikä jotakin, jonka rekrytoija on syöttänyt.

  5. Muistiinpanot (Kommentit) rajapinta - käytä tätä, jos haluat ladata paljon dataa etkä ole täysin varma, kuinka paljon dataa on olemassa. Tämä päättyy ehdokkaan kortille, Kommentit-välilehden alle, syötteenä. Muistiinpanot (Kommentit) vaativat käyttäjän ja hakijan.

Kun lataus on valmis, voit validoida alustalta löytyvät tiedot tarkistamalla hakijoiden lukumäärän ja sen, onko heillä halutut tiedot.

Tuki

Jos kohtaat ongelmia, kuten virheilmoituksia tai jokin ei toimi niin kuin pitäisi, voit ottaa yhteyttä tukeemme napsauttamalla chattilaatikkoa alustalla tai lähettämällä sähköpostia support@teamtailor.com

Jos tarvitset apua laajempiin kysymyksiin, kuten prosessin parempaan ymmärtämiseen tai tietorakenteeseen, ota yhteyttä myyntiimme tai CSM:ään, jotka ohjaavat sinut henkilön luo, joka voi auttaa siinä.

Vastasiko tämä kysymykseesi?