Patří do KategorieModulyWebuKiv

• Na titulce je pod nadpisem Věda a výzkum (resp. Research na anglické) odkaz s překvapivým názvem autorizovaný software.

• Na titulce je pod nadpisem Výzkum (resp. Research na anglické) odkaz s překvapivým názvem autorizovaný software.

• Taktéž na intranetu KIV je takový odkaz.

Přihlášení:

Jak se najde autorizovaný software

• Na titulce je pod nadpisem Výzkum (resp. Research na anglické) odkaz s překvapivým názvem autorizovaný software.
• Odjinud: V menu vlevo najit Vyzkum > Software

Zadání/úprava produktu:

Všechny stránky s autoriz.sw. mají lokální menu dole (na konci stránky) vpravo; přes něj se dělá většina akcí.

• Do aplikace nedávejte velké soubory (nad cca 50MB; soubory se ukládají do databáze). Pokud je vaše aplikace obsahuje, pak do textového souboru (README apod), který nahrajete, napište URL na kterém je možné stáhnout zbytek. (Nepište URL přímo do popisu, lidi by obcházeli stahování přes /vyzkum/software/ kde se logují počty stažení.)

• Do aplikace nedávejte velké soubory (nad cca 50MB; soubory se ukládají do databáze). Pokud je vaše aplikace obsahuje, pak do textového souboru (README apod), který nahrajete, napište URL na kterém je možné stáhnout zbytek.

• Do aplikace nedávejte velké soubory (nad cca 50MB) - pokud je vaše aplikace obsahuje. Vyřešte to tak, že do textového souboru (README apod), který nahrajete, napište URL na kterém je možné stáhnout zbytek.

• Jak mají vypadat zadávané texty a soubory viz odkazy v lokálním menu vpravo dole.

• Jak mají vypadat zadávané texty a soubory viz Attach:vzor-autorizovaneho-software.png.

• Jak mají vypadat zadávané texty a soubory viz Attach:vzor-autorizovaneho-software.png a Attach:styl-autorizovany-software.pdf.

• Jak mají vypadat zadávané texty a soubory viz Attach:vzor-autorizovaneho-software.png a

1. V menu vlevo najit Vyzkum > Software, všechny jeho stránky mají lokalni menu na konci stranky vpravo

Tytéž softwary jsou také na anglických stránkách (English > Research > Software) kde ale nejsou editační formuláře. K dispozici je také podrobná příručka.

Uživatelská příručka

Zde je stručné shrnutí postupu pro normální uživatele. Pozn: autorizovanému softwaru se v evidenční aplikaci říká "Produkt".

Přihlášení:

• Před používáním aplikace je nejprve potřeba se přihlásit - viz ManualPrihlaseni.

Zadání/úprava produktu:

Tytéž softwary jsou také na anglických stránkách (English > Research > Software) kde ale nejsou editační formuláře. K dispozici je také podrobná příručka.

1. V menu vlevo najit Vyzkum > Software, všechny jeho stránky mají lokalni menu na konci stranky vpravo

1. Autor odešle (přes tlačítko Odeslat ke schválení v editaci produktu) žádost o schválení - mj. odešle email schvalovateli

1. Po schválení je software k dispozici ke stažení na úvodní stránce Výzkum > Software.

Tytéž softwary jsou také na anglických stránkách (English > Research > Software) kde ale nejsou editační formuláře.

Pozn. Předchozí postup byl otestován na Apache Tomcat Version 6.0.14 na systému Windows Vista. Nastavení proměnných vystačí pro upload souboru velkého cca 100 MB. Více infromací k nastavení heap size na javahowto.blogspot.com

1. nastavte proměnné -Xms(initial heap size) a -Xmx(maximum heap size). Následující příkaz vložte někam na začátek otevřeného souboru:
   set CATALINA_OPTS=-Xms128m -Xmx512m
2. uložte soubor a restartujte Tomcat.

Následující postup popisuje, jak zvýšit velikost instance webového kontejneru Apache Tomcat:

1. otevřete soubor /bin/catalina.bat v oblíbeném textovém editoru.
2. nastavte proměnné -Xms(initial heap size) a -Xmx(maximum heap size) na následující hodnoty:

V případě, kdy bude chtít webmaster umožnit uploadování souborů větších než cca 10 MB, aplikace bude vyžadovat na webovém kontejneru více paměti a tudíž bude třeba zvýšit na něm velikost haldy, jinak bude OpenCms vyhazovat následující hlášku:

Nastavení větší velikosti paměti webového kontejneru

V případě, kdy bude chtít webmaster umožnit uploadování souborů větších než cca 10 MB, aplikace bude vyžadovat na webovém kontejneru více paměti a tudíž bude třeba zvýšit na něm velikost haldy.

• max_file_upload_size=10000

Maximální velikost souboru pro upload je možné nastavit vytvořením a vyplněním property max_file_upload_size. Tuto property je třeba nejprve definovat.

Maximální velikost souboru pro upload je možné nastavit vytvořením a vyplněním property max_file_upload_size. Tuto property je třeba nejprve definovat.
-> Příklad z beta.kiv.zcu.cz: Property jsem nastavil na adresář www.kiv.zcu.cz/produkty/

• max_file_upload_size=10000

Pokud property není nastavena, je maximální velikost souboru pro upload omezená pouze velikostí paměti webového kontejneru.

Nastavení maximální velikosti uploadovaného souboru produktu

Počet zobrazovaných nejstahovanějších produktů lze na této stránce redukovat nastavením property max_file_upload_size. Tuto property je třeba nejprve definovat.
Na souboru seznam-nejstahovanejsi.html pak této property nastavím hodnotu např:

• pocet_produktu=5

Pokud property není nastavena, zobrazuje se seznam všech schválených produktů v systému.

Před používáním aplikace je nejprve potřeba se přihlásit - viz ManualPrihlaseni.

Poznámka: při registraci uživatelů do OpenCms je potřeba, aby se jim nastavily

• skupina Kiv Staff a Users (jinak se nepřihlásí)
• po prvním přihlášení default web KIV (jinak je to hodí na OpenCms welcome stránku)

Z předchozí kapitoly vyplývá, že nepřihlášený uživatel nebude mít přístupová práva ke složce, v níž jsou uloženy soubory produktů. Tzn., že si nebude moci stáhnout soubory ani již publikovaného produktu. Z tohoto důvodu bylo třeba vytvořit pomocného uživatele pro download produktů - ten musí být typu WebUser nikoli normální uživatel.

Zde je stručné shrnutí postupu, k dispozici je také podrobná příručka. Pozn: autorizovanému softwaru se v evidenční aplikaci říká "Produkt".

1. Vytvořit, případně upravit, produkt - název, popis (je možné použít HTML), upload soubory, výběr licence

Práva pro adresář se soubory

Pokud chce uživatel jakkoli editovat produkty, musí se přihlásit do systému OpenCms jako schvalovatel, vlastník, nebo administrátor. K produktům se však vkládají i údaje o uživateli, který je editoval a tyto údaje se berou z DAO osoby. Proto je třeba, aby pro uživatele, který edituje produkty, existovala v OsobaDao osoba se stejným loginname, jakým se přihlašuje editující uživatel do systému OpenCms.

Pokud chce uživatel jakkoli editovat produkty, musí se přihlásit do systému OpenCms jako schvalovatel, vlastník, nebo administrátor. K produktům se však vkládají i údaje o uživateli, který je editoval a tyto údaje se berou z DAO osoby. Proto je třeba, aby pro uživatele, který edituje produkty, existovala v OsobaDao osoba se stejným loginname jakým se přihlašuje editující uživatel do systému OpenCms.

Pokud chce uživatel jakkoli editovat produkty, musí se přihlásit do systému OpenCms jako schvalovatel, vlastník, nebo administrátor. K produktům se však vkládají i údaje o uživateli, který je editoval a tyto údaje se berou z DAO osoby. Proto je třeba, aby pro uživatele, který edituje produkty existovala v OsobaDao osoba se stejným loginname jakým se přihlašuje editující uživatel do systému OpenCms

Soubor mail.jar je poté potřeba nakopírovat do [OPENCMS_HOME]/WEB-INF/lib/

Soubor mail.jar je pot0 potřeba nakopírovat do [OPENCMS_HOME]/WEB-INF/lib/

• mail.jar.zip

• mail.jar Δ

Tento soubor je potřeba nakopírovat do [OPENCMS_HOME]/WEB-INF/lib/

U odesílání mailů jsem také narazil na problém, že na beta.kiv.zcu.cz byla mezi knihovnami OpenCms verze 6.2.3 zastaralá knihovna javamail-API. Verzi, s kterou již odesílání funguje přikládám zde: mail.jar Δ Tento soubor je potřeba nakopírovat do [OPENCMS_HOME/WEB-INF/lib/]

• aktuální verze modulu je cz.zcu.kiv.produkty_0.24.zip

[@

    <cms:include page="/system/modules/cz.zcu.kiv.produkty/pages/produkty/detail.jsp" />

Modul Produkty je vytvořen ve 2 jazykových verzích - české a anglické. Vytvoření obou lokalizací popíšu podle toho, jak jsem je vytvořil na beta.kiv.zcu.cz

1. Česká verze

1. Anglická verze

• Není třeba vyplňovat username a password, protože mail je odesílán z domény zcu.cz.

Počet zobrazovaných nejstahovanějších produktů lze na této stránce redukovat nastavením property pocet_produktu. Tuto property je třeba nejprve definovat.
Na souboru seznam-nejstahovanejsi.html pak této property nastavím hodnotu např:

• pocet_produktu=5

Pokud property není nastavena, zobrazuje se seznam všech schválených produktů v systému.

• Je třeba provést nastavení i v anglické lokalizaci mail_en.properties
• Není třeba vyplňovat username a password, protože mail je odesílán z domény zcu.cz.

Nastavení počtu produktů. které se zobrazí na stránce seznam-nejstahovanejsi.html

    smtp=smtp.zcu.cz
    odesilatel=email@kiv.zcu.cz
    username=
    password=
    port=25
    tls.enable=false
    auth=false
    subject=Navr\u017Een\u00ED produktu

Při navržení produktu na schválení se provede akce odeslání emailu o navržení na schválení schvalovatelům.
Aby se email odeslal, je třeba správně nastavit SMTP server. Nastavení serveru je uloženo v souboru classes/cz/zcu/kiv/produkty/mail.properties.
Doporučené nastavení:

smtp=smtp.zcu.cz
odesilatel=email@kiv.zcu.cz
username=
password=
port=25
tls.enable=false
auth=false
subject=Navr\u017Een\u00ED produktu

Nastavenípočtu produktů. které se zobrazí na stránce seznam-nejstahovanejsi.html

• skupině TestDownload nastavíme na Allowed práva r+v

Z předchozí kapitoly vyplývá, že nepřihlášený uživatel nebude mít přístupová práva ke složce, v níž jsou uloženy soubory produktů. Tzn., že si nebude moci stáhnout soubory ani již publikovaného produktu. Z tohoto důvodu bylo třeba vytvořit pomocného uživatele pro download produktů.
Oproti schvalovatelům a vlastníkům však údaje o download uživateli jsou umístěny do souboru classes/cz/zcu/kiv/produkty/access.properties ve složce modulu. V tomto souboru je třeba definovat properties:

• download_username
• download_password

Z předchozí kapitoly vyplývá, že nepřihlášený uživatel nebude mít přístupová práva ke složce, v níž jsou uloženy soubory produktů. Tzn., že si nebude moci stáhnout soubory ani již publikovaného produktu. Z tohoto důvodu bylo třeba vytvořit pomocného uživatele pro download produktů

Nastavení SMTP serveru pro odesílání e-mailů o navržení produktů na schválení

Nastavenípočtu produktů. které se zobrazí na stránce seznam-nejstahovanejsi.html

• role_schvalovatele

TBD

TBD

TBD

Nastavení lokalizace modulu Produkty

TBD

1. Všem skupinám, kterým jsme přiřadili role schvalovatelů a vlastníků nastavíme na Allowed následující práva: d+r+w+v

Nastavení pomocného uživatele pro download souborů

Nastavení SMTP serveru pro odesílání e-mailů o navržení produktů na schválení

Nastavenípočtu produktů. které se zobrazí na stránce seznam-nejstahovanejsi.html

Nastavení lokalizace modulu Osoby

1. Všechna přístupová práva pro skupinu Guests nastavíme na denied. Navíc je nutné zaškrtnout volbu Overwrite inherited.

• role_vlastnici=TestClenove

Jelikož se produkty stahují přes licenci, neměl by být umožněn přímý přístup do adresáře www.kiv.zcu.cz/produkty/data/, kde jsou uloženy soubory produktů. K tomu je třeba upravit permissions k tomuto adresáři.

1. Všechna přístupová práva pro skupinu Guests nastavíme na denied.
2. Všem skupinám, kterým jsme přiřadili role schvalovatelů a vlastníků nastavíme na Allowed následující práva: d+r+w+v

• TestVedeni
• TestClenove
• TestNeutral

Na adresáři www.kiv.zcu.cz/produkty pak těmto properties přiřadím hodnotu. Každá role přitom může být přidělena více skupinám - pro tento případ v property odděluji jednotlivé skupiny znakem ';'

Na adresáři www.kiv.zcu.cz/produkty pak těmto properties přiřadím hodnotu. Každá role přitom může být přidělena více skupinám - pro tento případ v property odděluji jednotlivé skupiny znakem ;

Aby jsme využili všechny funkce modulu, je třeba přiřadit OpenCms skupinám tyto role.

• upload_folder_path=/produkty/data/

Nastavení přístupových práv na modul Produkty

Na Modulu Produkty následující role uživatelů:

• schvalovatelé - mohou vytvářet, editovat, schvalovat produkty k publikaci atd.
• vlastníci - mohou vytvářet, editovat produkty atd. Nemohou schvalovat produkty.

Aby jsme využili všechny funkce modulu, je třeba určit OpenCms skupinám tyto role. Na beta.kiv.zcu.cz jsem nejprve definoval nové property:

• role_shcalovatele
• role_vlastnici

Na adresáři www.kiv.zcu.cz/produkty pak těmto properties přiřadím hodnotu. Každá role přitom může být přidělena více skupinám - pro tento případ v property odděluji jednotlivé skupiny znakem ;

• upload_folder_path=/produkty/data/

• fotky_osob_folder_path=/osoby/fotografie/

@]

Nastavení adresáře pro ukládání souborů produktu

Produktům je možné přiřadit soubor, který se uploaduje do OpenCms VFS. Je tedy třeba nastavit property upload_folder_path u adresáře ve kterém se nachází JSP pracující s produkty. Na beta.kiv.zcu.cz jsem tuto property nastavil na adresář www.kiv.zcu.cz/produkty/. Property udává, kam se ukládají uploadované soubory.

Tato property defaultně není definovaná, takže je nutné ji nejprve definovat. Hodnota property se pak vyplní podle toho, kam se budou soubory do VFS ukládat (hodnota bude cesta k existujícímu adresáři). Příklad z beta.kiv.zcu.cz: Vytvořil jsem adresář www.kiv.zcu.cz/produkty/data/. Property jsem nastavil na adresář www.kiv.zcu.cz/produkty/.

• fotky_osob_folder_path=/osoby/fotografie/

Po importování modulů je nutné vytvořit JSP stránky na OpenCms frontendu. Na beta.kiv.zcu.cz jsem následující stránky do adresáře www.kiv.zcu.cz/produkty/.
Tyto JSP stránky mají opravdu příponu .html.

• seznam.html

Každá z těchto JSP stránek obsahuje pouze include stejnojmenného JSP z modulu cz.zcu.kiv.produkty tedy např. JSP detail.jsp obsahuje následující kód:

    
    <?xml version="1.0" encoding="UTF-8"?>
    <%@ taglib prefix="cms" uri="http://www.opencms.org/taglib/cms" %>

    <cms:include page="/system/modules/cz.zcu.kiv.osoby/pages/produkty/detail.jsp" />

1. Importujte do Opencms modul cz.zcu.kiv.produkty

Vytvoření JSP resources na frontendu

Po importování modulů je nutné vytvořit JSP stránky na OpenCms frontendu. Na beta.kiv.zcu.cz jsem následující stránky do adresáře www.kiv.zcu.cz/produkty/.

• detail.html
• edit.html
• produkt-download.htmlpozice-edit.jsp
• schvaleni.htmlpredmety-edit.jsp
• seznam-nejstahovanejsi.html
• seznam.html

Tento návod popisuje instalaci modulu cz.zcu.kiv.produkty na beta.kiv.zcu.cz. Jelikož je modul závislý na konkrétní DB na KIV, nebude fungovat v systému bez přístupu k této DB.\\

• aktuální verze modulu je cz.zcu.kiv.produkty_0.21.zip

1. Pokud ještě nemáte importovaný, importujte do OpenCms modul cz.zcu.kiv.common

1. Importujte do Opencms modul cz.zcu.kiv.produkty

Tento návod popisuje instalaci modulu cz.zcu.kiv.osoby na beta.kiv.zcu.cz. Jedná se však taktéž o obecný návod nasazení tohoto modulu do redakčního systému OpenCms.
Nutná podmínka pro instalaci tohoto modulu: V OpenCms musí být nainstalován aplikační framework Spring.

• aktuální verze modulu je cz.zcu.kiv.osoby_0.16.zip

Importování modulů

Pro instalaci modulu je třeba provést následující kroky:

1. Importujte do OpenCms modul cz.zcu.kiv.common

1. Importujte do Opencms modul cz.zcu.kiv.osoby