{"type":"doc","content":[{"type":"paragraph","content":[{"text":"Lemonsoftissa on käytettävissä kolme erilaista web service -rajapintaa:","type":"text"}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Käyttäjälähtöinen SOAP","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"Käyttäjälähtöinen SOAP API-avaimella","type":"text"}]}]}]},{"type":"bulletList","content":[{"type":"listItem","content":[{"type":"paragraph","content":[{"text":"REST-rajapinta API-avaimella","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"paragraph","content":[{"text":"Ennen versiota 2021.5 integraatiot on tyypillisesti toteutettu käyttäjälähtöisellä SOAP-rajapinnalla. Vanha datalähtöinen SOAP-rajapinta on jäänyt jo aiemmin pois käytöstä. Myös SOAP-rajapinnan tuki on loppunut 31.12.2023 ja uudet toteutukset on tehtävä REST-rajapinnalla.","type":"text"}]},{"type":"rule"},{"type":"heading","attrs":{"level":2},"content":[{"text":"REST-rajapinta","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"REST-tyyppinen web service -rajapinta on uusi ja aktiivisessa kehityksessä oleva Lemonsoftin integraatiorajapinta, joka laajenee asiakkaittemme tarpeiden mukaan myös tulevaisuudessa. Pyrimme kehittämään REST-rajapintaa nimenomaan integraatiotarpeiden näkökulmasta, eikä niinkään perinteisellä tavalla ERP-järjestelmän näkökulmasta. Tämä tuo joustavuutta integraatioiden toteuttamiseen ja parantaa integraation käytön tuottavuutta.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Rajapintojen elinkaaret","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Tuemme rajapintoja seuraavasti:","type":"text"}]},{"type":"table","attrs":{"layout":"default","width":760.0,"localId":"751de0ba-0e57-4158-9e32-66106217e3f1"},"content":[{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"Rajapinta","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"Huomioita","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"Tuen päättyminen","type":"text","marks":[{"type":"strong"}]}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"Datalähtöinen SOAP","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"Ei enää tueta.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"31.12.2020","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"Käyttäjälähtöinen SOAP","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"Ei enää tueta.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"31.12.2021","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"Käyttäjälähtöinen SOAP API-avaimella","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"Ei enää tueta.","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"31.12.2023","type":"text"}]}]}]},{"type":"tableRow","content":[{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[228.0]},"content":[{"type":"paragraph","content":[{"text":"REST-rajapinta API-avaimella","type":"text","marks":[{"type":"strong"}]}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":"Aktiivisen kehityksen kohde. ","type":"text"}]}]},{"type":"tableCell","attrs":{"colspan":1,"rowspan":1,"colwidth":[226.0]},"content":[{"type":"paragraph","content":[{"text":" ","type":"text"}]}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Lisenssit ja API-avain","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Lisenssi IWS_LOG avaa SOAP-tyyppisen rajapinnan kaikki toiminnot. Asiakkaamme ovat esittäneet meille toiveita rajapinnan käyttöoikeuksien tarkemmasta rajaamisesta, jonka takia olemme lisänneet REST-rajapinnan käyttöoikeuksiin mukaan ohjelmalisenssin, joka rajaa käyttöoikeuden ko. ohjelman käyttämiin tietoihin. REST-rajapinnan käyttöoikeus vaatii IWS_LOG-lisenssin.","type":"text"}]},{"type":"paragraph","content":[{"text":"Huomaa, että myös prosessikäyttäjällä tulee olla IWS_LOG-lisenssi. SOAP- ja REST-rajapintoihin lisätty API-avain yksilöi Lemonsoftin rajapintaan integroidun sovelluksen. Tämä parantaa tietojen siirron jäljitettävyyttä ja parantaa tietoturvaa. API-avaimesta voit lukea tarkemmin ","type":"text"},{"type":"inlineCard","attrs":{"url":"https://lemondoc.atlassian.net/wiki/spaces/KYTTJHALLI/pages/318570497"}},{"text":" ","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Muutokset olemassa oleviin integraatioihin","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Olemassa olevaan SOAP-rajapintaa käyttävään integraatioon tulee tehdä muutoksia. Viestin rakenne on muuttunut ja lisäksi tarvitset API-avaimen rajapinnan käyttämistä varten. Myös sanomaliikenne on jatkossa pakotetusti suojattua.","type":"text"},{"type":"hardBreak"}]},{"type":"paragraph","content":[{"text":"SOAP Autentikointi","type":"text","marks":[{"type":"strong"}]},{"type":"hardBreak"},{"text":"login-kutsussa tarvitaan API-avain, jonka annat ApiKey-parametriksi. Perusperiaate on ennallaan.","type":"text"},{"type":"hardBreak"},{"text":"Autentikointi tapahtuu rekisteröimälläsi sähköpostitunnuksella ja sen salasanalla.","type":"text"},{"type":"hardBreak"},{"text":"Palveluun on ensin muodostettava yhteys, jolloin saadaan Session ID, jota ohjelma käyttää jatkossa tunnistautumiseen.","type":"text"},{"type":"hardBreak"},{"text":"Muilta osin rajapinnan käyttö tapahtuu kuten aiemmin. Rajapinnan vaatima käyttäjä on käyttäjähallinnassa perustamasi paikallinen käyttäjä. Muut tunnistautumistavat eivät ole mahdollisia, koska rajapinnan täytyy tietää käyttäjän salasana.","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n\n\n\n\n\nApi-avain\n\nLemonDBx\n\nPASSWORD\n\nexample@example.com\n\n\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"SOAP Viestin rakenne","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Soap-sanoman rakenne säilyy ennallaan. Parametreistä tulee huomioida, että ovat alkuperäisessä järjestyksessä. Rajapinnan julkaiseman WSDL-dokumentaation avulla saat muodostettua rakenteet.","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n\n\n\n SESSION_ID \nTestinimi\n10\n\n\n\n","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"API-avain","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Löydät lähdekoodiesimerkkejä API-avaimen käyttämisestä tästä (","type":"text"},{"type":"inlineCard","attrs":{"url":"https://lemondoc.atlassian.net/wiki/spaces/KYTTJHALLI/pages/392790033"}},{"text":")","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"TLS salausprotokollan käyttö","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Lemonsoftin Alustapalvelussa on aina käytetty suojattuja yhteyksiä. Uuden version myötä pakotamme asetuksen myös paikallisasennuksiin. Mikäli et jostain syystä voi käyttää HTTPS-protokollaa, saat asiakaspalvelustamme ohjeen, jolla voit kytkeä salauksen pois päältä. ","type":"text"}]},{"type":"paragraph","content":[{"text":"Muutokset koskevat ","type":"text"},{"text":"web.config","type":"text","marks":[{"type":"strong"}]},{"text":" -tiedostoa. Integraation toteutukseen tämä muutos ei siis vaikuta.","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"ServiceMetadata:","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Vanha:","type":"text"}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"paragraph","content":[{"text":"Uusi:","type":"text"}]},{"type":"codeBlock","content":[{"text":"","type":"text"}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"BasicHttpBindingConfiguration","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Vanha:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n","type":"text"}]},{"type":"paragraph","content":[{"text":"Uusi:","type":"text"}]},{"type":"codeBlock","content":[{"text":"\n \n","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Rajapintojen tukeminen","type":"text","marks":[{"type":"strong"}]}]},{"type":"paragraph","content":[{"text":"Jos tarvitset konsultointia rajapintaan tehtävien muutosten osalta, voit olla yhteydessä asiakaspalveluumme, ","type":"text"},{"text":"MyLemon","type":"text","marks":[{"type":"underline"},{"type":"link","attrs":{"href":"https://lemonsoft.zendesk.com/hc/fi"}}]},{"text":"-yhteisön kautta.","type":"text"}]},{"type":"rule"},{"type":"paragraph"}],"version":1}

Selainta ei tueta