Modifier et gérer les données

Félicitations ! Vous avez configuré une connexion sécurisée et reçu des informations de la plateforme. Dans les étapes suivantes, nous allons aborder une tâche plus complexe et expliquer comment la réaliser.

Mettre à jour un destinataire

Supposons que nous ayons envoyé de nombreux documents à signer par des clients. Parfois, un document rebondit sur l'adresse e-mail d'un ancien employé ou le client nous indique qu'une autre personne est le signataire. Nous devons mettre à jour le destinataire — pouvons-nous créer un outil pour cela ?

Nous aurons besoin de ces arguments :

• l'id du document (une clé chaîne base64)
• l'ancien e-mail du destinataire
• le nouvel e-mail de l'utilisateur
• le prénom du nouvel utilisateur
• le nom de famille du nouvel utilisateur

Trouver l'ID du destinataire

Si l'utilisateur fournit un documentId, nous rechercherons le destinataire par adresse e-mail.

Obtenir les destinataires d'un document

Un moyen simple d'obtenir un documentId d'exemple depuis la Console est d'aller à la page Détails du document. Récupérez l'id du document depuis l'URL après /details/.

{
  document(id: "ZG9jMWVmMjdkYWYtMGJlMS0xMWYwLWJiDVCXMDZlNDc2YTA3NTY5") {
    id
    recipients {
      id
      email
      firstName
      lastName
    }
  }
}

Testez les requêtes dans le GraphiQL Explorer avant d'écrire du code. Si vous exécutez la commande ci-dessus avec un ID invalide, vous obtiendrez un avertissement NOSUCHID :

{
  "data": {
    "document": null
  },
  "errors": [
    {
      "errorType": "WARNING",
      "message": "NOSUCHID"
    }
  ]
}

Avec un ID valide, vous verrez les destinataires :

{
  "data": {
    "document": {
      "id": "ZG9jMWVmMjdkYWYtMGJlMS0xMWYwLWJiYjUtMDZlNDc2YTA3NTY5",
      "recipients": [
        {
          "id": "cmVjMjEwMzE4MjUtMGJlMS0xMWYwLWJiYjUtMDZlNDc2YTA3NTY5",
          "email": "<recipient-email>",
          "firstName": "Alex",
          "lastName": "Test"
        }
      ]
    }
  }
}

info

La plupart des serveurs de messagerie acceptent le +x après votre nom dans l'adresse e-mail. Vous pouvez utiliser cela pour tester plusieurs destinataires lorsque le modèle nécessite différentes personnes avec différentes adresses e-mail.