# Webová služba Rights verze 3.0.0 (Obecné webové služby) - popis rozhraní služby

Marbes Consulting s.r.o.

EOS4

Vygenerováno z verze 4.21.0.19.0.

Podmínky omezující zveřejnění

Autorem tohoto dokumentu je společnost MARBES CONSULTING s.r.o. Dokument obsahuje informace důvěrného charakteru a ve smyslu definice autorského práva (viz § 2, odst. 1 Zákona č. 121/2000 Sb., zákon o právu autorském) je duševním vlastnictvím autora a předmětem práva autorského. Dokument smí být použit výhradně za účelem, za kterým byl poskytnut a nesmí být bez předchozího souhlasu autora citován, kopírován, vytěžován1 nebo předán třetí fyzické či právnické osobě.

© 2009 MARBES CONSULTING s.r.o.

1 Vytěžováním se podle zákona č. 121/2000 Sb. rozumí trvalý nebo dočasný přepis celého obsahu nebo jeho podstatné části na jiný podklad, a to jakýmikoli prostředky nebo jakýmkoli způsobem.

## Obsah

- Obecné informace
- Seznam poskytovaných metod
- Seznam struktur dat
- Výjimky
- Popis poskytovaných metod
- Popis struktur dat

## Obecné informace

Rozhraní umožňuje číst oprávnění.

### Vysvětlení pojmů

- Prvek organizační struktury - organizačí jednotka, organizační role, skupinová role nebo zařazení osoby do organizační nebo skupinové role
- Role - organizační role a skupinová role
- Agenda - obecné označení prvku stromu agend, může reprezentovat agendu, činnost, roli v agendě nebo jiný uživatelský typ, který bude definován ve stromu agend, základní typy lze zjistit z atributu typeCode u agendy
- Osoba - reprezentuje skutečnou evidovanou osobu, osoba může mít více zařazení, ale na ty není brán zřetel
- Osoba v zařazení - reprezentuje konkrétní osobu zařazenou do konkrétní role (organizační nebo skupinové)
- Primární zařazení - jedná se o zařazení osoby do role, které má nejvyšší hodnotu obsazení. Osoba nemusí mít primární zařazení pokud není nikam zařazená, nebo má více zařazení se stejnou hodnotou obsazení.
- Strom organizačních rolí - strom nadřízenosti a podřízenosti organizačních rolí
- Aplikace - aplikace evidovaná v EOS, součástí aplikace je seznam atributů
- Atribut - patří k aplikaci a definuje typy oprávnění, např. jednotlivé úrovně řízení aplikace jako je přístup k webovým službám, typy dokumentů pro přístup, zda se jedná o adminstrátora atp.
- Hodnota oprávnění - konkrétní přiřazená hodnota oprávnění pro daný atribut, např. true pro atribut administrátor, výčet konkrétních přiřazených typů dokumentů pro atribut typů dokumentů atp.
- Response filter - jedná se o objekt, který uvádí, jaká data se mají ve výstupních objektech vracet, např. pokud externí systém "zajímají" pouze základní údaje, nemusí EOS vracet další rozšiřující data, např. seznam kontaktů k osobě, když nás zajímá pouze seznam osob atp. Pokud není uveden, vrací se pouze základní data k objektu.
- Session id - jedná se i identifikátor připojení k serveru a v tuto chvíli není povinný. Tento identifikátor lze získat webovou službou pro otevárání session. V novějších verzích bude vhodné session využít pro případ, kdy bude vyžadováno čtení dat s určitými vlastnostmi, např. dat z historie atp.

### Stránkování

Pokud metoda vrací seznam objektů, může být výsledný vracený seznam stránkovaný. Informaci o stránkování obsahuje atribut paging, ve kterém se nachází i informace, zda server uchovává další data (existuje další stránka). Vychozí velikost jedné stránky je 500 záznamů. Objekt paging obsahuje identifikátor seznamu dat (lid) a ten je nutné předat do metody, která načte další stránku (typický název metody je getNextXxx).

#### Důležité upozornění

Při načítání stránkovaného seznamu nemusí vždy odpovídat počet vrácených záznamů parametru totalCount, který je uveden v objektu paging. Toto se projeví pouze v případě, že jsou během stránkovaného načítání některé vracené objekty z EOS odstraněny.

### Filtrování

Některé metody podporují filtrování dat, např. načtení seznamu aplikací. Filtr se předává formou řetězce, ve kterém je zapsána podmínka. Podmínku lze použít POUZE na základní atributy vracených objektů. Podmínku nelze tedy použít na další vnořené hodnoty, např. kontakty osoby. Pro tento účel existují samostatné metody.

#### Možnosti filtrování

Podmínky u filtrů je možné sestavovat pouze stylem ATRIBUT OPERÁTOR HODNOTA, nelze tedy např. porovnávat dva atributy navzájem. Řetězcová hodnota se VŽDY uvádí v apostrofech (jinak bude chybně chápána jako název atributu a bude vyhozena chyba), pokud hodnota obsahuje apostrof, musí být znak zapsán jako dva apostrofy ''. U operátorů like a ilike je možné použít znak %, který nahrazuje žádný nebo libovolný počet znaků. Znak % lze používat pouze na začátku a konci hodnoty. Pokud je potřeba zapsat hodnotu null, je zapsána bez uvozovek. Datum je nutné zapsat ve formátu: `dd.MM.yyyy HH:mm:ss.SSS` nebo zkráceně bez času `dd.MM.yyyy`. Pro boolean hodnoty se uvádí hodnota 'true' nebo 1 pro true a 'false' nebo 0 pro false, textové reprezentace musí být uvedeny v apostrofech.

Podmínky jsou omezeny na počet porovnávaných hodnot. U výrazu `jmeno = 'petr' and id in ('1', '2', '3')` je počet podmínek 4. Maximální bezpečný počet je 1000, ale EOS toto nijak nekontroluje. Při použití vyššího počtu může, ale nemusí dotaz projít. Toto je z důvodu, že EOS do některých dotazů přidává vlastní podmínky a tudíž se může stát, že bude překročen limit DB serveru na velikost podmínky.

#### Operátory

- = - operátor nelze použít na hodnotu null
- is null - test null hodnoty
- is not null - test na ne-null hodnotu
- <> - operátor nelze použít na hodnotu null
- <
- >
- <=
- >=
- like - u operátoru lze použít znak %, ale pouze na začátku a na konci
- ilike - u operátoru lze použít znak %, ale pouze na začátku a na konci

#### Operandy

- and
- or

#### Příklad filtru

Příklad zapsání filtru na osoby, jejichž uživatelské jméno je "kolomaznik" a titul začíná na 'i': `username = "kolomaznik" and degreeBefore ilike 'i%'`

##### Příklad načtení seznamu všech aplikací

     EosApplications apps = WS.findApplicationsByFilter(sid, null, null);
     // Zpracování aplikací ...
     while (apps.getPaging().getNext()) {
       apps = WS.getNextApplications(apps.getPaging().getLid());
       // Zpracování aplikací ...
     }

Seznam atributů dle kterých lze filtrovat osoby:

- id - identifikátor osoby
- degreeBefore - titul před jménem
- firstname1 - první křestní jméno
- firstname2 - druhé křestní jméno
- surname1 - první příjmení
- surname2 - druhé příjmení
- degreeAfter - titul za jménem
- signature - iniciály
- abbrev - zkratka pracovníka
- userName - přihlašovací jméno osoby
- displayName - zobrazované jméno osoby
- passwordChangeRequested - příznak, jestli si uživatel musí změnit heslo (true/false)
- personalNumber - osobní číslo
- entranceDate - datum nástupu
- terminationDate - datum ukonční
- email - email osoby
- locked - příznak uzamčení osoby v Active Directory (true/false)
- disabled - příznak zakázání osoby v Active Directory (true/false)
- publicable - příznak jestli osobu zobrazovat na internetu (true/false)
- loginEnabled - informace jestli se může osoba přihlásit do EOSu (true/false)

## Seznam poskytovaných metod

Název | Popis
--- | ---
findApplicationsByFilter | Hledání aplikací podle předaného filtru.
findApplicationsByIds | Hledání aplikací podle předaného seznamu id.
findPersonsRoleActProfile | Získání osob podle zadaného filtru.
getApplicationsWithoutEnvironment | Načte senzam aplikací, které nejsou v žádném prostředí.
getEnvironmentApplications | Načtení aplikací, které jsou v daném prostředí.
getNextApplications | Načtení další části stránkovaného seznamu aplikací.
getNextPersonsRoleActProfile | Načte další seznam osob získaný dle filtru z {@link #findPersonsRoleActProfile(String, String)}.
getPersonApplications | Načtení aplikací, které jsou dostupné pro danou osobu nebo osobu v zařazení nebo osobu v primárním zařazení.
placePersonAttributeValue | Přiřadí hodnotu atributu na osobu.
placePersonAttributeValues | Přiřadí hodnoty atributu na osobu.

## Seznam struktur dat

Název | Popis
--- | ---
Cz.marbes.eos4.module.ws.v3.rights.wo.WOAttributeValue | Objekt reprezentuje hodnotu atributu (oprávnění).
Cz.marbes.eos4.module.ws.v3.rights.wo.WOAttributeValues | Objekt obsahující seznam hodnot atributů aplikace.
Cz.marbes.eos4.module.ws.v3.rights.wo.types.WOAttributeType | Typ atributu aplikace.
EosApplication | Object reprezentuje aplikaci.
EosApplicationIds | Objekt obsahující seznam identifikátorů aplikací.
EosApplicationRespFilter | Objekt definuje rozsah dat, které se budou u aplikací plnit.
EosApplications | Objekt obsahující seznam aplikací.
EosAttribute | Objekt reprezentuje atribut aplikace.
EosAttributes | Objekt obsahující seznam atributů.
EosEnvironment | Prostředí do kterého je přiřazena aplikace.
EosEnvironments | Obsahuje seznam prostředí v kterých se nachází aplikace.
EosIds | Objekt obsahující seznam id.
EosPaging | Objekt obsahující informace pro stránkování.
EosPerson | Osobu.
EosPersonRoleActProfile | WOObjekt obsahující detail osoby spolu s přiřazenými profily a agendami.
EosPersonRoleActProfiles | WO objekt obsahující seznam osob s jejich agendami a profily.
EosRoleActivities | WO objekt obsahující seznam agend.
EosRoleActivity | WO objekt agendy.
EosRoleIdType | Typ role.

## Výjimky

### EosIllegalArgumentException

Byl předán nevalidní vstupní argument do metody webové služby.

### EosInternalException

Reprezentuje neočekávanou výjimku při volání WS. Jejím zdrojem musí být vždy jiná výjimka.

### EosListNotFoundException

### EosNoPrimaryAssignmentException

Osoba nemá žádné primární zařazení.

### EosObjectNotFoundException

Objekt nebyl nalezen.

### EosSessionNotFoundException

Session s předaným id nebyla nalezena.

## Popis poskytovaných metod

### findApplicationsByFilter

Hledání aplikací podle předaného filtru.

#### Předpis

EosApplications findApplicationsByFilter (String sid, String filter, EosApplicationRespFilter respFilters)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
filter | String | Ne | filtr na aplikace, pokud není uveden, vrací se všechny aplikace
respFilters | EosApplicationRespFilter | Ne | response filtr

#### Výstup

EosApplications - seznam aplikací dle předaného filtru

#### Výjimky

EosSessionNotFoundException - neexistující session
EosInternalException - vniřní chyba
EosIllegalArgumentException - není validní vstup metody (neplatný filtr)

### findApplicationsByIds

Hledání aplikací podle předaného seznamu id.

#### Předpis

EosApplications findApplicationsByIds (String sid, EosApplicationIds applicationIds, EosApplicationRespFilter respFilters)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
applicationIds | EosApplicationIds | Ano | seznam id aplikací
respFilters | EosApplicationRespFilter | Ne | response filtr

#### Výstup

EosApplications - seznam nalezených aplikací podle předaných id, počet prvků nemusí odpovídat předanému seznamu id v případě, že některé aplikace nebyly nalezeny

#### Výjimky

EosSessionNotFoundException - neexistující session
EosInternalException - vniřní chyba
EosIllegalArgumentException - není validní vstup metody (v seznamu byl předán neplatný identifikátor aplikace)

### findPersonsRoleActProfile

Získání osob podle zadaného filtru. K jednotlivým osobám jsou načítány jejich přiřazené profily a agendy. Jak pro profily, tak pro agendy jsou výsledné seznamy tvořeny jako průnik seznamů ze všech zařazení osob, a to i ze zděděných entit z nadřazených prvků.

#### Předpis

EosPersonRoleActProfiles findPersonsRoleActProfile (String sid, String filter)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
filter | String | Ne | textový filtr osob, kterým můžeme omezit vrácený seznam osob

#### Výstup

EosPersonRoleActProfiles - seznam nalezených osob dle filtru

#### Výjimky

EosInternalException - vnitřní chyba systému
EosSessionNotFoundException - neexistuje session
EosIllegalArgumentException - špatně zadaný parametr

### getApplicationsWithoutEnvironment

Načte senzam aplikací, které nejsou v žádném prostředí.

#### Předpis

EosApplications getApplicationsWithoutEnvironment (String sid, EosApplicationRespFilter respFilters)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
respFilters | EosApplicationRespFilter | Ne | response filtr

#### Výstup

EosApplications - seznam aplikací, které nejsou v žádném prostředí

#### Výjimky

EosSessionNotFoundException - neexistující session
EosInternalException - vniřní chyba

### getEnvironmentApplications

Načtení aplikací, které jsou v daném prostředí.

#### Předpis

EosApplications getEnvironmentApplications (String sid, String environmentId, EosApplicationRespFilter respFilters)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
environmentId | String | Ano | id prostředí
respFilters | EosApplicationRespFilter | Ne | response filtr

#### Výstup

EosApplications - seznam aplikací pro dané prostředí

#### Výjimky

EosObjectNotFoundException - prostředí nebylo nalezeno
EosSessionNotFoundException - neexistující session
EosInternalException - vniřní chyba

### getNextApplications

Načtení další části stránkovaného seznamu aplikací.

#### Předpis

EosApplications getNextApplications (String sid, String lid)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
lid | String | Ano | list id

#### Výstup

EosApplications - další část stránkovaného seznamu aplikací

#### Výjimky

EosListNotFoundException - lid daného id neexistuje
EosInternalException - vniřní chyba
EosSessionNotFoundException - neexistující session

### getNextPersonsRoleActProfile

Načte další seznam osob získaný dle filtru z {@link #findPersonsRoleActProfile(String, String)}.

#### Předpis

EosPersonRoleActProfiles getNextPersonsRoleActProfile (String sid, String lid)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
lid | String | Ano | list id

#### Výstup

EosPersonRoleActProfiles - další seznam osob načtený dle filtru

#### Výjimky

EosSessionNotFoundException - neexistuje session
EosInternalException - vnitřní chyba systému

### getPersonApplications

Načtení aplikací, které jsou dostupné pro danou osobu nebo osobu v zařazení nebo osobu v primárním zařazení. Povolená kombinace parametrů role a onlyPrimAss:

- role=<id role>, onlyPrimAss=false - oprávnění pro osobu v konkrétní roli
- role=null, onlyPrimAss=false - oprávnění pro osobu bez ohledu na role
- role=null, onlyPrimAss=true - oprávnění pro osobu v primárním zařazení

#### Předpis

EosApplications getPersonApplications (String sid, String personId, String roleId, EosRoleIdType roleIdType, boolean onlyPrimAss, EosApplicationRespFilter respFilter)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
personId | String | Ano | id osoby
roleId | String | Ne | id entity organizační struktury, musí se jednat o id role
roleIdType | EosRoleIdType | Ne | typ entity, na které odkazuje roleId
onlyPrimAss | boolean | Ne | pokud je true, uvažuje se pouze primární zařazení osoby
respFilter | EosApplicationRespFilter | Ne | response filtr

#### Výstup

EosApplications - seznam aplikací

#### Výjimky

EosObjectNotFoundException - osoba nebo role nebyly nalezeny
EosNoPrimaryAssignmentException - nebylo nalezeno primární zařazení
EosIllegalArgumentException - nebyl předán identifikátor role
EosSessionNotFoundException - neexistující session
EosInternalException - vniřní chyba

### placePersonAttributeValue

Přiřadí hodnotu atributu na osobu. Pokud již osoba měla u daného atributu nějakou hodnotu nebo hodnoty tak budou přepsány.

#### Předpis

void placePersonAttributeValue (String sid, String personId, String applicationId, String attributeName, Cz.marbes.eos4.module.ws.v3.rights.wo.WOAttributeValue attributeValue)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
personId | String | Ano | id osoby
applicationId | String | Ano | id aplikace
attributeName | String | Ano | název atributu
attributeValue | Cz.marbes.eos4.module.ws.v3.rights.wo.WOAttributeValue | Ano | hodnota

#### Výjimky

EosObjectNotFoundException - osoba, aplikace nebo atribut nebyl nalezen
EosSessionNotFoundException - neexistující session
EosInternalException - vnitřní chyba

### placePersonAttributeValues

Přiřadí hodnoty atributu na osobu. Pokud již osoba měla u daného atributu nějakou hodnotu nebo hodnoty tak budou přepsány.

#### Předpis

void placePersonAttributeValues (String sid, String personId, String applicationId, String attributeName, Cz.marbes.eos4.module.ws.v3.rights.wo.WOAttributeValues attributeValues)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
personId | String | Ano | id osoby
applicationId | String | Ano | id aplikace
attributeName | String | Ano | název atributu
attributeValues | Cz.marbes.eos4.module.ws.v3.rights.wo.WOAttributeValues | Ano | hodnoty

#### Výjimky

EosObjectNotFoundException - osoba, aplikace nebo atribut nebyl nalezen
EosSessionNotFoundException - neexistující session
EosInternalException - vnitřní chyba

## Popis struktur dat

### Cz.marbes.eos4.module.ws.v3.rights.wo.WOAttributeValue

Objekt reprezentuje hodnotu atributu (oprávnění).

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
id | String | Ne | Id hodnoty atributu.
value | String | Ne | Hodnota atributu (oprávnění).
description | String | Ne | Popis hodnoty.
externId | String | Ne | Odkaz na id hodnoty, pouze pokud se jedná o SQL, WS nebo výčtový atribut.

### Cz.marbes.eos4.module.ws.v3.rights.wo.WOAttributeValues

Objekt obsahující seznam hodnot atributů aplikace.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
attributeValues | List<Cz.marbes.eos4.module.ws.v3.rights.wo.WOAttributeValue> | Ne | Seznam hodnot atributů aplikace.

### Cz.marbes.eos4.module.ws.v3.rights.wo.types.WOAttributeType

Typ atributu aplikace.

Hodnota | Popis
--- | ---
SELECT | SQL atribut, výčet možných hodnot je definován pomocí SQL a databázového připojení. Hodnoty mohou být definovány jako plochý seznam nebo jako strom.
TEXT | Textový atribut, hodnota je zadávána ručně jako řetězec.
BOOLEAN | Pravdivostní atribut, hodnoty mohou obsahovat true nebo false.
WS | Web service atribut, výčet možných hodnot je definován pomocí volání webové služby. Hodnoty mohou být definovány jako plochý seznam nebo jako strom.
ENUM | Výčtový atribut. Hodnota se vybírá z oboru hodnot atributu.
INNER | Vnitřní atribut aplikace EOS. Hodnoty se berou z dat aplikace EOS.
MULTICOLUMN | Vícesloupcový atribut.

### EosApplication

Object reprezentuje aplikaci.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
id | String | Ne | Id aplikace.
name | String | Ne | Název aplikace.
parameters | String | Ne | Parametry příkazové řádky.
author | String | Ne | Autor aplikace.
description | String | Ne | Popis aplikace.
path | String | Ne | Cesta k aplikaci. Kde je fyzicky spustitelný soubor na síti - v případě webové URL.
icon | String | Ne | Kde je uložena na disku nebo v síti ikona aplikace.
appServerName | String | Ne | Jméno aplikačního serveru.
manageStarting | Boolean | Ne | Atribut určující, zda se u aplikace má řešit spouštění. V případě true hodnoty aplikace dostane nový atribut, který bude obsahovat hodnoty spouštění.
appCode | String | Ne | Kód.
serverUrl | String | Ne | URL aplikačního serveru pro webové služby.
version | String | Ne | Verze aplikace.
attributes | EosAttributes | Ne | Atributy aplikace.
environments | EosEnvironments | Ne | Obsahuje seznam prostředí, do kterých je aplikace přiřazena.
formattedDescription | String | Ne | Podrobný naformátovaný popis aplikace, jedná se o xhtml kód.
central | Boolean | Ne | Příznak zda je aplikace centrální.

### EosApplicationIds

Objekt obsahující seznam identifikátorů aplikací.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
applicationids | List<String> | Ne | Seznam identifikátorů aplikací.

### EosApplicationRespFilter

Objekt definuje rozsah dat, které se budou u aplikací plnit.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
attributes | Boolean | Ne | Mají se u aplikace vracet atributy?
environments | Boolean | Ne | Příznak, jestli se mají vracet i prostředí k aplikace. True - mají se vracet i prostředí, false - nemají.

### EosApplications

Objekt obsahující seznam aplikací.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
applications | List<EosApplication> | Ne | Seznam aplikací.
paging | EosPaging | Ne | Stránkování seznamu.

### EosAttribute

Objekt reprezentuje atribut aplikace.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
id | String | Ne | Id atributu.
name | String | Ne | Název atributu.
type | Cz.marbes.eos4.module.ws.v3.rights.wo.types.WOAttributeType | Ne | Typ atributu.
appId | String | Ne | Id aplikace, ke které daný atribut patří.
singleValue | boolean | Ne | Příznak zda je atributu jednohodnotový (true) nebo vícehodnotový (false).

### EosAttributes

Objekt obsahující seznam atributů.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
attributes | List<EosAttribute> | Ne | Seznam atributů.

### EosEnvironment

Prostředí do kterého je přiřazena aplikace.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
id | String | Ne | Id prostředí.
name | String | Ne | Název prostředí.
description | String | Ne | Popis prostředí.
code | String | Ne | Kód prostředí.
testing | Boolean | Ne | Příznak jestli je prostředí testovací, nebo produktivní.

### EosEnvironments

Obsahuje seznam prostředí v kterých se nachází aplikace.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
environments | List<EosEnvironment> | Ne | Seznam prostředí pro aplikaci.

### EosIds

Objekt obsahující seznam id.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
ids | List<String> | Ne | Seznam identifikátorů.

### EosPaging

Objekt obsahující informace pro stránkování.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
lid | String | Ne | List id nebo null, pokud stránkování není vyžadováno.
start | int | Ne | Index prvního záznamu, který byl aktuálně vrácen.
totalCount | int | Ne | Celkový počáteční záznamů.
hasNext | boolean | Ne | Příznak, zda jsou k dispozici ještě další záznamy.

### EosPerson

Osobu.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
id | String | Ne | Id osoby.
degreeBefore | String | Ne | Titul před jménem.
firstname1 | String | Ne | Jméno.
firstname2 | String | Ne | Druhéí jméno.
surname1 | String | Ne | Příjmení.
surname2 | String | Ne | Další příjmení.
degreeAfter | String | Ne | Titul za jménem.
signature | String | Ne | Iniciály.
abbrev | String | Ne | Zkratka.
userName | String | Ne | Uživatelské jméno.
displayName | String | Ne | Zorazované jméno.
personalNumber | String | Ne | Osobní číslo.
entranceDate | Date | Ne | Datum nástupu.
terminationDate | Date | Ne | Datum ukončení.
email | String | Ne | E-mail.
locked | Boolean | Ne | Je účet uzamčen pro přihlášení?
disabled | Boolean | Ne | Je osoba zakázaná? V případě zakázání nemá osoba žádná oprávnění ani aplikace.
publicable | Boolean | Ne | Publikovat osobu ve veřejné (internetové) verzi zobrazení?

### EosPersonRoleActProfile

WOObjekt obsahující detail osoby spolu s přiřazenými profily a agendami.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
person | EosPerson | Ne | Detail osoby.
profileIds | EosIds | Ne | Seznam id profilů osoby.
roleActivities | EosRoleActivities | Ne | Seznam přiřazených agend.

### EosPersonRoleActProfiles

WO objekt obsahující seznam osob s jejich agendami a profily.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
personRoleActProfile | List<EosPersonRoleActProfile> | Ne | Seznam osob s agendami a profily.
paging | EosPaging | Ne | Stránkování.

### EosRoleActivities

WO objekt obsahující seznam agend.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
roleActivity | List<EosRoleActivity> | Ne | Seznam agend/činností.

### EosRoleActivity

WO objekt agendy.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
id | String | Ne | Id agendy.
code | String | Ne | Kód agendy. Pokud nemá agenda nastaven codeRPP, obsahuje pouze kod agendy.

### EosRoleIdType

Typ role.

Hodnota | Popis
--- | ---
OR | Organizační role.
GR | Organizační skupinová role.