> Source: https://docs.cyberelements.io/identity/7.1/mt/UserDocumentation/GeneralConfigurations/AttributeManagement/

# Ġ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”.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_MenuConfigurationDefinitionAttributs.png)

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.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_DefinitionAttributs.png)

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

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_DefinitionAttributsPagination.png)

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.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_DefinitionAttributsRecherche.png)

Biex toħloq attribut ġdid, ikklikkja l-buttuna “![type:inline](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_PictoAjout.png)”.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_DefinitionAttributsAjout.png)

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](#configure-a-formula-for-calculating-an-attribute) 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

  B’mod default, l-attributi murija huma:

  ```
   1
   2
   3
   4
   5
   6
   7
   8
   9
  10
  11
  12
  13
  14
  15
  16
  17
  18
  19
  20
  21
  22
  23
  24
  25
  26
  27
  ```
    - 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
- Validations

  > **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.
    - 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.

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.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/Identity71-AttributeCalculatedFormula.png)

Biex tara u timmodifika attribut, ikklikkja l-ikona “![type:inline](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_PictoConsultation.png)” li tinsab fuq il-lemin fir-ringiela korrispondenti tat-tabella.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_DefinitionAttributsConsultation.png)

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

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_VisualisationDefinitionAttributModifier.png)

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 “![type:inline](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_PictoSuppression.png)” li tinsab fuq il-lemin tar-ringiela korrispondenti tat-tabella.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_DefinitionAttributsSupprimer.png)

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.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_VisualisationDefinitionAttributEnumerePagination.png)

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.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_VisualisationDefinitionAttributEnumereRecherche.png)

Biex iżżid valur ġdid mal-lista tal-attribut enumerat, ikklikkja l-buttuna “![type:inline](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_PictoAjout.png)” li tinsab fit-tabella “Enumerated value list”.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_VisualisationDefinitionAttributEnumereAjout.png)

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.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_AjoutValeurDansAttribut.png)

Biex timmodifika element enumerat, ikklikkja l-ikona “![type:inline](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_PictoModif.png)” li tinsab fuq il-lemin fir-ringiela korrispondenti tat-tabella.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_VisualisationDefinitionAttributEnumereModif.png)

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 “![type:inline](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_PictoSuppression.png)” li tinsab fuq il-lemin tar-ringiela korrispondenti tat-tabella.

![](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_VisualisationDefinitionAttributEnumereSupprimer.png)

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](https://docs.cyberelements.io/identity/7.1/mt/UserDocumentation/AutomaticProvisioningConnectorsManagement/HowDoesSIPProvisioningEngineWork/) 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§

  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:

  ```
  1
  2
  3
  4
  5
  ```
    - §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.
- §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.

  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”
    - §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.
- §COMPTE§: kelma ewlenija li tista’ tintuża biss f’attributi marbuta mat-tip ta’ oġġett identità

  Eżempju: §COMPTE§Account_Type_AD§
    - §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.
- §COMPTEUR§

  Eżempju: §COMPTEUR§External_ID_Number§
    - §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.
- §CONTEXT§

  Eżempju:

  ```
  1
  2
  3
  4
  ```
    - §CONTEXT§Code§: jippermettilek tirkupra l-kodiċi tal-kuntest kurrenti.
- §ENUM§: kelma ewlenija li tippermettilek timla attribut tat-tip enumerazzjoni mill-kodiċi 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§

  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:

  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
  ```
    - §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.
    - §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].
    - Code = accès_intranet / Valeur = Intranet
    - Code = accès_externe / Valeur = Externe
- §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.

  Din il-varjazzjoni ħafna drabi tintuża meta ċ-ċavetta użata tvarja skont il-valur ta’ attribut ieħor.

  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.
    - §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].
    - §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.
- §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.

  Il-karattri aċċentati jiġu sostitwiti bl-ekwivalent mingħajr aċċent tagħhom:

  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”
    - §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.
    - à á â ã ä å isiru a
    - ç isir c
    - è é ê ë isiru e
    - ì í î ï isiru i
    - ñ isir n
    - ò ó ô õ ö isiru o
    - š isir s
    - ù ú û ü isiru u
    - ý ÿ isiru y
    - ž isir z
- §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.

  > **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.
    - §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

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§

  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].
    - §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.
- §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§

  !!! 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: `!#$%&()*+`
    - §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.
- §INDEX_DOUBLON§

  > **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.
    - §INDEX_DOUBLON§: iżżid indiċi fil-post fejn il-kelma ewlenija hija pożizzjonata fil-valur tal-attribut.
- §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
