Detalles de Conexión de Salesforce Pardot

Introducción

Versión del conector

Esta documentación se basa en la versión 21.0.8257 del conector.

Empezando

Compatibilidad con la versión de Salesforce Pardot

El conector aprovecha la API de SalesforcePardot para habilitar el acceso bidireccional a SalesforcePardot. Admite la API de Pardot v3 y v4.

Establecer una Conexión

Conexión a Pardot

Conexión Mediante OAuth2

Selecciona el AuthScheme a OAuth para autenticar con este método.

Id. de Unidad de Negocio de Pardot

Para conectarse a través de OAuth2.0, debe obtener el BusinessUnitId.

Para encontrar el Id. de unidad comercial de Pardot, utilice Configuración en Salesforce.

• Desde Configuración, ingrese "Configuración de cuenta de Pardot" en el cuadro Búsqueda rápida.

Su Id. de unidad comercial de Pardot comienza con "0Uv" y tiene 18 caracteres. Si no puede acceder a la información de configuración de la cuenta de Pardot, solicite a su administrador de Salesforce que le proporcione el ID de la unidad comercial de Pardot.

Puede conectarse después de configurar las propiedades de conexión requeridas para sus credenciales de usuario y obtener los tokens de acceso requeridos utilizando una herramienta como Postman.

Consulte Uso de la autenticación OAuth para obtener una guía de autenticación y detalles del flujo de autenticación de OAuth.

Uso de la Autenticación OAuth

OAuth requiere el uso de tokens de acceso obtenidos con Postman o una herramienta similar. La autenticación OAuth es compatible como se describe en Conexión en Configurar conexiones OAuth.

Notas Importantes

Procedimientos Almacenados

• Las funciones de procedimientos almacenados descritas en esta documentación no se admiten actualmente.
• Debido a que los procedimientos almacenados no se admiten actualmente, cualquier característica que dependa de los procedimientos almacenados tampoco se admite actualmente.

Archivos de Configuración y Sus Rutas

• Todas las referencias a la adición de archivos de configuración y sus rutas se refieren a archivos y ubicaciones en Harmony Agente donde está instalado el conector. Estas rutas deben ajustarse según corresponda según el agente y el sistema operativo. Si se utilizan varios agentes en un grupo de agentes, se requerirán archivos idénticos en cada agente.

Características Avanzadas

Esta sección detalla una selección de características avanzadas del conector Salesforce Pardot.

Vistas definidas por el usuario

El conector le permite definir tablas virtuales, llamadas vistas definidas por el usuario, cuyo contenido se decide mediante una consultar preconfigurada. Estas vistas son útiles cuando no puede controlar directamente las consultas que se envían a los controladores. Consulte Vistas definidas por el usuario para obtener una descripción general de la creación y configuración de vistas personalizadas.

Configuración SSL

Usar Configuración SSL para ajustar cómo el conector maneja las negociaciones de certificados TLS/SSL. Puede elegir entre varios formatos de certificado; ver el SSLServerCert propiedad en "Opciones de cadena de conexión" para obtener más información.

Apoderado

Para configurar el conector mediante Configuración de proxy de Agente Privado, Selecciona el Use Proxy Settings casilla de verificación en la pantalla de configuración de la conexión.

Vistas Definidas por el Usuario

El conector Jitterbit para Salesforce Pardot le permite definir una tabla virtual cuyos contenidos se deciden mediante una consultar preconfigurada. Estas se denominan Vistas definidas por el usuario, que son útiles en situaciones en las que no puede controlar directamente la consultar que se envía al controlador, por ejemplo, cuando se utiliza el controlador de Jitterbit. Las vistas definidas por el usuario se pueden utilizar para definir predicados que siempre se aplican. Si especifica predicados adicionales en la consultar a la vista, se combinan con la consultar ya definida como parte de la vista.

Hay dos formas de crear vistas definidas por el usuario:

• Cree un archivo de configuración con formato JSON que defina las vistas que desea.
• Declaraciones DDL.

Definición de Vistas Usando un Archivo de Configuración

Las vistas definidas por el usuario se definen en un archivo de configuración con formato JSON llamado UserDefinedViews.json. El conector detecta automáticamente las vistas especificadas en este archivo.

También puede tener múltiples definiciones de vista y controlarlas usando UserDefinedViews propiedad de conexión. Cuando utiliza esta propiedad, el conector solo ve las vistas especificadas.

Este archivo de configuración de vista definida por el usuario tiene el siguiente formato:

• Cada elemento raíz define el nombre de una vista.
• Cada elemento raíz contiene un elemento hijo, llamado query, que contiene la consultar SQL personalizada para la vista.

Por ejemplo:

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

Utilizar el UserDefinedViews propiedad de conexión para especificar la ubicación de su archivo de configuración JSON. Por ejemplo:

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

Esquema para Vistas Definidas por el Usuario

Las vistas definidas por el usuario se exponen en UserViews esquema por defecto. Esto se hace para evitar que el nombre de la vista entre en conflicto con una entidad real en el modelo de datos. Puede cambiar el nombre del esquema utilizado para UserViews configurando UserViewsSchemaName propiedad.

Trabajar con Vistas Definidas por el Usuario

Por ejemplo, una instrucción SQL con una vista definida por el usuario llamada UserViews.RCustomers solo enumera clientes en Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Un ejemplo de una consultar al controlador:

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

Dando como resultado la consultar efectiva a la fuente:

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

Ese es un ejemplo muy simple de una consultar a una vista definida por el usuario que es efectivamente una combinación de la consultar de vista y la definición de vista. Es posible componer estas consultas en patrones mucho más complejos. Todas las operaciones de SQL están permitidas en ambas consultas y se combinan cuando corresponde.

Configuración SSL

Personalización de la Configuración SSL

De forma predeterminada, el conector intenta negociar SSL/TLS comparando el certificado del servidor con el almacén de certificados de confianza del sistema.

Para especificar otro certificado, consulte SSLServerCert propiedad de los formatos disponibles para hacerlo.

Modelo de Datos

Descripción general

Esta sección muestra los objetos de API disponibles y brinda más información sobre cómo ejecutar SQL para las APIs de Salesforce Pardot.

Características clave

• El conector modela entidades de Salesforce Pardot como documentos, carpetas y grupos como vistas relacionales, lo que le permite escribir SQL para consultar datos de Salesforce Pardot.
• Procedimientos almacenados* le permiten ejecutar operaciones en Salesforce Pardot, incluida la recuperación del token de acceso y mantenerlo actualizado en OAuth 2.0.
• La conectividad en vivo a estos objetos significa que cualquier cambio en su cuenta de Salesforce Pardot se refleja inmediatamente al usar el conector.

Procesamiento colaborativo de consultas

El conector descarga la mayor parte posible del procesamiento de sentencias SELECT a Salesforce Pardot y luego procesa el resto de la consultar en la memoria. Las limitaciones y los requisitos de la API también se documentan en esta sección.

Ver SupportEnhancedSQL para obtener más información sobre cómo el conector elude las limitaciones de la API con el procesamiento del lado del cliente en memoria.

Modelo de Datos de Salesforce Pardot V3 y V4

Jitterbit Connector for Salesforce Pardot modela entidades de Salesforce Pardot como tablas relacionales, vistas y procedimientos almacenados. Las limitaciones y los requisitos de la API se documentan en esta sección; puedes usar el SupportEnhancedSQL función, configurada de forma predeterminada, para eludir la mayoría de estas limitaciones.

Mesas

El conector modela los datos en Salesforce Pardot en una lista de tablas que se pueden consultar mediante instrucciones SQL estándar.

Generalmente, consultar tablas de Salesforce Pardot es lo mismo que consultar una tabla en una base de datos relacional. A veces hay casos especiales, por ejemplo, incluir una determinada columna en la cláusula WHERE puede ser necesario para obtener datos para ciertas columnas de la tabla. Esto suele ser necesario para situaciones en las que se debe realizar una solicitud separada para cada fila para obtener ciertas columnas. Estos tipos de situaciones están claramente documentados en la parte superior de la página de la tabla vinculada a continuación.

Conector Jitterbit para Tablas Salesforce Pardot

Campañas

Recuperar y modificar campañas.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• Name admite '='.
• CreatedAt admite '=', '<', '<=', '>', '>='.
• UpdatedAt admite '=', '<', '<=', '>', '>='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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

Insertar

Esta tabla no tiene ningún atributo requerido al realizar una inserción.

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Campos Personalizados

Recuperar y modificar campos personalizados.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• CreatedAt admite '=', '<', '<=', '>', '>='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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

Insertar

Los siguientes atributos son necesarios al realizar una inserción: FieldId, Name.

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

Columnas

ListaMembresías

Recuperar y modificar miembros de la lista.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• ListId admite '='.
• CreatedAt admite '=', '<', '<=', '>', '>='.
• UpdatedAt admite '=', '<', '<=', '>', '>='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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

Insertar

Los siguientes atributos son necesarios al realizar una inserción: ListId, ProspectId.

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

Ser Eliminado

Para recuperar registros eliminados, se puede ejecutar una instrucción GETDELETED. La declaración GETDELETED admite los mismos filtros del lado del servidor que admite la declaración SELECT (excepto ID cuando se usa el operador de igualdad (=), pero no realiza ningún filtrado del lado del cliente.

GETDELETED FROM ListMemberships WHERE ID = 231

Columnas

Liza

Recuperar y modificar listas.

Columnas

Oportunidades

Recuperar y modificar oportunidades.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• Probability admite '=', '<', '<=', '>', '>='.
• CreatedAt admite '=', '<', '<=', '>', '>='.
• ProspectEmail admite '='.
• ProspectId admite '='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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

Insertar

Los siguientes atributos son necesarios al realizar una inserción: CampaignId, Name, Value, Probability, ProspectEmail, ProspectId.

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

Nota: Esta tabla no se puede actualizar si hay un conector de Salesforce presente.

Columnas

Cuentas de Prospectos

Recuperar y modificar cuentas de prospectos.

Columnas

Perspectivas

Recuperar y modificar prospectos.

Columnas

Puntos de Vista

Las vistas se componen de columnas y pseudocolumnas. Las vistas son similares a las tablas en la forma en que se representan los datos; sin embargo, las vistas no admiten actualizaciones. Las entidades que se representan como vistas suelen ser entidades de solo lectura. A menudo, un procedimiento almacenado* está disponible para actualizar los datos si dicha funcionalidad es aplicable a la fuente de datos.

Las consultas se pueden ejecutar contra una vista como si fuera una tabla normal, y los datos que regresan son similares en ese sentido. Para obtener más información sobre las tablas y los procedimientos almacenados, vaya a sus entradas correspondientes en este documento de ayuda.

Conector Jitterbit para Vistas Salesforce Pardot

Cuenta

Recuperar información de la cuenta.

Información Específica de la Tabla

Seleccionar

El conector procesará todos los filtros del lado del cliente.

Columnas

Redirecciones Personalizadas

Recuperar y modificar redireccionamientos personalizados.

Columnas

Contenido Dinámico

Recuperar contenidos dinámicos.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• CreatedAt admite '=', '<', '<=', '>', '>='.
• UpdatedAt admite '=', '<', '<=', '>', '>='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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'

Columnas

Clics de Correo Electrónico

Recuperar clics de correo.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '>', '>='.
• ListEmailId admite '='.
• DripProgramActionId admite '='.
• EmailTemplateId admite '='.
• TrackerRedirectId admite '='.
• CreatedAt admite '=', '<', '<=', '>', '>='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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'

Columnas

Correos

Recuperar correos.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '='.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM Emails WHERE ID = 10

Columnas

Estadísticas de Correo Electrónico

Recuperar estadísticas de correo.

Información Específica de la Tabla

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. Para consultar esta tabla, debe especificar el Id. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '='.

Por ejemplo, la siguiente consultar se procesa del lado del servidor:

SELECT * FROM EmailStats WHERE ID = 10

Columnas

Plantillas de Correo Electrónico

Recuperar plantillas de correo.

Información Específica de la Tabla

Seleccionar

De forma predeterminada, solo se devolverán las plantillas conectadas a OneToOneEmails.

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

SELECT * FROM EmailTemplates WHERE ID = 22

Columnas

Formularios

Recupera formularios.

Columnas

LifecycleHistories

Recuperar historiales de ciclo de vida.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• CreatedAt admite '=', '<', '<=', '>', '>='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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

Columnas

Etapas del Ciclo de Vida

Recuperar etapas del ciclo de vida.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

SELECT * FROM LifecycleStages WHERE ID = 18

Columnas

Correos Electrónicos Uno a Uno

Recuperar correos uno a uno.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

SELECT * FROM OneToOneEmails WHERE ID = 11

Columnas

TagObjects

Recuperar objetos de etiquetas.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• TagId admite '='.
• Type admite '='.
• ObjectId admite '='.
• CreatedAt admite '=', '<', '<=', '>', '>='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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

Columnas

Etiquetas

Recuperar etiquetas.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con la siguiente columna y operador. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• Name admite '='.
• CreatedAt admite '=', '<', '<=', '>', '>='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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

Columnas

Usuarios

Recuperar usuarios.

Columnas

Actividades del Visitante

Recuperar las actividades de los visitantes.

Columnas

Visitantes

Recuperar visitantes.

Columnas

VisitantesPáginaVistas

Recuperar vistas de página de visitantes.

Columnas

Visitas

Recuperar visitas.

Columnas

Procedimientos Almacenados

Procedimientos almacenados* están disponibles para complementar los datos disponibles del Modelo de datos. Puede ser necesario actualizar los datos disponibles desde una vista usando un procedimiento almacenado* porque los datos no proporcionan actualizaciones bidireccionales directas, similares a tablas. En estas situaciones, la recuperación de los datos se realiza utilizando la vista o tabla adecuada, mientras que la actualización se realiza llamando a un procedimiento almacenado. Procedimientos almacenados* toman una lista de parámetros y devuelven un conjunto de datos que contiene la colección de tuplas que constituyen la respuesta.

Jitterbit Connector para Procedimientos Almacenados de Salesforce Pardot

Asignar Prospecto

Actualizar las ubicaciones de una zona de envío.

Ejecutar

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

Aporte

Columnas del conjunto de resultados

Asignar Cuenta de Cliente Potencial

Actualizar las ubicaciones de una zona de envío.

Ejecutar

EXEC AssignProspectAccount UserId=432, ProspectAccountId=501

Aporte

Columnas del conjunto de resultados

Obtener Token de Acceso de OAuth

Si usa una aplicación de Windows, establezca Authmode en App. Si usa una aplicación web, establezca Authmode en Web y especifique el Verificador obtenido por GetOAuthAuthorizationUrl.

Aporte

Columnas del Conjunto de Resultados

Obtener URL de Autorización de OAuth

Obtiene la URL de autorización que el usuario debe abrir por separado para otorgar acceso a su aplicación. Solo se necesita al desarrollar aplicaciones web.

Aporte

Columnas del Conjunto de Resultados

RefreshOAuthAccessToken

Actualiza el token de OAuth o el ID de sesión después de que la sesión haya expirado. Tu aplicación de OAuth debe tener activado el ámbito refresh_token.

Aporte

Columnas del Conjunto de Resultados

Enviar Correo Electrónico

Actualizar las ubicaciones de una zona de envío.

Ejecutar

Este procedimiento requiere cualquiera de las siguientes combinaciones de entrada:

Uno de: ProspectId, ProspectEmail o ListId. Uno de: TemplateId o (TextContent, Name, Asunto y (FromEmail, FromName o FromUserId)) Ejemplos:

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'

Aporte

Columnas del conjunto de resultados

UnAssignProspect

Actualizar las ubicaciones de una zona de envío.

Ejecutar

EXEC UnAssignProspect ProspectId=432

Aporte

Columnas del conjunto de resultados

UnDeleteOportunity

Actualizar las ubicaciones de una zona de envío.

Ejecutar

EXEC UnDeleteOpportunity Id=600

Aporte

Columnas del conjunto de resultados

Modelo de Datos de Salesforce Pardot V5

Jitterbit Connector para Salesforce Pardot modela objetos de Salesforce Pardot Pardot API v5 como tablas relacionales, vistas y procedimientos almacenados. Las limitaciones y los requisitos de la API se documentan en esta sección; puedes usar el SupportEnhancedSQL función, configurada de forma predeterminada, para eludir la mayoría de estas limitaciones.

Mesas

Mesas describe una muestra de las tablas estándar disponibles.

Mesas

El conector modela los datos en Salesforce Pardot en una lista de tablas que se pueden consultar mediante instrucciones SQL estándar.

Generalmente, consultar tablas de Salesforce Pardot es lo mismo que consultar una tabla en una base de datos relacional. A veces hay casos especiales, por ejemplo, incluir una determinada columna en la cláusula WHERE puede ser necesario para obtener datos para ciertas columnas de la tabla. Esto suele ser necesario para situaciones en las que se debe realizar una solicitud separada para cada fila para obtener ciertas columnas. Estos tipos de situaciones están claramente documentados en la parte superior de la página de la tabla vinculada a continuación.

Conector Jitterbit para Tablas Salesforce Pardot

Redirecciones Personalizadas

Realice un seguimiento de los vínculos en su sitio web o en el sitio de un externo con los redireccionamientos personalizados de Pardot.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• IsDeleted admite '='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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

Insertar

Los siguientes atributos son necesarios al realizar una inserción: Nombre, CampaignId, DestinationUrl.

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

Actualizar

Actualice los atributos de CustomRedirects.

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

Borrar

Elimine todos los objetos CustomRedirects o uno especificando el ID de CustomRedirect.

DELETE FROM CustomRedirects

DELETE FROM CustomRedirects WHERE ID = 10003

ObtenerEliminado

Para recuperar redirecciones personalizadas que están en la papelera de reciclaje en Pardot, se admite la siguiente operación:

GETDELETED FROM CustomRedirects

Columnas

Plantillas de Correo Electrónico

Plantillas de correo de consulta.

Información Específica de la Tabla

Seleccionar

El conector utiliza la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• IsOneToOneEmail admite '='.
• IsDeleted admite '='.
• CreatedAt admite '=', '<', '<=', '>', '>='.
• UpdatedAt admite '=', '<', '<=', '>', '>='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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

Para insertar en una tabla, se requiere especificar SenderOptionsAggregate. La entrada para este campo sigue los principios de Deep Inserts. En Deep Insert, crea simultáneamente un objeto base y lo enlace al campo relacionado en la tabla principal. Para enviar datos JSON, proporcione los valores de la tabla secundaria en formato JSON. Para ejecutar la inserción, se puede hacer referencia al JSON completo o incluirlo como literales de cadena. Por ejemplo:

ObtenerEliminado

Para recuperar plantillas de correo que están en la papelera de reciclaje en Pardot, se admite la siguiente operación:

GETDELETED FROM EmailTemplates

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Archivos

Cargue imágenes y otros archivos para usar en sus correos, formularios y páginas de destino de Pardot.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• CreatedAt admite '=', '<', '<=', '>', '>='.
• UpdatedAt admite '=', '<', '<=', '>', '>='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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'

Insertar

Los siguientes atributos son necesarios al realizar una inserción: Nombre, FilePath.

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

Actualizar

Actualización de archivos:

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

Borrar

Elimine todos los archivos o un archivo especificando el ID del archivo.

DELETE FROM Files

DELETE FROM Files WHERE ID = 10003

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Plantillas de Diseño

Recuperar y modificar plantillas de diseño.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• IsDeleted admite '='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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

Insertar

Los siguientes atributos son necesarios al realizar una inserción: Nombre, LayoutContent.

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

Actualizar

Actualización de plantillas de diseño:

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

Borrar

Elimine todas las plantillas de diseño o una modelo de diseño especificando el ID de la modelo.

DELETE FROM LayoutTemplates

DELETE FROM LayoutTemplates WHERE ID = 10003

ObtenerEliminado

Para recuperar plantillas de diseño que están en la papelera de reciclaje en Pardot, se admite la siguiente operación:

GETDELETED FROM LayoutTemplates

Columnas

Liza

Recuperar y modificar listas.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• CreatedAt admite '=', '<', '<=', '>', '>='.
• UpdatedAt admite '=', '<', '<=', '>', '>='.
• IsDeleted admite '='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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

Insertar

Se requiere el siguiente atributo al realizar una inserción: Nombre.

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

Actualizar

Actualizar atributos de listas.

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

Borrar

Elimine todas las listas o una lista especificando el ID de la lista.

DELETE FROM Lists

DELETE FROM Lists WHERE ID = 10003

ObtenerEliminado

Para recuperar listas que están en la papelera de reciclaje en Pardot, se admite la siguiente operación:

GETDELETED FROM Lists

Columnas

Perspectivas

Recuperar y modificar prospectos.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• UserId admite '=', '<', '<=', '>', '>='.
• AssignedToId admite '=', '<', '<=', '>', '>='.
• LastActivityAt admite '=', '<', '<=', '>', '>='.
• IsDeleted admite '='.
• CreatedAt admite '=', '<', '<=', '>', '>='.
• UpdatedAt admite '=', '<', '<=', '>', '>='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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'

Ser Eliminado

Para recuperar prospectos eliminados, se puede ejecutar una declaración GETDELETED.

GETDELETED FROM Prospects

Columnas

Puntos de Vista

Las vistas se componen de columnas y pseudocolumnas. Las vistas son similares a las tablas en la forma en que se representan los datos; sin embargo, las vistas no admiten actualizaciones. Las entidades que se representan como vistas suelen ser entidades de solo lectura. A menudo, un procedimiento almacenado* está disponible para actualizar los datos si dicha funcionalidad es aplicable a la fuente de datos.

Las consultas se pueden ejecutar contra una vista como si fuera una tabla normal, y los datos que regresan son similares en ese sentido. Para obtener más información sobre las tablas y los procedimientos almacenados, vaya a sus entradas correspondientes en este documento de ayuda.

Conector Jitterbit para Vistas Salesforce Pardot

Campañas

Recuperar y modificar campañas.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• Name admite '='.
• CreatedAt admite '=', '<', '<=', '>', '>='.
• UpdatedAt admite '=', '<', '<=', '>', '>='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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

ObtenerEliminado

Para recuperar campañas que están en la papelera de reciclaje en Pardot, se admite la siguiente operación:

GETDELETED FROM Campaings

Columnas

Campos Personalizados

Recupera metadatos de campos personalizados.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• CreatedAt admite '=', '<', '<=', '>', '>='.
• UpdatedAt admite '=', '<', '<=', '>', '>='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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

Columnas

Pseudo-Columnas

Los campos de pseudocolumna se utilizan en la cláusula WHERE de las declaraciones SELECT y ofrecen un control más granular sobre las tuplas que se devuelven desde la fuente de datos.

Correos

Consulte los correos para saber cómo respondieron los clientes potenciales a los correos.

Información Específica de la Tabla

Seleccionar

El conector utiliza la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• ProspectId admite '=', '<', '<=', '>', '>='.
• ListEmailId admite '=', '<', '<=', '>', '>='.
• SentAt admite '=', '<', '<=', '>', '>='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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

Columnas

Carpetas

Recupere carpetas u organice y anide su contenido y activos de marketing de una manera que tenga sentido para su equipo.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• ParentFolderId admite '=', '<', '<=', '>', '>='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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

Columnas

Formularios

Recupera formularios.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• IsDeleted admite '='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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

ObtenerEliminado

Para recuperar formularios que están en la papelera de reciclaje en Pardot, se admite la siguiente operación:

GETDELETED FROM Forms

Columnas

ListaCorreo Electrónico

Un correo de lista es un único correo enviado a una lista de destinatarios.

Información Específica de la Tabla

Seleccionar

El conector utiliza la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• IsDeleted admite '='.
• CreatedAt admite '=', '<', '<=', '>', '>='.
• UpdatedAt admite '=', '<', '<=', '>', '>='.
• SentAt admite '=', '<', '<=', '>', '>='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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

ObtenerEliminado

Para recuperar el correo de la lista que está en la papelera de reciclaje en Pardot, se admite la siguiente operación:

GETDELETED FROM ListEmail

Columnas

Cuentas de Prospectos

Recuperar y modificar cuentas de prospectos.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

SELECT * FROM ProspectAccounts WHERE ID > 31

Ser Eliminado

Para recuperar cuentas de prospectos eliminadas, se puede ejecutar una instrucción GETDELETED.

GETDELETED FROM ProspectAccounts

Columnas

Opciones de Respuesta

Consulta las opciones de repltyTo de las plantillas de correo.

Columnas

SenderOptions

Consulta las opciones de remitente de las plantillas de correo.

Columnas

TrackerDomains

Consulta los dominios de seguimiento disponibles.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• IsDeleted admite '='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

SELECT * FROM TrackerDomains WHERE ID = 50

ObtenerEliminado

Para recuperar registros eliminados, se puede ejecutar una instrucción GETDELETED.

GETDELETED FROM TrackerDomains

Columnas

Usuarios

Consultar los usuarios disponibles.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• IsDeleted admite '='.
• UpdatedAt admite '=', '<', '<=', '>', '>='.
• CreatedAt admite '=', '<', '<=', '>', '>='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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'

Ser Eliminado

Para recuperar usuarios eliminados, se puede ejecutar una instrucción GETDELETED.

GETDELETED FROM Users

Columnas

VisitantesPáginaVistas

Recuperar vistas de página de visitantes.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• VisitId admite '=', '<', '<=', '>', '>='.
• VisitorId admite '=', '<', '<=', '>', '>='.
• CreatedAt admite '=', '<', '<=', '>', '>='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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

Columnas

Visitas

Recuperar visitas.

Información Específica de la Tabla

Seleccionar

El conector utilizará la API de Salesforce Pardot para procesar las condiciones de la cláusula WHERE creadas con las siguientes columnas y operadores. El resto del filtro se ejecuta del lado del cliente dentro del conector.

• Id admite '=', '<', '<=', '>', '>='.
• VisitorId admite '=', '<', '<=', '>', '>='.
• ProspectId admite '=', '<', '<=', '>', '>='.
• CreatedAt admite '=', '<', '<=', '>', '>='.
• UpdatedAt admite '=', '<', '<=', '>', '>='.

Por ejemplo, las siguientes consultas se procesan en el lado del servidor:

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

Columnas

Procedimientos Almacenados

Procedimientos almacenados* están disponibles para complementar los datos disponibles del Modelo de datos. Puede ser necesario actualizar los datos disponibles desde una vista usando un procedimiento almacenado* porque los datos no proporcionan actualizaciones bidireccionales directas, similares a tablas. En estas situaciones, la recuperación de los datos se realiza utilizando la vista o tabla adecuada, mientras que la actualización se realiza llamando a un procedimiento almacenado. Procedimientos almacenados* toman una lista de parámetros y devuelven un conjunto de datos que contiene la colección de tuplas que constituyen la respuesta.

Jitterbit Connector para Procedimientos Almacenados de Salesforce Pardot

Obtener Token de Acceso de OAuth

Si usa una aplicación de Windows, establezca Authmode en App. Si usa una aplicación web, establezca Authmode en Web y especifique el Verificador obtenido por GetOAuthAuthorizationUrl.

Aporte

Columnas del Conjunto de Resultados

Obtener URL de Autorización de OAuth

Obtiene la URL de autorización que el usuario debe abrir por separado para otorgar acceso a su aplicación. Solo se necesita al desarrollar aplicaciones web.

Aporte

Columnas del Conjunto de Resultados

RefreshOAuthAccessToken

Actualiza el token de OAuth o el ID de sesión después de que la sesión haya expirado. Tu aplicación de OAuth debe tener activado el ámbito refresh_token.

Aporte

Columnas del Conjunto de Resultados

Tablas del Sistema

Puede consultar las tablas del sistema que se describen en esta sección para acceder a la información del esquema, la información sobre la funcionalidad del origen de datos y las estadísticas de operación lote.

Tablas de Esquema

Las siguientes tablas devuelven metadatos de la base de datos para Salesforce Pardot:

• sys_catalogs: enumera las bases de datos disponibles.
• sys_schemas: enumera los esquemas disponibles.
• sys_tablas: enumera las tablas y vistas disponibles.
• sys_tablecolumns: Describe las columnas de las tablas y vistas disponibles.
• procedimientos_sys: describe los procedimientos almacenados disponibles.
• parámetros_procedimiento_sys: Describe procedimiento almacenado* parámetros.
• sys_keycolumns: describe las claves principal y externa.
• índices_sys: Describe los índices disponibles.

Tablas de Fuentes de Datos

Las siguientes tablas devuelven información sobre cómo conectarse y consultar la fuente de datos:

• sys_connection_props: Devuelve información sobre las propiedades de conexión disponibles.
• sys_sqlinfo: describe las consultas SELECT que el conector puede descargar al origen de datos.

Tablas de Información de Consultas

La siguiente tabla devuelve estadísticas de consultar para consultas de modificación de datos:

• identidad_sys: devuelve información sobre operaciones lote o actualizaciones individuales.

Sys_catalogs

Enumera las bases de datos disponibles.

La siguiente consultar recupera todas las bases de datos determinadas por la cadena de conexión:

SELECT * FROM sys_catalogs

Columnas

Sys_schemas

Enumera los esquemas disponibles.

La siguiente consultar recupera todos los esquemas disponibles:

SELECT * FROM sys_schemas

Columnas

Sys_tables

Enumera las tablas disponibles.

La siguiente consultar recupera las tablas y vistas disponibles:

SELECT * FROM sys_tables

Columnas

Sys_tablecolumns