Zum Inhalt springen

Square Create-Aktivität im Jitterbit Studio

Einführung

Eine Square Create-Aktivität erstellt neue Kunden in einer Square-Verbindung und ist dazu gedacht, als Ziel verwendet zu werden, um Daten in einem Vorgang zu konsumieren. Nach der Konfiguration einer Square-Verbindung können Sie so viele Square-Aktivitäten konfigurieren, wie Sie möchten, für jede Square-Verbindung.

Erstellen einer Square-Aktivität

Eine Instanz einer Aktivität wird aus einer Verbindung unter Verwendung eines Aktivitätstyps erstellt.

Um eine Instanz einer Aktivität zu erstellen, ziehen Sie den Aktivitätstyp auf die Entwurfsfläche oder kopieren Sie den Aktivitätstyp und fügen Sie ihn auf der Entwurfsfläche ein. Für weitere Details siehe Erstellen einer Aktivitäts- oder Toolinstanz in Komponentenwiederverwendung.

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

Konfigurieren einer Square Create-Aktivität

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

Schritt 1: Geben Sie einen Namen ein und spezifizieren Sie die Einstellungen

  • Endpoint-Menü: Wenn Sie mehrere Endpunkte desselben Verbindungstyps konfiguriert haben, zeigt ein Menü oben auf dem Bildschirm den aktuellen Endpunktnamen an. Klicken Sie auf das Menü, um zu einem anderen Endpunkt zu wechseln. Weitere Informationen finden Sie unter Ändern des zugewiesenen Endpunkts in Konfigurationsbildschirme.

    • Endpoint bearbeiten: Erscheint, wenn Sie über den aktuellen Endpunktnamen fahren. Klicken Sie, um die Verbindungs-Konfiguration des aktuell ausgewählten Endpunkts zu bearbeiten.

  • Name: Geben Sie einen Namen ein, um die Square Create-Aktivität zu identifizieren. Der Name muss für jede Create-Aktivität einzigartig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten.

  • Bei Fehler fortfahren: Wählen Sie diese Option, um die Ausführung der Aktivität fortzusetzen, wenn ein Fehler für einen Datensatz in einer Batch-Anfrage auftritt. Wenn Fehler auftreten, werden diese im Betriebsprotokoll aufgezeichnet.

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

  • Weiter: Klicken Sie, um die Konfiguration für diesen Schritt vorübergehend zu speichern und zum nächsten Schritt fortzufahren. Die Konfiguration wird nicht gespeichert, bis Sie die Schaltfläche Fertig im letzten Schritt klicken.

  • Änderungen verwerfen: Nach Änderungen klicken Sie auf Änderungen verwerfen, um die Konfiguration zu schließen, ohne die vorgenommenen Änderungen zu speichern. Eine Nachricht wird Sie auffordern, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Schritt 2: Überprüfen der Datenschemas

  • Datenschema: Die Anfrage- und Antwortdatenschemas für Square werden angezeigt. Wenn die Operation eine Transformation verwendet, werden die Datenschemas später während des Transformations-Mapping-Prozesses erneut angezeigt, wo Sie Ziel-Felder mithilfe von Quellobjekten, Skripten, Variablen, benutzerdefinierten Werten und mehr zuordnen können.

    Der Square-Connector verwendet die Square REST API. Weitere Informationen zu den Schemafeldern finden Sie in der API-Dokumentation.

    • Anfrage:

      Anfrage-Schemafeld/-Knoten Hinweise
      customer Knoten des Kunden
      givenName Der Vorname des Kunden
      familyName Der Nachname des Kunden
      companyName Das Unternehmen des Kunden
      nickname Der Spitzname des Kunden
      emailAddress Die Email-Adresse des Kunden
      phoneNumber Die Telefonnummer des Kunden
      referenceID Die Referenz-ID des Kunden
      note Eine Notiz zum Kunden
      birthday Der Geburtstag des Kunden
      address Knoten der Adresse

    • Antwort:

      Antwort-Schema Feld/Knoten Hinweise
      kunde Knoten des Kunden
      isCreated Ob der Kundenrecord erstellt wurde (true) oder nicht erstellt wurde (false)
      nachricht Nachricht von der Erstellungsaktivität
      kundenId Kunden-ID
      einstellungen Knoten der Einstellungen
      email_unsubscribed Zurückgegebener boolescher Wert des Status der Abmeldung von Emails (true oder false)

  • Aktualisieren: Klicken Sie auf das Aktualisierungssymbol oder das Wort Aktualisieren, um die Schemata vom Endpunkt neu zu generieren. Diese Aktion regeneriert auch das Schema an anderen Stellen im Projekt, wo dasselbe Schema referenziert wird, wie in einer benachbarten Transformation.

  • Zurück: Klicken Sie, 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: Nach Änderungen klicken Sie auf Änderungen verwerfen, um die Konfiguration zu schließen, ohne Änderungen an einem Schritt zu speichern. Eine Nachricht wird Sie auffordern, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Nächste Schritte

Nachdem Sie eine Square Create-Aktivität konfiguriert haben, vervollständigen Sie die Konfiguration der Operation, indem Sie weitere Aktivitäten oder Werkzeuge als Operation Schritte hinzufügen und konfigurieren. Sie können auch die Betriebseinstellungen einer Operation konfigurieren, die die Möglichkeit umfassen, Operationen zusammenzuführen, die sich in denselben oder unterschiedlichen Workflows befinden.

Nachdem eine Square-Aktivität erstellt wurde, sind die Menüaktionen für diese Aktivität im Projektbereich entweder in den Tabs Workflows oder Komponenten sowie auf der Entwurfscanvas zugänglich. Siehe Aktionsmenü der Aktivität für Details.

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

Andere Muster sind bei der Verwendung von Square Create-Aktivitäten nicht gültig. Siehe die Validierungsmuster auf der Seite zur Betriebsvalidität.

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

Wenn Sie bereit sind, implementieren und führen Sie den Betrieb aus und validieren Sie das Verhalten, indem Sie die Betriebsprotokolle überprüfen.