Modificare e Gestire i Dati

Congratulazioni! Hai configurato una connessione sicura e ottenuto informazioni dalla piattaforma. Nei passaggi successivi affronteremo un compito più complesso e ne analizzeremo le modalità di esecuzione.

Aggiornare un Destinatario

Supponiamo di aver inviato molti documenti da firmare ai clienti. Occasionalmente un documento viene rimbalzato dall'indirizzo email di un ex dipendente o il cliente ci comunica che il firmatario è un'altra persona. Dobbiamo aggiornare il destinatario — possiamo creare uno strumento per questo?

Avremo bisogno di questi argomenti:

• l'id del documento (una chiave stringa base64)
• l'email del destinatario precedente
• l'email del nuovo utente
• il nome del nuovo utente
• il cognome del nuovo utente

Trovare l'ID del Destinatario

Se l'utente passa un documentId cercheremo il destinatario tramite l'indirizzo email.

Ottenere i Destinatari per un Documento

Un modo semplice per ottenere un esempio di documentId dalla Console è andare alla pagina Dettagli Documento. Prendi l'id del documento dall'URL dopo /details/.

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

Prova le query nel GraphiQL Explorer prima di scrivere codice. Se esegui quanto sopra con un ID non valido otterrai un avviso NOSUCHID:

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

Con un ID valido vedrai i destinatari:

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

informazioni

La maggior parte dei server email consente il +x dopo il tuo nome nell'indirizzo email. Puoi usarlo per testare più destinatari quando il Modello richiede persone diverse con indirizzi email differenti.