Deltager
Indstillingerne for Begrænset dokumentsynlighed tillader, at en aftale kan indeholde flere filer, der er selektivt synlige for modtagerne, afhængigt af, hvilke indstillinger der er aktiveret, og hvordan aftalen er konfigureret.
Brugseksempler omfatter:
Her er en hurtig video, der registrer brugen på højt niveau:
Begrænset dokumentsynlighed involverer et antal meget specifikke begreber:
Bruger vs. bruger-id
Interne vs. eksterne parter
Regler for Begrænset dokumentsynlighed (BDS) er aktiveret på konto- eller gruppeniveauet (gruppeindstillinger tilsidesætter kontoindstillingerne)
BDS-regler viser kun det filindhold, der er eksplicit tildelt til en given modtager.
Filindholdet tildeles til en modtager ved at tilføje mindst ét felt, der er tildelt den modtager.
I eksemplet til højre er der to underskrivere og to dokumenter i en aftale.
Underskriver 1 ser begge dokumenter, da der er et felt tildelt på begge dokumenter (Felt 1 og Felt 2)
Underskriver 2 vil kun se Dok 2, fordi de ikke har et tildelt felt på Dok 1.
BDS-regler forventer to forudsætninger:
Hvis nogen af ovenstående krav ikke er sande, suspenderes BDS-regler for den aftale.
Når BDS er aktiveret, har det tre indstillinger, der ændrer adfærden af aftalen, og hvordan den vises:
Underskrivere og CC-modtagere i min konto vil se alle filer – når det er aktiveret, alle bruger-id'er i din konto, der får adgang til aftalen (som en modtager eller som en cc-part)
Når "Underskrivere vil kun se filer, der indeholder en underskrift, initialer eller indtastningsfelter, som er blevet tildelt til dem" er deaktiveret, er BDS som en helhed deaktiveret i grænsefladen.
Alle modtagere og cc-parter ser alle filer hele tiden.
Deltager |
Ved underskrivelse |
Fuldført aftale |
---|---|---|
Afsender |
Alle dokumenter |
Alle dokumenter |
Intern modtager |
Alle dokumenter |
Alle dokumenter |
Ekstern modtager |
Alle dokumenter |
Alle dokumenter |
Intern cc |
Alle dokumenter |
Alle dokumenter |
Ekstern cc |
Alle dokumenter |
Alle dokumenter |
Ekstern arkivmodtager |
NA |
Alle dokumenter |
Kun når Underskrivere vil kun se filer, der indeholder en underskrift, initialer eller indtastningsfelter, som er blevet tildelt til dem er aktiveret:
Deltager |
Ved underskrivelse |
Fuldført aftale |
---|---|---|
Afsender |
Alle dokumenter |
Alle dokumenter |
Intern modtager |
Tildelte dokumenter |
Tildelte dokumenter |
Ekstern modtager |
Tildelte dokumenter |
Tildelte dokumenter |
Intern cc |
Ingen |
Ingen |
Ekstern cc |
Ingen |
Ingen |
Ekstern arkivmodtager |
NA |
Alle dokumenter |
Når Underskrivere og CC-modtagere i min konto vil se alle filer er aktiveret:
Deltager |
Ved underskrivelse |
Fuldført aftale |
---|---|---|
Afsender |
Alle dokumenter |
Alle dokumenter |
Intern modtager |
Alle dokumenter |
Alle dokumenter |
Ekstern modtager |
Tildelte dokumenter |
Tildelte dokumenter |
Intern cc |
Alle dokumenter |
Alle dokumenter |
Ekstern cc |
Ingen |
Ingen |
Ekstern arkivmodtager |
NA |
Alle dokumenter |
Når Underskrivere og CC-modtagere ser alle filer, når de modtager den underskrevne aftale er aktiveret:
Når aftalen er fuldført, kan alle modtagere og cc-parter se alt filindhold.
Deltager |
Ved underskrivelse |
Fuldført aftale |
---|---|---|
Afsender |
Alle dokumenter |
Alle dokumenter |
Intern modtager |
Tildelte dokumenter |
Alle dokumenter |
Ekstern modtager |
Tildelte dokumenter |
Alle dokumenter |
Intern cc |
Ingen |
Alle dokumenter |
Ekstern cc |
Ingen |
Alle dokumenter |
Ekstern arkivmodtager |
NA |
Alle dokumenter |
Denne konfiguration aktiverer BDS-regler og lader alle interne bruger-id'er (relative til afsenderen) se alt filindhold under underskrivelsescyklussen.
Når aftalen er fuldført, kan alle brugere se alt filindhold
Deltager |
Ved underskrivelse |
Fuldført aftale |
---|---|---|
Afsender |
Alle dokumenter |
Alle dokumenter |
Intern modtager |
Alle dokumenter |
Alle dokumenter |
Ekstern modtager |
Tildelte dokumenter |
Alle dokumenter |
Intern cc |
Alle dokumenter |
Alle dokumenter |
Ekstern cc |
Ingen |
Alle dokumenter |
Ekstern arkivmodtager |
NA |
Alle dokumenter |
Hvis du har planer om at aktivere håndskrevne signaturer, bør du aktivere denne indstilling, men vær opmærksom på, at BDS-regler ikke gælder, når en håndskreven signatur er involveret.
I alle tilfælde suspenderes BDS-regler for den aftalen, når en håndskreven signatur er involveret.
Deltager |
Ved underskrivelse |
Fuldført aftale |
---|---|---|
Afsender |
Alle dokumenter |
Alle dokumenter |
Intern modtager |
Alle dokumenter |
Alle dokumenter |
Ekstern modtager |
Alle dokumenter |
Alle dokumenter |
Intern cc |
Alle dokumenter |
Alle dokumenter |
Ekstern cc |
Alle dokumenter |
Alle dokumenter |
Ekstern arkivmodtager |
NA |
Alle dokumenter |
REST API v6 kan bruges af afsenderen for eksplicit at give synlighed til dokumenter.
REST API v6-kald ignorerer alle indstillinger for dokumentsynlighed i grænsefladen, da API-kaldet tilsidesætter indstillinger på konto-/gruppeniveau.
Den eneste adfærd, der overføres, er, at afsenderen skal specificere et dokumentnavn, hvis det specificerer et formularfelt for en bestemt modtager.
POST /aftaler REST API v6-slutpunkt har tre parametre, der kan bruges til at styre adfærden for dokumentsynlighed.
Parameternavn |
Type |
Obligatorisk |
Beskrivelse |
---|---|---|---|
dokumentsynlighedAktiveret |
Boolsk |
Nej |
Valgfri parameter for dokumentsynlighed for aftalen. Denne parameter skal specificeres og indstilles til sand for at aktivere dokumentsynlighed. |
Parameternavn |
Type |
Obligatorisk |
Beskrivelse |
---|---|---|---|
synligeSider |
Streng[] |
Nej |
En liste over FileInfo.label, der bør gøres synlig for deltagere i dette deltagersæt. |
Parameternavn |
Type |
Obligatorisk |
Beskrivelse |
---|---|---|---|
synligeSider |
Streng[] |
Nej |
En liste over FileInfo.label, der bør gøres synlig for deltagere i denne cc. |
HTTP-statuskode |
Årsag |
Beskrivelse |
---|---|---|
400 |
INVALID_PARTICIPANT_SET_VISIBLE_PAGE_LABEL |
Ét eller flere synlige sidenavne i deltagersættet er ugyldige. |
400 |
INVALID_CC_VISIBLE_PAGE_LABEL |
Ét eller flere synlige sidenavne i CC er ugyldige. |
403 |
DOCUMENT_VISIBILITY_DISABLED |
Dokumentsynlighed aktiveret er indstillet til falsk, og derfor kan filinfoindeks ikke specificeres for noget deltagersæt eller cc. |
GET /agreements/{agreementId} REST API v6-slutpunkt kan bruges til at hente relationen mellem deltagere og dokumenter
Parameternavn |
Type |
Beskrivelse |
---|---|---|
dokumentsynlighedAktiveret |
Boolsk |
Hvis sand, var dokumentsynlighed aktiveret for denne aftale. |
Parameternavn |
REST-objekt |
Beskrivelse |
---|---|---|
synligeSider |
Streng[] |
En liste over FileInfo.label, der bør gøres synlig for deltagere i dette deltagersæt. |
Parameternavn |
REST-objekt |
Beskrivelse |
---|---|---|
synligeSider |
Streng[] |
En liste over FileInfo.label, der bør gøres synlig for deltagere i denne cc. |
Hvis GET /agreements/{agreementId} rapporterer ANNULLERET status, kan det skyldes én eller flere ugyldige parameterværdier for dokumentsynlighed.
Brug GET /agreements/{agreementId}/events for at hente fejlårsagen.
Fejlbesked |
Betingelse |
---|---|
fileInfoIndex <FileInfo index> mangler i ét af participantSets, der indeholder <participant email> |
<label> skal specificeres som visiblePages for deltager <participant email> |
Ovenstående fejl logges med værdien Event.type for AUTO_CANCELLED_CONVERSION_PROBLEM og Event.comment.
Begrænset dokumentsynlighed og digitale signaturcertifikater er inkompatible.
Når BDS er aktiveret, fjernes det digitale signaturobjekt fra appens oprettelsesmiljø.
Hvis en aftale med et digitalt signaturfelt sendes med BDS-regler aktiveret, udløses der en fejl:
Digitalt signaturfelt <field name> understøttes ikke pga. begrænset dokumentsynlighed.
Hvis bruger-id'et kan se den fil, der indeholder feltet med vedhæftede filter, har de også tilladelse til at se indholdet i den vedhæftede fil.
Udskiftning af en modtager virker på normal vis med én undtagelse.
Hvis Underskrivere og CC-modtagere i min konto vil se alle filer er aktiveret:
Filerne og felterne kan redigeres (med funktionen Rediger aftale), så længe den første modtager ikke er blevet set som en deltager
BDS er rolleagnostisk.
Hvis du har en ikke-underskrivende modtager, skal den modtager have mindst ét felt placeret på hver fil, som du vil give dem adgang til.
Hvis en modtager ikke har synlige felter (fordi der ikke er placeret nogen felter), udløses der en fejl:
Deltageren <email> (<participant role>) har ikke noget synligt dokument
Send i massevis fungerer på samme måde som andre aftaler.
Når en aftale sendes, skal der være mindst ét obligatorisk (ikke valgfrit eller betinget) signaturfelt for hver modtager med en underskrivelsesrolle.
Hvis én eller flere underskrivere ikke har et obligatorisk signaturfelt, føjes der en ekstra side til slutningen af aftalen, og der tilføjes en signaturblok for hver underskriver (der giver alle underskrivere en visning af den sidste side).
Log ind på din konto