Skenaarion rakentaminen

Editori

Kanvaasi keskellä, lisäyspaletti ja tarkastelupaneeli sen ympärillä. Lohkoja siirretään hiirellä, ja näkymää voi siirtää ja zoomata.

Lohkon lisääminen

Paletista, joka on jäsennelty kategorioittain: ohjaus, koostaminen (pyynnöt ja yhteydet), luettelot, silmukat, aika, matematiikka, algoritmiikka, tietomuodot, koodaus, käyttöliittymä ja apuvälineet.

Pyyntöön sidottu toiminto (HTTP-pyyntö, SOAP-pyyntö, kaikki yhteystoiminnot) pyytää osoittamaan projektin pyynnön, jota se ohjaa.

Skenaarion ja pyynnön välinen side

Pyynnön osoittaminen toiminnossa luo vahvan siteen: toiminto viittaa pyyntöön sen tunnisteella, ei kopiolla. Tästä seuraa:

• pyyntö pysyy jaettuna — sen muokkaaminen (URL, otsakkeet, sisältö) muuttaa sitä, mitä kaikki sitä käyttävät skenaariot suorittavat seuraavalla ajokerralla;
• side kestää pyynnön uudelleennimeämisen tai siirtämisen puussa: se ei perustu nimeen eikä polkuun;
• pyynnöstä käsin smartbar tarjoaa painikkeen ”Käytetään skenaarioissa” — se luettelee skenaariot, jotka kutsuvat pyyntöä, ja mahdollistaa niihin hyppäämisen. Tämä on refleksi, joka kannattaa omaksua ennen jaetun pyynnön muokkaamista;
• puuttuva pyyntö (poistettu tai puuttuu projektia avattaessa) kaataa skenaarion validoinnin: toistopainike pysyy lukittuna ja virheellinen lohko merkitään — koskaan ei jää hiljaisesti rikkinäistä skenaariota.

Jos haluat toistaa saman pyynnön koskematta sen tallennettuun versioon, älä muokkaa sitä: käytä ohituksia (pika-asetus, toiminnon ohitukset, kytkentä), jotka on kuvattu kohdassa Pyynnön ohittaminen.

Lohkon määrittäminen

Jokaisella lohkolla on omat kenttänsä, jotka täytetään suoraan lohkolla tai tarkastelupaneelissa. Kentät hyväksyvät tyypitettyjä arvoja — merkkijono, numero, totuusarvo, päivämäärä, Handlebars-lauseke, muuttuja, mukautettu luettelo, salaisuus… — katso Muuttujat ja ympäristöt.

Ctrl+Space käynnistää muuttujien ja helperien automaattitäydennyksen niissä kentissä, jotka sen hyväksyvät.

Kytkeminen

Vedä lähtöportista tuloporttiin.

Kaksi sääntöä on hyvä tuntea:

1. Tuloportti hyväksyy vain yhden kytkennän — paitsi portti in, joka hyväksyy niitä niin monta kuin halutaan ja toimii tällöin esteenä.
2. Puhtaan signaalin lähtö ei voi syöttää puhtaan arvon tuloa. Kaikki muu on sallittua: lähtö, joka kantaa arvon, toimii myös laukaisimena.

Yksityiskohdat: Portit ja kytkennät.

Kytkennän valitsin

Kytkentä voi kantaa valitsinta: polkua, joka sovelletaan matkalla olevaan arvoon.

data.items[0].id
body['user-id']
status

Juuri tämä säästää muunnoslohkon sijoittamiselta jokaisen kutsun ja sen kuluttajan väliin. Valitsin asetetaan kytkennän luonnin yhteydessä tai myöhemmin; sen tyhjentäminen poistaa sen.

Pyynnön ohittaminen

Pyyntöön sidottu toiminto voi muokata sitä koskematta itse pyyntöön. Neljä kerrosta, tässä järjestyksessä:

1. pyyntö sellaisena kuin se on tallennettu;
2. toiminnolle osoitettu pika-asetus (quick config) — näin tallennettu pyynnön variantti käytetään uudelleen suoraan skenaariossa ilman uudelleensyöttöä;
3. toiminnolle syötetyt ohitukset;
4. ohitusporttiin kytkennän kautta saapuva arvo.

Tämä on siisti tapa toistaa sama kutsu kolmella eri aineistolla.

Suoritus jokaisella tapahtumalla

Lohkon kontekstivalikossa on valinta ”Suorita jokaisella vastaanotetulla tapahtumalla”. Käytössä ollessaan se muuttaa kaikki kytketyt tulot estottomiksi ”tai”-porteiksi: lohko laukeaa uudelleen jokaisesta missä tahansa portissa vastaanotetusta arvosta sen sijaan, että odottaisi kaikkien saapumista.

Tämä on välttämätöntä virran käsittelyssä (jokainen MQTT-viesti, jokainen SSE-tapahtuma), ja se myös avaa valmistumissyklin.

Parametrit ja tulosteet

• Lohko Input / Param määrittelee skenaarion parametrit. Ne annetaan käynnistyksessä, komentoriviltä (--param nom=valeur) tai kysytään suorituksen aikana vuorovaikutteisessa tilassa.
• Lohko Output / Return tuo tuloksen kutsujan saataville — hyödyllistä, kun toinen skenaario kutsuu tätä toiminnolla Suorita skenaario.

Järjestäminen

Restorm osaa järjestää graafin automaattisesti (asettelu); lohkoja voi siirtää jälkeenpäin käsin. Ctrl+Z kumoaa, Ctrl+Shift+Z tekee uudelleen.

Validointi

Toistopainike on lukittuna niin kauan kuin validointivirheitä on jäljellä: virheellinen kytkentä, puuttuva pyyntö, tyhjä pakollinen kenttä. Virheelliset lohkot merkitään.