Aloita siitä siirrosta, jonka tulos puuttuu tai näyttää virheelliseltä. Kirjaa ylös tiedon nimi tai tunniste, integraatio, siirron suunta ja likimääräinen käsittelyaika. Lokista selvität, mitä käsittelyssä tapahtui; varmista lopputulos myös kyseisistä tiedoista Spotillassa ja toisessa järjestelmässä.

Edellytykset ja oikean lokin valinta

Lokeja tarkastellaan Spotillan selainversiossa adminkäyttäjän oikeuksilla. Android- ja iOS-sovelluksissa ei ole näitä lokinäkymiä. Myös mobiilissa tallennetun tiedon integraatiokäsittely selvitetään selaimessa.

Avaa päävalikosta Palvelun asetukset ja valitse Integraatiot. Käytössä on kaksi erilaista lokinäkymää:

  • Yhteinen loki: avaa Tapahtumaloki-välilehti.
  • Integraatiokohtainen loki: avaa LemonERP-, Procountor (Uusi)-, KIHO- tai GSFleet-välilehti ja sen sisältä Integraatioloki. Integraation välilehti näkyy vain, kun kyseinen integraatio on otettu organisaatiolle käyttöön.

Nämä ovat eri lokit: sama tapahtuma ei välttämättä löydy kummastakin. Varmista etenkin LemonERP- ja Procountor-yhteyksissä, käytättekö uutta välilehtikohtaista yhteyttä vai vanhaa integraatiomääritystä. Jos tarvittava yhteys ei näy, katso integraation käyttöönoton edellytykset.

Hae tapahtuma yhteisestä Tapahtumalokista

Valitse taulukon yläpuolella olevasta Tapahtuman luontihetki -valikosta haettava jakso. Oletus on Päivä, eli kuluva päivä. Viikko hakee seitsemän päivää sitten alkavan jakson tähän päivään asti. 1 Kuukausi hakee kuukautta aiemmin alkavan jakson tähän päivään asti. Ne eivät tarkoita kalenteriviikkoa tai kalenterikuukautta. Molemmat rajapäivät sisältyvät hakuun.

Kun valitset Hae aikaväliltä, määritä viereiseen Aikaväli-kenttään alku- ja loppupäivä. Näkymä voi palauttaa aiemmin käyttämäsi rajaukset, joten tarkista ne aina ennen tulosten tulkintaa.

Tarkenna haettua aineistoa sarakeotsikoiden alla olevilla suodattimilla: Luotu, Ohjelma, Kohteen tyyppi, Kohde, Tilakoodi ja Kuvaus. Sarakesuodatus ei laajenna yläpuolella valittua aikaväliä. Jos tapahtuma on sen ulkopuolella, muuta ensin päärajausta. Tapahtumat haetaan oletuksena uusimmat ensin.

Lue Tilakoodi yhdessä Kuvaus-sarakkeen kanssa. Tilakoodi on tapahtuman mukana kirjattu arvo; se ei ole integraatiokohtaisen lokin Tila eikä sille pidä olettaa samoja merkityksiä.

Hae tapahtuma integraation omasta lokista

Rajaa ajanjakso Aika-sarakkeen otsikon alla olevasta päivämääräsuodattimesta. Valitun alku- ja loppupäivän tapahtumat sisältyvät hakuun. Tässä lokissa ei ole yhteisen lokin päivän oletusrajausta, ja oletusjärjestys on uusimmat ensin.

Tarkenna hakua sarakkeiden Työ, Suunta, Kohdetyyppi, Tila ja Viesti tekstisuodattimilla. Voit hakea myös tekstin osalla. Useat suodattimet rajaavat tuloksia yhdessä.

  • Työ kertoo käsittelyn nimen. Se voi näkyä teknisenä nimenä eikä tarkoita välttämättä Spotillan tehtävää tai työmääräintä.
  • Suunta: inbound tarkoittaa tuontisuuntaa toisesta järjestelmästä Spotillaan ja outbound vientisuuntaa Spotillasta toiseen järjestelmään. Suunta ei yksin vahvista tietojen siirtymistä.
  • Kohdetyyppi kertoo käsitellyn tiedon tai käsittelyn tyypin. Rivi voi olla myös koko ajon yhteenveto.
  • Kohde näyttää nimen, kun lokimerkinnälle voidaan löytää vastaava Spotillan tieto. Tyhjä kohde ei yksin tarkoita virhettä. Nimi haetaan nykyisestä tiedosta, joten se ei välttämättä ole tapahtumahetken nimi.

Kohteen nimi voi avata siihen liittyvän Spotillan tietueen. Avaaminen on tuettu asiakkaille, yhteyshenkilöille, kansioille, tarjouksille, sopimuksille ja sopimuslaskuille. Kaikille kohdetyypeille ei ole toimivaa linkkiä, vaikka nimi näyttäisi linkiltä; etsi tieto tarvittaessa sen omasta näkymästä.

Tulkitse tila ja viesti yhdessä

  • ok: rivillä kuvattu toiminto onnistui. Se voi tarkoittaa uuden tiedon luontia, päivitystä tai pelkkää olemassa olevan tiedon yhdistämistä.
  • noop: käsittely ohitettiin tai muutosta ei tarvittu. Tämä ei takaa, että tavoittelemasi tieto siirtyi.
  • error: käsittelyssä todettiin virhe. Tarkista viestistä, mitä toimintoa ja kohdetta se koskee.

Viesti kertoo, mitä rivin tila käytännössä tarkoittaa. Esimerkiksi LemonERP-asiakastuonnin Bootstrap mapping created voi näkyä tilalla ok, vaikka uutta asiakasta ei luotu: olemassa oleva asiakas yhdistettiin. Missing cost center — skipped näkyy tilalla noop ja tarkoittaa, että uuden asiakkaan käsittely ohitettiin puuttuvan kustannuspaikan vuoksi.

Lokissa näkyvä onnistunut yhteystesti ei yksin todista laskun tai muun liiketoimintatiedon siirtymistä. Tarkista nimenomaan kyseisen toiminnon tulos ja mahdolliset muut saman käsittelyn rivit.

Varmista tulos ja selvitä jatkotoimet

Vertaa lokimerkintää kyseiseen tietoon Spotillassa ja vastaanottavassa järjestelmässä. Tuonnissa vastaanottava järjestelmä on Spotilla, viennissä toinen järjestelmä. Tarkista, löytyykö oikea tietue, onko se yhdistetty oikeaan kohteeseen ja ovatko odotetut kentät päivittyneet.

Jos riviä ei löydy, laajenna aikaväliä, poista liian tarkat sarakesuodattimet ja tarkista oikea integraatiototeutus ja loki. Puuttuva lokirivi ei yksin todista siirron onnistumista tai epäonnistumista: esimerkiksi lokin tallennus voi epäonnistua erillään itse käsittelystä.

Lokin lukeminen, suodattaminen tai lajittelu ei käynnistä siirron uusintaa eikä muuta käsiteltäviä tietoja. Jos viesti koskee tunnistautumista, tarkista oikea ympäristö ja yhteyden tunnisteasetukset. Jos kyse on puuttuvasta kentästä tai vastaavuudesta, korjaa sen määritys ennen uutta siirtoa. Yhteyskohtaiset ohjeet: LemonERP, Procountor, KIHO ja GSFleet.

Älä käynnistä laajaa uudelleensiirtoa vain yhden epäselvän rivin vuoksi. Tarkista ensin, mitkä tiedot onnistuivat ja mitä uusinta käsittelisi. Toimita tarvittaessa tuelle aikaväli, integraation nimi ja käytetty loki, suunta, kohde, tila tai tilakoodi sekä viesti tai kuvaus. Älä sisällytä salasanoja, API-avaimia tai muita salaisia tunnistetietoja.