Ġestjoni tal-attributi¶

It-tipi kollha ta’ oġġetti (identitajiet, strutturi, allokazzjonijiet, kontijiet) huma magħmula minn attributi. Attribut jista’ jkun ta’ tipi differenti (sensiela ta’ karattri, Identity, Allocation, Structure, eċċ.).

Oħloq/immodifika/ħassar attribut¶

Biex taċċessa l-ġestjoni tal-attributi, mur fil-menu “Configuration \ Attribute Definition”.

Tasal fl-ewwel tab, “Identity”, li fiha l-lista tal-attributi eżistenti.

Hemm erba’ tabs f’din il-paġna:

Identity
Strutturi
Allokazzjonijiet
Account

F’kull tab, l-attributi huma elenkati f’tabella.

Il-paġinazzjoni hija ssettjata biex turi biss 10 attributi b’mod default, iżda huwa possibbli li tbiddel in-numru ta’ elementi murija.

Qasam tat-tfittxija huwa disponibbli fir-rokna ta’ fuq fuq il-lemin tat-tabella. It-tfittxija tkopri l-kodiċijiet, l-ismijiet u d-deskrizzjonijiet tal-attributi.

Biex toħloq attribut ġdid, ikklikkja l-buttuna “”.

Il-konfigurazzjoni tal-attributi hija maqsuma fi tliet partijiet:

General
- Personal data: immarka l-kaxxa biex tidentifika l-attribut bħala data personali. Għall-attributi tat-tip Identity biss.
- Category: Agħżel il-kategorija default li fiha se jitqiegħed l-attribut. Tista’ tbiddel il-kategorija għal kull tip ta’ oġġett.
- Icon name: agħżel l-ikona minn lista ta’ għażliet. Se tkun inkluża fir-rekords tal-persuni. Fakultattiv.
- Icon color: għażla biex tippersonalizza l-kulur tal-ikona.
- Code: kodiċi tal-attribut. Għandu jkun uniku għal kull tip ta’ oġġett, mingħajr spazji jew karattri speċjali. Obbligatorju.
- Name: isem l-attribut. Tikketta li se tintwera fil-formoli differenti tal-applikazzjoni. Obbligatorju.
- Description: qasam biex iddaħħal deskrizzjoni tal-attribut. Fakultattiv.
- Data type: agħżel mil-lista li ġejja. Obbligatorju.
  - Character string
  - Number
  - Boolean
  - Date
  - Enumerated
  - Identity
  - Organization: għażla biex iżżid tip ta’ struttura, iżda mhux obbligatorja.
  - Allocation: huwa obbligatorju li ddaħħal tip ta’ allokazzjoni (riżorsa).
- Multi-valued: kaxxa ta’ selezzjoni jekk l-attribut jista’ jieħu diversi valuri. B’mod default, il-kaxxa mhijiex immarkata.
- Structure type jew Allocation type: jintwera jekk it-tip ta’ data huwa “Allocation” jew “Structure”. Daħħal it-tip tal-oġġett mixtieq. Meħtieġ biss jekk it-tip ta’ data huwa Allocation.
- Default value(s): valur li se jiġi assenjat b’mod default jekk ebda valur ma jiġi assenjat lill-attribut meta jinħoloq oġġett. Il-valur default jintuża biss waqt il-ħolqien. Fakultattiv.
- Formula type: agħżel metodu ta’ kalkolu mil-lista li ġejja jekk l-attribut għandu jiġi kkalkulat:
  - No formula: l-attribut mhuwiex ikkalkulat.
  - Formula calculated once: l-attribut jiġi kkalkulat biss meta jinħoloq oġġett.
  - Formula recalculated if necessary: l-attribut jiġi kkalkulat mill-ġdid meta jiġi mmodifikat attribut dipendenti (attribut użat fil-formula). Mill-verżjoni 7.1 ’il quddiem, dawn id-dipendenzi jiġu evalwati fuq it-tipi kollha ta’ oġġetti u wkoll bejn oġġetti differenti.
  - Formula recalculated with each modification: l-attribut jiġi kkalkulat mill-ġdid kull darba li l-oġġett jiġi aġġornat, irrispettivament mid-dipendenzi.
- Formula: għandha tinħoloq formula jekk il-qasam “Calculation mode” ma jkunx issettjat għal “None”. Jekk il-qasam “Calculation mode” ikun issettjat għal “None”, dan il-qasam għandu jkun vojt. Ara l-kapitolu Ikkonfigura formula għall-kalkolu ta’ attribut għall-konfigurazzjoni tal-formuli.
- Number of bevel days: numru sħiħ li jiddefinixxi t-tul tal-perjodu ta’ sovrappożizzjoni tal-valur ta’ attribut. Jintuża biex jiġu ġestiti l-awtorizzazzjonijiet mogħtija mir-regoli tal-awtorizzazzjoni.
- Quick search: immarka l-kaxxa biex tattiva t-tfittxijiet fuq l-attribut fl-istrixxa tat-tfittxija rapida tat-tabelli differenti tal-oġġetti (identitajiet, allokazzjonijiet, strutturi, kontijiet).
- Advanced search: immarka l-kaxxa biex tattiva t-tfittxijiet avvanzati, permezz tal-formoli tat-tfittxija.
- Use in filters: immarka l-kaxxa biex tinkludi l-attribut fil-kriterji tal-filtrar. Il-filtri tal-attributi jintużaw b’mod partikolari fit-tfittxijiet tal-oġġetti, fir-regoli tal-awtorizzazzjoni, fir-regoli SoD, fil-kampanji taċ-ċertifikazzjoni u fir-rwoli Identity. L-iskrin jindika dan b’nota: din l-għażla “significantly impacts the performance of rule calculations”. Immarkaha biss għall-attributi li fil-fatt jintużaw fil-filtri.
- Homonym: immarka l-kaxxa jekk trid li l-attribut jiġi mqabbel meta jinħolqu identitajiet manwalment.

Display format

Display index: indiċi tal-wiri default fil-formoli differenti (ħolqien, konsultazzjoni, modifika).
Display format: daħħal valur minn lista dinamika li tinbena skont it-tip ta’ data:
- Character string:
  - Default display format: sensiela ta’ karattri sempliċi
  - Link display format: sensiela ta’ karattri kkonvertita f’link
- Boolean:
  - Default display format: 1 jew 0 skont il-valur.
  - Button display format: jippermettilek tiddefinixxi ikona u tikketta skont il-valur tal-attribut. Jippermettilek twettaq azzjonijiet fuq il-buttuna.
- Date:
  - Agħżel il-format mil-lista: Short date, Medium date, Long date jew Custom (format li għandu jiġi definit bil-karattri d, M u y biex jiġu definiti, rispettivament, il-jiem, ix-xhur u s-snin).
- Persuna/allokazzjoni/struttura
  - Single string
  - Link to object (with logo)
Display in results table: kaxxa ta’ selezzjoni biex jintwera l-valur tal-attribut fit-tabella li telenka l-oġġetti korrispondenti.
Display index in results table: indiċi tal-wiri fit-tabelli tar-riżultati tal-oġġetti
Display as information: Agħżel “Displayed” biex turi l-attribut fil-kaxxa fir-rokna ta’ fuq fuq il-lemin tal-identitajiet.
- Displayed
- Hidden

B’mod default, l-attributi murija huma:

+ Display name
+ UID

    * Display for consultation

+ Displayed
+ Hidden

    * Display size in view mode: daħħal il-perċentwal tal-linja li għandu jiġi allokat għall-wiri tal-attribut fil-modalità ta’ konsultazzjoni. Eżempji:

+ 100: l-attribut jintwera fuq il-linja kollha
+ 50: jippermetti li jintwerew 2 attributi fuq linja waħda

    * Display during creation

+ Displayed
+ Hidden

    * Display size in view mode: daħħal il-perċentwal tal-linja li għandu jiġi allokat għall-wiri tal-attribut fil-modalità ta’ ħolqien.

    * Display in edition mode

+ Displayed: muri u editjabbli
+ Read-only: muri iżda mhux editjabbli
+ Hidden

    * Display size in view mode: daħħal il-perċentwal tal-linja li għandu jiġi allokat għall-wiri tal-attribut fil-modalità ta’ konsultazzjoni.

Validations
- Required: immarka l-kaxxa jekk l-attribut huwa obbligatorju fil-modalità ta’ ħolqien jew ta’ modifika.
- Skont it-tip ta’ data, huwa possibbli li tikkonfigura kontrolli:
  - Character string:
    - Minimum length
    - Maximum length
    - Data model: għażla biex tagħżel Mail jew Custom. Bit-tieni għażla, għandha tinkiteb espressjoni regolari.
  - Number:
  - Minimum value
  - Maximum value
- Minn CyberElements Identity 7.0 SP3 ’il quddiem, ġiet miżjuda għażla ta’ uniċità:
  - None: l-għażla ta’ uniċità mhijiex attivata (valur default);
  - By type: l-għażla ta’ uniċità hija attivata. Il-valuri vverifikati se jiġu ffiltrati skont it-tip ta’ oġġett;
  - Complete: l-għażla ta’ uniċità hija attivata u ma tqisx it-tip ta’ oġġett.
Eżempju
- Jekk l-għażla ta’ uniċità tkun issettjata għal “By type”, identità “Employee” tista’ jkollha l-istess valur bħal identità “External” għall-istess attribut. Żewġ identitajiet “Employee” ma jistgħux ikollhom l-istess valur tal-attribut.
- Jekk l-għażla ta’ uniċità tkun issettjata għal “Complete”, identità “Employee” ma tistax ikollha l-istess valur bħal identità “External” għall-istess attribut.

Jekk attribut ikun ikkalkulat, huwa meħtieġ li tispeċifika formula li għandha tiġi applikata f’każ li l-ewwel valur ikkalkulat bil-formula prinċipali jagħti valur li diġà jeżisti. Huwa rakkomandat li tuża l-kelma ewlenija §INDEX_DOUBLON§ fit-tieni formula biex tiżgura l-uniċità tal-valur.

Biex tara u timmodifika attribut, ikklikkja l-ikona “” li tinsab fuq il-lemin fir-ringiela korrispondenti tat-tabella.

Tista’ taqleb għall-modalità ta’ modifika direttament mill-paġna tal-konsultazzjoni tal-attribut.

Fil-modalità ta’ editjar, l-oqsma kollha jistgħu jiġu mmodifikati.

Azzjonijiet tal-buttuni fil-modalità ta’ editjar jew ta’ ħolqien:

Cancel: jikkanċella d-dħul attwali u jirritorna għall-paġna tal-lista tal-attributi.
Save: tivvalida l-formola u taqleb il-paġna għall-modalità tal-wiri
Save and quit: jivvalida l-formola u jirritorna għall-paġna tal-lista tal-attributi

Biex tħassar attribut, ikklikkja l-ikona “” li tinsab fuq il-lemin tar-ringiela korrispondenti tat-tabella.

Qabel ma l-attribut jitħassar, jidher messaġġ ta’ konferma.

Twissija: mhuwiex possibbli li tħassar attribut sakemm ikun marbut ma’ oġġetti.

Il-mili ta’ attribut enumerat¶

Attribut enumerat huwa attribut b’lista predeterminata ta’ valuri. Il-valur tal-attribut irid ikun preżenti fil-lista biex ikun jista’ jiġi assenjat.

Attribut enumerat jimtela jew permezz tal-interfaċċja jew permezz ta’ konnettur tal-provvediment ta’ dħul.

Biex timla attribut enumerat permezz tal-interfaċċja, iftaħ il-paġna tal-konfigurazzjoni tal-attribut fil-modalità ta’ konsultazzjoni.

Il-lista tal-valuri enumerati hija mgħobbija minn qabel f’tabella, mingħajr ebda filtru applikat, u tintwera fil-qiegħ tal-paġna.

Il-paġinazzjoni hija implimentata biex turi biss 10 valuri.

Qasam tat-tfittxija huwa disponibbli fir-rokna ta’ fuq fuq il-lemin tat-tabella. It-tfittxija tkopri l-kodiċijiet, l-ismijiet jew id-deskrizzjonijiet tal-valuri enumerati, jiġifieri l-oqsma murija fit-tabella.

Biex iżżid valur ġdid mal-lista tal-attribut enumerat, ikklikkja l-buttuna “” li tinsab fit-tabella “Enumerated value list”.

Daħħal l-informazzjoni tal-element enumerat:

Code: kodiċi tal-valur enumerat. Għandu jkun uniku, mingħajr spazji jew karattri speċjali. Obbligatorju.
Name: isem l-element enumerat. Tikketta li se tintwera fil-formoli differenti tal-applikazzjoni. Obbligatorju.
Description: qasam li jippermettilek iddaħħal deskrizzjoni tal-element enumerat. Fakultattiv.

Biex timmodifika element enumerat, ikklikkja l-ikona “” li tinsab fuq il-lemin fir-ringiela korrispondenti tat-tabella.

L-oqsma kollha jistgħu jiġu modifikati.

Azzjonijiet tal-buttuni fil-modalità ta’ editjar jew ta’ ħolqien:

Cancel: jikkanċella d-dħul kurrenti u jirritorna għall-paġna tal-konsultazzjoni tal-attribut.
Save: jivvalida l-formola u jżid il-valur mat-tabella tal-lista tal-enumerazzjoni

Biex tħassar element, ikklikkja l-ikona “” li tinsab fuq il-lemin tar-ringiela korrispondenti tat-tabella.

Qabel ma l-element enumerat jitħassar, jidher messaġġ ta’ konferma.

Twissija: mhuwiex possibbli li tħassar valur enumerat sakemm ikun assenjat lil attribut marbut ma’ oġġett (identità, struttura, provvediment jew kont).

Biex timla attribut enumerat permezz tal-magna tal-provvediment Systancia Identity Provisioning (SIP), għandek toħloq konnettur tal-provvediment ta’ dħul: minn sors awtorevoli estern, il-valuri tal-enumerazzjoni li jissodisfaw ir-regoli tas-sinkronizzazzjoni se jinħolqu, jiġu aġġornati u jitħassru f’CyberElements Identity skont ir-regoli definiti fir-regoli tal-importazzjoni.

Is-sekwenza tal-provvediment għandha tinkludi mill-inqas l-elementi li ġejjin:

Esportazzjoni tar-repożitorju awtorevoli
Esportazzjoni tar-repożitorju Identity tat-tip “ENUMERATIONS”
Regola ta’ sinkronizzazzjoni
Regola ta’ importazzjoni fir-repożitorju Identity tat-tip “ENUMERATIONS”

Ara l-paġna Ġestjoni tal-konnetturi tal-provvediment awtomatiku biex toħloq konnettur.

Ikkonfigura formula għall-kalkolu ta’ attribut¶

Il-formula għall-kalkolu ta’ attribut tikkorrispondi għal mistoqsija SELECT li se tiġi eżegwita fid-database. L-operazzjoni SELECT m’għandhiex tkun inkluża fil-formula.

Għall-attributi marbuta mat-tip ta’ oġġett identità, il-mistoqsijiet se jiġu eżegwiti fuq tabelli li fihom data tal-identitajiet.

Għall-attributi marbuta mat-tip ta’ oġġett struttura, il-mistoqsijiet se jiġu eżegwiti fuq tabelli li fihom data tal-istrutturi.

Għall-attributi marbuta mat-tip ta’ oġġett allokazzjoni, il-mistoqsijiet se jiġu eżegwiti fuq tabelli li fihom data tal-allokazzjonijiet.

Għall-attributi marbuta mat-tip ta’ oġġett kont, il-mistoqsijiet se jiġu eżegwiti fuq tabelli li fihom data tal-kontijiet.

Mill-verżjoni 7.1 ’il quddiem, id-dipendenzi bejn l-attributi kkalkulati jiġu evalwati fuq it-tipi kollha ta’ oġġetti u wkoll bejn oġġetti differenti: għalhekk, il-modifika ta’ attribut tista’ tiskatta l-kalkolu mill-ġdid ta’ attribut li jappartjeni għal oġġett ieħor. Sal-verżjoni 7.0, dawn id-dipendenzi kienu jiġu kkalkulati biss għall-attributi marbuta mal-identitajiet.

Eżempju

L-attribut tal-kont attribut_C1, marbut mat-tip ta’ kont CT1, għandu l-formula §OWNER§attribut_I1§, fejn attribut_I1 huwa attribut marbut ma’ tip ta’ persuna.

Jekk il-valur ta’ attribut_I1 jiġi mmodifikat għal persuna, u jekk din il-persuna jkollha kont tat-tip CT1, allura l-attribut tal-kont attribut_C1 jiġi kkalkulat mill-ġdid awtomatikament.

Biex tirreferi għal ċerti oġġetti, għandhom jintużaw kliem ewlieni.

Sakemm ma jkunx speċifikat mod ieħor, il-kliem ewlieni li ġej u l-varjazzjonijiet tagħhom jistgħu jintużaw fl-attributi tat-tipi kollha ta’ oġġetti (identità, struttura, allokazzjoni, kont):

§ATTRIBUT§

§ATTRIBUT§[attribute_code]§: jirkupra l-valur tal-attribut li l-kodiċi tiegħu jiġi mgħoddi bħala t-tieni parametru.
§ATTRIBUT§IS_MASTER§: Din il-varjazzjoni tista’ tintuża biss għall-attributi tal-oġġetti tat-tip Identity. Tirkupra l-pożizzjoni tal-identità primarja f’katina ta’ rikonċiljazzjoni. Il-valuri possibbli huma dawn li ġejjin:
- 0: jekk l-identità hija sekondarja f’katina ta’ rikonċiljazzjoni
- 1: jekk l-identità hija primarja f’katina ta’ rikonċiljazzjoni
- 2: jekk l-identità mhijiex f’ebda katina ta’ rikonċiljazzjoni
§ATTRIBUT§[primary_attribute_code].[secondary_attribute_code]§: jippermettilek tirkupra l-valur tal-attribut (sekondarju) marbut mal-oġġett definit minn primary_attribute_code. Dan jista’ jintuża biss għal attributi (primarji) tat-tip Identity, Structure jew Allocation, skont it-tip ta’ oġġett li juża l-formula:
- Identità tista’ tkun marbuta ma’ attributi tat-tip Identity, Structure u Allocation.
- Struttura tista’ tkun marbuta ma’ attributi tat-tip Identity u Allocation.
- Allokazzjoni tista’ tkun marbuta ma’ attributi tat-tip Identity u Structure.
- Kont jista’ jkun marbut ma’ attributi tat-tip Identity, Structure u Allocation.

Huwa possibbli wkoll li tuża din il-varjazzjoni biex tirkupra l-valuri tal-kodiċi, tal-isem jew tad-deskrizzjoni tal-attributi enumerati. F’dan il-każ, il-valur ta’ [secondary_attribute_code] għandu jkun:

+ Code biex tirkupra l-kodiċi tal-enumerazzjoni
+ Name biex tirkupra l-isem tal-enumerazzjoni
+ Description biex tirkupra d-deskrizzjoni tal-enumerazzjoni

    * §ATTRIBUT§[attribute_code].parent§: Varjazzjoni li tintuża biss għall-attributi tat-tip struttura. Tippermettilek tirkupra l-istruttura ġenitur tal-istruttura li tiġi mgħoddija bħala parametru. Huwa possibbli li tuża “.parent” diversi drabi jekk trid titla’ diversi livelli.

§CAMELIZE§: kelma ewlenija li tikteb b’ittra kbira l-ewwel ittra ta’ kull kelma fil-valur ta’ attribut tat-test, u tikteb il-karattri l-oħra b’ittri żgħar. Tieħu post il-funzjoni dbo.fctCamelizeString, deprekata mill-verżjoni 7.1 ’il quddiem u mneħħija mill-verżjoni 7.2 ’il quddiem.
- §CAMELIZE§[attribute_code]§, §CAMELIZE§ATTRIBUT§[attribute_code]§ jew §ATTRIBUT§[attribute_code].camelize()§: tapplika t-trasformazzjoni għall-valur tal-attribut li l-kodiċi tiegħu jiġi mgħoddi bħala parametru.
- §CAMELIZE§OWNER§[attribute_code]§ jew §OWNER§[attribute_code].camelize()§: tapplika t-trasformazzjoni għall-valur tal-attribut irkuprat mill-kelma ewlenija §OWNER§, jiġifieri l-valur tal-persuna primarja tal-katina ta’ rikonċiljazzjoni.
Il-karattri li ġejjin iwasslu għal ittra kbira fuq l-ittra li ssegwihom: l-ispazju, it-trattin “-”, it-tab, ir-ritorn tal-karru jew il-qabża tal-linja, u l-ispazju li ma jinqasamx (NBSP).

Biex tgħaqqad din il-kelma ewlenija ma’ §NORMALIZE§, uża s-sintassi bit-tikek: §ATTRIBUT§[attribute_code].camelize().normalize()§

Din il-kelma ewlenija tista’ tintuża fl-attributi tal-oġġetti identità, struttura, allokazzjoni u kont, kif ukoll fil-politiki tal-login u tal-passwords.
Eżempju
- “jean-pierre” jagħti “Jean-Pierre”
- “martin dupont” jagħti “Martin Dupont”
- il-konkatenazzjoni tal-isem “jean” u tal-kunjom “dupont” tagħti “Jean Dupont”
§COMPTE§: kelma ewlenija li tista’ tintuża biss f’attributi marbuta mat-tip ta’ oġġett identità
- §COMPTE§[account_type_code]§: jippermettilek tirkupra l-login tal-kont, marbut mal-identità li fuqha tiġi eżegwita l-formula, u li t-tip tal-kodiċi tiegħu jiġi mgħoddi bħala t-tieni parametru.
Eżempju: §COMPTE§Account_Type_AD§
§COMPTEUR§
- §COMPTEUR§[counter_code]§: jirkupra l-valur tal-kontatur, miżjud b’unità waħda, li l-kodiċi tiegħu jiġi mgħoddi bħala t-tieni parametru.
Eżempju: §COMPTEUR§External_ID_Number§

§CONTEXT§

§CONTEXT§Code§: jippermettilek tirkupra l-kodiċi tal-kuntest kurrenti.

Eżempju:

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

§ENUM§: kelma ewlenija li tippermettilek timla attribut tat-tip enumerazzjoni mill-kodiċi tiegħu.
- §ENUM§[enum_type_attribute_code]§[secondary_attribute_code]§: jippermettilek timla l-attribut tat-tip enumerazzjoni li l-kodiċi tiegħu huwa ugwali għall-parametru [enum_type_attribute_code] mill-valur tal-attribut li l-kodiċi tiegħu jiġi mgħoddi bħala t-tieni parametru [secondary_attribute_code]. Dan ifisser li t-tieni attribut għandu l-kodiċi ta’ enumerazzjoni bħala l-valur tiegħu.
Din il-varjazzjoni ħafna drabi tintuża meta l-kodiċi ta’ enumerazzjoni jiġi rkuprat minn tabella ta’ korrispondenza.

Eżempju: Fl-attribut bil-kodiċi “Code_grade_table”, il-kodiċi tal-enumerazzjoni tal-grad korrispondenti jiġi kkalkulat minn tabella ta’ korrispondenza. Għandu l-valur GRADE_MANAGER.

Għandek attribut bil-kodiċi “grade”, tat-tip enumerazzjoni, li fih trid tassenja l-valur li jikkorrispondi għall-kodiċi kkalkulat fl-attribut “Code_grade_table”.

Il-formula tiegħek se tkun: §ENUM§grade§Code_grade_table§
- §ENUM§[enum_type_attribute_code].[enumeration_code]§: jippermettilek timla l-attribut tat-tip enumerazzjoni li l-kodiċi tiegħu huwa ugwali għall-parametru [enum_type_attribute_code] bil-kodiċi tal-enumerazzjoni mgħoddi fit-tieni parametru [enumeration_code].
Din il-varjazzjoni ħafna drabi tintuża meta l-valur tal-enumerazzjoni jiġi kkalkulat abbażi tal-valur ta’ attribut ieħor.

Eżempju: Għandek attribut bil-kodiċi “access_type”, li huwa tat-tip enumerazzjoni bil-valuri li ġejjin:
- Code = accès_intranet / Valeur = Intranet
- Code = accès_externe / Valeur = Externe
L-attribut tiegħek għandu jieħu l-valur “Intranet” meta t-tip ta’ persuna jkun ugwali għal “agent” u l-valur “External” meta t-tip ta’ persuna jkun ugwali għal “service provider”.

Il-formula tiegħek se tkun:
1 2 3 4
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§: jirkupra l-valur tal-attribut mgħoddi bħala t-tieni parametru tal-identità li l-UID tagħha huwa speċifikat fl-ewwel parametru. L-UID għandu jiġi mgħoddi bħala valur fiss.
§MAPPING§: kelma ewlenija li tirkupra valuri minn tabelli ta’ korrispondenza abbażi ta’ ċavetta partikolari.
- §MAPPING§[mapping_table_code].[table_key_code]§: jirkupra l-valur jew il-valuri fit-tabella bil-kodiċi [mapping_table_code] u l-valur taċ-ċavetta mgħoddi fit-tieni parametru [table_key_code].
Din il-varjazzjoni ħafna drabi tintuża meta ċ-ċavetta użata tvarja skont il-valur ta’ attribut ieħor.
- §MAPPING§[mapping_table_code]§[secondary_attribute_code]§: jirkupra l-valur jew il-valuri fit-tabella bil-kodiċi [mapping_table_code] mill-valur tal-attribut li l-kodiċi tiegħu jiġi mgħoddi fit-tieni parametru [secondary_attribute_code]. Dan ifisser li t-tieni attribut għandu ċavetta minn tabella ta’ enumerazzjoni bħala l-valur tiegħu.
F’dan il-każ, jekk l-attribut sekondarju jkun tat-tip identità, struttura jew allokazzjoni, huwa possibbli li testendi l-varjazzjoni kif ġej: §MAPPING§[cross-reference_table_code]§[secondary_attribute_code].[tertiary_attribute_code]§. Jiġi rkuprat il-valur tal-attribut [tertiary_attribute_code] marbut mal-attribut [secondary_attribute_code].

Din il-varjazzjoni ħafna drabi tintuża meta ċ-ċavetta ta’ tabella ta’ enumerazzjoni tkun mimlija jew ikkalkulata f’attribut.
§NORMALIZE§: kelma ewlenija li tikteb il-valur ta’ attribut tat-test b’ittri żgħar, tneħħi l-aċċenti u tħassar ċerti karattri speċjali. Tipikament tintuża biex tiġġenera identifikaturi jew logins stabbli minn attributi tat-test, bħall-isem u l-kunjom. Tieħu post il-funzjoni dbo.fctNormalizeString, deprekata mill-verżjoni 7.1 ’il quddiem u mneħħija mill-verżjoni 7.2 ’il quddiem.
- §NORMALIZE§[attribute_code]§, §NORMALIZE§ATTRIBUT§[attribute_code]§ jew §ATTRIBUT§[attribute_code].normalize()§: tapplika t-trasformazzjoni għall-valur tal-attribut li l-kodiċi tiegħu jiġi mgħoddi bħala parametru.
- §NORMALIZE§OWNER§[attribute_code]§ jew §OWNER§[attribute_code].normalize()§: tapplika t-trasformazzjoni għall-valur tal-attribut irkuprat mill-kelma ewlenija §OWNER§, jiġifieri l-valur tal-persuna primarja tal-katina ta’ rikonċiljazzjoni.
Il-karattri aċċentati jiġu sostitwiti bl-ekwivalent mingħajr aċċent tagħhom:
- à á â ã ä å isiru a
- ç isir c
- è é ê ë isiru e
- ì í î ï isiru i
- ñ isir n
- ò ó ô õ ö isiru o
- š isir s
- ù ú û ü isiru u
- ý ÿ isiru y
- ž isir z
Il-karattri speċjali li ġejjin jitħassru: & < > ! % ( ) * + , - . / : ; = ? @ ^ _ { | } ~ € ‚ ¦ [ '

Biex tgħaqqad din il-kelma ewlenija ma’ §CAMELIZE§, uża s-sintassi bit-tikek: §ATTRIBUT§[attribute_code].camelize().normalize()§

Din il-kelma ewlenija tista’ tintuża fl-attributi tal-oġġetti identità, struttura, allokazzjoni u kont, kif ukoll fil-politiki tal-login u tal-passwords.
Eżempju
- “jean-pierre” jagħti “jeanpierre”
- “élodie dupont” jagħti “elodiedupont”
- il-konkatenazzjoni tal-isem “élodie” u tal-kunjom “d'el binde” tagħti “elodiedelbinde”
§PERSON_STATE§: kelma ewlenija li tista’ tintuża biss fl-attribut tas-sistema Status (code=person_status), u li tippermetti li jiġi assenjat valur lil dan l-attribut.
- §PERSON_STATE§[status_code]§: tassenja l-valur li l-kodiċi tiegħu jiġi mgħoddi bħala t-tieni parametru.
§RELATED§: kelma ewlenija li tirkupra l-oġġetti marbuta ma’ oġġett ieħor permezz ta’ attribut. Pereżempju, għal tip ta’ persuna li jġorr attribut tat-tip persuna li fih il-maniġer tal-identità, din il-kelma ewlenija tirkupra, minn identità, il-lista tal-identitajiet kollha li hija timmaniġġja.
- §RELATED§[attribute_code]§[operation]§: [attribute_code] huwa attribut li jorbot entitajiet flimkien, u dawn l-entitajiet huma persuni, strutturi jew allokazzjonijiet. [operation] huwa fakultattiv u jieħu wieħed miż-żewġ valuri li ġejjin:
  - ANY: il-kelma ewlenija tirritorna valur boolean
  - COUNT: il-kelma ewlenija tirritorna numru
Eżempju
- §RELATED§manager§ jirritorna l-lista tal-persuni li l-maniġer tagħhom huwa l-identità li qed tiġi evalwata.
- §RELATED§manager§ANY§ jirritorna “true” jekk l-identità hija l-maniġer ta’ mill-inqas persuna waħda, inkella “false”.
- §RELATED§manager§COUNT§ jirritorna n-numru ta’ persuni li l-maniġer tagħhom huwa l-identità.
Twissija

It-tip tal-attribut li jġorr il-formula għandu jkun adattat għall-użu tal-kelma ewlenija. Pereżempju, biex tirkupra lista ta’ persuni bil-formula §RELATED§manager§, għandek tikkonfigura attribut tat-tip identità b’diversi valuri.

Il-kliem ewlieni li ġej u l-varjazzjonijiet tagħhom jistgħu jintużaw f’attributi relatati mat-tip ta’ oġġett kont:

§RIGHTS§
- §RIGHTS§[right_parameter_code]§: jippermettilek tirkupra valur, kodiċi, status tal-provvediment, status teoretiku, eċċ. (parametru mgħoddi bħala t-tieni parametru, [right_parameter_code]) għall-awtorizzazzjonijiet kollha marbuta mal-kont. Din il-kelma ewlenija għandha tintuża f’attribut b’diversi valuri.
- §RIGHTS. [right_code]§[right_parameter_code]§: jippermettilek tirkupra valur, kodiċi, status tal-provvediment, status teoretiku, eċċ. (parametru mgħoddi bħala t-tielet parametru, [right_parameter_code]) għall-awtorizzazzjoni li l-kodiċi tagħha huwa definit fit-tieni parametru, [right_code]. Il-valur jista’ jkun b’valur wieħed jew b’diversi valuri.
§ROLES§
- §ROLES§[role_parameter_code]$: jirkupra l-isem jew il-kodiċi (parametru mgħoddi bħala t-tieni parametru, [role_parameter_code]) tar-rwoli kollha marbuta mal-kont. Din il-kelma ewlenija għandha tintuża f’attribut b’diversi valuri.
- §ROLES.[role_code]§[role_parameter_code]§: jirkupra l-isem jew il-kodiċi (parametru mgħoddi bħala t-tielet parametru, [role_parameter_code]) tar-rwol li l-kodiċi tiegħu huwa definit fit-tieni parametru, [role_code].
§OWNER§ / §IDENTITIES§
- §OWNER§[attribute_code]§: jirkupra l-valur ta’ attribut li l-kodiċi tiegħu jiġi mgħoddi bħala t-tieni parametru ([attribute_code]) tal-persuna primarja fil-katina ta’ rikonċiljazzjoni, kemm jekk tkun marbuta mal-kont kif ukoll jekk le.
- §IDENTITIES§[attribute_code]§: jirkupra l-valur ta’ attribut li l-kodiċi tiegħu jiġi mgħoddi bħala t-tieni parametru ([attribute_code]) għall-identitajiet kollha marbuta mal-kont, jiġifieri kemm dik primarja kif ukoll dawk sekondarji.
Jekk l-attribut ikun tat-tip identità, struttura jew allokazzjoni, huwa possibbli li testendi l-varjazzjoni kif ġej: §[OWNER/IDENTITIES]§[attribute_code].[secondary_attribute_code]. Jiġi rkuprat il-valur tal-attribut [secondary_attribute_code] marbut mal-attribut [attribute_code].
§CONCAT§ / §MIN§ / §MAX§: kliem ewlieni li jista’ jintuża biss mal-kliem ewlieni §OWNER§ / §IDENTITIES§.
- §CONCAT§[OWNER/IDENTITIES]§[attribute_code].[secondary_attribute_code]§[separator]§: jirkupra sensiela ta’ karattri li l-valur tagħha huwa konkatenazzjoni tal-valur tal-attribut mgħoddi fit-tielet u fir-raba’ parametru ([attribute_code].[secondary_attribute_code]) għall-identitajiet kollha identifikati mit-tieni parametru. Kull valur huwa separat b’karattru speċifikat fil-ħames parametru.
- §MIN§[OWNER/IDENTITIES]§[attribute_code]§: jirkupra l-inqas valur fost il-valuri tal-attribut mgħoddi bħala t-tielet parametru ([attribute_code]) għall-identitajiet kollha identifikati mit-tieni parametru.
- §MAX§[OWNER/IDENTITIES]§[attribute_code]§: jirkupra l-ogħla valur fost il-valuri tal-attribut mgħoddi bħala t-tielet parametru ([attribute_code]) għall-identitajiet kollha identifikati mit-tieni parametru.
§PASSWORD§
- §PASSWORD§[number]§[lowercase]§[uppercase]§[special]§[special_characters_list]§[number_of_characters]§: jippermettilek tiġġenera passwords każwali għall-kontijiet.
  - [number]: jippermettilek tiddefinixxi jekk il-password għandux ikun fiha mill-inqas ċifra waħda. Il-valur 1 jattiva r-restrizzjoni. Biex tiddiżattiva r-restrizzjoni, daħħal il-valur 0.
  - [lowercase]: jippermettilek tiddefinixxi jekk il-password għandux ikun fiha mill-inqas ittra żgħira waħda. Il-valur 1 jattiva r-restrizzjoni. Biex tiddiżattiva r-restrizzjoni, daħħal il-valur 0.
  - [uppercase]: jippermettilek tiddefinixxi jekk il-password għandux ikun fiha mill-inqas ittra kbira waħda. Il-valur 1 jattiva r-restrizzjoni. Biex tiddiżattiva r-restrizzjoni, daħħal il-valur 0.
  - [special]: jippermettilek tiddefinixxi jekk il-password għandux ikun fiha mill-inqas karattru speċjali wieħed. Il-valur 1 jattiva r-restrizzjoni. Biex tiddiżattiva r-restrizzjoni, daħħal il-valur 0.
  - [special_characters_list]: jippermettilek tispeċifika l-karattri speċjali aċċettati mil-lista li ġejja: !#$%&()*+,./:;<>?@[]^_|~.
  - [number_of_characters]: jiddefinixxi n-numru ta’ karattri fil-password.
!!! example "Eżempju" §PASSWORD§1§1§1§1§!#$%&()*+§8§ Din il-linja tiddefinixxi password ta’ 8 karattri li teħtieġ mill-inqas ċifra waħda, mill-inqas ittra żgħira waħda, mill-inqas ittra kbira waħda u mill-inqas karattru speċjali wieħed mil-lista li ġejja: !#$%&()*+
§INDEX_DOUBLON§
- §INDEX_DOUBLON§: iżżid indiċi fil-post fejn il-kelma ewlenija hija pożizzjonata fil-valur tal-attribut.
Twissija

Din il-kelma ewlenija tista’ tintuża biss għall-attributi kkalkulati u biss meta l-għażla ta’ uniċità tkun attivata.
§UNION§
- §UNION§<attribute1>|<attribute2>|...§: jippermettilek tgħaqqad valuri minn diversi attributi f’attribut ieħor.
- §UNION§<attribute1>|<attribute2>|...§<value1>|<value2>|...§: jippermettilek tgħaqqad valuri minn diversi attributi f’attribut ieħor billi tispeċifika valuri fissi.
  - Il-valuri fissi fil-formula jistgħu jieħdu l-forma li ġejja:
    - Għall-attributi booleani: true jew false
      - §UNION§active_person§false§
    - Għall-attributi tat-tip Date: għandu jintuża l-format SQL_DATE_FORMAT_SHORT fit-tabella dbo.CONFIGURATION (b’mod default “yyyy-MM-dd”)
      - §UNION§start_date|end_date§2025-05-15§
    - Għall-attributi tat-tip identità, struttura, riżorsa jew enumerat: għandu jiġi speċifikat l-ID
      - §UNION§manager§1885|1886§
    - Għall-attributi tat-tip sensiela ta’ karattri: mhuwiex possibbli li tinkludi spazji fis-sensiela ta’ karattri, u lanqas li tuża l-karattri | jew §. Il-karattri speċjali aċċettati huma: !#$%&'()*+,./:;<>?@[]^_{}~
      - §UNION§firstname§Jean-Pierre|Marie§
§RANDOM§
- §RANDOM.[object_type]§[code]§: jippermettilek tagħżel b’mod każwali valur minn lista ta’ valuri f’oġġett tat-tip Table de correspondance, énumérations jew attributs multivalués.
  - [object_type] jippermettilek tispeċifika t-tip ta’ oġġett; jista’ jieħu l-valuri li ġejjin:
    - MAPPING għat-tabelli ta’ korrispondenza
    - ENUM għall-attributi enumerati
    - ATTRIBUTE għal attribut b’diversi valuri
  - [code] jippermettilek tispeċifika l-kodiċi tal-attribut jew tal-oġġett mixtieq