Récupération de l’état de la signature

Pour télécharger l’exemple de code complet, consultez notre site Code Share .

Une fois qu’une transaction a été créée, vous pouvez récupérer le statut de signature de cette transaction ou d’un signataire particulier.

Il est fortement recommandé d’utiliser un Callback Listener au lieu d’interroger les statuts des transactions. L’utilisation de l’interrogation peut consommer des ressources inutiles de votre côté et du service OneSpan Sign.

Les transactions OneSpan Sign suivent un cycle de vie prédéfini, défini par les états de cycle de vie suivants :

• Brouillon : La transaction n’a pas encore été envoyée.

• En cours : La transaction a été distribuée pour signatures, mais n’est pas encore terminée.

• Terminée : La transaction a été signée par tous les destinataires.

• Désabonnement : Au moins un destinataire de la transaction a choisi de ne pas signer la transaction par voie électronique. Remarque : L’option de désinscription a été supprimée de l’expérience du signataire.

• Refusée : la transaction a au moins un destinataire qui a refusé de signer la transaction.

• Expirée : La transaction a expiré (c’est-à-dire que sa date d’expiration est passée).

• Archivé : La transaction a été archivée.

Le diagramme suivant décrit le flux normal d’une transaction. En outre, inclus dans ce diagramme ou deux actions possibles que vous pouvez effectuer au cours de ce processus de cycle de vie.

• Action Corbeille : L’action Corbeille est utilisée pour déplacer une transaction sélectionnée vers le dossier Corbeille . Les transactions dans le dossier corbeille ne sont pas automatiquement supprimées, sauf si une politique de rétention spécifique est définie pour ce compte. Les transactions qui sont supprimées manuellement de ce dossier sont récupérables pendant deux semaines après la suppression. Pour récupérer ces transactions, vous devez contacter notre équipe d’assistance.

• Action de suppression : votre package sera définitivement supprimé et ne pourra pas être rétabli.

  

La première étape consiste à créer votre objet PackageId . Pour ce faire, le code suivant :

 PackageId packageId = new PackageId("XB4m3cocNudSPEAoUDCIZgbkZD4="); 

Ensuite, vous utilisez le client OneSpan Sign pour interroger l’état de la transaction et d’un signataire. Pour ce faire, le code suivant :

 com.silanis.esl.sdk.SigningStatus pkgStatus =
    eslClient.getSigningStatus(packageId, null, null);
com.silanis.esl.sdk.SigningStatus signerStatus1 =
    eslClient.getSigningStatus(packageId, new SignerId(signerId1), null);

Résultats

Une fois que vous avez récupéré l’état de signature, faites un System.out.println() de chaque objet SigningStatus .

Voici un exemple de ce que vous pouvez vous attendre à voir une fois que vous avez exécuté votre code.

Pour télécharger l’exemple de code complet, consultez notre site Code Share .

Une fois qu’une transaction a été créée, vous pouvez récupérer le statut de signature de cette transaction ou d’un signataire particulier.

Il est fortement recommandé d’utiliser un Callback Listener au lieu d’interroger les statuts des transactions. L’utilisation de l’interrogation peut consommer des ressources inutiles de votre côté et du service OneSpan Sign.

Les transactions OneSpan Sign suivent un cycle de vie prédéfini, défini par les états de cycle de vie suivants :

• Brouillon : La transaction n’a pas encore été envoyée.

• En cours : La transaction a été distribuée pour signatures, mais n’est pas encore terminée.

• Terminée : La transaction a été signée par tous les destinataires.

• Désabonnement : Au moins un destinataire de la transaction a choisi de ne pas signer la transaction par voie électronique. Remarque : L’option de désinscription a été supprimée de l’expérience du signataire.

• Refusée : la transaction a au moins un destinataire qui a refusé de signer la transaction.

• Expirée : La transaction a expiré (c’est-à-dire que sa date d’expiration est passée).

• Archivé : La transaction a été archivée.

Le diagramme suivant décrit le flux normal d’une transaction. En outre, inclus dans ce diagramme ou deux actions possibles que vous pouvez effectuer au cours de ce processus de cycle de vie.

• Action Corbeille : L’action Corbeille est utilisée pour déplacer une transaction sélectionnée vers le dossier Corbeille . Les transactions dans le dossier corbeille ne sont pas automatiquement supprimées, sauf si une politique de rétention spécifique est définie pour ce compte. Les transactions qui sont supprimées manuellement de ce dossier sont récupérables pendant deux semaines après la suppression. Pour récupérer ces transactions, vous devez contacter notre équipe d’assistance.

• Action de suppression : votre package sera définitivement supprimé et ne pourra pas être rétabli.

  

La première étape consiste à créer votre objet PackageId . Pour ce faire, le code suivant :

 PackageId packageId = new PackageId("XB4m3cocNudSPEAoUDCIZgbkZD4="); 

Ensuite, vous utilisez le client OneSpan Sign pour interroger l’état de la transaction et d’un signataire. Pour ce faire, le code suivant :

 Silanis.ESL.SDK.SigningStatus signerStatus1 =
    eslClient.GetSigningStatus(packageId, signerId1, null);
Silanis.ESL.SDK.SigningStatus pkgStatus =
    eslClient.GetSigningStatus(packageId, null, null);

Résultats

Une fois que vous avez récupéré l’état de signature, faites un Debug.WriteLine() de chaque objet SigningStatus .

Voici un exemple de ce que vous pouvez vous attendre à voir une fois que vous avez exécuté votre code.

Pour télécharger l’exemple de code complet, consultez notre site Code Share .

Une fois qu’une transaction a été créée, vous pouvez récupérer le statut de signature de cette transaction ou d’un signataire particulier.

Il est fortement recommandé d’utiliser un Callback Listener au lieu d’interroger les statuts des transactions. L’utilisation de l’interrogation peut consommer des ressources inutiles de votre côté et du service OneSpan Sign.

Les transactions OneSpan Sign suivent un cycle de vie prédéfini, défini par les états de cycle de vie suivants :

• Brouillon : La transaction n’a pas encore été envoyée.

• En cours : La transaction a été distribuée pour signatures, mais n’est pas encore terminée.

• Terminée : La transaction a été signée par tous les destinataires.

• Désabonnement : Au moins un destinataire de la transaction a choisi de ne pas signer la transaction par voie électronique. Remarque : L’option de désinscription a été supprimée de l’expérience du signataire.

• Refusée : la transaction a au moins un destinataire qui a refusé de signer la transaction.

• Expirée : La transaction a expiré (c’est-à-dire que sa date d’expiration est passée).

• Archivé : La transaction a été archivée.

Le diagramme suivant décrit le flux normal d’une transaction. En outre, inclus dans ce diagramme ou deux actions possibles que vous pouvez effectuer au cours de ce processus de cycle de vie.

• Action Corbeille : L’action Corbeille est utilisée pour déplacer une transaction sélectionnée vers le dossier Corbeille . Les transactions dans le dossier corbeille ne sont pas automatiquement supprimées, sauf si une politique de rétention spécifique est définie pour ce compte. Les transactions qui sont supprimées manuellement de ce dossier sont récupérables pendant deux semaines après la suppression. Pour récupérer ces transactions, vous devez contacter notre équipe d’assistance.

• Action de suppression : votre package sera définitivement supprimé et ne pourra pas être rétabli.

  

Pour ce faire, le code suivant :

Requête HTTP

GET /api/packages/{packageId}/signingStatus?signer={signerId}&document={documentId}

En-têtes HTTP

Accept: application/json   
Content-Type: application/json   

Pour une description complète de chaque champ, consultez le tableau Charge utile de la demande ci-dessous.

Charge utile de réponse

 {   "status": "DRAFT"   

Où le packageId vous est renvoyé lors de la création de la transaction. Si vous le souhaitez, vous pouvez ajouter les paramètres signerId et documentId pour récupérer l’état de signature d’un signataire ou d’un document.

Résultats

Voici un exemple de ce que vous pouvez vous attendre à voir une fois que vous avez exécuté votre code.

Pour télécharger l’exemple de code complet, consultez notre site Code Share .

Une fois qu’une transaction a été créée, vous pouvez récupérer le statut de signature de cette transaction ou d’un signataire particulier.

Il est fortement recommandé d’utiliser un Callback Listener au lieu d’interroger les statuts des transactions. L’utilisation de l’interrogation peut consommer des ressources inutiles de votre côté et du service OneSpan Sign.

Les transactions OneSpan Sign suivent un cycle de vie prédéfini, défini par les états de cycle de vie suivants :

• Brouillon : La transaction n’a pas encore été envoyée.

• En cours : La transaction a été distribuée pour signatures, mais n’est pas encore terminée.

• Terminée : La transaction a été signée par tous les destinataires.

• Désabonnement : Au moins un destinataire de la transaction a choisi de ne pas signer la transaction par voie électronique. Remarque : L’option de désinscription a été supprimée de l’expérience du signataire.

• Refusée : la transaction a au moins un destinataire qui a refusé de signer la transaction.

• Expirée : La transaction a expiré (c’est-à-dire que sa date d’expiration est passée).

• Archivé : La transaction a été archivée.

Le diagramme suivant décrit le flux normal d’une transaction. En outre, inclus dans ce diagramme ou deux actions possibles que vous pouvez effectuer au cours de ce processus de cycle de vie.

• Action Corbeille : L’action Corbeille est utilisée pour déplacer une transaction sélectionnée vers le dossier Corbeille . Les transactions dans le dossier corbeille ne sont pas automatiquement supprimées, sauf si une politique de rétention spécifique est définie pour ce compte. Les transactions qui sont supprimées manuellement de ce dossier sont récupérables pendant deux semaines après la suppression. Pour récupérer ces transactions, vous devez contacter notre équipe d’assistance.

• Action de suppression : votre package sera définitivement supprimé et ne pourra pas être rétabli.

  

La fonction suivante vous permet d’interroger un statut :

 public String getSigningStatus(String packageId, String signerId, String documentId) 

Vous pouvez également interroger le statut d’un package ou d’un signataire ou d’un signataire avec un ID de document spécifique. Pour ce faire, le code suivant :

 String pkgStatus = getSigningStatus('_AQlDyjbxVLphMfM0oPG5YuioTU=',null,null);   String signer1Status = getSigningStatus('_AQlDyjbxVLphMfM0oPG5YuioTU=','signer1@example.com',null);   

Résultats

Voici un exemple de ce que vous pouvez vous attendre à voir une fois que vous avez exécuté votre code.