Power Automate eta Zapier

1. Zer behar duzu

Enpresaren API gako bat. «Administrazioa» → “Sistema” → “API gakoak” atalean, sakatu “Sortu gako bat” “Power Automate” bezalako izen batekin eta, “Baliabide bakoitzeko baimenak (API publikoa)” atalean, markatu fluxuek behar dutena: gertakarien gertaerak jasotzeko, “Gertakariak” irakurri; langileak sortzeko, “Langileak” idatzi. Abiarazle batek gakoak irakur ditzakeen gertaerak bakarrik eskaintzen ditu, eta aptitudu medikoarenek beren baimena behar dute. Sortu gako bat tresna bakoitzeko: horrela, bat baliogabetzeak ez ditu besteak geldiarazten.

Power Automaterako goPrevinaren konektorea eta Zapier aplikazioa denda bakoitzean argitaratzeko zain daude. Bitartean, eskatu goPrevinaren laguntza-zerbitzuari Power Automateko konektorearen fitxategia edo Zapier aplikazio pribatura gonbidapen bat. Make aplikazioa abian jarri ondoren helduko da.

2. Power Automate

1. Power Automaten, “Konektore pertsonalizatuak” → “Konektore pertsonalizatu berria” → “Inportatu OpenAPI fitxategi bat”, aukeratu goPrevinaren fitxategia eta sortu konektorea (argitaratuta dagoenean, bilatu “goPrevina” horren ordez).

2. Lehen aldiz erabiltzen duzunean, itsatsi API gakoa.

3. Abiarazleak: “When an incident is recorded”, “When a training certificate is about to expire”, “When a worker is added” eta beste batzuk, baita “When an event occurs” ere, zeinean zerrendako edozein gertaera aukeratzen duzun.

4. Ekintzak: langileak, zentroak eta prebentzio-neurriak sortu eta eguneratu, gertakariak erregistratu, ikastaroak esleitu eta zerrenda guztiak irakurri (gertakariak, neurriak, ebaluazioak, ziurtagiriak, dokumentuak, kontratistak).

Konektorearen izenak ingelesez daude. goPrevinaren abiarazle bat duen fluxu bat gordetzean, Power Automate gertaerara harpidetzen da; fluxua itzaltzean edo ezabatzean, harpidetza kentzen du.

3. Zapier

Zapierren, gehitu goPrevina aplikazioa eta konektatu API gakoarekin; utzi “API Address” dagoen bezala, zure enpresak goPrevinaren instalazio propioa ez badu behintzat. “New Incident” edo “Training Certificate Expiring” bezalako abiarazleak Zap-a piztean harpidetzen dira eta itzaltzean baja ematen dute.

4. Adibidea: gertakaria → Teams eta SharePoint zerrenda bat

1. Sortu SharePointen “Gertakariak” zerrenda bat zutabe hauekin: Izenburua, Larritasuna, Data eta goPrevinako Id-a.

2. Power Automaten, sortu fluxu automatizatu bat “When an incident is recorded” abiarazlearekin.

3. Gehitu “Argitaratu mezua txat edo kanal batean” (Microsoft Teams), aukeratu prebentzio-kanala eta idatzi mezua eduki dinamikoarekin: izenburua, larritasuna eta data.

4. Gehitu “Sortu elementua” (SharePoint) “Gertakariak” zerrendan eta esleitu Izenburua, Larritasuna, Data eta Id-a.

5. Gorde, erregistratu proba-gertakari bat goPrevinan eta egiaztatu mezua eta errenkada minutu bat baino lehen agertzen direla.

5. Adibidea: alta Excelen → langilea

1. Eraman altak OneDriveko edo SharePointeko Excel taula batean zutabe hauekin: Izena, Emaila, Lanpostua eta Alta-data.

2. Zapierren, erabili Microsoft Excelen “New Row” abiarazlea taula horren gainean.

3. Gehitu goPrevinaren “Create Worker” ekintza eta esleitu Full Name, Email, Position eta Hire Date.

4. “Idempotency Key” eremuan, esleitu errenkadaren id-a: Zap-a errenkada berarekin berriro exekutatzen bada, goPrevinak lehendik sortu zuen langilea itzultzen du beste bat gehitu beharrean.

Gakoak “Langileak” idatzi behar du.

6. Adibidea: iraungitzear dagoen ziurtagiria → Outlooko zeregina

1. Power Automaten, erabili “When a training certificate is about to expire” abiarazlea. goPrevinak iraungitze-data baino 30 egun lehenago bidaltzen du.

2. Gehitu “Get a worker” gertaerako langilearen id-arekin (employeeId), izena izateko.

3. Gehitu Microsoft To Doren “Gehitu egiteko bat”, zeinaren zereginak Outlookek erakusten dituen, “Berritu ziurtagiria” izenburuarekin eta ondoren ziurtagiriaren zenbakia eta langilearen izena, eta muga-data gisa gertaerako iraungitze-data (expiresAt).

Gakoak “Prestakuntza” irakurri eta “Langileak” irakurri behar ditu.

7. Non dauden harpidetzak eta nola gelditu

Erabiltzen ari den abiarazle bakoitza “Webhook-ak” atalean agertzen da tresnaren izenarekin eta bidalketen historiarekin. Fluxua, Zap-a edo eszenatokia itzaltzeak bere harpidetza kentzen du. API gakoa baliogabetzeak harekin egindako harpidetza guztiak kentzen ditu eta bidalketak berehala gelditzen ditu. goPrevinak gertaera bakoitza X-Goprevina-Signature goiburuarekin eta harpidetzean itzulitako sekretuarekin sinatzen du; sistema propio batek egiazta dezake webhooken gidak azaltzen duen bezala.