API Process Queue -näkymän avulla näet, mitä rajapinnan prosesseja ja sanomia on jonossa, miksi jokin käsittely jumittaa ja missä virheet ovat. Tämä auttaa erityisesti tilanteissa, joissa ulkoinen järjestelmä (esim. Akeneo) lähettää suuria massapäivityksiä, joita AI Commerce käsittelee jonossa erissä aikakatkaisujen välttämiseksi.

Mistä editoidaan

• Jonon tarkastelu: Hallintapaneeli > Reports → API Process Queue
• Jonon tyhjennys: näkymän Flush-painike

Miten näkymä toimii

• Sivu näyttää taulukossa kaikki rivit tietokannan api_process_queue-taulusta.
• Sivulla ei ole hakua tai suodattimia: tarkoitus on pitää näkymä nopeana ja yksinkertaisena.
• Uusimmat rivit näkyvät ensimmäisenä.
   

Miksi jono on olemassa

• Jonon tarkoitus on hallita suuria päivitysmääriä ilman aikarajakatkaisuja.
• Esimerkki: jos ulkoisesta järjestelmästä kuten Akeneosta tulee sadalle tuhannelle tuotteelle kerralla päivitys, verkkokauppa ei pysty käsittelemään tätä yhdessä hetkessä yhdessä pyynnössä aikarajakatkaisujen vuoksi.
• Tällöin prosessi jää jonoon ja sitä käsitellään erissä, esimerkiksi 100 tuotetta minuutissa.

Näin sanomat päätyvät jonoon

1) Sisään tulevat sanomat (ulkoinen järjestelmä → AI Commerce)

• Jonoon ei voi “kerryttää” sisään tulevia viestejä AI Commerce -sovelluksen kautta, vaan sisään tulevat viestit syntyvät ulkoisesta järjestelmästä, kun ulkoiset järjestelmät ilmoittavat muutoksista.
• Jos haluat nähdä tässä näkymässä ulkoisesta järjestelmästä tulevia sanomia, tee muutoksia ulkoisessa järjestelmässä.
• Kun AI Commerce kysyy muutoksia ulkoisesta järjestelmästä, ulkoinen järjestelmä vastaa muutoksista ja ne tulevat jonoon näkyviin.

2) Ulospäin lähtevät sanomat (AI Commerce → ulkoinen järjestelmä)

• Ulospäin lähtevät sanomat tulevat jonoon tyypillisesti automaattisesti asianmukaisten toimien johdosta.
• Esimerkki: kun verkkokaupan kassalla luodaan tilaus, se muodostuu jonoon pienellä viiveellä.
• Vastaavasti asiakastilin editoinnit verkkokaupan käyttöliittymässä muodostuvat jonoon hetken kuluttua.

Taulukon sarakkeet (englanniksi UI:ssa)

Virheiden tunnistaminen ja vaikutus rajapintaan

• Näet mahdolliset virheet Error-sarakkeessa.
• Jos jonossa on paljon virheitä, se voi pysäyttää koko rajapinnan toiminnan, koska tietyt rajapinnat katsovat, paljonko on jumissa olevia sanomia.
• Jos jumissa olevia sanomia on hyvin paljon, käsittely voidaan lopettaa, koska rajapinta olettaa, että ihmisen pitää tehdä tarkastus syistä, miksi virheitä on näin paljon.

Flush-toiminto (jonon tyhjennys)

• Flush tyhjentää koko jonon yhdellä toiminnolla.
• Toiminto pyytää varmistuksen ennen tyhjennystä.
• Käytä tätä, jos jono näyttää jumittuneen.

Toimintaohje: kun jonossa on paljon virheitä

1. Avaa Hallintapaneeli > Reports → API Process Queue ja tarkista, kuinka paljon rivejä jonossa on ja mihin aikaan ne on luotu (Created At).
2. Tarkista virheet Error-sarakkeesta ja tunnista, liittyvätkö ne sisään tuleviin (ulkoinen järjestelmä → AI Commerce) vai ulospäin lähteviin sanomiin (AI Commerce → ulkoinen järjestelmä).
3. Jos virheet liittyvät ulkoisesta järjestelmästä tuleviin päivityksiin, tee tarvittavat korjaukset ulkoisessa järjestelmässä (esim. Akeneo) ja tuota muutokset uudelleen siellä, jotta seuraavalla haulla ulkoinen järjestelmä vastaa oikein.
4. Jos huomaat, että jonossa on paljon pelkkiä virheellisiä sanomia, voit nollata jonon (Flush) ja tehdä pyynnöt uudestaan korjausten jälkeen, jotta seuraavalla kerralla pyynnöt menisivät lävitse.
5. Jos virheet koskevat todella vanhoja päivityksiä, jotka ovat jo vanhoja ja jo käsiteltyjä (eli käytännössä turhia päivityksiä), voit huoletta nollata jonon: kaikki virheelliset prosessit poistuvat Flush-painikkeella.

Lisävinkit

• Muista, että sisään tulevien sanomien “näkyminen jonossa” edellyttää muutoksia ulkoisessa järjestelmässä, koska sanomat syntyvät ulkoisten järjestelmien ilmoittamista muutoksista.
• Ulospäin lähtevissä sanomissa pieni viive on normaalia (esim. tilaus kassalta tai asiakastilin muokkaus näkyy jonossa hetken kuluttua).
• Riippuen rajapinnoista, osa rajapinnoista nollaa tätä jonoa itsestään tietyn ajan.
• Huom: alkuperäisessä kuvauksessa mainittiin, että rajapintaan liittyen on vielä muita lisätietoja; tämä artikkeli keskittyy API Process Queue -jonon käyttöön ja vianetsintään.

Yhteenveto

API Process Queue auttaa seuraamaan rajapinnan jonotusta, ymmärtämään massapäivitysten käsittelyä ja löytämään virheet Error-sarakkeesta. Kun virheellisiä rivejä kertyy paljon tai jono jumittaa, Flush on ensisijainen keino nollata jono ja tuottaa sanomat uudelleen korjausten jälkeen.

Avainsanat

• API Process Queue
• Reports → API Process Queue
• Flush queue
• api_process_queue
• rajapintajono
• Error-sarake
• Akeneo integraatio
• massapäivitys tuotteet
• jonon nollaus
• Hallintapaneeli