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.
    • Geben Sie beispielsweise Folgendes ein, um die Aktivität pc:2 auf einer Instanz von PolicyCenter auf Ihrem Computer zu patchen: http://localhost:8180/pc/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:8180/pc/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:8180/pc/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 PolicyCenter.
    1. Melden Sie sich bei PolicyCenter als Benutzer aapplegate an. Klicken Sie in der linken Seitenleiste auf My Activities. PolicyCenter zeigt das Fenster My Activities an, in dem die offenen Aktivitäten angezeigt werden, die Alice zugewiesen sind.
    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.