Participant
Les paramètres Visibilité limitée de documents (LDV) permettent d’intégrer plusieurs fichiers à un accord, qui sont visibles de manière sélective par les destinataires en fonction des paramètres activés et de la configuration de l’accord.
Les utilisations possibles incluent entre autres :
Voici une courte vidéo qui illustre l’utilisation de haut niveau :
La fonction Visibilité limitée de documents fait intervenir plusieurs termes particuliers :
Utilisateur et ID utilisateur
Entités internes et externes
Les règles de Visibilité limitée de documents (LDV) sont activées au niveau du compte/groupe.
Les règles de LDV présentent uniquement le contenu du fichier qui a été explicitement attribué à un destinataire donné.
Le contenu du fichier est affecté à un destinataire en ajoutant au moins un champ attribué à ce destinataire.
Dans l’exemple de droite, un accord comporte deux signataires et deux documents.
Le signataire 1 voit les deux documents, car un champ lui est attribué dans les deux documents (Champ 1 et Champ 2).
Le signataire 2 ne verra que le Document 2, car il n’a pas de champ attribué sur le Document 1.
Les règles de LDV requièrent deux conditions préalables :
Si l’une des conditions ci-dessus n’est pas vérifiée, les règles de LDV sont suspendues pour cet accord.
Lorsque cette option est activée, le fichier LDV comporte trois paramètres qui modifient le comportement de l’accord et son affichage :
Les signataires ne verront que des fichiers contenant une signature, des initiales ou des champs d’entrée de données qui leur sont attribués est le paramètre racine qui active l’expérience LDV et l’ensemble des commandes. Si l’option
Les signataires ne verront que des fichiers contenant une signature, des initiales ou des champs d’entrée de données qui leur sont attribués est désactivée, la LDV dans son ensemble est désactivée dans l’interface utilisateur.
Tous les destinataires et les personnes en copie voient tous les fichiers en permanence.
|
Participant |
Pendant la signature |
Accord terminé |
|---|---|---|
|
Expéditeur |
Tous les documents |
Tous les documents |
|
Destinataire interne |
Tous les documents |
Tous les documents |
|
Destinataire externe |
Tous les documents |
Tous les documents |
|
Personne interne en copie |
Tous les documents |
Tous les documents |
|
Personne externe en copie |
Tous les documents |
Tous les documents |
|
Destinataire des archives externes |
s.o. |
Tous les documents |
Lorsque l’option Les signataires ne verront que des fichiers contenant une signature, des initiales ou des champs d’entrée de données qui leur sont attribués est activée :
|
Participant |
Pendant la signature |
Accord terminé |
|---|---|---|
|
Expéditeur |
Tous les documents |
Tous les documents |
|
Destinataire interne |
Documents attribués |
Documents attribués |
|
Destinataire externe |
Documents attribués |
Documents attribués |
|
Personne interne en copie |
Aucun |
Aucun |
|
Personne externe en copie |
Aucun |
Aucun |
|
Destinataire des archives externes |
s.o. |
Tous les documents |
Lorsque l’option Les signataires et les personnes en copie de mon compte verront tous les fichiers est activée :
|
Participant |
Pendant la signature |
Accord terminé |
|---|---|---|
|
Expéditeur |
Tous les documents |
Tous les documents |
|
Destinataire interne |
Tous les documents |
Tous les documents |
|
Destinataire externe |
Documents attribués |
Documents attribués |
|
Personne interne en copie |
Tous les documents |
Tous les documents |
|
Personne externe en copie |
Aucun |
Aucun |
|
Destinataire des archives externes |
s.o. |
Tous les documents |
Lorsque l’option Les signataires et les personnes en copie verront tous les fichiers lors de la réception de l’accord signé est activée :
Une fois l’accord terminé, tous les destinataires et les personnes en copie peuvent voir l’ensemble du contenu de fichier.
|
Participant |
Pendant la signature |
Accord terminé |
|---|---|---|
|
Expéditeur |
Tous les documents |
Tous les documents |
|
Destinataire interne |
Documents attribués |
Tous les documents |
|
Destinataire externe |
Documents attribués |
Tous les documents |
|
Personne interne en copie |
Aucun |
Tous les documents |
|
Personne externe en copie |
Aucun |
Tous les documents |
|
Destinataire des archives externes |
s.o. |
Tous les documents |
Cette configuration active les règles de LDV et permet à tous les ID utilisateur internes (associés à l’expéditeur) d’afficher l’ensemble du contenu du fichier pendant le cycle de signature.
Une fois l’accord terminé, tous les utilisateurs peuvent afficher l’ensemble du contenu du fichier.
|
Participant |
Pendant la signature |
Accord terminé |
|---|---|---|
|
Expéditeur |
Tous les documents |
Tous les documents |
|
Destinataire interne |
Tous les documents |
Tous les documents |
|
Destinataire externe |
Documents attribués |
Tous les documents |
|
Personne interne en copie |
Tous les documents |
Tous les documents |
|
Personne externe en copie |
Aucun |
Tous les documents |
|
Destinataire des archives externes |
s.o. |
Tous les documents |
Si vous envisagez d’accepter des signatures manuscrites, activez cette option, mais sachez que les règles de LDV ne s’appliquent pas lorsqu’une signature manuscrite est impliquée.
Dans tous les cas, lorsqu’une signature manuscrite est impliquée, les règles de LDV sont suspendues pour cet accord.
|
Participant |
Pendant la signature |
Accord terminé |
|---|---|---|
|
Expéditeur |
Tous les documents |
Tous les documents |
|
Destinataire interne |
Tous les documents |
Tous les documents |
|
Destinataire externe |
Tous les documents |
Tous les documents |
|
Personne interne en copie |
Tous les documents |
Tous les documents |
|
Personne externe en copie |
Tous les documents |
Tous les documents |
|
Destinataire des archives externes |
s.o. |
Tous les documents |
L’expéditeur peut utiliser l’API REST v6 pour accorder explicitement la visibilité des documents.
Les appels de l’API REST v6 ignorent tous les paramètres de visibilité des documents dans l’interface utilisateur, car l’appel de l’API remplace les paramètres de niveau compte/groupe.
Le seul comportement de report est le suivant : lorsque l’expéditeur spécifie un champ de formulaire pour un destinataire donné, il doit spécifier un libellé de document.
Le point de terminaison POST/agreements de l’API REST v6 possède trois paramètres qui peuvent être utilisés pour contrôler les comportements de visibilité des documents.
|
Nom du paramètre |
Type |
Obligatoire |
Description |
|---|---|---|---|
|
documentVisibilityEnabled |
Booléen |
Non |
Paramètre de visibilité du document facultatif pour l’accord. Ce paramètre doit être spécifié et défini sur true pour activer la visibilité du document. |
|
Nom du paramètre |
Type |
Obligatoire |
Description |
|---|---|---|---|
|
visiblePages |
Chaîne[] |
Non |
Liste de FileInfo.label qui doit être visible pour les participants de cet ensemble. |
|
Nom du paramètre |
Type |
Obligatoire |
Description |
|---|---|---|---|
|
visiblePages |
Chaîne[] |
Non |
Liste de FileInfo.label qui doit être visible pour les participants en copie. |
|
Code d’état HTTP |
Motif |
Description |
|---|---|---|
|
400 |
INVALID_PARTICIPANT_SET_VISIBLE_PAGE_LABEL |
Au moins une des étiquettes de page visibles dans l’ensemble de participants n’est pas valide. |
|
400 |
INVALID_CC_VISIBLE_PAGE_LABEL |
Au moins une des étiquettes de page visibles dans CC n’est pas valide. |
|
403 |
DOCUMENT_VISIBILITY_DISABLED |
L’activation de la visibilité du document est définie sur false. Par conséquent, l’index d’informations de fichier ne peut pas être spécifié pour un ensemble de participants ou de personnes en copie. |
Le point de terminaison GET /agreements/{agreementId} de l’API REST v6 peut être utilisé pour récupérer la relation entre les participants et les documents.
|
Nom du paramètre |
Type |
Description |
|---|---|---|
|
documentVisibilityEnabled |
Booléen |
Si la valeur est true, la visibilité du document est activée pour cet accord. |
|
Nom du paramètre |
Objet REST |
Description |
|---|---|---|
|
visiblePages |
Chaîne[] |
Liste de FileInfo.label qui doit être visible pour les participants de cet ensemble. |
|
Nom du paramètre |
Objet REST |
Description |
|---|---|---|
|
visiblePages |
Chaîne[] |
Liste de FileInfo.label qui doit être visible pour les participants en copie. |
Si GET /agreements/{agreementId} signale l’état ANNULÉ, une ou plusieurs valeurs de paramètres de visibilité de document ne sont peut-être pas valides.
Utilisez GET /agreements/{agreementId}/events pour connaître le motif de l’échec.
|
Message d’erreur |
Condition |
|---|---|
|
fileInfoIndex <index FileInfo> est manquant dans l’un des participantsSets contenant <e-mail du participant> |
<libellé> doit être spécifié en tant que visiblePages pour le participant <e-mail du participant> |
L’échec ci-dessus est consigné avec la valeur Event.type de AUTO_CANCELLED_CONVERSION_PROBLEM et Event.comment.
La visibilité de document limitée et les certificats de signature numérique sont incompatibles.
Lorsque la LDV est activée, l’objet de signature numérique est supprimé de l’environnement de création intégré.
Si un accord avec un champ de signature numérique est envoyé avec des règles de LDV activées, une erreur est déclenchée :
Le champ de signature numérique <nom du champ> n’est pas pris en charge en raison de la fonctionnalité de visibilité de document limitée.
Si l’ID utilisateur peut afficher le fichier contenant le champ de pièce jointe, il peut également afficher le contenu de la pièce jointe.
Le remplacement d’un destinataire fonctionne de la manière habituelle, avec une exception :
Si l’option Les signataires et les personnes en copie de mon compte verront tous les fichiers est activée :
Les fichiers et les champs peuvent être modifiés (à l’aide de la fonction Modifier l’accord) tant que l’accord n’a pas été consulté par un participant.
La LDV est indépendante du rôle.
Si vous avez un destinataire non-signataire, ce destinataire doit avoir au moins un champ placé sur chaque fichier auquel vous souhaitez qu’il ait accès.
Si aucun fichier n’est visible pour un destinataire (car aucun champ n’est placé), une erreur est déclenchée :
Aucun document n’est visible pour le participant <e-mail> (<rôle du participant>)
L’accord Envoyer en masse fonctionne de la même manière que les autres accords.
Lorsqu’un accord est envoyé, chaque destinataire ayant un rôle de signataire doit avoir au moins un champ de signature obligatoire (non facultatif ou conditionnel).
Si un ou plusieurs signataires n’ont pas de champ de signature obligatoire, une page supplémentaire est ajoutée à la fin de l’accord et un bloc de signature pour chaque signataire est ajouté (tous les signataires voient cette dernière page).
Accéder à votre compte