Handler - Quickfill
QuickFill-käsittelijän avulla tukihenkilö voi nopeasti täyttää kaikki yleisesti lisättävät tiedot tietokorttiin.
QuickFill-käsittelijän käyttöliittymä koostuu kolmesta elementistä: QuickFill-tietokortin viitteen valinnan pudotusvalikosta, Show-painikkeesta ja Select-painikkeesta. Tämän käsittelijän luomat elementit näkyvät vain tietokortin muokkaustilassa.
QuickFill-viitteen pudotusvalikko sisältää luettelon ennalta määritetyistä lähdetietokorteista, joissa on ennalta määritetyt arvot määritetyille attribuuteille. Show -painikkeen avulla käyttäjä voi tarkastella parhaillaan valitun QuickFill-tietokortin arvoja. Viitatun QuickFill-tietokortin arvot näytetään omassa ponnahdusikkunassaan. Select-painike näkyy Show-painikkeen vieressä. Kun käyttäjä valitsee quick fill -tietokortin pudotusvalikosta ja napsauttaa Select-painiketta, kaikki ennalta määritetyt arvot sovelletaan välittömästi parhaillaan muokattavaan tietokorttiin.
Standard solution -attribuutti, jolla on QuickFillHandler

Quick Fill -määritystietokortit
QuickFillHandler kopioi arvoja erillisistä lähdetietokorteista muokattavana olevaan tietokorttiin. Lähdetietokorttien malli määritetään attribuutin Reference-asetuksissa. Arvot kopioidaan lähdetietokortista kohdetietokorttiin täsmäävien attribuuttikoodien perusteella.
Esimerkki quick fill -määritystietokortista:

Luettelo quick fill -määritystietokorteista. Vanhentuneet tietokortit voidaan piilottaa DataCardHiddenStateHandler-käsittelijällä, eikä niitä voi enää valita.

Kansio-oikeudet Quick Fill -määritystietokorteille
Quick fill -määritysten lähdetietokortit voidaan tallentaa erilliseen kansioon. Tavallisilla käyttäjillä voi olla read-only -oikeus kyseiseen kansioon. He voivat käyttää quick fill -toimintoa, mutta eivät voi muokata määrityksiä. Etuoikeutetuilla käyttäjillä, jotka voivat muokata määritystietokortteja, tulisi olla create-, update- ja delete -oikeudet kyseiseen kansioon.
Kansio-oikeuksien määritys quick fillin lähdetietokorteille:

Quick Fill -määritysmallit
Quick fill -toiminnoissa käytettävät arvot määritetään erillisen mallin tietokorteissa. QuickFillHandler-käsittelijällä varustettu attribuutti on määritettävä viittaamaan quick fill -malliin. Kyseisellä mallilla saa olla vain ne attribuutit, joita quick fillissä tarvitaan. Quick filliä käyttävillä käyttäjillä on oltava vähintään lukuoikeus kyseiseen malliin ja sen attribuutteihin. Quick fill -määrityksiä ylläpitävät käyttäjät tarvitsevat create-, update- ja delete -oikeudet malliin ja sen attribuutteihin.
Lähdemalli quick fill -määritykselle, joka vastaa Incident-mallia

Attribuutit
Kopioitavat arvot määritetään attribuuttikoodien perusteella. Lähdeattribuutin ja kohdeattribuutin koodien on oltava samat. Yleensä lähde- ja kohdeattribuutilla on oltava täsmälleen sama tietotyyppi. On joitakin poikkeuksia, jotka helpottavat lähdemallin toteuttamista.
Attribuuttien käyttöoikeuksia noudatetaan sekä lähde- että kohdeattribuuteissa.
Jos kohdeattribuutti on ei-staattinen yksiarvoinen, päivitetään vain tällä hetkellä tyhjä arvo, eli vanhaa arvoa ei korvata. Staattinen yksiarvoinen kuitenkin korvataan.
Jos kohdeattribuutti on moniarvoinen, lähdetietokortin uudet arvot lisätään, eli vanhoja arvoja ei korvata. Jos quick fill loisi kaksoiskappaleen arvosta, sitä ei lisätä.
Tekstiattribuutin uusi arvo lisätään uuden arvon alkuun.
Tuetut tietotyypit ja mahdolliset muunnokset

String ja Text
Lähteen string kopioidaan kohteen stringiksi. Lähteen text kopioidaan kohteen textiksi. Näitä tietotyyppejä ei voi sekoittaa keskenään. Seuraavia makroja voidaan käyttää:
-
$USER$- Nykyisen käyttäjän nimi admin-tietokortilta. -
$USERID$- Nykyisen käyttäjän tunnus. -
$DATE$- Nykyinen päivämäärä. -
$TIME$- Nykyinen aika.
Tekstiattribuutin uusi arvo lisätään uuden arvon alkuun. Voi olla hyvä idea määrittää tekstiarvo esimerkiksi näin: $USER$ added comment on $DATE$ $TIME$
Integer
Lähteen integer-arvo kopioidaan kohteen integer-kenttään. Sitä ei voi sekoittaa floatin kanssa.
Float
Lähteen float-arvo kopioidaan kohteen floatiin. Sitä ei voi sekoittaa integerin kanssa.
Date, Date and Time
Lähteen date kopioidaan kohteen dateen. Lähteen date and time kopioidaan kohteen date and timeen. Näitä tietotyyppejä ei voi sekoittaa keskenään. Lähdeattribuutti voi olla string-arvo, jossa on now-makro, esimerkiksi:
nownow + 1dnow + 45m
Viitteet
Lähdeattribuutin viittaama tietokortti lisätään kohteen (back)reference-attribuutin arvoon.
Back referenceä ei voi käyttää lähdearvona.
Upotettuja viitteitä (embedded references) ei voi käyttää lainkaan.
Lähde ja kohde voivat olla eri attribuutteja. Kohdeattribuutin on kyettävä viittaamaan uuteen kohdearvoon. Tämä tarkoittaa, että sekä lähde- että kohdeattribuutin on viitattava samaan malliin, ellei käytetä makrolauseketta.
Lähdeattribuutti voi olla string-arvo, joka edustaa user-makroa. Esimerkiksi:
-
#user#- Nykyisen käyttäjän admin-tietokortti. -
#user:person#- Nykyisen käyttäjän admin-tietokortin viite person-tietokorttiin.
Staattiset arvot
Kohteen staattisen attribuutin lähdeattribuutti voi olla sama staattinen arvo, mikä tahansa muu staattinen arvo tai string. Kohteen staattisen arvon on täsmättävä lähdearvon kanssa, kun niiden arvoja verrataan stringinä.
Attribuutin määritys
Tämän käsittelijän attribuutin on oltava yksiarvoinen viiteattribuutti, joka voi viitata vain yhteen malliin.
Taulukko 1. Attribuutin asetukset
| Käsittelijän nimi | Tietotyyppi |
|---|---|
QuickFill |
Reference |
Taulukko 2. Valinnainen attribuutin metadata
| Nimi | Arvo | Kuvaus |
|---|---|---|
Label |
Quick fill -painikkeen otsikko | Määritä painikkeen otsikko. Arvo voi olla esitysteksti, joka käännetään käyttäjän kielelle. Oletusarvoinen englanninkielinen arvo on "Select" ("text_select" esitystekstissä). |
Table of Contents