Zum Inhalt springen

Square Update-Aktivität

Einführung

Eine Square Update-Aktivität aktualisiert einen bestehenden Kunden bei einer Square-Verbindung und soll als Ziel verwendet werden um Daten in einer Operation zu verbrauchen. Nachdem Sie eine Square-Verbindung konfiguriert haben, können Sie beliebig viele Square Aktivitäten konfigurieren wie Sie möchten für jede Square-Verbindung.

Erstellen einer Square Aktivität

Aus einer Verbindung wird mithilfe eines Aktivitätstyps eine Instanz einer Aktivität erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Design-Canvas oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Design-Canvas ein. Weitere Informationen finden Sie unter Erstellen einer Aktivitätsinstanz in Komponentenwiederverwendung.

Eine vorhandene Aktivität kann von diesen Orten aus bearbeitet werden:

Konfigurieren einer Square Update-Aktivität

Befolgen Sie diese Schritte, um eine Square Update-Aktivität zu konfigurieren:

Schritt 1: Namen eingeben und Einstellungen festlegen

Tab „Verbindungen“

  • Name: Geben Sie einen Namen ein, der zur Identifizierung der Square Update-Aktivität verwendet werden soll. Der Name muss für jede Aktivität eindeutig sein. Update-Aktivität und darf keine Schrägstriche enthalten (/) oder Doppelpunkte (:).

  • Bei Fehler fortfahren: Wählen Sie diese Option aus, um die Aktivitätsausführung fortzusetzen, wenn bei einem Datensatz in einer Charge-Anforderung ein Fehler auftritt. Wenn Fehler auftreten, werden sie in das Operation geschrieben.

  • Speichern und beenden: Wenn aktiviert, klicken Sie hier, um die Konfiguration für diesen Schritt zu speichern und die Aktivitätskonfiguration zu schließen.

  • Weiter: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und mit dem nächsten Schritt fortzufahren. Die Konfiguration wird erst gespeichert, wenn Sie im letzten Schritt auf die Schaltfläche Fertig klicken.

  • Änderungen verwerfen: Nachdem Sie Änderungen vorgenommen haben, klicken Sie auf Änderungen verwerfen, um die Konfiguration zu schließen, ohne die an einem Schritt vorgenommenen Änderungen zu speichern. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Überprüfen der Datenschemata

Tab „Verbindungen“

  • Datenschema: Die Anforderungs- und Antwortdatenschemata für Square werden angezeigt. Wenn der Operation eine Transformation verwendet, werden die Datenschemata später während des Transformation erneut angezeigt, wo Sie mithilfe von Quellobjekten, Scripts, Variablen, benutzerdefinierten Werten und mehr Zielfelder zuordnen können.

    Der Square Konnektor verwendet die Square REST API. Informationen zu den Schema finden Sie in der API Dokumentation.

    • Anfrage:

      Schemafeld/-knoten anfordern Hinweise
      Kunde Knoten des Kunden
      customerID ID des jeweiligen Kunden
      givenName Der Vor- und Nachname des Kunden
      familyName Der Familienname (Nachname) des Kunden
      companyName Das Unternehmen des Kunden
      Spitzname Der Spitzname des Kunden
      emailAddress Die Email Adresse des Kunden
      phoneNumber Die Telefonnummer des Kunden
      referenceID Die Referenz-ID des Kunden
      Hinweis Ein Hinweis zum Kunden
      Geburtstag Der Geburtstag des Kunden

    • Antwort:

      Antwortschemafeld/-knoten Hinweise
      update Knoten des Updates
      isUpdated Ob der Kundendatensatz aktualisiert wurde (true) oder nicht aktualisiert (false)
      Nachricht Nachricht von der Aktivität „Erstellen“
      Kunde Knoten des Kunden
      givenName Der Vor- und Nachname des Kunden
      familyName Der Familienname (Nachname) des Kunden
      companyName Das Unternehmen des Kunden
      Spitzname Der Spitzname des Kunden
      emailAddress Die Email Adresse des Kunden
      phoneNumber Die Telefonnummer des Kunden

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um Schemas vom Endpoint neu generieren. Diese Aktion generiert das Schema auch an anderen Stellen im gesamten das Projekt, in dem auf dasselbe Schema verwiesen wird, beispielsweise in einer angrenzenden Transformation.

  • Zurück: Klicken Sie hier, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum vorherigen Schritt zurückzukehren.

  • Fertig: Klicken Sie, um die Konfiguration für alle Schritte zu speichern und die Aktivitätskonfiguration zu schließen.

  • Änderungen verwerfen Klicken Sie nach dem Vornehmen von Änderungen auf Änderungen verwerfen, um die Konfiguration ohne Speichern zu schließen. Änderungen an einem beliebigen Schritt. Sie werden in einer Meldung aufgefordert, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Square Update-Aktivität konfiguriert haben, schließen Sie die Konfiguration der Operation ab, indem Sie Folgendes hinzufügen und konfigurieren: andere Aktivitäten, Transformations oder Scripts als Operation. Sie können auch die Operation einer Operation konfigurieren Einstellungen, darunter die Möglichkeit, Vorgänge im gleichen oder in unterschiedlichen Workflows miteinander zu verketten.

Nachdem eine Square Aktivität erstellt wurde, sind Menüaktionen für diese Aktivität zugänglich aus dem Projektbereich entweder auf den Registerkarten Workflows oder Komponenten und aus der Design-Canvas. Siehe Aktionsmenü für weitere Einzelheiten.

Square Update-Aktivitäten können als Ziel mit diesen Operation verwendet werden: - Transformation - Zwei-Transformationsmuster (als erstes oder zweites Ziel)

Andere Muster sind bei Verwendung von Square Update-Aktivitäten nicht gültig. Siehe die Validierungsmuster auf der Gültigkeit der Operation Seite.

Um die Aktivität mit Skriptfunktionen zu verwenden, schreiben Sie die Daten an einen temporären Speicherort und verwenden Sie dann diesen temporären Speicherort. Speicherort in der Skriptfunktion.

Wenn Sie bereit sind, führen Sie den Operation aus und validieren Sie das Verhalten, indem Sie die Operation prüfen.