Kolme integraatiomallia vertailussa

AI Commercen natiivi rajapinta, AI Connector ja GraphQL ovat kolme erilaista vastuumallia järjestelmien väliseen tiedonsiirtoon. Mallia ei valita vain teknisen helppouden perusteella. Ratkaisevaa on, kuka omistaa integraation ajamisen, kenttien mappaukset, asiakaskohtaisen logiikan, tunnukset, lokit, virheenkorjauksen ja jatkokehityksen.

Nykyinen GraphQL-palvelu on AI Commercen ja sen kumppaneiden sisäiseen käyttöön tarkoitettu monivuokralainen rajapinta, ei vapaasti avoin julkinen API. Käyttö vaatii erikseen myönnetyn pääsyn ja palvelinpuolella säilytettävät tunnukset.

Integraatiomallit lyhyesti

AI Commercen kolme integraatiomallia jakavat vastuun eri tavoin:

• AI Commercen natiivi rajapinta: AI Commerce hallitsee integraation infrastruktuuria, ydintoteutusta, ylläpitoa ja sovittuja mappauksia. Asiakaskohtaisia asetuksia ja sääntöjä voidaan toteuttaa sovitun palvelumallin puitteissa.
• AI Connector: AI Commerce tarjoaa integraatioympäristön ja ajomallin, mutta asiakas tai kumppani voi hallita sovitussa projektikerroksessa mappauksia, muunnoksia ja asiakaskohtaisia sääntöjä ilman pääsyä ydinkoodiin.
• GraphQL: AI Commerce ylläpitää rajapintapalvelua ja sen tietosopimusta. Asiakas, kumppani tai ulkoinen palvelinympäristö omistaa kutsuvan integraation, sen ajamisen, mappauksen ja liiketoimintalogiikan.

Kaikilla malleilla voidaan siirtää tietoa järjestelmien välillä, mutta tuettu tietosisältö, luku- ja kirjoitusoikeudet sekä palvelutasot sovitaan integraatiokohtaisesti. Mallin nimi ei yksin takaa tietyn resurssin tai toiminnon saatavuutta.

Nopea vastuuvertailu

AI Commercen integraatiomallien olennaiset erot näkyvät omistajuudessa:

Kirjaa vastuut projektisopimukseen ennen toteutusta. Erityisesti mappauksen omistaja, tuotantotunnusten haltija, päivystysvastuu ja muutosten hyväksyntä pitää nimetä, jotta virhe ei jää kahden organisaation väliin.

AI Commercen natiivi rajapinta

AI Commercen natiivi rajapinta rakennetaan ja ylläpidetään AI Commercen oman alustan yhteydessä. Se sopii tilanteeseen, jossa asiakas haluaa yhden päävastuutahon ja integraatio liittyy läheisesti alustan ydintoimintoihin. Ulkopuolinen kumppani voi osallistua tietovirran ja virheen selvitykseen, mutta ei saa pääsyä AI Commercen ydinkoodiin.

Natiivi malli voi sisältää oletuslogiikan lisäksi vuokralaiskohtaisia mappauksia, arvoja ja poikkeuksia. Muutos ei silti ole asiakkaan vapaasti muokattava skripti, vaan se määritellään, toteutetaan ja julkaistaan AI Commercen hallitsemassa prosessissa.

Natiivi rajapinta sopii erityisesti, kun samaa toteutusta voidaan hyödyntää usealla asiakkaalla, ylläpitovastuun halutaan pysyvän AI Commercella tai integraatio vaatii tiiviin yhteyden alustan tietomalliin. Uusi toteutus voi vaatia erillisen käyttöönottoprojektin, rakennustyön ja jatkuvan ylläpidon.

AI Connector

AI Connector erottaa projektikohtaisen mappauksen ja integraatiosäännöt AI Commercen ydinkoodista. AI Commerce tarjoaa integraation infrastruktuurin ja turvallisen ajomallin, kun taas sovittu asiakas- tai kumppanikerros määrittää kenttien mappaukset, tietomuunnokset, käsittelyjärjestyksen sekä projektikohtaiset säännöt ja poikkeukset.

AI Connector sopii tilanteeseen, jossa AI Commercen hallitsema ympäristö halutaan säilyttää mutta jokaista mappausmuutosta ei haluta toteuttaa ydintuotteen kehitystyönä. Malli ei anna ulkopuoliselle pääsyä ydinkoodiin. Se antaa hallinnan vain erikseen rajattuun projektikerrokseen ja sovittuihin tietovirtoihin.

Valitse AI Connector, jos asiakkaalla tai kumppanilla on aito vastuu mappausten jatkuvasta ylläpidosta, integraatio tarvitsee paljon asiakaskohtaista muunnoslogiikkaa tai omaa iPaaS-infrastruktuuria ei haluta rakentaa. Sovi samalla, kuka ylläpitää loki- ja virheenkorjausnäkymiä ja missä raja alustan sekä projektikerroksen välillä kulkee.

GraphQL

AI Commercen GraphQL on sisäinen, monivuokralainen API AI Commercen ja sen kumppaneiden integraatioille. Se tarjoaa dokumentoituja kyselyitä ja mutaatioita tuetuille resursseille, mutta kutsuva järjestelmä vastaa omasta ajamisesta, mappauksesta, virheenkäsittelystä ja liiketoimintalogiikasta. GraphQL ei itsessään hostaa asiakkaan työnkulkua.

GraphQL sopii, kun olemassa oleva järjestelmä, kumppanin palvelu tai ulkoinen automaatioympäristö tarvitsee hallitun API-yhteyden AI Commerceen ja toteuttaja haluaa omistaa integraatiokoodin. Käyttö vaatii vuokralaiskohtaisen tunnistuksen ja erillisen GraphQL-tunnuksen; tunnuksia ei saa sijoittaa selaimeen tai muuhun asiakaspään koodiin.

Rajapinta palauttaa vain kysytyt kentät, mutta se ei tee mappauksesta tai prosessista automaattisesti oikeaa. Toteuttajan pitää hallita skeemamuutokset, kutsurajat, uudelleenyritykset, idempotenssi, virhevastaukset, lokitus ja salaisuuksien kierto omassa ympäristössään.

Valitse integraatiomalli vastuun perusteella

AI Commercen integraatiomallin valinta alkaa viidestä kysymyksestä:

1. Kuka hallitsee integraation infrastruktuuria ja tuotantoajoa?
2. Kuka määrittää ja muuttaa kenttien mappauksia?
3. Kuka omistaa integraation liiketoimintalogiikan ja asiakaskohtaiset poikkeukset?
4. Kenen kautta jatkokehitys tilataan ja kuka hyväksyy julkaisun?
5. Tarvitseeko asiakas tai kumppani suoran hallinnan projektikohtaiseen logiikkaan?

Jos AI Commercen halutaan hallitsevan ympäristöä, mappausta ja kehitystä, natiivi rajapinta on lähtökohta. Jos AI Commercen ympäristö halutaan säilyttää mutta asiakas tai kumppani tarvitsee hallinnan projektikohtaisiin mappauksiin, arvioi AI Connector. Jos kutsuva järjestelmä ja integraatiologiikka halutaan pitää ulkopuolisessa ympäristössä, arvioi GraphQL.

Integraatiot-näkymässä /configuration/integrations voit tarkistaa hallintapaneeliin tuodut integraatiokortit ja niiden tilan. Näkymän olemassaolo ei kuitenkaan määritä projektin vastuurajaa; se pitää sopia integraatiokohtaisesti.

Esimerkit integraatiomallien valinnasta

AI Commercen natiivi rajapinta sopii esimerkiksi ERP-integraatioon, jonka tietovirran, oletuslogiikan ja vuokralaaskohtaiset mappaukset AI Commerce rakentaa ja ylläpitää. Asiakas tilaa muutokset samalta päävastuutaholta eikä ylläpidä erillistä integraatioympäristöä.

AI Connector sopii esimerkiksi projektiin, jossa kumppani muuntaa asiakkaan ERP-kentät, määrittää käsittelyjärjestyksen ja ylläpitää poikkeussääntöjä, mutta suoritusympäristö ja yhteys AI Commercen tietomalliin ovat AI Commercen hallinnassa.

GraphQL sopii esimerkiksi ulkoiseen SaaS- tai automaatiopalveluun, joka käsittelee tietoa omassa ympäristössään ja käyttää AI Commercen tuettuja kyselyitä tai mutaatioita. Kutsuva toteuttaja vastaa oman palvelunsa loki-, mappaus-, uudelleenyritys- ja tietoturvakäytännöistä.

Lokit, virheet ja kustannukset

AI Commercen integraation virhe selvitetään aina vastuurajan molemmin puolin. Natiivissa rajapinnassa AI Commerce vastaa ylläpitämänsä tietovirran dokumentoidusta toiminnasta. AI Connectorissa ensin ratkaistaan, onko virhe alustassa, projektikerroksessa vai mappauksessa. GraphQLissä tarkistetaan sekä API-vastaus että kutsuvan järjestelmän loki.

Kustannukset muodostuvat mallista riippuen käyttöönotosta, mahdollisesta rakennustyöstä, integraatioympäristön käytöstä, jatkuvasta ylläpidosta ja käyttöoikeudesta. Natiivissa mallissa paino on AI Commercen toteutus- ja ylläpitopalvelussa, AI Connectorissa ympäristössä sekä jaetussa ylläpidossa ja GraphQLissä API-pääsyssä sekä toteuttajan oman ympäristön kustannuksissa.

Älä vertaa malleja pelkällä kuukausihinnalla. Arvioi myös muutosten läpimenoaika, päivystys, lokien saatavuus, salaisuuksien hallinta, testausympäristöt ja se, kuka maksaa virheen selvittämisestä. Ajantasainen kaupallinen sisältö vahvistetaan aina projektitarjouksessa.

Yhteenveto

AI Commercen natiivi rajapinta, AI Connector ja GraphQL eivät ole suoria korvikkeita. Natiivissa mallissa AI Commerce hallitsee ympäristöä ja toteutusta. AI Connectorissa AI Commerce tarjoaa ympäristön, mutta projektikohtaista mappausta ja logiikkaa voidaan antaa asiakkaan tai kumppanin hallintaan. GraphQLissä AI Commerce ylläpitää sisäistä kumppani-API:a ja kutsuva toteuttaja omistaa integraationsa.

Valitse malli sen perusteella, missä integraation pitää elää ja kenellä pitää olla muutosvalta. Kirjaa ennen toteutusta ympäristön, mappauksen, liiketoimintalogiikan, tunnusten, lokien, virheenkorjauksen, jatkokehityksen ja kustannusten omistajat. Selkeä vastuumalli on tärkeämpi kuin teknologian nimi.