Handler - CategoryDropdownReference
CategoryDropdownReference-handleria käytetään luomaan riippuvuuksia kategoria-alasvetovalikoiden (category dropdown) välille. Tällä handlerilla voidaan määrittää, että toinen alasvetovalikko saa mahdolliset arvonsa tämän handlerin valitun alasvetovalikon arvon perusteella.
Tietokortin muokkaaminen, jossa on useita kategoria-alasvetovalikoita (kukin "Category X" -attribuutti). Kuvakaappaus on otettu Firefoxilla. Internet Explorerissa "Category 4" -alasvetovalikko jäisi valkoiseksi harmaan sijaan:

Yllä oleva kuva näyttää esimerkin riippuvuuskategoriasta (dependency category).
- "
Category 1"-arvo rajaa "Category 2":n mahdollisia arvoja, ja "Category 2" puolestaan rajaa "Category 3":n mahdollisia arvoja, ja niin edelleen. - Tässä esimerkissä alasvetovalikkokategorian juuri ("
Category 1") on määritetty viittaamaan tietyn mallipohjan kaikkiin tietokortteihin.- Seuraavan tason kategoria ("
Category 2") on myös määritetty viittaamaan mahdollisesti eri mallipohjan kaikkiin tietokortteihin (mallipohja voi olla eri kuin "Category 1":n viittaama mallipohja). - Koska "
Category 2" on kuitenkin "Category 1":n alainen, tarvitaan konfiguraatio, joka yhdistää "Category 2":n viittaaman mallipohjan tietokortit "Category 1":n alasvetovalikosta valittuun tietokorttiin. - Tämä tarkoittaa, että "
Category 2":lle kelvollisten tietokorttien täytyy viitata jo "Category 1":ssä valittuun tietokorttiin.
- Seuraavan tason kategoria ("
- Yllä olevassa kuvassa "
Application Services" -tietokortti viittaa "Servers and Storage" -tietokorttiin.
Ottaaksesi käyttöön "Reserve Ticket" -painikkeen toiminnon, katso Handler - TicketReservation
CategoryDropdownReference-handlerin painikkeen oletusotsikko on esitystekstin button_reserve arvo. Otsikon arvon voi ylikirjoittaa mallipohjan lokalisointieditorissa.
Taulukko 1. Attribuutin asetukset
| Handlerin nimi | Tietotyyppi |
|---|---|
CategoryDropdownReference |
Reference |
Taulukko 2. Pakolliset attribuutin metatiedot
| Nimi | Arvo | Kuvaus |
|---|---|---|
Category template |
[mallipohjan koodi] | Kategoriamallipohjan koodi. Tämän mallipohjan tietokortit muodostavat kategoriapuun (parent-child-suhde). Jotta mallipohja kelpaa kategoriamallipohjaksi, sillä on siis oltava ylätason tietokorttiin viittaava attribuutti (referrer attribute). |
Attribute for parent category in category template |
[attribuutin koodi] | Ylätason tietokorttiin viittaavan attribuutin koodi. Tämän attribuutin on kuuluttava yllä määritettyyn kategoriamallipohjaan, ja sen tyypin on oltava reference. |
Taulukko 3. Valinnaiset attribuutin metatiedot
| Nimi | Arvo | Kuvaus |
|---|---|---|
Attribute for parent category |
[attribuutin koodi] | Tämä attribuutin koodi osoittaa ylätason kategoria-alasvetovalikon attribuuttiin. Vaihtoehtoisesti attribuutin koodi voi osoittaa tavalliseen reference-attribuuttiin (katso esimerkkikonfiguraatio). Jos tämä metatieto puuttuu, se tarkoittaa, että tätä handleria käyttävä attribuutti on kategoria-alasvetovalikkohierarkian juuri. |
|
|
[attribuutin koodi] |
Ota käyttöön tietokortin varaus (datacard reserving) määrittämällä nämä viisi metatietoa. Katso lisätietoja artikkelista Handler - TicketReservation.
|
Konfiguraatioesimerkit
Esimerkki riippuvuuskategorian (dependency category) määrittämisestä yhdellä kategoriamallipohjalla:
- Luo kategoriamallipohja, jossa on ylätason tietokorttiin viittaava attribuutti (attribuutti, joka viittaa juuri luotuun samaan mallipohjaan) sekä nimikenttä.
- Luo mallipohja, jossa on kaksi (tai valitsemasi määrä) attribuuttia, joissa on CategoryDropdownReference-handler. Aseta tämä mallipohja viittaamaan kategoriamallipohjaan.
- Anna kaikille mallipohjille ja attribuuteille yksilöllinen koodi. (Attribuuttikoodien tarvitsee olla yksilöllisiä vain yhden mallipohjan sisällä.)
- Määritä handler ensimmäiselle attribuutille (riippuvuuskategorian juuri). Aseta metatiedoissa "Category template" -arvoksi kategoriamallipohjan koodi. Aseta "Attribute for parent category in category template" -arvoksi ylätason tietokorttiin viittaavan attribuutin koodi. Älä aseta "Attribute for parent category" -arvoa, koska tämä on riippuvuuskategorian juurikonfiguraatio.
- Määritä toinen handler-attribuutti: aseta "
Category template" ja "Attribute for parent category in category template" samoiksi kuin edellä kuvatussa ensimmäisessä konfiguraatiossa. Aseta "Attribute for parent category" -arvoksi edellisen handler-attribuutin arvo. - Luo kategoriamallipohjan tietokortteja: luo yksi tai useampi tietokortti, jolla ei ole ylätasoa, ja luo sitten yksi tai useampi tietokortti, jolla on ylätaso.
- Riippuvuuskategoria on nyt valmis käytettäväksi.
Toinen esimerkki riippuvuuskategorian määrittämisestä, tällä kertaa useammalla kategoriamallipohjalla:
- Tee perusmääritykset yllä olevan esimerkin mukaisesti.
- Luo toinen kategoriamallipohja, jossa on toinen ylätason tietokorttiin viittaava attribuutti, joka viittaa sekä tähän uuteen kategoriamallipohjaan että aiemmin luotuun kategoriamallipohjaan. Näin tämän mallipohjan tietokortit voivat kuulua aiemmin luodun mallipohjan tietokorteista muodostuvaan kategoriapuuhun (syntyy parent-child-suhde, joka on edellytys tietokorttien liittämiselle riippuvuuskategoriaan).
- Luo uusi
CategoryDropdownReference-handler-attribuutti aiemmin luotujen rinnalle. Määritä ne osoittamaan ylätasoihinsa (katso "Attribute for parent category"). Aseta "Category template" ja "Attribute for parent category in category template" osoittamaan uuteen kategoriamallipohjaan. Aseta tämä attribuutti viittaamaan juuri luotuun uuteen kategoriamallipohjaan. - Meillä on nyt kaksi kategoriamallipohjaa, yksi isäntämallipohja (mallipohja, jossa nämä
CategoryDropdownReference-handlerit ovat) ja kolme attribuuttia, joissa tämä handler on käytössä. Ensimmäinen kategoria-alasvetovalikko listaa ensimmäisen kategoriamallipohjan juuritietokortit, toinen kategoria-alasvetovalikko listaa tietokortit, joiden ylätasona on valittu kategoriatietokortti, ja viimeinen kategoria-alasvetovalikko listaa toisen kategoriamallipohjan tietokortit, joiden ylätasona on toinen valittu kategoriatietokortti.
Ylimmän kategoria-alasvetovalikon voi myös määrittää riippumaan tavallisesta reference-attribuutista. Tässä esimerkki tällaisesta käyttötapauksesta: yritykselläni on hierarkkinen organisaatio. Tietokorttia muokatessani haluan valita oman yksikköni organisaatiosta riippuvuuskategorian avulla.
Continent, Country, Strategic Business Unit ja Team ovat pois käytöstä, koska Company -arvoa ei ole vielä valittu:

Tässä konfiguraatiossa Continentin "Attribute for parent category" on Company-attribuutin koodi, Countryn "Attribute for parent category" on Continent -attribuutin koodi, ja niin edelleen.
Valitse jokin Company-kentän vaihtoehdoista, jotta Continent-valinta tulee mahdolliseksi.

Continent-valinta on nyt käytössä, koska Asia, Europe ja America viittaavat kohteeseen My company.

Lisäksi on nyt mahdollista valita Country, Strategic Business Unit sekä Team.

Huomaa, miten Europe, Asia ja America viittaavat kohteeseen My company. Tämä mahdollistaa sen, että ylin kategoria-alasvetovalikko riippuu tavallisesta reference-attribuutista.

Taulukko 4. Sanasto
| Termi | Kuvaus |
|---|---|
Category dropdown |
Käyttöliittymän kenttä, josta viitattu tietokortti valitaan (teknisesti html select -elementti). Se on Matrix42-attribuutti, johon on liitetty CategoryDropdownReference handler. Se on osa riippuvuuskategoriaa. |
Category data card |
Yksi kategoriapuun elementeistä. Sen mallipohja on kategoriamallipohja. |
Category root data card |
Kategoriapuun tietokortti, jolla ei ole ylätasoa. |
Category template |
Tämän mallipohjan tietokortit (category data cards) kelpaavat category dropdown -kentän arvoksi. Tällä mallipohjalla on oltava reference-tyyppinen attribuutti, joka viittaa ylätason kategoriatietokorttiin. Toisin sanoen attribuutti on määritetty viittaamaan kategoriamallipohjaan itseensä. |
Category tree |
Matrix42-tietokorteista muodostuva puu. Jokaisella tämän puun tietokortilla voi olla ylätaso ja yksi tai useampi alataso. Jos tietokortilla ei ole ylätasoa, se on category root data card. |
Dependency category |
Tämä kategoria muodostuu useista attribuuteista, joihin on liitetty CategoryDropdownReference-handler. |
Dependency category root |
Tämä on category dropdown, jonka metatiedoissa ei ole määritetty kategorian ylätasoa. |
Parent data card referrer attribute |
Tämä on kategoriamallipohjan attribuutti. Se viittaa category data card -kortin mahdolliseen ylätasoon. |
Table of Contents