Protokol MTBODC: Porovnání verzí

Z enTeam
Skočit na navigaci Skočit na vyhledávání
m (naimportována 1 revize)
 
(Nejsou zobrazeny 3 mezilehlé verze od stejného uživatele.)
Řádek 1: Řádek 1:
Pomocí protokolu MTBODC je možné provádět různé operace s objekty aplikací M/TeamBridge a M/DMS. Volání protokolu se obvykle provádí tak, že se vytvoří "webový" odkaz, který je možný volat např. z webové stránky, excelovského dokumentu, emailu, těla procesu M/TeamBridge a ze spousty dalších míst. Jestliže tedy jednou z podporovaných operací je otevření procesu na základě jeho ID, pak jsme schopni z jakékoliv aplikace otevřít proces v M/TB.
+
Pomocí protokolu MTBODC je možné provádět různé operace s objekty aplikací enTeam Workflow Manager a enTeam DMS. Volání protokolu se obvykle provádí tak, že se vytvoří "webový" odkaz, který je možný volat např. z webové stránky, excelovského dokumentu, e-mailu, těla procesu enTeam Workflow Manager a ze spousty dalších míst. Jestliže tedy jednou z podporovaných operací je otevření procesu na základě jeho ID, pak jsme schopni z jakékoliv aplikace otevřít proces v enTeam Workflow Manager.<br/>
 +
Pro správnou funkci protokolu je nutné jej mít na počítači zaregistrovaný (např. pomocí ClientInstall.exe, menu Registrace/Zaregistrovat protokol MTBODC) a dále mít nainstalovaný enTeam Workflow Manager, případně enTeam DMS.
  
 
<h2>Podporované operace</h2>
 
<h2>Podporované operace</h2>
Řádek 5: Řádek 6:
 
* spuštění skriptu v procesu  
 
* spuštění skriptu v procesu  
 
* otevření přílohy procesu
 
* otevření přílohy procesu
* otevření dokumentu z M/DMS
+
* otevření dokumentu z enTeam DMS
  
  
Řádek 19: Řádek 20:
  
 
'''Předání parametrů v zakryptovaném řetězci'''<br/>
 
'''Předání parametrů v zakryptovaném řetězci'''<br/>
Před spuštěním skriptu je možné v procesu naplnit stringlistovou proměnnou MTBODC_params. Pokud proměnná dosud v procesu neexistuje, bude vytvořena. Hodnoty parametrů budou zakryptovány a tedy pro uživatele nečitelné. Parametry Params musí být uloženy ve formátu stringlistových proměnných M/TB, např. 3,1,2,3,abbccc<br/>
+
Před spuštěním skriptu je možné v procesu naplnit stringlistovou proměnnou MTBODC_params. Pokud proměnná dosud v procesu neexistuje, bude vytvořena. Hodnoty parametrů budou zakryptovány a tedy pro uživatele nečitelné. Parametry Params musí být uloženy ve formátu stringlistových proměnných enTeam Workflow manager, např. 3,1,2,3,abbccc<br/>
 
Kryptovaný text obsahuje: <CaseId>|RunScript|<ScriptName>[|<Params>] <br/>
 
Kryptovaný text obsahuje: <CaseId>|RunScript|<ScriptName>[|<Params>] <br/>
  
Řádek 28: Řádek 29:
 
Kryptovaný text obsahuje: <CaseId>|OpenAttachment|<AttachmentId>
 
Kryptovaný text obsahuje: <CaseId>|OpenAttachment|<AttachmentId>
  
<h3>Otevření dokumentu z DMS</h3>
+
<h3>Otevření dokumentu z enTeam DMS</h3>
 
Kryptovaný text obsahuje: <DmsId>|OpenDMSDoc|<DocumentName>
 
Kryptovaný text obsahuje: <DmsId>|OpenDMSDoc|<DocumentName>
  
  
<b>Pozn.:</b> Kryptování se provádí funkcí KWencrypt z knihovny ActualDocument.dll
+
<b>Pozn.:</b> Kryptování se provádí funkcí [https://funkce.enteam.cz/routines/KWencrypt.html KWencrypt] z knihovny ActualDocument.dll

Aktuální verze z 14. 8. 2020, 09:50

Pomocí protokolu MTBODC je možné provádět různé operace s objekty aplikací enTeam Workflow Manager a enTeam DMS. Volání protokolu se obvykle provádí tak, že se vytvoří "webový" odkaz, který je možný volat např. z webové stránky, excelovského dokumentu, e-mailu, těla procesu enTeam Workflow Manager a ze spousty dalších míst. Jestliže tedy jednou z podporovaných operací je otevření procesu na základě jeho ID, pak jsme schopni z jakékoliv aplikace otevřít proces v enTeam Workflow Manager.
Pro správnou funkci protokolu je nutné jej mít na počítači zaregistrovaný (např. pomocí ClientInstall.exe, menu Registrace/Zaregistrovat protokol MTBODC) a dále mít nainstalovaný enTeam Workflow Manager, případně enTeam DMS.

Podporované operace

  • otevření procesu
  • spuštění skriptu v procesu
  • otevření přílohy procesu
  • otevření dokumentu z enTeam DMS


Příklady volání MTBODC

Protokol je vždy volán následujícím způsobem: mtbodc://<zakryptovaný text>[?<URI parametry>]

Otevření procesu

Kryptovaný text obsahuje: <CaseId>|OpenCase[|<ProxyGuid>]
CaseId obsahuje ID procesu, který chceme otevřít. Volitelný parametr ProxyGuid použijeme, pokud chceme proces otevřít jako zástupce jiného uživatele. Obsahuje GUID uživatele, v jehož hlavní složce (tj. v zastupování) chceme proces otevřít.

Spuštění skriptu v procesu

Kryptovaný text obsahuje: <CaseId>|RunScript|<ScriptName>

Předání parametrů v zakryptovaném řetězci
Před spuštěním skriptu je možné v procesu naplnit stringlistovou proměnnou MTBODC_params. Pokud proměnná dosud v procesu neexistuje, bude vytvořena. Hodnoty parametrů budou zakryptovány a tedy pro uživatele nečitelné. Parametry Params musí být uloženy ve formátu stringlistových proměnných enTeam Workflow manager, např. 3,1,2,3,abbccc
Kryptovaný text obsahuje: <CaseId>|RunScript|<ScriptName>[|<Params>]

Použití URI parametrů
URI parametry je možné použít pro nastavení hodnot proměnných v procesu před spuštěním skriptu. Pro oddělení parametrů je použit znak # místo standardního & z důvodu možnosti použití odkazu v bat souborech. Hodnoty proměnných tento znak nesmí obsahovat. Např. při volání mtbodc://<zakryptovaný text>?Jmeno=Jana#Prijmeni=%D8in%E8ilov%E1 budou nastavené proměnné Jmeno a Prijmeni (na hodnotu Řinčilová - diakritika musí být kódována dle konvencí HTTP). Pokud v procesu proměnné dosud neexistují, budou vytvořeny. Názvy proměnných i hodnoty jsou nekryptované a tedy pro uživatele čitelné.

Otevření přílohy z procesu

Kryptovaný text obsahuje: <CaseId>|OpenAttachment|<AttachmentId>

Otevření dokumentu z enTeam DMS

Kryptovaný text obsahuje: <DmsId>|OpenDMSDoc|<DocumentName>


Pozn.: Kryptování se provádí funkcí KWencrypt z knihovny ActualDocument.dll