Pour télécharger l'exemple complet de code, consultez notre site Partage de code.
Un espace réservé à la signature est utile si l'identité d'un signataire doit être déterminée ultérieurement. Par exemple, lors de la création d'un modèle. Un espace réservé peut être attribué à un champ de signature comme si vous attribuiez un signataire ordinaire. Cependant, tous les espace réservés doivent être remplacés par des signataires réels avant que la transaction ne soit distribuée pour signature. Comme un espace de signature n'a pas d'adresse courriel, il est identifié par un ID.
Ajout d'un espace réservé à la signature dans un modèle
Pour ajouter un espace réservé à la signature à un modèle, vous devez d'abord créer l'objet Placeholder. Le code suivant va créer un objet Placeholder :
Placeholder placeholder = new Placeholder("Manager");
Une fois que l'objet Placeholder aura été créé, utilisez la fonction OneSpan Sign TemplateService pour ajouter l'espace réservé à votre signature à votre modèle et définissez l'objet templateId et l'espace réservé comme paramètres. Le code suivant permet d'effectuer ce qui suit :
Placeholder addedPlaceholder = eslClient.getTemplateService().addPlaceholder(templateId, placeholder);
Mise à jour d'un espace réservé à la signature
Pour mettre à jour un espace de signature existant, utilisez le code suivant :
addedPlaceholder.setName("Client"); Placeholder updatedPlaceholder = eslClient.getTemplateService().updatePlaceholder(templateId, addedPlaceholder);
Suppression d'un espace réservé à la signature
Enfin, la suppression d'un espace réservé à la signature se fait à l'aide de la commande PackageService. Vous devrez passer l'objet templateId et l'espace réservé id String comme paramètres.
eslClient.getPackageService().removeSigner(templateId, addedPlaceholder.getId());
Pour télécharger l'exemple complet de code, consultez notre site Partage de code.
Un espace réservé à la signature est utile si l'identité d'un signataire doit être déterminée ultérieurement. Par exemple, lors de la création d'un modèle. Un espace réservé peut être attribué à un champ de signature comme si vous attribuiez un signataire ordinaire. Cependant, tous les espace réservés doivent être remplacés par des signataires réels avant que la transaction ne soit distribuée pour signature. Comme un espace de signature n'a pas d'adresse courriel, il est identifié par un ID.
Ajout d'un espace réservé à la signature dans un modèle
Pour ajouter un espace réservé à la signature à un modèle, vous devez d'abord créer l'objet Placeholder. Le code suivant va créer un objet Placeholder :
Placeholder placeholder = new Placeholder("Manager");
Une fois que l'objet Placeholder aura été créé, utilisez la fonction OneSpan Sign TemplateService pour ajouter l'espace réservé à votre signature à votre modèle et définissez l'objet templateId et l'espace réservé comme paramètres. Le code suivant permet d'effectuer ce qui suit :
Placeholder addedPlaceholder = eslClient.TemplateService.AddPlaceholder(templateId, placeholder);
Mise à jour d'un espace réservé à la signature
Pour mettre à jour un espace de signature existant, utilisez le code suivant :
addedPlaceholder.Name = "Client"; Placeholder updatedPlaceholder = eslClient.TemplateService.UpdatePlaceholder(templateId, addedPlaceholder);
Suppression d'un espace réservé à la signature
Enfin, la suppression d'un espace réservé à la signature se fait à l'aide de la commande PackageService. Vous devrez passer l'objet templateId et l'espace réservé id String comme paramètres.
eslClient.PackageService.RemoveSigner(templateId, addedPlaceholder.Id);
Pour télécharger l'exemple complet de code, consultez notre site Partage de code.
Un espace réservé à la signature est utile si l'identité d'un signataire doit être déterminée ultérieurement. Par exemple, lors de la création d'un modèle. Un espace réservé peut être attribué à un champ de signature comme si vous attribuiez un signataire ordinaire. Cependant, tous les espace réservés doivent être remplacés par des signataires réels avant que la transaction ne soit distribuée pour signature. Comme un espace de signature n'a pas d'adresse courriel, il est identifié par un ID.
Ajout d'un espace réservé à un modèle
Pour ajouter un espace réservé à la signature dans un modèle, utilisez le code suivant :
Requête HTTP
POST /api/packages/{templateId}/roles
En-têtes HTTP
Accept: application/json Content-Type: application/json Authorization: Basic api_key
Données utiles de la demande
{ "id": "Manager", "type": "SIGNER", "index": 0, "name": "Manager" }
Pour une description complète de chaque champ, voir le tableau des données utiles de la demande ci-dessous.
Données utiles de la réponse
{ "id": "Manager", "data": null, "emailMessage": null, "attachmentRequirements": [], "locked": false, "reassign": false, "specialTypes": [], "type": "SIGNER", "index": 0, "signers": [], "name": "Manager" }
Mise à jour d'un espace réservé à la signature
La mise à jour d'un espace réservé se fait également de manière similaire. Vous devrez construire le JSON avec les mises à jour que vous souhaitez effectuer :
Requête HTTP
PUT /api/packages/{templateId}/roles/[roleId}
En-têtes HTTP
Accept: application/json Content-Type: application/json Authorization: Basic api_key
Données utiles de la demande
{ "id": "Manager", "type": "SIGNER", "index": 0, "name": "Manager" }
Données utiles de la réponse
{ "id": "Manager", "data": null, "emailMessage": null, "attachmentRequirements": [], "locked": false, "reassign": false, "specialTypes": [], "type": "SIGNER", "index": 0, "signers": [], "name": "Manager" }
Suppression d'un espace réservé à la signature
Enfin, pour supprimer un espace réservé :
Requête HTTP
DELETE /api/packages/{templateId}/roles/{roleId}
En-têtes HTTP
Accept: application/json Content-Type: application/json Authorization: Basic api_key
Tableau des données utiles de la demande
| Propriété | Type | Modifiable | Requis | Par défaut | Exemples de valeurs |
|---|---|---|---|---|---|
| nom | chaîne de caractères | Oui | Non | s.o. | Directeur |
| id | chaîne de caractères | Oui | Non | s.o. | Directeur |
| type | stringer | Oui | Non | SIGNER | SIGNATAIRE / EXPÉDITEUR |
| nom | chaîne de caractères | Oui | Non | s.o. | Directeur |
Pour télécharger l'exemple complet de code, consultez notre site Partage de code.
Un espace réservé à la signature est utile si l'identité d'un signataire doit être déterminée ultérieurement. Par exemple, lors de la création d'un modèle. Un espace réservé peut être attribué à un champ de signature comme si vous attribuiez un signataire ordinaire. Cependant, tous les espace réservés doivent être remplacés par des signataires réels avant que la transaction ne soit distribuée pour signature. Comme un espace de signature n'a pas d'adresse courriel, il est identifié par un ID.
Ajout d'un espace réservé à la signature dans un modèle
Pour ajouter un espace réservé dans un modèle, vous devez d'abord créer votre objet Role . Le code suivant permet d'effectuer ce qui suit :
String placeholderId = 'placeholder1'; ESignLiveAPIObjects.Role placeholder1 = new ESignLiveAPIObjects.Role(); placeholder1.id = placeholderId; placeholder1.name = placeholderId;
Une fois que vous avez construit votre Placeholder utilisez l'élément sdk.helper pour ajouter l'espace réservé à votre signature à votre modèle et passez l'objet templateId et l'espace réservé comme paramètres. Le code suivant permet d'effectuer ce qui suit :
sdk.helper.createRole('E-_tmDsICwCkM2vqFuzVxF7NVQQ=', placeholder1);
Mise à jour d'un espace réservé à la signature
Pour mettre à jour un espace de signature existant, utilisez le code suivant :
sdk.helper.updateRole('E-_tmDsICwCkM2vqFuzVxF7NVQQ=','Manager', placeholder1);
Suppression d'un espace réservé à la signature
Enfin, la suppression d'un espace réservé à la signature se fait également à l'aide de la commande sdk.helper. Vous devrez passer l'objet templateId et l'espace réservé id String comme paramètres.
sdk.helper.deleteRole('E-_tmDsICwCkM2vqFuzVxF7NVQQ=','Manager');