Senden von PATCHs

Sie können ein Anforderungstool wie Postman verwenden, um sicherzustellen, dass PATCHs wohlgeformt sind, und um die Struktur der Antwort-Nutzdaten zu überprüfen. Weitere Informationen zu Postman finden Sie unter Anforderungen und Antworten.

PATCH mit Postman senden

Prozedur

  1. Starten Sie in Postman eine neue Anforderung, indem Sie auf das + rechts neben der Registerkarte Launchpad klicken.
  2. Geben Sie als Basic Auth-Autorisierung den Benutzer aapplegate und das Kennwort gw an.
  3. Stellen Sie sicher, dass unter der Bezeichnung Untitled Request PATCH ausgewählt ist.
  4. Geben Sie im Feld Enter request URL die URL für den Server und den Endpunkt ein.
    • Um beispielsweise die Aktivität cc:2 auf einer Instanz von ClaimCenter auf Ihrem Computer zu patchen, geben Sie Folgendes ein: http://localhost:8080/cc/rest/common/v1/activities/cc:2
  5. Geben Sie die Anforderungs-Nutzdaten an.
    • Klicken Sie in der ersten Zeile der Registerkarten (die mit Params beginnt) auf Body.
    • Wählen Sie in der Optionsfeldzeile raw aus.
    • Ändern Sie am Ende der Zeile mit den Optionsfeldern den Wert der Dropdown-Liste von Text in JSON.
    • Fügen Sie die Anforderungs-Nutzdaten in das Textfeld unter den Optionsfeldern ein.
  6. Klicken Sie auf Senden. Die Antwort-Nutzdaten werden unterhalb der Anforderung-Nutzdaten angezeigt.

Lernprogramm: PATCH von Aktivitäten

In diesem Lernprogramm wird davon ausgegangen, dass Sie Postman in Ihrer Umgebung mit dem korrekten Beispieldatensatz eingerichtet haben. Weitere Informationen finden Sie unter Lernprogramm: Einrichten Ihrer Postman-Umgebung.

In diesem Tutorial finden Sie eine offene Aktivität aus den Beispieldaten. Anschließend aktualisieren Sie den Betreff und die Priorität der Aktivität.

Schritte des Lernprogramms

  1. Starten Sie in Postman eine neue Anforderung, indem Sie auf das + rechts neben der Registerkarte Launchpad klicken.
  2. Geben Sie als Basic Auth-Autorisierung den Benutzer aapplegate und das Kennwort gw an.
  3. Fragen Sie alle offenen Aktivitäten ab, indem Sie den folgenden Aufruf eingeben und auf Senden klicken:
    1. GET http://localhost:8080/cc/rest/common/v1/activities?filter=status:eq:open
  4. Beachten Sie für die erste Aktivität in den Antwort-Nutzdaten, die Andy/Alice Applegate zugewiesen ist, die folgenden Informationen:
    1. Aktivitäten-ID
    2. Priorität
    3. Betreff
  5. Geben Sie auf derselben Registerkarte den folgenden Aufruf ein, klicken Sie aber noch nicht auf Senden:
    1. PATCH http://localhost:8080/cc/rest/common/v1/activities/<activityID>
  6. Geben Sie die Anforderungs-Nutzdaten an.
    1. Klicken Sie in der ersten Zeile der Registerkarten (die mit Params beginnt) auf Body.
    2. Wählen Sie in der Optionsfeldzeile raw aus.
    3. Ändern Sie am Ende der Zeile mit den Optionsfeldern den Wert der Dropdown-Liste von Text in JSON.
    4. Kopieren Sie Folgendes in das Textfeld unter den Optionsfeldern. Geben Sie als Betreff den ursprünglichen Betreff mit einem zusätzlichen "!" an.
      {
  "data": {
    "attributes": {
      "subject" : "<originalSubject>!",
      "priority": {
        "code": "low"
        }
    }
  }
}
  7. Klicken Sie auf Senden. Die Antwort-Nutzdaten werden unterhalb der Anforderung-Nutzdaten angezeigt.

Ihre Arbeit überprüfen

  1. Anzeigen der geänderten Aktivität in ClaimCenter.
    1. Melden Sie sich bei ClaimCenter als Benutzer aapplegate an. Andys Zielseite ist das Fenster Activities, in dem die ihm zugewiesenen offenen Aktivitäten angezeigt werden.
    2. Klicken Sie auf die Spalte Priority um die Aktivitäten in umgekehrter Reihenfolge zu sortieren.

Die gepatchte Aktivität (deren Priorität jetzt "Niedrig" ist) sollte sich an oder in der Nähe des Listenrangs befinden. Die gepatchte Aktivität hat einen Betreff, der mit einem "!" endet.