Daten ändern und verwalten

Herzlichen Glückwunsch! Sie haben eine sichere Verbindung eingerichtet und Informationen von der Plattform zurückerhalten. In den nächsten Schritten nehmen wir uns eine komplexere Aufgabe vor und erläutern, wie man sie umsetzt.

Empfänger aktualisieren

Angenommen, wir haben viele Dokumente zum Unterschreiben an Kunden verschickt. Gelegentlich kommt ein Dokument wegen einer alten E-Mail-Adresse eines Mitarbeiters zurück oder der Kunde teilt uns mit, dass eine andere Person unterschreibt. Wir müssen den Empfänger aktualisieren – können wir dafür ein Tool erstellen?

Wir benötigen folgende Argumente:

• die Dokument-ID (ein base64-kodierter Schlüssel)
• die alte Empfänger-E-Mail
• die neue Nutzer-E-Mail
• den neuen Vornamen des Nutzers
• den neuen Nachnamen des Nutzers

Empfänger-ID ermitteln

Wenn der Nutzer eine documentId übergibt, suchen wir den Empfänger über die E-Mail-Adresse.

Empfänger für ein Dokument abrufen

Eine einfache Möglichkeit, eine Beispiel-documentId aus der Console zu erhalten, ist die Detailseite des Dokuments aufzurufen. Die Dokument-ID erhalten Sie aus der URL nach /details/.

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

Testen Sie Abfragen im GraphiQL Explorer, bevor Sie Code schreiben. Wenn Sie die obige Abfrage mit einer ungültigen ID ausführen, erhalten Sie eine NOSUCHID-Warnung:

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

Mit einer gültigen ID sehen Sie die Empfänger:

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

Info

Die meisten E-Mail-Server erlauben das +x nach Ihrem Namen in der E-Mail-Adresse. Sie können dies nutzen, um mehrere Empfänger zum Testen zu verwenden, wenn die Vorlage unterschiedliche Personen mit verschiedenen E-Mail-Adressen erfordert.