Τροποποίηση και Διαχείριση Δεδομένων

Συγχαρητήρια! Έχετε ρυθμίσει μια ασφαλή σύνδεση και λάβατε πληροφορίες από την πλατφόρμα. Στα επόμενα βήματα θα αναλάβουμε μια πιο σύνθετη εργασία και θα αναλύσουμε πώς να την εκτελέσουμε.

Ενημέρωση Παραλήπτη

Ας υποθέσουμε ότι έχουμε στείλει πολλά έγγραφα για υπογραφή από πελάτες. Κατά καιρούς ένα έγγραφο επιστρέφει από το παλιό email ενός υπαλλήλου ή ο πελάτης μας ενημερώνει ότι άλλος είναι ο υπογράφων. Πρέπει να ενημερώσουμε τον παραλήπτη — μπορούμε να δημιουργήσουμε ένα εργαλείο γι’ αυτό;

Θα χρειαστούμε αυτά τα ορίσματα:

• το αναγνωριστικό εγγράφου (ένα κλειδί σε μορφή base64)
• το παλιό email παραλήπτη
• το νέο email χρήστη
• το νέο όνομα χρήστη
• το νέο επώνυμο χρήστη

Εύρεση Αναγνωριστικού Παραλήπτη

Εάν ο χρήστης δώσει ένα documentId θα αναζητήσουμε τον παραλήπτη με βάση τη διεύθυνση email.

Λήψη Παραληπτών για Έγγραφο

Ένας εύκολος τρόπος να πάρετε ένα δείγμα documentId από το Console είναι να μεταβείτε στη σελίδα Λεπτομερειών Εγγράφου. Πάρτε το αναγνωριστικό εγγράφου από τη διεύθυνση URL μετά το /details/.

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

Δοκιμάστε ερωτήματα στον GraphiQL Explorer πριν γράψετε κώδικα. Εάν εκτελέσετε το παραπάνω με μη έγκυρο ID, θα λάβετε προειδοποίηση NOSUCHID:

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

Με έγκυρο ID θα δείτε τους παραλήπτες:

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

πληροφορίες

Οι περισσότερες υπηρεσίες email επιτρέπουν το +x μετά το όνομά σας στη διεύθυνση email. Μπορείτε να το χρησιμοποιήσετε για να δοκιμάσετε πολλούς παραλήπτες όπου το Πρότυπο απαιτεί διαφορετικά άτομα με διαφορετικές διευθύνσεις email.