Předkonfigurace "SOAP - výměna zpráv založených na XML"

Výměna zpráv založených na XML pomocí HttpRequest metodou POST

Tato předkonfigurace se vyvolá při zakládání nového objektu (např. volbou "Nový objekt ..." v kontextovém menu objektu nebo stisknutím klávesy Insert po označení objektu) a je zařazena ve skupině: "/ Komunikace / Protokoly a jiné komunikace / HTTP - XML, JSON, CSV, SOAP, text".
Tuto předkonfiguraci lze vytvořit nad objektem: PmaFolder nebo PmaRoot.

- Předkonfigurace vytvoří nakonfigurovaný objekt typu PmaFolder obsahující objekty PmaSequencer, PmaData a PmaPanel.

- Předkonfigurace obrazu (objekt typu PmaPanel) je funkční i jako Web obraz.

Objekt PmaFolder má dvojici souvisejících uživatelských metod. Jedna nastavuje požadovanou strukturu odesílaných dat a ty odesílá metodou Add objektu PmaSequencer s příslušnými parametry ke komunikaci. Druhá související metoda příchozí data zpracovává. Událost onStep objektu PmaSequencer použije první dva parametry k odeslání požadavku na komunikaci. A třetí parametr použije k volání konkrétní metody, které předá xml obsah přijaté odpovědi.

Objekt PmaSequencer je nakonfigurován tak, aby každá komunikace probíhala mimo hlavní pracovní vlákno aplikace PROMOTIC. V události onStep je pak vytvořen ActiveX objekt Microsoft.XMLHTTP, kterému jsou v metodě "open" předánány příslušné parametry pro komunikaci v synchronním režimu. Pak následuje metoda "send", která odešle data. Přijatá xml data jsou předána do konkrétní metody ke zpracování. Přenos je ukončen metodou abort.

Testovací obraz PmaPanel umožní spustit předkonfigurované metody a zobrazit nezpracovaná přijatá data.

Konfigurátory které lze nastavit před vytvořením předkonfigurace:

Název vytvářeného objektu	Název nově vytvořeného objektu ve stromu Pma objektů. Maximální délka názvu je 30 znaků. Je to systémový název, může obsahovat pouze alfanumerické znaky a nesmí obsahovat diakritiku (tzn. národnostně závislé znaky), prázdný řetězec, mezery a první znak nesmí být číslo. Přednastaveno: "SOAP"

Vytvořit testovací obraz	Vytvoří obraz pro testování komunikace se zobrazením přijatých dat

Povolit jako Web komponentu	Určuje, zda tento objekt se má zaregistrovat jako komponenta Web serveru Po vytvoření předkonfigurace bude na tuto hodnotu nastaven konfigurátor "PmaPanel > Web server > Povolit jako Web komponentu".
PmaWeb objekt	Cesta ve stromu Pma objektů k objektu PmaWeb, PmaWebFolder nebo PmaWebLang, do kterého se provede zaregistrování. Pro zadání lze použít Makro výraz (vyhodnocuje se po spuštění aplikace). Po vytvoření předkonfigurace bude na tuto hodnotu nastaven konfigurátor "PmaPanel > Web server > PmaWeb objekt".