Protokol MTBODC: Porovnání verzí
m (naimportována 1 revize) |
|||
| Řádek 1: | Řádek 1: | ||
| − | Pomocí protokolu MTBODC je možné provádět různé operace s objekty aplikací | + | 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, emailu, 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. |
<h2>Podporované operace</h2> | <h2>Podporované operace</h2> | ||
| Řádek 5: | Řádek 5: | ||
* 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 | + | * otevření dokumentu z enTeam DMS |
| Řádek 19: | Řádek 19: | ||
'''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 | + | 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 28: | ||
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í [http://funkce.enteam.cz/routines/KWencrypt.html KWencrypt] z knihovny ActualDocument.dll |
Verze z 10. 7. 2019, 12:12
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, emailu, 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.
Obsah
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
