Detalhes da Conexão do Salesforce Pardot¶

Introdução¶

Versão do conector

Esta documentação é baseada na versão 21.0.8257 do conector.

Começando¶

Suporte à versão do Salesforce Pardot

O conector utiliza a API SalesforcePardot para permitir o acesso bidirecional ao SalesforcePardot. Suporta Pardot API v3 e v4.

Estabelecendo uma Conexão¶

Conectando ao Pardot¶

Conectando Usando OAuth2¶

Colocou o AuthScheme para OAuth para autenticar com este método.

ID da Unidade de Negócios Pardot¶

Para se conectar via OAuth2.0, você precisa obter o BusinessUnitId.

Para localizar a ID da unidade de negócios do Pardot, use Configuração no Salesforce.

• Em Configuração, insira "Configuração da conta do Pardot" na caixa Busca rápida.

O ID da unidade de negócios do Pardot começa com "0Uv" e tem 18 caracteres. Se você não conseguir acessar as informações de configuração da conta do Pardot, peça ao administrador do Salesforce para fornecer a ID da unidade de negócios do Pardot.

Você pode se conectar depois de definir as propriedades de conexão necessárias para suas credenciais de usuário e obter os tokens de acesso necessários usando uma ferramenta como o Postman.

Consulte Usando autenticação OAuth para obter um guia de autenticação e detalhes do fluxo de autenticação OAuth.

Usando Autenticação OAuth¶

OAuth requer o uso de tokens de acesso obtidos com Postman ou ferramenta similar. A autenticação OAuth é suportada conforme descrito em Conexão em Configurar conexões OAuth.

Anotações Importantes¶

Procedimentos Armazenados¶

• Os recursos de procedimentos armazenados descritos nesta documentação não são suportados no momento.
• Como os procedimentos armazenados não são suportados atualmente, qualquer recurso dependente de procedimentos armazenados também não é suportado atualmente.

Arquivos de Configuração e Seus Caminhos¶

• Todas as referências para adicionar arquivos de configuração e seus caminhos referem-se a arquivos e locais no Harmony Agente onde o conector está instalado. Esses caminhos devem ser ajustados conforme apropriado, dependendo do agente e do sistema operacional. Se vários agentes forem usados em um grupo de agentes, arquivos idênticos serão necessários em cada agente.

Características Avançadas¶

Esta seção detalha uma seleção de recursos avançados do conector Salesforce Pardot.

Visualizações definidas pelo usuário

O conector permite definir tabelas virtuais, denominadas visualizações definidas pelo usuário, cujo conteúdo é decidido por uma consultar pré-configurada. Essas exibições são úteis quando você não pode controlar diretamente as consultas enviadas aos drivers. Consulte Visualizações definidas pelo usuário para obter uma visão geral da criação e configuração de exibições personalizadas.

Configuração SSL

Use Configuração SSL para ajustar como o conector lida com as negociações de certificado TLS/SSL. Você pode escolher entre vários formatos de certificado; Veja o SSLServerCert propriedade em "Opções de cadeia de conexão" para obter mais informações.

Procurador

Para configurar o conector usando configurações de proxy do Agente Privado, selecione os Use Proxy Settings caixa de seleção na tela de configuração da conexão.

Visualizações Definidas pelo Usuário¶

O Jitterbit Connector for Salesforce Pardot permite definir uma tabela virtual cujo conteúdo é decidido por uma consultar pré-configurada. Elas são chamadas de Visualizações Definidas pelo Usuário, que são úteis em situações onde você não pode controlar diretamente a consultar que está sendo emitida para o driver, por exemplo, ao usar o driver do Jitterbit. As Visualizações Definidas pelo Usuário podem ser usadas para definir predicados que são sempre aplicados. Se você especificar predicados adicionais na consultar para a visualização, eles serão combinados com a consultar já definida como parte da visualização.

Há duas maneiras de criar exibições definidas pelo usuário:

• Crie um arquivo de configuração em formato JSON definindo as visualizações desejadas.
• declarações DDL.

Definindo Visualizações Usando um Arquivo de Configuração¶

As visualizações definidas pelo usuário são definidas em um arquivo de configuração formatado em JSON chamado UserDefinedViews.json. O conector detecta automaticamente as visualizações especificadas neste arquivo.

Você também pode ter várias definições de exibição e controlá-las usando o UserDefinedViews propriedade de conexão. Quando você usa essa propriedade, apenas as exibições especificadas são vistas pelo conector.

Este arquivo de configuração de exibição definida pelo usuário é formatado da seguinte forma:

• Cada elemento raiz define o nome de uma visualização.
• Cada elemento raiz contém um elemento filho, chamado query, que contém a consultar SQL personalizada para a exibição.

Por exemplo:

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

Use o UserDefinedViews propriedade de conexão para especificar a localização do seu arquivo de configuração JSON. Por exemplo:

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

Esquema para Exibições Definidas pelo Usuário¶

As visualizações definidas pelo usuário são expostas no UserViews esquema por padrão. Isso é feito para evitar que o nome da exibição entre em conflito com uma entidade real no modelo de dados. Você pode alterar o nome do esquema usado para UserViews definindo o UserViewsSchemaName propriedade.

Trabalhando com Exibições Definidas pelo Usuário¶

Por exemplo, uma instrução SQL com uma Visualização Definida pelo Usuário chamada UserViews.RCustomers lista apenas clientes em Raleigh:

SELECT * FROM Customers WHERE City = 'Raleigh';

Exemplo de consultar ao driver:

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

Resultando na consultar efetiva à fonte:

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

Esse é um exemplo muito simples de uma consultar a uma exibição definida pelo usuário que é efetivamente uma combinação da consultar de exibição e da definição de exibição. É possível compor essas consultas em padrões muito mais complexos. Todas as operações SQL são permitidas em ambas as consultas e são combinadas quando apropriado.

Configuração SSL¶

Personalizando a Configuração SSL¶

Por padrão, o conector tenta negociar SSL/TLS verificando o certificado do servidor em relação ao armazenamento de certificados confiáveis do sistema.

Para especificar outro certificado, consulte o SSLServerCert propriedade para os formatos disponíveis para fazê-lo.

Modelo de Dados¶

Visão geral

Esta seção mostra os objetos de API disponíveis e fornece mais informações sobre como executar SQL para APIs do Salesforce Pardot.

Características principais

• O conector modela entidades do Salesforce Pardot como documentos, pastas e grupos como exibições relacionais, permitindo que você escreva SQL para consultar dados do Salesforce Pardot.
• Procedimentos armazenados* permitem que você execute operações no Salesforce Pardot, incluindo recuperar o token de acesso e mantê-lo atualizado no OAuth 2.0.
• A conectividade ao vivo com esses objetos significa que quaisquer alterações em sua conta do Salesforce Pardot são refletidas imediatamente ao usar o conector.

Processamento de consulta colaborativa

O conector transfere o máximo possível do processamento da instrução SELECT para o Salesforce Pardot e processa o restante da consultar na memória. As limitações e requisitos da API também estão documentados nesta seção.

Ver SupportEnhancedSQL para obter mais informações sobre como o conector contorna as limitações da API com processamento na memória do lado do cliente.

Modelo de Dados do Salesforce Pardot V3 e V4¶

O Conector Jitterbit para Salesforce Pardot modela entidades Salesforce Pardot como tabelas relacionais, exibições e procedimentos armazenados. As limitações e requisitos da API estão documentados nesta seção; você pode usar o SupportEnhancedSQL recurso, definido por padrão, para contornar a maioria dessas limitações.

Tabelas¶

O conector modela os dados no Salesforce Pardot em uma lista de tabelas que podem ser consultadas usando instruções SQL padrão.

Geralmente, consultar tabelas do Salesforce Pardot é o mesmo que consultar uma tabela em um banco de dados relacional. Às vezes, há casos especiais, por exemplo, incluir uma determinada coluna na cláusula WHERE pode ser necessário para obter dados para determinadas colunas na tabela. Isso geralmente é necessário para situações em que uma solicitação separada deve ser feita para cada linha para obter determinadas colunas. Esses tipos de situações estão claramente documentados na parte superior da página da tabela vinculada abaixo.

Conector Jitterbit para Tabelas Salesforce Pardot¶

Campanhas¶

Recupere e modifique campanhas.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com a coluna e o operador a seguir. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

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

Inserir¶

Esta tabela não possui nenhum atributo necessário ao executar uma inserção.

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Os Campos Personalizados¶

Recupere e modifique campos personalizados.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com a coluna e o operador a seguir. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

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

Inserir¶

Os seguintes atributos são necessários ao realizar uma inserção: FieldId, Name.

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

Colunas¶

Listar Associações¶

Recupere e modifique membros da lista.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com a coluna e o operador a seguir. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

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

Inserir¶

Os seguintes atributos são necessários ao executar uma inserção: ListId, ProspectId.

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

Ser Deletado¶

Para recuperar registros excluídos, uma instrução GETDELETED pode ser executada. A instrução GETDELETED suporta os mesmos filtros do lado do servidor que são suportados pela instrução SELECT (exceto ID ao usar o operador de igualdade(=)), mas não executa nenhuma filtragem do lado do cliente.

GETDELETED FROM ListMemberships WHERE ID = 231

Colunas¶

Listas¶

Recupere e modifique listas.

Colunas¶

Oportunidades¶

Recuperar e modificar oportunidades.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com a coluna e o operador a seguir. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

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

Inserir¶

Os seguintes atributos são necessários ao executar uma inserção: CampaignId, Nome, Valor, Probabilidade, ProspectEmail, ProspectId.

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

Observação: esta tabela não pode ser atualizada se um conector Salesforce estiver presente.

Colunas¶

Contas em Potencial¶

Recupere e modifique contas de clientes em potencial.

Colunas¶

Perspectivas¶

Recupere e modifique clientes em potencial.

Colunas¶

Visualizações¶

As exibições são compostas por colunas e pseudocolunas. As exibições são semelhantes às tabelas na forma como os dados são representados; no entanto, as exibições não oferecem suporte a atualizações. Entidades que são representadas como exibições são normalmente entidades somente leitura. Frequentemente, um procedimento armazenado* está disponível para atualizar os dados se tal funcionalidade for aplicável à fonte de dados.

As consultas podem ser executadas em uma exibição como se fosse uma tabela normal, e os dados retornados são semelhantes nesse aspecto. Para saber mais sobre tabelas e procedimentos armazenados, navegue até as entradas correspondentes neste documento de ajuda.

Conector Jitterbit para Exibições do Salesforce Pardot¶

Conta¶

Recuperar informações da conta.

Informações Específicas da Tabela¶

Selecione¶

O conector processará todos os filtros do lado do cliente.

Colunas¶

CustomRedirects¶

Recupere e modifique redirecionamentos personalizados.

Colunas¶

Conteúdo Dinâmico¶

Recupere conteúdos dinâmicos.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com a coluna e o operador a seguir. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do 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'

Colunas¶

Cliques de E-mail¶

Recupere cliques e-mail.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com a coluna e o operador a seguir. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do 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'

Colunas¶

E-mails¶

Recuperar e-mails.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com a coluna e o operador a seguir. O restante do filtro é executado no lado do cliente dentro do conector.

• Id suporta '='.

Por exemplo, a seguinte consultar é processada no lado do servidor:

SELECT * FROM Emails WHERE ID = 10

Colunas¶

Estatísticas de E-mail¶

Recupere estatísticas e-mail.

Informações Específicas da Tabela¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com a coluna e o operador a seguir. Para consultar esta tabela, você precisa especificar o Id. O restante do filtro é executado no lado do cliente dentro do conector.

• Id suporta '='.

Por exemplo, a seguinte consultar é processada no lado do servidor:

SELECT * FROM EmailStats WHERE ID = 10

Colunas¶

Modelos de E-mail¶

Recupere modelos e-mail.

Informações Específicas da Tabela¶

Selecione¶

Por padrão, apenas modelos conectados a OneToOneEmails serão retornados.

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com a coluna e o operador a seguir. O restante do filtro é executado no lado do cliente dentro do conector.

• Id suporta '='.

Por exemplo, as seguintes consultas são processadas no lado do servidor:

SELECT * FROM EmailTemplates WHERE ID = 22

Colunas¶

Formulários¶

Recuperar formulários.

Colunas¶

Histórias de Ciclo de Vida¶

Recupere históricos de ciclo de vida.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com a coluna e o operador a seguir. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

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

Colunas¶

Estágios do Ciclo de Vida¶

Recupere os estágios do ciclo de vida.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com a coluna e o operador a seguir. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

SELECT * FROM LifecycleStages WHERE ID = 18

Colunas¶

OneToOneE-mails¶

Recupere e e-mails um a um.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com a coluna e o operador a seguir. O restante do filtro é executado no lado do cliente dentro do conector.

• Id suporta '='.

Por exemplo, as seguintes consultas são processadas no lado do servidor:

SELECT * FROM OneToOneEmails WHERE ID = 11

Colunas¶

TagObjects¶

Recupere objetos de marca.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com a coluna e o operador a seguir. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

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

Colunas¶

Tag¶

Recuperar etiquetas.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com a coluna e o operador a seguir. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

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

Colunas¶

Usuários¶

Recupere usuários.

Colunas¶

VisitanteAtividades¶

Recupere as atividades dos visitantes.

Colunas¶

Visitantes¶

Recupere visitantes.

Colunas¶

VisitorPageViews¶

Recupere visualizações de página dos visitantes.

Colunas¶

Visitas¶

Recuperar visitas.

Colunas¶

Procedimentos Armazenados¶

Procedimentos armazenados* estão disponíveis para complementar os dados disponíveis no Modelo de Dados. Pode ser necessário atualizar os dados disponíveis em uma exibição usando um procedimento armazenado* porque os dados não fornecem atualizações bidirecionais diretas, semelhantes a tabelas. Nessas situações, a recuperação dos dados é feita usando a visualização ou tabela apropriada, enquanto a atualização é feita chamando um procedimento armazenado. Procedimentos armazenados* pega uma lista de parâmetros e retorna um conjunto de dados que contém a coleção de tuplas que constituem a resposta.

Conector Jitterbit para Procedimentos Armazenados do Salesforce Pardot¶

Atribuir Prospecto¶

Atualize os locais de uma zona de frete.

Executar¶

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

Entrada

Colunas do conjunto de resultados

Atribuir Conta de Cliente Potencial¶

Atualize os locais de uma zona de frete.

Executar¶

EXEC AssignProspectAccount UserId=432, ProspectAccountId=501

Entrada

Colunas do conjunto de resultados

GetOAuthAccessToken¶

Se estiver usando um aplicativo do Windows, defina Authmode como App. Se estiver usando um aplicativo Web, defina Authmode como Web e especifique o Verifier obtido por GetOAuthAuthorizationUrl.

Entrada¶

Colunas do Conjunto de Resultados¶

GetOAuthAuthorizationUrl¶

Obtém a URL de autorização que deve ser aberta separadamente pelo usuário para conceder acesso ao seu aplicativo. Necessário apenas ao desenvolver aplicativos da Web.

Entrada¶

Colunas do Conjunto de Resultados¶

RefreshOAuthAccessToken¶

Atualiza o token OAuth ou o ID da sessão após a expiração da sessão. Seu aplicativo OAuth deve ter o escopo refresh_token ativado.

Entrada¶

Colunas do Conjunto de Resultados¶

Enviar Email¶

Atualize os locais de uma zona de frete.

Executar¶

Este procedimento requer qualquer uma das seguintes combinações de entrada:

Um de: ProspectId, ProspectEmail ou ListId. Um de: TemplateId ou (TextContent, Name, Subject e (FromEmail, FromName ou FromUserId)) Exemplos:

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'

Entrada

Colunas do conjunto de resultados

Cancelar Atribuição do Projeto¶

Atualize os locais de uma zona de frete.

Executar¶

EXEC UnAssignProspect ProspectId=432

Entrada

Colunas do conjunto de resultados

UnDeleteOpportunity¶

Atualize os locais de uma zona de frete.

Executar¶

EXEC UnDeleteOpportunity Id=600

Entrada

Colunas do conjunto de resultados

Modelo de Dados do Salesforce Pardot V5¶

O Conector Jitterbit para Salesforce Pardot modela objetos Salesforce Pardot Pardot API v5 como tabelas relacionais, exibições e procedimentos armazenados. As limitações e requisitos da API estão documentados nesta seção; você pode usar o SupportEnhancedSQL recurso, definido por padrão, para contornar a maioria dessas limitações.

Tabelas¶

Tabelas descreve uma amostra das tabelas padrão disponíveis.

Tabelas¶

O conector modela os dados no Salesforce Pardot em uma lista de tabelas que podem ser consultadas usando instruções SQL padrão.

Geralmente, consultar tabelas do Salesforce Pardot é o mesmo que consultar uma tabela em um banco de dados relacional. Às vezes, há casos especiais, por exemplo, incluir uma determinada coluna na cláusula WHERE pode ser necessário para obter dados para determinadas colunas na tabela. Isso geralmente é necessário para situações em que uma solicitação separada deve ser feita para cada linha para obter determinadas colunas. Esses tipos de situações estão claramente documentados na parte superior da página da tabela vinculada abaixo.

Conector Jitterbit para Tabelas Salesforce Pardot¶

CustomRedirects¶

Rastreie links em seu site ou site de externo com redirecionamentos personalizados do Pardot.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

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

Inserir¶

Os seguintes atributos são necessários ao executar uma inserção: Name, CampaignId, DestinationUrl.

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

Atualizar¶

Atualize os atributos CustomRedirects.

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

Excluir

Remova todos os objetos CustomRedirects ou um especificando o ID do CustomRedirect.

DELETE FROM CustomRedirects

DELETE FROM CustomRedirects WHERE ID = 10003

GetDeleted¶

Para recuperar redirecionamentos personalizados que estão na lixeira do Pardot, a seguinte operação é suportada:

GETDELETED FROM CustomRedirects 

Colunas¶

Modelos de E-mail¶

Modelos e-mail de consulta.

Informações Específicas da Tabela¶

Selecione¶

O conector usa a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

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

Para inserir em uma tabela, é necessário especificar o SenderOptionsAggregate. A entrada para este campo segue os princípios de Deep Inserts. No Deep Insert, você cria simultaneamente um objeto base e o vincula ao campo relacionado na tabela principal. Para enviar dados JSON, forneça os valores para a tabela filha no formato JSON. Para executar a inserção, o JSON completo pode ser referenciado ou incluído como strings literais. Por exemplo:

GetDeleted¶

Para recuperar modelos e-mail que estão na lixeira do Pardot, a seguinte operação é suportada:

GETDELETED FROM EmailTemplates

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

Arquivos¶

Carregue imagens e outros arquivos para usar em seus e-mails, formulários e páginas de destino do Pardot.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do 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'

Inserir¶

Os seguintes atributos são necessários ao executar uma inserção: Name, FilePath.

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

Atualizar¶

Atualizando arquivos:

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

Excluir

Remova todos os arquivos ou um arquivo especificando o ID do arquivo.

DELETE FROM Files

DELETE FROM Files WHERE ID = 10003

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

LayoutTemplates¶

Recupere e modifique modelos de layout.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

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

Inserir¶

Os seguintes atributos são necessários ao realizar uma inserção: Name, LayoutContent.

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

Atualizar¶

Atualizando LayoutTemplates:

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

Excluir

Remova todos os modelos de layout ou um modelo de layout especificando o ID do modelo.

DELETE FROM LayoutTemplates

DELETE FROM LayoutTemplates WHERE ID = 10003

GetDeleted¶

Para recuperar modelos de layout que estão na lixeira no Pardot, a seguinte operação é suportada:

GETDELETED FROM LayoutTemplates 

Colunas¶

Listas¶

Recupere e modifique listas.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

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

Inserir¶

O seguinte atributo é necessário ao realizar uma inserção: Nome.

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

Atualizar¶

Atualizar atributos de listas.

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

Excluir

Remova todas as listas ou uma lista especificando o ID da lista.

DELETE FROM Lists

DELETE FROM Lists WHERE ID = 10003

GetDeleted¶

Para recuperar listas que estão na lixeira no Pardot, a seguinte operação é suportada:

GETDELETED FROM Lists

Colunas¶

Perspectivas¶

Recupere e modifique clientes em potencial.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do 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 Deletado¶

Para recuperar clientes em potencial excluídos, uma instrução GETDELETED pode ser executada.

GETDELETED FROM Prospects

Colunas¶

Visualizações¶

As exibições são compostas por colunas e pseudocolunas. As exibições são semelhantes às tabelas na forma como os dados são representados; no entanto, as exibições não oferecem suporte a atualizações. Entidades que são representadas como exibições são normalmente entidades somente leitura. Frequentemente, um procedimento armazenado* está disponível para atualizar os dados se tal funcionalidade for aplicável à fonte de dados.

As consultas podem ser executadas em uma exibição como se fosse uma tabela normal, e os dados retornados são semelhantes nesse aspecto. Para saber mais sobre tabelas e procedimentos armazenados, navegue até as entradas correspondentes neste documento de ajuda.

Conector Jitterbit para Exibições do Salesforce Pardot¶

Campanhas¶

Recupere e modifique campanhas.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

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

GetDeleted¶

Para recuperar campanhas que estão na lixeira no Pardot, a seguinte operação é suportada:

GETDELETED FROM Campaings

Colunas¶

Os Campos Personalizados¶

Recupere metadados de campos personalizados.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

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

Colunas¶

Pseudo-colunas¶

Os campos de pseudocoluna são usados na cláusula WHERE das instruções SELECT e oferecem um controle mais granular sobre as tuplas que são retornadas da fonte de dados.

E-mails¶

Consulte e-mails para saber como os clientes em potencial responderam aos e-mails.

Informações Específicas da Tabela¶

Selecione¶

O conector usa a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

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

Colunas¶

Pastas¶

Recupere pastas ou organize e aninhe seu conteúdo e ativos de marketing de uma forma que faça sentido para sua equipe.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

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

Colunas¶

Formulários¶

Recuperar formulários.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

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

GetDeleted¶

Para recuperar formulários que estão na lixeira no Pardot, a seguinte operação é suportada:

GETDELETED FROM Forms 

Colunas¶

ListaEmail¶

Um e-mail de lista é um único e-mail enviado para uma lista de destinatários.

Informações Específicas da Tabela¶

Selecione¶

O conector usa a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

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

GetDeleted¶

Para recuperar e-mail de lista que estão na lixeira no Pardot, a seguinte operação é suportada:

GETDELETED FROM ListEmail

Colunas¶

Contas em Potencial¶

Recupere e modifique contas de clientes em potencial.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

SELECT * FROM ProspectAccounts WHERE ID > 31

Ser Deletado¶

Para recuperar contas de prospects excluídas, uma instrução GETDELETED pode ser executada.

GETDELETED FROM ProspectAccounts

Colunas¶

ReplyToOptions¶

Consulte as opções repltyTo dos modelos e-mail.

Colunas¶

SenderOptions¶

Consulte as opções do remetente dos modelos e-mail.

Colunas¶

TrackerDomains¶

Consulte os domínios do rastreador disponíveis.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

SELECT * FROM TrackerDomains WHERE ID = 50

GetDeleted¶

Para recuperar registros excluídos, uma instrução GETDELETED pode ser executada.

GETDELETED FROM TrackerDomains 

Colunas¶

Usuários¶

Consulte os usuários disponíveis.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do 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 Deletado¶

Para recuperar usuários excluídos, uma instrução GETDELETED pode ser executada.

GETDELETED FROM Users

Colunas¶

VisitorPageViews¶

Recupere visualizações de página dos visitantes.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

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

Colunas¶

Visitas¶

Recuperar visitas.

Informações Específicas da Tabela¶

Selecione¶

O conector usará a API do Salesforce Pardot para processar as condições da cláusula WHERE criadas com as seguintes colunas e operadores. O restante do filtro é executado no lado do cliente dentro do conector.

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

Por exemplo, as seguintes consultas são processadas no lado do servidor:

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

Colunas¶

Procedimentos Armazenados¶

Procedimentos armazenados* estão disponíveis para complementar os dados disponíveis no Modelo de Dados. Pode ser necessário atualizar os dados disponíveis em uma exibição usando um procedimento armazenado* porque os dados não fornecem atualizações bidirecionais diretas, semelhantes a tabelas. Nessas situações, a recuperação dos dados é feita usando a visualização ou tabela apropriada, enquanto a atualização é feita chamando um procedimento armazenado. Procedimentos armazenados* pega uma lista de parâmetros e retorna um conjunto de dados que contém a coleção de tuplas que constituem a resposta.

Conector Jitterbit para Procedimentos Armazenados do Salesforce Pardot¶

GetOAuthAccessToken¶

Se estiver usando um aplicativo do Windows, defina Authmode como App. Se estiver usando um aplicativo Web, defina Authmode como Web e especifique o Verifier obtido por GetOAuthAuthorizationUrl.

Entrada¶

Colunas do Conjunto de Resultados¶

GetOAuthAuthorizationUrl¶

Obtém a URL de autorização que deve ser aberta separadamente pelo usuário para conceder acesso ao seu aplicativo. Necessário apenas ao desenvolver aplicativos da Web.

Entrada¶

Colunas do Conjunto de Resultados¶

RefreshOAuthAccessToken¶

Atualiza o token OAuth ou o ID da sessão após a expiração da sessão. Seu aplicativo OAuth deve ter o escopo refresh_token ativado.

Entrada¶

Colunas do Conjunto de Resultados¶

Tabelas do Sistema¶

Você pode consultar as tabelas do sistema descritas nesta seção para acessar informações de esquema, informações sobre a funcionalidade da fonte de dados e estatísticas de operação em lote.

Tabelas de Esquema¶

As tabelas a seguir retornam metadados de banco de dados para o Salesforce Pardot:

• sys_catalogs: Lista os bancos de dados disponíveis.
• sys_schemas: Lista os esquemas disponíveis.
• sys_tables: Lista as tabelas e exibições disponíveis.
• sys_tablecolumns: Descreve as colunas das tabelas e exibições disponíveis.
• sys_procedures: Descreve os procedimentos armazenados disponíveis.
• sys_procedureparameters: Descreve procedimento armazenado* parâmetros.
• sys_keycolumns: Descreve as chaves primárias e estrangeiras.
• sys_indexes: Descreve os índices disponíveis.

Tabelas de Fonte de Dados¶

As tabelas a seguir retornam informações sobre como se conectar e consultar a fonte de dados:

• sys_connection_props: Retorna informações sobre as propriedades de conexão disponíveis.
• sys_sqlinfo: Descreve as consultas SELECT que o conector pode descarregar para a fonte de dados.

Consultar Tabelas de Informações¶

A tabela a seguir retorna estatísticas de consultar para consultas de modificação de dados:

• sys_identity: Retorna informações sobre operações em lote ou atualizações únicas.

Sys_catalogs¶

Lista os bancos de dados disponíveis.

A consultar a seguir recupera todos os bancos de dados determinados pela string de conexão:

SELECT * FROM sys_catalogs

Colunas¶

Sys_schemas¶

Lista os esquemas disponíveis.

A consultar a seguir recupera todos os esquemas disponíveis:

SELECT * FROM sys_schemas

Colunas¶

Sys_tables¶

Lista as tabelas disponíveis.

A consultar a seguir recupera as tabelas e exibições disponíveis:

SELECT * FROM sys_tables

Colunas¶

Sys_tablecolumns¶