Protokol MTBODC

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.

Podporované operace

• otevření procesu
• spuštění skriptu v procesu
• otevření přílohy procesu
• otevření dokumentu z M/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 M/TB, 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 DMS

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

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