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