Podepisování vzorů

Využití vzorů v Signi je elegantní řešení pro situace, kdy v integrovaném systému máte informace ve strukturované podobě, ale je pro vás obtížné vygenerovat výsledný dokument.

V Signi se vytvoří vzor / šablona / template dokumentu a při volání API pak předáte jen hodnoty parametrů vzoru, Signi je doplní na příslušná místa vzoru a vytvoří finální dokument. Kromě zobrazení hodnot lze také parametry řídit ukazování a schovávání částí obsahu ve vzoru.

• Jak vypadá volání Signi API při použití vzorů
• Jaké typu parametrů lze ve vzorech použít?
• Jak při použití vzorů přes API skrývat a zobrazovat části obsahu?
• Jak při použití vzorů zjistit, které parametry vzor má? 
• Jak předávat informaci o umístění podpisů při použití vzorů?
• Jak sladit vzory a volání API, aby se podpisy ukazovaly na správných místech ?  
• Jak si zobrazím celý kód vzoru vzoru? 
• Vzor dokumentu je uložen v rozšířené verzi HTML. 

Jak vypadá volání Signi API při použití vzorů

• Při předávání údajů pro vzor se využije endpoint Vytvoření smlouvy / dokumentu 2.0 > Ze vzoru. V sekci Parameters jsou předány jednotlivé parametru vzoru s tím, že “id” odpovídá id parametru ve vzoru.

• Příklady vytvoření dokumentu ze vzoru přes API viz Příklad 3 - Předání podkladů pro vzor > A - Předání běžných hodnot - text, číslo, datum

Jaké typu parametrů lze ve vzorech použít?

Při návrhu vzoru lze počítat s tímto typem parametrů, přes které lze ovládat výsledný obsah vzoru:

1. Text Area - con-textarea - text k zobrazení

2. Číslo - con-number - číslo

3. Datum - con-date - datum

4. Výběr varianty - con-options - výčet hodnot, z nichž jedna může být zvolena. Pokud je zvolena konkrétní varianta, může se ve výsledném dokumentu zobrazit jakýkoliv text, třeba několik paragrafů smlouvy. Pokud je zvolena jiná varianta, nemusí se ve výsledném dokumentu zobrazit nic nebo jiné paragrafy.

5. Obsahový blok - con-part - Text, který lze hodnotou parametru schovat anebo zobrazit.

Jak při použití vzorů přes API skrývat a zobrazovat části obsahu?

Jsou dvě možnosti:

• konkrétní část obsahu buď skrýt nebo zobrazit,

• nebo použít výčet hodnot, kdy při volbě každé hodnoty lze zvolit, jaký obsah se má ukázat.

Pro první případ slouží ve vzoru položka con-part. Zobrazení nebo skrytí celé sekce lze řídit tak, že mezi parametry předávanými přes API přidáme i ID parametru odpovídající sekci con-part, kdy hodnota je buď hide, či show.

Obdoba skrytí či zobrazení části obsahu vzoru přes uživatelské rozhraní Signi.

Příklad vzoru a volání viz Příklad 3 - Předání podkladů pro vzor > C - Zobrazování a schovávání částí obsahu vzoru.

Pozor!!! Identifikátory sekcí con-part se NEukazují v seznamu parametrů vzoru - viz Jak při použití vzorů zjistit, které parametry vzor má? Jedna z možností, jak je zjistit, je stáhnout si celý kód vzoru pomocí Jak si zobrazím celý kód vzoru vzoru? a tam si příslušné identifikátory sekcí con-part najít.

Pro druhý případ slouží ve vzoru položky con-options a con-option. Výběr konkrétní volby lze přes API řídit názvem příslušné volby předaném v položce con-options.

Obdoba výběru z hodnot parametru vzoru v uživatelském rozhraní.

Příklad vzoru a volání viz Příklad 3 - Předání podkladů pro vzor > B - Předávání hodnoty z výčtu hodnot.

Jak při použití vzorů zjistit, které parametry vzor má? 

End point https://api.signi.com/api/v1/contract/templates vám vrátí všechny vzory přístupné pro workspace s API klíčem použitým pří volání, ve vráceném seznamu vzorů jsou ve formě JSON uvedeny parametry volání jednotlivých vzorů - viz např. níže.

{
    "templates": [
        {
            "id": 396,
            "contract_name": "Pohybový doklad ",
            "parameters": [
                {
                    "id": "111",
                    "name": "Typ dokladu",
                    "type": "con-options",
                    "values": [
                        "Příjemka",
                        "Výdejka",
                        "Objednávka vydaná",
                        "Objednávka přijatá",
                        "Rezervace vydaná",
                        "Rezervace přijatá",
                        "Příjemka",
                        "Vratné obaly"
                    ]
                }
                ...
            ]
        }
    ]
}

{"people": [
        {
            "is_proposer": true,
            "party_order": 1,
            "email": "me@example.com",
            "contract_role": "sign"
        },
        {
            "is_proposer": false,
            "party_order": 2,
            "email": "unregistered+1@example.com",
            "contract_role": "sign",

 <tr>
                <td>
                    <p>
                        <con-sign con-id="16" party-type="proposer"></con-sign>
                    </p>
                </td>
                <td>
                    <p>
                        <con-sign con-id="17" party-type="counterparty" party-order="2"></con-sign>
                    </p>
                </td>
            </tr>

"people": [
        {
            "is_proposer": true,
              "party_order": 1,
            "email": "zakladatelworkspace@firmanavrhovatele.cz",
            "contract_role": "approve"
        },
        {
            "is_proposer": false,
              "party_order": 2,
            "email": "me@example.com",
            "contract_role": "sign"
        },
        {
            "is_proposer": false,
            "party_order": 3,
            "email": "unregistered+1@example.com",
            "contract_role": "sign",

<tr>
                <td>
                    <p>
                          <con-sign con-id="16" party-type="counterparty" party-order="2"></con-sign>
                    </p>
                </td>
                <td>
                    <p>
                        <con-sign con-id="17" party-type="counterparty" party-order="3"></con-sign>
                    </p>
                </td>
            </tr>

"settings": {
    "signing_order": "one_at_a_time"
},