Sign

Sähköiset allekirjoitukset

MarkkinapaikkaSisältö ja asiakirjatVersio 0.1.0manifest

Mihin se on tarkoitettu ​

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.

Mitä paketti tekee ja mitä ei ​

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.

Mallit ​

sign_template ​

A document that can be sent out for signature

Lukuryhmä: sign.user. Kirjoitusryhmä: sign.manager.

KenttäTyyppiTietoluokkaHenkilötietoRyhmäAgentit näkevätKuvaus
nametextnoneeisign.userselkoisenaTemplate name, for example Employment contract
descriptionlongtextnoneeisign.userselkoisenaWhat the document is for and who signs it
bodylongtextnoneeisign.userselkoisenaThe document text, or a reference to where the file is kept
signer_roletextnoneeisign.userselkoisenaRole of the person who signs, for example Customer
activeboolnoneeisign.userselkoisenaWhether new requests can use the template

sign_request ​

A request for one person to sign one document

Lukuryhmä: sign.user. Kirjoitusryhmä: sign.user.

KenttäTyyppiTietoluokkaHenkilötietoRyhmäAgentit näkevätKuvaus
template_idref → sign_templatenoneeisign.userselkoisenaThe document to sign
titletextnoneeisign.userselkoisenaSubject shown to the signer
messagelongtextnoneeisign.userselkoisenaMessage shown to the signer in the request
signer_nametextinternalkylläsign.usermaskattuName of the person who must sign
signer_emailtextinternalkylläsign.usermaskattuEmail address the request is sent to
sent_ondatenoneeisign.userselkoisenaDay the request was sent (YYYY-MM-DD)
expires_ondatenoneeisign.userselkoisenaLast day the request can be signed (YYYY-MM-DD)
signed_ondatenoneeisign.userselkoisenaDay the document was signed (YYYY-MM-DD)
signer_iptextinternalkylläsign.managermaskattuIP address the signature came from (evidence)
signer_user_agenttextinternalkylläsign.managermaskattuBrowser the signature was made with (evidence)
signature_referencetextnoneeisign.managerselkoisenaWhere the signature image or certificate is stored
document_hashtextnoneeisign.managerselkoisenaSHA-256 hash (hex) of the signed document, to prove it was not changed afterwards
stateselect (draft, sent, signed, declined, expired)noneeisign.userselkoisenaRequest status: draft, sent, signed, declined, expired

Työnkulut ​

sign_request ​

ToimintoSiirtääKuka voi suorittaaHyväksyntä
sign_request.sendstate: draft → sentsign.userkyllä
sign_request.signstate: sent → signedsign.managerkyllä
sign_request.declinestate: sent → declinedsign.userei
sign_request.expirestate: sent → expiredsign.userei

Käyttöoikeusryhmät ​

Tämän sovelluksen käyttämät ryhmät:

  • sign.manager
  • sign.user

Hyväksyntävaiheet ​

Vaiheet, joita agentti voi vain ehdottaa:

  • sign_request.send
  • sign_request.sign

Mitä agentit voivat ja eivät voi tehdä ​

Agentti voi lukea, hakea, luoda ja päivittää tämän sovelluksen tietueita sekä suorittaa toiminnot, jotka eivät vaadi hyväksyntää, tunnisteensa käyttöoikeusryhmien rajoissa.

Se voi vain ehdottaa näitä vaiheita, ja ihmisen on hyväksyttävä ne: sign_request.send, sign_request.sign, sign_template.delete, sign_request.delete.

Henkilötiedot maskataan paikkamerkeiksi: sign_request.signer_name, sign_request.signer_email, sign_request.signer_ip, sign_request.signer_user_agent.

Riippuvuudet ​

Ei ole.

Asennus ​

Asenna se Customize-sovelluksesta (Marketplace) tai komentoriviltä:

bash
obop modules install-from sign

Vaatii tietokannan ja ylläpitäjän oikeudet.

Tee oma ​

Moduulioppaassa näytetään, miten tällaiset sovellukset kirjoitetaan