Materiaalin käsittelylaitteiden rajapinta (MHAX)

Materiaalin käsittelylaitteiden liittymää (MHAX) voi käyttää yhteyden muodostamiseen varastonhallintaprosesseja (WMS) Microsoft Dynamics 365 Supply Chain Managementissa käyttävän varaston ja ulkoisten fyysisten materiaalinkäsittelyjärjestelmien (MH) välille. WMS- ja MH-järjestelmien välinen rajapinta koostuu kahdesta jonosta: yksi lähteville tapahtumille (WMS -> MH) ja toinen saapuville tapahtumille (MH -> WMS). WMS-järjestelmä luo lähteviä tapahtumia niiden työrivien perusteella, jotka luodaan työn luomisen ja suorittamisen eri prosessien aikana. Tämän jälkeen MH-järjestelmä kyselee WMS-järjestelmältä säännöllisesti uusia tapahtumia ja käsittelee vastaukset. Kun MH-järjestelmä on lopettanut tapahtumien käsittelyn työohjeiden mukaisesti, se lähettää saapuvia tapahtumia, kuten työrivien valmistumisia ja lyhyitä keräilyjä.

Tärkeä

Jos otat tämän ominaisuuden käyttöön, tietosi saatetaan jakaa valitsemiesi kolmannen osapuolten palveluiden kanssa. Päätät itse, mitä tietoja kolmannelle osapuolelle mahdollisesti jaetaan. Kolmannen osapuolen palveluiden käyttö on omalla vastuullasi, ja se määräytyy sinun ja kolmannen osapuolen välillä sovittujen ehtojen mukaan. Tietosuojasi on meille tärkeä. Lisätietoja on tietosuojalausekkeessa.

Seuraavassa kuvassa esitetään eri elementit sekä järjestys, jossa prosessit tapahtuvat, kun käytetään MHAX-integrointia.

Seuraavassa on selitys edellisessä kuvassa näkyvistä vuorovaikutuksista:

1. Työn luomisen tai työn suorittamisen aikana lähtevät tapahtumat luodaan lähtevien jonoon.
2. MH-laitteisto muodostaa yhteyden MH-laitteistopalveluun, kyselee sen kannalta merkittäviä uusia tapahtumia ja käsittelee nämä tapahtumat.
3. Kun MH-laitteisto on valmis vastaamaan, se muodostaa yhteyden palveluun uudelleen ja lähettää saapuvia tapahtumia. Jonon käsittelyprosessi käsittelee nämä tapahtumat heti.
4. Riippuen saapuvien tapahtumien tiedoista, jonon käsittelyprosessi saattaa suorittaa olemassa olevia töitä, muokata niitä tai luoda uusia töitä.

MHAX-toiminnon käyttöönotto

Ennen kuin voit käyttää MHAX-toimintoa, sekä sen toiminto että sen määritysavain on otettava käyttöön.

1. Jos käytössä on Supply Chain Managementin versio 10.0.28 tai aiempi versio, tee seuraavat toiminnot:
   1. Valitse Järjestelmänvalvoja > Työtilat > Ominaisuuksien hallinta.
   2. Ota Toiminnonhallinta-työtilassa käyttöön Materiaalin käsittelylaitteiden rajapinta -toiminto. (Supply Chain Managementin versiosta 10.0.29 alkaen tämä toiminto on pakollinen, eikä sitä voi poistaa käytöstä.)
2. Siirrä järjestelmä ylläpitotilaan kohdassa Ylläpitotila kuvatulla tavalla.
3. Valitse Järjestelmän hallinta > Asetukset > Käyttöoikeuden konfiguraatio.
4. Laajenna Kauppa > Varaston- ja kuljetuksenhallinta ja valitse sitten Materiaalin käsittelylaitteiden rajapinta -valintaruutu.
5. Poista järjestelmän ylläpitotila käytöstä kohdassa Ylläpitotila kuvatulla tavalla.

MHAX-parametrien määritys

Toiminnon määrittäminen edellyttää joidenkin yleisten parametrien määrittämistä Materiaalin käsittelylaitteiden rajapinnan parametrit -sivulla.

1. Siirry kohtaan Materiaalin käsittelylaitteiden rajapinta > Määritys > Materiaalin käsittelylaitteiden rajapinnan parametrit.

2. Määritä Yleiset-välilehdessä seuraavat kentät:

   • Käyttäjien yhdistämismääritykset – Yhdistä järjestelmän käyttäjiä heihin liittyviin varastotyöntekijöihin. Järjestelmän käyttäjiä käytetään saapuvien jonopalvelun kutsumiseen. Valituille työntekijöille määritetään työvaiheet (keräilyt ja hyllytykset), jotka käsitellään saapuvien jonon avulla. Työvaiheet suoritetaan kunkin työntekijän oletusvarastossa.
   • Ota saapuvien sanomien tunnus käyttöön – Kun tämän asetuksen arvona on Kyllä ja vastaanotetaan saapuvan sanoman tunnuksen kaksoiskappale, sanoma hylätään ja virheilmoituksessa ilmoitetaan, että sanoma on jo olemassa. Kun tämän asetuksen arvona on Ei, saapuvien sanomien tunnusten kaksoiskappaleet ovat sallittuja.
   • Ota manuaalinen saapuvien sanomien luominen käyttöön – Kun tämän asetuksen arvona on Kyllä, voit simuloida saapuvia sanomia luomalla tietueen suoraan Saapuvien jono -sivulla.

3. Valitse Numerosarjat-välilehdessä järjestelmän laajuiset numerosarjat, joita pitäisi käyttää yksilöllisten tunnusten luomiseen saapuvien jonon kohteille, lähtevien jonon kohteille ja työrivipareille.

Lähtevät tapahtumat

Järjestelmä määrittää tietyissä työn luomisen tai työn suorittamisen kohdissa, pitääkö sen luoda lähteviä tapahtumia MH-järjestelmään lähetettäväksi. Jos tilaus on määritetty tiettyyn kohtaan varastossa käsittelyä, järjestelmä luo tapahtuman tilauksen määrityksen mukaisesti.

Lähtevien tapahtumien rakenne

Kullakin lähtevällä tapahtumalla on yksilöllinen lähtevän jonon tunnus. Lähtevän transaktion tyyppi määrittää tapahtuman tyypin. Tapahtumalle kirjataan myös varasto ja tapahtuman luoneen tilauksen tunnus.

Tietojen viemiseksi MH-järjestelmään lähtevä tapahtuma sisältää 10 tietokenttää (tieto01–tieto10). Nämä tietokentät vastaavat suoraan (1:1) olemassa olevia tietokantakenttiä. Tarkemmin sanoen ne haetaan työrivin ja työotsikkotaulukkojen kentistä. Kentät voidaan valita vapaasti. Ne määritetään tilausta luotaessa.

Tapahtuma voi olemassa olevia tietokantakenttiä suoraan vastaavien 10 tietokentän lisäksi sisältää ylimääräisen tietokentän, josta käytetään nimitystä lisätiedot. Tämän kentän sisältö luodaan mukautetulla X++-koodilla, jota kutsutaan lisätietogeneraattoriksi. Tilauksessa on määritetty mahdollisesti käytettävät lisätietogeneraattorit.

Sen varmistamiseksi, että MH-järjestelmä vastaanottaa jokaisen lähtevän jonon tunnuksen vain kerran, käytetään tilakenttää sen määrittämiseen, onko tapahtuma valmis lähetettäväksi ulkoiseen materiaalinkäsittelyjärjestelmään (Valmis-tila) vai onko se jo lähetetty (Lähetetty-tila).

Lähtevien jonon tilaukset

Ennen tapahtumien luomista on määritettävä tilaus, jolla MHAX-toiminnolle ilmoitetaan, luodaanko tapahtumia ja miten niitä mahdollisesti luodaan. Luoduille tapahtumille määritetään tilaustunniste. Siten useat MH-järjestelmät voivat muodostaa yhteyden samaan WMS-järjestelmään, mutta pitää tapahtumansa erillään. Kun MHAX-palvelulta kysellään uusia tapahtumia, tilaus on yksi vaihtoehdoista tapahtumien hakemiseksi.

Voit luoda tilauksen valitsemalla Materiaalin käsittelylaitteiden rajapinta > Määritys > Tilaukset. Seuraavat parametrit ovat käytettävissä kunkin tilauksen osalta:

• Tilaustunnus – Yksilöllinen nimi, jonka perusteella tilaus voidaan tunnistaa.
• Kuvaus – Vapaamuotoinen tilauksen kuvaus.
• Varasto – Ne varastot, joiden perusteella tapahtumat suodatetaan.
• Lähtevän tapahtuman tyyppi – Niiden tapahtumien tyyppi, joita tilauksen on sisällettävä.
• Lisätietogeneraattori – Valinnainen koodilaajennus, jolla voidaan lisätä tietoja lähtevän tapahtuman Lisätiedot-kenttään.

Kuhunkin tilaukseen voidaan liittää kysely. Tämä kysely suodattaa työrivejä ja otsikkoja, jotta rajoitettaisiin entisestään töitä, jotka käyttävät tilausta tapahtumien luomiseen. Voit lisätä kyselyn tilaukseen valitsemalla kulloisenkin tilauksen Suorita kysely -valintaruudun Tilaukset-sivulla ja valitsemalla sitten toimintoruudusta Muokkaa kyselyä. Näkyviin tulee vakiomuotoinen Supply Chain Managementin kyselyeditori.

Lisäksi tilauksella on tilauskartta, joka yhdistää kenttiä joko työn otsikosta tai työriviltä kaikkiin tai joihinkin lähtevän tapahtuman 10 vapaasta tietokentästä tarpeen mukaan. Tietojen palauttamiseksi MHAX-palveluun sisällytetään yleensä työrivitietueen tunnus tai työriviparin tunnus. (Työriviparin tunnus on uusi ominaisuus, jonka avulla järjestelmä voi käyttää yksittäistä palautuskomentoa poiminta- ja asetusrivien käsittelemiseen.) Muut kentät määräytyvät käyttötapauksen mukaan. Esimerkkejä esitetään myöhemmin tässä artikkelissa.

Voit luoda tilauskartan valitsemalla kulloisenkin tilauksen Tilaukset-sivulta ja valitsemalla sitten toimintoruudusta Tilauskartta. Näkyviin tulevassa Tilauskartta-valintaikkunassa voit määrittää taulukon ja kentän kullekin käytettävissä olevalle tietokentälle tarpeen mukaan.

Lähtevien tapahtumien tyypit

Tässä osassa kuvataan erilaiset käytettävissä olevat tapahtumatyypit. (Tapahtumatyypeistä käytetään myös nimitystä transaktiotyypit.) Lisäksi kuvataan, milloin kukin tapahtumatyyppi luodaan WMS-järjestelmässä.

Työnluontitapahtumat (WorkCreation)

Työnluontitapahtumat luodaan, kun sovellus on luonut työn. Tämä toiminta pätee useimpiin työnluontiprosessien tyyppeihin ja erityisesti poiminta- ja täydennystöiden luomiseen. Yleensä, kun työ luodaan tilassa Avoin, mikä tarkoittaa, että työ on valmiina työntekijän suoritettavaksi, luodaan työnluontitapahtuma. Lisäksi työnluontitapahtumia luodaan perustason siirtotöille (ei mallityöhön perustuville siirroille), vaikka kyseisiä töitä ei luotaisi avoimena työnä.

Merkittävä poikkeus tähän toimintaan on inventointityö, jota ei tällä hetkellä tueta. MH-järjestelmän varastomäärät ovat MHAX-järjestelmän sovellusalan ulkopuolella, ja laskentojen tulokset on tuotavat inventaarionlaskennan kirjauskansioon.

Kun työ on luotu, MHAX-palvelu käsittelee luodut työrivit ja märittää työriviparin tunnuksen kaikkien työotsikkojen kaikille luoduille työriveille. Tarkoituksena on ryhmittää kaikki poimintatyörivit niiden jälkeen tulevien asetusten jälkeen yhteisen työriviparin tunnuksen alle. (Ryhmät vastaavat työmallien poiminta-asetuspareja.) Tällä tavoin yksittäistä tunnusta voidaan käyttää ilmoittamaan kaikkien toisiinsa liittyvien poiminta- ja asetusrivien töiden valmistumisesta. Ryhmittelyprosessi alkaa ensimmäisestä rivistä ja jatkuu samalla tunnuksella, kunnes tavataan peräkkäinen pari asetus- ja poimintatyörivejä. Juokseva tunnus määritetään parin asetusriville. Tämän jälkeen seuraavan parin poimintariville määritetään uusi tunnus. Tämä prosessi jatkuu, kunnes kaikki työotsikkoon kuuluvat rivit on käsitelty.

Työnluontitapahtumien erikoisominaisuutena luoduilla tapahtumilla on tila Estetty tavanomaisen niiden MH-järjestelmään lähettämiseen käytettävän Valmis-tilan sijaan, jos työotsikon Estetty aalto -asetuksen arvona on Kyllä. Työotsikon Estetty aalto -merkintä ilmaisee, että työotsikko ei vielä ole valmis työntekijöiden suoritettavaksi. Syynä voi olla esimerkiksi valmistumaton täydennystyö. Kun Estetty aalto -merkintä poistetaan, jo luotujen tapahtumien esto poistetaan. Tällöin ne ovat valmiina MH-järjestelmän noudettavaksi jonosta.

Työnalustustapahtumat (WorkInitiation)

Työnalustustapahtumia luodaan, kun työn tila muuttuu tilasta Avoin tilaan Käynnissä työnpäivityksen yhteydessä.

Työnvalmistumistapahtumat (WorkCompletion)

Työnvalmistumistapahtumia luodaan, kun työn tila muuttuu tilasta Käynnissä tilaan Suljettu työnpäivityksen yhteydessä.

Työnperuutustapahtumat (WorkCancel)

Työnpalautustapahtumia luodaan, kun työn tila muuttuu mistä tahansa muusta tilasta kuin tilasta Peruutettu tilaan Peruutettu työnpäivityksen yhteydessä. Lisäksi kaikki muut työotsikkoon liittyvät tapahtumat poistetaan kaikkien tilausten jonosta. Näin ulkoisia järjestelmiä estetään käsittelemästä tarpeettomia tapahtumia.

Poiminnan/asetuksen valmistumistapahtumat (PickCompletion/PutCompletion)

Poiminnan/asetuksen valmistumistapahtumia luodaan, kun poiminta-/asetusrivin tila muuttuu tilasta Käynnissä tilaan Suljettu työrivin päivityksen yhteydessä.

Lähtevien jonon seuranta

Voit tarkistaa lähtevien jonon valitsemalla Materiaalin käsittelylaitteiden rajapinta > Yhteiset > Lähtevien jono. Lähtevien jono -sivulla on luettelo kaikista lähtevien jonon kohteista ja niiden tiloista. Voit tarkastella jonokohteen tietoja valitsemalla sen. Näitä tietoja ovat esimerkiksi kohteen tapahtumatyyppi, käytetty tilaus sekä kunkin tietokentän (tieto01–tieto10) arvo ja lisätiedot.

Lähtevien jonon tyhjentäminen

Ennen pitkää lähtevien jono täyttyy jonokohteista, jotka on jo lähetetty. Voit poistaa nämä kohteet valitsemalla Materiaalin käsittelylaitteiden rajapinta > Säännölliset tehtävät > Tyhjennys > Lähtevien jonon tyhjennys.

Saapuvat tapahtumat

Tässä osassa kuvataan erilaiset saapuvat tapahtumat, joista MH-järjestelmä voi ilmoittaa takaisin WMS-järjestelmälle. Siinä selitetään myös, että MH-järjestelmän on toimitettava tiedot, ja se, mitä kukin saapuva tapahtuma saa aikaan WMS-järjestelmässä.

Saapuvien tapahtumien rakenne

Kun saapuva tapahtuma lähetetään, ulkoisen järjestelmän on toimitettava saapuvan transaktion tyyppi sekä enintään 10 parametria (tieto01–tieto10). Valinnaisen vahvistuksen avulla voidaan varmistaa, että MHAX-palvelu ei ole vastaanottanut saapuvaa tapahtumaa kuin yhden kerran. Jotta tämä vahvistus olisi käytössä, kullakin saapuvalla tapahtumalla on oltava yksilöllinen sanomatunnus. Jos sanomatunnuksen kaksoiskappale vastaanotetaan ja Käytä saapuvan sanoman tunnusta -asetuksen arvona Materiaalin käsittelylaitteiden rajapinnan parametrit -sivulla on Kyllä, sanoma hylätään. Virhesanoma ilmaisee, että sanoma on jo olemassa.

Saapuvien tietokenttien lisäksi järjestelmä määrittää tapahtumalle yksilöllisen saapuvan jonon tunnuksen.

Saapuvien tapahtumien tyypit

Tässä osiossa kuvataan saapuvien tapahtumien tyypit (transaktiotyypit), joita tuetaan, sekä tiedot, jotka on annettava, jotta tapahtumat käsitellään.

Työn vahvistustapahtumat (WorkConfirm)

Työn vahvistustapahtumat edellyttävät, että saapuvat tietokentät sisältävät seuraavat tiedot:

• tieto01 – Työriviparin tunnus.

• tieto02 – Työrivitietueen tunnus (RecId-arvo).

  Muistiinpano

  Joko kentällä tieto01 tai kentällä tieto02 on oltava arvo.

• tieto03 – Sen rekisterikilven tunnus, josta poiminta suoritetaan.

• tieto04 – Työotsikon kohteen rekisterikilven tunnus.

Jos työriviparin tunnus annetaan, suoritetaan peräkkäin kaikki poiminta-, asetus- tai muokatut työrivit, jotka on merkitty työriviparin tunnuksilla ja joiden tila on Avoin tai Käynnissä. Jos työrivitietueen tunnus (RecIdarvo) on annettu, työrivin on oltava poiminta-, asetus- tai muokattu työrivi, jonka tilana on Avoin tai Käynnissä.

Paikat, joita hallitaan poimimalla rivejä rekisterikilvestä, edellyttävät, että tieto03 määrittää rekisterikilven, josta poimitaan, riippumatta siitä, onko rivit merkitty työrivitietueen tunnuksella vai työriviparin tunnuksella. tieto04-kentässä on määritettävä työotsikon poiminnan kohteena oleva rekisterikilpi.

Asetusriveillä ei voi olla muita tietoja. Ne suoritetaan vain nykyisen työrivin sijainnin sekä työn kohteena olevan rekisterikilven perusteella. Jos asetus on suoritettava eri sijainnissa, muuta työrivin sijaintia myöhemmin tässä artikkelissa olevassa Ohitustapahtumat-osassa kuvatulla tavalla.

Mukautetut työrivit eivät edellytä eivätkä tue muita tietoja saapuvassa tapahtumassa.

Lyhyiden poimintojen tapahtumat (ShortPick)

Lyhyiden poimintojen tapahtumat edellyttävät, että saapuvat tietokentät sisältävät seuraavat tiedot:

• tieto02 – Työtietueen tunnus (RecId-arvo).
• tieto03 – Sen rekisterikilven tunnus, josta poiminta suoritetaan.
• tieto04 – Poimittava määrä.
• data05 – Lyhyen poiminnan poikkeuskoodi, joka liittyy Työpoikkeus-tietueeseen, jonka Poikkeustyyppi-arvona on Lyhyt poiminta.
• tieto06 – Työotsikon kohteen rekisterikilven tunnus. Tämän tunnuksen voi jättää tyhjäksi, kun se on määritetty automaattisesti luotavaksi.

Huomautus

tieto01-kenttää ei käytetä lyhyiden poimintatapahtumien osalta.

Tämä tapahtuma muistuttaa työnvahvistustapahtumaa, mutta se koskee vain poimintarivejä.

Ohitustapahtumat (Override)

Ohitustapahtumat edellyttävät, että saapuvat tietokentät sisältävät seuraavat tiedot:

• tieto01 – Työtietueen tunnus (RecId-arvo).
• tieto02 – Uusi sijaintitunnus.

Työrivin tilana on oltava joko Avoin tai Käynnissä ja uuden sijainnin on oltava olemassa.

Rekisterikilpien vastaanottotapahtumat (LPReceipt)

Rekisterikilpien vastaanottotapahtumat edellyttävät, että saapuvat tietokentät sisältävät seuraavat tiedot:

• tieto01 – Vastaanottavan saapuvan rekisterikilven tunnus.

Järjestelmä suorittaa rekisterikilven noutotoiminnon sen rekiserikilven perusteella, jota käytetään tieto01-kentän arvona.

Saapuvien jonon seuranta

Voit tarkistaa saapuvien jonon valitsemalla Materiaalin käsittelylaitteiden rajapinta > Yhteiset > Saapuvien jono. Saapuvien jono -sivulla on luettelo kaikista saapuvien jonon kohteista ja niiden tiloista. Voit tarkastella jonokohteen tietoja valitsemalla sen. Näitä tietoja ovat esimerkiksi kohteen tapahtumatyyppi, sanoman tunnus sekä kunkin tietokentän (tieto01–tieto10) arvo.

Jos saapuvien tapahtumien käsittelyssä ilmenee virhe tai esiintyy muunlainen lokikohde, voit tarkastaa lokin valitsemalla toimintoruudusta Virheloki.

Saapuvien tapahtumien käsittely

Saapuvat tapahtumat kirjoitetaan ensin tietokantaan ja suoritetaan sitten välittömästi (synkronisesti). Jos käsittelyn aikana tapahtuu virhe, tapahtuma kirjoitetaan tästä huolimatta jonoon, mutta tilaksi määritetään Aiheutti virheen. MHAX-palvelu palauttaa virhesanoman MH-järjestelmään ja tallentaa virhelokin saapuvien tapahtumien tietueeseen myöhempää tutkimista varten.

Tapahtumat, joiden tila Aiheutti virheen, voidaan käsitellä myöhemmin uudelleen, jos virhe on korjattu. Ne käsitellään uudelleen seuraavasti:

• Valitse Materiaalin käsittelylaitteiden rajapinta > Yhteiset > Saapuvien jono. Valitse asianomainen saapuvien jono ja valitse sitten toimintoruudusta Käsittele uudelleen.
• Valitse Materiaalin käsittelylaitteiden rajapinta > Yhteiset > Käsittele virheen aiheuttanut saapuvien jono uudelleen. näyttöön tulee vakioerätyön valintaikkuna. Siinä voit määrittää tietuesuodattimen sekä ajoittaa tai suorittaa erätyön jonon uudelleenkäsittelyä varten.

Kaikki työvaiheet (poiminnat ja asetukset) suoritetaan käyttäen sitä työntekijää, joka on valittu Materiaalin käsittelylaitteiden rajapinnan parametrit -sivun Käyttäjätunnus-kentässä.

Saapuvien jonon tyhjentäminen

Ennen pitkää saapuvien jono täyttyy jonokohteista, jotka on jo käsitelty. Voit poistaa nämä kohteet valitsemalla Materiaalin käsittelylaitteiden rajapinta > Säännölliset tehtävät > Tyhjennys > Saapuvien jonon tyhjennys.

Nopean yleiskuvan saaminen jononhallinnan avulla

Kun haluat nopean yleiskuvan kaikista saapuviin ja lähtevien jonoihin liittyvistä toimista, valitse Materiaalin käsittelylaitteiden rajapinta > Työtilat > Jononhallinta. Jononhallinta-sivulla on joukon välilehtiä ja ruutuja, joita voit käyttää jonojen valvomiseen ja tutkimiseen. Se sisältää myös hyödyllisiä linkkejä useimmille muille tässä artikkelissa mainituille sivuille.

Yhteyden muodostaminen MHAX-palveluun

MHAX toteutetaan mukautettuna palveluna. Siksi se on käytettävissä SOAP- ja REST-kutsujen avulla. SOAP- ja REST-päätepisteiden osoitteet:

• SOAP:https://base_environment_URL/soap/services/WMHEServices
• REST:https://base_environment_URL/api/services/WMHEServices/WMHEService

Sanomien noutaminen lähtevien jonosta

Sanomia voi noutaa lähtevien jonosta seuraavilla tavoilla:

• Nouda tapahtumia tilauksen tunnuksen perusteella käyttämällä komentoa readOutboundSubscriptionQueue.
• Nouda tapahtumia tapahtumatyypin ja varastotunnuksen perusteella useista tilauksista käyttämällä komentoa readOutboundWarehouseQueue.