Instalace webového rozhraní: Porovnání verzí

Z enTeam
Skočit na navigaci Skočit na vyhledávání
(→‎Instalace webového API)
(→‎INI soubor webového API)
 
(Není zobrazeno 115 mezilehlých verzí od stejného uživatele.)
Řádek 1: Řádek 1:
 
== O aplikaci ==
 
== 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ů.<br>
 
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ů.<br>
−
Pro zprovoznění webového rozhraní informačního systému enTeam je třeba provést tyto kroky:
 
−
* instalaci a nastavení webového API (aplikační rozhraní),
 
−
* instalaci a nastavení webového GUI (grafické uživatelské rozhraní),
 
−
* přesměrování komunikace z protokolu http na HTTPS a
 
−
* zpřístupnění webového API na protokolu HTTPS.
 
  
−
Popis provedení každého z těchto kroků je uveden v dalších kapitolách.<br>
+
Tento postup obsahuje odkazy na aplikace enTeam, které nazýváme:
−
Instalační soubory webového rozhraní jsou součástí instalačního ZIP archivu. V návodu jsou uvedeny relativní cesty k souborům a adresářům (vždy začínají adresářem {{FileNameZip|enTeam.WebApi}} nebo {{FileNameZip|enTeam.WebGui}}</code>, tj. jedním z adresářů umístěných na první úrovni vnoření v uvedeném archivu).<br>
+
* Workflow Manager - stávající klient, aplikace mtbGUI.exe
−
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}}.<br>
+
* enTeamUI - nový klient, aplikace enTeamUI.exe
−
V tomto dokumentu jsou uvedeny příklady částí souborů. Takové texty jsou označeny {{FileCont|modrou barvou}}.<br>
+
* webové API - aplikační rozhraní enTeam, součást webového rozhraní enTeam
 +
* webové GUI - webové grafické uživatelské rozhraní, součást webového rozhraní enTeam
  
−
== Předpoklady instalace webového rozhraní ==
+
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):
−
Webové rozhraní informačního systému enTeam využívá k připojení do databáze dvou způsobů. Prvním z nich je přímé připojení do databáze pomocí databázového klienta. Druhým způsobem je připojení pomocí OLE rozhraní, které je součástí standardního desktopového klienta aplikace enTeam. <br>
+
* službu operačního systému Windows, nebo
−
Server, kde bude webové rozhraní provozováno, proto musí mít:
+
* aplikaci v rámci webového serveru Internet Information Services (IIS)  
−
* Funkční enTeam verze 6.0.0.3 nebo novější – serverovou (hlavní) nebo klientskou instalaci
 
−
* Funkční webový server Internet Information Services (IIS) verze 10 nebo novější nainstalovaný na serveru, kde je zprovozněn IS enTeam
 
  
−
== Instalace webového API ==
+
Instalační soubory webového rozhraní jsou součástí ZIP archivu CD (verze aplikace enTeam).<br>  
−
Webové API je kolekce webových služeb poskytující přístup k datům modulů aplikace enTeam.<br>
+
Pro přehlednost jsou názvy souborů a adresářů v celém postupu instalace označeny {{FileName|technickým písmem}}.<br>
−
Aktuálně podporované DBMS jsou Firebird, Microsoft SQL Server a Oracle. Požadovanou strukturu databáze je nutné vytvořit dodanými SQL skripty (viz <ref>Postup instalace</ref>[Postup instalace webového API]). Strukturu lze vytvořit:
+
Dále jsou v tomto postupu uvedeny příklady částí souborů. Takové texty jsou označeny {{FileCont|modrou barvou}}.<br>
−
* Individuálně, tj. samostatná databáze koexistující vedle stávající databáze enTeam
 
−
* Přidat do aktuální databáze enTeam
 
−
Na vytvořenou strukturu databáze je pak potřeba nasměrovat aplikaci (viz [[Soubor appsettings.json]])
 
  
 +
== Instalace webového rozhraní ==
 
=== Předpoklady ===
 
=== Předpoklady ===
−
[[Předpoklady instalace webového API|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]].
  
−
=== Postup instalace ===
+
=== Zabezpečení ===
−
[[Postup instalace webového API|Postup instalace]]
+
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.
  
−
=== Nastavení webového API ===
+
===Služba OS Windows===
−
[[Nastavení webového API]]
+
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.
  
−
==== Soubor appsettings.json ====
+
===Aplikace v rámci webového serveru Internet Information Services (IIS)===
−
[[Soubor appsettings.json]]
+
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.
  
−
==== INI soubor webového API ====
+
====Postup instalace====
−
[[INI soubor webového API]]
+
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|Application\WEB\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…)<br>
 +
[[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).<br>
 +
[[Soubor:AddWebsite.png|522px|Add Website]]<br>
 +
<br>
 +
{{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.}}<br>
 +
{{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.}}
 +
</li>
 +
</ol>
  
−
==== Soubor web.config ====
+
====Nastavení webového API====
−
[[Soubor web.config]]
+
Pro zajištění správné funkčnosti webového rozhraní enTeam je třeba upravit konfiguraci následujících souborů.
  
−
=== Ověření funkčnosti ===
+
=====Soubor appsettings.json=====
−
[[Ověření funkčnosti webového API|Ověření funkčnosti]]
+
V aplikaci webového API nastavte soubor {{FileName|appsettings.json}} dle následujícího postupu.
−
 
+
<ol>
−
=== Způsob provozování webového API ===
+
<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}}<br>
−
[[Způsob provozování webového API]]
+
{{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>
−
== Instalace webového GUI ==
+
<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}}
−
[[Instalace webového GUI]]
+
</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 &gt; Default}} a pomocí vlastností {{FileCont|Provider}} a {{FileCont|ConnectionString}}<br>
 +
{{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><br>
 +
{{Note|Poznámka: V případě databázového serveru Firebird obsahuje vlastnost ConnectionString plnou cestu k souboru databáze (např. C:\enTeam\Files\Data\enTeam.fdb). Aby byla aplikace webového API schopna vlastnost 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 ConnectionString např. tato: &quot;ConnectionString&quot;: &quot;Database&#61;SERVER:C:\\enTeam\\Files\\Data\\enTeam.fdb;...&quot;.}}<br>
  
−
=== Předpoklady ===
+
=====INI soubor webového API=====
−
[[Předpoklady instalace webového GUI|Předpoklady]]
+
Webové API pro svůj běh potřebuje pozměněné INI oproti Workflow Manageru a ostatním stávajícím aplikacím enTeam. 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<br>
 +
{{FileCont|1=[M/TeamBridge]<br>
 +
ServerEngine=True}}
  
−
=== Postup instalace v IIS – webová stránka ===
+
=====Soubor web.config=====
−
[[Postup instalace v IIS – webová stránka]]
+
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:<br>
 +
{{FileCont11Lines |
 +
1=<aspNetCore |
 +
2=&nbsp;&nbsp;processPath="c:\Program Files (x86)\dotnet\dotnet.exe" |
 +
3=&nbsp;&nbsp;arguments=".\Leviom.enTeam.WebApi.dll" |
 +
4=&nbsp;&nbsp;stdoutLogEnabled="false" |
 +
5=&nbsp;&nbsp;stdoutLogFile=".\logs\stdout"> |
 +
6=&nbsp;&nbsp;&nbsp;&nbsp;<environmentVariables> |
 +
7=&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<environmentVariable |
 +
8=&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;name="SERIEM" |
 +
9=&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;value="<enTeamAdresar>\Ini\serie_m.WebApi.ini" /> |
 +
10=&nbsp;&nbsp;&nbsp;&nbsp;</environmentVariables> |
 +
11=</aspNetCore>}}<br>
  
−
=== Postup instalace v IIS – podstránka jiné webové stránky ===
+
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).
−
[[Postup instalace v IIS – podstránka jiné webové stránky]]
 
  
−
=== Nastavení webového GUI ===
+
</li>
−
[[Nastavení webového GUI]]
+
<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.<br>
 +
{{FileCont3Lines |
 +
1=<modules runAllManagedModulesForAllRequests="false"> |
 +
2=&nbsp;&nbsp;&nbsp;&nbsp;<remove name="WebDAVModule" /> |
 +
3=</modules>}}
 +
</li>
 +
</ol>
  
 
=== Ověření funkčnosti ===
 
=== Ověření funkčnosti ===
−
[[Ověření funkčnosti webového GUI|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>.<br>
−
 
+
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ě.<br><br>
−
== URL Rewrite – Přesměrování na https ==
+
[[Soubor:LoginToWebEnteam.png|Login to enTeam]]<br>
−
[[URL Rewrite – Přesměrování na https]]
 
−
 
 
−
=== Předpoklady ===
 
−
[[Předpoklady přesměrování na https|Předpoklady]]
 
  
−
=== Postup ===
+
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.
−
[[Postup  přesměrování na https|Postup]]
 
−
 
 
−
== URL Rewrite – Zpřístupnění webového API ==
 
−
[[URL Rewrite – Zpřístupnění webového API]]
 
−
 
 
−
=== Předpoklady ===
 
−
[[Předpoklady zpřístupnění webového API|Předpoklady]]
 
−
 
 
−
=== Postup ===
 
−
[[Postup zpřístupnění webového API|Postup]]
 
−
 
 
−
=== Ověření funkčnosti ===
 
−
[[Ověření zpřístupnění webového API|Ověření funkčnosti]]
 
  
 
== Často kladené otázky (FAQ) ==
 
== Často kladené otázky (FAQ) ==
−
[[Často kladené otázky (FAQ)]]
 
  
−
=== Pod uživatelem se nelze připojit z enTeam.WebApi do DB Firebird 3.0+. Spojení z ostatních aplikací enTeam pod stejným uživatelem funguje. ===
+
=== Ověření funkčnosti webového API končí chybou 500 nebo 502 ===
−
[[Pod uživatelem se nelze připojit z enTeam.WebApi do DB Firebird 3.0+. Spojení z ostatních aplikací enTeam pod stejným uživatelem funguje.]]
+
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>}}<br>
 +
V příkazu nahraďte<br>
 +
{{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<br>
 +
{{Command|<DotnetAdresar>\dotnet.exe Leviom.enTeam.WebApi.dll}}<br>
 +
V příkazu nahraďte<br>
 +
{{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.
  
−
=== Ověření funkčnosti webového API končí chybou 500 nebo 502 ===
+
Pokud aplikace vypíše do příkazové řádky tento text:<br><br>
−
[[Ověření funkčnosti webového API končí chybou 500 nebo 502]]
+
{{Command|1=Hosting environment: Production<br>
 +
Content root path: c:\inetpub\wwwroot\enTeam.WebApi <span style="color: red">(může se lišit)</span><br>
 +
Now listening on: <nowiki>http://localhost:5000</nowiki><br>
 +
Application started. Press Ctrl+C to shut down.}},<br><br>
 +
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]].

Aktuální verze z 2. 9. 2025, 09:56

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

Tento postup obsahuje odkazy na aplikace enTeam, které nazýváme:

  • Workflow Manager - stávající klient, aplikace mtbGUI.exe
  • enTeamUI - nový klient, aplikace enTeamUI.exe
  • webové API - aplikační rozhraní enTeam, součást webového rozhraní enTeam
  • webové GUI - webové grafické uživatelské rozhraní, součást webového rozhraní enTeam

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).
Pro přehlednost jsou názvy souborů a adresářů v celém postupu instalace označeny technickým písmem.
Dále jsou v tomto postupu uvedeny příklady částí souborů. Takové texty jsou označeny 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.

Zabezpečení

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) a zvolený port byl dostupný pouze v rámci firemní sítě, příp. po připojení do VPN.

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ů:

  1. Vytvořit adresář enTeam.WebApi v kořenovém adresáři webového serveru (např. c:\inetpub\wwwroot)
  2. Zkopírovat obsah adresáře Application\WEB\bin do adresáře enTeam.WebApi, vytvořeného v předchozím kroku
  3. V IIS Manageru přidat nový aplikační pool pro webové API (IIS Manager > Server > Application Pools > Add Application Pool…)
    Add Application Pool
  4. 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
    Advanced Settings
  5. 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).
    Add Website

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

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 appsettings.json dle následujícího postupu.

  1. Pokud v adresáři aplikace webového API dosud takový soubor nemáte, pak jej vytvořte zkopírováním souboru appsettings.Template.json
    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 appsettings.json, je možné zakomentované řádky zcela odstranit (pozor ale na případné porušení syntaxe JSON, např. čárky mezi vlastnostmi)
  2. Pokud chcete použít nastavení připojení k databázi ve standardním INI aplikace enTeam (doporučená varianta), zkontrolujte, že soubor appsettings.json neobsahuje klíč ConnectionStrings
  3. Pokud nelze použít hodnoty načtené z INI, nastavte přístup k databázím aplikace enTeam uvnitř klíče ConnectionStrings > Default a pomocí vlastností Provider a ConnectionString
    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.


Poznámka: V případě databázového serveru Firebird obsahuje vlastnost ConnectionString plnou cestu k souboru databáze (např. C:\enTeam\Files\Data\enTeam.fdb). Aby byla aplikace webového API schopna vlastnost 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 ConnectionString např. tato: "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 Workflow Manageru a ostatním stávajícím aplikacím enTeam. Vytvořte kopii souboru serie_m.ini, ke které bude přistupovat pouze webové API (např. <enTeamAdresar>\Ini\serie_m.WebApi.ini) a přidejte do něj následující obsah
[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 serie_m.WebApi.ini (viz #INI soubor webového API). Toho lze docílit úpravou souboru web.config (uvnitř elementu aspNetCore) dle následujícího postupu:

  1. Pokud v adresáři aplikace webového API dosud takový soubor nemáte, pak jej vytvořte zkopírováním souboru web.Template.config
  2. Správně nastavte proměnnou SERIEM v souboru web.config Příklad nastavení proměnné SERIEM:
    <aspNetCore
      processPath="c:\Program Files (x86)\dotnet\dotnet.exe"
      arguments=".\Leviom.enTeam.WebApi.dll"
      stdoutLogEnabled="false"
      stdoutLogFile=".\logs\stdout">
        <environmentVariables>
            <environmentVariable
              name="SERIEM"
              value="<enTeamAdresar>\Ini\serie_m.WebApi.ini" />
        </environmentVariables>
    </aspNetCore>
    Používáte-li 64bitový OS, zajistěte, aby se používala x86 varianta programu dotnet.exe. Nejjednodušší je upravit soubor web.config tak, že nastavíte plnou cestu k programu v atributu processPath elementu aspNetCore (viz ukázka výše).
  3. 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 web.config následující sekci.
    <modules runAllManagedModulesForAllRequests="false">
        <remove name="WebDAVModule" />
    </modules>

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ř. https://enteam.<doména>.cz.
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ě.

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:

  1. Otevřete aplikaci Příkazová řádka (cmd.exe)
  2. V Příkazové řádce přejděte do adresáře aplikace, ve které dochází k chybě, příkazem: cd <AplikaceAdresar>
    V příkazu nahraďte
    <AplikaceAdresar> za plnou cestu k adresáři s instalací aplikace, která vykazuje uvedenou chybu (např. c:\inetpub\wwwroot\enTeam.WebApi)
  3. V Příkazové řádce spusťte požadovanou aplikaci
    <DotnetAdresar>\dotnet.exe Leviom.enTeam.WebApi.dll
    V příkazu nahraďte
    <DotnetAdresar> za plnou cestu k adresáři s instalací x86 varianty programu dotnet.exe (např. c:\Program Files (x86)\dotnet)

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:

Hosting environment: Production
Content root path: c:\inetpub\wwwroot\enTeam.WebApi (může se lišit)
Now listening on: http://localhost:5000
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.

Citováno z „https://wiki.enteam.cz/index.php?title=Instalace_webového_rozhraní&oldid=926“