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

# Bainistíocht na dtréithe

Tá gach cineál oibiachta (aitheantais, struchtúir, leithdháiltí, cuntais) comhdhéanta de thréithe. Is féidir le tréith a bheith de chineálacha éagsúla (teaghrán carachtar, Identity, Allocation, Structure, srl.).

## Tréith a chruthú, a mhodhnú nó a scriosadh

Chun rochtain a fháil ar bhainistíocht na dtréithe, téigh go dtí an roghchlár “Configuration \ Attribute Definition”.

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

Tiocfaidh tú go dtí an chéad chluaisín, “Identity”, ina bhfuil liosta na dtréithe atá ann cheana.

Tá ceithre chluaisín ar an leathanach seo:

- Identity
- Struchtúir
- Leithdháiltí
- Account

I ngach cluaisín, liostaítear na tréithe i dtábla.

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

Tá uimhriú leathanach socraithe chun 10 dtréith amháin a thaispeáint de réir réamhshocraithe, ach is féidir líon na n-earraí a thaispeántar a athrú.

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

Tá réimse cuardaigh ar fáil ag barr an tábla ar dheis. Cuimsíonn an cuardach cóid, ainmneacha agus cur síos na dtréithe.

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

Chun tréith nua a chruthú, cliceáil an cnaipe “![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)

Tá cumraíocht na tréithe roinnte ina trí chuid:

- General
    - Personal data: cuir tic sa bhosca chun an tréith a shainaithint mar shonraí pearsanta. Do thréithe den chineál Identity amháin.
    - Category: Roghnaigh an chatagóir réamhshocraithe ina gcuirfear an tréith. Is féidir leat an chatagóir a athrú do gach cineál oibiachta.
    - Icon name: roghnaigh an deilbhín ó liosta roghanna. Beidh sé le feiceáil i gcomhaid na ndaoine. Roghnach.
    - Icon color: rogha chun dath an deilbhín a shaincheapadh.
    - Code: cód na tréithe. Caithfidh sé a bheith uathúil do gach cineál oibiachta, gan spásanna ná carachtair speisialta. Éigeantach.
    - Name: ainm na tréithe. An lipéad a thaispeánfar i bhfoirmeacha éagsúla an fheidhmchláir. Éigeantach.
    - Description: réimse chun cur síos ar an tréith a iontráil. Roghnach.
    - Data type: roghnaigh ón liosta seo a leanas. Éigeantach.
        - Character string
        - Number
        - Boolean
        - Date
        - Enumerated
        - Identity
        - Organization: rogha chun cineál struchtúir a chur leis, ach ní éigeantach é.
        - Allocation: tá sé éigeantach cineál leithdháilte (acmhainn) a iontráil.
    - Multi-valued: ticbhosca le roghnú más féidir leis an tréith luachanna iolracha a ghlacadh. De réir réamhshocraithe, níl tic sa bhosca.
    - Structure type nó Allocation type: taispeántar é más “Allocation” nó “Structure” an cineál sonraí. Iontráil cineál na hoibiachta atá uait. Riachtanach amháin más Allocation an cineál sonraí.
    - Default value(s): an luach a shannfar de réir réamhshocraithe mura sanntar aon luach don tréith nuair a chruthaítear oibiacht. Ní úsáidtear an luach réamhshocraithe ach le linn an chruthaithe. Roghnach.
    - Formula type: roghnaigh modh ríomha ón liosta seo a leanas más gá an tréith a ríomh:
        - No formula: ní ríomhtar an tréith.
        - Formula calculated once: ní ríomhtar an tréith ach nuair a chruthaítear oibiacht.
        - Formula recalculated if necessary: athríomhtar an tréith nuair a mhodhnaítear tréith spleách (tréith a úsáidtear san fhoirmle). Ó leagan 7.1 ar aghaidh, meastar na spleáchais seo ar gach cineál oibiachta agus idir oibiachtaí éagsúla freisin.
        - Formula recalculated with each modification: athríomhtar an tréith gach uair a nuashonraítear an oibiacht, beag beann ar na spleáchais.
    - Formula: ní mór foirmle a chruthú mura bhfuil an réimse “Calculation mode” socraithe ar “None”. Má tá an réimse “Calculation mode” socraithe ar “None”, ní mór an réimse seo a fhágáil folamh. Féach an chaibidil [Foirmle a chumrú chun tréith a ríomh](#configure-a-formula-for-calculating-an-attribute) le haghaidh chumraíocht na bhfoirmlí.
    - Number of bevel days: slánuimhir a shainíonn fad na tréimhse forluí do luach tréithe. Úsáidtear í chun na húdaruithe a thugann rialacha údaraithe a bhainistiú.
    - Quick search: cuir tic sa bhosca chun cuardaigh ar an tréith a chumasú i mbarra an chuardaigh thapa i dtáblaí na n-oibiachtaí éagsúla (aitheantais, leithdháiltí, struchtúir, cuntais).
    - Advanced search: cuir tic sa bhosca chun ardchuardaigh a chumasú trí na foirmeacha cuardaigh.
    - Use in filters: cuir tic sa bhosca chun an tréith a chur san áireamh sna critéir scagtha. Úsáidtear scagairí tréithe go háirithe i gcuardaigh oibiachtaí, i rialacha údaraithe, i rialacha SoD, i bhfeachtais deimhniúcháin agus i róil Identity. Tarraingíonn an scáileán aird air seo i nóta a deir faoin rogha seo go “significantly impacts the performance of rule calculations”. Ná cuir tic ann ach i gcás tréithe a úsáidtear i scagairí i ndáiríre.
    - Homonym: cuir tic sa bhosca más mian leat go gcuirfí an tréith i gcomparáid nuair a chruthaítear aitheantais de láimh.
- Display format

  De réir réamhshocraithe, seo iad na tréithe a thaispeántar:

  ```
   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: innéacs taispeána réamhshocraithe sna foirmeacha éagsúla (cruthú, amharc, modhnú).
    - Display format: iontráil luach ó liosta dinimiciúil a thógtar de réir an chineáil sonraí:
        - Character string:
            - Default display format: teaghrán carachtar simplí
            - Link display format: teaghrán carachtar arna thiontú ina nasc
        - Boolean:
            - Default display format: 1 nó 0, ag brath ar an luach.
            - Button display format: ligeann sé duit deilbhín agus lipéad a shainiú ag brath ar luach na tréithe. Ligeann sé duit gníomhartha a dhéanamh ar an gcnaipe.
        - Date:
            - Roghnaigh an fhormáid ón liosta: Short date, Medium date, Long date nó Custom (formáid le sainiú leis na carachtair d, M agus y chun laethanta, míonna agus blianta a shainiú faoi seach).
        - Person/allocation/structure
            - Single string
            - Link to object (with logo)
    - Display in results table: ticbhosca chun luach na tréithe a thaispeáint sa tábla ina liostaítear na hoibiachtaí comhfhreagracha.
    - Display index in results table: innéacs taispeána i dtáblaí torthaí na n-oibiachtaí
    - Display as information: Roghnaigh “Displayed” chun an tréith a thaispeáint sa bhosca ag barr ar dheis na n-aitheantas.
        - Displayed
        - Hidden
- Validations

  > **Sampla**
  >
  > - Má tá an rogha uathúlachta socraithe ar “By type”, is féidir le haitheantas “Employee” an luach céanna a bheith aige agus atá ag aitheantas “External” don tréith chéanna. Ní féidir an luach tréithe céanna a bheith ag dhá aitheantas “Employee”.
  > - Má tá an rogha uathúlachta socraithe ar “Complete”, ní féidir le haitheantas “Employee” an luach céanna a bheith aige agus atá ag aitheantas “External” don tréith chéanna.
    - Required: cuir tic más éigeantach an tréith i mód cruthaithe nó i mód modhnaithe.
    - Ag brath ar an gcineál sonraí, is féidir seiceálacha a chumrú:
        - Character string:
            - Minimum length
            - Maximum length
            - Data model: rogha chun Mail nó Custom a roghnú. Leis an dara rogha, ní mór slonn ionadaíochta a scríobh.
        - Number:
        - Minimum value
        - Maximum value
    - Ó SP3 de CyberElements Identity 7.0 i leith, cuireadh rogha uathúlachta leis:
        - None: níl an rogha uathúlachta cumasaithe (luach réamhshocraithe);
        - By type: tá an rogha uathúlachta cumasaithe. Scagfar na luachanna a sheiceáiltear de réir chineál na hoibiachta;
        - Complete: tá an rogha uathúlachta cumasaithe agus ní chuireann sí cineál na hoibiachta san áireamh.

Má ríomhtar tréith, ní mór foirmle a shonrú a chuirfear i bhfeidhm sa chás go dtugann an chéad luach a ríomhtar leis an bpríomhfhoirmle luach atá ann cheana ar ais. Moltar an eochairfhocal §INDEX_DOUBLON§ a úsáid sa dara foirmle chun uathúlacht an luacha a chinntiú.

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

Chun tréith a fheiceáil agus a mhodhnú, cliceáil an deilbhín “![type:inline](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_PictoConsultation.png)” atá ar dheis sa ró comhfhreagrach den tábla.

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

Is féidir leat aistriú go mód eagarthóireachta go díreach ó leathanach amhairc na tréithe.

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

Sa mhód eagarthóireachta, is féidir gach réimse a mhodhnú.

Gníomhartha na gcnaipí sa mhód eagarthóireachta nó sa mhód cruthaithe:

- Cancel: cuireann sé an iontráil reatha ar ceal agus filleann sé ar leathanach liosta na dtréithe.
- Save: Bailíochtaíonn sé an fhoirm agus athraíonn sé an leathanach go dtí an mód amhairc
- Save and quit: bailíochtaítear an fhoirm agus filltear ar leathanach liosta na dtréithe

Chun tréith a scriosadh, cliceáil an deilbhín “![type:inline](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_PictoSuppression.png)” atá ar dheis sa ró comhfhreagrach den tábla.

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

Taispeánfar teachtaireacht dheimhnithe sula scriosfar an tréith.

**Rabhadh**: ní féidir tréith a scriosadh fad atá sí ceangailte le hoibiachtaí.

## Tréith áirimh a líonadh

Is éard is tréith áirimh ann tréith a bhfuil liosta réamhchinnte luachanna aici. Ní mór luach na tréithe a bheith sa liosta le go bhféadfar é a shannadh.

Líontar tréith áirimh tríd an gcomhéadan nó trí nascóir soláthair ionchuir.

**Chun tréith áirimh a líonadh tríd an gcomhéadan**, oscail leathanach cumraíochta na tréithe i mód amhairc.

Réamhlódáiltear liosta na luachanna áirimh i dtábla gan aon scagaire curtha i bhfeidhm, agus taispeántar é ag bun an leathanaigh.

Tá uimhriú leathanach curtha i bhfeidhm chun 10 luach amháin a thaispeáint.

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

Tá réimse cuardaigh ar fáil ag barr an tábla ar dheis. Cuimsíonn an cuardach cóid, ainmneacha nó cur síos na luachanna áirimh, is é sin na réimsí a thaispeántar sa tábla.

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

Chun luach nua a chur le liosta na tréithe áirimh, cliceáil an cnaipe “![type:inline](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_PictoAjout.png)” atá sa tábla “Enumerated value list”.

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

Iontráil faisnéis an luacha áirimh:

- Code: cód an luacha áirimh. Caithfidh sé a bheith uathúil, gan spásanna ná carachtair speisialta. Éigeantach.
- Name: ainm an luacha áirimh. An lipéad a thaispeánfar i bhfoirmeacha éagsúla an fheidhmchláir. Éigeantach.
- Description: réimse inar féidir leat cur síos ar an luach áirimh a iontráil. Roghnach.

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

Chun luach áirimh a mhodhnú, cliceáil an deilbhín “![type:inline](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_PictoModif.png)” atá ar dheis sa ró comhfhreagrach den tábla.

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

Is féidir gach réimse a mhodhnú.

Gníomhartha na gcnaipí sa mhód eagarthóireachta nó sa mhód cruthaithe:

- Cancel: cealaítear an iontráil reatha agus filltear ar leathanach amhairc na tréithe.
- Save: bailíochtaítear an fhoirm agus cuirtear an luach le tábla liosta na luachanna áirimh

Chun iontráil a scriosadh, cliceáil an deilbhín “![type:inline](https://docs.cyberelements.io/identity/7.1/img/Identity/IdU_PictoSuppression.png)” atá ar dheis sa ró comhfhreagrach den tábla.

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

Taispeánfar teachtaireacht dheimhnithe sula scriosfar an luach áirimh.

**Rabhadh**: ní féidir luach áirimh a scriosadh fad atá sé sannta do thréith atá ceangailte le hoibiacht (aitheantas, struchtúr, soláthar nó cuntas).

**Chun tréith áirimh a líonadh trí inneall Systancia Identity Provisioning (SIP)**, ní mór duit nascóir soláthair ionchuir a chruthú: ó fhoinse údarásach sheachtrach, cruthófar, nuashonrófar agus scriosfar i CyberElements Identity na luachanna áirimh a chomhlíonann na rialacha sioncronaithe, de réir na rialacha atá sainithe sna rialacha iompórtála.

Ní mór na heilimintí seo a leanas ar a laghad a bheith sa seicheamh soláthair:

- Easpórtáil den stór údarásach
- Easpórtáil den stór Identity den chineál “ENUMERATIONS”
- Riail sioncrónaithe
- Riail iompórtála sa stór Identity den chineál “ENUMERATIONS”

Féach an leathanach [Bainistíocht na nascóirí soláthair uathoibríocha](https://docs.cyberelements.io/identity/7.1/ga/UserDocumentation/AutomaticProvisioningConnectorsManagement/HowDoesSIPProvisioningEngineWork/) chun nascóir a chruthú.

## Foirmle a chumrú chun tréith a ríomh

Freagraíonn an fhoirmle chun tréith a ríomh do cheist SELECT a rithfear sa bhunachar sonraí. Ní mór gan an oibríocht SELECT féin a chur san fhoirmle.

I gcás tréithe atá ceangailte leis an gcineál oibiachta aitheantais, déanfar na ceisteanna ar tháblaí ina bhfuil sonraí aitheantais.

I gcás tréithe atá ceangailte leis an gcineál oibiachta struchtúir, déanfar na ceisteanna ar tháblaí ina bhfuil sonraí struchtúir.

I gcás tréithe atá ceangailte leis an gcineál oibiachta leithdháilte, déanfar na ceisteanna ar tháblaí ina bhfuil sonraí leithdháilte.

I gcás tréithe atá ceangailte leis an gcineál oibiachta cuntais, déanfar na ceisteanna ar tháblaí ina bhfuil sonraí cuntas.

Ó leagan 7.1 ar aghaidh, meastar na spleáchais idir tréithe ríofa ar gach cineál oibiachta agus idir oibiachtaí éagsúla freisin: dá bhrí sin, is féidir le modhnú tréithe athríomh tréithe atá ag oibiacht eile a spreagadh. Suas go leagan 7.0, níor ríomhadh na spleáchais seo ach i gcás tréithe a bhí ceangailte le haitheantais.

> **Sampla**
>
> Is í §OWNER§attribut_I1§ an fhoirmle atá ag an tréith chuntais `attribut_C1`, atá ceangailte leis an gcineál cuntais `CT1`, áit ar tréith atá ceangailte le cineál duine í `attribut_I1`.
>
> Má mhodhnaítear luach `attribut_I1` do dhuine, agus má tá cuntas den chineál `CT1` ag an duine sin, athríomhtar an tréith chuntais `attribut_C1` go huathoibríoch.

Chun tagairt a dhéanamh d'oibiachtaí áirithe, ní mór eochairfhocail a úsáid.

Mura sonraítear a mhalairt, is féidir na heochairfhocail seo a leanas agus a malairtí a úsáid i dtréithe gach cineál oibiachta (aitheantas, struchtúr, leithdháileadh, cuntas):

- §ATTRIBUT§

  Is féidir an mhalairt seo a úsáid freisin chun luachanna cóid, ainm nó cur síos na dtréithe áirimh a aisghabháil. Sa chás sin, ní mór do luach [secondary_attribute_code] a bheith mar seo a leanas:

  ```
  1
  2
  3
  4
  5
  ```
    - §ATTRIBUT§[attribute_code]§: aisghabhann sé luach na tréithe a gcuirtear a cód ar aghaidh mar an dara paraiméadar.
    - §ATTRIBUT§IS_MASTER§: Ní féidir an mhalairt seo a úsáid ach i dtréithe oibiachtaí den chineál Identity. Aisghabhann sí ionad an phríomhaitheantais i slabhra réitigh. Seo a leanas na luachanna is féidir:
        - 0: má tá an t-aitheantas tánaisteach i slabhra réitigh
        - 1: má tá an t-aitheantas príomha i slabhra réitigh
        - 2: mura bhfuil an t-aitheantas in aon slabhra réitigh
    - §ATTRIBUT§[primary_attribute_code].[secondary_attribute_code]§: ligeann sé duit luach na tréithe (tánaistí) atá ceangailte leis an oibiacht atá sainithe ag primary_attribute_code a aisghabháil. Ní féidir é seo a úsáid ach i gcás tréithe (príomha) den chineál Identity, Structure nó Allocation, ag brath ar chineál na hoibiachta a úsáideann an fhoirmle:
        - Is féidir aitheantas a cheangal le tréithe den chineál Identity, Structure agus Allocation.
        - Is féidir struchtúr a cheangal le tréithe den chineál Identity agus Allocation.
        - Is féidir leithdháileadh a cheangal le tréithe den chineál Identity agus Structure.
        - Is féidir cuntas a cheangal le tréithe den chineál Identity, Structure agus Allocation.
- §CAMELIZE§: eochairfhocal a chuireann ceannlitir ar an gcéad litir de gach focal i luach tréithe téacs, agus a chuireann na carachtair eile i gcás íochtair. Tagann sé in ionad na feidhme `dbo.fctCamelizeString`, atá dímholta ó leagan 7.1 ar aghaidh agus a bhaintear ó leagan 7.2 ar aghaidh.

  Cuireann na carachtair seo a leanas ceannlitir ar an litir a leanann iad: an spás, an fleiscín “-”, an táb, an t-aisfhilleadh carráiste nó an fotha líne, agus an spás neamhbhristeach (NBSP).

  Chun an t-eochairfhocal seo a chomhcheangal le §NORMALIZE§, úsáid comhréir na bponcanna: §ATTRIBUT§[attribute_code].camelize().normalize()§

  Is féidir an t-eochairfhocal seo a úsáid i dtréithe na n-oibiachtaí Identity, Structure, Allocation agus Account, agus freisin i bpolasaithe na n-ainmneacha logála isteach agus na bpasfhocal.

  > **Sampla**
  >
  > - tugann “jean-pierre” an toradh “Jean-Pierre”
  > - tugann “martin dupont” an toradh “Martin Dupont”
  > - tugann comhchaitéiniú an chéad ainm “jean” agus an tsloinne “dupont” an toradh “Jean Dupont”
    - §CAMELIZE§[attribute_code]§, §CAMELIZE§ATTRIBUT§[attribute_code]§ nó §ATTRIBUT§[attribute_code].camelize()§: cuireann sé an claochlú i bhfeidhm ar luach na tréithe a gcuirtear a cód ar aghaidh mar pharaiméadar.
    - §CAMELIZE§OWNER§[attribute_code]§ nó §OWNER§[attribute_code].camelize()§: cuireann sé an claochlú i bhfeidhm ar luach na tréithe a aisghabhann an t-eochairfhocal §OWNER§, is é sin luach phríomhdhuine an tslabhra réitigh.
- §COMPTE§: eochairfhocal nach féidir a úsáid ach i dtréithe atá ceangailte leis an gcineál oibiachta aitheantais

  Sampla: §COMPTE§Account_Type_AD§
    - §COMPTE§[account_type_code]§: ligeann sé duit ainm logála isteach an chuntais a aisghabháil atá ceangailte leis an aitheantas ar a rithtear an fhoirmle, agus a gcuirtear a chineál cóid ar aghaidh mar an dara paraiméadar.
- §COMPTEUR§

  Sampla: §COMPTEUR§External_ID_Number§
    - §COMPTEUR§[counter_code]§: aisghabhann sé luach an áiritheora, méadaithe faoi aonad amháin, a gcuirtear a chód ar aghaidh mar an dara paraiméadar.
- §CONTEXT§

  Sampla:

  ```
  1
  2
  3
  4
  ```
    - §CONTEXT§Code§: ligeann sé duit cód an chomhthéacs reatha a aisghabháil.
- §ENUM§: eochairfhocal a ligeann duit tréith den chineál áirimh a líonadh óna cód.

  Is minic a úsáidtear an mhalairt seo nuair a aisghabhtar cód luacha áirimh ó thábla crostagartha.

  Sampla: Sa tréith a bhfuil an cód “Code_grade_table” aici, ríomhtar cód an luacha áirimh grád chomhfhreagraigh ó thábla crostagartha. Is é GRADE_MANAGER a luach.

  Tá tréith agam a bhfuil an cód “grade” aici, den chineál áirimh, inar mian liom an luach a shannadh a fhreagraíonn don chód a ríomhtar sa tréith “Code_grade_table”.

  Beidh m'fhoirmle mar seo: §ENUM§grade§Code_grade_table§

  Is minic a úsáidtear an mhalairt seo nuair a ríomhtar luach an luacha áirimh bunaithe ar luach tréithe eile.

  Sampla: Tá tréith agam a bhfuil an cód “access_type” aici, atá den chineál áirimh, agus a bhfuil na luachanna seo a leanas aici:

  Ní mór don tréith agam an luach “Intranet” a ghlacadh nuair is ionann an cineál duine agus “agent”, agus an luach “External” nuair is ionann an cineál duine agus “service provider”.

  Beidh m'fhoirmle mar seo:

  ```
  1
  2
  3
  4
  ```
    - §ENUM§[enum_type_attribute_code]§[secondary_attribute_code]§: ligeann sé duit an tréith den chineál áirimh a bhfuil a cód cothrom leis an bparaiméadar [enum_type_attribute_code] a líonadh ó luach na tréithe a gcuirtear a cód ar aghaidh mar an dara paraiméadar [secondary_attribute_code]. Ciallaíonn sé seo go bhfuil cód luacha áirimh mar luach ag an dara tréith.
    - §ENUM§[enum_type_attribute_code].[enumeration_code]§: ligeann sé duit an tréith den chineál áirimh a bhfuil a cód cothrom leis an bparaiméadar [enum_type_attribute_code] a sholáthar leis an gcód áirimh a chuirtear ar aghaidh sa dara paraiméadar [enumeration_code].
    - Code = accès_intranet / Valeur = Intranet
    - Code = accès_externe / Valeur = Externe
- §IDENTITY§
    - §IDENTITY§uid_identity§attribute_code§: aisghabhann sé luach na tréithe a chuirtear ar aghaidh mar an dara paraiméadar den aitheantas a bhfuil a UID sonraithe sa chéad pharaiméadar. Ní mór an UID a chur ar aghaidh mar luach crua-chódaithe.
- §MAPPING§: eochairfhocal a aisghabhann luachanna ó tháblaí mapála bunaithe ar eochair ar leith.

  Is minic a úsáidtear an mhalairt seo nuair a bhíonn an eochair a úsáidtear éagsúil ag brath ar luach tréithe eile.

  Sa chás sin, más den chineál aitheantais, struchtúir nó leithdháilte an tréith thánaisteach, is féidir an mhalairt a leathnú mar seo a leanas: §MAPPING§[cross-reference_table_code]§[secondary_attribute_code].[tertiary_attribute_code]§. Aisghabhtar luach na tréithe [tertiary_attribute_code] atá ceangailte leis an tréith [secondary_attribute_code].

  Is minic a úsáidtear an mhalairt seo nuair a líontar nó a ríomhtar eochair tábla mapála i dtréith.
    - §MAPPING§[mapping_table_code].[table_key_code]§: aisghabhann sé an luach nó na luachanna sa tábla a bhfuil an cód [mapping_table_code] aige agus a bhfuil an luach eochrach a chuirtear ar aghaidh sa dara paraiméadar [table_key_code] aige.
    - §MAPPING§[mapping_table_code]§[secondary_attribute_code]§: aisghabhann sé an luach nó na luachanna sa tábla a bhfuil an cód [mapping_table_code] aige ó luach na tréithe a gcuirtear a cód ar aghaidh sa dara paraiméadar [secondary_attribute_code]. Ciallaíonn sé seo go bhfuil eochair ó thábla mapála mar luach ag an dara tréith.
- §NORMALIZE§: eochairfhocal a chuireann luach tréithe téacs i gcás íochtair, a bhaineann na haiceanna agus a scriosann carachtair speisialta áirithe. Úsáidtear go hiondúil é chun aitheantóirí cobhsaí nó ainmneacha logála isteach a ghiniúint ó thréithe téacs, amhail an chéad ainm agus an sloinne. Tagann sé in ionad na feidhme `dbo.fctNormalizeString`, atá dímholta ó leagan 7.1 ar aghaidh agus a bhaintear ó leagan 7.2 ar aghaidh.

  Cuirtear a gcomhionann gan aiceann in ionad na gcarachtar a bhfuil aiceann orthu:

  Scriostar na carachtair speisialta seo a leanas: `& < > ! % ( ) * + , - . / : ; = ? @ ^ _ { | } ~ € ‚ ¦ [ '`

  Chun an t-eochairfhocal seo a chomhcheangal le §CAMELIZE§, úsáid comhréir na bponcanna: §ATTRIBUT§[attribute_code].camelize().normalize()§

  Is féidir an t-eochairfhocal seo a úsáid i dtréithe na n-oibiachtaí Identity, Structure, Allocation agus Account, agus freisin i bpolasaithe na n-ainmneacha logála isteach agus na bpasfhocal.

  > **Sampla**
  >
  > - tugann “jean-pierre” an toradh “jeanpierre”
  > - tugann “élodie dupont” an toradh “elodiedupont”
  > - tugann comhchaitéiniú an chéad ainm “élodie” agus an tsloinne “d'el binde” an toradh “elodiedelbinde”
    - §NORMALIZE§[attribute_code]§, §NORMALIZE§ATTRIBUT§[attribute_code]§ nó §ATTRIBUT§[attribute_code].normalize()§: cuireann sé an claochlú i bhfeidhm ar luach na tréithe a gcuirtear a cód ar aghaidh mar pharaiméadar.
    - §NORMALIZE§OWNER§[attribute_code]§ nó §OWNER§[attribute_code].normalize()§: cuireann sé an claochlú i bhfeidhm ar luach na tréithe a aisghabhann an t-eochairfhocal §OWNER§, is é sin luach phríomhdhuine an tslabhra réitigh.
    - athraítear à á â ã ä å go a
    - athraítear ç go c
    - athraítear è é ê ë go e
    - athraítear ì í î ï go i
    - athraítear ñ go n
    - athraítear ò ó ô õ ö go o
    - athraítear š go s
    - athraítear ù ú û ü go u
    - athraítear ý ÿ go y
    - athraítear ž go z
- §PERSON_STATE§: eochairfhocal nach féidir a úsáid ach sa tréith chórais Status (code=person_status), agus a ligeann luach a shannadh don tréith seo.
    - §PERSON_STATE§[status_code]§: sannann sé an luach a gcuirtear a chód ar aghaidh mar an dara paraiméadar.
- §RELATED§: eochairfhocal a aisghabhann na hoibiachtaí atá ceangailte le hoibiacht eile trí thréith. Mar shampla, i gcás cineál duine a bhfuil tréith de chineál duine aige ina bhfuil bainisteoir an aitheantais, aisghabhann an t-eochairfhocal seo, ag tosú ó aitheantas, liosta na n-aitheantas go léir a bhainistíonn sé.

  > **Sampla**
  >
  > - Tugann §RELATED§manager§ ar ais liosta na ndaoine a bhfuil an t-aitheantas atá á mheas ina bhainisteoir acu.
  > - Tugann §RELATED§manager§ANY§ “true” ar ais más bainisteoir ar dhuine amháin ar a laghad é an t-aitheantas, agus “false” murab ea.
  > - Tugann §RELATED§manager§COUNT§ ar ais líon na ndaoine a bhfuil an t-aitheantas ina bhainisteoir acu.

  > **Rabhadh**
  >
  > Ní mór cineál na tréithe a iompraíonn an fhoirmle a bheith oiriúnach d'úsáid an eochairfhocail. Mar shampla, chun liosta daoine a aisghabháil leis an bhfoirmle §RELATED§manager§, ní mór duit tréith illuachach den chineál aitheantais a chumrú.
    - §RELATED§[attribute_code]§[operation]§: is tréith í [attribute_code] a cheanglaíonn eintitis le chéile, agus is daoine, struchtúir nó leithdháiltí iad na heintitis sin. Tá [operation] roghnach agus glacann sé ceann den dá luach seo a leanas:
        - ANY: tugann an t-eochairfhocal luach Boole ar ais
        - COUNT: tugann an t-eochairfhocal uimhir ar ais

Is féidir na heochairfhocail seo a leanas agus a malairtí a úsáid i dtréithe a bhaineann leis an gcineál oibiachta cuntais:

- §RIGHTS§
    - §RIGHTS§[right_parameter_code]§: ligeann sé duit luach, cód, stádas soláthair, stádas teoiriciúil, srl. (paraiméadar a chuirtear ar aghaidh mar an dara paraiméadar, [right_parameter_code]) a aisghabháil do gach údarú atá ceangailte leis an gcuntas. Ní mór an t-eochairfhocal seo a úsáid i dtréith illuachach.
    - §RIGHTS. [right_code]§[right_parameter_code]§: ligeann sé duit luach, cód, stádas soláthair, stádas teoiriciúil, srl. (paraiméadar a chuirtear ar aghaidh mar an tríú paraiméadar, [right_parameter_code]) a aisghabháil don údarú a bhfuil a chód sainithe sa dara paraiméadar, [right_code]. Is féidir leis an luach a bheith aonluachach nó illuachach.
- §ROLES§
    - §ROLES§[role_parameter_code]$: aisghabhann sé ainm nó cód (paraiméadar a chuirtear ar aghaidh mar an dara paraiméadar, [role_parameter_code]) gach róil atá ceangailte leis an gcuntas. Ní mór an t-eochairfhocal seo a úsáid i dtréith illuachach.
    - §ROLES.[role_code]§[role_parameter_code]§: aisghabhann sé ainm nó cód (paraiméadar a chuirtear ar aghaidh mar an tríú paraiméadar, [role_parameter_code]) an róil a bhfuil a chód sainithe sa dara paraiméadar, [role_code].
- §OWNER§ / §IDENTITIES§

  Más den chineál aitheantais, struchtúir nó leithdháilte an tréith, is féidir an mhalairt a leathnú mar seo a leanas: §[OWNER/IDENTITIES]§[attribute_code].[secondary_attribute_code]. Aisghabhtar luach na tréithe [secondary_attribute_code] atá ceangailte leis an tréith [attribute_code].
    - §OWNER§[attribute_code]§: aisghabhann sé luach tréithe a gcuirtear a cód ar aghaidh mar an dara paraiméadar ([attribute_code]) de chuid phríomhdhuine an tslabhra réitigh, cibé acu atá an duine sin ceangailte leis an gcuntas nó nach bhfuil.
    - §IDENTITIES§[attribute_code]§: aisghabhann sé luach tréithe a gcuirtear a cód ar aghaidh mar an dara paraiméadar ([attribute_code]) do gach aitheantas atá ceangailte leis an gcuntas, is é sin na haitheantais phríomha agus thánaisteacha araon.
- §CONCAT§ / §MIN§ / §MAX§: eochairfhocail nach féidir a úsáid ach leis na heochairfhocail §OWNER§ / §IDENTITIES§.
    - §CONCAT§[OWNER/IDENTITIES]§[attribute_code].[secondary_attribute_code]§[separator]§: aisghabhann sé teaghrán carachtar arb é a luach comhchaitéiniú luach na tréithe a chuirtear ar aghaidh sa 3ú agus sa 4ú paraiméadar ([attribute_code].[secondary_attribute_code]) do gach aitheantas a shainaithnítear leis an dara paraiméadar. Scartar na luachanna ó chéile le carachtar a shonraítear sa chúigiú paraiméadar.
    - §MIN§[OWNER/IDENTITIES]§[attribute_code]§: aisghabhann sé an luach is ísle i measc luachanna na tréithe a chuirtear ar aghaidh mar an tríú paraiméadar ([attribute_code]) do gach aitheantas a shainaithnítear leis an dara paraiméadar.
    - §MAX§[OWNER/IDENTITIES]§[attribute_code]§: aisghabhann sé an luach is airde i measc luachanna na tréithe a chuirtear ar aghaidh mar an tríú paraiméadar ([attribute_code]) do gach aitheantas a shainaithnítear leis an dara paraiméadar.
- §PASSWORD§

  !!! example "Sampla" `§PASSWORD§1§1§1§1§!#$%&()*+§8§` Sainíonn an líne seo pasfhocal ocht gcarachtar a éilíonn uimhir amháin ar a laghad, litir chás íochtair amháin ar a laghad, litir chás uachtair amháin ar a laghad agus carachtar speisialta amháin ar a laghad ón liosta seo a leanas: `!#$%&()*+`
    - §PASSWORD§[number]§[lowercase]§[uppercase]§[special]§[special_characters_list]§[number_of_characters]§: ligeann sé duit pasfhocail randamacha a ghiniúint do chuntais.
        - [number]: ligeann sé duit a shainiú an gcaithfidh uimhir amháin ar a laghad a bheith sa phasfhocal. Cumasaíonn an luach 1 an srian. Chun an srian a dhíchumasú, iontráil an luach 0.
        - [lowercase]: ligeann sé duit a shainiú an gcaithfidh litir chás íochtair amháin ar a laghad a bheith sa phasfhocal. Cumasaíonn an luach 1 an srian. Chun an srian a dhíchumasú, iontráil an luach 0.
        - [uppercase]: ligeann sé duit a shainiú an gcaithfidh litir chás uachtair amháin ar a laghad a bheith sa phasfhocal. Cumasaíonn an luach 1 an srian. Chun an srian a dhíchumasú, iontráil an luach 0.
        - [special]: ligeann sé duit a shainiú an gcaithfidh carachtar speisialta amháin ar a laghad a bheith sa phasfhocal. Cumasaíonn an luach 1 an srian. Chun an srian a dhíchumasú, iontráil an luach 0.
        - [special_characters_list]: ligeann sé duit na carachtair speisialta atá ceadaithe a shonrú ón liosta seo a leanas: `!#$%&()*+,./:;<>?@[]^_|~`.
        - [number_of_characters]: sainíonn sé líon na gcarachtar sa phasfhocal.
- §INDEX_DOUBLON§

  > **Rabhadh**
  >
  > Ní féidir an t-eochairfhocal seo a úsáid ach i gcás tréithe ríofa, agus sin amháin nuair atá an rogha uathúlachta cumasaithe.
    - §INDEX_DOUBLON§: cuireann sé innéacs leis san áit a bhfuil an t-eochairfhocal suite i luach na tréithe.
- §UNION§
    - §UNION§<attribute1>|<attribute2>|...§: ligeann sé duit luachanna ó roinnt tréithe a chomhchaitéiniú i dtréith eile.
    - §UNION§<attribute1>|<attribute2>|...§<value1>|<value2>|...§: ligeann sé duit luachanna ó roinnt tréithe a chomhchaitéiniú i dtréith eile trí luachanna seasta a shonrú.
        - Is féidir na foirmeacha seo a leanas a bheith ar na luachanna crua-chódaithe san fhoirmle:
            - I gcás tréithe Boole: true nó false
                - §UNION§active_person§false§
            - I gcás tréithe dáta: ní mór an fhormáid `SQL_DATE_FORMAT_SHORT` sa tábla dbo.CONFIGURATION a úsáid (“yyyy-MM-dd” de réir réamhshocraithe)
                - §UNION§start_date|end_date§2025-05-15§
            - I gcás tréithe den chineál struchtúir, acmhainní nó áirimh: ní mór an ID a shonrú
                - §UNION§manager§1885|1886§
            - I gcás tréithe den chineál teaghrán carachtar: ní féidir spásanna a chur i dteaghráin charachtar, ná na carachtair `|` nó `§` a úsáid. Seo iad na carachtair speisialta atá ceadaithe: !#$%&'()*+,./:;<>?@[]^_{}~
                - §UNION§firstname§Jean-Pierre|Marie§
- §RANDOM§
    - §RANDOM.[object_type]§[code]§: ligeann sé duit luach a roghnú go randamach ó liosta luachanna in oibiacht den chineál `Table de correspondance`, `énumérations` nó `attributs multivalués`.
        - Ligeann [object_type] duit cineál na hoibiachta a shonrú; is féidir leis na luachanna seo a leanas a ghlacadh:
            - MAPPING do tháblaí mapála
            - ENUM do thréithe áirimh
            - ATTRIBUTE do thréith illuachach
        - Ligeann [code] duit cód na tréithe nó na hoibiachta atá uait a shonrú
