ISKAM

Rozdíly

Zde můžete vidět rozdíly mezi vybranou verzí a aktuální verzí dané stránky.

Odkaz na výstup diff

Obě strany předchozí revizePředchozí verze
Následující verze		Předchozí verze
napoveda_iskam_4:instalace:integrace [2012/11/28 12:02] – dubpetrnapoveda_iskam_4:instalace:integrace [2025/10/22 11:08] (aktuální) – malina
Řádek 1: Řádek 1:
 ====== Integrace se softwarovým okolím ====== ====== Integrace se softwarovým okolím ======
  
-===== Scénář =====+ISKAM umožňuje importovat data o klientech, kartách a firmách z jiných systémů. Typicky jde o univerzitní centrální registr osob, popř. studijní a zaměstnaneckou agendu a ekonomický systém. Všechny importy jsou nejsnáze realizovatelné pomocí pohledů v níže uvedených strukturách. Frekvenci předávání dat ze systému zákazníka/školy do těchto tabulek je třeba upravit dohodou mezi provozovatelem systému ISKAM a příslušným IT oddělením. Frekvence načítání dat z této tabulky do ostrých databází lze nastavit v ISKAMu a je možné i "ruční" spuštění kdykoliv.
  
-Chci zprovoznit importy a exporty dat mezi ISKAMem a dalšími systémy. 
  
-===== Postup =====+==== Import klientů (název tabulky nebo pohledu musí být KlientiImport) ====
  
-ISKAM umožňuje importovat data o klientech, kartách a firmách z jiných systémů. Typicky jde o univerzitní centrální registr osob, popř. studijní a zaměstnaneckou agendu a ekonomický systém. Všechny importy jsou nejsnáze realizovatelné pomocí pohledů v níže uvedených strukturách. Frekvenci předávání dat ze systému školy do těchto tabulek je třeba upravit dohodou mezi provozovatelem systému ISKAM a příslušným výpočetním střediskem školy. Frekvence načítání dat z této tabulky do ostrých databází lze nastavit v ISKAMu a je možné i "ruční" spuštění kdykoliv. +^ Klíč   ^ Název sloupce ^ Typ sloupce ^ Velikost ^ Smí být NULL ^ Poznámka  ^ 
- +| PRIMARY | IDIS           | varchar      |  20            |  0  | Číslo v IS zákazníka  | 
- +|    | RC           | varchar |  10            |  0  | Rodné číslo      |
-==== Import klientů ==== +
- +
-^ Klíč   ^ Název sloupce ^ Typ sloupce ^ Velikost ^ Smí být NULL ^ Poznámka ^ +
-| PRIMARY | IDIS           | varchar      |  20            |  0  | Číslo v IS školy | +
-| UNIQUE   | RC           | varchar |  10            |  0  | Rodné číslo |+
 |         | Titul         | varchar |  16            |  1  | Titul(y) | |         | Titul         | varchar |  16            |  1  | Titul(y) |
 |   | Jmeno | varchar |  50            |  1  | Křestní jméno | |   | Jmeno | varchar |  50            |  1  | Křestní jméno |
Řádek 20: Řádek 14:
 | | Pohlavi | char         |  1          |  0  | M – muž, Z – žena |  | | Pohlavi | char         |  1          |  0  | M – muž, Z – žena | 
 | | DatumNarozeni | date, datetime |  8         |  1  | Datum narození | | | DatumNarozeni | date, datetime |  8         |  1  | Datum narození |
-| | OP         | varchar |  20         |  1  | Občanský průkaz |+| | OP         | varchar |  40         |  1  | Číslo dokladu totožnosti | 
 +| | TypDokladu| smallint        |          |  1  | Nepovinný sloupec, [[napoveda_iskam_4:instalace:typyosobnihodokladu|číselník]] * |
 | | Ulice         | varchar        |  30         |  1  | Adresa bydliště | | | Ulice         | varchar        |  30         |  1  | Adresa bydliště |
 | | PSC        | varchar         |   6         |  1  |  |  | | PSC        | varchar         |   6         |  1  |  |
Řádek 31: Řádek 26:
 | | KodBanky | char        |  4         |  1  |  | | | KodBanky | char        |  4         |  1  |  |
 | | SSymbol | varchar      |  10         |  1  |  |  | | SSymbol | varchar      |  10         |  1  |  |
-| | StupenStudia | char        |  1         |  1  | Nepovinný* | +| | StupenStudia | char        |  1         |  1  |  | 
-| | Rocnik        | int        |  4         |  1  | Nepovinný* | +| | Rocnik        | int        |  4         |  1  |  | 
-| | IDFakulty    | varchar        |  10         |  1  | Nepovinný* | +| | IDFakulty    | varchar        |  10         |  1  |  | 
-| | VarSymbol    | Varchar        |  10         |  1  | Nepovinný sloupec – pokud má být jako variabilní symbol použito něco jiného než RČ |+| | VarSymbol    | Varchar        |  10         |  1  | Pokud má být jako variabilní symbol použito něco jiného než RČ, jinak ponechte NULL | 
 +| | StavStudia    | char        |  1         |  1  | * | 
 +| | ZmenaStudia   | datetime        |  1         |  1  | Nepovinný sloupec * | 
 +| | SpecialniTypOsoby  | varchar        |  4         |  1  | Nepovinný sloupec * | 
 +| | StatniPrislusnost       | char        |  3 |  1  | Kód státu dle ISO 3166-1 alpha-3 (nepovinný) |
  
  
  
-Tabulka musí obsahovat aktuální seznam osob, které se mají předávat z informačního systému školy (není třeba uchovávat historii ani osob, ani změn). Osoby se párují dle IDIS, takže by se nemělo měnit. Pokud není osoba dle IDIS nalezena, zkusí ISKAM najít osobu dle rodného čísla a při shodě aktualizuje tohoto klienta. V praxi to znamená, že se nesmí změnit současně RČ a IDIS, aby se nevytvořila duplicita.+Tabulka musí obsahovat aktuální seznam osob, které se mají předávat z informačního systému zákazníka či školy (není třeba uchovávat historii ani osob, ani změn). Osoby se párují dle IDIS, takže by se nemělo měnit. Pokud není osoba dle IDIS nalezena, zkusí ISKAM najít osobu dle rodného čísla a při shodě aktualizuje tohoto klienta. V praxi to znamená, že se nesmí změnit současně RČ a IDIS, aby se nevytvořila duplicita.
  
 Poznámky: Poznámky:
 +  * Většina údajů je nepovinná, záleží na provozovateli, která data chce/může do systému zasílat. Z důvodu provozu ve školských zařízeních obsahuje import i data o studiu, která se u komerčních zákazníků pochopitelně nevyužívají.
   * Rodné číslo je bez mezer, lomítek a pomlček. Systém netestuje jeho formální správnost (připouští i písmena). V tabulce nesmí být dvě osoby se stejným RČ (ani se nesmí taková osoba vyskytnout v historii).   * Rodné číslo je bez mezer, lomítek a pomlček. Systém netestuje jeho formální správnost (připouští i písmena). V tabulce nesmí být dvě osoby se stejným RČ (ani se nesmí taková osoba vyskytnout v historii).
-  * Sloupec OP může u cizinců obsahovat číslo pasu.+  * Sloupec OP může u cizinců obsahovat číslo pasu. Ve sloupci TypDokladu je vhodné uvést, o jaký [[napoveda_iskam_4:instalace:typyosobnihodokladu|typ dokladu]] se ve skutečnosti jedná.
   * PSČ je ve formátu 111 11.   * PSČ je ve formátu 111 11.
   * Číslo účtu je ve tvaru „123456-1234567890“ (do této podoby je předčíslí i číslo účtu doplněno nulami zleva).   * Číslo účtu je ve tvaru „123456-1234567890“ (do této podoby je předčíslí i číslo účtu doplněno nulami zleva).
   * Kód banky je číselný kód banky.   * Kód banky je číselný kód banky.
   * SSymbol je specifický symbol – sloužilo v minulosti pro čísl České Spořitelny, již nepoužívat!     * SSymbol je specifický symbol – sloužilo v minulosti pro čísl České Spořitelny, již nepoužívat!  
-  * Položky IDFakulty, StupenStudia a Rocnik musí být buď uvedeny všechny, nebo žádná. 
   * StupenStudia obsahuje pouze jeden ze znaků B (bakalářský), M (magisterský), D (doktorský) nebo C (celoživotní vzdělávání).   * StupenStudia obsahuje pouze jeden ze znaků B (bakalářský), M (magisterský), D (doktorský) nebo C (celoživotní vzdělávání).
 +  * StavStudia obsahuje jedno z písmen K (ukončené studium), N (neznámý stav studia - výchozí hodnota, necháte-li údaj NULL), P (přerušené studium), S (studuje), U (uchazeč) nebo Z (zaměstnanec).
 +  * ZmenaStudia může obsahovat datum a čas, kdy došlo ke změně údaje o stavu studia. Sloupec je nepovinný, tj. nemusí být vůbec v definici tabulky (pohledu) KlientiImport.
 +  * Uvedete-li a vyplníte-li sloupec SpecialniTypOsoby, tak při rezervaci bez pořadníku bude klientovi přidělen uvedený typ osoby (sem zadejte zkratku). Zkratka XXX znamená, že klient si nesmí udělat rezervaci bez pořadníku (blacklist).
  
  
 +Více informací o řešení případných problémů s importem klientů najdete v sekci [[napoveda_iskam_4:faq:chybaimportudatklientu|Často kladené otázky]].
  
-==== Import karet ====+ 
 +==== Import karet (název tabulky nebo pohledu musí být KartyImport) ====
  
 Jeden klient může mít více karet, které se zpravidla liší fakultou (ESID) nebo typem (studentská vs. zaměstnanecká). Jeden klient může mít více karet, které se zpravidla liší fakultou (ESID) nebo typem (studentská vs. zaměstnanecká).
  
-^ Klíč  ^ Název sloupce  ^ Typ sloupce ^ Velikost^ Smí být NULL ^ Poznámka ^ +^ Klíč  ^ Název sloupce  ^ Typ sloupce ^ Velikost^ Smí být NULL ^ Poznámka   ^ 
-|       | IDIS           | varchar     |  20     |  0           | ID majitele v IS školy |  +|       | IDIS           | varchar     |  20     |  0           | ID majitele v IS zákazníka/školy|  
-|       | ESID           | varchar     |  10     |  1           | ID firmy v ES školy    | +|       | ESID           | varchar     |  10     |  1           | ID firmy v ES zákazníka    | 
 |       | TypKarty       | varchar     |  3      |  0           | Poznámka 1             |    |       | TypKarty       | varchar     |  3      |  0           | Poznámka 1             |   
-|       | CisloKarty     | varchar     |  20     |  0           | Číslo karty pro ruční zadání – není nastaveno jako primární klíč, ale pokud má existovat více karet stejného čísla, tak by to | +|       | CisloKarty     | varchar     |  20     |  0           | Číslo karty pro ruční zadání – není nastaveno jako primární klíč, ale pokud má existovat více karet stejného čísla, tak by to měly být duplikáty. | 
 |       | CisloCipu      | varchar     |  70     |  1           | Číslo čipu tak, jak jej vrací použitá čtečka čipových karet. |  |       | CisloCipu      | varchar     |  70     |  1           | Číslo čipu tak, jak jej vrací použitá čtečka čipových karet. | 
 |       | Vydal          | varchar     |  30     |  0           | Kdo kartu vydal |  |       | Vydal          | varchar     |  30     |  0           | Kdo kartu vydal | 
Řádek 69: Řádek 73:
  
  
-Poznámka 1: Typ karty v informačním systému školy může být jiný, než typ karty v systému ISKaM – převod mezi těmito typy je potřeba vyřešit v rámci definice tohoto pohledu.+Poznámka 1: Typ karty v informačním systému zákazníka/školy může být jiný, než typ karty v systému ISKaM – převod mezi těmito typy je potřeba vyřešit v rámci definice tohoto pohledu.
  
-==== Import firem ====+==== Import firem (název tabulky nebo pohledu musí být FirmyImport) ====
  
 Je potřeba řešit jen v případě, kdy je prováděn export faktur do ekonomického systému. Struktura tabulky je: Je potřeba řešit jen v případě, kdy je prováděn export faktur do ekonomického systému. Struktura tabulky je:
  
 ^ Klíč    ^ Název sloupce     ^ Typ sloupce ^ Velikost  ^ Smí být NULL ^ Poznámka                          ^ ^ Klíč    ^ Název sloupce     ^ Typ sloupce ^ Velikost  ^ Smí být NULL ^ Poznámka                          ^
-| PRIMARY | ESID              | varchar     |   10      |        0     | Číslo firmy v ES školy     |+| PRIMARY | ESID              | varchar     |   10      |        0     | Číslo firmy v ES      |
 | UNIQUE  | IC                | varchar     |   50      |        0     | IČ (dříve IČO) | | UNIQUE  | IC                | varchar     |   50      |        0     | IČ (dříve IČO) |
 |         | DIC               | varchar     |   50      |        1     | DIČ | |         | DIC               | varchar     |   50      |        1     | DIČ |
Řádek 82: Řádek 86:
 |         | Nazev             | varchar     |   60      |        0     | Obchodní název firmy | |         | Nazev             | varchar     |   60      |        0     | Obchodní název firmy |
 |         | SidloUlice        | varchar     |   30      |        1     | Sídlo firmy | |         | SidloUlice        | varchar     |   30      |        1     | Sídlo firmy |
-|         | SidloPSC          | varchar     |    6      |        1     |   | +|         | SidloPSC          | varchar     |    6      |        1     | :::  | 
-|         | SidloObec         | varchar     |   50      |        1     |   | +|         | SidloObec         | varchar     |   50      |        1     | :::  | 
-|         | SidloKodStatu     | char        |    3      |        1     |   |+|         | SidloKodStatu     | char        |    3      |        1     | :::  |
 |         | FakturaceUlice    | varchar     |   30      |        1     | Fakturační adresa | |         | FakturaceUlice    | varchar     |   30      |        1     | Fakturační adresa |
-|         | FakturacePSC      | varchar     |    6      |        1     |   | +|         | FakturacePSC      | varchar     |    6      |        1     | :::  | 
-|         | FakturaceObec     | varchar     |   50      |        1     |   | +|         | FakturaceObec     | varchar     |   50      |        1     | :::  | 
-|         | FakturaceKodStatu | char        |    3      |        1     |   |+|         | FakturaceKodStatu | char        |    3      |        1     | :::  |
 |         | Telefon1          | varchar     |   20      |        1     | Telefon 1 | |         | Telefon1          | varchar     |   20      |        1     | Telefon 1 |
 |         | Telefon2          | varchar     |   20      |        1     | Telefon 2 | |         | Telefon2          | varchar     |   20      |        1     | Telefon 2 |
Řádek 95: Řádek 99:
 |         | KontaktOsoba      | varchar     |   50      |        1     | Kontaktní osoba | |         | KontaktOsoba      | varchar     |   50      |        1     | Kontaktní osoba |
 |         | CisloUctu         | varchar     |   17      |        1     | Bankovní spojení | |         | CisloUctu         | varchar     |   17      |        1     | Bankovní spojení |
-|         | KodBanky          | char        |    4      |        1     |   | +|         | KodBanky          | char        |    4      |        1     | :::  | 
-|         | SSymbol           | varchar     |   10      |        1     |   |+|         | SSymbol           | varchar     |   10      |        1     | :::  |
  
 Tabulka obsahuje seznam všech firem, se kterými je instituce v obchodním kontaktu. Primárním klíčem, podle kterého se údaje párují, je číslo firmy v ekonomickém systému. IČ musí být rovněž jedinečné. Není třeba uchovávat historii. Tabulka obsahuje seznam všech firem, se kterými je instituce v obchodním kontaktu. Primárním klíčem, podle kterého se údaje párují, je číslo firmy v ekonomickém systému. IČ musí být rovněž jedinečné. Není třeba uchovávat historii.
Řádek 104: Řádek 108:
   * Parametr ESID odpovádí ESID v importu firem a IDFirmy v tabulce klientů.   * Parametr ESID odpovádí ESID v importu firem a IDFirmy v tabulce klientů.
  
-===== Další tipy a triky =====+=== Problém s certifikátem SafeQ === 
 +Řada univerzit v poslední době (rok 2025) přecházela na nové certifikáty vydané Hellenic Academic and Research Institutions CA. Po přechodu se potýkala s problémem s napojením SafeQ na ISKAM. Problém je v tom, že SafeQ nedůvěřuje těmto certifikátům a je zapotřebí naimportovat i mezilehlé certifikáty a prohlásit je za důvěryhodné. Zejména by se mělo jednat o  HARICA TLS RSA Root CA 2021. 
 + 
 +ApS Brno nemůže bohužel mluvit za stranu SafeQ, ale třeba Vám tato informace bude nápomocna v řešení. 
 + 
 +Jeden z uživatelů problém vyřešil takto: našel 3 uložiště ve formátu souborů cacerts. Mohly to být i nějaké další soubory, ale zjevně to byly tyhle: 
 +  * C:\SafeQ6\Management\java\lib\security\cacerts 
 +  * C:\SafeQ6\SPOC\java\lib\security\cacerts 
 +  * C:\SafeQ6\YPS\java\lib\security\cacerts 
 +Do nich jsem přidal 2 mezilehlé odtud: https://pki.cesnet.cz/cs/certificates-tcs.html 
 +HARICA TLS RSA Root CA 2021 a GEANT TLS RSA 1 root tam byl. Možná by stačil jeden a možná jen do některého cacerts, ale asi to ničemu nevadí. Dělal jsem to přes keystore explorer abych se nemusel trápit s keytoolem v cmd. 
 +Po restartu SafeQ jsem zkusil se přihlásit na studenta, co předtím nešel a už to chyby nehlásí. 
  
-~~DISCUSSION~~