Webová služba OrgRoleStructureRead verze 1.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.
Rozhraní webové služby pro čtení informací o struktuře organizačních rolí.
Vyjímka reprezentuje špatný vstupní parametr do web metod.
Vyjímka reprezentuje stav, kdy nebyl objekt podle kriterií nalezen.
Reprezentuje neočekávanou výjimku při volání WS. Jejím zdrojem musí být vždy
jiná výjimka.
Načte seznam všech sekundárních stromů.
Předpis
Parametry
Parametr |
Typ |
Povinný |
Popis |
clientId |
String |
Ne |
identifikátor klienta, není povinný |
Výstup
Výjimky
Vrátí seznam potomků organizační role (jen podřízené organizační role)
v primárním stromu.
Předpis
Parametry
Parametr |
Typ |
Povinný |
Popis |
parentOrgRoleId |
EosIdentifier |
Ano |
id organizační role, od které se budou hledat potomci |
clientId |
String |
Ano |
identifikátor klienta, je povinný jen při předání externího Id
v parentOrgRoleId |
Výstup
Výjimky
Najde bezprostředně nadřízenou organizační roli k předané v primárním stromu.
Předpis
Parametry
Parametr |
Typ |
Povinný |
Popis |
childOrgRoleId |
EosIdentifier |
Ano |
id organizační role, pro kterou se hledá nadřazená |
clientId |
String |
Ano |
identifikátor klienta, je povinný jen při předání externího Id
v childOrgRoleId |
Výstup
EosOrgRole - rodičovskou organizační roli v primárním stromu, pokud je předaná
entita kořenová, návratová hodnota není definována
Výjimky
Načte všechny kořenové organizační role primárního stromu.
Předpis
Parametry
Parametr |
Typ |
Povinný |
Popis |
clientId |
String |
Ne |
identifikátor klienta, není povinný |
Výstup
EosOrgRoles - seznam kořenových organizačních rolí promárního stromu
Výjimky
Vrátí seznam potomků organizační role (jen podřízené organizační role)
v sekundárním stromu.
Předpis
Parametry
Parametr |
Typ |
Povinný |
Popis |
secondaryOrgRoleTreeId |
EosIdentifier |
Ano |
identifikátor sekundárního stromu organizačních rolí |
parentOrgRoleId |
EosIdentifier |
Ano |
id organizační role, od které se budou hledat potomci |
clientId |
String |
Ano |
identifikátor klienta, je povinný jen při předání externího Id
v parentOrgRoleId nebo v secondaryOrgRoleTreeId |
Výstup
Výjimky
Najde bezprostředně nadřízenou organizační roli k předané v sekundárním stromu.
Předpis
Parametry
Parametr |
Typ |
Povinný |
Popis |
secondaryOrgRoleTreeId |
EosIdentifier |
Ano |
identifikátor sekundárního stromu organizačních rolí |
childOrgRoleId |
EosIdentifier |
Ano |
id organizační role, pro kterou se hledá nadřazená |
clientId |
String |
Ano |
identifikátor klienta, je povinný jen při předání externího Id
v childOrgRoleId nebo v secondaryOrgRoleTreeId |
Výstup
EosOrgRole - rodičovskou organizační roli v sekundárním stromu,
pokud je předaná entita kořenová, návratová hodnota není definována
Výjimky
Nalezne sekundární strom organizačních rolí podle daného id.
Předpis
Parametry
Parametr |
Typ |
Povinný |
Popis |
secondaryOrgRoleTreeId |
EosIdentifier |
Ano |
id požadovaného sekundárního stromu organizačních rolí |
clientId |
String |
Ano |
identifikátor klienta, je povinný jen při předání externího Id
v secondaryOrgRoleTreeId |
Výstup
Výjimky
Načte všechny kořenové organizační role v sekundárním stromu.
Předpis
Parametry
Parametr |
Typ |
Povinný |
Popis |
secondaryOrgRoleTreeId |
EosIdentifier |
Ano |
identifikátor sekundárního stromu organizačních rolí |
clientId |
String |
Ano |
identifikátor klienta, je povinný jen při zadání externího
id v secondaryOrgRoleTreeId |
Výstup
EosOrgRoles - seznam kořenových organizačních rolí v sekundárním stromu
Výjimky
Testuje, zda je daná organizační role kořenová v primárním stromu.
Předpis
boolean isPrimaryOrgRoleRoot (
EosIdentifier orgRoleId, String clientId)
Parametry
Parametr |
Typ |
Povinný |
Popis |
orgRoleId |
EosIdentifier |
Ano |
id testované organizační role |
clientId |
String |
Ano |
identifikátor klienta, je povinný jen při předání externího Id
v orgRoleId |
Výstup
boolean - true pokud je organizační role kořenovou v primárním stromu
Výjimky
Testuje, zda je daná organizační role kořenová v sekundárním stromu.
Předpis
Parametry
Parametr |
Typ |
Povinný |
Popis |
secondaryOrgRoleTreeId |
EosIdentifier |
Ano |
identifikátor sekundárního stromu organizačních rolí |
orgRoleId |
EosIdentifier |
Ano |
id testované organizační role |
clientId |
String |
Ano |
identifikátor klienta, je povinný jen při předání externího Id
v orgRoleId nebo v secondaryOrgRoleTreeId |
Výstup
boolean - true pokud je organizační role kořenovou v sekundárním stromu
Výjimky
Reprezentuje údaje o budově. Není v EOSu skutečnou entitou, proto neobsahuje
žádný identifikátor.
Jméno atributu |
Datový typ |
Povinné |
Popis |
building |
EosValue |
Ne |
Název budovy. |
floor |
EosValue |
Ne |
Patro budovy. |
room |
EosValue |
Ne |
Místnost budovy. |
Reprezentuje identifikátor webového objektu slučující interní a externí ID.
Jméno atributu |
Datový typ |
Povinné |
Popis |
externalId |
String (255) |
Ne |
Id entity v externím systému. |
eosIdentifier |
String (255) |
Ne |
Unikátní identifikátor entity v EOSu (v rámci konkrétního potomka entity,
tedy např. organizační role), při importu do EOSu nemá význam. |
Reprezentuje organizační roli.
Jméno atributu |
Datový typ |
Povinné |
Popis |
id |
EosIdentifier |
Ano |
Identifikátor. |
buildingInfo |
EosBuildingInfo |
Ne |
Informace o budově. |
userFields |
EosUserFields |
Ne |
Uživatelská pole jednotlivých entit. |
phones |
EosPhones |
Ne |
Telefony přiřazené této entitě. |
name |
String (255) |
Ano |
Jméno organizační role. |
code |
String (100) |
Ne |
Kód organizační role. |
sentence |
Integer |
Ne |
Pořadí pracovní pozice v rámci nadřízené organizační jednotky. |
altName |
String |
Ne |
Alternativní název role. |
unitId |
EosIdentifier |
Ano |
Organizační jednotka, do které je role zařazena. |
superiorId |
EosIdentifier |
Ne |
Nadřazená organizační role. |
typeCode |
String (32) |
Ne |
Kód typu organizační role. |
Reprezentuje wrapper pro kolekci organizačních rolí.
Jméno atributu |
Datový typ |
Povinné |
Popis |
orgRole |
List<EosOrgRole> |
Ne |
Kolekce rolí. |
Jméno atributu |
Datový typ |
Povinné |
Popis |
id |
EosIdentifier |
Ano |
Identifikátor. |
description |
String (512) |
Ne |
Popis telefonu. |
prefix |
String (80) |
Ne |
Předvolba. |
number |
String (80) |
Ano |
Telefonní číslo. |
extension |
String (80) |
Ne |
Linka. |
Reprezentuje wrapper pro kolekci telefonů.
Jméno atributu |
Datový typ |
Povinné |
Popis |
phone |
List<EosPhone> |
Ne |
Kolekce telefonů. |
Reprezentuje informaci o sekundárním stromu organizačních rolí.
Jméno atributu |
Datový typ |
Povinné |
Popis |
id |
EosIdentifier |
Ano |
Identifikátor. |
name |
String (255) |
Ano |
Jméno sekundárního stromu organizačních rolí. |
code |
String (100) |
Ano |
Kód sekundárního stromu organizačních rolí. |
description |
String (2000) |
Ne |
Popis sekundárního stromu organizačních rolí. |
Reprezentuje wrapper pro kolekci informací o skundárních stromech
organizačních rolí.
Jméno atributu |
Datový typ |
Povinné |
Popis |
secondaryOrgRoleTree |
List<EosSecondaryOrgRoleTree> |
Ne |
Kolekce informací o skundárních stromech organizačních rolí. |
Reprezentuje uživatelské pole.
Jméno atributu |
Datový typ |
Povinné |
Popis |
name |
String (255) |
Ano |
Jméno uživatelského pole. |
content |
String (512) |
Ano |
Hodnota uživatelského pole. |
code |
String (255) |
Ano |
Kód uživatelského pole. |
Reprezentuje kolekci uživatelských polí.
Jméno atributu |
Datový typ |
Povinné |
Popis |
userField |
List<EosUserField> |
Ne |
Kolekce uživatelských polí. |
Reprezentuje hodnotu string atributu, výčtového atributu a selectového
atributu. Dále pak hodnoty rozsahu výčtového atributu.
Jméno atributu |
Datový typ |
Povinné |
Popis |
id |
EosIdentifier |
Ano |
Identifikátor. |
content |
String (512) |
Ano |
Samotná hodnota atributu. |
comment |
String (512) |
Ne |
Komentář hodnoty atributu. |