Sanomaruutujen toiminnot
Sanomaruutuja voidaan käyttää työpöytätyönkuluissa viestinnässä käyttäjien kanssa, pyynnön syötteessä ja tuloksen antamisessa.
Jos haluat näyttää käyttäjälle sanoman työnkulun suorittamisen aikana, käytä Näytä sanoma -toimintoa. Määritä viestiruudun otsikko, sisältö, kuvake ja näytettävän ruudun painikkeet. Lisäksi voit asettaa oletuspainikkeen esivalinnaksi sekä ilmoittamaan, pitäisikö viestilaatikon olla aina koneen kaikkien muiden ikkunoiden päällä ja sulkeutuuko viestilaatikko automaattisesti tietyn ajan kuluttua.
Tässä esimerkissä näkyy sanomaruutu, joka ilmoittaa käyttäjälle jäsennyksen olevan valmis ja kysyy, jäsennetäänkö toinen tiedosto. Sanomaruudussa on kysymyskuvake, ja se on aina muiden ikkunoiden päällä. Käyttäjän valinta tallennetaan ButtonPressed-muuttujaan.
Luodun sanomaruudun pitäisi olla seuraavan esimerkin kaltainen:
Tämän lisäksi voit luoda mukautetun lomakkeen viestin näyttämiseksi työnkulun osana käyttämällä Näytä mukautettu lomake -toimintoa. Mukautettu lomake hyväksyy useita osia, ja voit luoda mukautetun lomakkeen, joka sisältää erilaisia syötetyyppejä ja painikkeita. Lisätietoja: Mukautettujen lomakkeiden luominen.
Syötetietoja voidaan pyytää valintaikkunan avulla ottamalla Näytä syötteen valintaikkuna -toiminto käyttöön. Tämä toiminto edellyttää, että valintaikkunalla on otsikko ja sanoma, joka näytetään kehotteena käyttäjälle. Voit myös määrittää oletusarvon ja syöttötyypin (yksirivinen, monirivinen tai salasana).
Käytä Näytä tiedoston valinnan valintaikkuna -toimintoa pyytämään käyttäjiä etsimään tiedosto selaamalla. Seuraavassa esimerkissä pyydetään valitsemaan kuvatiedosto. Muuttuja määrittää alkuperäisen kansion, ja tiedostosuodatin rajoittaa käytettävissä olevat valinnat tiettyihin tiedostotunnisteisiin.
Luodun tiedostoikkunan pitäisi olla seuraavan esimerkin kaltainen. Määritetty suodatin näkyy valintaikkunan oikeassa alakulmassa.
Näytä sanoma
Näyttää sanomaruudun.
Syöteparametrit
| Argumentti | Valinnainen | Hyväksyy | Oletusarvo | Description |
|---|---|---|---|---|
| Message box title | Kyllä | Tekstin arvo | Teksti, jota käytetään sanomaruudun otsikkona | |
| Message to display | Kyllä | Tekstin arvo | Todellisena sanomana näytettävä teksti | |
| Message box icon | – | Ei mitään, Tiedot, Kysymys, Varoitus, Virhe | Ei ole | Sanomaruudussa näytettävä kuvake |
| Message box buttons | – | OK, OK - Peruuta, Kyllä - Ei, Kyllä - Ei - Peruuta, Keskeytä - Yritä uudelleen - Ohita, Yritä uudelleen - Peruuta | OK | Sanomaruudussa näytettävät painikkeet |
| Default button | – | Ensimmäinen painike, Toinen painike, Kolmas painike | Ensimmäinen painike | Oletusarvoinen korostettava painike. Jos käyttäjä valitsee Enter, tätä painiketta painetaan |
| Pidä sanomaruutu aina päällimmäisenä | – | Totuusarvo | Väärin | Määritä, tuleeko sanomaruudun olla aina muiden ikkunoiden päällä |
| Close message box automatically | – | Totuusarvo | Väärin | Määritä, sulkeutuuko sanomaruutu automaattisesti esiasetettuna aikana, aivan kuin oletuspainiketta olisi painettu. Muussa tapauksessa työnkulku odottaa, kunnes käyttäjä painaa painiketta |
| Timeout | Kyllä | Numeerinen arvo | 3 | Sekunnit, joiden ajaksi automaatio keskeytetään syötteen odottamisen ajaksi. Tämän jälkeen jatketaan automaattisesti |
Tuotetut muuttujat
| Argumentti | Type | Description |
|---|---|---|
| ButtonPressed | Tekstiarvo | Valitun painikkeen teksti |
Poikkeukset
| Poikkeus | Kuvaus |
|---|---|
| Sanomaruudun näyttäminen epäonnistui | Osoittaa, että sanoman valintaikkunan näyttämisessä on ongelma |
| Sanomaruutua ei voi näyttää muussa kuin vuorovaikutteisessa tilassa | Osoittaa, että sanoman valintaikkunan näyttämisessä muussa kuin vuorovaikutteisessa tilassa on ongelma |
Näytä syötteen valintaikkuna
Näyttää dialogin, joka kehottaa käyttäjää syöttämään tekstiä.
Syöteparametrit
| Argumentti | Valinnainen | Hyväksyy | Oletusarvo | Description |
|---|---|---|---|---|
| Input dialog title | Kyllä | Tekstin arvo | Valintaikkunan otsikko | |
| Input dialog message | Kyllä | Tekstin arvo | Valintaikkunan sanoma | |
| Default value | Kyllä | Tekstin arvo | Määritä oletuksena näytettävä teksti. Jos käyttäjä haluaa muuttaa tätä tekstiä, hän voi kirjoittaa sen päälle. Muussa tapauksessa käytetään oletustekstiä | |
| Input type | – | Yksirivinen, Salasana, Monirivinen | Yksi rivi | Syöttötekstin muoto. Valitse Yksi rivi - salasana, jos haluat piilottaa tekstin, tai Useita rivejä, jolloin suuri näyttöruutu mahdollistaa usean tekstirivin näyttämisen |
| Keep input dialog always on top | – | Totuusarvo | Väärin | Määritä, tuleeko syötteen valintaikkunan olla aina muiden ikkunoiden päällä |
Tuotetut muuttujat
| Argumentti | Type | Description |
|---|---|---|
| UserInput | Tekstiarvo | Käyttäjän antama teksti tai oletusteksti |
| ButtonPressed | Tekstin arvo | Valitun painikkeen teksti. Käyttäjälle annetaan automaattisesti vaihtoehdot OK ja Peruuta |
Poikkeukset
| Poikkeus | Kuvaus |
|---|---|
| Syötön valintaikkunan näyttäminen epäonnistui | Osoittaa, että syötön valintaikkunan näyttämisessä on ongelma |
| Syötteen valintaikkunaa ei voi näyttää muussa kuin vuorovaikutteisessa tilassa | Osoittaa, että syötteen valintaikkunan näyttämisessä muussa kuin vuorovaikutteisessa tilassa on ongelma |
Näytä päivämäärän valinnan valintaikkuna
Näyttää dialogin, joka kehottaa käyttäjää syöttämään päivämäärän tai päivämääräalueen.
Syöteparametrit
| Argumentti | Valinnainen | Hyväksyy | Oletusarvo | Description |
|---|---|---|---|---|
| Dialog title | Kyllä | Tekstin arvo | Valintaikkunan otsikko | |
| Dialog message | Kyllä | Tekstin arvo | Valintaikkunan sanoma | |
| Dialog type | – | Yksittäinen päivämäärä, Päivämääräalue (kaksi päivämäärää) | Yksi päivämäärä | Määrittää, antaako käyttäjä yhden päivämäärän vai kaksi päivämäärää päivämääräalueen päätepisteiksi |
| Prompt for | – | Vain päivämäärä, Päivämäärä ja kellonaika | Vain päivämäärä | Määritä, antaako käyttäjä vain päivämäärän vai päivämäärän ja kellonajan |
| Default value | Kyllä | Päivämäärä/aika | Päivämäärän oletusarvo | |
| Default value for second date | Kyllä | Päivämäärä/aika | Alueen loppupäivämäärän oletusarvo | |
| Keep date selection dialog always on top | – | Totuusarvo | Väärin | Määritä, tuleeko päivämäärän valinnan valintaikkunan olla aina muiden ikkunoiden päällä |
Tuotetut muuttujat
| Argumentti | Type | Description |
|---|---|---|
| SelectedDate | Päivämäärä/aika | Käyttäjän antama päivämäärä tai oletuspäivämäärä |
| SecondSelectedDate | Päivämäärä/aika | Käyttäjän antama toinen päivämäärä tai oletuspäivämäärä |
| ButtonPressed | Tekstin arvo | Käyttäjän painaman painikkeen teksti. Käyttäjälle annetaan automaattisesti vaihtoehdot OK ja Peruuta |
Poikkeukset
| Poikkeus | Kuvaus |
|---|---|
| Päivämäärän valinnan valintaikkunan näyttäminen epäonnistui | Osoittaa, että päivämäärän valinnan valintaikkunan näyttämisessä on ongelma |
| Päivämäärän valinnan valintaikkunaa ei voi näyttää muussa kuin vuorovaikutteisessa tilassa | Osoittaa, että syötteen valintaikkunan näyttämisessä muussa kuin vuorovaikutteisessa tilassa on ongelma |
Näytä Valitse luettelosta -valintaikkuna
Näyttää dialogin, jonka vaihtoehtojen avulla käyttäjä voi tehdä valinnan luettelosta.
Syöteparametrit
| Argumentti | Valinnainen | Hyväksyy | Oletusarvo | Description |
|---|---|---|---|---|
| Dialog title | Kyllä | Tekstin arvo | Valintaikkunan otsikko | |
| Dialog message | Kyllä | Tekstin arvo | Valintaikkunan sanoma | |
| List to choose from | Ei | Yleinen arvo | Näytettävä luettelo avattavana valikkona käyttäjän valintaa varten | |
| Keep select dialog always on top | – | Totuusarvo | Väärin | Määritä, tuleeko valinnan valintaikkunan olla aina muiden ikkunoiden päällä |
| Limit to list | – | Totuusarvo | Oikein | Määritä, sallitaanko käyttäjän syöttää oma vastaus näytettävän luettelon ulkopuolelta |
| Allow empty selection | – | Totuusarvo | Väärin | Salli käyttäjän jättää valinta tekemättä, jolloin luodaan tyhjä valitun kohteen tuloste |
| Salli useat valinnat | – | Totuusarvo | Epätosi | Salli käyttäjän valita useita vaihtoehtoja. Valittu kohde ja valitun indeksin muuttujat sisältävät kohdeluettelon |
| Preselect items starting with a + sign | – | Totuusarvo | Väärin | Määritä, näkyvätkö kohteet, joiden alkuun on lisätty +-merkki, automaattisesti esivalittuina |
Tuotetut muuttujat
| Argumentti | Type | Description |
|---|---|---|
| SelectedItem | Tekstiarvo | Luettelosta valittu kohde tekstinä |
| SelectedItems | Tekstiarvojenluettelo | Tekstiluettelosta valitut kohteet |
| SelectedIndex | Numeerinen arvo | Luettelosta valitun kohteen indeksinumero. On mahdollista käyttää kohteen numero valinnon koko tekstin sijaan |
| SelectedIndexes | Numeeristen arvojenluettelo | Luettelosta valittujen kohteiden indeksinumero. Tämän parametrin avulla voidaan käyttää kohteen numeroa valitun koko tekstin sijaan |
| ButtonPressed | Tekstiarvo | Käyttäjän valitseman painikkeen nimi (OK tai Peruuta) |
Poikkeukset
| Poikkeus | Kuvaus |
|---|---|
| Valinnan valintaikkunan näyttäminen epäonnistui | Osoittaa, että valinnan valintaikkunan näyttämisessä on ongelma |
| Valinnan valintaikkunaa ei voi näyttää muussa kuin vuorovaikutteisessa tilassa | Osoittaa, että syötteen valintaikkunan näyttämisessä muussa kuin vuorovaikutteisessa tilassa on ongelma |
Näytä tiedoston valinnan valintaikkuna
Näyttää tiedoston valinnan dialogin ja pyytää käyttäjää valitsemaan vähintään yhden tiedoston.
Syöteparametrit
| Argumentti | Valinnainen | Hyväksyy | Oletusarvo | Description |
|---|---|---|---|---|
| Dialog title | Kyllä | Tekstin arvo | Valintaikkunan otsikko | |
| Initial folder | Kyllä | Kansio | Alkuperäinen kansion, joka avataan etsittäessä tiedostoa selaamalla. Tässä kansiossa Valitse tiedosto -valintaikkunatoiminto käynnistää käyttäjän etsimään tiedostoja | |
| Tiedostosuodatin | Kyllä | Tekstiarvo | Suodatin, joka rajoittaa noudetut tiedostot. Tämä parametri sallii yleismerkit, esimerkiksi .txt tai document?.doc. Jos käyttäjä saa valita useista tiedostosuodattimista, erota valinnat puolipisteellä, esimerkiksi .txt;*.exe | |
| Keep file selection dialog always on top | – | Totuusarvo | Väärin | Määritä, tuleeko tiedoston valinnan valintaikkunan olla aina muiden ikkunoiden päällä |
| Salli useat valinnat | – | Totuusarvo | Epätosi | Määrittää, voiko käyttäjä valita useita tiedostoja |
| Check if file exists | – | Totuusarvo | Väärin | Määritä, hyväksytäänkö vain olemassa olevan tiedostot |
Tuotetut muuttujat
| Argumentti | Type | Description |
|---|---|---|
| SelectedFile | Tiedosto | Tiedosto, joka valitaan valintaikkunan kautta |
| SelectedFiles | Luettelotiedostoista | Valitut tiedostot |
| ButtonPressed | Tekstin arvo | Valitun painikkeen teksti. Käyttäjälle annetaan automaattisesti vaihtoehdot Avaa ja Peruuta |
Poikkeukset
| Poikkeus | Kuvaus |
|---|---|
| Tiedoston valinnan valintaikkunan näyttäminen epäonnistui | Osoittaa, että tiedoston valinnan valintaikkunan näyttämisessä on ongelma |
| Tiedoston valinnan valintaikkunaa ei voi näyttää muussa kuin vuorovaikutteisessa tilassa | Osoittaa, että syötteen valintaikkunan näyttämisessä muussa kuin vuorovaikutteisessa tilassa on ongelma |
Näytä kansion valinnan valintaikkuna
Näyttää kansion valinnan dialogin ja pyytää käyttäjää valitsemaan kansion.
Syöteparametrit
| Argumentti | Valinnainen | Hyväksyy | Oletusarvo | Description |
|---|---|---|---|---|
| Dialog description | Kyllä | Tekstin arvo | Kansion valinnan valintaikkunan kuvaus. Se voi olla esimerkiksi Valitse kansio, johon haluat kopioida tiedostot | |
| Initial folder | Kyllä | Kansio | Avattava alkuperäinen kansio. Tämä kansio on oletuskansio, ellei käyttäjä valitse uutta kansiota | |
| Keep folder selection dialog always on top | – | Totuusarvo | Väärin | Määritä, tuleeko kansion valinnan valintaikkunan olla aina muiden ikkunoiden päällä |
Tuotetut muuttujat
| Argumentti | Type | Description |
|---|---|---|
| SelectedFolder | Kansio | Valittu kansio |
| ButtonPressed | Tekstin arvo | Valitun painikkeen teksti. Käyttäjälle annetaan automaattisesti vaihtoehdot OK ja Peruuta |
Poikkeukset
| Poikkeus | Kuvaus |
|---|---|
| Kansion valinnan valintaikkunan näyttäminen epäonnistui | Osoittaa, että kansion valinnan valintaikkunan näyttämisessä on ongelma |
| Kansion valinnan valintaikkunaa ei voi näyttää muussa kuin vuorovaikutteisessa tilassa | Osoittaa, että syötteen valintaikkunan näyttämisessä muussa kuin vuorovaikutteisessa tilassa on ongelma |
Näytä mukautettu lomake
Näytä mukautettu lomake, joka voi sisältää useita elementtityyppejä, kuten tekstiä, numero- ja tiedostosyötteitä jne.
Syöteparametrit
Syöttöparametrit määritetään mukautetun lomakkeiden suunnitteluohjelman kautta.
Tuotetut muuttujat
| Argumentti | Type | Description |
|---|---|---|
| CustomFormData | Mukautettu objekti | Mukautettu objekti, joka sisältää käyttäjän syötteen |
| ButtonPressed | Tekstin arvo | Painetun painikkeen tunnus |
Poikkeukset
| Poikkeus | Kuvaus |
|---|---|
| Mukautetun lomakkeen näyttäminen epäonnistui | Ilmaisee mukautetun lomakkeen näyttämisongelman |