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¶