== O aplikaci ==
Informační systém enTeam zajišťuje řízení a správu firemních dokumentů, komunikaci uvnitř pracovního týmu a flexibilní automatizaci firemních procesů. 
Webové rozhraní informačního systému enTeam je možné provozovat jako (popis zprovoznění každé z možností je uveden v samostatné kapitole tohoto postupu):
* službu operačního systému Windows, nebo
* aplikaci v rámci webového serveru Internet Information Services (IIS)

Instalační soubory webového rozhraní jsou součástí ZIP archivu CD (verze aplikace enTeam). V návodu jsou uvedeny relativní cesty k souborům a adresářům (vždy začínají adresářem {{FileNameZip|enTeam.WebApi}}</code>, tj. adresářem umístěném na první úrovni vnoření v uvedeném archivu). 
Pro přehlednost jsou názvy souborů a adresářů v celém postupu instalace označeny {{FileName|technickým písmem}}. Názvy adresářů a souborů obsažené v uvedeném ZIP archivu jsou navíc zvýrazněny {{FileNameZip|červenou barvou}}. 
Dále jsou v tomto postupu uvedeny příklady částí souborů. Takové texty jsou označeny {{FileCont|modrou barvou}}. 

== Instalace webového rozhraní ==
=== Předpoklady ===
Webové aplikační rozhraní (webové API) informačního systému enTeam může být provozováno na serveru splňujícím předpoklady uvedené na stránce [[Předpoklady_instalace_webového_API|Předpoklady instalace webového API]].

===Služba OS Windows===
Instalace webového rozhraní enTeam jako služby OS Windows je zajištěna v rámci instalace nové verze enTeam. Nedaří-li se po instalaci nové verze enTeam službu webového API nastartovat, kontaktujte prosím technickou podporu společnosti Leviom.

===Aplikace v rámci webového serveru Internet Information Services (IIS)===
Instalaci webového rozhraní enTeam jako aplikace v rámci webového serveru Internet Information Services (IIS) je třeba provést manuálně podle následujícího postupu.

====Postup instalace====
Instalace sestává z následujících kroků:
<ol>
<li> Vytvořit adresář {{FileName|enTeam.WebApi}} v kořenovém adresáři webového serveru (např. {{FileName|c:\inetpub\wwwroot}})</li>
<li> Zkopírovat obsah adresáře {{FileName|enTeam.WebApi\bin}} do adresáře {{FileName|enTeam.WebApi}}, vytvořeného v předchozím kroku</li>
<li> V IIS Manageru přidat nový aplikační pool pro webové API (IIS Manager > Server > Application Pools > Add Application Pool…) 
[[Soubor:AddAppPool.png|Add Application Pool]]
</li>
<li> V rozšířených nastaveních aplikačního poolu musí být nastaveno
* .NET CLR Version = No Managed Code
* Enable 32-Bit Applications = true
* Identity = Local System
[[Soubor:AdvancedSettings.png|Advanced Settings]]
</li>
<li> V IIS Manageru vytvořit novou webovou stránku pro webové API (pojmenovanou např. enTeam.WebApi) a přiřadit jí vlastní port (např. 8088). 
[[Soubor:AddWebsite.png|522px|Add Website]] 
 
{{Note|Poznámka: Pokud je uvedený port na serveru již obsazen jinou aplikací, použijte libovolný jiný. Zvolený port je ale nutné reflektovat ve všech krocích tohoto postupu.}} 
{{Note|Poznámka: Zvolený port musí být dostupný ze všech zařízení, kde má být provozováno webové rozhraní aplikace enTeam nebo aplikace enTeamUI.}} 
{{Note|Poznámka: Z důvodu zabezpečení aplikace důrazně doporučujeme, aby webové rozhraní aplikace enTeam bylo provozováno výhradně na protokolu HTTPS (viz [[Přesměrování_nešifrované_komunikace_na_protokol_HTTPS|Přesměrování nešifrované komunikace na protokol HTTPS]]) a zvolený port byl dostupný pouze v rámci firemní sítě, příp. po připojení do VPN.}}
</li>
</ol>

====Nastavení webového API====
Pro zajištění správné funkčnosti webového rozhraní enTeam je třeba upravit konfiguraci následujících souborů.

=====Soubor appsettings.json=====
V aplikaci webového API nastavte soubor {{FileName|appsettings.json}} dle následujícího postupu.
<ol>
<li> Pokud v adresáři aplikace webového API dosud takový soubor nemáte, pak jej vytvořte zkopírováním souboru {{FileName|appsettings.Template.json}} 
{{Note|Poznámka: Klíče (ve struktuře JSON souboru), které začínají znakem (nebo více znaky) #, jsou považovány za zakomentované a slouží pouze jako ilustrace možného nastavení. Po nastavení hodnot v souboru {{FileName|appsettings.json}}, je možné zakomentované řádky zcela odstranit (pozor ale na případné porušení syntaxe JSON, např. čárky mezi vlastnostmi)}}
</li>
<li> Pokud chcete použít nastavení připojení k databázi ve standardním INI aplikace enTeam (doporučená varianta), zkontrolujte, že soubor {{FileName|appsettings.json}} neobsahuje klíč {{FileCont|ConnectionStrings}}
</li>
<li> Pokud nelze použít hodnoty načtené z INI, nastavte přístup k databázím aplikace enTeam uvnitř klíče {{FileCont|ConnectionStrings > Default}} a její vlastnosti {{FileCont|Provider}} a {{FileCont|ConnectionString}} 
{{Note|Poznámka: Pokud jsou jednotlivé (nebo všechny) evidence rozděleny do samostatných databází, je třeba klíč Default nahradit za klíče WebApiDb, DataDictionaryDb, ScriptExDb, UserDb a WorkflowManagerDb a každému klíči korektně nastavit vlastnosti Provider a ConnectionString.}}
</li>
</ol> 
{{Note|Poznámka: V případě databázového serveru Firebird obsahuje vlastnost {{FileCont|ConnectionString}} plnou cestu k souboru databáze (např. {{FileName|C:\enTeam\Files\Data\enTeam.fdb}}). Aby byla aplikace webového API schopna vlastnost {{FileCont|ConnectionString}} přečíst, je třeba zpětná lomítka v cestě k souboru „zdvojit“. Cesta k databázi pak bude v hodnotě vlastnosti {{FileCont|ConnectionString}} např. tato: 
{{FileCont|1="ConnectionString":"Database=SERVER:C:\\enTeam\\Files\\Data\\enTeam.fdb;…"}}}} 

=====INI soubor webového API=====
Webové API pro svůj běh potřebuje pozměněné INI oproti desktopu. Vytvořte kopii souboru serie_m.ini, ke které bude přistupovat pouze webové API (např. {{FileName|<enTeamAdresar>\Ini\serie_m.WebApi.ini}}) a přidejte do něj následující obsah 
{{FileCont|1=[M/TeamBridge] 
ServerEngine=True}}

=====Soubor web.config=====
Pro běh webového API je třeba nastavit proměnnou prostředí SERIEM tak, aby odkazovala na soubor {{FileName|serie_m.WebApi.ini}} (viz [[#INI soubor webového API]]). Toho lze docílit úpravou souboru {{FileName|web.config}} (uvnitř elementu {{FileCont|aspNetCore)}} dle následujícího postupu:
<ol>
<li>
Pokud v adresáři aplikace webového API dosud takový soubor nemáte, pak jej vytvořte zkopírováním souboru {{FileName|web.Template.config}}
</li>
<li>
Správně nastavte proměnnou SERIEM v souboru {{FileName|web.config}}
Příklad nastavení proměnné SERIEM: 
{{FileCont11Lines |
1=<aspNetCore |
2=  processPath="c:\Program Files (x86)\dotnet\dotnet.exe" |
3=  arguments=".\Leviom.enTeam.WebApi.dll" |
4=  stdoutLogEnabled="false" |
5=  stdoutLogFile=".\logs\stdout"> |
6=    <environmentVariables> |
7=        <environmentVariable |
8=          name="SERIEM" |
9=          value="<enTeamAdresar>\Ini\serie_m.WebApi.ini" /> |
10=    </environmentVariables> |
11=</aspNetCore>}} 

Používáte-li 64bitový OS, zajistěte, aby se používala x86 varianta programu dotnet.exe. Nejjednodušší je upravit soubor {{FileName|web.config}} tak, že nastavíte plnou cestu k programu v atributu {{FileCont|processPath}} elementu {{FileCont|aspNetCore}} (viz ukázka výše).

</li>
<li>
V IIS Manageru ověřte, zda máte na serveru nainstalovaný modul WebDAV (IIS Manager > Server > Modules). Pokud se v seznamu instalovaných modulů nevyskytuje WebDAVModule, odstraňte ze souboru {{FileName|web.config}} následující sekci. 
{{FileCont3Lines |
1=<modules runAllManagedModulesForAllRequests="false"> |
2=    <remove name="WebDAVModule" /> |
3=</modules>}}
</li>
</ol>

=== Ověření funkčnosti ===
Pro ověření dostupnosti webového rozhraní vložte do internetového prohlížeče adresu, na které má být rozhraní dostupné, tedy např. 
<nowiki>https://enteam.<doména>.cz</nowiki> 
Pokud se v prohlížeči zobrazí přihlašovací stránka webového rozhraní informačního systému enTeam a do aplikace je možné se přihlásit, je webové rozhraní nainstalováno správně. 
[[Soubor:LoginToWebEnteam.png|Login to enTeam]] 

Pokud není ověření funkčnosti aplikace úspěšné, pokračujte zjištěním příčiny chyby dle [[#Ověření funkčnosti webového API končí chybou 500 nebo 502]] a po vyřešení problému znovu ověřte funkčnost aplikace z internetového prohlížeče.

== Často kladené otázky (FAQ) ==

=== Ověření funkčnosti webového API končí chybou 500 nebo 502 ===
Pokud ověření funkčnosti webového API dle kapitoly [[#Ověření funkčnosti]] končí chybou 500 Internal Server Error, příp. 502 Bad Gateway, lze příčinu chyby zjistit dle následujícího postupu:
<ol>
<li> Otevřete aplikaci Příkazová řádka (cmd.exe)
</li>
<li> V Příkazové řádce přejděte do adresáře aplikace, ve které dochází k chybě, příkazem:
{{Command|cd <AplikaceAdresar>}} 
V příkazu nahraďte 
{{Command|<AplikaceAdresar>}} za plnou cestu k adresáři s instalací aplikace, která vykazuje uvedenou chybu (např. {{FileName|c:\inetpub\wwwroot\enTeam.WebApi}})
</li>
<li> V Příkazové řádce spusťte požadovanou aplikaci 
{{Command|<DotnetAdresar>\dotnet.exe Leviom.enTeam.WebApi.dll}} 
V příkazu nahraďte 
{{Command|<DotnetAdresar>}} za plnou cestu k adresáři s instalací x86 varianty programu dotnet.exe (např. {{FileName|c:\Program Files (x86)\dotnet}})
</li>
</ol>
V příkazové řádce se zobrazí výpis, z něhož by mělo být možné důvod nefunkčnosti aplikace zjistit. Pokud výpisu aplikace nerozumíte, kontaktujte, prosím, technickou podporu společnosti Leviom.

Pokud aplikace vypíše do příkazové řádky tento text: 
{{Command|1=Hosting environment: Production 
Content root path: c:\inetpub\wwwroot\enTeam.WebApi (může se lišit) 
Now listening on: <nowiki>http://localhost:5000</nowiki> 
Application started. Press Ctrl+C to shut down.}}, 
byly odstraněny všechny chyby a aplikace je plně funkční. V takovém případě ji lze v Příkazové řádce ukončit stiskem Ctrl+C a znovu ověřit její funkčnost z webového prohlížeče dle kapitoly [[#Ověření funkčnosti]].

2025-08-29T13:55:34Z

EnTeamAdmin: /* Služba OS Windows */

== O aplikaci ==
Informační systém enTeam zajišťuje řízení a správu firemních dokumentů, komunikaci uvnitř pracovního týmu a flexibilní automatizaci firemních procesů. 
Webové rozhraní informačního systému enTeam je možné provozovat jako (popis zprovoznění každé z možností je uveden v samostatné kapitole tohoto postupu):
* službu operačního systému Windows, nebo
* aplikaci v rámci webového serveru Internet Information Services (IIS)

Instalační soubory webového rozhraní jsou součástí ZIP archivu CD (verze aplikace enTeam). V návodu jsou uvedeny relativní cesty k souborům a adresářům (vždy začínají adresářem {{FileNameZip|enTeam.WebApi}}</code>, tj. adresářem umístěném na první úrovni vnoření v uvedeném archivu). 
Pro přehlednost jsou názvy souborů a adresářů v celém postupu instalace označeny {{FileName|technickým písmem}}. Názvy adresářů a souborů obsažené v uvedeném ZIP archivu jsou navíc zvýrazněny {{FileNameZip|červenou barvou}}. 
Dále jsou v tomto postupu uvedeny příklady částí souborů. Takové texty jsou označeny {{FileCont|modrou barvou}}. 

== Instalace webového rozhraní ==
=== Předpoklady ===
Webové aplikační rozhraní (webové API) informačního systému enTeam může být provozováno na serveru splňujícím předpoklady uvedené na stránce [[Předpoklady_instalace_webového_API|Předpoklady instalace webového API]].

===Služba OS Windows===
Instalace webového rozhraní enTeam jako služby OS Windows je zajištěna v rámci instalace nové verze enTeam. Nedaří-li se po instalaci nové verze enTeam službu webového API nastartovat, kontaktujte prosím technickou podporu společnosti Leviom.

=== Aplikace v rámci webového serveru Internet Information Services (IIS) ===
Instalaci webového rozhraní enTeam jako aplikace v rámci webového serveru Internet Information Services (IIS) je třeba provést manuálně podle následujícího postupu.

==== Postup instalace ====
Instalace sestává z následujících kroků:
<ol>
<li> Vytvořit adresář {{FileName|enTeam.WebApi}} v kořenovém adresáři webového serveru (např. {{FileName|c:\inetpub\wwwroot}})</li>
<li> Zkopírovat obsah adresáře {{FileName|enTeam.WebApi\bin}} do adresáře {{FileName|enTeam.WebApi}}, vytvořeného v předchozím kroku</li>
<li> V IIS Manageru přidat nový aplikační pool pro webové API (IIS Manager > Server > Application Pools > Add Application Pool…) 
[[Soubor:AddAppPool.png|Add Application Pool]]
</li>
<li> V rozšířených nastaveních aplikačního poolu musí být nastaveno
* .NET CLR Version = No Managed Code
* Enable 32-Bit Applications = true
* Identity = Local System
[[Soubor:AdvancedSettings.png|Advanced Settings]]
</li>
<li> V IIS Manageru vytvořit novou webovou stránku pro webové API (pojmenovanou např. enTeam.WebApi) a přiřadit jí vlastní port (např. 8088). 
[[Soubor:AddWebsite.png|522px|Add Website]] 
 
{{Note|Poznámka: Pokud je uvedený port na serveru již obsazen jinou aplikací, použijte libovolný jiný. Zvolený port je ale nutné reflektovat ve všech krocích tohoto postupu.}} 
{{Note|Poznámka: Zvolený port musí být dostupný ze všech zařízení, kde má být provozováno webové rozhraní aplikace enTeam nebo aplikace enTeamUI.}} 
{{Note|Poznámka: Z důvodu zabezpečení aplikace důrazně doporučujeme, aby webové rozhraní aplikace enTeam bylo provozováno výhradně na protokolu HTTPS a zvolený port byl dostupný pouze v rámci firemní sítě, příp. po připojení do VPN.}}
</li>
</ol>

==== Nastavení webového API ====

===== Soubor appsettings.json =====
V aplikaci webového API nastavte soubor {{FileName|appsettings.json}} dle následujícího postupu.
<ol>
<li> Pokud v adresáři aplikace webového API dosud takový soubor nemáte, pak jej vytvořte zkopírováním souboru {{FileName|appsettings.Template.json}} 
{{Note|Poznámka: Klíče (ve struktuře JSON souboru), které začínají znakem (nebo více znaky) #, jsou považovány za zakomentované a slouží pouze jako ilustrace možného nastavení. Po nastavení hodnot v souboru {{FileName|appsettings.json}}, je možné zakomentované řádky zcela odstranit (pozor ale na případné porušení syntaxe JSON, např. čárky mezi vlastnostmi)}}
</li>
<li> Pokud chcete použít nastavení připojení k databázi ve standardním INI aplikace enTeam (doporučená varianta), zkontrolujte, že soubor {{FileName|appsettings.json}} neobsahuje klíč {{FileCont|ConnectionStrings}}
</li>
<li> Pokud nelze použít hodnoty načtené z INI, nastavte přístup k databázím aplikace enTeam uvnitř klíče {{FileCont|ConnectionStrings}}. Jde o vlastnosti {{FileCont|WebApiDb}}, {{FileCont|DataDictionaryDb}}, {{FileCont|ScriptExDb}}, {{FileCont|UserDb}} a {{FileCont|WorkflowManagerDb}} a jejich vlastnosti {{FileCont|Provider}} a {{FileCont|ConnectionString}} 
{{Note|Poznámka: Pokud jsou některé (nebo všechny) databáze spojené a vlastnosti Provider a ConnectionString by se v různých klíčích konfigurace opakovaly, lze tyto nahradit implicitním nastavením – klíčem Default.}}
</li>
</ol> 
{{Note|Poznámka: V případě databázového serveru Firebird obsahuje vlastnost {{FileCont|ConnectionString}} plnou cestu k souboru databáze (např. {{FileName|C:\enTeam\Files\Data\enTeam.fdb}}). Aby byla aplikace webového API schopna vlastnost {{FileCont|ConnectionString}} přečíst, je třeba zpětná lomítka v cestě k souboru „zdvojit“. Cesta k databázi pak bude v hodnotě vlastnosti {{FileCont|ConnectionString}} např. tato: 
{{FileCont|1="ConnectionString":"Database=SERVER:C:\\enTeam\\Files\\Data\\enTeam.fdb;…"}}}} 

===== INI soubor webového API =====
Webové API pro svůj běh potřebuje pozměněné INI oproti desktopu. Vytvořte kopii souboru serie_m.ini, ke které bude přistupovat pouze webové API (např. {{FileName|<enTeamAdresar>\Ini\serie_m.WebApi.ini}}) a přidejte do něj následující obsah 
{{FileCont|1=[M/TeamBridge] 
ServerEngine=True}}

===== Soubor web.config =====
Pro běh webového API je třeba nastavit proměnnou prostředí SERIEM tak, aby odkazovala na soubor {{FileName|serie_m.WebApi.ini}} (viz [[#INI soubor webového API]]). Toho lze docílit úpravou souboru {{FileName|web.config}} (uvnitř elementu {{FileCont|aspNetCore)}} dle následujícího postupu:
<ol>
<li>
Pokud v adresáři aplikace webového API dosud takový soubor nemáte, pak jej vytvořte zkopírováním souboru {{FileName|web.Template.config}}
</li>
<li>
Správně nastavte proměnnou SERIEM v souboru {{FileName|web.config}}
Příklad nastavení proměnné SERIEM: 
{{FileCont11Lines |
1=<aspNetCore |
2=  processPath="c:\Program Files (x86)\dotnet\dotnet.exe" |
3=  arguments=".\Leviom.enTeam.WebApi.dll" |
4=  stdoutLogEnabled="false" |
5=  stdoutLogFile=".\logs\stdout"> |
6=    <environmentVariables> |
7=        <environmentVariable |
8=          name="SERIEM" |
9=          value="<enTeamAdresar>\Ini\serie_m.WebApi.ini" /> |
10=    </environmentVariables> |
11=</aspNetCore>}} 

Používáte-li 64bitový OS, zajistěte, aby se používala x86 varianta programu dotnet.exe. Nejjednodušší je upravit soubor {{FileName|web.config}} tak, že nastavíte plnou cestu k programu v atributu {{FileCont|processPath}} elementu {{FileCont|aspNetCore}} (viz ukázka výše).

</li>
<li>
V IIS Manageru ověřte, zda máte na serveru nainstalovaný modul WebDAV (IIS Manager > Server > Modules). Pokud se v seznamu instalovaných modulů nevyskytuje WebDAVModule, odstraňte ze souboru {{FileName|web.config}} následující sekci. 
{{FileCont3Lines |
1=<modules runAllManagedModulesForAllRequests="false"> |
2=    <remove name="WebDAVModule" /> |
3=</modules>}}
</li>
</ol>

=== Ověření funkčnosti ===
Pro ověření dostupnosti webového rozhraní vložte do internetového prohlížeče adresu, na které má být rozhraní dostupné, tedy např. 
<nowiki>https://enteam.<doména>.cz</nowiki> 
Pokud se v prohlížeči zobrazí přihlašovací stránka webového rozhraní informačního systému enTeam a do aplikace je možné se přihlásit, je webové rozhraní nainstalováno správně. 
[[Soubor:LoginToWebEnteam.png|Login to enTeam]] 

Pokud není ověření funkčnosti aplikace úspěšné, pokračujte zjištěním příčiny chyby dle [[#Ověření funkčnosti webového API končí chybou 500 nebo 502]] a po vyřešení problému znovu ověřte funkčnost aplikace z internetového prohlížeče.

== Často kladené otázky (FAQ) ==

=== Ověření funkčnosti webového API končí chybou 500 nebo 502 ===
Pokud ověření funkčnosti webového API dle kapitoly [[#Ověření funkčnosti]] končí chybou 500 Internal Server Error, příp. 502 Bad Gateway, lze příčinu chyby zjistit dle následujícího postupu:
<ol>
<li> Otevřete aplikaci Příkazová řádka (cmd.exe)
</li>
<li> V Příkazové řádce přejděte do adresáře aplikace, ve které dochází k chybě, příkazem:
{{Command|cd <AplikaceAdresar>}} 
V příkazu nahraďte 
{{Command|<AplikaceAdresar>}} za plnou cestu k adresáři s instalací aplikace, která vykazuje uvedenou chybu (např. {{FileName|c:\inetpub\wwwroot\enTeam.WebApi}})
</li>
<li> V Příkazové řádce spusťte požadovanou aplikaci 
{{Command|<DotnetAdresar>\dotnet.exe Leviom.enTeam.WebApi.dll}} 
V příkazu nahraďte 
{{Command|<DotnetAdresar>}} za plnou cestu k adresáři s instalací x86 varianty programu dotnet.exe (např. {{FileName|c:\Program Files (x86)\dotnet}})
</li>
</ol>
V příkazové řádce se zobrazí výpis, z něhož by mělo být možné důvod nefunkčnosti aplikace zjistit. Pokud výpisu aplikace nerozumíte, kontaktujte, prosím, technickou podporu společnosti Leviom.

Pokud aplikace vypíše do příkazové řádky tento text: 
{{Command|1=Hosting environment: Production 
Content root path: c:\inetpub\wwwroot\enTeam.WebApi (může se lišit) 
Now listening on: <nowiki>http://localhost:5000</nowiki> 
Application started. Press Ctrl+C to shut down.}}, 
byly odstraněny všechny chyby a aplikace je plně funkční. V takovém případě ji lze v Příkazové řádce ukončit stiskem Ctrl+C a znovu ověřit její funkčnost z webového prohlížeče dle kapitoly [[#Ověření funkčnosti]].

Instalace webového rozhraní

2025-08-29T13:55:00Z

EnTeamAdmin:

== O aplikaci ==
Informační systém enTeam zajišťuje řízení a správu firemních dokumentů, komunikaci uvnitř pracovního týmu a flexibilní automatizaci firemních procesů. 
Webové rozhraní informačního systému enTeam je možné provozovat jako (popis zprovoznění každé z možností je uveden v samostatné kapitole tohoto postupu):
* službu operačního systému Windows, nebo
* aplikaci v rámci webového serveru Internet Information Services (IIS)

Instalační soubory webového rozhraní jsou součástí ZIP archivu CD (verze aplikace enTeam). V návodu jsou uvedeny relativní cesty k souborům a adresářům (vždy začínají adresářem {{FileNameZip|enTeam.WebApi}}</code>, tj. adresářem umístěném na první úrovni vnoření v uvedeném archivu). 
Pro přehlednost jsou názvy souborů a adresářů v celém postupu instalace označeny {{FileName|technickým písmem}}. Názvy adresářů a souborů obsažené v uvedeném ZIP archivu jsou navíc zvýrazněny {{FileNameZip|červenou barvou}}. 
Dále jsou v tomto postupu uvedeny příklady částí souborů. Takové texty jsou označeny {{FileCont|modrou barvou}}. 

== Instalace webového rozhraní ==
=== Předpoklady ===
Webové aplikační rozhraní (webové API) informačního systému enTeam může být provozováno na serveru splňujícím předpoklady uvedené na stránce [[Předpoklady_instalace_webového_API|Předpoklady instalace webového API]].

=== Služba OS Windows ===
Instalace webového rozhraní enTeam jako služby OS Windows je zajištěna v rámci instalace nové verze enTeam. Nedaří-li se po instalaci nové verze enTeam službu webového API nastartovat, kontaktujte prosím technickou podporu společnosti Leviom.

=== Aplikace v rámci webového serveru Internet Information Services (IIS) ===
Instalaci webového rozhraní enTeam jako aplikace v rámci webového serveru Internet Information Services (IIS) je třeba provést manuálně podle následujícího postupu.

==== Postup instalace ====
Instalace sestává z následujících kroků:
<ol>
<li> Vytvořit adresář {{FileName|enTeam.WebApi}} v kořenovém adresáři webového serveru (např. {{FileName|c:\inetpub\wwwroot}})</li>
<li> Zkopírovat obsah adresáře {{FileName|enTeam.WebApi\bin}} do adresáře {{FileName|enTeam.WebApi}}, vytvořeného v předchozím kroku</li>
<li> V IIS Manageru přidat nový aplikační pool pro webové API (IIS Manager > Server > Application Pools > Add Application Pool…) 
[[Soubor:AddAppPool.png|Add Application Pool]]
</li>
<li> V rozšířených nastaveních aplikačního poolu musí být nastaveno
* .NET CLR Version = No Managed Code
* Enable 32-Bit Applications = true
* Identity = Local System
[[Soubor:AdvancedSettings.png|Advanced Settings]]
</li>
<li> V IIS Manageru vytvořit novou webovou stránku pro webové API (pojmenovanou např. enTeam.WebApi) a přiřadit jí vlastní port (např. 8088). 
[[Soubor:AddWebsite.png|522px|Add Website]] 
 
{{Note|Poznámka: Pokud je uvedený port na serveru již obsazen jinou aplikací, použijte libovolný jiný. Zvolený port je ale nutné reflektovat ve všech krocích tohoto postupu.}} 
{{Note|Poznámka: Zvolený port musí být dostupný ze všech zařízení, kde má být provozováno webové rozhraní aplikace enTeam nebo aplikace enTeamUI.}} 
{{Note|Poznámka: Z důvodu zabezpečení aplikace důrazně doporučujeme, aby webové rozhraní aplikace enTeam bylo provozováno výhradně na protokolu HTTPS a zvolený port byl dostupný pouze v rámci firemní sítě, příp. po připojení do VPN.}}
</li>
</ol>

==== Nastavení webového API ====

===== Soubor appsettings.json =====
V aplikaci webového API nastavte soubor {{FileName|appsettings.json}} dle následujícího postupu.
<ol>
<li> Pokud v adresáři aplikace webového API dosud takový soubor nemáte, pak jej vytvořte zkopírováním souboru {{FileName|appsettings.Template.json}} 
{{Note|Poznámka: Klíče (ve struktuře JSON souboru), které začínají znakem (nebo více znaky) #, jsou považovány za zakomentované a slouží pouze jako ilustrace možného nastavení. Po nastavení hodnot v souboru {{FileName|appsettings.json}}, je možné zakomentované řádky zcela odstranit (pozor ale na případné porušení syntaxe JSON, např. čárky mezi vlastnostmi)}}
</li>
<li> Pokud chcete použít nastavení připojení k databázi ve standardním INI aplikace enTeam (doporučená varianta), zkontrolujte, že soubor {{FileName|appsettings.json}} neobsahuje klíč {{FileCont|ConnectionStrings}}
</li>
<li> Pokud nelze použít hodnoty načtené z INI, nastavte přístup k databázím aplikace enTeam uvnitř klíče {{FileCont|ConnectionStrings}}. Jde o vlastnosti {{FileCont|WebApiDb}}, {{FileCont|DataDictionaryDb}}, {{FileCont|ScriptExDb}}, {{FileCont|UserDb}} a {{FileCont|WorkflowManagerDb}} a jejich vlastnosti {{FileCont|Provider}} a {{FileCont|ConnectionString}} 
{{Note|Poznámka: Pokud jsou některé (nebo všechny) databáze spojené a vlastnosti Provider a ConnectionString by se v různých klíčích konfigurace opakovaly, lze tyto nahradit implicitním nastavením – klíčem Default.}}
</li>
</ol> 
{{Note|Poznámka: V případě databázového serveru Firebird obsahuje vlastnost {{FileCont|ConnectionString}} plnou cestu k souboru databáze (např. {{FileName|C:\enTeam\Files\Data\enTeam.fdb}}). Aby byla aplikace webového API schopna vlastnost {{FileCont|ConnectionString}} přečíst, je třeba zpětná lomítka v cestě k souboru „zdvojit“. Cesta k databázi pak bude v hodnotě vlastnosti {{FileCont|ConnectionString}} např. tato: 
{{FileCont|1="ConnectionString":"Database=SERVER:C:\\enTeam\\Files\\Data\\enTeam.fdb;…"}}}} 

===== INI soubor webového API =====
Webové API pro svůj běh potřebuje pozměněné INI oproti desktopu. Vytvořte kopii souboru serie_m.ini, ke které bude přistupovat pouze webové API (např. {{FileName|<enTeamAdresar>\Ini\serie_m.WebApi.ini}}) a přidejte do něj následující obsah 
{{FileCont|1=[M/TeamBridge] 
ServerEngine=True}}

===== Soubor web.config =====
Pro běh webového API je třeba nastavit proměnnou prostředí SERIEM tak, aby odkazovala na soubor {{FileName|serie_m.WebApi.ini}} (viz [[#INI soubor webového API]]). Toho lze docílit úpravou souboru {{FileName|web.config}} (uvnitř elementu {{FileCont|aspNetCore)}} dle následujícího postupu:
<ol>
<li>
Pokud v adresáři aplikace webového API dosud takový soubor nemáte, pak jej vytvořte zkopírováním souboru {{FileName|web.Template.config}}
</li>
<li>
Správně nastavte proměnnou SERIEM v souboru {{FileName|web.config}}
Příklad nastavení proměnné SERIEM: 
{{FileCont11Lines |
1=<aspNetCore |
2=  processPath="c:\Program Files (x86)\dotnet\dotnet.exe" |
3=  arguments=".\Leviom.enTeam.WebApi.dll" |
4=  stdoutLogEnabled="false" |
5=  stdoutLogFile=".\logs\stdout"> |
6=    <environmentVariables> |
7=        <environmentVariable |
8=          name="SERIEM" |
9=          value="<enTeamAdresar>\Ini\serie_m.WebApi.ini" /> |
10=    </environmentVariables> |
11=</aspNetCore>}} 

Používáte-li 64bitový OS, zajistěte, aby se používala x86 varianta programu dotnet.exe. Nejjednodušší je upravit soubor {{FileName|web.config}} tak, že nastavíte plnou cestu k programu v atributu {{FileCont|processPath}} elementu {{FileCont|aspNetCore}} (viz ukázka výše).

</li>
<li>
V IIS Manageru ověřte, zda máte na serveru nainstalovaný modul WebDAV (IIS Manager > Server > Modules). Pokud se v seznamu instalovaných modulů nevyskytuje WebDAVModule, odstraňte ze souboru {{FileName|web.config}} následující sekci. 
{{FileCont3Lines |
1=<modules runAllManagedModulesForAllRequests="false"> |
2=    <remove name="WebDAVModule" /> |
3=</modules>}}
</li>
</ol>

=== Ověření funkčnosti ===
Pro ověření dostupnosti webového rozhraní vložte do internetového prohlížeče adresu, na které má být rozhraní dostupné, tedy např. 
<nowiki>https://enteam.<doména>.cz</nowiki> 
Pokud se v prohlížeči zobrazí přihlašovací stránka webového rozhraní informačního systému enTeam a do aplikace je možné se přihlásit, je webové rozhraní nainstalováno správně. 
[[Soubor:LoginToWebEnteam.png|Login to enTeam]] 

Pokud není ověření funkčnosti aplikace úspěšné, pokračujte zjištěním příčiny chyby dle [[#Ověření funkčnosti webového API končí chybou 500 nebo 502]] a po vyřešení problému znovu ověřte funkčnost aplikace z internetového prohlížeče.

== Často kladené otázky (FAQ) ==

=== Ověření funkčnosti webového API končí chybou 500 nebo 502 ===
Pokud ověření funkčnosti webového API dle kapitoly [[#Ověření funkčnosti]] končí chybou 500 Internal Server Error, příp. 502 Bad Gateway, lze příčinu chyby zjistit dle následujícího postupu:
<ol>
<li> Otevřete aplikaci Příkazová řádka (cmd.exe)
</li>
<li> V Příkazové řádce přejděte do adresáře aplikace, ve které dochází k chybě, příkazem:
{{Command|cd <AplikaceAdresar>}} 
V příkazu nahraďte 
{{Command|<AplikaceAdresar>}} za plnou cestu k adresáři s instalací aplikace, která vykazuje uvedenou chybu (např. {{FileName|c:\inetpub\wwwroot\enTeam.WebApi}})
</li>
<li> V Příkazové řádce spusťte požadovanou aplikaci 
{{Command|<DotnetAdresar>\dotnet.exe Leviom.enTeam.WebApi.dll}} 
V příkazu nahraďte 
{{Command|<DotnetAdresar>}} za plnou cestu k adresáři s instalací x86 varianty programu dotnet.exe (např. {{FileName|c:\Program Files (x86)\dotnet}})
</li>
</ol>
V příkazové řádce se zobrazí výpis, z něhož by mělo být možné důvod nefunkčnosti aplikace zjistit. Pokud výpisu aplikace nerozumíte, kontaktujte, prosím, technickou podporu společnosti Leviom.

Pokud aplikace vypíše do příkazové řádky tento text: 
{{Command|1=Hosting environment: Production 
Content root path: c:\inetpub\wwwroot\enTeam.WebApi (může se lišit) 
Now listening on: <nowiki>http://localhost:5000</nowiki> 
Application started. Press Ctrl+C to shut down.}}, 
byly odstraněny všechny chyby a aplikace je plně funkční. V takovém případě ji lze v Příkazové řádce ukončit stiskem Ctrl+C a znovu ověřit její funkčnost z webového prohlížeče dle kapitoly [[#Ověření funkčnosti]].