Details zur Salesforce Pardot-Verbindung

Einführung

Connector-Version

Diese Dokumentation basiert auf Version 21.0.8662 des Connectors.

Erste Schritte

Versionsunterstützung für Salesforce Pardot

Der Connector nutzt die SalesforcePardot-API, um bidirektionalen Zugriff auf SalesforcePardot zu ermöglichen. Unterstützt Pardot API v3 und v4.

Herstellen einer Verbindung

Herstellen einer Verbindung mit Pardot

Herstellen einer Verbindung mit OAuth2

Setzen Sie die AuthScheme Zu OAuth um sich mit dieser Methode zu authentifizieren.

Pardot-Geschäftsbereichs-ID

Um eine Verbindung über OAuth2.0 herzustellen, müssen Sie die BusinessUnitId abrufen.

Um die Pardot-Geschäftseinheit-ID zu finden, verwenden Sie das Setup in Salesforce.

• Geben Sie unter „Setup“ im Feld „Schnellsuche“ „Pardot-Konto-Setup“ ein.

Ihre Pardot Business Unit-ID beginnt mit „0Uv“ und ist 18 Zeichen lang. Wenn Sie nicht auf die Informationen zur Pardot-Kontoeinrichtung zugreifen können, bitten Sie Ihren Salesforce-Administrator, Ihnen die Pardot Business Unit-ID mitzuteilen.

Sie können eine Verbindung herstellen, nachdem Sie die erforderlichen Verbindungseigenschaften für Ihre Benutzeranmeldeinformationen festgelegt und die erforderlichen Zugriffstoken mit einem Tool wie Postman abgerufen haben.

Siehe OAuth-Authentifizierung verwenden für eine Authentifizierungsanleitung und Einzelheiten zum OAuth-Authentifizierungsablauf.

OAuth-Authentifizierung verwenden

OAuth erfordert die Verwendung von Zugriffstoken, die mit Postman oder einem ähnlichen Tool erhalten wurden. Die OAuth-Authentifizierung wird wie in Verbindung beschrieben unterstützt unter OAuth-Verbindungen konfigurieren.

Eingebettete Anmeldeinformationen

Authentifizieren Sie sich mit den eingebetteten OAuth-Anmeldeinformationen

Desktop-Authentifizierung mit der eingebetteten OAuth-App

Sie können eine Verbindung herstellen, ohne Verbindungseigenschaften für Ihre Benutzeranmeldeinformationen festzulegen. Nachdem Sie Folgendes festgelegt haben, können Sie eine Verbindung herstellen:

• InitiateOAuth: Setzen Sie dies auf GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Setzen von zu vermeiden OAuthAccessToken.
• BusinessUnitID: Legen Sie hier Ihre Geschäftseinheits-ID fest.

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen. Der Connector schließt dann den OAuth-Prozess ab.

1. Extrahiert das Zugriffstoken aus der Rückruf URL und authentifiziert Anfragen.
2. Erhält einen neuen Zugriffstoken, wenn der alte abläuft.
3. Speichert OAuth-Werte in OAuthSettingsLocation damit die Werte über mehrere Verbindungen hinweg bestehen bleiben.

Benutzerdefinierte Anmeldeinformationen

In diesem Abschnitt wird die Desktop-Authentifizierung mithilfe der Anmeldeinformationen für Ihre benutzerdefinierte OAuth-App beschrieben. Siehe Erstellen einer benutzerdefinierten OAuth-App für weitere Informationen.

Holen Sie sich ein OAuth-Zugriffstoken

Nachdem Sie Folgendes eingestellt haben, können Sie eine Verbindung herstellen:

• OAuthClientId: Stellen Sie die Client-ID in Ihren App-Einstellungen ein.
• OAuthClientSecret: Stellen Sie das Client-Geheimnis in Ihren App-Einstellungen ein.
• CallbackURL: Stellen Sie die Weiterleitungs URL in Ihren App-Einstellungen ein.
• InitiateOAuth: Auf setzen GETANDREFRESH. Sie können InitiateOAuth verwenden, um die Wiederholung des OAuth-Austauschs und das manuelle Festlegen der zu vermeiden OAuthAccessToken.

Wenn Sie eine Verbindung herstellen, öffnet der Connector den OAuth-Endpoint in Ihrem Standardbrowser. Melden Sie sich an und erteilen Sie der Anwendung Berechtigungen. Der Connector führt dann den folgenden OAuth-Prozess aus:

1. Extrahiert das Zugriffstoken aus der Rückruf URL und authentifiziert Anfragen.
2. Erhält einen neuen Zugriffstoken, wenn der alte abläuft.
3. Speichert OAuth-Werte in OAuthSettingsLocation soll über mehrere Verbindungen hinweg bestehen bleiben.

Authentifizieren mit OAuthJWT-Zertifikatauthentifizierung

Setzen Sie die AuthScheme Zu OAuthJWT.

Nachdem Sie Ihre OAuth-Anwendung erstellt haben, legen Sie die folgenden Verbindungseigenschaften fest:

• AuthScheme: Auf festlegen OAuthJWT.
• InitiateOAuth: Auf setzen GETANDREFRESH.
• OAuthJWTCert: Legen Sie dies auf den JWT-Zertifikatspeicher fest.
• OAuthJWTPassword: Legen Sie dies auf das Passwort des JWT-Zertifikatspeichers fest.
• OAuthJWTIssuer: Legen Sie dies auf die OAuth-Client-ID fest.
• OAuthJWTCertType: Legen Sie dies auf den Typ des von OAuthJWTCert angegebenen Zertifikatspeichers fest.

Kopflose Maschinen

Um Salesforce Pardot Datenquellen auf Headless-Servern oder anderen Computern zu erstellen, auf denen der Connector keinen Browser öffnen kann, müssen Sie sich von einem anderen Computer aus authentifizieren. Die Authentifizierung erfolgt in zwei Schritten.

1. Anstatt den Connector auf einem anderen Computer zu installieren, können Sie die folgenden Schritte ausführen, um den OAuthVerifier-Wert. Oder Sie können den Connector auf einem anderen Computer installieren und die OAuth-Authentifizierungswerte übertragen, nachdem Sie sich über den üblichen browserbasierten Ablauf authentifiziert haben.
2. Anschließend können Sie den Connector so konfigurieren, dass das Zugriffstoken vom Headless-Computer automatisch aktualisiert wird.

Sie können dem Headless-OAuth-Authentifizierungsablauf mit den eingebetteten OAuth-Anmeldeinformationen des Connectors oder mit den OAuth-Anmeldeinformationen für Ihre benutzerdefinierte OAuth-App folgen.

Verwenden der Anmeldeinformationen für eine benutzerdefinierte OAuth-App

Erstellen einer benutzerdefinierten OAuth-App

Siehe Erstellen einer benutzerdefinierten OAuth-App für ein Verfahren. Dieser Abschnitt beschreibt das Verfahren zur Authentifizierung und Verbindung mit Daten.

Erhalten Sie einen Verifier-Code

Legen Sie zunächst die folgenden Eigenschaften auf der Headless-Maschine fest:

• InitiateOAuth: Auf setzen OFF.
• OAuthClientId: Stellen Sie die App-ID in Ihren App-Einstellungen ein.
• OAuthClientSecret: Stellen Sie in Ihren App-Einstellungen das App-Geheimnis ein.

Authentifizieren Sie sich anschließend von einem anderen Computer aus und erhalten Sie das OAuthVerifier Verbindungseigenschaft:

1. Rufen Sie die gespeicherte Prozedur GetOAuthAuthorizationURL auf, wobei der Eingabeparameter CallbackURL auf die genaue Umleitungs-URI eingestellt sein muss, die Sie in Ihren App-Einstellungen angegeben haben.
2. Öffnen Sie die zurückgegebene URL in einem Browser. Melden Sie sich an und erteilen Sie dem Connector Berechtigungen. Sie werden dann zur Callback-URL weitergeleitet, die den Prüfcode enthält.
3. Speichern Sie den Wert des Prüfcodes. Sie müssen diesen in der OAuthVerifier Verbindungseigenschaft.

Legen Sie abschließend auf der Headless-Maschine die folgenden Verbindungseigenschaften fest, um die OAuth-Authentifizierungswerte zu erhalten:

• OAuthClientId: Stellen Sie den Consumer-Schlüssel in Ihren App-Einstellungen ein.
• OAuthClientSecret: Stellen Sie es in Ihren App-Einstellungen auf das Verbrauchergeheimnis ein.
• OAuthVerifier: Auf den Prüfcode setzen.
• OAuthSettingsLocation: Festlegen, um die verschlüsselten OAuth-Authentifizierungswerte in der angegebenen Datei zu speichern.
• InitiateOAuth: Auf setzen REFRESH.

Mit Daten verbinden

Nachdem die OAuth-Einstellungsdatei generiert wurde, legen Sie die folgenden Eigenschaften fest, um eine Verbindung zu Daten herzustellen:

• OAuthSettingsLocation: Auf die Datei mit den verschlüsselten OAuth-Authentifizierungswerten setzen. Stellen Sie sicher, dass diese Datei dem Anbieter Lese- und Schreibberechtigungen erteilt, um die automatische Aktualisierung des Zugriffstokens zu ermöglichen.
• InitiateOAuth: Auf setzen REFRESH.

OAuth-Einstellungen übertragen

Um den Connector auf einem anderen Computer zu installieren, authentifizieren Sie sich und übertragen Sie dann die resultierenden OAuth-Werte:

1. Installieren Sie den Connector auf einem zweiten Computer und stellen Sie eine Verbindung mit den folgenden Eigenschaften her:
   • OAuthSettingsLocation: Auf eine beschreibbare Textdatei einstellen.
   • InitiateOAuth: Auf setzen GETANDREFRESH.
   • OAuthClientId: In Ihren App-Einstellungen auf die Client-ID einstellen.
   • OAuthClientSecret: Stellen Sie es in Ihren App-Einstellungen auf das Client-Geheimnis ein.
   • CallbackURL: Stellen Sie die Rückruf-URL in Ihren App-Einstellungen ein.
2. Testen Sie die Verbindung zur Authentifizierung. Die resultierenden Authentifizierungswerte werden verschlüsselt in den durch angegebenen Pfad geschrieben OAuthSettingsLocation. Nachdem Sie die Verbindung erfolgreich getestet haben, kopieren Sie die OAuth-Einstellungsdatei auf Ihren Headless-Computer. Legen Sie auf dem Headless-Computer die folgenden Verbindungseigenschaften fest, um eine Verbindung zu Daten herzustellen:
   • InitiateOAuth: Auf setzen REFRESH.
   • OAuthSettingsLocation: Legen Sie den Pfad zu Ihrer OAuth-Einstellungsdatei fest. Stellen Sie sicher, dass diese Datei dem Connector Lese- und Schreibberechtigungen erteilt, um die automatische Aktualisierung des Zugriffstokens zu ermöglichen.

Authentifizieren mit OAuthJWT-Zertifikatauthentifizierung

Setzen Sie die AuthScheme Zu OAuthJWT.

Nachdem Sie Ihre OAuth-Anwendung erstellt haben, legen Sie die folgenden Verbindungseigenschaften fest:

• AuthScheme: Auf festlegen OAuthJWT.
• InitiateOAuth: Auf setzen GETANDREFRESH.
• OAuthJWTCert: Legen Sie dies auf den JWT-Zertifikatspeicher fest.
• OAuthJWTPassword: Legen Sie dies auf das Passwort des JWT-Zertifikatspeichers fest.
• OAuthJWTIssuer: Legen Sie dies auf die OAuth-Client-ID fest.
• OAuthJWTCertType: Legen Sie dies auf den Typ des von OAuthJWTCert angegebenen Zertifikatspeichers fest.

Erstellen einer benutzerdefinierten OAuth-App

Wenn Sie keinen Zugriff auf den Benutzernamen und das Kennwort haben oder diese nicht anfordern möchten, können Sie die OAuth-Authentifizierung verwenden. Salesforce Pardot verwendet den OAuth-Authentifizierungsstandard, der erfordert, dass der authentifizierende Benutzer über den Browser mit Salesforce Pardot interagiert. Der Connector erleichtert den OAuth-Austausch auf verschiedene Weise, wie in diesem Abschnitt beschrieben.

Erstellen einer verbundenen App

So erhalten Sie die OAuth-Clientanmeldeinformationen, den Consumer-Schlüssel und das Consumer-Geheimnis:

1. Melden Sie sich bei Salesforce an.
2. Geben Sie im Setup ein Apps im Feld „Schnellsuche“ und klicken Sie dann auf den Link, um eine App zu erstellen. Im Connected Apps Abschnitt der resultierenden Seite, klicken Sie auf New.
3. Geben Sie einen Namen ein, der den Benutzern angezeigt wird, wenn sie sich anmelden, um Ihrer App Berechtigungen zu erteilen, sowie eine Kontakt-Email-Adresse.
4. Klicken Sie auf Enable OAuth Settings und geben Sie einen Wert in das Callback URL-Feld. Wenn Sie eine Desktop-Anwendung erstellen, setzen Sie die Callback-URL auf http://localhost:33333 oder eine andere Port Ihrer Wahl. Wenn Sie eine Webanwendung erstellen, legen Sie die Rückruf-URL auf eine Seite in Ihrer Webanwendung fest, zu der der Benutzer nach der Autorisierung Ihrer Anwendung zurückgeleitet werden soll.
5. Wählen Sie den Umfang der Berechtigungen aus, die Ihre App vom Benutzer anfordern soll. Mindestens die Bereiche „pardot_api“ und „api“ und/oder der Bereich „vollständig“ müssen zu den ausgewählten OAuth-Umfängen gehören. Andernfalls kann nur der OAuth-Flow „Benutzername-Passwort“ mit der Pardot API verwendet werden.
6. Außerdem muss der Bereich „refresh_token“ ausgewählt werden. Durch Hinzufügen dieses Bereichs gibt die API in der OAuth-Anforderung ein Aktualisierungstoken zurück, das vom Treiber verwendet wird, um das Zugriffstoken nach Ablauf automatisch zu aktualisieren.
7. Klicken Sie auf Ihren App-Namen, um eine Seite mit Informationen zu Ihrer App zu öffnen. Die OAuth-Client-Anmeldeinformationen, der Consumer-Schlüssel und das Consumer-Geheimnis werden angezeigt.

Wichtige Hinweise

Konfigurationsdateien und ihre Pfade

• Alle Verweise auf das Hinzufügen von Konfigurationsdateien und deren Pfaden beziehen sich auf Dateien und Speicherorte auf dem Jitterbit-Agenten, auf dem der Connector installiert ist. Diese Pfade sind je nach Agent und Operationssystem entsprechend anzupassen. Wenn mehrere Agenten in einer Agentengruppe verwendet werden, werden auf jedem Agenten identische Dateien benötigt.

Erweiterte Funktionen

In diesem Abschnitt wird eine Auswahl erweiterter Funktionen des Salesforce Pardot-Connectors beschrieben.

Benutzerdefinierte Ansichten

Der Connector ermöglicht Ihnen die Definition virtueller Tabellen, sogenannter benutzerdefinierter Ansichten, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese Ansichten sind nützlich, wenn Sie die an die Treiber gesendeten Abfragen nicht direkt steuern können. Siehe Benutzerdefinierte Ansichten für einen Überblick über das Erstellen und Konfigurieren benutzerdefinierter Ansichten.

SSL-Konfiguration

Verwenden Sie SSL-Konfiguration, um anzupassen, wie der Connector TLS/SSL-Zertifikatsverhandlungen handhabt. Sie können aus verschiedenen Zertifikatsformaten wählen; siehe SSLServerCert-Eigenschaft unter „Verbindungszeichenfolgenoptionen“ für weitere Informationen.

Proxy

So konfigurieren Sie den Connector mit privaten Agent-Proxy-Einstellungen, wählen Sie die Use Proxy Settings Kontrollkästchen auf dem Verbindungskonfigurationsbildschirm.

Benutzerdefinierte Ansichten

Mit dem Salesforce Pardot-Connector können Sie eine virtuelle Tabelle definieren, deren Inhalt durch eine vorkonfigurierte Abfrage bestimmt wird. Diese werden als benutzerdefinierte Ansichten bezeichnet und sind in Situationen nützlich, in denen Sie die an den Treiber gesendete Abfrage nicht direkt steuern können, z. B. wenn Sie den Treiber von Jitterbit verwenden. Die benutzerdefinierten Ansichten können verwendet werden, um Prädikate zu definieren, die immer angewendet werden. Wenn Sie in der Abfrage an die Ansicht zusätzliche Prädikate angeben, werden diese mit der bereits als Teil der Ansicht definierten Abfrage kombiniert.

Es gibt zwei Möglichkeiten, benutzerdefinierte Ansichten zu erstellen:

• Erstellen Sie eine Konfigurationsdatei im JSON-Format, die die gewünschten Ansichten definiert.
• DDL-Anweisungen.

Definieren von Ansichten mithilfe einer Konfigurationsdatei

Benutzerdefinierte Ansichten werden in einer JSON-formatierten Konfigurationsdatei namens UserDefinedViews.json. Der Connector erkennt die in dieser Datei angegebenen Ansichten automatisch.

Sie können auch mehrere Ansichtsdefinitionen haben und diese mit steuern UserDefinedViews Verbindungseigenschaft. Wenn Sie diese Eigenschaft verwenden, werden vom Connector nur die angegebenen Ansichten angezeigt.

Diese Konfigurationsdatei für benutzerdefinierte Ansichten ist wie folgt formatiert:

• Jedes Stammelement definiert den Namen einer Ansicht.
• Jedes Stammelement enthält ein untergeordnetes Element namens query, das die benutzerdefinierte SQL- Abfrage für die Ansicht enthält.

Zum Beispiel:

{
    "MyView": {
        "query": "SELECT * FROM Prospects WHERE MyColumn = 'value'"
    },
    "MyView2": {
        "query": "SELECT * FROM MyTable WHERE Id IN (1,2,3)"
    }
}

Verwenden Sie die UserDefinedViews Verbindungseigenschaft, um den Speicherort Ihrer JSON-Konfigurationsdatei anzugeben. Beispiel:

"UserDefinedViews", "C:\Users\yourusername\Desktop\tmp\UserDefinedViews.json"

Schema für benutzerdefinierte Ansichten

Benutzerdefinierte Ansichten werden im angezeigt UserViews Schema standardmäßig. Dies geschieht, um zu vermeiden, dass der Name der Ansicht mit einer tatsächlichen Entität im Datenmodell kollidiert. Sie können den Namen des für UserViews verwendeten Schema ändern, indem Sie festlegen UserViewsSchemaName Eigentum.

Arbeiten mit benutzerdefinierten Ansichten

Beispielsweise eine SQL-Anweisung mit einer benutzerdefinierten Ansicht namens UserViews.RCustomers listet nur Kunden in Raleigh auf:

SELECT * FROM Customers WHERE City = 'Raleigh';

Ein Beispiel für eine Abfrage an den Treiber:

SELECT * FROM UserViews.RCustomers WHERE Status = 'Active';

Daraus ergibt sich die effektive Abfrage an die Quelle:

SELECT * FROM Customers WHERE City = 'Raleigh' AND Status = 'Active';

Dies ist ein sehr einfaches Beispiel für eine Abfrage an eine benutzerdefinierte Ansicht, die tatsächlich eine Kombination aus der Abfrage und der Ansichtsdefinition ist. Es ist möglich, diese Abfragen in viel komplexeren Mustern zusammenzustellen. Alle SQL-Operationen sind in beiden Abfragen zulässig und werden bei Bedarf kombiniert.

SSL-Konfiguration

Anpassen der SSL-Konfiguration

Standardmäßig versucht der Connector, SSL/TLS auszuhandeln, indem er das Zertifikat des Servers mit dem vertrauenswürdigen Zertifikatspeicher des Systems vergleicht.

Um ein anderes Zertifikat anzugeben, siehe SSLServerCert Eigenschaft für die verfügbaren Formate, um dies zu tun.

Datenmodell

Überblick

In diesem Abschnitt werden die verfügbaren API Objekte angezeigt und weitere Informationen zur Ausführung von SQL für Salesforce Pardot APIs bereitgestellt.

Hauptmerkmale

• Der Connector modelliert Salesforce Pardot Entitäten wie Dokumente, Ordner und Gruppen als relationale Ansichten, sodass Sie SQL schreiben können, um Salesforce Pardot Daten Abfrage.
• Gespeicherte Prozeduren ermöglichen Ihnen die Ausführung von Vorgängen in Salesforce Pardot, einschließlich des Abrufens und Aktualisierens des Zugriffstokens in OAuth 2.0.
• Die Live-Konnektivität zu diesen Objekten bedeutet, dass alle Änderungen an Ihrem Salesforce Pardot-Konto bei Verwendung des Connectors sofort angezeigt werden.

Kollaborative Abfrageverarbeitung

Der Connector verlagert die Verarbeitung der SELECT-Anweisung so weit wie möglich auf Salesforce Pardot und verarbeitet den Rest der Abfrage dann im Speicher. API Einschränkungen und-Anforderungen werden ebenfalls in diesem Abschnitt dokumentiert.

Sehen SupportEnhancedSQL für weitere Informationen dazu, wie der Connector API Einschränkungen durch die clientseitige In-Memory-Verarbeitung umgeht.

Salesforce Pardot V3- und V4-Datenmodell

Der Salesforce Pardot-Konnektor modelliert Salesforce Pardot Entitäten als relationale Tabellen, Ansichten und gespeicherte Prozeduren. API Einschränkungen und-Anforderungen sind in diesem Abschnitt dokumentiert. Sie können die SupportEnhancedSQL Funktion, standardmäßig eingestellt, um die meisten dieser Einschränkungen zu umgehen.

Tabellen

Der Connector modelliert die Daten in Salesforce Pardot in einer Liste von Tabellen, die mit Standard-SQL-Anweisungen abgefragt werden können.

Im Allgemeinen ist das Abfragen von Salesforce Pardot-Tabellen dasselbe wie das Abfragen einer Tabelle in einer relationalen Datenbank. Manchmal gibt es Sonderfälle, beispielsweise kann das Einfügen einer bestimmten Spalte in die WHERE-Klausel erforderlich sein, um Daten für bestimmte Spalten in der Tabelle abzurufen. Dies ist normalerweise in Situationen erforderlich, in denen für jede Zeile eine separate Abfrage erfolgen muss, um bestimmte Spalten abzurufen. Diese Arten von Situationen sind oben auf der unten verlinkten Tabellenseite klar dokumentiert.

Salesforce Pardot Connector-Tabellen

Kampagnen

Kampagnen abrufen und ändern.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• Name unterstützt '='.
• CreatedAt unterstützt '=', '<', '<=', '>', '>='.
• UpdatedAt unterstützt '=', '<', '<=', '>', '>='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Campaigns WHERE Id = 43
SELECT * FROM Campaigns WHERE Name = 'Website Tracking'

Einfügen

Diese Tabelle hat beim Durchführen eines Einfügens keine erforderlichen Attribute.

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Benutzerdefinierte Felder

Benutzerdefinierte Felder abrufen und ändern.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• CreatedAt unterstützt '=', '<', '<=', '>', '>='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM CustomFields WHERE Id = 50
SELECT * FROM CustomFields WHERE CreatedAt > '01/01/2019'

Einfügen

Beim Einfügen sind folgende Attribute erforderlich: FieldId, Name.

INSERT INTO CustomFields(FieldId, Name) VALUES(100, 'Example')

Spalten

ListeMitgliedschaften

Listenmitgliedschaften abrufen und ändern.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• ListId unterstützt '='.
• CreatedAt unterstützt '=', '<', '<=', '>', '>='.
• UpdatedAt unterstützt '=', '<', '<=', '>', '>='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ListMemberships WHERE Id = 26
SELECT * FROM ListMemberships WHERE ListId = 44
SELECT * FROM ListMemberships WHERE CreatedAt > '01/01/2019'

Einfügen

Beim Einfügen sind folgende Attribute erforderlich: ListId, ProspectId.

INSERT INTO ListMemberships(ListId, ProspectId) VALUES(20104, 3457990)

Gelöscht werden

Um gelöschte Datensätze abzurufen, kann eine GETDELETED-Anweisung ausgeführt werden. Die GETDELETED-Anweisung unterstützt dieselben serverseitigen Filter, die von der SELECT-Anweisung unterstützt werden (außer ID bei Verwendung des Gleichheitsoperators (=), führt jedoch keine clientseitige Filterung durch.

GETDELETED FROM ListMemberships WHERE ID = 231

Spalten

Listen

Listen abrufen und ändern.

Spalten

Gelegenheiten

Möglichkeiten abrufen und ändern.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• Probability unterstützt '=', '<', '<=', '>', '>='.
• CreatedAt unterstützt '=', '<', '<=', '>', '>='.
• ProspectEmail unterstützt '='.
• ProspectId unterstützt '='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Opportunities WHERE Id = 14
SELECT * FROM Opportunities WHERE ProspectId = 34
SELECT * FROM Opportunities WHERE ProspectEmail = 'example@exampledomain.com'

Einfügen

Beim Einfügen sind die folgenden Attribute erforderlich: CampaignId, Name, Value, Probability, ProspectEmail, ProspectId.

INSERT INTO Opportunities(CampaignId, Name, Value, Probability, ProspectEmail, ProspectId) VALUES(1, 'Example', 3, 75, 'example@exampledomain.com', 2)

Hinweis: Diese Tabelle kann nicht aktualisiert werden, wenn ein Salesforce-Connector vorhanden ist.

Spalten

Interessentenkonten

Abrufen und Ändern potenzieller Konten.

Spalten

Perspektiven

Interessenten abrufen und ändern.

Spalten

Ansichten

Ansichten bestehen aus Spalten und Pseudospalten. Ansichten ähneln Tabellen in der Art und Weise, wie Daten dargestellt werden; Ansichten unterstützen jedoch keine Aktualisierungen. Entitäten, die als Ansichten dargestellt werden, sind normalerweise schreibgeschützte Entitäten. Oft ist eine gespeicherte Prozedur verfügbar, um die Daten zu aktualisieren, wenn eine solche Funktionalität auf die Datenquelle anwendbar ist.

Abfragen können für eine Ansicht ausgeführt werden, als wäre sie eine normale Tabelle, und die zurückgegebenen Daten sind in dieser Hinsicht ähnlich. Um mehr über Tabellen und gespeicherte Prozeduren zu erfahren, navigieren Sie bitte zu den entsprechenden Einträgen in diesem Hilfedokument.

Salesforce Pardot Connector-Ansichten

Konto

Kontoinformationen abrufen.

Tabellenspezifische Informationen

Wählen

Der Connector verarbeitet alle Filter clientseitig.

Spalten

Benutzerdefinierte Weiterleitungen

Benutzerdefinierte Weiterleitungen abrufen und ändern.

Spalten

Dynamische Inhalte

Dynamische Inhalte abrufen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• CreatedAt unterstützt '=', '<', '<=', '>', '>='.
• UpdatedAt unterstützt '=', '<', '<=', '>', '>='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM DynamicContents WHERE Id = 32
SELECT * FROM DynamicContents WHERE CreatedAt > '02/03/2019 23:11:33'
SELECT * FROM DynamicContents WHERE UpdatedAt > '01/03/2018 23:11:33' AND UpdatedAt <= '02/03/2019 23:11:33'

Spalten

E-Mail-Klicks

Email Klicks abrufen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '>', '>='.
• ListEmailId unterstützt '='.
• DripProgramActionId unterstützt '='.
• EmailTemplateId unterstützt '='.
• TrackerRedirectId unterstützt '='.
• CreatedAt unterstützt '=', '<', '<=', '>', '>='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM EmailClicks WHERE ListEmailId = 20
SELECT * FROM EmailClicks WHERE DripProgramActionId = 42
SELECT * FROM EmailClicks WHERE EmailTemplateId = 26 AND TrackerRedirectId = 31 AND CreatedAt > '02/03/2019 23:11:33'

Spalten

Emails

Emails.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '='.

Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM Emails WHERE ID = 10

Spalten

E-Mail-Statistiken

Email Statistiken abrufen.

Tabellenspezifische Informationen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Um diese Tabelle Abfrage, müssen Sie die ID angeben. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '='.

Beispielsweise wird die folgende Abfrage serverseitig verarbeitet:

SELECT * FROM EmailStats WHERE ID = 10

Spalten

E-Mail-Vorlagen

Email Vorlagen abrufen.

Tabellenspezifische Informationen

Wählen

Standardmäßig werden nur mit OneToOneEmails verknüpfte Vorlagen zurückgegeben.

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM EmailTemplates WHERE ID = 22

Spalten

Formulare

Formulare abrufen.

Spalten

Lebenszyklushistorien

Lebenszyklushistorien abrufen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• CreatedAt unterstützt '=', '<', '<=', '>', '>='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM LifecycleHistories WHERE Id = 49
SELECT * FROM LifecycleHistories WHERE Id >= 44
SELECT * FROM LifecycleHistories WHERE CreatedAt <= '02/03/2019 23:11:33'

Spalten

Lebenszyklusphasen

Lebenszyklusphasen abrufen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM LifecycleStages WHERE ID = 18

Spalten

OneToOneE-Mails

Rufen Sie einzelne Emails ab.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM OneToOneEmails WHERE ID = 11

Spalten

TagObjects

Tag-Objekte abrufen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• TagId unterstützt '='.
• Type unterstützt '='.
• ObjectId unterstützt '='.
• CreatedAt unterstützt '=', '<', '<=', '>', '>='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM TagObjects WHERE Id <= 31
SELECT * FROM TagObjects WHERE TagId = 12
SELECT * FROM TagObjects WHERE CreatedAt <= '02/03/2019 23:11:33'

Spalten

Schlagwörter

Tags abrufen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit der folgenden Spalte und dem folgenden Operator erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• Name unterstützt '='.
• CreatedAt unterstützt '=', '<', '<=', '>', '>='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Tags WHERE Id >= 42
SELECT * FROM Tags WHERE Name = 'criteria'
SELECT * FROM Tags WHERE CreatedAt >= '02/03/2019 23:11:33'

Spalten

Benutzer

Benutzer abrufen.

Spalten

BesucherAktivitäten

Besucheraktivitäten abrufen.

Spalten

Besucher

Besucher abrufen.

Spalten

BesucherSeitenaufrufe

Seitenaufrufe von Besuchern abrufen.

Spalten

Besuche

Besuche abrufen.

Spalten

Gespeicherte Prozeduren

Gespeicherte Prozeduren stehen zur Ergänzung der im Datenmodell verfügbaren Daten zur Verfügung. Es kann erforderlich sein, die in einer Ansicht verfügbaren Daten mithilfe einer gespeicherten Prozedur zu aktualisieren, da die Daten keine direkten, tabellenartigen, bidirektionalen Aktualisierungen ermöglichen. In diesen Situationen erfolgt der Abruf der Daten mithilfe der entsprechenden Ansicht oder Tabelle, während die Aktualisierung durch Aufruf einer gespeicherten Prozedur erfolgt. Gespeicherte Prozeduren verwenden eine Liste von Parametern und geben einen Datensatz zurück, der die Sammlung von Tupeln enthält, die die Antwort bilden.

Gespeicherte Prozeduren für den Salesforce Pardot Connector

Interessenten zuweisen

Aktualisieren Sie die Standorte für eine Versandzone.

Ausführen

EXEC AssignProspect ProspectId=432, AssignmentType='user', AssignTo=101

EXEC AssignProspect ProspectId=432, AssignmentType='email', AssignTo='prospectEmail@host.tld'

Eingabe

Spalten des Ergebnissatzes

Interessentenkonto zuweisen

Aktualisieren Sie die Standorte für eine Versandzone.

Ausführen

EXEC AssignProspectAccount UserId=432, ProspectAccountId=501

Eingabe

Spalten des Ergebnissatzes

GetOAuthAccessToken

Wenn Sie eine Windows Anwendung verwenden, legen Sie den Authmode auf App fest. Wenn Sie eine Web-App verwenden, legen Sie den Authmode auf Web fest und geben Sie den von GetOAuthAuthorizationUrl erhaltenen Verifier an.

Eingang

Ergebnissatzspalten

GetOAuthAuthorizationUrl

Ruft die Autorisierungs-URL ab, die vom Benutzer separat geöffnet werden muss, um Zugriff auf Ihre Anwendung zu gewähren. Wird nur bei der Entwicklung von Web-Apps benötigt.

Eingang

Ergebnissatzspalten

Aktualisieren Sie das OAuthAccessToken

Aktualisiert das OAuth-Token oder die Sitzungs-ID, nachdem die Sitzung abgelaufen ist. In Ihrer OAuth-Anwendung muss der Bereich „refresh_token“ aktiviert sein.

Eingang

Ergebnissatzspalten

E-Mail senden

Aktualisieren Sie die Standorte für eine Versandzone.

Ausführen

Dieses Verfahren erfordert eine der folgenden Eingabekombinationen:

Eine von: ProspectId, ProspectEmail oder ListId. Eine von: TemplateId oder (TextContent, Name, Betreff und (FromEmail, FromName oder FromUserId)) Beispiele:

EXEC SendEmail CampaignId=20006, ProspectId=1807618, TemplateId=13598
EXEC SendEmail CampaignId=20006, ProspectEmail='prospectEmail@host.tld', TextContent='content', Name='email name', Subject='email subject', FromUserId=24486
EXEC SendEmail CampaignId=20006, ListId=20104, TextContent='content', Name='email name', Subject='email subject', FromEmail='senderEmail@host.tld', FromName='Name Surname'

Eingabe

Ergebnissatzspalten

Zuweisung von Interessenten aufheben

Aktualisieren Sie die Standorte für eine Versandzone.

Ausführen

EXEC UnAssignProspect ProspectId=432

Eingabe

Spalten des Ergebnissatzes

Löschen aufheben

Aktualisieren Sie die Standorte für eine Versandzone.

Ausführen

EXEC UnDeleteOpportunity Id=600

Eingabe

Ergebnissatzspalten

Salesforce Pardot V5-Datenmodell

Der Salesforce Pardot-Konnektor modelliert Salesforce Pardot Pardot API v5-Objekte als relationale Tabellen, Ansichten und gespeicherte Prozeduren. API Einschränkungen und-Anforderungen sind in diesem Abschnitt dokumentiert. Sie können die SupportEnhancedSQL-Funktion, standardmäßig eingestellt, um die meisten dieser Einschränkungen zu umgehen.

Tabellen

Tabellen beschreibt eine Auswahl der verfügbaren Standardtabellen.

Tabellen

Der Connector modelliert die Daten in Salesforce Pardot in einer Liste von Tabellen, die mit Standard-SQL-Anweisungen abgefragt werden können.

Im Allgemeinen ist das Abfragen von Salesforce Pardot-Tabellen dasselbe wie das Abfragen einer Tabelle in einer relationalen Datenbank. Manchmal gibt es Sonderfälle, beispielsweise kann das Einfügen einer bestimmten Spalte in die WHERE-Klausel erforderlich sein, um Daten für bestimmte Spalten in der Tabelle abzurufen. Dies ist normalerweise in Situationen erforderlich, in denen für jede Zeile eine separate Abfrage erfolgen muss, um bestimmte Spalten abzurufen. Diese Arten von Situationen sind oben auf der unten verlinkten Tabellenseite klar dokumentiert.

Salesforce Pardot Connector-Tabellen

Benutzerdefinierte Weiterleitungen

Verfolgen Sie Links auf Ihrer Website oder auf Websites von Drittpartei mit benutzerdefinierten Pardot-Weiterleitungen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• IsDeleted unterstützt '='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM CustomRedirects WHERE Id = 40
SELECT * FROM CustomRedirects WHERE IsDeleted = 'true'

Einfügen

Beim Einfügen sind folgende Attribute erforderlich: Name, Kampagnen-ID, Ziel-URL.

INSERT INTO CustomRedirects (Name,CampaignId,DestinationUrl) VALUES ('name','1','https://example.com/content.html')

Aktualisieren

CustomRedirects-Attribute aktualisieren.

Update CustomRedirects set Name='newName', FolderId='527425' where Id=24143

Löschen

Entfernen Sie alle CustomRedirects-Objekte oder eines, indem Sie die ID des CustomRedirect angeben.

DELETE FROM CustomRedirects

DELETE FROM CustomRedirects WHERE ID = 10003

GetDeleted

Zum Abrufen benutzerdefinierter Weiterleitungen, die sich im Papierkorb in Pardot befinden, wird der folgende Operation unterstützt:

GETDELETED FROM CustomRedirects

Spalten

E-Mail-Vorlagen

Email Vorlagen abfragen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• IsOneToOneEmail unterstützt '='.
• IsDeleted unterstützt '='.
• CreatedAt unterstützt '=', '<', '<=', '>', '>='.
• UpdatedAt unterstützt '=', '<', '<=', '>', '>='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM EmailTemplates WHERE Id = 50
SELECT * FROM EmailTemplates WHERE UpdatedAt > '01/01/2022'
SELECT * FROM EmailTemplates WHERE CreatedAt > '01/01/2022'

Zum Einfügen in eine Tabelle ist die Angabe des SenderOptionsAggregate erforderlich. Die Eingabe für dieses Feld folgt den Prinzipien von Deep Inserts. Bei Deep Insert erstellen Sie gleichzeitig ein Basisobjekt und verknüpfen es mit dem zugehörigen Feld in der Haupttabelle. Um JSON-Daten zu übermitteln, geben Sie die Werte für die untergeordnete Tabelle im JSON-Format an. Um das Einfügen auszuführen, kann das vollständige JSON referenziert oder als Zeichenfolgenliterale eingefügt werden. Beispiel:

GetDeleted

Zum Abrufen von Email-Vorlagen, die sich im Papierkorb in Pardot befinden, wird der folgende Operation unterstützt:

GETDELETED FROM EmailTemplates

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Dateien

Laden Sie Bilder und andere Dateien hoch, um sie in Ihren Pardot-Emails, Formularen und Zielseiten zu verwenden.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• CreatedAt unterstützt '=', '<', '<=', '>', '>='.
• UpdatedAt unterstützt '=', '<', '<=', '>', '>='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Files WHERE Id = 40
SELECT * FROM Files WHERE UpdatedAt < '2021-12-30T03:16:27-08:00' and CreatedAt >= '2021-11-12T07:18:56-08:00'

Einfügen

Beim Einfügen sind folgende Attribute erforderlich: Name, Dateipfad.

INSERT INTO Files (Name, FilePath) VALUES ('file1','C:\file1.txt')

Aktualisieren

Dateien aktualisieren:

UPDATE Files SET Name='testingUpdate', FolderId='33609' WHERE id='804969'

Löschen

Entfernen Sie alle Dateien oder eine Datei, indem Sie die ID der Datei angeben.

DELETE FROM Files

DELETE FROM Files WHERE ID = 10003

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Layoutvorlagen

Layoutvorlagen abrufen und ändern.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• IsDeleted unterstützt '='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM LayoutTemplates WHERE Id = 40
SELECT * FROM LayoutTemplates WHERE IsDeleted = 'true'

Einfügen

Beim Einfügen sind folgende Attribute erforderlich: Name, Layoutinhalt.

INSERT INTO LayoutTemplates (Name,IsIncludeDefaultCss,LayoutContent,FolderId) VALUES ('name','true','content', 33621)

Aktualisieren

Layoutvorlagen aktualisieren:

Update LayoutTemplates set Name='newName' where Id=24143

Löschen

Entfernen Sie alle Layoutvorlagen oder eine Layoutvorlage, indem Sie die ID der Vorlage angeben.

DELETE FROM LayoutTemplates

DELETE FROM LayoutTemplates WHERE ID = 10003

GetDeleted

Zum Abrufen von Layoutvorlagen, die sich im Papierkorb in Pardot befinden, wird der folgende Operation unterstützt:

GETDELETED FROM LayoutTemplates

Spalten

Listen

Listen abrufen und ändern.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• CreatedAt unterstützt '=', '<', '<=', '>', '>='.
• UpdatedAt unterstützt '=', '<', '<=', '>', '>='.
• IsDeleted unterstützt '='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Lists WHERE Id = 40
SELECT * FROM Lists WHERE IsDeleted = 'true'
SELECT * FROM Lists WHERE CreatedAt > '01/01/2022'

Einfügen

Beim Einfügen ist folgendes Attribut erforderlich: Name.

INSERT INTO Lists (Name) VALUES ('name')

Aktualisieren

Listenattribute aktualisieren.

Update Lists set Name='newName' where Id=24143

Löschen

Entfernen Sie alle Listen oder eine Liste, indem Sie die ID der Liste angeben.

DELETE FROM Lists

DELETE FROM Lists WHERE ID = 10003

GetDeleted

Zum Abrufen von Listen, die sich im Papierkorb in Pardot befinden, wird der folgende Operation unterstützt:

GETDELETED FROM Lists

Spalten

Perspektiven

Interessenten abrufen und ändern.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• UserId unterstützt '=', '<', '<=', '>', '>='.
• AssignedToId unterstützt '=', '<', '<=', '>', '>='.
• LastActivityAt unterstützt '=', '<', '<=', '>', '>='.
• IsDeleted unterstützt '='.
• CreatedAt unterstützt '=', '<', '<=', '>', '>='.
• UpdatedAt unterstützt '=', '<', '<=', '>', '>='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Prospects WHERE Id = 3457992
SELECT * FROM Prospects WHERE UserId = 14
SELECT * FROM Prospects WHERE UpdatedAt < '2021-12-30T03:16:27-08:00' and CreatedAt >= '2021-11-12T07:18:56-08:00'

Gelöscht werden

Um gelöschte Interessenten abzurufen, kann eine GETDELETED-Anweisung ausgeführt werden.

GETDELETED FROM Prospects

Spalten

Ansichten

Ansichten bestehen aus Spalten und Pseudospalten. Ansichten ähneln Tabellen in der Art und Weise, wie Daten dargestellt werden; Ansichten unterstützen jedoch keine Aktualisierungen. Entitäten, die als Ansichten dargestellt werden, sind normalerweise schreibgeschützte Entitäten. Oft ist eine gespeicherte Prozedur verfügbar, um die Daten zu aktualisieren, wenn eine solche Funktionalität auf die Datenquelle anwendbar ist.

Abfragen können für eine Ansicht ausgeführt werden, als wäre sie eine normale Tabelle, und die zurückgegebenen Daten sind in dieser Hinsicht ähnlich. Um mehr über Tabellen und gespeicherte Prozeduren zu erfahren, navigieren Sie bitte zu den entsprechenden Einträgen in diesem Hilfedokument.

Salesforce Pardot Connector-Ansichten

Kampagnen

Kampagnen abrufen und ändern.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• Name unterstützt '='.
• CreatedAt unterstützt '=', '<', '<=', '>', '>='.
• UpdatedAt unterstützt '=', '<', '<=', '>', '>='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Campaigns WHERE Id = 50
SELECT * FROM Campaigns WHERE Name = 'campaignName'
SELECT * FROM Campaigns WHERE CreatedAt > '01/01/2022'

GetDeleted

Zum Abrufen von Kampagnen, die sich im Papierkorb in Pardot befinden, wird der folgende Operation unterstützt:

GETDELETED FROM Campaings

Spalten

Benutzerdefinierte Felder

Metadaten benutzerdefinierter Felder abrufen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• CreatedAt unterstützt '=', '<', '<=', '>', '>='.
• UpdatedAt unterstützt '=', '<', '<=', '>', '>='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM CustomFields WHERE Id = 50
SELECT * FROM CustomFields WHERE CreatedAt > '01/01/2022'
SELECT * FROM CustomFields WHERE UpdatedAt < '01/01/2022'

Spalten

Pseudo-Spalten

Pseudospaltenfelder werden in der WHERE-Klausel von SELECT-Anweisungen verwendet und bieten eine genauere Kontrolle über die Tupel, die von der Datenquelle zurückgegeben werden.

Emails

Emails Abfragen, um zu erfahren, wie potenzielle Kunden auf die Emails reagiert haben.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• ProspectId unterstützt '=', '<', '<=', '>', '>='.
• ListEmailId unterstützt '=', '<', '<=', '>', '>='.
• SentAt unterstützt '=', '<', '<=', '>', '>='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Emails WHERE Id = 50
SELECT * FROM Emails WHERE ProspectId = 23
SELECT * FROM Emails WHERE SentAt > '01/01/2022'

Spalten

Ordner

Rufen Sie Ordner ab oder organisieren und verschachteln Sie Ihre Inhalte und Marketingressourcen auf eine Weise, die für Ihr Team sinnvoll ist.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• ParentFolderId unterstützt '=', '<', '<=', '>', '>='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Folders WHERE Id = 50
SELECT * FROM Folders WHERE ParentFolderId = 2

Spalten

Formulare

Formulare abrufen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• IsDeleted unterstützt '='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Forms WHERE Id <= 17
SELECT * FROM Forms WHERE IsDeleted = 'true'

GetDeleted

Zum Abrufen von Formularen, die sich im Papierkorb in Pardot befinden, wird der folgende Operation unterstützt:

GETDELETED FROM Forms

Spalten

ListeE-Mail

Eine Listen-Email ist eine einzelne Email, die an eine Empfängerliste gesendet wird.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• IsDeleted unterstützt '='.
• CreatedAt unterstützt '=', '<', '<=', '>', '>='.
• UpdatedAt unterstützt '=', '<', '<=', '>', '>='.
• SentAt unterstützt '=', '<', '<=', '>', '>='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ListEmail WHERE Id = 50
SELECT * FROM ListEmail WHERE SentAt > '01/01/2022'
SELECT * FROM ListEmail WHERE CreatedAt > '01/01/2022'

GetDeleted

Zum Abrufen von Listen-Email, die sich im Papierkorb in Pardot befinden, wird der folgende Operation unterstützt:

GETDELETED FROM ListEmail

Spalten

Interessentenkonten

Abrufen und Ändern potenzieller Konten.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM ProspectAccounts WHERE ID > 31

Gelöscht werden

Um gelöschte potenzielle Kundenkonten wiederherzustellen, kann eine GETDELETED-Anweisung ausgeführt werden.

GETDELETED FROM ProspectAccounts

Spalten

Antwortoptionen

Fragen Sie die „RepltyTo“-Optionen von Email Vorlagen ab.

Spalten

AbsenderOptionen

Abfrage der Absenderoptionen von Email Vorlagen.

Spalten

TrackerDomains

Frage die verfügbaren Tracker-Domänen ab.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• IsDeleted unterstützt '='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM TrackerDomains WHERE ID = 50

GetDeleted

Um gelöschte Datensätze abzurufen, kann eine GETDELETED-Anweisung ausgeführt werden.

GETDELETED FROM TrackerDomains

Spalten

Benutzer

Fragen Sie die verfügbaren Benutzer ab.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• IsDeleted unterstützt '='.
• UpdatedAt unterstützt '=', '<', '<=', '>', '>='.
• CreatedAt unterstützt '=', '<', '<=', '>', '>='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Users WHERE Id = 32
SELECT * FROM Users WHERE CreatedAt < '02/03/2019 23:11:33' AND CreatedAt > '02/03/2018 23:11:33'

Gelöscht werden

Um gelöschte Benutzer abzurufen, kann eine GETDELETED-Anweisung ausgeführt werden.

GETDELETED FROM Users

Spalten

BesucherSeitenaufrufe

Seitenaufrufe von Besuchern abrufen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• VisitId unterstützt '=', '<', '<=', '>', '>='.
• VisitorId unterstützt '=', '<', '<=', '>', '>='.
• CreatedAt unterstützt '=', '<', '<=', '>', '>='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM VisitorPageViews WHERE VisitId = 22
SELECT * FROM VisitorPageViews WHERE ID >= 22 AND VisitorId = 1234

Spalten

Besuche

Besuche abrufen.

Tabellenspezifische Informationen

Wählen

Der Connector verwendet die Salesforce Pardot API, um WHERE-Klauselbedingungen zu verarbeiten, die mit den folgenden Spalten und Operatoren erstellt wurden. Der Rest des Filters wird clientseitig innerhalb des Connectors ausgeführt.

• Id unterstützt '=', '<', '<=', '>', '>='.
• VisitorId unterstützt '=', '<', '<=', '>', '>='.
• ProspectId unterstützt '=', '<', '<=', '>', '>='.
• CreatedAt unterstützt '=', '<', '<=', '>', '>='.
• UpdatedAt unterstützt '=', '<', '<=', '>', '>='.

Beispielsweise werden die folgenden Abfragen serverseitig verarbeitet:

SELECT * FROM Visits WHERE Id = 22
SELECT * FROM Visits WHERE VisitorId > 234

Spalten

Gespeicherte Prozeduren

Gespeicherte Prozeduren stehen zur Ergänzung der im Datenmodell verfügbaren Daten zur Verfügung. Es kann erforderlich sein, die in einer Ansicht verfügbaren Daten mithilfe einer gespeicherten Prozedur zu aktualisieren, da die Daten keine direkten, tabellenartigen, bidirektionalen Aktualisierungen ermöglichen. In diesen Situationen erfolgt der Abruf der Daten mithilfe der entsprechenden Ansicht oder Tabelle, während die Aktualisierung durch Aufruf einer gespeicherten Prozedur erfolgt. Gespeicherte Prozeduren verwenden eine Liste von Parametern und geben einen Datensatz zurück, der die Sammlung von Tupeln enthält, die die Antwort bilden.

Gespeicherte Prozeduren für den Salesforce Pardot Connector

GetOAuthAccessToken

Wenn Sie eine Windows Anwendung verwenden, legen Sie den Authmode auf App fest. Wenn Sie eine Web-App verwenden, legen Sie den Authmode auf Web fest und geben Sie den von GetOAuthAuthorizationUrl erhaltenen Verifier an.

Eingang

Ergebnissatzspalten

GetOAuthAuthorizationUrl

Ruft die Autorisierungs-URL ab, die vom Benutzer separat geöffnet werden muss, um Zugriff auf Ihre Anwendung zu gewähren. Wird nur bei der Entwicklung von Web-Apps benötigt.

Eingang

Ergebnissatzspalten

Aktualisieren Sie das OAuthAccessToken

Aktualisiert das OAuth-Token oder die Sitzungs-ID, nachdem die Sitzung abgelaufen ist. In Ihrer OAuth-Anwendung muss der Bereich „refresh_token“ aktiviert sein.

Eingang