Registr uživatelů users-register

Označuje typ dokumentu jako registr uživatelů. Takto označený dokument musí v rámci aplikace vždy existovat právě a pouze jeden. Na toto nastavení navazuje mapování prvku toto typu dokumentů pomocí vl. mapp-to-user.

V každé aplikaci je třeba pomocí XDS definovat právě jeden dokument označený jako registr uživatelů. Jde o schopnost systému flexideo evidovat uživatele jež se do něj přihlašují a nastavovat jejich možnosti. Dále tento dokument znažně rozšiřuje potenciál využití přístupové filtrace položek pro určité okruhy uživatelů (parametr admin-filter). Je tedy zapotřebí, aby byl jeden dokument v rámci definice (či více definic - je-li XDS pro aplikaci rozděleno do více souborů) měl parametr users-regisrer = true. Pro názornost ukážeme příklad definování dokumentu "Uživatel". Tento dokument se však může jmenovat jakkoli jinak (dle potřeby). Důležité je, aby měl definovánu popisovanou vlastnost na hodnotu true:

<DocumentDef>
  <`label`>Uživatel</`label`>
  <`name`>uzivatel</`name`>
  <`descr`>Dokument pro evidenci uživatelů systému flexideo.</`descr`>
  <`group`>kontakty</`group`>
  <`icon`>osoba.png</`icon`>
  <`users-register`>true</`users-register`>
  <content>
   <area `label`="Základní údaje">
    <element `label`="Jméno uživatele" `mapp-to-user`="Display`name`" `data`="type:varchar; max-length: 256;" `input`="type:field;length:50;"/>
    <element `label`="ID uživatele" `mapp-to-user`="UserID" `data`="type:varchar; max-length: 32;" `input`="type:field;length:10;"/>
    <element `label`="Č. role" `mapp-to-user`="Role" `data`="type: number; total-digits: 7;"/>
   </area>
   <area `label`="Ostatní údaje" name="ostatni">
    <element `label`="e-mail" `mapp-to-user`="Email" `data`="type:varchar; max-length: 256;" `input`="type:field;length:50;"/>
    <element `label`="Synchronizace Exchange" `initial`="true" `mapp-to-user`="Sync" `data`="type:boolean;"/>
   </area>
   <area `label`="Zařazení" `source`="`foreign`: kontakt: /pro_uzivatele"/>
  </content>
  <services/>
</DocumentDef>

Všiměte si důležité vlastnosti mapp-to-user. Jde o vyznačení vlastností v dokumentu uživatele, které jsou využívány systémem flexideo pro účely práce s uživateli obecně (více. viz popis vlastnosti mapp-to-user).

V dokumentu, který je označen jako registr uživatelů musí být uvedeny alespoň povinně mapované typy. Na druhou stranu ne všechny instance dokumentu pro evidenci uživatelů musejí být uživatelé. V praxi můžete mít pro aplikaci definován jediný dokument pro evidenci kontaktů, který většinou příhodně nazvete "Kontakt" a tento dokument zároveň můžete označit jako registr uživatelů. Tento dokument, je-li tak navržen, může sloužit pro evidenci všech osob, firem a jiných subjektů vč. osob - uživatelů. Pak to, zda je určitá instance takového typu zároveň i uživatelem určuje vyplnění klíčové kolonky namapované jako userid. Vyplněním dojde k synchronizaci na vnitřní registr uživatelů a doplní se i ostatní mapované kolonky. A naopak. Je-li v systému zaveden nový uživatel jinak, než přes výše zmíněný dokument kontakt, bude přidána nová instance tohoto dokumentu s vyplněním všech mapovaných kolonek. Velmi silně se však doporučuje - zejména z důvodů obecné přístupnosti kontaktů a oporoti tomu jen omezené přístupnosti k uživatelům - tento koncept jediného dokumentu kontakt nevyužívat a pro uživatele zvolit samostatný dokumentový typ.

Potenciální vlastnické uzly

Vlastnost users-register je možné uvést u následujících uzlů:

DocumentDef - dokument nebo šablona d. (kmenová definice) - jako parametr;

Potenciální vlastnické uzly​

Vlastnost users-register users-register​

Potenciální vlastnické uzly

Vlastnost users-register users-register