Integraatioavainta käytetään järjestelmien välisessä yhteydessä. Avaimen luominen tuottaa yhteyden tunnistetiedot, mutta ei määritä, mitä tietoja integraatio siirtää tai milloin se toimii. Sovi yhteyden toteutuksesta ja käyttötarkoituksesta integraation ylläpitäjän kanssa.

Oikeudet ja hallinnan sijainti

Hallinta edellyttää Spotillan adminkäyttäjän oikeuksia; managerikäyttäjän oikeudet eivät riitä. Avaa selainversion päävalikosta Palvelun asetukset, sitten Integraatiot-välilehti ja sen alta Integraatioavaimet. Android- ja iOS-sovelluksissa ei ole integraatioavainten hallintaa.

Avain käyttää sitä varten luodun integraatiotilin valmiiksi määritettyjä käyttöoikeuksia. Lomakkeessa ei valita rajattua oikeusjoukkoa. Oikeudet kattavat esimerkiksi Spottien ja asiakastietojen lukemista, luomista ja päivittämistä sekä palvelupyyntöjen käsittelyä. Osa oikeuksista riippuu palvelussa käytössä olevista ominaisuuksista. Toimita avaintiedot vain kyseisen integraation ylläpitäjälle sovitulla tavalla. Erillistä mobiilikäyttäjän tunnusta ei tarvitse luoda tätä varten.

Luo avain ja ota tunnistetiedot käyttöön

  1. Valitse avainlistan yläpuolelta Luo integraatioavain.
  2. Täytä pakollinen Nimi. Anna enintään 50 merkin pituinen nimi, josta käyttötarkoitus selviää myös myöhemmin.
  3. Valitse tarvittaessa Vanhenemispäivä. Tyhjä kenttä tarkoittaa, ettei avaimelle aseteta tätä määräaikaa.
  4. Valitse lomakkeen Luo integraatioavain. Luotu avain tulee listaan.
  5. Avaa tiedot valitsemalla avaimen nimi tai rivin kynäkuvake. Valitse tietolomakkeesta Näytä/piilota arvot, jotta näet Avain-, Käyttäjän ID- ja Subdomain-tiedot.
  6. Toimita kaikki kolme tietoa integraation ylläpitäjälle yhteyden määritystä varten. Käyttäjän ID yksilöi integraatiotilin käyttäjän ja Subdomain Spotillan asiakkuuden.

Näytä/piilota arvot vaihtaa vain tietojen näkyvyyttä lomakkeessa. Se ei vaihda avainta eikä poista sitä käytöstä. Tunnistetietoja ei muokata suoraan näissä kentissä.

Integraation muun käyttöönoton edellytyksiä käsitellään ohjeessa Miten tarkistan integraation käyttöönoton edellytykset ja tilan?

Muuta nimeä tai vanhenemispäivää

Avaa avaimen tiedot listasta, muuta Nimi tai Vanhenemispäivä ja valitse Tallenna. Nimen muuttaminen ei vaihda tunnistetietoja. Vanhenemispäivän tyhjentäminen poistaa määräajan.

Avain ei kelpaa tunnistautumiseen enää sen tallennetun vanhenemisajan täytyttyä. Määräajan ylittäneet avaimet myös mitätöidään automaattisesti; mitätöinti tyhjentää vanhenemispäivän. Tyhjä päivämäärä ei siis yksin osoita, että avain toimii.

Jos käyttö on estynyt vain määräajan vuoksi eikä avainta ole vielä mitätöity, määräajan siirtäminen tulevaisuuteen tai tyhjentäminen voi palauttaa käytön. Jo mitätöityä avainta päivämäärän muutos ei palauta: silloin tarvitaan Resetoi avain.

Vaihda avain resetoinnilla

Valitse avaimen tietolomakkeesta Resetoi avain, kun tarvitset uuden avaimen tai haluat ottaa mitätöidyn avaimen uudelleen käyttöön. Toiminto vaihtaa avaimen heti ja mitätöi vanhat tunnistautumistunnisteet. Jo täyttynyt vanhenemisaika poistetaan, mutta tuleva määräaika säilyy.

Avaa tiedot uudelleen ja näytä tunnistetiedot. Päivitä uusi Avain kaikkiin sitä käyttäviin yhteyksiin. Käyttäjän ID ja Subdomain säilyvät samoina. Vanhaa avainta käyttävät yhteydet eivät jatka toimintaansa pelkän Spotillassa tehdyn vaihdon perusteella.

Mitätöi avain tai poista integraatiotili

Tarkista ensin, mitä yhteyksiä avain palvelee. Valitse tietolomakkeesta Aseta vanhentuneeksi, kun avain pitää poistaa käytöstä heti. Toiminto mitätöi avaimen, poistaa sen tunnistautumistunnisteet ja tyhjentää vanhenemispäivän. Rivi ja integraatiotili säilyvät. Avainta voi käyttää uudelleen vasta resetoinnin ja uuden arvon käyttöönoton jälkeen.

Resetoi avain ja Aseta vanhentuneeksi vaikuttavat heti ilman erillistä tallennusta. Lomakkeen sulkeminen tai Peruuta ei kumoa niitä. Nämä toiminnot eivät poista integraation jo luomia tai muuttamia liiketoimintatietoja.

Jos haluat poistaa myös integraatiotilin, valitse avainlistan kyseisen rivin roskakorikuvake ja vahvista poistaminen. Poistaminen poistaa tilin, siihen liittyvän käyttäjän, avaimen ja tunnistautumistunnisteet sekä rivin listasta. Poistettua avainta ei voi palauttaa resetoinnilla; uuden avaimen luominen tuottaa uuden integraatiotilin ja uudet tunnistetiedot.

Tilin poistaminen ei peruuta aiempia tiedonsiirtoja. Käyttäjän viestit ja kommentit säilyvät, mutta niiden yhteys poistettuun kirjoittajaan katkeaa. Myös tehtävien vastuukäyttäjäviittaukset voivat tyhjentyä. Tiliin liittyvät allekirjoitusvaatimukset voivat estää poistamisen; selvitä tällöin näytetty virhe ennen uutta yritystä.

Varmista muutoksen tulos

Lataa avainlista uudelleen esimerkiksi päivittämällä selainsivu. Tarkista oikea nimi, vanhenemispäivä ja Tila. Ei käytössä tarkoittaa mitätöityä avainta. Käytössä ei kuitenkaan takaa toimivaa yhteyttä: määräajan ylittänyt avain voi näkyä näin ennen automaattista mitätöintiä. Myöskään tietolomakkeen avainkenttien näkyvyys ei todista avaimen voimassaoloa.

Tee avainta käyttävässä järjestelmässä tarkoitettu yhteyskokeilu. Luonnin tai resetoinnin jälkeen varmista, että uudet tunnistetiedot toimivat ja haluttu toiminto tuottaa odotetun tuloksen. Resetoinnin jälkeen vanhan avaimen tulee lakata toimimasta; mitätöinnin tai poistamisen jälkeen yhteyden ei enää pidä tunnistautua sillä. Tarkista tarvittaessa myös siirretty tieto Spotillasta ja toisesta järjestelmästä. Avaimen tila ei yksin vahvista tiedonsiirron onnistumista.