# Webová služba RoleActivity verze 6.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í pro práci s agendami a jejich přiřazením.

### 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%'`

## Seznam poskytovaných metod

Název | Popis
--- | ---
assignRoleActivitiesStateToPersonInRoles | Nastavení položek agend na zařazení osob do rolí.
assignRoleActivityToOrgEntity | Přiřazení položky agendy na roli nebo profil v organizační struktuře.
assignRoleActivityToPerson | Přiřazení položky agendy na osobu.
assignRoleActivityToPersonInRole | Přiřazení položky agendy na zařazení osoby do role.
checkEntityRppRole | Ověření, zda má daná osoba nebo osoba v zařazení oprávnění pro konkrétní agendovou roli v agendě.
detachRoleActivityFromOrgEntity | Odebrání položky agendy z role nebo profilu v organizační struktuře.
detachRoleActivityFromPerson | Odebrání položky agendy z osoby.
detachRoleActivityFromPersonInRole | Odebrání položky agendy ze zařazení osoby do role v organizační struktuře.
findPersonRoleActivityRegistrationRequirements | Načte seznam požadavků na schválení registrace agendy, ke kterým se má vyjádřit zvolená osoba.
findRoleActivitiesByFilter | Hledání agend podle předaného filtru.
findRoleActivitiesByIds | Hledání agend podle předaného seznamu id.
findRppAdministrationsByFilter | Načítání agend rpp podle filtru.
findRppRolesByFilter | Načítání agendových rolí rpp v rámci agendy rpp.
getEntityRppData | Načtení položek agend a agendových rolí pro osobu nebo osobu v zařazení nebo roli nebo profil v EOS.
getNextRoleActivities | Načtení další části stránkovaného seznamu agend.
getRoleActivityChildren | Načtení celého podstromu agend pro předanou agendu nebo načtení jen přímých potomků.
getRootRoleActivities | Načtení kořenových agend ve stromu agend.

## Seznam struktur dat

Název | Popis
--- | ---
EosEntityIdType | Typ id role.
EosPaging | Objekt obsahující informace pro stránkování.
EosPersonInRoleActivities | Seznam položek agend na zařazení osoby do role.
EosPersonInRolesActivities | Seznam položek agend na zařazení osob do rolí.
EosRequirementState | Stav schálení požadavku.
EosRoleActivities | Objekt obsahuje seznam agend.
EosRoleActivity | Agenda.
EosRoleActivityIds | Objekt obsahující seznam id agend.
EosRoleActivityRespFilter | Objekt definuje rozsah dat, které se budou u agend plnit.
EosRoleActivityType |
EosRoleIdType | Typ id role.

## Výjimky

### EosIllegalArgumentException

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

### EosInternalException

Neočekávaná výjimka při volání webových služeb.

### EosObjectNotFoundException

Objekt nebyl nalezen.

### EosObjectNotFoundException

Nedostatečná oprávnění pro provedení požadované akce.

## Popis poskytovaných metod

### assignRoleActivitiesStateToPersonInRoles

Nastavení položek agend na zařazení osob do rolí. Metoda odstraní aktuální položky agend na zařazení osob do rolí a přiřadí jim jen položky předané v parametru. Tato metoda vyžaduje přihlášení.

#### Předpis

void assignRoleActivitiesStateToPersonInRoles (String sid, EosPersonInRolesActivities personInRolesActivities)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
personInRolesActivities | EosPersonInRolesActivities | Ano | položky agend na zařazení osob do rolí

#### Výjimky

EosObjectNotFoundException - Objekt nebyl nalezen.
EosIllegalArgumentException - Byl předán nevalidní vstupní argument do metody webové služby.
EosObjectNotFoundException - Nedostatečná oprávnění pro provedení požadované akce.
EosInternalException - Neočekávaná výjimka při volání webových služeb.

### assignRoleActivityToOrgEntity

Přiřazení položky agendy na roli nebo profil v organizační struktuře. Tato metoda vyžaduje přihlášení.

#### Předpis

void assignRoleActivityToOrgEntity (String sid, String roleActivityId, String entityId, EosEntityIdType entityIdType)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
roleActivityId | String | Ano | id položky agendy
entityId | String | Ano | id entity organizační struktury, musí se jednat o id role nebo profilu
entityIdType | EosEntityIdType | Ano | typ entity, na které odkazuje entityId

#### Výjimky

EosObjectNotFoundException - Objekt nebyl nalezen.
EosIllegalArgumentException - Byl předán nevalidní vstupní argument do metody webové služby.
EosObjectNotFoundException - Nedostatečná oprávnění pro provedení požadované akce.
EosInternalException - Neočekávaná výjimka při volání webových služeb.

### assignRoleActivityToPerson

Přiřazení položky agendy na osobu. Tato metoda vyžaduje přihlášení.

#### Předpis

void assignRoleActivityToPerson (String sid, String roleActivityId, String personId)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
roleActivityId | String | Ano | id položky agendy
personId | String | Ano | id osoby

#### Výjimky

EosObjectNotFoundException - Objekt nebyl nalezen.
EosIllegalArgumentException - Byl předán nevalidní vstupní argument do metody webové služby.
EosObjectNotFoundException - Nedostatečná oprávnění pro provedení požadované akce.
EosInternalException - Neočekávaná výjimka při volání webových služeb.

### assignRoleActivityToPersonInRole

Přiřazení položky agendy na zařazení osoby do role. Tato metoda vyžaduje přihlášení.

#### Předpis

void assignRoleActivityToPersonInRole (String sid, String roleActivityId, String personId, String roleId, EosRoleIdType roleIdType)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
roleActivityId | String | Ano | id položky agendy
personId | String | Ano | id osoby
roleId | String | Ano | id entity organizační struktury, do které je osoba zařazena, musí se jednat o id role
roleIdType | EosRoleIdType | Ano | typ entity, na které odkazuje roleId

#### Výjimky

EosObjectNotFoundException - Objekt nebyl nalezen.
EosIllegalArgumentException - Byl předán nevalidní vstupní argument do metody webové služby.
EosObjectNotFoundException - Nedostatečná oprávnění pro provedení požadované akce.
EosInternalException - Neočekávaná výjimka při volání webových služeb.

### checkEntityRppRole

Ověření, zda má daná osoba nebo osoba v zařazení oprávnění pro konkrétní agendovou roli v agendě. Kobinace vstupních id (personId, entityId a entityIdType):

- personId, entityId, entityIdType - načtení dat pro osobu v konkrétním zařazení(jen do role)
- entityId, entityIdType - načtení dat pro roli nebo profil v EOS
- personId - načtení dat pro osobu ve všech zařazeních

#### Předpis

boolean checkEntityRppRole (String sid, String personId, String entityId, EosEntityIdType entityIdType, String admCodeRpp, String roleCodeRpp, EosRoleActivityRespFilter respFilter)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
personId | String | Ne | id osoby
entityId | String | Ne | id entity organizační struktury, musí se jednat o id role nebo profilu
entityIdType | EosEntityIdType | Ne | typ entity, na které odkazuje entityId
admCodeRpp | String | Ano | kód agendy rpp
roleCodeRpp | String | Ano | kód role rpp
respFilter | EosRoleActivityRespFilter | Ne | neuvádí se

#### Výstup

boolean - true, pokud má osoba oprávnění na danou agendovou roli

#### Výjimky

EosObjectNotFoundException - Objekt nebyl nalezen.
EosIllegalArgumentException - Byl předán nevalidní vstupní argument do metody webové služby.
EosInternalException - Neočekávaná výjimka při volání webových služeb.

### detachRoleActivityFromOrgEntity

Odebrání položky agendy z role nebo profilu v organizační struktuře. Tato metoda vyžaduje přihlášení.

#### Předpis

boolean detachRoleActivityFromOrgEntity (String sid, String roleActivityId, String entityId, EosEntityIdType entityIdType)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
roleActivityId | String | Ano | id položky agendy
entityId | String | Ano | id entity organizační struktury, musí se jednat o id role nebo profilu
entityIdType | EosEntityIdType | Ano | typ entity, na které odkazuje entityId

#### Výstup

boolean - true, pokud byla agenda odebrána, agenda nemusí být odebrána např. pokud není na entitě přímo přiřazena a je zděděna

#### Výjimky

EosObjectNotFoundException - Objekt nebyl nalezen.
EosIllegalArgumentException - Byl předán nevalidní vstupní argument do metody webové služby.
EosObjectNotFoundException - Nedostatečná oprávnění pro provedení požadované akce.
EosInternalException - Neočekávaná výjimka při volání webových služeb.

### detachRoleActivityFromPerson

Odebrání položky agendy z osoby. Tato metoda vyžaduje přihlášení.

#### Předpis

boolean detachRoleActivityFromPerson (String sid, String roleActivityId, String personId)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
roleActivityId | String | Ano | id položky agendy
personId | String | Ano | id osoby

#### Výstup

boolean - true, pokud byla agenda odebrána, agenda nemusí být odebrána např. pokud není na entitě přímo přiřazena a je zděděna

#### Výjimky

EosObjectNotFoundException - Objekt nebyl nalezen.
EosIllegalArgumentException - Byl předán nevalidní vstupní argument do metody webové služby.
EosObjectNotFoundException - Nedostatečná oprávnění pro provedení požadované akce.
EosInternalException - Neočekávaná výjimka při volání webových služeb.

### detachRoleActivityFromPersonInRole

Odebrání položky agendy ze zařazení osoby do role v organizační struktuře. Tato metoda vyžaduje přihlášení.

#### Předpis

boolean detachRoleActivityFromPersonInRole (String sid, String roleActivityId, String personId, String roleId, EosRoleIdType roleIdType)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
roleActivityId | String | Ano | id položky agendy
personId | String | Ano | id osoby
roleId | String | Ano | id entity organizační struktury, musí se jednat o id role
roleIdType | EosRoleIdType | Ano | typ entity, na které odkazuje roleId

#### Výstup

boolean - true, pokud byla agenda odebrána, agenda nemusí být odebrána např. pokud není na entitě přímo přiřazena a je zděděna

#### Výjimky

EosObjectNotFoundException - Objekt nebyl nalezen.
EosIllegalArgumentException - Byl předán nevalidní vstupní argument do metody webové služby.
EosObjectNotFoundException - Nedostatečná oprávnění pro provedení požadované akce.
EosInternalException - Neočekávaná výjimka při volání webových služeb.

### findPersonRoleActivityRegistrationRequirements

Načte seznam požadavků na schválení registrace agendy, ke kterým se má vyjádřit zvolená osoba.

#### Předpis

EosRegRequirement findPersonRoleActivityRegistrationRequirements (String sid, String personId, EosRequirementState requirementState)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
personId | String | Ano | id osoby
requirementState | EosRequirementState | Ne | stav požadavku, pokud není uvedeno, ignoruje se

#### Výstup

EosRegRequirement -

#### Výjimky

EosObjectNotFoundException - Objekt nebyl nalezen.
EosIllegalArgumentException - Byl předán nevalidní vstupní argument do metody webové služby.
EosObjectNotFoundException - Nedostatečná oprávnění pro provedení požadované akce.
EosInternalException - Neočekávaná výjimka při volání webových služeb.

### findRoleActivitiesByFilter

Hledání agend podle předaného filtru. Pořadí vracených položek není nijak definováno.

#### Předpis

EosRoleActivities findRoleActivitiesByFilter (String sid, String filter, String roleActivityId, EosRoleActivityRespFilter respFilter)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
filter | String | Ne | filtr na agendy
roleActivityId | String | Ne | pokud je uvedeno, jedná se o položku, pod kterou bude hledáno
respFilter | EosRoleActivityRespFilter | Ne | response filtr na agendy

#### Výstup

EosRoleActivities - seznam entit podle předaného filtru

#### Výjimky

EosObjectNotFoundException - Objekt nebyl nalezen.
EosIllegalArgumentException - Byl předán nevalidní vstupní argument do metody webové služby.
EosInternalException - Neočekávaná výjimka při volání webových služeb.

### findRoleActivitiesByIds

Hledání agend podle předaného seznamu id. Metoda je vhodná pro hromadné načítání položek. Alternativou je metoda findRoleActivitiesByFilter s filtrem, ale ten má omezen počet položek. Tato metoda nemá počet vstupních id omezen.

#### Předpis

EosRoleActivities findRoleActivitiesByIds (String sid, EosRoleActivityIds raIds, EosRoleActivityRespFilter respFilter)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
raIds | EosRoleActivityIds | Ano | seznam id agend
respFilter | EosRoleActivityRespFilter | Ne | response filtr

#### Výstup

EosRoleActivities - nalezené agendy, pokud podle některých id nebyly agendy nalezeny, nebudou ve výsledku obsaženy

#### Výjimky

EosObjectNotFoundException - Objekt nebyl nalezen.
EosIllegalArgumentException - Byl předán nevalidní vstupní argument do metody webové služby.
EosInternalException - Neočekávaná výjimka při volání webových služeb.

### findRppAdministrationsByFilter

Načítání agend rpp podle filtru.

#### Předpis

EosRoleActivities findRppAdministrationsByFilter (String sid, String filter, EosRoleActivityRespFilter respFilter)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
filter | String | Ne | filtr
respFilter | EosRoleActivityRespFilter | Ne | response filtr na agendy

#### Výstup

EosRoleActivities - seznam agend rpp

#### Výjimky

EosObjectNotFoundException - Objekt nebyl nalezen.
EosIllegalArgumentException - Byl předán nevalidní vstupní argument do metody webové služby.
EosInternalException - Neočekávaná výjimka při volání webových služeb.

### findRppRolesByFilter

Načítání agendových rolí rpp v rámci agendy rpp.

#### Předpis

EosRoleActivities findRppRolesByFilter (String sid, String admCodeRpp, String filter, EosRoleActivityRespFilter respFilter)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
admCodeRpp | String | Ano | kód agendy rpp
filter | String | Ne | filtr
respFilter | EosRoleActivityRespFilter | Ne | response filtr na agendy

#### Výstup

EosRoleActivities - seznam agendových rolí rpp pod danou agendou rpp

#### Výjimky

EosObjectNotFoundException - Objekt nebyl nalezen.
EosIllegalArgumentException - Byl předán nevalidní vstupní argument do metody webové služby.
EosInternalException - Neočekávaná výjimka při volání webových služeb.

### getEntityRppData

Načtení položek agend a agendových rolí pro osobu nebo osobu v zařazení nebo roli nebo profil v EOS. Kobinace vstupních id:

- personId, entityId, entityIdType - načtení dat pro osobu v konkrétním zařazení(jen do role)
- entityId, entityIdType - načtení dat pro roli nebo profil v EOS
- personId - načtení dat pro osobu ve všech zařazeních

Omezení na agendu: buď neuvedeno, nebo kód agendy rpp.

#### Předpis

EosRoleActivities getEntityRppData (String sid, String personId, String entityId, EosEntityIdType entityIdType, String admCodeRpp, EosRoleActivityRespFilter respFilter)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
personId | String | Ne | id osoby
entityId | String | Ne | id entity organizační struktury, musí se jednat o id role nebo profilu
entityIdType | EosEntityIdType | Ne | typ entity, na které odkazuje entityId
admCodeRpp | String | Ne | typ agendy rpp, pokud je uveden, omezují se výsledky pro danou agendu
respFilter | EosRoleActivityRespFilter | Ne | respose filtr

#### Výstup

EosRoleActivities - seznam agendových rolí a agend, pokud je v EOS přiřazena agendová role, je vrácena včetně agendy, pokud je v EOS přiřazena agenda, je vrácena včetně všech agendových rolí

#### Výjimky

EosObjectNotFoundException - Objekt nebyl nalezen.
EosIllegalArgumentException - Byl předán nevalidní vstupní argument do metody webové služby.
EosInternalException - Neočekávaná výjimka při volání webových služeb.

### getNextRoleActivities

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

#### Předpis

EosRoleActivities getNextRoleActivities (String sid, String lid)

#### Parametry

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

#### Výstup

EosRoleActivities - další část stránkovaného seznamu agend

#### Výjimky

EosObjectNotFoundException - Objekt nebyl nalezen.
EosIllegalArgumentException - Byl předán nevalidní vstupní argument do metody webové služby.
EosInternalException - Neočekávaná výjimka při volání webových služeb.

### getRoleActivityChildren

Načtení celého podstromu agend pro předanou agendu nebo načtení jen přímých potomků. Metoda je na výstupu stránkovaná, ale při vracení dat respektuje pořadí položek tak, aby systém mohl postupně z načtených dat sestavovat strom. Metoda je vhodné pro čtění dat z pohledu stromového upořádání.

#### Předpis

EosRoleActivities getRoleActivityChildren (String sid, String roleActivityId, boolean onlyDirect, EosRoleActivityRespFilter respFilter)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
roleActivityId | String | Ano | id agendy, pro kterou se načítá podstrom
onlyDirect | boolean | Ano | pokud je true, vracejí se jen přímí potomci předané agendy, pokud je false, vracejí se všichni potomci celého podtromu
respFilter | EosRoleActivityRespFilter | Ne | response filtr na agendy

#### Výstup

EosRoleActivities - potomci pro danou agendu

#### Výjimky

EosObjectNotFoundException - Objekt nebyl nalezen.
EosIllegalArgumentException - Byl předán nevalidní vstupní argument do metody webové služby.
EosInternalException - Neočekávaná výjimka při volání webových služeb.

### getRootRoleActivities

Načtení kořenových agend ve stromu agend.

#### Předpis

EosRoleActivities getRootRoleActivities (String sid, EosRoleActivityRespFilter respFilter)

#### Parametry

Parametr | Typ | Povinný | Popis
--- | --- | --- | ---
sid | String | Ne | session id
respFilter | EosRoleActivityRespFilter | Ne | response filtr na agendy

#### Výstup

EosRoleActivities - seznam kořenových agend

#### Výjimky

EosObjectNotFoundException - Objekt nebyl nalezen.
EosIllegalArgumentException - Byl předán nevalidní vstupní argument do metody webové služby.
EosInternalException - Neočekávaná výjimka při volání webových služeb.

## Popis struktur dat

### EosEntityIdType

Typ id role.

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

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

### EosPersonInRoleActivities

Seznam položek agend na zařazení osoby do role.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
roleActivityIds | EosRoleActivityIds | Ne | Id položek agend.
personId | String | Ne | Id osoby.
roleId | String | Ne | Id role.
roleIdType | EosRoleIdType | Ne | Typ entity, na které odkazuje roleId.

### EosPersonInRolesActivities

Seznam položek agend na zařazení osob do rolí.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
personInRoleActivities | List<EosPersonInRoleActivities> | Ne | Seznam položek agend na zařazení osoby do role.

### EosRequirementState

Stav schálení požadavku.

Hodnota | Popis
--- | ---
WAITING | Osoba ještě nevyplnila osoby a počty osob k agendě a jejím rolím.
CONFIRMED | Osoba potvrdila, že již vyplnila všechny počty osob k agendě a jejím rolím.

### EosRoleActivities

Objekt obsahuje seznam agend.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
roleActivities | List<EosRoleActivity> | Ne | Seznam agend/činností.
paging | EosPaging | Ne | Stránkování.

### EosRoleActivity

Agenda.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
id | String | Ne | Id agendy.
parentId | String | Ne | Id nadřazené agendy, pokud je kořenová, není uvedeno.
name | String | Ne | Název agendy.
code | String | Ne | Kód agendy.
typeCode | String | Ne | Kód typu agendy. Standardní kódy: ADMINISTRATION - agenda ACTIVITY - činnost v agendě ROLE - agendová role v agendě (role z pohledu oprávnění)
coreRpp | String | Ne | Kód RPP, pokud je položka navázána na RPP.
type | EosRoleActivityType | Ne | Typ agendy.
description | String | Ne | Popis agendy.
validFrom | Date | Ne | Datum, od kterého (včetně) je daná osoba obsazena do této role.
validTo | Date | Ne | Datum, do kterého (včetně) je daná osoba obsazena do této role.
notSent | Date | Ne | Datum, kdy poprvé agenda/agendová role nepřišla z RPP. Pokud opět přijde pole se vynuluje.
valid | Boolean | Ne | Datum, do kterého (včetně) je daná osoba obsazena do této role.
rppItem | Boolean | Ne | Příznak, zda se jedná o položku synchronizovanou z RPP. Položky s hodnoto false jsou vlastn položky EOS definované zákazníkem a mohou se na RPP vázat přes coreRpp.

### EosRoleActivityIds

Objekt obsahující seznam id agend.

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
roleActivityIds | List<String> | Ne | Seznam id organizační jednotek.

### EosRoleActivityRespFilter

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

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
typeCode | boolean | Ne | Má se plnit kód typu organizační entity? (typ organizační role/typ organizační jednotky atp.)
typeEntity | boolean | Ne | Má se plnit objekt typu organizační entity? (typ organizační role/typ organizační jednotky atp.)

### EosRoleActivityType

Jméno atributu | Datový typ | Povinné | Popis
--- | --- | --- | ---
name | String | Ne | Název typu agendy.
code | String | Ne | Kód typu agendy.
desc | String | Ne | Popis typu agendy.

### EosRoleIdType

Typ id role.

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