| Table of Contents |
|---|
Signi konektor pro Microsoft Power Automate - Je je vhodný pro jednodušší úlohy a pro ty s menší zkušeností s integracemi.
Před jeho použitím je třeba si zřídit účet na Signi, nechat si od Signi aktivovat přístup k API, vygenerovat si API klíč, zaregistrovat si konektor a zprovoznit ho v prostředí MS Power Automate dle následujícího postupu.
| Table of Contents |
|---|
Příprava na straně Signi
Vytvoření účtu
Uživatel si vytvoří svůj hlavní účet na www.signi.com pod jím zvoleným e-mailem. Při zřizování účtu vybere vytvoření pracovního prostoru / workspace pro právnickou osobu, aby bylo možné přidávat více lidí do týmu. Pod tímto účtem se bude případně následně vést i fakturace..
...
Při zřizování účtu či pracovní plochy / workspace zvolte jako typ “Právnická osoba”. Budete tak moci například umožnit přístup více uživatelům do pracovní plochy.
Aktivace API
E-mail, pod kterým je zřízen tento hlavní účet, uživatel zašle do Signi na sales@signi.com. Na základě toho jsou pro účet, resp. pracovní prostory/workspace povoleny některé rozšiřující funkce, například vlastní branding či přístup přes API, a nastaven dostatek kreditů pro testování podpisů.
...
V menu uživatelského profilu po volbě “Workspaces” a výběru příslušného pracovního prostoru / workspace v “Rozšířeném nastavení” je, pokud je povolen přístup k pracovnímu prostoru přes API, zaškrtnuto Používání API.
Vygenerování API klíče
Uživatel si v okamžiku, kdy je přihlášen do Signi pod účtem pod kterým má na Signi založen/y workspace, zobrazí stránku https://app.signi.com/api a tam si vygeneruje pro svůj/své workspace API klíč/e.
...
Vygenerování a zobrazení API klíče pro jednotlivé pracovní prostory / workspace
Příprava na staně MS Power Automate
Registrace API klíče a stažení konektoru
Na https://docs.talxis.com/cz/customizer-guide/integration/signi/ :
Zadejte do formuláře údaje potřebné pro zprovoznění konektoru
Vyčkejte, až bude potvrzena aktivace propojení pro váš API klíč
Na stránce formuláře si také stáhněte balíček se Signi konektorem pro Microsoft.
...
Co a jak vyplnit do registračního formuláře Signi konektoru pro Microsoft
Instalace konektoru
Přihlašte se do MS Power Automate ve vašem Microsoft prostředí.
...
V Data > Custom Connectors zvolte New custom connector > Import OpenAPI File, zvolte Solutions > Import Solution a nahrajte ZIP soubor konektoru z předchozího kroku.
...
Po importu, který může trvat cca 1 minutu, si ověřit, že je konektor “TALXIS Connector Signi” v seznamu custom connectorů.
Využití konektoru
Nastavení flow
Příklad flow/toku jednoduchého vyvolání podpisu dokumentu zobrazuje následující diagram. Význam parametrů jednotlivých volání konektoru je popsán dále.
...
Parametry volání “Sign Contract From Provided File” | |
File (File Name) | Jméno souboru při volání API - např. “Název souboru” získané z flow/toku. Nemělo by obsahovat diakritiku, přípona by měla odpovídat typu dokumentu, např. pdf. Jméno by se mělo lišit od jména výsledného dokumentu s podpisem, pokud není využito verzování. |
File Content (File) | Obsah souboru, např. ”Obsah souboru” získaný z flow/toku. |
Contract Number | Číslo dokumentu využitelné pro evidenci v Signi zobrazené a dohledatelné v uživatelském rozhraní Signi. |
Contract Sign Date | Datum podepsání navrhovatelem, ideálně aktuální datum, nutné dodržet výchozí formát data YYYY-MM-DD . |
Author E-mail * | E-mail zástupce navrhovatele, typicky statutárního zástupce provozovatele Signi, musí mít pod svým e-mailem zaveden účet v Signi a na workspace nastaveno právo podepisování. Pokud má mít umístěn i podpis, musí mít nahrán v profilu svůj podpis a ve vlastnostech workspace musí být zadáno výchozí místo podepisování. |
Author Should Sign * | Ano - Zástupce navrhovatele, typicky statutární zástupce provozovatele Signi, bude dokument podepisovat, tj. dojde mu notifikační e-mail a SMS. Pokud má být podepsán na dokument automaticky, vyžaduje to, aby měl pod svým e-mailem zaveden účet v Signi, měl na workspace nastaveno právo podepisování, měl nahrán v uživatelském profilu Signi > Nastavení profilu > Podpis svůj podpis. Ve vlastnostech workspace musí být zadáno výchozí místo podepisování. Ne - Zástupce navrhovatele, typicky statutární zástupce provozovatele dokument obdrží ke schválení - jen ho přečte a potvrdí, ale nepodepisuje |
Author Signature Page *, Author Signature X, Author Signature Y | Pro podpis navrhujícího, nyní povinné atributy, Page - stránka dokumentu počítaná od 0, X , Y souřadnice umístění podpisu od horního levého rohu v procentech, uváděno je jen číslo, ne znak “%”. Více viz Integrace API - FAQ |
Signer Type |
|
Signer First Name* | Křestní jméno protistrany, povinný atribut, |
Signer Surname* | Příjmení protistrany, povinný atribut |
Signer Email* | Na tuto e-mailovou adresu odesílat notifikační e-mail, povinný atribut |
Signer Phone* | Na tento telefon se budou odesílat notifikační e-mail a PIN pro 2fázové ověření pro protistranu, povinný atribut |
Signer Should Sign * | Ano - Protistrana bude dokument podepisovat Ne - Protistrana dokument obdrží ke schválení - jen ho přečte a potvrdí, ale nepodepisuje - dostane notifikační e-mail a SMS (připravuje se). |
Signer Signature Page *, Signer Signature X*, Signer Signature Y* (Signature Signer Page, Signature Signer X, Signer Signature Y) | Pro podpis protistrany, nyní povinné atributy, Page - stránka dokumentu počítaná od 0, X , Y souřadnice umístění podpisu od horního levého rohu v procentech, uváděno jen číslo. Více viz Integrace API - FAQ |
Signer Location* (Contract Sign Location) | Předvyplní se jako místo podpisu, např. “Praze”, volitelný atribut |
Signer Street | Nepovinný atribut, adresa podepisujícího jako součást jeho identifikace. Hodí se zejména při použití vzorů Signi, kde se údaje o podepisujícím uvádějí v hlavičce vzoru. |
Signer City | Nepovinný atribut, obec podepisujícího jako součást jeho identifikace. Hodí se zejména při použití vzorů Signi, kde se údaje o podepisujícím uvádějí v hlavičce vzoru. |
Signer ZIP | Nepovinný atribut, PSČ podepisujícího jako součást jeho identifikace. Hodí se zejména při použití vzorů Signi, kde se údaje o podepisujícím uvádějií uvádějí v hlavičce vzoru. |
Signer Date of Birth | Datum narození, vyplňuje se pro fyzické osoby s OSVČ, pokud chceme mít jako součást identifikace podepisujícího. Hodí se zejména při použití vzorů Signi, kde se údaje o podepisujícím uvádějí v hlavičce vzoru. |
Signer Company Name | Jméno organizace, vyplňuje se, je-li protistrana právnickou osobou |
Signer VAT ID | DIČ organizace, vyplňuje se, je-li protistrana právnickou osobou |
Signer Company ID | IČO organizace, vyplňuje se, je-li protistrana právnickou osobou |
Spuštění flow v MS Sharepoint
V příslušné složce v MS Sharepoint vybrat příslušný dokument k podepsání a zvolit Automate > Submit to SIGNI Signature .
...
Tipy a poznámky
Datumy musí být ve výchozím formátu YYYY-MM-DD.
...
Po importu Solution chvíli počkat, může trvat nějajou nějakou dobu.
NIDKY necpat tam syrové JSON , pak to nebude updatovatelné,- Nesmí nesmí to být
NIKDY neecditovat Custom Connector - sice to jde , ale důsledkem bude, že to nepůjde pak aktualizovat
Pokud nám dá zákazník práva do tenantu, můžeme aktualizovat konektor za něj.
Jak přidat tlačítko na řádek s dokumentem ?
Přidat sloupec s JSONemJSON
Použít JSON formater - https://www.google.com/search?q=sharepoint+column+formating+JSON&oq=sharepoint+column+formating+JSON&aqs=chrome..69i57j0l7.11017j0j7&sourceid=chrome&ie=UTF-8
...
Další témata
Materiály k MS Power Automate
Určitě nejdříve toto školení, můžete začít ihned: https://docs.microsoft.com/en-us/learn/browse/?expanded=power-platform&products=power-automate
Také si udělejte Free Office 365 Developer Subscription, popsáno je zde: https://www.mspro.cz/microsoft-365-e5-developer-subscription%e2%80%8b/
Normální Sharepoint včetně Windows Server je v Interních partnerských licencích Action Packu, viz popis zde: https://www.mspro.cz/vyhody-microsoft-partner-network-a-interni-licence/
Pro naše engaged partnery na Azure ve spojení s PowerApps Microsoft zajišťuje školení na míru vlastními silami
Microsoft Partneři, např. Networg, dělají také školení našim ostatním partnerům na Power Platformu.
Existuje placený MOC kurz MOC PL-900.
Ukázka jednoduchého propojení
Příklad jednoduchého propojení Signi a MS Sharepoint z pohledu uživatele ukazuje následující video.
Jak
...
je konektor
...
udržován
Konektor průběžně udržujeme, abychom zohlednili
...
novinky v platformě i Signi
...
K provádění změn
Upgrade nové verze konektoru se provede stejně jako instalace, na pozadí se vymění verze konektoru.
V případě problémů může pomoci KLASICKÉ “vystoupit, nastoupit” tj. odebrat Solution s konektorem a znovu přidat.
Změny v konektoru děláme “non-breaking” tj. zůstávají zachovány stávající akce konektoru i jejich logika.
Verze konektoru: 1.0.2106.4 a 1.0.2105.4
03.6.2021
Konektor ke stažení : https://docs.talxis.com/cz/customizer-guide/integration/signi/
1. Nový End Point Stažení kontrolního listu k dokumentu Get Revison List
Ke každému dokumentu podepsanému v Signi je možné stáhnout i jeho Kontrolní list s auditní stopou dokumentu. Stačí znát Constract ID daného dokumentu.
...
Volání Enp Ppoointu pro kontrolní list v MS Power Automate
2. Přidána nová metoda souhlasu s dokumenty - jen SMS
Kromě
biometrického podpisu - uživatel kreslí svůj podpis, který je vidět v dokumentu a
schválení dokumentu - uživatel klikne, že souhlasí např s obchodními podmínkami, nikde v dokumentu není jeho podpis
nově Signi umí i vyjádřit
souhlas pouze přes opsáním PINu ze zaslané SMS - v auditní stopě je zaznamenáno použité telefonní číslo.
Stačí při předání dokumentu nebo údajů pro vzor zvolit typ souhlasu “stamp".
3. Podpora jazykových mutací při podpisové komunikaci.
Při předání dokumentu nebo údajů pro vzor lze nyní zvolit jazyk komunikace při podepisování - v jakém jazyku nbudou chosti notifikační emaily a smsm, v jakém jazyku se budou zobrazovat stránky při podepisování.
Stačí při předání dokumentu nebo údajů pro vzor zvolit dvoupísměnnou zkratku jazyka.
Pozn: Pozor, pokud používáte fuknci Advanced Branding, kde máte své znění notifikačních emailů, je třeba mít připravené šablony emailů pro své jazyky. Lze ověřit zasláním dokumentu napřímo ze Signi, kdy v podpisovém scénáři zvolíte daný jazyk.
...
Verze konektoru 1.0.2104.4
12.4.2021
Konektor ke stažení : https://docs.talxis.com/cz/customizer-guide/integration/signi/
Přidána nová akce : Sign Contract From Provided File and Wait (V2)
Funkce umožňuje:
Dynamický počet podepisujících či schvalovatelů - Lze zadat libovolný počet podepisujích či schvalujících, jak mezi zástupci navrhovatele, tak protistran
Možnost dynamického umístění podpisu - Při hodnotě parametru Automatic sign placement: append_to_the_end není třeba určovat souřadnice ani velikost jednotlivých podpisů. všechny podpisy se umístí na samostatný podpisový arch přidaný na závěr dokumentu. Druhá možnost je Automatic sign placement: error , kdy pokud nejsou uvedeny souřadnice podpisu, je vyvolána chuba a dokument není předán k podepsaní.
...
Zadání parametrů pro dynamické umíťování podpisů MS PowerAutomate
...
Přiklad dynamickoého umístění podpisu
Verze konektoru 1.0.1
10. 2020
První verze Signi konektoru pro MIcrosoft využívající volání Vytvoření slouvy 1.0 Signi API umožňující přdat PDS dokument k podpisu, zadat jednoho navrhovatele a jednu protistranu a určit souřadnice podpisů
...
Konektor má vždy nějaké “zpoždění” ohledně dostupnustí funkcní dostupných v Signi API. V případě potřeby e možné volat Signi API napřímo přes HTTP Request.
Kam se obrátit v případě potíží
Prvním místem je help@signi.com .
Alternativou je obrátit se přímo na autory konetoru na support.networg.com či na e-mail psa@support.networg.com .