Llofnodi Iframe neu Wedi'i Mewnosod

Embed/iframe y dudalen llofnodi yn eich ap eich hun.

Diweddariad - golygu cydran JS a llofnodi yn dod yn fuan. Cysylltwch â ni.

Dolenni uniongyrchol

Os oes arnoch angen tudalen agored syml nad oes angen addasu, lle gall unrhyw un fynd a llofnodi dogfen (ac yn opsiynol gadarnhau eu e-bost wedyn), ceisiwch Dolen Legalesign. Gallwch greu’r rhain yn y we app heb god. Maent hefyd yn ymgorfforiadwy. Enghreifftiau o Dolenni gallai fod cofrestru digwyddiad, taflenni amser, ymddiheuriadau atebolrwydd. Dysgwch fwy am Dolen Legalesign (tudalennau llofnodi ymgorfforiadwy).

API

Os oes angen i chi addasu’r ddogfen, neu os oes angen mwy o swyddogaeth, defnyddiwch yr API.

Cyfyngiadau

Dyfeisiau

Mae hyn yn ymwneud â dogfennau sy’n seiliedig ar PDF (nid dogfennau testun/html).

• mae cyd-destunau bwrdd gwaith yn gweithio’n dda
• mae cyd-destunau symudol yn gweithio ar gyfer dogfennau syml (h.y. llofnod, nid ffurflenni cymhleth)
• efallai na fydd cyd-destunau symudol lle mae gennych ffurflen gymhleth yn gweithio’n dda (yn enwedig ar iPhones) ac rydym yn argymell eich bod yn neidio defnyddiwr i ffenestr porwr newydd (gallwch guddio hyn drwy dynnu baw y dudalen llofnodi a chynnal ailgyfeirio, gweler isod).

Er nad yw’r opsiwn olaf yn UX llyfn, bydd yn sicrhau profiad dibynadwy i’ch defnyddwyr. Hyd y gwyddom ni, nid yw’n bosibl bod yn hyderus ynghylch maint dyfais y defnyddiwr o fewn ffenestr iframe (mewn rhai neu holl iPhones), sy’n gwneud llywio clir o amgylch ffurflen gymhleth yn amhendant.

Safon Llofnod

Rhybudd arall, heb gynllunio, efallai na fyddwch yn cwrdd â safon llofnod electronig 'uwch'.

Mae’r egwyddorion allweddol o’r safon yn cynnwys

• rhaid i’ch llofnodwr fod yn rheolaeth unig ar y broses llofnodi ac
• rhaid iddo gael ei adnabod yn unigryw.

Trwy dderbyn y ddolen llofnodi eich hun, gallwch nawr lofnodi’r ddogfen; colledir rheolaeth unig.

Efallai y byddai ateb yn ychwanegu dilysu SMS i’ch derbynnydd. Bydd derbyn y testun SMS hwnnw o dan reolaeth unig eich derbynnydd a bydd yn eu hadnabod yn unigryw.

Bydd angen i chi gynllunio pa reolaethau sydd ar waith i sicrhau bod y llofnodwr yn adnabod a bod rheolaeth unig ar eich ochr i adennill y safon 'uwch'. Dysgwch fwy am y ddeddf ar lofnodion electronig.

Sut i greu dolen llofnodi ymgorfforiadwy

Byddwch wedi dilyn y tiwtorial cychwyn cyflym a llwyddo i greu/anfon dogfen i’w llofnodi.

1. Ychwanegwch yr nodwedd ganlynol yn eich cais POST sy’n creu/anfon dogfen (h.y. /api/v1/document/):

{return_signer_links: true}

2. Darllenwch y CYNIG o’r ymateb a byddwch yn canfod gwrthrych JSON sy’n cynnwys y dolenni llofnodi ar gyfer pob un o’ch derbynwyr dogfen.

3. Rhowch y ddolen llofnodi o fewn elfen iframe.

Nodweddion defnyddiol eraill

• I atal pob e-bost Legalesign, yna mewn y POST i /api/v1/document/ gosodwch y nodwedd hon: {do_email: false}.

• I ailgyfeirio’r defnyddiwr yn syth ar ôl llofnodi ychwanegwch y nodwedd hon: {redirect: yourUrl } (gweler mwy isod).

• I dynnu baw o’r dudalen llofnodi, ychwanegwch y llinyn chwiliad hwn i’r ddolen llofnodi: &hidenav=1&hidetext=1

Adolygwch yr holl nodweddion anfon-dogfen yma: Galwad API Anfon Dogfen

Ffactor Safari

Os ydych yn disgwyl defnyddwyr safari efallai y bydd angen i chi ychwanegu ‘trwsio’ gyda darn bach o JavaScript.

Mae gosodiadau diogelwch diofyn Safari yn gwrthod cwcis iframe. Os ydych am drin hyn heb darfu ar y defnyddiwr, bydd angen i chi a) anfon eich parth gwraidd atom, a b) gweithredu rhywfaint o JavaScript cyn i’r iframe lwytho - cliciwch yma am y côd (ymddiheuriadau am jQuery, dylech allu ei addasu yn ôl yr angen). O fewn y JS bydd angen i chi ychwanegu rhai paramedrau i’r URL sy’n cael ei chwilio. Os nad yw hyn yn glir o’r enghraifft côd cysylltwch â ni am gymorth.

Mae Safari wedi gwneud defnyddio iframe yn fwy anodd.

Os ydych am sicrhau bod iframe yn gweithio yn Safari bydd angen i chi ddefnyddio ein nodwedd CNAME newydd. Bydd hyn yn gosod y tudalennau llofnodi mewn is-barth o’ch prif barth. Mae’r nodwedd hon yn dal yn beta, cysylltwch â ni os ydych am ei defnyddio.

Y dewis amgen gorau yw cael defnyddwyr i neidio allan i ffenestr porwr newydd, wedi gosod URL ailgyfeirio-ar- ôl-llofnodi ar y ddogfen i’w dod yn ôl ar ôl cwblhau (gweler isod).

Signalau wedi gorffen

Mae dau ffordd i gymryd rheolaeth ar ôl llofnodi.

• Gosodwch URL ailgyfeirio ar eich dogfen wrth i chi ei chreu. Bydd Legalesign yn ailgyfeirio’r defnyddiwr i’ch URL ar ôl cwblhau’r ddogfen, neu
• defnyddiwch nodwedd postMessage JavaScript.

URL Ailgyfeirio

Ychwanegwch yn syml eich URL ailgyfeirio i nodwedd ‘redirect’ y cais POST sy’n creu’r ddogfen (/api/v1/document/).

Oherwydd bod yr ailgyfeirio yn ôl pob dogfen (nid yn ôl person), bydd Legalesign yn atodi llinyn chwiliad i’ch URL ailgyfeirio y gallwch ei ddefnyddio i gasglu gwybodaeth am gyflwr y ddogfen a’r llofnodwr:

[your URL]?signer=[signer UID]&doc=[doc UID]&group=[group UID]&signer_state=[signer status]&doc_state=[doc state]

Cliciwch ar y dolenni hyn i weld y tabl cyfeirio ar gyfer statws dogfen a statws derbynnydd.

postMessage

Mae postMessage yn neges a drosglwyddir trwy JavaScript y gallwch ei derbyn yn eich fframwr rhieni. Yna gallwch ddefnyddio’r negeseuon hynny i wneud ailgyfeiriadau neu ail-lunio’r dudalen fel y bo’n angenrheidiol.

Ar ôl llofnodi byddwch yn derbyn un o dri neges postMessage JavaScript yn syth: 'waiting’, 'signed’, 'rejected’.

Os yw’r ddogfen wedi ei llofnodi a’ch bod yn caniatáu i’r broses llofnodi barhau ac yn caniatáu i’r dudalen lawrlwytho lan-lunio yn eich iframe, byddwch hefyd yn cael y neges 'download’ os yw’r botwm lawrlwytho dogfen yn cael ei glicio.

Byddwch yn cael neges 'waiting’ os oes mwy na 1 llofnodwr gennych a bod angen i bobl eraill ei llofnodi eto.

Am fwy o wybodaeth am postMessage, gweler: https://developer.mozilla.org/en-US/docs/Web/API/Window/postMessage.

Os bwriwch ailgyfeirio’r llofnodwr, sylfwch y gallai fo neu hi weld tudalen newydd yn llunio’n fyr (naill ai’r dudalen ‘download’ neu dudalen ‘waiting for others’) cyn i’ch ailgyfeirio defnyddio postMessage ddod i rym.

Nesaf.

Ar ôl llofnodi gallwch lawrlwytho’r ddogfen PDF derfynol. Argymhellwn ddefnyddio gwehookiau i wneud hynny. Dysgwch fwy am wehookiau. Edrychwch ar y ddogfennaeth ar gyfer galwad API i lawrlwytho PDF terfynol. Peidiwch â gwneud y lawrlwythiad yn syth ar ôl digwyddiad llofnodi (gan ddefnyddio’r signalau ôl-llofnodi uchod), efallai na fydd y PDF terfynol yn barod. Yn fwy dibynadwy, gwrandewch am y gwehook lle mae’r gwrthrych yn 'document' ac y digwyddiad yn 'finalPdfCreated'.