Protokol MTBODC

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