9bc5486d0d
Created by Github action --------- Co-authored-by: github-actions <github-actions@twenty.com>
321 lines
11 KiB
Plaintext
321 lines
11 KiB
Plaintext
---
|
|
title: Työnkulun ominaisuudet
|
|
info: Kaikki saatavilla olevat työnkulun laukaisimet, toiminnot ja hallintaominaisuudet.
|
|
image: /images/user-guide/workflows/robot.png
|
|
sectionInfo: Automatisoi prosessit ja integroi ulkoisten työkalujen kanssa
|
|
---
|
|
|
|
<Frame>
|
|
<img src="/images/user-guide/workflows/robot.png" alt="Header" />
|
|
</Frame>
|
|
|
|
## Työnkulun laukaisimet
|
|
|
|
Työnkulut alkavat aina yhdellä laukaisimella, joka määrittelee, milloin automaatio tulee suorittaa.
|
|
|
|
### Record is Created
|
|
|
|
Starts the workflow when a new record is created in a selected object (People, Companies, Opportunities, or any custom object).
|
|
|
|
**Määritys**: Valitse objektityyppi, jota valvotaan uusien tietueiden varalta.
|
|
|
|
### Tietue päivitetään
|
|
|
|
Aloittaa työnkulun, kun olemassa olevaan tietueeseen tehdään muutoksia.
|
|
|
|
**Määritys**:
|
|
|
|
- Valitse objektityyppi
|
|
- Voit halutessasi määrittää, mitä kenttiä muutoksille seurataan
|
|
|
|
### Tietue päivitetään tai luodaan
|
|
|
|
Aloittaa työnkulun, kun tietue luodaan tai päivitetään valitussa objektissa.
|
|
|
|
**Miksi tämä on tärkeää**: Tämä laukaisin on erityisen hyödyllinen, koska eri menetelmillä luodut tietueet käyttäytyvät eri tavoin:
|
|
|
|
- **API/CSV-tuonnit**: Tietueet luodaan siten, että kaikki kentät on täytetty välittömästi
|
|
- **Manuaalinen luominen**: Tietueet luodaan ensin, ja sitten kenttiä lisätään myöhemmissä päivityksissä
|
|
|
|
**Määritys**:
|
|
|
|
- Valitse objektityyppi, jota valvotaan
|
|
- Voit halutessasi määrittää, mitä kenttiä muutoksille seurataan
|
|
- Työnkulku aloitetaan sekä alkuperäisessä luomisessa että myöhemmissä päivityksissä
|
|
|
|
### Tietue poistetaan
|
|
|
|
Aloittaa työnkulun, kun tietue poistetaan objektista.
|
|
|
|
**Määritys**: Valitse objektityyppi, jota valvotaan poistojen varalta.
|
|
|
|
### Käynnistä manuaalisesti
|
|
|
|
Aloittaa työnkulun, kun käyttäjän toimenpide sitä käynnistää. Tähän laukaisimeen pääsee Cmd+K-valikon kautta tai mukautetun painikkeen avulla navigointipalkissa.
|
|
|
|
**Saatavuuden määritys**:
|
|
Valitse, miten työnkulku käsittelee tietuevalinnan:
|
|
|
|
- **Global**: No record is required to trigger this workflow. Työnkulku käynnistetään mistä tahansa (mistä tahansa objektista) eikä se käytä tietuetta syötteenä.
|
|
|
|
- **Yksittäinen**: Valitut tietueet välitetään työnkulkuun. Tämä on määritetty tietylle objektille. Useita tietueita voidaan valita ennen työnkulun käynnistämistä. Työnkulku suoritetaan niin monta kertaa kuin on valittuja tietueita.
|
|
|
|
<Warning>
|
|
You cannot run more than 100 workflows in parallel at any given time.
|
|
</Warning>
|
|
|
|
- **Joukkokäsittely**: Valitut tietue(t) toimitetaan työnkulkuusi. Tämä on määritetty tietylle objektille. Useita tietueita voidaan valita ennen työnkulun käynnistämistä. Työnkulku suoritetaan kerran ja koko tietuelista annetaan syötteenä. This means the workflow needs to contain an Iterator action. Tämä on parasta niille, jotka haluavat optimoida/rajoittaa työnkulun suoritusmäärää.
|
|
|
|
**Lisäasetukset**:
|
|
|
|
- Valitse kohdeobjekti (yksittäiselle ja joukkokäsittelylle)
|
|
- Valitse työnkulun käynnistyskomennon kuvake
|
|
- Määritä navigointipalkin sijoittaminen (kiinnitetty tai ei kiinnitetty)
|
|
|
|
**Käyttömenetelmät**:
|
|
|
|
- Cmd+K-valikko manuaalisten työnkulkujen löytämiseksi ja käynnistämiseksi
|
|
- Muokattu painike ylävalikkorivillä (jos konfiguroitu)
|
|
|
|
### Aikataulu
|
|
|
|
Käynnistää työnkulun toistetulla tavalla, jonka määrittelet.
|
|
|
|
**Määritys**:
|
|
|
|
- Valitse aikayksikkö (minuutit, tunnit, päivät)
|
|
- Syötä arvo tai käytä mukautettuja cron-lausekkeita edistyneeseen ajoitukseen
|
|
|
|
### Webhook
|
|
|
|
Käynnistää työnkulun, kun ulkoisesta palvelusta vastaanotetaan GET- tai POST-pyyntö.
|
|
|
|
**Määritys**:
|
|
|
|
- Vastaanota ainutlaatuinen webhook-URL
|
|
- POST-pyyntöjen osalta määritä odotettu runkorakenne
|
|
- Konfiguroi todennus tarvittaessa
|
|
|
|
## Työnkulun toiminnot
|
|
|
|
Toiminnot määrittelevät, mitä tapahtuu, kun käynnistin laukeaa. Voit ketjuttaa useita toimintoja yhteen.
|
|
|
|
### Luo tietue
|
|
|
|
Lisää uuden tietueen valittuun objektiin.
|
|
|
|
**Määritys**:
|
|
|
|
- Valitse kohdeobjekti
|
|
- Täytä vaaditut ja vapaaehtoiset kentät
|
|
- Käytä edellisten vaiheiden tietoja kenttien täyttämiseen
|
|
|
|
**Output**: The newly created record data is available for use in subsequent steps.
|
|
|
|
### Päivitä tietue
|
|
|
|
Muokkaa olemassa olevaa tietuetta valitussa objektissa.
|
|
|
|
**Määritys**:
|
|
|
|
- Valitse kohdeobjekti
|
|
- Valitse erityinen tietue, jota muokataan
|
|
- Valitse muokattavat kentät ja syötä uudet arvot
|
|
|
|
**Output**: The updated record data is available for use in subsequent steps.
|
|
|
|
### Poista tietue
|
|
|
|
Poistaa tietueen valitusta objektista.
|
|
|
|
**Määritys**:
|
|
|
|
- Valitse kohdeobjekti
|
|
- Valitse poistettava tietue
|
|
|
|
**Output**: The deleted record data remains available for use in subsequent steps.
|
|
|
|
### Etsi tietueita
|
|
|
|
Löytää tietueita valitussa objektissa käyttämällä suodatinolosuhteita.
|
|
|
|
**Määritys**:
|
|
|
|
- Valitse haettava objekti
|
|
- Set filter criteria to narrow results
|
|
- Määritä lajittelu ja rajat
|
|
|
|
**Tuotos**: Palauttaa vastaavat tietueet, joita voidaan käyttää myöhemmissä vaiheissa.
|
|
|
|
**Paras käytäntö**: Käytä haaroja Etsiessä tietueita, jotta voit käsitellä "löydetty" tai "ei löydetty" skenaarioita.
|
|
|
|
### Iteraattori
|
|
|
|
Käy läpi edellisen vaiheen palauttaman tietueen taulukon ja suorita toiminnot jokaiselle tietueelle erikseen.
|
|
|
|
**Määritys**:
|
|
|
|
- Valitse edellisen vaiheen rekisterin taulukko (esim. Etsi tietueita -tulokset)
|
|
- Määritä toiminnot, jotka suoritetaan jokaiselle tietueelle silmukassa.
|
|
- Konfiguroi muuttujan nimi jokaisen iteraatiossa olevan tietueen viittaamiseen
|
|
|
|
**Example**: Search Records returns 5 people, then use Iterator to send an email to each person or update each record individually.
|
|
|
|
**Huomautus**: Iteraattori on tällä hetkellä beetaversiossa. Aktivoi se kohdassa Asetukset > Julkaisut > Lab.
|
|
|
|
### Suodata
|
|
|
|
Suodattaa tietueiden taulukon määritettyjen ehtojen perusteella, jolloin vain ehdot täyttävät tietueet pääsevät läpi.
|
|
|
|
**Määritys**:
|
|
|
|
- Valitse suodatettavat tietueet
|
|
- Määritä suodatin ehdot ja kriteerit
|
|
- Määritä, mitkä tietueet pääsevät jatkamaan seuraaviin vaiheisiin
|
|
|
|
**Tuotos**: Palauttaa vain tietueet, jotka täyttävät määritellyt suodatus ehdot.
|
|
|
|
### Lähetä sähköposti
|
|
|
|
Lähettää sähköpostin osana työnkulkua.
|
|
|
|
**Edellytykset**: Lisää sähköpostitili kohtaan Asetukset > Tilit
|
|
|
|
**Määritys**:
|
|
|
|
- Anna vastaanottajan sähköpostiosoite
|
|
- Aseta aiherivi
|
|
- Kirjoita viestin teksti
|
|
- Viittaa edellisten vaiheiden muuttujiin personointia varten
|
|
|
|
**Huomautus**: Sähköpostiliitteet saatavilla Q1 2026.
|
|
|
|
### Koodi
|
|
|
|
Suorittaa mukautettua JavaScriptia työnkulussa.
|
|
|
|
**Määritys**:
|
|
|
|
- Kirjoita JavaScript-koodi editoriin
|
|
- Käytä edellisten vaiheiden muuttujia
|
|
- Palauta muuttujat käytettäväksi seuraavissa vaiheissa
|
|
- Testaa koodi suoraan vaiheessa
|
|
|
|
**Pääsy**: Hallinnoi API-avaimia kohdassa Asetukset → API & Webhooks
|
|
|
|
### Lomake
|
|
|
|
Näyttää lomakkeen työnkulun aikana käyttäjän syötteen keräämistä varten.
|
|
|
|
**Määritys**:
|
|
|
|
- Määritä syötekentät tyypeillä, tarroilla ja paikkamerkeillä
|
|
- Määritä vahvistussäännöt
|
|
- Aseta lomakkeen otsikko ja kuvaus
|
|
|
|
**Tuotos**: Lomakevastaukset ovat käytettävissä myöhemmissä vaiheissa.
|
|
|
|
<Warning>
|
|
Lomakkeet on tällä hetkellä suunniteltu vain manuaalisille käynnistimille. For workflows with other triggers (Record Created, Updated, etc.), forms are only accessible via the workflow run interface, which is not the expected user experience. Ilmoituskeskus julkaistaan vuonna 2026 tukemaan lomakkeita asianmukaisesti automatisoiduissa työnkuluissa.
|
|
</Warning>
|
|
|
|
### HTTP Pyyntö
|
|
|
|
Lähettää pyynnön ulkoiseen APIin osana työnkulkua.
|
|
|
|
**Määritys**:
|
|
|
|
- Syötä API-päätepisteen URL
|
|
- Valitse HTTP-menetelmä (GET, POST, PUT, PATCH, DELETE)
|
|
- Lisää tarvittavat otsikot ja arvot
|
|
- Sisällytä pyyntörunko POST/PUT/PATCH-pyynnöille
|
|
- Tarjoa esimerkki vastausrakenteen esikatselua varten
|
|
|
|
## Työnkulun hallinta
|
|
|
|
### Työnkulkujen luominen
|
|
|
|
1. Napsauta "+ Lisää työnkulku" aloittaaksesi
|
|
2. Click "Untitled" to name your workflow
|
|
3. Valitse ja konfiguroi työnkulun käynnistin
|
|
4. Lisää toimintoja työnkulkuun
|
|
5. Testaa ja iteroi
|
|
6. Aktivoi työnkulku (tällä hetkellä luonnostilassa), kun olet valmis muokkaamaan sitä.
|
|
|
|
**Note**: If you don't see the Workflows section, this is due to a permissions issue. Ota yhteyttä työympäristön ylläpitäjään saadaksesi pääsyn työnkulkuihin.
|
|
|
|
### Työnkulun tilat
|
|
|
|
- **Luonnos**: Muokataan, ei vielä julkaistu
|
|
- **Active**: Live version responding to triggers
|
|
- **Poistettu käytöstä**: Aiemmin aktiivinen, mutta lopetettu manuaalisesti
|
|
- **Arkistoitu**: Menneet versiot säilytetään historiaa varten
|
|
|
|
### Työnkulkujen aktivointi
|
|
|
|
Napsauta **Aktivoi** julkaistaksesi luonnoksen uutena versiona. Tämä tekee työnkulun valmiiksi käynnistyksiä varten, mutta ei suorita sitä heti.
|
|
|
|
### Työnkulkujen testaaminen
|
|
|
|
Testaa työnkulkuja ennen aktivointia käyttäen:
|
|
|
|
- Manuaaliset käynnistimet (kun tietuetta ei ole valittu)
|
|
- Yksittäisten toimintojen testaus (etenkin kooditoiminnot)
|
|
- Luonnostilojen testaus, joka ei aktivoi työnkulkua
|
|
|
|
### Työnkulkujen suoritukset
|
|
|
|
**Suoritus** on tieto työnkulun suorituksesta, joka sisältää:
|
|
|
|
- Tila (onnistui, epäonnistui, käynnissä)
|
|
- Tulosaineisto jokaisesta vaiheesta
|
|
- Tekijä- ja aikaleimat
|
|
- Virheilmoitukset, jos sovellettavissa
|
|
|
|
**Suoritusten katselu**:
|
|
|
|
- Tarkista **Suoritukset**-paneeli työnkulkueditorissa
|
|
- Avaa **Työnkulun suoritukset** näkymä seurattavaksi kaikissa työnkuluissa
|
|
|
|
**Suorituskykyvinkki**: Piilota työnkulun suoritukset "Kaikki työnkulut"-sivulta ja muilta työnkulkujen sivuilta latausnopeuden parantamiseksi, koska suuret määrät suorituksia voivat hidastaa sivulatauksia.
|
|
|
|
### Version historia
|
|
|
|
- View all versions under the **Versions** field
|
|
- Napsauta mitä tahansa versiota nähdäksesi yksityiskohdat
|
|
- Käytä **Käytä luonnoksena** palauttaaksesi aiemmat versiot
|
|
- Hallitse luonnoskonflikteja ylikirjoitus- tai palautusvaihtoehdoilla
|
|
|
|
## Parhaat käytännöt
|
|
|
|
### Työnkulun organisointi
|
|
|
|
- **Kuvaavat nimet**: Käytä selkeitä, tarkkoja työnkulun nimiä
|
|
- **Vaiheiden nimeäminen**: Nimeä vaiheet niiden toiminnan kuvauksella
|
|
- **Dokumentaatio**: Lisää kommentteja kooditoiminnoissa
|
|
- **Luokittelu**: Ryhmittele sukuisia työnkulkuja loogisesti
|
|
- **Mukautetut kentät**: Lisää kenttiä työnkulkuobjektiin tietomallissa (samanlainen kuin muut objektit) järjestääksesi ja kategorisoidaksesi työnkulut mukautetulla ominaisuuksilla
|
|
|
|
### Suorituskyvyn optimointi
|
|
|
|
- **Minimoi API-kutsut**: Erätoiminnot, kun mahdollista
|
|
- **Tehokkaat haut**: Käytä tarkkoja suodatusehtoja
|
|
- **Virheiden käsittely**: Suunnittele vikatilanteita varten
|
|
- **Rajataajuus**: Kunnioita ulkoisen API:n rajoituksia
|
|
|
|
### Datavirtahallinta
|
|
|
|
- **Branch Logic**: Use branches after Search Records
|
|
- **Muuttujien käyttö**: Hyödynnä edellisten vaiheiden tietoja
|
|
- **Datan validointi**: Vahvista syötteet kooditoiminnoissa
|
|
- **Kenttäkartoitus**: Suunnittele tiedon muunnokset huolellisesti
|
|
|
|
### Monitorointi ja ylläpito
|
|
|
|
- **Säännöllinen monitorointi**: Tarkista työnkulun suoritukset virheiden varalta
|
|
- **Suorituskyvyn tarkastelu**: Analysoi suoritusaikoja ja onnistumisprosentteja
|
|
- **Päivitysten hallinta**: Testaa muutoksia luonnoksena ennen aktivointia
|
|
- **Tiimikoordinointi**: Dokumentoi työnkulut tiimin jäsenille
|
|
|
|
For practical examples of these features in action, see our [Internal Automations](/l/fi/user-guide/workflows/internal-automations) and [External Tool Integration](/l/fi/user-guide/workflows/external-tool-integration) guides.
|