SendGrid-Connector in Jitterbit Studio

Zusammenfassung

Der SendGrid-Connector stellt Zugriff auf SendGrid bereit.

Der SendGrid-Connector bietet eine Schnittstelle zum Erstellen einer SendGrid-Verbindung, die Grundlage für die Generierung von SendGrid-Aktivitätsinstanzen. Diese Aktivitäten interagieren nach der Konfiguration mit SendGrid über die Verbindung.

Der SendGrid-Connector wird über die Registerkarte Project endpoints and connectors (Projektendpunkte und Connectoren) der Designkomponentenpalette aufgerufen (siehe Design component palette).

Connector-Übersicht

Dieser Connector wird zunächst zum Konfigurieren einer SendGrid-Verbindung verwendet. Die mit dieser Verbindung verknüpften Aktivitätstypen werden dann verwendet, um Aktivitätsinstanzen zu erstellen, die als Quellen (zur Bereitstellung von Daten in einem Vorgang) oder Ziele (zur Verarbeitung von Daten in einem Vorgang) verwendet werden sollen.

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

• Read: Ruft Objektdaten (nach der id des ausgewählten Objekts) aus SendGrid ab und ist zur Verwendung als Quelle in einem Vorgang vorgesehen.

• Query: Fragt angegebene Marketingkampagnen-Kontaktdaten in SendGrid mit SendGrids Segmentation Query Language ab und ist zur Verwendung als Quelle in einem Vorgang vorgesehen.

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

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

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

• Send: Sendet eine E-Mail von SendGrid und ist zur Verwendung als Ziel in einem Vorgang vorgesehen.

• Delete: Löscht Objektdaten aus SendGrid und ist zur Verwendung als Ziel in einem Vorgang vorgesehen.

Mit diesem Connector erstellte Endpunkte sind in der Endpunktnutzungsberichterstellung enthalten und werden auf die Lizenz angerechnet.

Fehlerbehebung

Bei Problemen mit dem SendGrid-Connector werden diese Schritte zur Fehlerbehebung 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 Agent heruntergeladen wird (sofern nicht die Organisationsrichtlinie Disable Auto Connector Update verwendet wird).

2. Überprüfen Sie die Vorgangsprotokolle auf alle während der Vorgangsausführung geschriebenen Informationen.

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

4. Bei Verwendung privater Agenten können Sie das Connector-Verbose-Logging für diesen Connector aktivieren, indem Sie diesen Logger-Konfigurationseintrag in die logback.xml-Datei des privaten Agenten einfügen:

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

   Weitere Informationen zum Connector-Verbose-Logging finden Sie unter Verbose logging for connectors using Jitterbit private agents.

5. Bei Verwendung privater Agenten können Sie die Agent-Protokolle auf weitere Informationen überprüfen.

6. Weitere Überlegungen zur Fehlerbehebung finden Sie unter Operation troubleshooting.

Voraussetzungen und unterstützte API-Versionen

Dieser Connector kann mit Cloud-Agenten und privaten Agenten verwendet werden.

Agenten laden automatisch die neueste Version dieses Connectors herunter, wenn erforderlich. Bei privaten Agenten können Sie diese Updates mit der Organisationsrichtlinie Disable Auto Connector Update organization policy aussetzen.

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