Power Automate: tarjouspyynnöt Hilmasta

Power Platform on Microsoftin liiketoimintasovellusten kehitysalusta. Power Automatea voidaan käyttää erilaisten rutiinien automatisointiin varsin helppokäyttöisellä tavalla.

Tällaisten kehitysvälineiden hyöty tulee siitä, että eri liiketoimintayksiköt ymmärtävät liiketoimintansa ja tietävät että aina on olemassa erilaisia prosesseja, jotka voitaisiin automatisoida mutta joiden kehitys perinteisillä välineillä olisi liian kallista.

Power Automate on selainpohjainen kehitysväline erilaisten työkulkujen rakentamiseen, tässä esimerkissä laitetaan ajastettu työkulku lähettämään uudet ilmoitukset tietyn Microsoft Teams tiimin kanavaan. Lisää tietoa Power Automatesta löytyy tästä.

Hilman rajapinta

Hilma on julkisten hankintojen portaali, jota ylläpitävät Työ – ja elinkeinoministeriö sekä Hansel Oy.

Hilma tarjoaa myös rajapintapalvelun, johon rekisteröitymällä saa käyttöönsä API – avaimen. Ohjeistus löytyy kirjautuneelle käyttäjälle kehittäjäportaalin sisältä. En käsittele sitä tässä kirjoituksessa sen enempää.

HTTP connector

Työkulkuun keskeisesti kuuluvaan http connectoriin tarvitaan seuraavat asiat:

-url

-menetelmä

-API – avain

Lisäksi tarvitaan hakuun liittyvä määritys JSON – muodossa, alla on esimerkki näistä kuvan muodossa.

Header eli otsikko-osioon tarvitaan kuvassa oleva määritys sekä API - avain. Request body eli leipäteksti – osio on itseasiassa Azure Cognitive Searchin mukainen määritys hakuehdoille.

Tässä tapauksessa etsitään CPV – koodin perusteella huonekaluja tietynlaisista ilmoituksista. Määrityksen mukaan vasteena pitäisi tulla maksimissaan 15 kappaletta parhaiten hakuehtoihin mätsäävää tarjouspyyntöä.

{

  "search": "cpvCodes:39100000",

  "filter": "expirationDate ne null and isLatest eq true and (type ne 300 and type ne 600) and isCorrigendum eq false",

  "top": "15",

  "count": "true",

  "searchMode": "any",

  "orderby": "datePublished desc"

}

JSON - käsittely

Rajapinta tuottaa JSON – muodossa olevan vasteen, JSON:sta taas saadaan datat jatkokäyttöön Parse JSON – operaatiolla.

JSON – skeeman saa Hilman portaalista, jossa erilaisia kutsuja voi testata.

Muutamiin kohtiin on syytä määritellä Hilman näytteestä poiketen, että null – arvot sallitaan. Lisäksi kentän voisi myös poistaa required osiosta.

"type": ["null","string"]

Viestin kirjoitus Teams - kanavaan

Tässä esimerkissä tarjouspyynnöt kirjoitetaan Microsoft Teamsin tiimin kanavalle, tiimin määritykset on helppo asettaa Teams connectorin osiossa.

For Each – tyyppistä operaatiota tarvitaan, koska Hilman rajapinnan palauttamassa datassa on useiden ilmoitusten tiedot ja haluamme kirjoittaa jokaisen erillisenä viestinä.