Příklad spouštění akcí pomocí zpráv

Upravit obsah stránky

Při přípravě a dalším vylepšování možností cílové aplikace jsou pomocí spec. nástroje v replikátoru nebo v intranetu připravovány a generovány tzv. transformační procesy. Tyto procesy je možné vyvolávat i nepřímo pomocí záslání zprávy patřičně vybavenému doplňku add-on, který nastavený proces vykoná. Taková zpráva musí mít zvláštní formu. Tuto formu buď zajistí server při obsluze ukládání dokumentu, kde se vyskytuje prvek nastavený jako messenger nebo je možné k zaslání takové zprávy samozřejmě použít požadavek send-message.

Požadavek pro odeslání "spouštěcí" zprávy je založen jednak naznalosti správného id uživatele s patřičnými oprávněními, pod kterým je přihlášen transformační add-on a jednak na typu a obsahu zprávy:

bullet

Typ zprávy:

@type="1"

bullet

Obsah zprávy:

@msg="doc-type={#type-of-document} d-key={#pdk-of-document} [xds-id={#xds-id-of-messenger}][{#name-of-param-1}={#value-of-param-1}][&{#name-of-param-2}={#value-of-param-2}][&...]..."

Zpráva vyvolávající transformaci, tedy musí mít nastaven typ na hodnotu 1 a obsahovat minimálně dokumentový typ aprimární klíč jeho instance, ke které budou vykonány odpovídající transformace dle registru akcí. Vedle toho je možné vkládat také parametry, které jsou případně akcí vyžadovány jako zadání uživatele nebo jiné vstupy. Každý transformační proces seznam těchto vstupů obsahuje vsouboru svých nastavení.

Příklad pro vyvolání zprávy nad dokumentem statistika_obchodu i s parametry:

msg="doc-type='statistika_obchodu' d-key='123' params='idRegionu=9876&Rok=2013&Mesic=9' "