FI Finnish
SE Swedish
FR French
PL Polish
DE German
US English (US)

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

Finnish
FI Finnish
SE Swedish
FR French
PL Polish
DE German
US English (US)
  • Log in
  • Home
  • Alusta
  • ESM
  • Muu tekninen ESM-dokumentaatio
  • Handler-dokumentaatio

Handler - ReferenceTargetFinder

Contact Us

If you still have questions or prefer to get help directly from an agent, please submit a request.
We’ll get back to you as soon as possible.

Please fill out the contact form below and we will reply as soon as possible.

  • Palveluhallinta
    Matrix42 Core -ratkaisu Matrix42 Intelligence Matrix42 Professional -ratkaisu
  • Identity Governance and Administration (IGA)
    IGA-ratkaisukirjasto IGA-yleiskatsaus
  • Alusta
    ESM ESS2 ESS Efecte Chat for Service Management Lisäosat
  • Julkaisutiedot M42 Professionalille, IGA:lle ja konversationaaliselle tekoälylle
    2026.1 2025.3 2025.2 2025.1 2024.2 2023.4 2023.3 2023.2 2023.1 2022.4 2022.3 Julkaisutiedot ja käytännöt
  • Muu materiaali
    Saavutettavuusselosteet Termit ja dokumentaatio-ohjeet
  • Palvelut
+ More
    • Palveluhallinta

    • Identity Governance and Administration (IGA)

    • Alusta

    • Julkaisutiedot M42 Professionalille, IGA:lle ja konversationaaliselle tekoälylle

    • Muu materiaali

    • Palvelut

Handler - ReferenceTargetFinder

ReferenceTargetFinder-käsittelijä etsii täsmäävää kohdetietokorttia. Haun kriteerit määritetään attribuutin metadataparien avulla.

Alla olevassa kuvassa on esimerkki yksinkertaisesta ohjelmistolisenssien hallintaskenaariosta:

Lisenssienhallinnan esimerkki:

Yllä olevassa esimerkissä, installed software on linkitetty software-attribuuttiin (linkki A) ja computer-attribuuttiin (linkki B1), ja license on linkitetty software-attribuuttiin (linkki A') ja cost center-attribuuttiin (linkki B'). Asennetulle ohjelmistolle tarvitaan sopiva lisenssi lisenssien hallintaa varten.

Tässä tapauksessa on etsittävä sopiva lisenssi, jonka kohde vastaa samaa ohjelmistoa kuin asennettu ohjelmisto. Toisin sanoen linkkien A ja A' on osoitettava samaan kohteeseen. Lisäksi kohdelisenssin on osoitettava samaan kustannuspaikkaan kuin tietokoneen, johon ohjelmisto on asennettu. Toisin sanoen polun B1-B2 on osoitettava samaan kohteeseen kuin linkin B'.

Nämä vastaavuudet on annettava attribuutin metadatassa. Alla on määritysesimerkki yllä olevasta tapauksesta.

Metadataesimerkki License-attribuutille:

Yllä olevassa kuvassa, ReferenceTargetFinder yrittää löytää viitatusta mallista tietokortin, joka täsmää seuraaviin kriteereihin: software-attribuutti viittaa samaan tietokorttiin kuin tämän tietokortin $software$-attribuutti, ja cost_center-attribuutti viittaa samaan tietokorttiin kuin computer-attribuutin viittaaman tietokortin cost_center-attribuutti. Jos annetuilla ehdoilla ei löydy yhtään korttia tai löytyy useampi kuin yksi kortti, attribuutti jää tyhjäksi.

Seuraavat taulukot sisältävät tietoa ReferenceTargetFinder-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
ReferenceTargetFinder Reference

Taulukko 2. Pakollinen attribuutin metadata

Nimi Arvo Kuvaus
attribute_[name]_[order] [$attribute_code$ tai $attribute_code1:attribute_code2$]

Käytetään määrittämään nykyisen tietokortin attribuutti, jota käytetään ReferenceTargetFinder-käsittelijän hakukriteerinä.

Name-kenttä

Name-kentässä 'attribute_[name]'-osa on pakollinen, '_[order]'-osa on valinnainen.

  • [name]-osa voi olla mikä tahansa merkkijono. Sitä käytetään yhdistämään tämä metadata search_template_attribute-metadataan, joten samalla [name]-arvolla varustetun search_template_attribute-metadatan on myös oltava olemassa.
  • Kaikki attribute_[name]- ja search_template_attribute_[name]-metadataparit, joilla ei ole [order]-arvoa, otetaan huomioon kaikissa järjestetyissä hauissa AND-ehtoina. Toisin sanoen, jos jokin kriteeri on yhteinen kaikille järjestetyille hauille, voit käyttää järjestämätöntä kriteeriä, jotta kriteeriä ei tarvitse määrittää useaan kertaan.
  • [order]-osa on valinnainen. Sitä tarvitaan vain, jos haluat luoda useita ehtoja, joita kokeillaan määritetyssä järjestyksessä. Jos [order] on määritetty attribute_[name] -metadatalle, myös samalla [name]- ja [order]-arvolla varustetun search_template_attribute-metadatan on oltava olemassa. Ehtoja kokeillaan [order]-arvon määrittämässä järjestyksessä.

Value-kenttä

Value-kenttään syötetään jokin viiteattribuutin koodi '$'-merkkien ympäröimänä. Jos haluat määrittää polun, voit määrittää viitteet käyttämällä ':'-merkkiä erottimena. Kun annat polun, kaikkien polun attribuuttien on oltava yksiarvoisia viitteitä.

Pariutuminen search_template_attribute-metadatan kanssa

Tässä metadatassa määritetyn viiteattribuutin arvoa verrataan search_template_attribute-metadatassa määritetyn viiteattribuutin arvoon. Toisin sanoen näiden kahden viiteattribuutin on viitattava samaan tietokorttiin.

search_template_attribute_[name]_[order] [attribute_code]

Käytetään määrittämään haettavan mallin attribuutti, jota käytetään ReferenceTargetFinder-käsittelijän hakukriteerinä.

Name-kenttä

Name-kentässä 'attribute_[name]'-osa on pakollinen, '_[order]'-osa on valinnainen.

  • [name]-osa voi olla mikä tahansa merkkijono. Sitä käytetään yhdistämään tämä metadata attribute-metadataan, joten samalla [name]-arvolla varustetun attribute-metadatan on myös oltava olemassa.
  • Kaikki attribute_[name]- ja search_template_attribute_[name]-metadataparit, joilla ei ole [order]-arvoa, otetaan huomioon kaikissa järjestetyissä hauissa AND -ehtoina. Toisin sanoen, jos jokin kriteeri on yhteinen kaikille järjestetyille hauille, voit käyttää järjestämätöntä kriteeriä, jotta kriteeriä ei tarvitse määrittää useaan kertaan.
  • [order]-osa on valinnainen. Sitä tarvitaan vain, jos haluat luoda useita ehtoja, joita kokeillaan määritetyssä järjestyksessä. Myös samalla [name]- ja [order]-arvolla varustetun attribute-metadatan on oltava olemassa. Ehtoja kokeillaan [order]-arvon määrittämässä järjestyksessä.

Value-kenttä

Value -kenttään syötetään jonkin viiteattribuutin koodi. Älä käytä tässä '$'-merkkejä. Polkuja ei voi käyttää.

Pariutuminen attribute-metadatan kanssa

Tässä metadatassa määritetyn viiteattribuutin arvoa verrataan attribute-metadatassa määritetyn viiteattribuutin arvoon. Toisin sanoen näiden kahden viiteattribuutin on viitattava samaan tietokorttiin.

Määritysesimerkkejä Software Asset Managementille

ReferenceTargetFinder-käsittelijää käytetään yleensä Software Asset Managementissa (SAM). SAMissa sen haluttu toiminta on etsiä sopiva ohjelmistolisenssipooli valvotulle ohjelmistoasennukselle, mahdollisesti useasta lisenssipoolista määritetyssä järjestyksessä, ja lisätä viite kyseiseen pooliin valvotun ohjelmistoasennuksen tietokorttiin.

Taulukko 3. ReferenceTargetFinder-esimerkkimääritys järjestysarvoilla

Nimi Arvo
attribute_owner_1 $user$
attribute_owner_2 $cost_center$
attribute_owner_3 $company$
search_template_attribute_owner_1 user
search_template_attribute_owner_2 cost_center
search_template_attribute_owner_3 company
attribute_software $software$
search_template_attribute_software software

Taulukko 4. ReferenceTargetFinder-esimerkkimääritys järjestysarvoilla ja poluilla

Nimi Arvo Kuvaus
attribute_owner_1 $user$
attribute_owner_2 $user:cost_center$
attribute_owner_3 $user:cost_center:company$
search_template_attribute_owner_1 owner owner on viiteattribuutti, jolla on viite (vähintään) User-, Cost Center- ja Company-malleihin
search_template_attribute_owner_2 owner owner on viiteattribuutti, jolla on viite (vähintään) User-, Cost Center- ja Company-malleihin
search_template_attribute_owner_3 owner owner on viiteattribuutti, jolla on viite (vähintään) User-, Cost Center- ja Company-malleihin
attribute_software $software$
search_template_attribute_software software

Järjestämätön haku on voimassa jokaisen järjestetyn haun yhteydessä; se etsii lisenssipoolia, joka viittaa samaan ohjelmistoon kuin ohjelmistoasennus.

Järjestetyt haut toimivat seuraavasti: ensin ReferenceTargetFinder yrittää löytää tietokortin, jossa user-attribuutti viittaa samaan käyttäjään kuin tämä tietokortti. Jos täsmälleen yksi osuma löytyy, attribuutin kohteeksi tulee kyseinen tietokortti (paitsi jos lisenssejä ei ole jäljellä ja prevent_exceeding -attribuuttia käytetään). Jos sopivaa tietokorttia ei löydy, ReferenceTargetFinder yrittää seuraavaksi etsiä tietokorttia, jossa cost_center -attribuutti viittaa samaan tietokorttiin kuin tämän tietokortin cost center. Jos sellainen löytyy, siitä tulee tämän viitteen kohde (paitsi jos lisenssejä ei ole jäljellä ja prevent_exceeding -attribuuttia käytetään). Jos sopivaa tietokorttia ei löydy, ReferenceTargetFinder yrittää seuraavaksi etsiä tietokorttia, jossa company-attribuutti viittaa samaan tietokorttiin kuin tämän tietokortin company (paitsi jos lisenssejä ei ole jäljellä ja prevent_exceeding -attribuuttia käytetään).

Käytännössä tällainen määritys voitaisiin luoda SAM:ssa, jos asiakkaalla on ohjelmistolle käyttäjäkohtaisia, kustannuspaikkakohtaisia ja koko yrityksen laajuisia lisenssejä. SAM yrittäisi ensin käyttää käyttäjäkohtaisia lisenssejä. Jos yksikään ei ole vapaana, SAM yrittäisi seuraavaksi käyttää kustannuspaikkakohtaisia lisenssejä. Jos yksikään ei ole vapaana, SAM yrittäisi käyttää koko yrityksen laajuisia lisenssejä. Jos yksikään ei ole vapaana, lisenssin allokointi epäonnistuisi.

Jos yhdelläkään määritetyllä ehdolla ei löydy tietokortteja, attribuutti jää tyhjäksi. Jos jollakin yksittäisellä ehdolla löytyy useampi kuin yksi tietokortti, tulosta käsitellään samalla tavalla kuin tilannetta, jossa tietokortteja ei löydy (eli jos hakuja on vielä jäljellä, ne suoritetaan; jos kaikki haut ovat tuottaneet nolla tai useamman tietokortin, attribuutti jää tyhjäksi).

prevent_exceeding-attribuutin käyttö ReferenceTargetFinder-määrityksessä

Normaalisti, kun kohde (lisenssipooli) löytyy, haku päättyy eikä seuraavaa ehtoa järjestyksessä kokeilla. Jos halutaan, että lisenssipoolissa käytettyjen lisenssien määrä ei ylitä lisenssien määrää, lisenssipoolilla voi olla attribuutti, jonka koodi on prevent_exceeding. Jos kyseisellä attribuutilla on jokin arvo ja käytettyjen lisenssien määrä (attribuuttikoodi UsedLicenses) ylittäisi lisenssien määrän (attribuuttikoodi LicenseManagementLicenseAmount), viite ei osoita kyseiseen lisenssipooliin ja haku jatkuu seuraavalla ehdolla järjestyksessä. SAM:ssa UsedLicenses-attribuuttia käytetään tyypillisesti yhdessä ReferrerCounter -käsittelijän kanssa jo käytössä olevien lisenssien määrän seuraamiseen.

overflown_license_pool-attribuutin käyttö ReferenceTargetFinder-määrityksessä

On myös mahdollista seurata ohjelmistoinstansseja, jotka käyttävät muuta kuin niiden ensisijaista lisenssipoolia. Tämä voidaan tehdä lisäämällä ohjelmistoinstanssiin viiteattribuutti, jonka koodi on overflown_license_pool . Jos lisenssien ylivuoto tapahtuu (eli muutoin sopiva osuma hylätään, koska kaikki kyseisen poolin lisenssit ovat jo käytössä ja prevent_exceeding on voimassa), tämä attribuutti asetetaan automaattisesti osoittamaan instanssin ensisijaiseen lisenssipooliin.

Ei ole mahdollista poistaa käytöstä prevent_exceeding - ja overflown_license_pool -attribuuttien vaikutusta muuten kuin poistamalla attribuuttikoodit mallista. Näin ollen näillä koodeilla varustettuja attribuutteja ei saa olla malleissa, joissa niiden toiminnallisuutta ei haluta.

Jos seuraat, mitkä ohjelmistoinstanssit käyttävät muuta kuin ensisijaista lisenssipooliaan, ole huolellinen määrittäessäsi lisenssipoolimallin käytettyjen lisenssien viittaajalaskuri-attribuuttia laskemaan ohjelmistoinstanssit vain oikeasta attribuutista, eli varmista, ettei ylivuotopoolin viitteitä sisällytetä laskentaan. Voit myös laskea ohjelmistoinstanssit, jotka olisivat ylittäneet poolin lisenssien rajan, lisäämällä toisen viittaajalaskuri-attribuutin, joka laskee vain ne ohjelmistoinstanssit, jotka osoittavat siihen overflown_license_pool -attribuuttinsa kautta.

ReferenceTargetFinder suoritetaan aina, kun tietokortti tallennetaan, joten lisenssipoolin lisenssien määrällä ei ole välitöntä vaikutusta niihin viittaaviin ohjelmistoasennuksiin — ne on ensin tallennettava.

Kun Efecte Inspectoria käytetään, tietokortit tallennetaan automaattisesti tuonnin aikana, joten niitä ei tarvitse tallentaa manuaalisesti, ellei muutosta tarvitse saada näkyviin välittömästi.

Kun Sccm -toimintoa käytetään, tietokortit tallennetaan vain, kun tietokoneessa tapahtuu muutos. Tämä tarkoittaa, että ohjelmistoasennusten lisenssitiedot eivät välttämättä ole ajan tasalla: ne eivät ehkä käytä lisenssipoolia optimaalisella tavalla. Yksi tapa estää tämä ongelma on valita Show referrers lisenssipoolinäkymässä, jotta kaikki lisenssit näytetään, ja käynnistää sitten tallennus monimuokkauksella.

Was this article helpful?

Yes
No
Give feedback about this article

Table of Contents

Related Articles

  • Yleiskatsaus käsittelijöihin
  • EQL-editori
  • Handler - IDGenerator
  • Attribute Metadata - ShowCode
  • Attribute Metadata - PrintTemplateName

Copyright 2026 – Matrix42 Professional.

Matrix42 homepage


Knowledge Base Software powered by Helpjuice

0
0
Expand