Správa atribútov

Všetky typy objektov (identity, štruktúry, pridelenia, účty) sa skladajú z atribútov. Atribút môže byť rôzneho typu (reťazec znakov, Identity, Allocation, Structure atď.).

Vytvorenie, úprava a odstránenie atribútu

Ak chcete prejsť na správu atribútov, otvorte ponuku „Configuration \ Attribute Definition“.

Zobrazí sa prvá karta, „Identity“, ktorá obsahuje zoznam existujúcich atribútov.

Na tejto stránke sú štyri karty:

• Identity
• Štruktúry
• Pridelenia
• Account

Na každej karte sú atribúty uvedené v tabuľke.

Stránkovanie je predvolene nastavené na zobrazenie iba 10 atribútov, počet zobrazených položiek však možno zmeniť.

V pravom hornom rohu tabuľky je k dispozícii pole vyhľadávania. Vyhľadávanie zahŕňa kódy, názvy a popisy atribútov.

Ak chcete vytvoriť nový atribút, kliknite na tlačidlo „“.

Konfigurácia atribútu je rozdelená na tri časti:

• General

  • Personal data: začiarknite políčko, ak chcete atribút označiť ako osobné údaje. Iba pre atribúty typu Identity.
  • Category: vyberte predvolenú kategóriu, do ktorej sa atribút umiestni. Kategóriu môžete zmeniť pre každý typ objektu.
  • Icon name: vyberte ikonu zo zoznamu možností. Zobrazí sa v záznamoch osôb. Voliteľné.
  • Icon color: možnosť prispôsobiť farbu ikony.
  • Code: kód atribútu. Musí byť jedinečný pre každý typ objektu, bez medzier a špeciálnych znakov. Povinné.
  • Name: názov atribútu. Označenie, ktoré sa zobrazí v rôznych formulároch aplikácie. Povinné.
  • Description: pole na zadanie popisu atribútu. Voliteľné.
  • Data type: vyberte z nasledujúceho zoznamu. Povinné.
    • Character string
    • Number
    • Boolean
    • Date
    • Enumerated
    • Identity
    • Organization: možnosť pridať typ štruktúry, nie je to však povinné.
    • Allocation: je povinné zadať typ pridelenia (prostriedku).
  • Multi-valued: začiarkavacie políčko, ak atribút môže nadobúdať viac hodnôt. Predvolene políčko nie je začiarknuté.
  • Structure type alebo Allocation type: zobrazí sa, ak je typ údajov „Allocation“ alebo „Structure“. Zadajte typ požadovaného objektu. Povinné iba vtedy, ak je typ údajov Allocation.
  • Default value(s): hodnota, ktorá sa predvolene priradí, ak sa atribútu pri vytváraní objektu nepriradí žiadna hodnota. Predvolená hodnota sa používa iba pri vytváraní. Voliteľné.
  • Formula type: ak sa má atribút vypočítavať, vyberte spôsob výpočtu z nasledujúceho zoznamu:
    • No formula: atribút sa nevypočítava.
    • Formula calculated once: atribút sa vypočíta iba pri vytvorení objektu.
    • Formula recalculated if necessary: atribút sa prepočíta, keď sa zmení závislý atribút (atribút použitý vo vzorci). Od verzie 7.1 sa tieto závislosti vyhodnocujú pre všetky typy objektov a aj medzi rôznymi objektmi.
    • Formula recalculated with each modification: atribút sa prepočíta pri každej aktualizácii objektu bez ohľadu na závislosti.
  • Formula: vzorec musí byť vytvorený, ak pole „Calculation mode“ nie je nastavené na „None“. Ak je pole „Calculation mode“ nastavené na „None“, toto pole musí zostať prázdne. Konfigurácia vzorcov je opísaná v časti Konfigurácia vzorca na výpočet atribútu.
  • Number of bevel days: celé číslo, ktoré určuje trvanie obdobia prekrývania hodnoty atribútu. Používa sa na správu autorizácií udelených pravidlami autorizácie.
  • Quick search: začiarknite políčko, ak chcete povoliť vyhľadávanie podľa atribútu na paneli rýchleho vyhľadávania v jednotlivých tabuľkách objektov (identity, pridelenia, štruktúry, účty).
  • Advanced search: začiarknite políčko, ak chcete povoliť rozšírené vyhľadávanie, teda prostredníctvom formulárov vyhľadávania.
  • Use in filters: začiarknite políčko, ak chcete atribút zahrnúť do kritérií filtrovania. Filtre atribútov sa používajú najmä pri vyhľadávaní objektov, v pravidlách autorizácie, pravidlách SoD, kampaniach certifikácie a rolách Identity. Obrazovka na to upozorňuje poznámkou: táto možnosť „significantly impacts the performance of rule calculations“. Začiarknite ju iba pri atribútoch, ktoré sa vo filtroch skutočne používajú.
  • Homonym: začiarknite políčko, ak chcete, aby sa atribút porovnával pri manuálnom vytváraní identít.

• Display format

  • Display index: predvolený index zobrazenia v jednotlivých formulároch (vytvorenie, zobrazenie, úprava).

  • Display format: zadajte hodnotu z dynamického zoznamu, ktorý sa zostavuje podľa typu údajov:

    • Character string:
      • Default display format: jednoduchý reťazec znakov
      • Link display format: reťazec znakov prevedený na odkaz
    • Boolean:
      • Default display format: 1 alebo 0 v závislosti od hodnoty.
      • Button display format: umožňuje definovať ikonu a označenie v závislosti od hodnoty atribútu. Umožňuje vykonávať akcie pomocou tlačidla.
    • Date:
      • Vyberte formát zo zoznamu: Short date, Medium date, Long date alebo Custom (formát sa definuje pomocou znakov d, M a y, ktoré označujú dni, mesiace a roky).
    • Person/allocation/structure
      • Single string
      • Link to object (with logo)

  • Display in results table: začiarkavacie políčko na zobrazenie hodnoty atribútu v tabuľke so zoznamom príslušných objektov.

  • Display index in results table: index zobrazenia v tabuľkách výsledkov objektov

  • Display as information: vyberte „Displayed“, ak chcete atribút zobraziť v oddiele vpravo hore v zázname identity.

    • Displayed
    • Hidden

  Predvolene sa zobrazujú tieto atribúty:

  + Display name
  + UID
  
      * Display for consultation
  
  + Displayed
  + Hidden
  
      * Display size in view mode: zadajte, akú percentuálnu časť riadka vyhradiť na zobrazenie atribútu v režime zobrazenia. Príklady:
  
  + 100: atribút sa zobrazí na celom riadku
  + 50: umožňuje zobraziť 2 atribúty na jednom riadku
  
      * Display during creation
  
  + Displayed
  + Hidden
  
      * Display size in view mode: zadajte, akú percentuálnu časť riadkov vyhradiť na zobrazenie atribútu v režime vytvárania.
  
      * Display in edition mode
  
  + Displayed: zobrazený a upraviteľný
  + Read-only: zobrazený, ale neupraviteľný
  + Hidden
  
      * Display size in view mode: zadajte, akú percentuálnu časť riadka vyhradiť na zobrazenie atribútu v režime zobrazenia.
  

• Validations

  • Required: začiarknite, ak je atribút povinný v režime vytvárania alebo úprav.
  • V závislosti od typu údajov možno konfigurovať kontroly:
    • Character string:
      • Minimum length
      • Maximum length
      • Data model: možnosť vybrať Mail alebo Custom. Pri druhej možnosti je potrebné napísať regulárny výraz.
    • Number:
    • Minimum value
    • Maximum value
  • Od SP3 produktu CyberElements Identity 7.0 bola pridaná možnosť jedinečnosti:
    • None: možnosť jedinečnosti nie je povolená (predvolená hodnota);
    • By type: možnosť jedinečnosti je povolená. Kontrolované hodnoty sa budú filtrovať podľa typu objektu;
    • Complete: možnosť jedinečnosti je povolená a neberie do úvahy typ objektu.

  Príklad

  • Ak je možnosť jedinečnosti nastavená na „By type“, identita „Employee“ môže mať pre ten istý atribút rovnakú hodnotu ako identita „External“. Dve identity „Employee“ nemôžu mať rovnakú hodnotu atribútu.
  • Ak je možnosť jedinečnosti nastavená na „Complete“, identita „Employee“ nemôže mať pre ten istý atribút rovnakú hodnotu ako identita „External“.

Ak sa atribút vypočítava, je potrebné zadať vzorec, ktorý sa použije v prípade, že prvá hodnota vypočítaná pomocou hlavného vzorca vráti už existujúcu hodnotu. Na zabezpečenie jedinečnosti hodnoty sa odporúča použiť v druhom vzorci kľúčové slovo §INDEX_DOUBLON§.

Ak chcete zobraziť a upraviť atribút, kliknite na ikonu „“ napravo v príslušnom riadku tabuľky.

Do režimu úprav môžete prepnúť priamo zo stránky zobrazenia atribútu.

V režime úprav možno upraviť všetky polia.

Akcie tlačidiel v režime úprav alebo vytvárania:

• Cancel: zruší aktuálne zadávanie a vráti sa na stránku so zoznamom atribútov.
• Save: potvrdí formulár a prepne stránku do režimu zobrazenia
• Save and quit: potvrdí formulár a vráti sa na stránku so zoznamom atribútov

Ak chcete odstrániť atribút, kliknite na ikonu „“ napravo v príslušnom riadku tabuľky.

Pred odstránením atribútu sa zobrazí potvrdzujúce hlásenie.

Upozornenie: atribút nemožno odstrániť, kým je prepojený s objektmi.

Naplnenie výčtového atribútu

Výčtový atribút je atribút s vopred určeným zoznamom hodnôt. Aby bolo možné hodnotu atribútu priradiť, musí sa nachádzať v zozname.

Výčtový atribút sa napĺňa buď prostredníctvom rozhrania, alebo prostredníctvom vstupného konektora zriaďovania.

Ak chcete naplniť výčtový atribút prostredníctvom rozhrania, otvorte stránku konfigurácie atribútu v režime zobrazenia.

Zoznam výčtových hodnôt sa vopred načíta do tabuľky bez akýchkoľvek použitých filtrov a zobrazí sa v dolnej časti stránky.

Stránkovanie je nastavené na zobrazenie iba 10 hodnôt.

V pravom hornom rohu tabuľky je k dispozícii pole vyhľadávania. Vyhľadávanie zahŕňa kódy, názvy alebo popisy výčtových hodnôt, t. j. polia zobrazené v tabuľke.

Ak chcete do zoznamu výčtového atribútu pridať novú hodnotu, kliknite na tlačidlo „“ v tabuľke „Enumerated value list“.

Zadajte informácie o výčtovej hodnote:

• Code: kód výčtovej hodnoty. Musí byť jedinečný, bez medzier a špeciálnych znakov. Povinné.
• Name: názov výčtovej hodnoty. Označenie, ktoré sa zobrazí v rôznych formulároch aplikácie. Povinné.
• Description: pole, do ktorého môžete zadať popis výčtovej hodnoty. Voliteľné.

Ak chcete upraviť výčtovú hodnotu, kliknite na ikonu „“ napravo v príslušnom riadku tabuľky.

Všetky polia je možné upraviť.

Akcie tlačidiel v režime úprav alebo vytvárania:

• Cancel: zruší aktuálne zadávanie a vráti sa na stránku zobrazenia atribútu.
• Save: potvrdí formulár a pridá hodnotu do tabuľky so zoznamom výčtových hodnôt

Ak chcete odstrániť položku, kliknite na ikonu „“ napravo v príslušnom riadku tabuľky.

Pred odstránením výčtovej hodnoty sa zobrazí potvrdzujúca správa.

Upozornenie: výčtovú hodnotu nemožno odstrániť, kým je priradená k atribútu prepojenému s objektom (identita, štruktúra, zriaďovanie alebo účet).

Ak chcete naplniť výčtový atribút prostredníctvom modulu Systancia Identity Provisioning (SIP), musíte vytvoriť vstupný konektor zriaďovania: výčtové hodnoty z externého autoritatívneho zdroja, ktoré spĺňajú pravidlá synchronizácie, sa budú v produkte CyberElements Identity vytvárať, aktualizovať a odstraňovať podľa pravidiel definovaných v pravidlách importu.

Postupnosť zriaďovania musí obsahovať aspoň tieto prvky:

• Export autoritatívneho úložiska
• Export úložiska Identity typu „ENUMERATIONS“
• Pravidlo synchronizácie
• Pravidlo importu v úložisku Identity typu „ENUMERATIONS“

Informácie o vytvorení konektora nájdete na stránke Správa konektorov automatického zriaďovania.

Konfigurácia vzorca na výpočet atribútu

Vzorec na výpočet atribútu zodpovedá dotazu SELECT, ktorý sa vykoná v databáze. Samotná operácia SELECT nesmie byť súčasťou vzorca.

Pri atribútoch prepojených s typom objektu identita sa dotazy vykonávajú na tabuľkách, ktoré obsahujú údaje identít.

Pri atribútoch prepojených s typom objektu štruktúra sa dotazy vykonávajú na tabuľkách, ktoré obsahujú údaje štruktúr.

Pri atribútoch prepojených s typom objektu pridelenie sa dotazy vykonávajú na tabuľkách, ktoré obsahujú údaje pridelení.

Pri atribútoch prepojených s typom objektu účet sa dotazy vykonávajú na tabuľkách, ktoré obsahujú údaje účtov.

Od verzie 7.1 sa závislosti medzi vypočítavanými atribútmi vyhodnocujú pre všetky typy objektov a aj medzi rôznymi objektmi: úprava atribútu teda môže spustiť prepočet atribútu, ktorý patrí inému objektu. Do verzie 7.0 sa tieto závislosti vypočítavali iba pre atribúty prepojené s identitami.

Príklad

Atribút účtu attribut_C1, prepojený s typom účtu CT1, má vzorec §OWNER§attribut_I1§, kde attribut_I1 je atribút prepojený s typom osoby.

Ak sa hodnota attribut_I1 zmení pre osobu a táto osoba má účet typu CT1, atribút účtu attribut_C1 sa automaticky prepočíta.

Na odkazovanie na určité objekty je potrebné použiť kľúčové slová.

Ak nie je uvedené inak, tieto kľúčové slová a ich varianty možno používať v atribútoch všetkých typov objektov (identita, štruktúra, pridelenie, účet):

• §ATTRIBUT§

  • §ATTRIBUT§[attribute_code]§: načíta hodnotu atribútu, ktorého kód sa odovzdá ako druhý parameter.

  • §ATTRIBUT§IS_MASTER§: tento variant možno použiť iba pre atribúty objektov typu identita. Načíta pozíciu primárnej identity v reťazci zosúladenia. Možné hodnoty sú nasledujúce:

    • 0: ak je identita v reťazci zosúladenia sekundárna
    • 1: ak je identita v reťazci zosúladenia primárna
    • 2: ak identita nie je v žiadnom reťazci zosúladenia

  • §ATTRIBUT§[primary_attribute_code].[secondary_attribute_code]§: umožňuje načítať hodnotu (sekundárneho) atribútu prepojeného s objektom, ktorý definuje primary_attribute_code. Možno ho použiť iba pre (primárne) atribúty typu identita, štruktúra alebo pridelenie, v závislosti od typu objektu, ktorý vzorec používa:

    • Identita môže byť prepojená s atribútmi typu identita, štruktúra a pridelenie.
    • Štruktúra môže byť prepojená s atribútmi typu identita a pridelenie.
    • Pridelenie môže byť prepojené s atribútmi typu identita a štruktúra.
    • Účet môže byť prepojený s atribútmi typu identita, štruktúra a pridelenie.

  Tento variant možno použiť aj na načítanie hodnôt kódu, názvu alebo popisu výčtových atribútov. V takom prípade musí mať [secondary_attribute_code] hodnotu:

  + Code na načítanie kódu výčtovej hodnoty
  + Name na načítanie názvu výčtovej hodnoty
  + Description na načítanie popisu výčtovej hodnoty
  
      * §ATTRIBUT§[attribute_code].parent§: variant, ktorý sa používa iba pre atribúty typu štruktúra. Umožňuje načítať nadradenú štruktúru štruktúry odovzdanej ako parameter. Ak chcete prejsť o niekoľko úrovní vyššie, môžete „.parent“ použiť viackrát.
  

• §CAMELIZE§: kľúčové slovo, ktoré v hodnote textového atribútu zmení prvé písmeno každého slova na veľké a ostatné znaky na malé. Nahrádza funkciu dbo.fctCamelizeString, ktorá je od verzie 7.1 zastaraná a vo verzii 7.2 odstránená.

  • §CAMELIZE§[attribute_code]§, §CAMELIZE§ATTRIBUT§[attribute_code]§ alebo §ATTRIBUT§[attribute_code].camelize()§: použije transformáciu na hodnotu atribútu, ktorého kód sa odovzdá ako parameter.
  • §CAMELIZE§OWNER§[attribute_code]§ alebo §OWNER§[attribute_code].camelize()§: použije transformáciu na hodnotu atribútu načítanú kľúčovým slovom §OWNER§, teda na hodnotu primárnej osoby reťazca zosúladenia.

  Nasledujúce znaky spôsobia, že písmeno za nimi bude veľké: medzera, spojovník „-“, tabulátor, návrat na začiatok riadka alebo posun riadka a nezlomiteľná medzera (NBSP).

  Ak chcete toto kľúčové slovo kombinovať s §NORMALIZE§, použite bodkovú syntax: §ATTRIBUT§[attribute_code].camelize().normalize()§

  Toto kľúčové slovo možno použiť v atribútoch objektov typu identita, štruktúra, pridelenie a účet, ako aj v zásadách pre prihlasovacie mená a heslá.

  Príklad

  • z „jean-pierre“ vznikne „Jean-Pierre“
  • z „martin dupont“ vznikne „Martin Dupont“
  • spojením mena „jean“ a priezviska „dupont“ vznikne „Jean Dupont“

• §COMPTE§: kľúčové slovo, ktoré možno použiť iba v atribútoch prepojených s typom objektu identita

  • §COMPTE§[account_type_code]§: umožňuje načítať prihlasovacie meno účtu, ktorý je prepojený s identitou, pre ktorú sa vzorec vykonáva, a ktorého kód typu sa odovzdá ako druhý parameter.

  Príklad: §COMPTE§Account_Type_AD§

• §COMPTEUR§

  • §COMPTEUR§[counter_code]§: načíta hodnotu počítadla, ktorého kód sa odovzdá ako druhý parameter, zvýšenú o jednu jednotku.

  Príklad: §COMPTEUR§External_ID_Number§

• §CONTEXT§

  • §CONTEXT§Code§: umožňuje načítať kód aktuálneho kontextu.

  Príklad:

  CASE §CONTEXT§Code§ 
  WHEN ‘Standard’ THEN ‘Accès ouvert’
  WHEN ‘Plan blanc’ THEN ‘Accès limité’
  ELSE ‘Accès fermé’ END
  

• §ENUM§: kľúčové slovo, ktoré umožňuje naplniť výčtový atribút na základe jeho kódu.

  • §ENUM§[enum_type_attribute_code]§[secondary_attribute_code]§: umožňuje naplniť výčtový atribút, ktorého kód sa rovná parametru [enum_type_attribute_code], z hodnoty atribútu, ktorého kód sa odovzdá ako druhý parameter [secondary_attribute_code]. To znamená, že druhý atribút má ako hodnotu kód výčtovej hodnoty.

  Tento variant sa často používa, keď sa kód výčtovej hodnoty načítava z mapovacej tabuľky.

  Príklad: v atribúte s kódom „Code_grade_table“ sa kód zodpovedajúcej výčtovej hodnoty stupňa vypočíta z mapovacej tabuľky. Má hodnotu GRADE_MANAGER.

  Mám výčtový atribút s kódom „grade“, ktorému chcem priradiť hodnotu zodpovedajúcu kódu vypočítanému v atribúte „Code_grade_table“.

  Môj vzorec bude: §ENUM§grade§Code_grade_table§

  • §ENUM§[enum_type_attribute_code].[enumeration_code]§: umožňuje naplniť výčtový atribút, ktorého kód sa rovná parametru [enum_type_attribute_code], kódom výčtovej hodnoty odovzdaným v druhom parametri [enumeration_code].

  Tento variant sa často používa, keď sa výčtová hodnota vypočítava na základe hodnoty iného atribútu.

  Príklad: mám výčtový atribút s kódom „access_type“ s týmito hodnotami:

  • Code = accès_intranet / Valeur = Intranet
  • Code = accès_externe / Valeur = Externe

  Môj atribút musí nadobudnúť hodnotu „Intranet“, keď sa typ osoby rovná „agent“, a hodnotu „External“, keď sa typ osoby rovná „service provider“.

  Môj vzorec bude:

  CASE §ATTRIBUT§type_personne_enum.code§  
  WHEN ‘agent’ THEN §ENUM§type_accès.accès_intranet§
  WHEN ‘prestataire’ THEN §ENUM§type_accès.accès_externe§
  ELSE ‘’ END
  

• §IDENTITY§

  • §IDENTITY§uid_identity§attribute_code§: načíta hodnotu atribútu odovzdaného ako druhý parameter pre identitu, ktorej UID je uvedené v prvom parametri. UID sa musí odovzdať ako pevne zadaná hodnota.

• §MAPPING§: kľúčové slovo, ktoré načíta hodnoty z mapovacích tabuliek na základe zadaného kľúča.

  • §MAPPING§[mapping_table_code].[table_key_code]§: načíta hodnotu alebo hodnoty z tabuľky s kódom [mapping_table_code] pre hodnotu kľúča odovzdanú v druhom parametri [table_key_code].

  Tento variant sa často používa, keď sa použitý kľúč líši v závislosti od hodnoty iného atribútu.

  • §MAPPING§[mapping_table_code]§[secondary_attribute_code]§: načíta hodnotu alebo hodnoty z tabuľky s kódom [mapping_table_code] na základe hodnoty atribútu, ktorého kód sa odovzdá v druhom parametri [secondary_attribute_code]. To znamená, že druhý atribút má ako hodnotu kľúč z mapovacej tabuľky.

  V takom prípade, ak je sekundárny atribút typu identita, štruktúra alebo pridelenie, možno variant rozšíriť takto: §MAPPING§[cross-reference_table_code]§[secondary_attribute_code].[tertiary_attribute_code]§. Načíta sa hodnota atribútu [tertiary_attribute_code] prepojeného s atribútom [secondary_attribute_code].

  Tento variant sa často používa, keď sa kľúč mapovacej tabuľky napĺňa alebo vypočítava v atribúte.

• §NORMALIZE§: kľúčové slovo, ktoré prevedie hodnotu textového atribútu na malé písmená, odstráni diakritiku a odstráni niektoré špeciálne znaky. Zvyčajne sa používa na generovanie stabilných identifikátorov alebo prihlasovacích mien z textových atribútov, ako sú meno a priezvisko. Nahrádza funkciu dbo.fctNormalizeString, ktorá je od verzie 7.1 zastaraná a vo verzii 7.2 odstránená.

  • §NORMALIZE§[attribute_code]§, §NORMALIZE§ATTRIBUT§[attribute_code]§ alebo §ATTRIBUT§[attribute_code].normalize()§: použije transformáciu na hodnotu atribútu, ktorého kód sa odovzdá ako parameter.
  • §NORMALIZE§OWNER§[attribute_code]§ alebo §OWNER§[attribute_code].normalize()§: použije transformáciu na hodnotu atribútu načítanú kľúčovým slovom §OWNER§, teda na hodnotu primárnej osoby reťazca zosúladenia.

  Znaky s diakritikou sa nahradia ich ekvivalentmi bez diakritiky:

  • à á â ã ä å sa zmenia na a
  • ç sa zmení na c
  • è é ê ë sa zmenia na e
  • ì í î ï sa zmenia na i
  • ñ sa zmení na n
  • ò ó ô õ ö sa zmenia na o
  • š sa zmení na s
  • ù ú û ü sa zmenia na u
  • ý ÿ sa zmenia na y
  • ž sa zmení na z

  Odstránia sa tieto špeciálne znaky: & < > ! % ( ) * + , - . / : ; = ? @ ^ _ { | } ~ € ‚ ¦ [ '

  Ak chcete toto kľúčové slovo kombinovať s §CAMELIZE§, použite bodkovú syntax: §ATTRIBUT§[attribute_code].camelize().normalize()§

  Toto kľúčové slovo možno použiť v atribútoch objektov typu identita, štruktúra, pridelenie a účet, ako aj v zásadách pre prihlasovacie mená a heslá.

  Príklad

  • z „jean-pierre“ vznikne „jeanpierre“
  • z „élodie dupont“ vznikne „elodiedupont“
  • spojením mena „élodie“ a priezviska „d'el binde“ vznikne „elodiedelbinde“

• §PERSON_STATE§: kľúčové slovo, ktoré možno použiť iba v systémovom atribúte Status (code=person_status) a ktoré umožňuje priradiť tomuto atribútu hodnotu.

  • §PERSON_STATE§[status_code]§: priradí hodnotu, ktorej kód sa odovzdá ako druhý parameter.

• §RELATED§: kľúčové slovo, ktoré načíta objekty prepojené s iným objektom prostredníctvom atribútu. Napríklad pre typ osoby, ktorý obsahuje atribút typu osoba s nadriadeným identity, toto kľúčové slovo načíta, počnúc identitou, zoznam všetkých identít, ktoré táto identita riadi.

  • §RELATED§[attribute_code]§[operation]§: [attribute_code] je atribút, ktorý navzájom prepája entity, pričom týmito entitami sú osoby, štruktúry alebo pridelenia. [operation] je voliteľný a nadobúda jednu z týchto dvoch hodnôt:
    • ANY: kľúčové slovo vráti logickú hodnotu
    • COUNT: kľúčové slovo vráti číslo

  Príklad

  • §RELATED§manager§ vráti zoznam osôb, ktorých nadriadeným je vyhodnocovaná identita.
  • §RELATED§manager§ANY§ vráti „true“, ak je identita nadriadeným aspoň jednej osoby, inak „false“.
  • §RELATED§manager§COUNT§ vráti počet osôb, ktorých nadriadeným je táto identita.

  Upozornenie

  Typ atribútu, ktorý obsahuje vzorec, musí zodpovedať spôsobu použitia kľúčového slova. Ak chcete napríklad načítať zoznam osôb pomocou vzorca §RELATED§manager§, musíte nakonfigurovať viachodnotový atribút typu identita.

Tieto kľúčové slová a ich varianty možno používať v atribútoch súvisiacich s typom objektu účet:

• §RIGHTS§

  • §RIGHTS§[right_parameter_code]§: umožňuje načítať hodnotu, kód, stav zriaďovania, teoretický stav atď. (parameter odovzdaný ako druhý parameter, [right_parameter_code]) pre všetky autorizácie prepojené s účtom. Toto kľúčové slovo sa musí použiť vo viachodnotovom atribúte.
  • §RIGHTS. [right_code]§[right_parameter_code]§: umožňuje načítať hodnotu, kód, stav zriaďovania, teoretický stav atď. (parameter odovzdaný ako tretí parameter, [right_parameter_code]) pre autorizáciu, ktorej kód je definovaný v druhom parametri, [right_code]. Hodnota môže byť jednohodnotová alebo viachodnotová.

• §ROLES§

  • §ROLES§[role_parameter_code]$: načíta názov alebo kód (parameter odovzdaný ako druhý parameter, [role_parameter_code]) všetkých rolí prepojených s účtom. Toto kľúčové slovo sa musí použiť vo viachodnotovom atribúte.
  • §ROLES.[role_code]§[role_parameter_code]§: načíta názov alebo kód (parameter odovzdaný ako tretí parameter, [role_parameter_code]) roly, ktorej kód je definovaný v druhom parametri, [role_code].

• §OWNER§ / §IDENTITIES§

  • §OWNER§[attribute_code]§: načíta hodnotu atribútu, ktorého kód sa odovzdá ako druhý parameter ([attribute_code]), pre primárnu osobu v reťazci zosúladenia bez ohľadu na to, či je prepojená s účtom.
  • §IDENTITIES§[attribute_code]§: načíta hodnotu atribútu, ktorého kód sa odovzdá ako druhý parameter ([attribute_code]), pre všetky identity prepojené s účtom, t. j. primárne aj sekundárne.

  Ak je atribút typu identita, štruktúra alebo pridelenie, možno variant rozšíriť takto: §[OWNER/IDENTITIES]§[attribute_code].[secondary_attribute_code]. Načíta sa hodnota atribútu [secondary_attribute_code] prepojeného s atribútom [attribute_code].

• §CONCAT§ / §MIN§ / §MAX§: kľúčové slová, ktoré možno použiť iba s kľúčovými slovami §OWNER§ / §IDENTITIES§.

  • §CONCAT§[OWNER/IDENTITIES]§[attribute_code].[secondary_attribute_code]§[separator]§: načíta reťazec znakov, ktorého hodnota je zreťazením hodnôt atribútu odovzdaného v 3. a 4. parametri ([attribute_code].[secondary_attribute_code]) pre všetky identity určené druhým parametrom. Jednotlivé hodnoty sú oddelené znakom zadaným v piatom parametri.
  • §MIN§[OWNER/IDENTITIES]§[attribute_code]§: načíta najnižšiu hodnotu spomedzi hodnôt atribútu odovzdaného ako tretí parameter ([attribute_code]) pre všetky identity určené druhým parametrom.
  • §MAX§[OWNER/IDENTITIES]§[attribute_code]§: načíta najvyššiu hodnotu spomedzi hodnôt atribútu odovzdaného ako tretí parameter ([attribute_code]) pre všetky identity určené druhým parametrom.

• §PASSWORD§

  • §PASSWORD§[number]§[lowercase]§[uppercase]§[special]§[special_characters_list]§[number_of_characters]§: umožňuje generovať náhodné heslá pre účty.
    • [number]: umožňuje určiť, či heslo musí obsahovať aspoň jednu číslicu. Hodnota 1 toto obmedzenie povolí. Ak chcete obmedzenie zakázať, zadajte hodnotu 0.
    • [lowercase]: umožňuje určiť, či heslo musí obsahovať aspoň jedno malé písmeno. Hodnota 1 toto obmedzenie povolí. Ak chcete obmedzenie zakázať, zadajte hodnotu 0.
    • [uppercase]: umožňuje určiť, či heslo musí obsahovať aspoň jedno veľké písmeno. Hodnota 1 toto obmedzenie povolí. Ak chcete obmedzenie zakázať, zadajte hodnotu 0.
    • [special]: umožňuje určiť, či heslo musí obsahovať aspoň jeden špeciálny znak. Hodnota 1 toto obmedzenie povolí. Ak chcete obmedzenie zakázať, zadajte hodnotu 0.
    • [special_characters_list]: umožňuje zadať povolené špeciálne znaky z tohto zoznamu: !#$%&()*+,./:;<>?@[]^_|~.
    • [number_of_characters]: určuje počet znakov hesla.

  !!! example "Príklad" §PASSWORD§1§1§1§1§!#$%&()*+§8§ Tento riadok definuje 8-znakové heslo, ktoré vyžaduje aspoň jednu číslicu, aspoň jedno malé písmeno, aspoň jedno veľké písmeno a aspoň jeden špeciálny znak z tohto zoznamu: !#$%&()*+

• §INDEX_DOUBLON§

  • §INDEX_DOUBLON§: pridá index na miesto, kde sa kľúčové slovo nachádza v hodnote atribútu.

  Upozornenie

  Toto kľúčové slovo možno použiť iba pre vypočítavané atribúty a iba vtedy, keď je povolená možnosť jedinečnosti.

• §UNION§

  • §UNION§<attribute1>|<attribute2>|...§: umožňuje zreťaziť hodnoty z viacerých atribútov do iného atribútu.
  • §UNION§<attribute1>|<attribute2>|...§<value1>|<value2>|...§: umožňuje zreťaziť hodnoty z viacerých atribútov do iného atribútu so zadaním pevných hodnôt.
    • Pevne zadané hodnoty vo vzorci môžu mať tento tvar:
      • Pri logických atribútoch: true alebo false
        • §UNION§active_person§false§
      • Pri atribútoch typu dátum: je potrebné použiť formát SQL_DATE_FORMAT_SHORT z tabuľky dbo.CONFIGURATION (predvolene „yyyy-MM-dd“)
        • §UNION§start_date|end_date§2025-05-15§
      • Pri atribútoch typu štruktúra, prostriedky alebo výčet: je potrebné zadať ID
        • §UNION§manager§1885|1886§
      • Pri atribútoch typu reťazec znakov: v reťazcoch znakov nemožno používať medzery ani znaky | alebo §. Povolené špeciálne znaky sú: !#$%&'()*+,./:;<>?@[]^_{}~
        • §UNION§firstname§Jean-Pierre|Marie§

• §RANDOM§

  • §RANDOM.[object_type]§[code]§: umožňuje náhodne vybrať hodnotu zo zoznamu hodnôt v objekte typu Table de correspondance, énumérations alebo attributs multivalués.
    • [object_type] umožňuje určiť typ objektu; môže nadobúdať tieto hodnoty:
      • MAPPING pre mapovacie tabuľky
      • ENUM pre výčtové atribúty
      • ATTRIBUTE pre viachodnotový atribút
    • [code] umožňuje zadať kód požadovaného atribútu alebo objektu