Handler - ReferenceCopy
ReferenceCopy-käsittelijä luo Search-komentopainikkeen attribuutin datakentän viereen, jonka avulla voidaan etsiä ja hakea dataa viitatusta tietokortista viittaavaan tietokorttiin. Attribuutti, jolla on ReferenceCopy-käsittelijä, eroaa tavallisesta viiteattribuutista siten, että viittaava attribuutti hakee arvot tietokortin muille attribuuteille, mutta ei itse tarvitse arvoa. Kun arvot on kopioitu viittaavaan tietokorttiin, arvojen muutokset eivät vaikuta viitattuun tietokorttiin.
Metadatan avulla voit määrittää attribuutit, joiden arvot haluat hakea ylätietokorttiin. Arvojen hakemisen onnistumiseksi molempien mallien jokaisella attribuutilla on oltava yksilöllinen attribuuttikoodi, jonka merkitset metadataan. Jos esimerkiksi haluat hakea käyttäjätietoja olemassa olevista User-tietokorteista Car-tietokortteihin, luo Car-tietokorttiin viiteattribuutti ja liitä siihen ReferenceCopy-käsittelijä. Määritä sitten viiteattribuutin metadatassa vastaavat attribuutit siten, että metadatan Name-kenttiin syötetään lähdeattribuuttien koodit ja vastaaviin metadatan Value-kenttiin syötetään vastaavat kohdeattribuuttien koodit. Näin User-tietokortin attribuuttien arvot ovat haettavissa Car -tietokortin attribuutteihin. Seuraava kuva näyttää esimerkin metadatan määrityksestä.
Metadata attribuutille, jolla on ReferenceCopy-käsittelijä:
Tietokortilla Search-painike näkyy viiteattribuutin kentän vieressä. Sen napsauttaminen avaa Search window -ikkunan, josta voidaan etsiä ja kopioida olemassa olevaa dataa luonnin alla olevaan tietokorttiin, kuten seuraavassa kuvassa havainnollistetaan.
User-attribuutti, jolla on ReferenceCopy:
Luonnin alla olevassa tietokortissa viiteattribuutti User (jossa on ReferenceCopy), joka sisältää ReferenceCopy-käsittelijän, on näkyvissä. Tallennetussa tietokortissa sen sijaan näkyvät vain haetut arvot sisältävät attribuutit, mutta yläattribuutti on piilotettu, kuten seuraavassa kuvassa havainnollistetaan.
ReferenceCopy-tuloste:
Jotta tietokortti voidaan tallentaa haetuilla arvoilla, kohde- ja lähdeattribuutin tietotyypin on oltava sama. Jos esimerkiksi haluat kopioida päivämäärän, sekä lähde- että kohdeattribuutin tietotyypin on oltava joko date tai date and time. Matrix42 validoi tietotyypin luotua tietokorttia tallennettaessa ja tallennus epäonnistuu, jos tietotyypit eivät täsmää.
Toimiakseen tarkoitetulla tavalla viiteattribuutin on viitattava vähintään yhteen malliin.
Lisäksi, jotta arvot voidaan hakea lähdeattribuuteista kohdeattribuutteihin, mallia käyttävillä käyttäjillä on oltava vähintään lukuoikeus viitattuun malliin. Jos yläattribuutti ei viittaa mihinkään malliin TAI käyttäjällä ei ole oikeutta viitattuun malliin, yläattribuutin kenttä piilotetaan eikä käsittelijä toimi.
Normaalisti tietokortin olemassa olevat arvot korvataan lähdetietokortin arvoilla. Katso metadatamäärityksen tiedoista ohjeet siihen, miten olemassa olevat arvot voidaan säilyttää. Jos viitekopiointiattribuutti (tämä attribuutti) on moniarvoinen ja haluat tallentaa linkit alkuperäisiin tietokortteihin käyttämällä :SOURCE:-määritystä, käytä myös plus-merkki-mekanismia. Katso jälleen ohjeet metadatamäärityksen tiedoista.
Jos halutaan linkki viitattuun tietokorttiin, muista asettaa metadatamääritys :SOURCE: siten, että sen arvona on tämän attribuutin koodi. Näin viittaavalla tietokortilla (mallin instanssilla, jossa tämä ReferenceCopy-käsittelijä on) on linkki tietokorttiin, johon se viittaa.
Jos yläattribuutti on kiinnitetty useampaan kuin yhteen malliin, malleilla ei välttämättä ole samoja koodeja kopioitaville attribuuteille. Tässä tapauksessa voit määrittää viitattujen mallien koodit aloittamalla metadatan nimen muodossa template_code:attribute_code . Nämä mallikohtaiset kopiointisäännöt sovelletaan ensin, minkä jälkeen sovelletaan yleisiä (ei mallikohtaisia) sääntöjä.
Seuraavat taulukot sisältävät tietoa ReferenceCopy-käsittelijän attribuuttiasetuksista ja metadatavaatimuksista. Pakolliset metatiedot on esitetty Pakollinen attribuutin metadata-taulukossa yhdessä ehdotusten kanssa mahdollisista metadatan arvoista.
Taulukko 1. Attribuutin asetukset
| Käsittelijän nimi | Tietotyyppi |
|---|---|
ReferenceCopy |
Reference |
Taulukko 2. Pakollinen attribuutin metadata
| Nimi | Arvo | Kuvaus |
|---|---|---|
[source_attribute_code] |
[target_attribute_code] |
Syötä viittaavan attribuutin koodi Voit määrittää useita attribuuttikoodipareja useiden arvojen kopioimiseksi. Jos lisäät plus-merkin (+) value-kenttään ennen attribuuttikoodia, olemassa olevia arvoja ei korvata, vaan uudet arvot lisätään olemassa olevien perään. Tämä on hyödyllistä, kun kohdeattribuutti on moniarvoinen tai kun viitekopiointiattribuutti (tämä attribuutti) on moniarvoinen. Tämä toimii myös yksiarvoisten merkkijono- ja tekstiattribuuttien kanssa. |
Taulukko 3. Valinnainen attribuutin metadata
| Nimi | Arvo | Kuvaus |
|---|---|---|
:SOURCE: |
[target_attribute_code] | Viite alkuperäiseen entiteettiin tallennetaan attribuuttiin, jonka koodi on määritetty value-kentässä. Normaalisti arvo voi olla tämän attribuutin oma koodi. |
Preserve existing |
[on | off] |
Jos haluat säilyttää viittaavan tietokortin mahdollisesti olemassa olevat tiedot, aseta tämä arvo Oletus on |
Table of Contents