Sign

E-signering

MarknadsplatsInnehåll och dokumentVersion 0.1.0manifest

Vad den är till för ​

Manage templates and signature requests through draft, sent, signed, declined and expired, and record the document hash that was signed. The platform cannot yet lock a record, so a signed request is immutable by convention only.

Vad paketet gör och inte gör ​

Document templates and signature requests with a draft, sent, signed, declined, expired flow. A request names the signer (personal data) and keeps the signature evidence as references. A signed request is immutable by convention only: the platform cannot yet lock a record, so nobody should edit a request once it is signed, and the document_hash records what was signed. Sending and recording a signature need a human approval; agents may only propose them.

Modeller ​

sign_template ​

A document that can be sent out for signature

Läsgrupp: sign.user. Skrivgrupp: sign.manager.

FältTypDataklassPersonuppgiftGruppAgenter serBeskrivning
nametextnonenejsign.useri klartextTemplate name, for example Employment contract
descriptionlongtextnonenejsign.useri klartextWhat the document is for and who signs it
bodylongtextnonenejsign.useri klartextThe document text, or a reference to where the file is kept
signer_roletextnonenejsign.useri klartextRole of the person who signs, for example Customer
activeboolnonenejsign.useri klartextWhether new requests can use the template

sign_request ​

A request for one person to sign one document

Läsgrupp: sign.user. Skrivgrupp: sign.user.

FältTypDataklassPersonuppgiftGruppAgenter serBeskrivning
template_idref → sign_templatenonenejsign.useri klartextThe document to sign
titletextnonenejsign.useri klartextSubject shown to the signer
messagelongtextnonenejsign.useri klartextMessage shown to the signer in the request
signer_nametextinternaljasign.usermaskeradName of the person who must sign
signer_emailtextinternaljasign.usermaskeradEmail address the request is sent to
sent_ondatenonenejsign.useri klartextDay the request was sent (YYYY-MM-DD)
expires_ondatenonenejsign.useri klartextLast day the request can be signed (YYYY-MM-DD)
signed_ondatenonenejsign.useri klartextDay the document was signed (YYYY-MM-DD)
signer_iptextinternaljasign.managermaskeradIP address the signature came from (evidence)
signer_user_agenttextinternaljasign.managermaskeradBrowser the signature was made with (evidence)
signature_referencetextnonenejsign.manageri klartextWhere the signature image or certificate is stored
document_hashtextnonenejsign.manageri klartextSHA-256 hash (hex) of the signed document, to prove it was not changed afterwards
stateselect (draft, sent, signed, declined, expired)nonenejsign.useri klartextRequest status: draft, sent, signed, declined, expired

Arbetsflöden ​

sign_request ​

ÅtgärdFlyttarVem får köra denGodkännande
sign_request.sendstate: draft → sentsign.userja
sign_request.signstate: sent → signedsign.managerja
sign_request.declinestate: sent → declinedsign.usernej
sign_request.expirestate: sent → expiredsign.usernej

Behörighetsgrupper ​

Grupper som den här appen använder:

  • sign.manager
  • sign.user

Steg som kräver godkännande ​

Steg som en agent bara kan föreslå:

  • sign_request.send
  • sign_request.sign

Vad agenter kan och inte kan göra ​

En agent kan läsa, söka, skapa och uppdatera poster i den här appen, och köra de åtgärder som inte kräver godkännande, inom behörighetsgrupperna för sin token.

Den kan bara föreslå de här stegen, och en person måste godkänna dem: sign_request.send, sign_request.sign, sign_template.delete, sign_request.delete.

Personuppgifter maskeras som platshållare: sign_request.signer_name, sign_request.signer_email, sign_request.signer_ip, sign_request.signer_user_agent.

Beroenden ​

Inga.

Installera ​

Installera den från appen Customize (Marknadsplats), eller från kommandoraden:

bash
obop modules install-from sign

Kräver en databas och administratörsbehörighet.

Bygg din egen ​

Modulguiden visar hur appar som den här skrivs