Zu Hauptinhalt springen Zu ergänzendem Inhalt springen

Aktualisieren von Kampagnen mithilfe der API

Sie können eine Kampagne mit den gewünschten Änderungen aktualisieren. Bearbeiten können Sie nur die Bezeichnung oder die Teilnehmer.

In diesem Beispiel wird Talend API Tester zum Senden von Requests verwendet.

Weitere Informationen zu Talend API Tester finden Sie im Nutzungshandbuch für Talend Cloud API Tester.

Prozedur

  1. Sofern Sie noch nicht über ein persönliches Zugriffstoken verfügen, erzeugen Sie eines. Weitere Informationen finden Sie unter „Generieren persönlicher Zugriffstoken“.
  2. Öffnen Sie Talend API Tester in Ihrem Browser.
  3. Wählen Sie auf der Registerkarte Repository die Methode Put in der Dropdown-Liste Method (Methode) aus.
  4. Geben Sie folgende URL ein: https://tds.{region}.cloud.talend.com/data-stewardship/api/v1/campaigns/owned

    Eine Liste der für die verschiedenen Rechenzentren zu verwendenden URLs finden Sie unter Zugriff auf Talend Cloud-Anwendungen.

  5. Klicken Sie auf die Schaltfläche Add header (Header hinzufügen) und geben Sie Authorization (Autorisierung) in das Feld name (Name) und Bearer, gefolgt von einem Leerzeichen und Ihrem Token in das Feld value (Wert) ein.
  6. Klicken Sie auf die Schaltfläche Add header (Header hinzufügen), geben Sie Cookie in das Feld name (Name) ein und lassen Sie das Feld value (Wert) leer.
  7. Nehmen Sie in das Feld Body den Inhalt der zur Erstellung der Kampagne verwendeten Operation POST https://tds.{region}.cloud.talend.com/data-stewardship/api/v1/campaigns/owned mit den gewünschten Änderungen auf.

    Example

    Um den Data Steward steward2@account.com für den neuen Workflow-Schritt New (Neu) hinzuzufügen, fügen Sie ihn zum Wert Supervisor im Objekt participants (Teilnehmer) hinzu:
    {
        "campaign": {
            "name": "my-campaign-resolution-created-via-api",
            "label": "Improve product catalog data quality (created via API)",
            "description": "Increase the level of data quality for each product catalog.",
            "owners": ["owner@account.com"],
            "taskType": "RESOLUTION",
            "schemaRef": {
                "namespace": "org.talend.schema",
                "name": "my_products_created_via_API",
                "version": 1,
                "displayName": "Product (created via API)"
            },
            "taskResolutionDelay": {
                "value": 10,
                "unit": "DAYS"
            },
            "workflow": {
                "name": "default workflow",
                "states": [{
                    "name": "New",
                    "label": "New",
                    "transitions": [{
                        "name": "To validate",
                        "label": "To validate",
                        "targetStateName": "To validate",
                        "allowedRoles": ["Supervisor"]
                    }],
                    "allowedRoles": [],
                    "translations": {}
                }, {
                    "name": "To validate",
                    "label": "To validate",
                    "transitions": [{
                        "name": "Accept",
                        "label": "Accept",
                        "targetStateName": "Resolved",
                        "allowedRoles": ["Validator"]
                    }, {
                        "name": "Reject",
                        "label": "Reject",
                        "targetStateName": "New",
                        "allowedRoles": ["Validator"]
                    }],
                    "allowedRoles": [],
                    "translations": {}
                }, {
                    "name": "Resolved",
                    "label": "Resolved",
                    "transitions": [],
                    "allowedRoles": ["Validator"],
                    "translations": {}
                }]
            }
        },
        "participants": {
            "Supervisor": ["steward1@account.com", "steward2@account.com"],
            "Validator": ["steward1@account.com"]
        }
    }
  8. Klicken Sie auf Send (Senden).

Ergebnisse

Die API gibt den HTTP-Code 200 zurück, um Sie darüber zu informieren, dass der Request erfolgreich war. Die Antwort enthält eine aktualisierte JSON-Beschreibung der Kampagne.

Hat diese Seite Ihnen geholfen?

Wenn Sie ein Problem mit dieser Seite oder ihrem Inhalt feststellen, sei es ein Tippfehler, ein ausgelassener Schritt oder ein technischer Fehler, informieren Sie uns bitte!