---
title: "Gestion des Placeholders de Signature"
slug: "managing-signature-placeholders"
updated: 2026-11-02T14:26:18Z
published: 2026-11-02T14:26:18Z
canonical: "docs.onespan.com/managing-signature-placeholders"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.onespan.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Gestion des Placeholders de Signature

[Java SDK](/v1/docs/fr/managing-signature-placeholders#java-sdk) [.NET SDK](/v1/docs/fr/managing-signature-placeholders#net-sdk) [REST API](/v1/docs/fr/managing-signature-placeholders#rest-api) [APEX SDK](/v1/docs/fr/managing-signature-placeholders#apex-sdk)

## Java SDK

Pour télécharger l’exemple complet de code, consultez notre site [de partage de code](https://community.onespan.com/documentation/onespan-sign/codeshare/placeholders-management-java-sdk/) .

Un placeholder de signature est utile si l’identité d’un signataire sera déterminée ultérieurement. Par exemple, lors de la création d’un modèle. Un placeholder peut être attribué à un champ de signature comme si vous assigniez un signataire régulier. Cependant, tous les placeholders doivent être remplacés par de vrais signataires avant que la transaction ne soit distribuée pour la signature. Comme un placeholder de signature n’a pas d’adresse e-mail, il est identifié par un ID.

Vous pouvez attribuer une méthode d’authentification à un substitut. La méthode s’applique partout où le substitut est utilisé, donc chaque transaction construite à partir de celle-ci bénéficie des mêmes vérifications d’identité sans configuration supplémentaire. Les expéditeurs peuvent toujours passer outre la méthode pour un destinataire spécifique lorsque cela est nécessaire. L’authentification par placeholder peut être configurée depuis l’interface web, l’API et les SDK. **REMARQUE :** Pour utiliser les SDK, vous devez [passer à la dernière version disponible](/v1/docs/fr/downloading-sdks#downloading-the-latest-sdk-11-version) . Pour activer cette fonctionnalité, contactez notre [Support Team](https://www.onespan.com/support).

- Envoi en masse : Un nouveau paramètre au niveau des transactions, Imposer l’authentification en envoiement massif, contrôle la manière dont l’authentification provisoire s’applique lors [de l’envoi en masse](/v1/docs/fr/bulk-sending). Pour l’activer, contactez notre [Support Team](https://www.onespan.com/support).
  - Non appliqué (par défaut) : Les détails d’authentification dans le CSV Envoie en masse ont la priorité sur la méthode définie sur le placeholder.
  - Appliqué : La méthode d’authentification dans le CSV doit correspondre à celle définie sur le Placeholder. Si elle ne correspond pas, une erreur apparaît lors du téléchargement du CSV, et vous devez corriger le fichier avant de pouvoir continuer. Les détails d’authentification dans le CSV, tels que les numéros de téléphone ou les valeurs de questions-réponses, sont toujours utilisés.
- Limitations : La vérification d’identité n’est pas prise en charge comme méthode d’authentification provisoire. [Fast Track](/v1/docs/fr/fast-track) ignore l’authentification temporaire. Lorsqu’un modèle est utilisé via Fast Track, l’authentification des destinataires temporaires est réinitialisée à Aucun.

### Ajouter un Marque-Remplaçant de Signature à un Modèle

Pour ajouter un Placeholder signature à un modèle, vous devez d’abord créer l’objet Placeholder . Le code suivant créera un objet Placeholder :

```java
Placeholder placeholder = new Placeholder("Manager");
```

Une fois l’objet Placeholder créé, utilisez le OneSpan Sign Template Service pour ajouter votre Placeholder de signature à votre modèle et passer le TemplateId et le Placeholder comme paramètres. Le code suivant fera cela :

```java
 Placeholder addedPlaceholder = eslClient.getTemplateService().addPlaceholder(templateId, placeholder);
```

### Mise à jour d’un Marque-Place de Signature

Pour mettre à jour un marqueur de signature existant, utilisez le code suivant :

```java
addedPlaceholder.setName("Client");
Placeholder updatedPlaceholder = eslClient.getTemplateService().updatePlaceholder(templateId, addedPlaceholder);
```

### Suppression d’un Marque-Signature

Enfin, la suppression d’un marque-place de signature se fait avec le PackageService. Vous devrez passer l’objet TemplateId et la chaîne Placeholder id String comme paramètres.

```java
eslClient.getPackageService().removeSigner(templateId, addedPlaceholder.getId());
```

## .NET SDK

Pour télécharger l’exemple complet de code, consultez notre site [de partage de code](https://community.onespan.com/documentation/onespan-sign/codeshare/placeholders-management-net-sdk/) .

Un placeholder de signature est utile si l’identité d’un signataire sera déterminée ultérieurement. Par exemple, lors de la création d’un modèle. Un placeholder peut être attribué à un champ de signature comme si vous assigniez un signataire régulier. Cependant, tous les placeholders doivent être remplacés par de vrais signataires avant que la transaction ne soit distribuée pour la signature. Comme un placeholder de signature n’a pas d’adresse e-mail, il est identifié par un ID.

Vous pouvez attribuer une méthode d’authentification à un substitut. La méthode s’applique partout où le substitut est utilisé, donc chaque transaction construite à partir de celle-ci bénéficie des mêmes vérifications d’identité sans configuration supplémentaire. Les expéditeurs peuvent toujours passer outre la méthode pour un destinataire spécifique lorsque cela est nécessaire. L’authentification par placeholder peut être configurée depuis l’interface web, l’API et les SDK. **REMARQUE :** Pour utiliser les SDK, vous devez [passer à la dernière version disponible](/v1/docs/fr/downloading-sdks#downloading-the-latest-sdk-11-version) . Pour activer cette fonctionnalité, contactez notre [Support Team](https://www.onespan.com/support).

- Envoi en masse : Un nouveau paramètre au niveau des transactions, Imposer l’authentification en envoiement massif, contrôle la manière dont l’authentification provisoire s’applique lors [de l’envoi en masse](/v1/docs/fr/bulk-sending). Pour l’activer, contactez notre [Support Team](https://www.onespan.com/support).
  - Non appliqué (par défaut) : Les détails d’authentification dans le CSV Envoie en masse ont la priorité sur la méthode définie sur le placeholder.
  - Appliqué : La méthode d’authentification dans le CSV doit correspondre à celle définie sur le Placeholder. Si elle ne correspond pas, une erreur apparaît lors du téléchargement du CSV, et vous devez corriger le fichier avant de pouvoir continuer. Les détails d’authentification dans le CSV, tels que les numéros de téléphone ou les valeurs de questions-réponses, sont toujours utilisés.
- Limitations : La vérification d’identité n’est pas prise en charge comme méthode d’authentification provisoire. [Fast Track](/v1/docs/fr/fast-track) ignore l’authentification temporaire. Lorsqu’un modèle est utilisé via Fast Track, l’authentification des destinataires temporaires est réinitialisée à Aucun.

### Ajouter un Marque-Remplaçant de Signature à un Modèle

Pour ajouter un Placeholder signature à un modèle, vous devez d’abord créer l’objet Placeholder . Le code suivant créera un objet Placeholder :

```csharp
 Placeholder placeholder = new Placeholder("Manager");
```

Une fois l’objet Placeholder créé, utilisez le OneSpan Sign Template Service pour ajouter votre Placeholder de signature à votre modèle et passer le TemplateId et le Placeholder comme paramètres. Le code suivant fera cela :

```csharp
 Placeholder addedPlaceholder = eslClient.TemplateService.AddPlaceholder(templateId, placeholder);
```

### Mise à jour d’un Marque-Place de Signature

Pour mettre à jour un marqueur de signature existant, utilisez le code suivant :

```csharp
addedPlaceholder.Name = "Client";
Placeholder updatedPlaceholder = eslClient.TemplateService.UpdatePlaceholder(templateId, addedPlaceholder);
```

### Suppression d’un Marque-Signature

Enfin, la suppression d’un marque-place de signature se fait avec le PackageService. Vous devrez passer l’objet TemplateId et la chaîne Placeholder id String comme paramètres.

```csharp
eslClient.PackageService.RemoveSigner(templateId, addedPlaceholder.Id);
```

## REST API

Pour télécharger l’exemple complet de code, consultez notre site [de partage de code](https://community.onespan.com/documentation/onespan-sign/codeshare/placeholders-management-rest-api/) .

Un placeholder de signature est utile si l’identité d’un signataire sera déterminée ultérieurement. Par exemple, lors de la création d’un modèle. Un placeholder peut être attribué à un champ de signature comme si vous assigniez un signataire régulier. Cependant, tous les placeholders doivent être remplacés par de vrais signataires avant que la transaction ne soit distribuée pour la signature. Comme un placeholder de signature n’a pas d’adresse e-mail, il est identifié par un ID.

Vous pouvez attribuer une méthode d’authentification à un substitut. La méthode s’applique partout où le substitut est utilisé, donc chaque transaction construite à partir de celle-ci bénéficie des mêmes vérifications d’identité sans configuration supplémentaire. Les expéditeurs peuvent toujours passer outre la méthode pour un destinataire spécifique lorsque cela est nécessaire. L’authentification par placeholder peut être configurée depuis l’interface web, l’API et les SDK. **REMARQUE :** Pour utiliser les SDK, vous devez [passer à la dernière version disponible](/v1/docs/fr/downloading-sdks#downloading-the-latest-sdk-11-version) . Pour activer cette fonctionnalité, contactez notre [Support Team](https://www.onespan.com/support).

- Envoi en masse : Un nouveau paramètre au niveau des transactions, Imposer l’authentification en envoiement massif, contrôle la manière dont l’authentification provisoire s’applique lors [de l’envoi en masse](/v1/docs/fr/bulk-sending). Pour l’activer, contactez notre [Support Team](https://www.onespan.com/support).
  - Non appliqué (par défaut) : Les détails d’authentification dans le CSV Envoie en masse ont la priorité sur la méthode définie sur le placeholder.
  - Appliqué : La méthode d’authentification dans le CSV doit correspondre à celle définie sur le Placeholder. Si elle ne correspond pas, une erreur apparaît lors du téléchargement du CSV, et vous devez corriger le fichier avant de pouvoir continuer. Les détails d’authentification dans le CSV, tels que les numéros de téléphone ou les valeurs de questions-réponses, sont toujours utilisés.
- Limitations : La vérification d’identité n’est pas prise en charge comme méthode d’authentification provisoire. [Fast Track](/v1/docs/fr/fast-track) ignore l’authentification temporaire. Lorsqu’un modèle est utilisé via Fast Track, l’authentification des destinataires temporaires est réinitialisée à Aucun.

### Ajouter un Espace Réservé à un Modèle

Pour ajouter un lieu de remplacement de signature à un modèle, utilisez le code suivant :

#### Requête HTTP

```http
POST /api/packages/{templateId}/roles
```

#### En-têtes HTTP

```http
Accept: application/json   
Content-Type: application/json   
Authorization: Basic api_key
```

#### Charge utile de demande

```json
 {   "id": "Manager",   "type": "SIGNER",   "index": 0,   "name": "Manager"   }
```

Pour une description complète de chaque champ, voir le tableau des charges utiles de demande ci-dessous.

#### Charge utile de réponse

```json
{
    "id": "Manager",
    "type": "SIGNER",
    "index": 0,
    "name": "Manager"
}
```

### Mise à jour d’un Marque-Place de Signature

La mise à jour d’un Placeholder se fait également de manière similaire. Vous devrez construire le JSON avec les mises à jour que vous souhaitez effectuer :

#### Requête HTTP

```http
PUT /api/packages/{templateId}/roles/[roleId}
```

#### En-têtes HTTP

```http
Accept: application/json   
Content-Type: application/json   
Authorization: Basic api_key
```

#### Charge utile de demande

```http
{
    "id": "Manager",
    "type": "SIGNER",
    "index": 0,
    "name": "Manager"
}
```

#### Charge utile de réponse

```http
{
    "id": "Manager",
    "data": null,
    "emailMessage": null,
    "attachmentRequirements": [],
    "locked": false,
    "reassign": false,
    "specialTypes": [],
    "type": "SIGNER",
    "index": 0,
    "signers": [],
    "name": "Manager"
}
```

### Suppression d’un Marque-Signature

Enfin, pour supprimer un placeholder :

#### Requête HTTP

```http
DELETE /api/packages/{templateId}/roles/{roleId}
```

#### En-têtes HTTP

```http
Accept: application/json   
Content-Type: application/json   
Authorization: Basic api_key
```

### Table des charges utiles de requêtes

| Propriété | Type | Modifiable | Obligatoire | Par défaut | Valeurs d’échantillonnage |
| --- | --- | --- | --- | --- | --- |
| Nom | Corde | Oui | Non | N/D | Entraîneur |
| id | Corde | Oui | Non | N/D | Entraîneur |
| Type | Pignonnier | Oui | Non | SIGNATAIRE | SIGNATAIRE / EXPÉDITEUR |
| Nom | Corde | Oui | Non | N/D | Entraîneur |

## APEX SDK

Pour télécharger l’exemple complet de code, consultez notre site [de partage de code](https://community.onespan.com/documentation/onespan-sign/codeshare/placeholders-management-apex-sdk/) .

Un placeholder de signature est utile si l’identité d’un signataire sera déterminée ultérieurement. Par exemple, lors de la création d’un modèle. Un placeholder peut être attribué à un champ de signature comme si vous assigniez un signataire régulier. Cependant, tous les placeholders doivent être remplacés par de vrais signataires avant que la transaction ne soit distribuée pour la signature. Comme un placeholder de signature n’a pas d’adresse e-mail, il est identifié par un ID.

Vous pouvez attribuer une méthode d’authentification à un substitut. La méthode s’applique partout où le substitut est utilisé, donc chaque transaction construite à partir de celle-ci bénéficie des mêmes vérifications d’identité sans configuration supplémentaire. Les expéditeurs peuvent toujours passer outre la méthode pour un destinataire spécifique lorsque cela est nécessaire. L’authentification par placeholder peut être configurée depuis l’interface web, l’API et les SDK. **REMARQUE :** Pour utiliser les SDK, vous devez [passer à la dernière version disponible](/v1/docs/fr/downloading-sdks#downloading-the-latest-sdk-11-version) . Pour activer cette fonctionnalité, contactez notre [Support Team](https://www.onespan.com/support).

- Envoi en masse : Un nouveau paramètre au niveau des transactions, Imposer l’authentification en envoiement massif, contrôle la manière dont l’authentification provisoire s’applique lors [de l’envoi en masse](/v1/docs/fr/bulk-sending). Pour l’activer, contactez notre [Support Team](https://www.onespan.com/support).
  - Non appliqué (par défaut) : Les détails d’authentification dans le CSV Envoie en masse ont la priorité sur la méthode définie sur le placeholder.
  - Appliqué : La méthode d’authentification dans le CSV doit correspondre à celle définie sur le Placeholder. Si elle ne correspond pas, une erreur apparaît lors du téléchargement du CSV, et vous devez corriger le fichier avant de pouvoir continuer. Les détails d’authentification dans le CSV, tels que les numéros de téléphone ou les valeurs de questions-réponses, sont toujours utilisés.
- Limitations : La vérification d’identité n’est pas prise en charge comme méthode d’authentification provisoire. [Fast Track](/v1/docs/fr/fast-track) ignore l’authentification temporaire. Lorsqu’un modèle est utilisé via Fast Track, l’authentification des destinataires temporaires est réinitialisée à Aucun.

### Ajouter un Marque-Remplaçant de Signature à un Modèle

Pour ajouter un espace réservé dans un modèle, vous devrez d’abord créer votre objet Rôle . Le code suivant fera ceci :

```plaintext
String placeholderId = 'placeholder1';
ESignLiveAPIObjects.Role placeholder1 = new ESignLiveAPIObjects.Role();
placeholder1.id = placeholderId;
placeholder1.name = placeholderId;
```

Une fois que vous avez construit votre objet Placeholder , utilisez le sdk.helper pour ajouter votre place de signature à votre modèle et passer le TemplateId et le placeholder comme paramètres. Le code suivant fera cela :

```plaintext
sdk.helper.createRole('E-_tmDsICwCkM2vqFuzVxF7NVQQ=', placeholder1);
```

### Mise à jour d’un Marque-Place de Signature

Pour mettre à jour un marqueur de signature existant, utilisez le code suivant :

```plaintext
sdk.helper.updateRole('E-_tmDsICwCkM2vqFuzVxF7NVQQ=','Manager', placeholder1);
```

### Suppression d’un Marque-Signature

Enfin, supprimer un marque-repère de signature se fait aussi avec le fichier sdk.helper. Vous devrez passer l’objet TemplateId et la chaîne Placeholder id String comme paramètres.

```plaintext
sdk.helper.deleteRole('E-_tmDsICwCkM2vqFuzVxF7NVQQ=','Manager');
```