Zum Inhalt springen

SendGrid-Connector für Jitterbit Studio

Zusammenfassung

Der SendGrid-Connector ermöglicht den Zugriff auf SendGrid.

Der SendGrid-Connector bietet eine Schnittstelle zur Erstellung einer SendGrid-Verbindung, die als Grundlage für die Generierung von Instanzen von SendGrid-Aktivitäten dient. Diese Aktivitäten interagieren, sobald sie konfiguriert sind, über die Verbindung mit SendGrid.

Der SendGrid-Connector wird über die Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette aufgerufen (siehe Designkomponentenpalette).

Übersicht über den Connector

Dieser Connector wird zunächst verwendet, um eine SendGrid-Verbindung zu konfigurieren. Die mit dieser Verbindung verbundenen Aktivitätstypen werden dann verwendet, um Instanzen von Aktivitäten zu erstellen, die als Quellen (um Daten in einem Vorgang bereitzustellen) oder Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden sollen.

Zusammen werden eine spezifische SendGrid-Verbindung und ihre Aktivitäten als SendGrid-Endpunkt bezeichnet:

SendGrid-Aktivitätstypen

  • Read: Ruft Objektdaten (über die id des ausgewählten Objekts) von SendGrid ab und ist als Quelle in einem Vorgang vorgesehen.

  • Query: Abfragt die angegebenen Kontaktdaten der Marketingkampagne in SendGrid unter Verwendung von SendGrids Segmentation Query Language und ist als Quelle in einem Vorgang vorgesehen.

  • Upsert: Aktualisiert vorhandene Kontaktdaten oder erstellt neue Kontaktdaten für eine Marketingkampagne in SendGrid und ist als Ziel in einem Vorgang vorgesehen.

  • Create: Erstellt Objektdaten in SendGrid und ist als Ziel in einem Vorgang vorgesehen.

  • Update: Aktualisiert Objektdaten in SendGrid und ist als Ziel in einem Vorgang vorgesehen.

  • Send: Sendet eine Email von SendGrid und ist als Ziel in einem Vorgang vorgesehen.

  • Löschen: Löscht Objektdaten von SendGrid und ist als Ziel in einer Operation vorgesehen.

Hinweis

Dieser Connector ist ein auf dem Connector SDK-basierten Connector, auf den Jitterbit verweisen kann, wenn Änderungen an mit dem Connector SDK erstellten Connectors kommuniziert werden.

Endpunkte, die mit diesem Connector erstellt wurden, sind in Endpunktnutzungsberichten enthalten und zählen zu Ihrer Lizenz.

Fehlersuche

Wenn Sie Probleme mit dem SendGrid-Connector haben, werden die folgenden Schritte zur Fehlersuche empfohlen:

  1. Klicken Sie auf die Schaltfläche Test in der Verbindungskonfiguration, um sicherzustellen, dass die Verbindung erfolgreich ist und die neueste Version des Connectors auf den Agenten heruntergeladen wird (es sei denn, Sie verwenden die Organisationsrichtlinie Auto Connector Update deaktivieren).

  2. Überprüfen Sie die Betriebsprotokolle auf Informationen, die während der Ausführung der Operation geschrieben wurden.

  3. Aktivieren Sie das Debug-Protokoll für die Operation (für Cloud-Agenten oder für private Agenten), um zusätzliche Protokolldateien und Daten zu generieren.

  4. Wenn Sie private Agenten verwenden, können Sie das ausführliche Protokollieren des Connectors für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei Ihres privaten Agenten hinzufügen:

    <logger name="org.jitterbit.connector.verbose.logging.sendgrid" level="DEBUG"/>

    Weitere Informationen zum ausführlichen Protokollieren von Connectors finden Sie unter Ausführliches Protokollieren für Connectors, die Jitterbit-private Agenten verwenden.

  5. Wenn Sie private Agenten verwenden, können Sie die Agentenprotokolle auf weitere Informationen überprüfen.

  6. Für zusätzliche Überlegungen zur Fehlersuche siehe Fehlersuche bei Operationen.

Voraussetzungen und unterstützte API-Versionen

Der SendGrid-Connector erfordert die Verwendung einer Agentenversion 10.1 oder höher. Diese Agentenversionen laden automatisch die neueste Version des Connectors herunter, wenn dies erforderlich ist.

Der SendGrid-Connector verwendet die SendGrid v3 API. Weitere Informationen zu den Schema-Knoten und -Feldern finden Sie in der API-Dokumentation.