Detalhes da Conexão do Salesforce Marketing Cloud

Introdução

Versão do conector

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

Começando

Suporte à versão do Salesforce Marketing Cloud

Estabelecendo uma Conexão

Autenticação para a API REST do Salesforce Marketing Cloud

Para conectar, defina Schema descansar". A API REST do Salesforce Marketing Cloud usa o padrão de autenticação OAuth. Para autenticar usando OAuth, você precisará criar um aplicativo para obter o OAuthClientId e OAuthClientSecret propriedades de conexão. Consulte Usando autenticação OAuth para obter um guia de autenticação.

Autenticação para a API SOAP do Salesforce Marketing Cloud

A API SOAP do Salesforce Marketing Cloud pode se conectar usando suas credenciais de login ou usando autenticação OAuth.

Para se conectar aos dados usando a autenticação básica (credenciais de login), defina o seguinte:

• User: A conta de usuário do Salesforce Marketing Cloud usada para autenticação.
• Password: A senha utilizada para autenticar o usuário.
• AuthScheme: Defina como Básico.
• UseLegacyAuthentication: Defina como Verdadeiro.

às suas credenciais de login.

Conectando-se às APIs do Salesforce Marketing Cloud

Depois de se autenticar na API SOAP ou REST, você estará pronto para se conectar aos dados.

Você pode, opcionalmente, refinar o acesso aos dados usando as seguintes propriedades:

• Instance: A instância da API do Salesforce Marketing Cloud usada. A instância padrão é s7 da API de serviços da Web; no entanto, você pode usar essa propriedade para especificar uma instância diferente.

Usando Autenticação OAuth

OAuth requer que o usuário autenticado interaja com o Salesforce Marketing Cloud usando o navegador. O conector facilita isso de várias maneiras, conforme descrito abaixo.

Credenciais Personalizadas

Você precisará registrar um aplicativo para obter o OAuthClientId e OAuthClientSecret.

Criando um Aplicativo OAuth Personalizado

Consulte Criando um aplicativo OAuth personalizado para o procedimento.

Credenciais Personalizadas

Autenticação de Área de Trabalho com Seu Aplicativo OAuth

Siga as etapas abaixo para autenticar com as credenciais de um aplicativo OAuth personalizado. Consulte Criando um aplicativo OAuth personalizado.

Obtenha um Token de Acesso OAuth

Depois de definir o seguinte, você está pronto para se conectar:

• OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o segredo do cliente nas configurações do aplicativo.
• APIIntegrationType: Defina isso como Web-App ou Server-to-Server, dependendo de qual você selecionou ao criar seu aplicativo.
• OAuthGrantType: Alternativamente, em vez de definir APIIntegrationType, o OAuthGrantType pode ser configurado diretamente para Code (Web-App) ou Client (Server-to-Server). Pode ser desejável usar OAuthGrantType nos casos em que vários produtos estão sendo usados para manter as coisas consistentes.
• CallbackURL: Defina isso para o URL de redirecionamento nas configurações do aplicativo.
• InitiateOAuth: Defina como GETANDREFRESH. Você pode usar InitiateOAuth para evitar repetir a troca de OAuth e configurar manualmente o OAuthAccessToken..
• AccountId: Defina isso para o MID específico da unidade de negócios de destino. Isso não está disponível para pacotes legados.

Quando você conecta, o conector abre o endpoint OAuth em seu navegador padrão. Faça login e conceda permissões ao aplicativo. O conector então conclui o processo OAuth:

1. Extrai o token de acesso do URL de retorno de chamada e autentica as solicitações.
2. Obtém um novo token de acesso quando o antigo expira.
3. Salva valores OAuth em OAuthSettingsLocation para ser persistido nas conexões.

Máquinas Sem Cabeça

Usando OAuth em uma Máquina Sem Cabeça

Para criar fontes de dados do Salesforce Marketing Cloud em servidores headless ou outras máquinas nas quais o conector não pode abrir um navegador, você precisa autenticar de outra máquina. A autenticação é um processo de duas etapas.

1. Ao invés de instalar o conector em outra máquina, você pode seguir os passos abaixo para obter o OAuthVerifier valor. Ou você pode instalar o conector em outra máquina e transferir os valores de autenticação OAuth, depois de autenticar por meio do fluxo normal baseado em navegador.
2. Em seguida, você pode configurar o conector para atualizar automaticamente o token de acesso da máquina sem periféricos.

Usando as Credenciais para um Aplicativo OAuth Personalizado

Crie um aplicativo OAuth personalizado

Consulte Criando um aplicativo OAuth personalizado para um procedimento. Você pode seguir os procedimentos abaixo para autenticar e conectar-se aos dados.

Obtenha um código verificador

Defina as seguintes propriedades na máquina sem periféricos:

• InitiateOAuth: Defina como DESLIGADO.
• OAuthClientId: Defina isso como o ID do aplicativo nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o Segredo do aplicativo nas configurações do aplicativo.
• AccountId: Defina isso para o MID específico da unidade de negócios de destino. Isso não está disponível para pacotes legados.

Você pode seguir as etapas abaixo para autenticar em outra máquina e obter o OAuthVerifier propriedade de conexão.

1. Chame o GetOAuthAuthorizationURL procedimento armazenado* com o parâmetro de entrada CallbackURL definido para o URI de redirecionamento exato que você especificou nas configurações do aplicativo.
2. Abra o URL retornado em um navegador. Faça login e conceda permissões ao conector. Você será redirecionado para o URL de retorno de chamada, que contém o código do verificador.
3. Salve o valor do código do verificador. Você definirá isso no OAuthVerifier propriedade de conexão.

Na máquina sem periféricos, defina as seguintes propriedades de conexão para obter os valores de autenticação OAuth:

• OAuthClientId: Defina isso como a chave do consumidor nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o segredo do consumidor nas configurações do aplicativo.
• OAuthVerifier: Defina isso para o código do verificador.
• OAuthSettingsLocation: Defina para manter os valores de autenticação OAuth criptografados no arquivo especificado.
• InitiateOAuth: Configure para ATUALIZAR.
• AccountId: Defina isso para o MID específico da unidade de negócios de destino. Isso não está disponível para pacotes legados.

Conecte-se aos dados

Depois que o arquivo de configurações OAuth for gerado, defina as seguintes propriedades para se conectar aos dados:

• OAuthSettingsLocation: Defina isso para o arquivo que contém os valores de autenticação OAuth criptografados. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao provedor para ativar a atualização automática do token de acesso.
• InitiateOAuth: Defina como REFRESH.
• AccountId: Defina isso para o MID específico da unidade de negócios de destino. Isso não está disponível para pacotes legados.

Configurações de transferência OAuth

Siga as etapas abaixo para instalar o conector em outra máquina, autenticar e depois transferir os valores OAuth resultantes.

Em uma segunda máquina, instale o conector e conecte-se com o seguinte conjunto de propriedades:

• OAuthSettingsLocation: Defina isso como um arquivo de texto gravável.
• InitiateOAuth: Defina como GETANDREFRESH.
• OAuthClientId: Defina isso como o ID do cliente nas configurações do aplicativo.
• OAuthClientSecret: Defina isso como o segredo do cliente nas configurações do aplicativo.
• CallbackURL: Defina isso para o URL de retorno de chamada nas configurações do aplicativo.
• AccountId: Defina isso para o MID específico da unidade de negócios de destino. Isso não está disponível para pacotes legados.

Teste a conexão para autenticar. Os valores de autenticação resultantes são gravados, criptografados, no caminho especificado por OAuthSettingsLocation. Depois de testar a conexão com sucesso, copie o arquivo de configurações OAuth para sua máquina sem periféricos. Na máquina sem periféricos, defina as seguintes propriedades de conexão para se conectar aos dados:

• InitiateOAuth: Configure para ATUALIZAR.
• OAuthSettingsLocation: Defina isso como o caminho para o arquivo de configurações OAuth. Certifique-se de que este arquivo forneça permissões de leitura e gravação ao conector para habilitar a atualização automática do token de acesso.
• AccountId: Defina isso para o MID específico da unidade de negócios de destino. Isso não está disponível para pacotes legados.

Criando um Aplicativo OAuth Personalizado

Criar um Aplicativo

Você pode seguir o procedimento abaixo para registrar um aplicativo e obter as credenciais do cliente OAuth, o Client ID e o Client Secret:

1. Faça login no Salesforce Marketing Cloud Vá para Marketing Cloud | Administração | Pacotes instalados.
2. Clique em New.
3. Dê um nome e uma descrição ao pacote.
4. Salve o pacote. Depois que o pacote é salvo, você vê detalhes importantes sobre o pacote. Consulte Definições de Pacotes Instalados para obter mais informações sobre cada campo. Você vê o ID do pacote, o segredo de assinatura JWT e a conta de origem apenas para pacotes criados em sua conta.
5. Em Componentes, clique em Add Component.
6. Selecione API Integration.
7. Você deve selecionar Server-to-Server ou Web App como tipo de integração se o pacote suportar funcionalidade aprimorada.
8. Atribua o escopo apropriado para sua integração.
   • Perform server-to-server requests... é selecionado automaticamente para todas as integrações de API.
   • Selecione Perform requests on behalf of the user... se este pacote contiver um aplicativo Marketing Cloud.
   • Selecione o escopo do Marketing Cloud para suas chamadas de API. Atribua apenas o escopo que seu pacote precisa.
9. Salve o componente.
10. Nos detalhes do componente, você pode encontrar o Client ID e Client Secret.

Seleção de Extensões de Dados no SalesforceMarketingCloud

O conector oferece a possibilidade de selecionar, inserir, atualizar e excluir dados de extensões de dados como tabelas relacionais. Para consultar uma extensão de dados, basta inserir seu nome no formato DataExtensionObject_Name, em que Name é o nome de sua extensão de dados.

Selecionando Dados de Extensões de Dados

SELECT * FROM DataExtensionObject_fsefes3

SELECT * FROM DataExtensionObject_fsefes3 WHERE FieldName1 = 'One'

Observação 1: Todos os filtros que funcionam com tabelas/exibições normais também funcionam com extensões de dados.

Observação 2: se sua conta do Salesforce Marketing Cloud contiver mais de uma unidade de negócios, a entrada ClientID deverá ser especificada. Você pode usar ponto e vírgula (;) para especificar mais de um ClientID.

SELECT * FROM DataExtensionObject_fsefes3 WHERE ClientID = '1234567'

Inserindo Dados em Extensões de Dados

INSERT INTO DataExtensionObject_fsefes3(FieldName1, FieldName2, FieldName3) VALUES ('One', 'Two', 'Three')

Atualizando Dados de Extensões de Dados

UPDATE DataExtensionObject_secondtest15 SET [Nome] = 'ChangedFromTheApi' WHERE [Endereço E-mail] = 'update_me@gmail.com'

Observação: deve existir uma chave primária para esta extensão de dados para que a atualização funcione.

Excluindo Dados de Extensões de Dados

DELETE FROM DataExtensionObject_secondtest15 WHERE [Endereço E-mail] = 'delete_me@gmail.com'

Observação: deve existir uma chave primária para esta extensão de dados para que a exclusão funcione.

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 Marketing Cloud.

Visualizações definidas pelo usuário

O conector permite definir tabelas virtuais, denominadas visõ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 para Salesforce Marketing Cloud 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 visualização.

Por exemplo:

{
    "MyView": {
        "query": "SELECT * FROM Subscriber 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

O Conector Jitterbit para Salesforce Marketing Cloud modela duas APIs Salesforce Marketing Cloud como bancos de dados relacionais, a API REST e a API SOAP. Colocou o Schema e use as informações em cada seção para selecionar a API adequada com base nas necessidades do seu projeto.

Processamento de consulta colaborativa

O conector transfere o máximo possível do processamento da instrução SELECT para as APIs do Salesforce Marketing Cloud e, em seguida, processa o restante da consultar no conector.

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.

Usando a API REST

A API REST oferece acesso mais amplo aos recursos do Salesforce Marketing Cloud. Todas as novas tecnologias do Salesforce Marketing Cloud implementam a API REST. Consulte Modelo de dados REST para as entidades disponíveis na API REST.

Usando a API SOAP

A API SOAP fornece acesso abrangente à maioria das funcionalidades e-mail. A API SOAP usa envelopes SOAP para passar informações entre você e o Salesforce Marketing Cloud. Consulte Modelo de dados SOAP para as entidades disponíveis na API SOAP.

Modelo de Dados REST

O conector modela as APIs REST do Salesforce Marketing Cloud como banco de dados Tabelas e Procedimentos Armazenados. Eles são definidos em arquivos de esquema, que são arquivos de configuração simples baseados em texto que facilitam a personalização dos esquemas.

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 as tabelas disponíveis. As tabelas são definidas estaticamente para modelar ativos, categorias, jornadas e muito mais.

Procedimentos Armazenados

NOTE: Procedimentos armazenados não são suportados atualmente. Veja a nota para detalhes.

Procedimentos armazenados são interfaces semelhantes a funções para o Salesforce Marketing Cloud. Procedimentos armazenados* permitem que você execute operações no Salesforce Marketing Cloud, incluindo download e upload de objetos.

Tabelas

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

Geralmente, consultar tabelas do Salesforce Marketing Cloud é 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 do Salesforce Marketing Cloud

Ativos

Crie, atualize, exclua e consultar ativos de sua conta do SalesForce Marketing Cloud.

Informações Específicas da Tabela

Selecione

Selecione todos os ativos:

SELECT * FROM ASSETS

Recupere um recurso específico:

SELECT * FROM ASSETS WHERE ID=20088

Filtragem avançada do lado do servidor usando 'AND' e 'OR' operadores lógicos são suportados para esta tabela. Você pode verificar nas informações da tabela se a coluna tem filtros compatíveis. Todas as colunas que têm filtros suportados também podem ser classificadas no lado do servidor.

SELECT * FROM ASSETS WHERE (Id=5895 OR Id=19442) AND EnterpriseId=7307527 ORDER BY Name ASC, ID DESC

Inserir

Para criar um ativo, você precisará especificar pelo menos a coluna Name e TypeId.

INSERT INTO ASSETS(TypeID,TypeName,Name) VALUES(207,'templatebasedemail','First_Based_Template_Email_')

Atualizar

Os ativos podem ser modificados fornecendo o ID do ativo e emitindo uma instrução UPDATE.

UPDATE ASSETS SET Description='This is an updated asset.', Data='
  "campaigns": {
    "campaigns": [
      {
        "campaignId": 12345,
        "campaignAssociationId": 2387
      }
    ]
  },
"email": { } ... }'  WHERE ID=19442

Excluir

Os ativos podem ser excluídos fornecendo o ID do ativo e emitindo uma instrução DELETE.

DELETE FROM ASSETS WHERE ID=20027

Colunas

Chamadas de Retorno

Crie, atualize, exclua e consultar callbacks de notificação de eventos

Informações Específicas da Tabela

Selecione

Selecione todos os retornos de chamada:

SELECT * FROM Callbacks

Recupere um retorno de chamada específico:

SELECT * FROM Callbacks WHERE CallbackId=94766

Inserir

Para criar um retorno de chamada, você precisará especificar pelo menos a coluna CallbackName e URL.

INSERT INTO [Chamadas de retorno] (CallbackName, Url) VALUES ('cb1', 'https://example.com')

Atualizar

Os retornos de chamada podem ser modificados fornecendo o CallbackId do retorno de chamada e emitindo uma instrução UPDATE.

UPDATE [Chamadas de retorno] SET CallbackName = 'cb update' WHERE CallbackId = '34cd6cfe-5a21-4f3e-94c5-b6313a6954a4'

Excluir

Os retornos de chamada podem ser excluídos fornecendo o CallbackId do retorno de chamada e emitindo uma instrução DELETE.

DELETE FROM [Chamadas de retorno] WHERE CallbackId = '43841979-7154-4fc4-9789-909dbba3a54f'

Colunas

Campanhas

Crie, atualize, exclua e consultar Campanhas.

Informações Específicas da Tabela

Selecione

Selecione todas as campanhas:

SELECT * FROM Campaigns

Recupere uma campanha específica:

SELECT * FROM Campaigns WHERE ID = '3130'

Inserir

Para criar uma campanha, você precisará especificar pelo menos a coluna Nome.

INSERT INTO [Campanhas] (Name, Description, CampaignCode, Color, Favorite) VALUES ('Test Camp', 'Test Description', 'tst 001', '0000ff', true)

Atualizar

As operações de atualização não são suportadas para esta tabela.

Excluir

As campanhas podem ser excluídas fornecendo o CampaignId da campanha e emitindo uma instrução DELETE.

DELETE FROM [Campanhas] WHERE ID = '5161'

Colunas

Categorias

Crie, atualize, exclua e consultar categorias (pastas) no Content Builder.

Informações Específicas da Tabela

Selecione

Selecione todas as categorias:

SELECT * FROM Categories

Recupere todas as categorias que possuem um ParentId específico:

SELECT * FROM Categories WHERE ParentId=71839

Recuperar uma categoria específica:

SELECT * FROM Categories WHERE Id=94766

Todas as colunas, exceto SharedWith e SharingType, podem ser classificadas no lado do servidor:

SELECT * FROM Categories ORDER BY Name ASC

Inserir

Para criar uma categoria, você precisará especificar pelo menos a coluna Name e ParentId.

INSERT INTO Categories(Name,ParentId,categoryType) VALUES('New New New Folder',71839,'asset')

Atualizar

As categorias podem ser modificadas fornecendo o ID da categoria e emitindo uma instrução UPDATE.

Update Categories SET SharedWith='333,555,888', SharingType='edit', EnterpriseId=12345 WHERE Id=71839

Excluir

As categorias podem ser excluídas fornecendo o ID da categoria e emitindo uma instrução DELETE.

DELETE FROM Categories WHERE Id=94843

Colunas

EventDefinitions

Crie, exclua e consultar definições de eventos.

Informações Específicas da Tabela

Selecione

Recupere todas as definições de evento:

SELECT * FROM EventDefinitions

Recupere uma definição de evento específica:

SELECT * FROM EventDefinitions WHERE Id='9955614b-02e7-4147-91a2-3f5f5fe9d679'

Recupere todas as definições de eventos que estão sendo executadas em um modo específico:

SELECT * FROM EventDefinitions WHERE Mode='Test'

Recupere todas as definições de evento que contêm a frase entre aspas especificada em seus nomes:

SELECT * FROM EventDefinitions WHERE Contains(Name,'Welcome Journey')

Inserir

Para criar uma definição de evento, você precisará especificar pelo menos a coluna Nome e Tipo. DataExtensionId também é obrigatório. Se você não especificar, deverá especificar a coluna Esquema.

INSERT INTO EventDefinitions(Type,Name,DataExtensionId,IsVisibleInPicker) VALUES('Event','FirstEventDefinition','74bc3342-eaca-e711-b98f-38eaa71427a1',true)

Excluir

As definições de eventos podem ser excluídas fornecendo o ID da definição de evento e emitindo uma instrução DELETE.

DELETE FROM EventDefinitions WHERE Id='f10efb9e-cb91-4fc9-be50-c20f00f7f255'

Colunas

Propriedades do Mensageiro do Facebook

Consulte e crie propriedades do messenger do Facebook.

Informações Específicas da Tabela

Selecione

Recupere todas as propriedades registradas do facebook messenger:

SELECT * FROM FacebookMessengerProperties

Recupere uma propriedade específica do Facebook Messenger registrada:

SELECT * FROM FacebookMessengerProperties WHERE PageId='1732555047025799'

Inserir

Para registrar uma nova propriedade do facebook messenger você deve especificar PageId, ApplicationId, ApplicationSecret, PageName, PageAccessToken, CallbackVerifyToken, EndpointUrl e ApiVersion:

INSERT INTO FacebookMessengerProperties(PageId,ApplicationId,ApplicationSecret,PageName,PageAccessToken,EndpointUrl,CallbackVerifyToken,ApiVersion) VALUES('1732555047025799','1093076390764037','03d537gg656gvkbe9b430f002e9c4517','SFMC Engineers','someaccesstoken4fasdcruib213123knubkdnfisdubnu12312ub3pijnb','https://graph.facebook.com/v2.6/me/messages','this_is_the_verify_token','v2.0')

Colunas

JornadaAtividades

Crie, atualize e consultar atividades de jornada.

Informações Específicas da Tabela

Selecione

Recupere as atividades da jornada para a versão mais recente da jornada especificada:

SELECT * FROM JourneyActivities WHERE JourneyId='1cb643b5-3144-4d17-80fa-a1f0035e78e2'

Recuperar atividades de jornada para uma versão de jornada específica:

SELECT * FROM JourneyActivities WHERE JourneyId='1cb643b5-3144-4d17-80fa-a1f0035e78e2' AND JourneyVersion=1

Recupere as atividades de todas as viagens com uma versão específica:

SELECT * FROM JourneyActivities WHERE JourneyVersion=1

Inserir

Para criar uma nova atividade de jornada, você precisará especificar pelo menos a coluna JourneyId, JourneyVersion, Type, Key, Arguments, ConfigurationArguments.

INSERT INTO JourneyActivities(JourneyId,JourneyVersion,Type,Key,Arguments,ConfigurationArguments) VALUES('4753026f-20b2-481b-89c5-fcd76ffa41f7',1,'WAIT','WAITBYDURATION-1','{
  "waitEndDateAttributeDataBound": "",
  "waitDefinitionId": "f3de0c9a-5ff8-4f7b-84bd-9309ca337227",
  "waitForEventId": "",
  "executionMode": "{{Context.ExecutionMode}}",
  "startActivityKey": "{{Context.StartActivityKey}}",
  "waitQueueId": "{{Context.WaitQueueId}}"
}','{
  "waitDuration": 1,
  "waitUnit": "DAYS",
  "specifiedTime": "",
  "timeZone": "",
  "description": "",
  "waitEndDateAttributeExpression": "",
  "specificDate": "",
  "waitForEventKey": ""
}')

Atualizar

As atividades de jornada podem ser modificadas fornecendo o Id, JourneyId, JourneyVersion e emitindo uma instrução UPDATE.

Update JourneyActivities SET Description='First_Journey_Activity_Description', Outcomes='[
  {
    "key": "11bb2807-3f3d-4305-af51-547df032dbaf",
    "next": "WAITBYDURATION-1",
    "arguments": null,
    "metaData": null
  }
]' WHERE Id='fa4c3d81-8043-40e2-9741-22708d3a2e25' AND  JourneyId='4753026f-20b2-481b-89c5-fcd76ffa41f7' AND JourneyVersion=1

Colunas

Viagens

Crie, atualize, exclua e consultar jornadas.

Informações Específicas da Tabela

Selecione

Recupere viagens com a versão mais recente:

SELECT * FROM Journeys

Recuperar uma versão da jornada:

SELECT * FROM Journeys WHERE ID='1cb643b5-3144-4d17-80fa-a1f0035e78e2' AND Version=1

Recupere todas as versões da jornada:

SELECT * FROM Journeys WHERE MostRecentVersionOnly=false

Recupere viagens com uma tag específica:

SELECT * FROM Journeys WHERE Tag='First_Tag'

Recupere viagens que tenham a string de pesquisa especificada dentro do nome ou descrição:

SELECT * FROM Journeys WHERE NameOrDescription='Journey'

Recupere jornadas com versão específica da API de fluxo de trabalho:

SELECT * FROM Journeys WHERE workFlowApiVersion=1

Recuperar viagens com versão específica:

SELECT * FROM Journeys WHERE Version=1

Recuperar viagens com status específico:

SELECT * FROM Journeys WHERE Status='Draft'

Classifique as jornadas de acordo com a data modificada ou coluna de nome:

SELECT * FROM Journeys Order BY ModifiedDate DESC
SELECT * FROM Journeys Order BY Name DESC

Inserir

Para criar uma nova jornada, você precisará especificar pelo menos a coluna Nome.

INSERT INTO Journeys(Name) VALUES('API-Created journey')

Para criar uma nova versão de jornada, você precisará especificar uma chave de jornada existente.

INSERT INTO Journeys(Name,Key) VALUES('API-Created journey Version 3','53bf5ea2-ff59-4c00-a23a-b1e9e333b80c')

Atualizar

As viagens podem ser modificadas fornecendo o Id, Versão da viagem e emitindo uma declaração UPDATE.

UPDATE Journeys SET Name='API-Updated journey' WHERE Id='257c51df-d6ed-4fb6-8fbc-70e63ed52b12' AND Version=5

Excluir

As jornadas podem ser excluídas fornecendo o ID da jornada e emitindo uma instrução DELETE.

DELETE FROM Journeys WHERE Id='53bf5ea2-ff59-4c00-a23a-b1e9e333b80c'

As versões da jornada podem ser excluídas fornecendo o ID, Versão da jornada e emitindo uma instrução DELETE.

DELETE FROM Journeys WHERE Id='257c51df-d6ed-4fb6-8fbc-70e63ed52b12' AND Version=5

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.

Propriedades do LineMessenger

Consultar e criar propriedades do Line Messenger.

Informações Específicas da Tabela

Selecione

Recupere todas as propriedades do mensageiro de linha registradas:

SELECT * FROM LineMessengerProperties

Recupere uma propriedade de mensageiro de linha registrada específica:

SELECT * FROM LineMessengerProperties WHERE ID='23493453984234345'

Inserir

Para registrar uma nova propriedade do messenger de linha, você deve especificar ChannelId, ChannelName, ChannelSecret, IsTransactional, IsTestChannel, EndpointUrl e ApiVersion:

INSERT INTO LineMessengerProperties(ChannelId,ChannelName,ChannelSecret,EndpointUrl,IsTransactional,IsTestChannel,IsActive,ApiVersion) VALUES('23493453984234345','SFMC Engineers','03d537gg656gvkbe9b430f002e9c4517','https://example.com/1732555047025799',true,false,true,'v2.0')");

Colunas

Assinaturas

Crie, atualize, exclua e consultar assinaturas de notificação de eventos.

Informações Específicas da Tabela

Selecione

Selecione todas as assinaturas:

SELECT * FROM Subscriptions

Recupere uma assinatura específica:

SELECT * FROM Subscriptions WHERE SubscriptionId=94766

Inserir

Para criar uma assinatura, você precisará especificar pelo menos a coluna SubscriptionName, CallbackId e EventCategoryTypes.

INSERT INTO [Assinaturas] (SubscriptionName, CallbackId, EventCategoryTypes) VALUES ('sajli subscription', '6fb0758b-155d-4968-869d-7a4f5a3ad2fe', '[\"TransactionalSendEvents.EmailNotSent\", \"TransactionalSendEvents.EmailSent\"]')

Atualizar

As assinaturas podem ser modificadas fornecendo o SubscriptionId e a coluna EventCategoryTypes da assinatura e emitindo uma instrução UPDATE.

UPDATE [Assinaturas] SET Status = 'paused', EventCategoryTypes = '[\"TransactionalSendEvents.EmailNotSent\", \"TransactionalSendEvents.EmailSent\"]' WHERE SubscriptionId = 'db1e2af0-807d-463b-96e8-fe3aaa019fdb'

Excluir

As assinaturas podem ser excluídas fornecendo o SubscriptionId da assinatura e emitindo uma instrução DELETE.

DELETE FROM [Assinaturas] WHERE SubscriptionId = '43841979-7154-4fc4-9789-909dbba3a54f'

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 Marketing Cloud

Tipos de Ativos

Obtenha todos os tipos de ativos disponíveis no Salesforce Marketing Cloud.

Informações Específicas da Tabela

Selecione

Recupere todos os tipos de ativos:

SELECT * FROM AssetTypes

Colunas

Recursos da Campanha

Recupere todos os ativos de campanha no Salesforce Marketing Cloud.

Ver Informações Específicas

Selecione

Selecione todos os ativos de campanha para uma campanha específica:

SELECT * FROM CampaignAssets WHERE CampaignId = '3130'

Recupere uma campanha específica:

SELECT * FROM CampaignAssets WHERE CampaignId = '3130' AND ID = '3325'

Colunas

Contato

Recupere contatos no Salesforce Marketing Cloud.

Informações Específicas da Tabela

Selecione

Recuperar todos os contatos:

SELECT * FROM Contact

Observação: A maioria das colunas desta tabela é dinâmica, portanto, elas podem não ser iguais às colunas especificadas abaixo porque você pode ter um esquema de contato diferente em sua conta do Salesforce marketing cloud.
Os contatos que estão em um estado excluído, excluindo ou restrito não são recuperados.

Colunas

Contatos

Recupere todos os contatos no Salesforce Marketing Cloud.

Informações Específicas da Tabela

Selecione

Recuperar todos os contatos:

SELECT * FROM Contacts

Observação: A maioria das colunas desta tabela é dinâmica, portanto, elas podem não ser iguais às colunas especificadas abaixo porque você pode ter um esquema de contato diferente em sua conta do Salesforce marketing cloud.
Os contatos que estão em um estado excluído, excluindo ou restrito não são recuperados.

Colunas

JourneyAuditLogs

Recupera um log de auditoria de uma jornada e suas versões.

Colunas

SmsStatusCodes

Consultar códigos de status sms.

Informações Específicas da Tabela

Selecione

Recupere todos os códigos de status para os seguintes países: EUA, Canadá, Brasil e Índia. Use esses códigos para avaliar e diagnosticar e resolver problemas problemas de envio de SMS.

SELECT * FROM SmsStatusCodes

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 Marketing Cloud

CreateImportSendDeliveryReport

Gera um arquivo .csv contendo informações sobre a entrega de mensagens SMS para uma MessageList específica e coloca o relatório no local de FTP avançado para a conta do Marketing Cloud.

Entrada

Colunas do Conjunto de Resultados

CriarPalavra-chave

Cria uma palavra-chave em uma conta.

Entrada

Colunas do Conjunto de Resultados

CreateMessageListDeliveryReport

Aciona um relatório de entrega para a API messageList.

Entrada

Colunas do Conjunto de Resultados

CreateOptInMessage

Cria uma mensagem SMS opt-in permitindo que os contatos assinem outras mensagens SMS.

Entrada

Colunas do Conjunto de Resultados

Excluir Palavra-chave

Exclui uma palavra-chave em uma conta.

Excluir Palavra-chave por ID

Exclui uma palavra-chave em uma conta com um ID de palavra-chave.

EXECUTE DeleteKeyword KeywordId='alm5LXNSSktGMGluRznRb1Rb1R5MDZFQTo4Njow'

Excluir Palavra-chave por Código Longo

Exclui uma palavra-chave em uma conta com uma palavra-chave e um código longo.

EXECUTE DeleteKeyword LongCode='5550003232', Keyword='TEST'

Excluir Palavra-chave por Código Curto

Exclui uma palavra-chave em uma conta com uma palavra-chave, código curto e código de país.

EXECUTE DeleteKeyword ShortCode='89239', Keyword='TEST', CountryCode='US'

Entrada

Colunas do Conjunto de Resultados

FireEntryEvent

Acione o evento de entrada que inicia a jornada.

Entrada

Colunas do Conjunto de Resultados

GetChannelViewHtml

Retorna o HTML compilado da exibição do canal solicitado para o recurso.

Entrada

Colunas do Conjunto de Resultados

GetDeliveryStatusOfQueuedMO

Recupera o status de entrega de um MO na fila.

Entrada

Colunas do Conjunto de Resultados

GetFileForAnAsset

Obtém o arquivo binário para um ativo.

Entrada

Colunas do Conjunto de Resultados

GetHeaderFooterAccount

Obtém o cabeçalho e o rodapé padrão de uma conta.

Colunas do Conjunto de Resultados

GetHeaderFooterEmail

Obtém o cabeçalho e o rodapé de um e-mail.

Entrada

Colunas do Conjunto de Resultados

GetImportSendStatus

Recupera o status de uma automação ImportSend.

Entrada

Colunas do Conjunto de Resultados

GetImportStatus

Recupera o status de um trabalho de importação.

Entrada

Colunas do Conjunto de Resultados

GetJourneyPublicationStatus

Recupera o status de uma publicação de jornada.

Entrada

Colunas do Conjunto de Resultados

GetMessageContactHistory

Recupera a última mensagem enviada para um número de celular.

Entrada

Colunas do Conjunto de Resultados

GetMessageContactStatus

Recupera o status geral de entrega de uma mensagem para um contato.

Entrada

Colunas do Conjunto de Resultados

GetMessageListStatus

Retorna o status de uma mensagem enviada para um grupo de números móveis.

Entrada

Colunas do Conjunto de Resultados

GetOAuthAccessToken

Obtém um token de autenticação de SalesforceMarketingCloud.

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

GetRefreshListStatus

Recupera o status da lista de atualização.

Entrada

Colunas do Conjunto de Resultados

GetSubscriptionStatus

Retorna o status da assinatura para números de celular ou chaves de assinante.

EXECUTE GetSubscriptionStatus MobileNumbers='["15555555555"]'
EXECUTE GetSubscriptionStatus SubscriberKeys='["ExampleSubKey1"]'

Entrada

Colunas do Conjunto de Resultados

GetTrackingHistoryOfQueuedMO

Recupera o histórico de rastreamento de um MO enfileirado.

Entrada

Colunas do Conjunto de Resultados

ImportAndSendMessage

Importa e envia.

EXECUTE ImportAndSendMessage MessageId='MessageId'," +
          "Keyword='Test_Keyword'," +
          "NotificationEmail='myEmail@example.com'," +
          "IsDuplicationAllowed=true," +
          "IsDuplicationAllowed=true," +
          "ImportDefinition='[{" +
          "    \"FileName\": \"MyTestList.csv\"," +
          "    \"ImportType\": \"FILE\"," +
          "    \"ImportMappingType\": \"ManualMap\"," +
          "    \"FieldMaps\": [{" +
          "      \"Destination\": \"_FirstName\"," +
          "      \"Source\": \"First Name\"" +
          "    }, {" +
          "      \"Destination\": \"_Subscriberkey\"," +
          "      \"Source\": \"Subscriber Key\"" +
          "    }, {" +
          "      \"Destination\": \"_LastName\"," +
          "      \"Source\": \"Last Name\"" +
          "    }, {" +
          "      \"Destination\": \"_MobileNumber\"," +
          "      \"Source\": \"Mobile\"" +
          "    }, {" +
          "      \"Destination\": \"_CountryCode\"," +
          "      \"Source\": \"Country\"" +
          "    }]" +
"  }]'

Entrada

Colunas do Conjunto de Resultados

PostMessageToList

Inicia uma mensagem para uma ou mais listas de contatos.

EXECUTE PostMessageToList MessageId='NCNSDNsd222as85dj92j2sM',  TargetListIds=' [" +
          "        \"bzZ0cENGam1FZUtNX0poTDRYZzhlQTo2Mzow\"" +
          "    ]', OverrideTemplateTargetLists=true, OverrideTemplateExclusionLists=false, IgnoreExclusionLists=true, OverrideMessageText=false, " +
          "ContentURL='http://image.exct.net/lib/fe6d15707662057c7411/m/1/dj_CC_AUS.jpg'," +
"UtcOffset='-0500', WindowStart='1500', WindowEnd='2200', AllowDuplication=false

Entrada

Colunas do Conjunto de Resultados

PostMessageToNumber

Inicia uma mensagem para um ou mais números móveis.

Assinantes

As colunas disponíveis para a tabela temporária Assinantes são as seguintes:

Executar

Use números de celular para fazer referência aos registros de contato:

EXECUTE PostMessageToNumber MessageId='NCNSDNsd222as85dj92j2sM', mobileNumbers='[" +
          "    \"13175551212\"" +
"    ]', Subscribe=true, Resubscribe=true, keyword='JOINSMS', Override=true, messageText='Welcome to Code@', ContentURL='http://image.exct.net/lib/abcd/m/1/dj_CC_AUS.jpg', SendTime='2012-10-05 20:01'

Use a tabela Subscribers#Temp como uma maneira alternativa de referenciar registros de contato:

Insert INTO Subscribers#Temp(MobileNumber,SubscriberKey,Attributes) Values('15555554410','ExampleSubKey1','{" +
          "            \"FirstName\":\"Michael\"" +
          "            }')
Insert INTO Subscribers#Temp(MobileNumber,SubscriberKey,Attributes) Values('15555552254','ExampleSubKey2','{" +
          "            \"FirstName\":\"Kristen\"" +
          "            }')          
EXECUTE PostMessageToNumber MessageId='NCNSDNsd222as85dj92j2sM', Subscribe=true, Resubscribe=true, Keyword='JOINSMS', Override=false, SendTime='2012-10-05 20:01' 

Entrada

Colunas do Conjunto de Resultados

Publicar Jornada

Publica uma versão da jornada de forma assíncrona.

Entrada

Colunas do Conjunto de Resultados

FilaContatoImportar

Coloca uma importação de contato na fila.

FieldMaps

As colunas disponíveis para a tabela temporária FieldMaps são as seguintes:

Executar

Insert INTO FieldMaps#Temp(destination,ordinal,source) Values('_MobileNumber',2,'mobile number')
Insert INTO FieldMaps#Temp(destination,ordinal,source) Values('_CountryCode',3,'locale')
Insert INTO FieldMaps#Temp(destination,ordinal,source) Values('_SubscriberKey',1,'subscriber key')
EXECUTE QueueContactImport ListId='UEhwdktFWXpFZUs3Z3hRUW45R2dBQTo2Mzow', ShortCode='90913', Keyword='WELCOME', SendEmailNotification=true, EmailAddress='example@example.com'," +
"ImportMappingType='MapByOrdinal', FileName='testdata.csv', FileType='csv', IsFirstRowHeader=true

Entrada

Colunas do Conjunto de Resultados

QueueMoMessage

Enfileira uma mensagem MO para envio.

EXECUTE QueueMoMessage MobileNumbers='[" +
          "  \"15555551212\"" +
          "  ]', ShortCode='86288', MessageText='CODETEST'
EXECUTE QueueMoMessage Subscribers='[    " +
          "     {   " +
          "       \"mobilenumber\": \"15555551212\",    " +
          "       \"subscriberkey\": \"0_MC1652\"   " +
          "     },    " +
          "     {   " +
          "       \"mobilenumber\": \"15555551213\",    " +
          "       \"subscriberkey\": \"0_MC1652\"   " +
          "     }   " +
"   ]', ShortCode='86288', MessageText='CODETEST'

Entrada

Colunas do Conjunto de Resultados

Atualizar Lista

Atualiza uma lista.

Entrada

Colunas do Conjunto de Resultados

RefreshOAuthAccessToken

Atualiza o token de acesso OAuth usado para autenticação com SalesforceMarketingCloud.

Entrada

Colunas do Conjunto de Resultados

SendMessageToRecipient

Envie uma mensagem OTT para o destinatário. As redes OTT suportadas são Facebook Messenger e LINE.

Conteúdo da Mensagem

Você não pode enviar uma mensagem OTT ao destinatário sem especificar o conteúdo da mensagem. Para criar o conteúdo da mensagem, você deve inserir dados em uma tabela temporária chamada 'MessageContents#TEMP'. As colunas disponíveis para esta tabela temporária são as seguintes:

MessageCustomKeys

Você também pode especificar chaves personalizadas de mensagem para passagem na payload da mensagem inserindo dados em uma tabela temporária chamada 'MessageCustomKeys#TEMP'. As colunas disponíveis para esta tabela temporária são as seguintes:

Executar

Envio de mensagem do Messenger:

Insert INTO MessageContents#Temp(type,text) Values('text','thanks for purchase')
Insert INTO MessageCustomKeys#Temp(messagingType) Values('RESPONSE')
EXECUTE SendMessageToRecipient MessageKey='e1c35141-6e5c-4bc2-813b-60f969e52b0d', MessageGroupKey='CanBeAGUIDorAny100UnicodeCharString', SenderType='messenger', SenderId='503868699681937', OttId='FBfacdb735074f7c492c0bf190fa99020', UserReference='1938cd4d34cc4db0b109756b8a9b14ff', Subject='Message Name', ValidityPeriod=30"

Diferentes tipos de conteúdo do Messenger:

Insert INTO MessageContents#Temp(type,url,AltUrl,IsReusable,AttachmentId) Values('image','https://example.com/original.jpg','https://example.com/preview.jpg',true,12345)
Insert INTO MessageCustomKeys#Temp(messagingType) Values('RESPONSE')
EXECUTE SendMessageToRecipient MessageKey='e1c35141-6e5c-4bc2-813b-60f969e52b0d', MessageGroupKey='CanBeAGUIDorAny100UnicodeCharString', SenderType='messenger', SenderId='503868699681937', OttId='FBfacdb735074f7c492c0bf190fa99020', UserReference='1938cd4d34cc4db0b109756b8a9b14ff', Subject='Message Name', ValidityPeriod=30"

LINE mensagem enviada:

Insert INTO MessageContents#Temp(type,text) Values('text','thanks for purchase')
Insert INTO MessageCustomKeys#Temp(messagingType) Values('RESPONSE')
EXECUTE SendMessageToRecipient MessageKey='CanBeAGUIDorAny100UnicodeCharString', MessageGroupKey='CanBeAGUIDorAny100UnicodeCharString', SenderType='line', SenderId='2145435435632435', OttId='U42348yafsd8y3248yfsq8cy9088934d', UserReference='1938cd4d34cc4db0b109756b8a9b14ff', Subject='Message Name', ValidityPeriod=30"

Entrada

Colunas do Conjunto de Resultados

StopJourney

Pare uma jornada em execução.

Entrada

Colunas do Conjunto de Resultados

Modelo de Dados SOAP

O conector modela as APIs SOAP do Salesforce Marketing Cloud como banco de dados Tabelas e Visualizações. Eles são definidos em arquivos de esquema, que são arquivos de configuração simples baseados em texto que facilitam a personalização dos esquemas.

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 as tabelas disponíveis. As tabelas são definidas estaticamente para modelar ativos, categorias, jornadas e muito mais.

Visualizações

Visualizações são tabelas que não podem ser modificadas. Normalmente, os dados somente leitura são mostrados como exibições. Procedimentos armazenados* permitem que você execute operações no Salesforce Marketing Cloud, incluindo download e upload de objetos.

Tabelas

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

Geralmente, consultar tabelas do Salesforce Marketing Cloud é 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 do Salesforce Marketing Cloud

Conta

Uma conta do Marketing Cloud.

Informações Específicas da Tabela

Selecione

O conector usa as APIs do Salesforce Marketing Cloud para processar os seguintes operadores de cláusula WHERE para todos, exceto valores de data e hora: =, !=, <>, >, >=, <, <=, IN. Para valores de data e hora, apenas > e < são suportados. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL para falso, caso em que qualquer critério de pesquisa que se refira a outras colunas causará um erro.

Por exemplo, as seguintes (mas não apenas) consultas são processadas no lado do servidor:

SELECT * FROM Account

SELECT * FROM Account WHERE Id = 123

SELECT * FROM Account WHERE Id IN (123, 456)

SELECT * FROM Account WHERE CreatedDate > '2017/01/25'

Inserir

Você deve especificar a coluna Nome ao executar uma inserção nesta tabela.

INSERT INTO Account(Name) VALUES('Test')

Atualizar

Você deve especificar o ID na cláusula WHERE ao executar uma atualização nesta tabela.

UPDATE Account SET Fax='1123123' WHERE Id=123

Excluir

Você deve especificar o ID na cláusula WHERE ao executar uma exclusão nesta tabela.

DELETE FROM Account WHERE ID = 123

Colunas

Usuário da Conta

Um usuário individual em uma conta. Esta tabela não suporta exclusões.

Informações Específicas da Tabela

Selecione

O conector usa as APIs do Salesforce Marketing Cloud para processar os seguintes operadores de cláusula WHERE para todos, exceto valores de data e hora: =, !=, <>, >, >=, <, <=, IN. Para valores de data e hora, apenas > e < são suportados. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL para falso, caso em que qualquer critério de pesquisa que se refira a outras colunas causará um erro.

Por exemplo, as seguintes (mas não apenas) consultas são processadas no lado do servidor:

SELECT * FROM AccountUser

SELECT * FROM AccountUser WHERE Id = 123

SELECT * FROM AccountUser WHERE Id IN (123, 456)

SELECT * FROM AccountUser WHERE CreatedDate > '2017/01/25'

Inserir

Você deve especificar os seguintes campos ao inserir nesta tabela: Client_Id, Name, E-mail, UserID e Password.

INSERT INTO AccountUser(Client_Id, UserId, Name, Email, Password) VALUES(123, 'bcabsbasbcasb', 'Test', 'test@gmail.com', 'testpas@2sowrd')

Atualizar

Você deve especificar o ID e o Client_Id na cláusula WHERE ao executar uma atualização nesta tabela.

UPDATE AccountUser SET Name='changed' WHERE Id=123 AND Client_Id=456

Colunas

Unidade de Negócio

Uma unidade dentro de uma conta Enterprise ou Enterprise 2.0 maior. Esta tabela suporta apenas consultas e atualizações.

Informações Específicas da Tabela

Selecione

O conector usa as APIs do Salesforce Marketing Cloud para processar os seguintes operadores de cláusula WHERE para todos, exceto valores de data e hora: =, !=, <>, >, >=, <, <=, IN. Para valores de data e hora, apenas > e < são suportados. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL para falso, caso em que qualquer critério de pesquisa que se refira a outras colunas causará um erro.

Por exemplo, as seguintes (mas não apenas) consultas são processadas no lado do servidor:

SELECT * FROM BusinessUnit

SELECT * FROM BusinessUnit WHERE Id = 123

SELECT * FROM BusinessUnit WHERE Id IN (123, 456)

SELECT * FROM BusinessUnit WHERE CreatedDate > '2017/01/25'

Atualizar

Você deve especificar o ID na cláusula WHERE ao executar uma atualização nesta tabela.

UPDATE BusinessUnit SET Name='Changed' WHERE Id=123

Colunas

Área de Conteudo

Uma ContentArea representa uma seção definida de conteúdo reutilizável.

Informações Específicas da Tabela

Selecione

O conector usa as APIs do Salesforce Marketing Cloud para processar os seguintes operadores de cláusula WHERE para todos, exceto valores de data e hora: =, !=, <>, >, >=, <, <=, IN. Para valores de data e hora, apenas > e < são suportados. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL para falso, caso em que qualquer critério de pesquisa que se refira a outras colunas causará um erro.

Por exemplo, as seguintes (mas não apenas) consultas são processadas no lado do servidor:

SELECT * FROM ContentArea

SELECT * FROM ContentArea WHERE Id = 123

SELECT * FROM ContentArea WHERE Id IN (123, 456)

SELECT * FROM ContentArea WHERE CreatedDate > '2017/01/25'

Inserir

Você deve especificar os seguintes campos ao inserir nesta tabela: Nome e Conteúdo.

INSERT INTO ContentArea(Name, Content) VALUES('Testing', 'Hello world')

Atualizar

Você deve especificar o ID na cláusula WHERE ao executar uma atualização nesta tabela.

UPDATE ContentArea SET Name='Changed' WHERE Id=123

Excluir

Você deve especificar o ID na cláusula WHERE ao executar uma exclusão nesta tabela.

DELETE FROM ContentArea WHERE ID = 123

Colunas

DataExtension

Representa uma extensão de dados em uma conta.

Informações Específicas da Tabela

Selecione

O conector usa as APIs do Salesforce Marketing Cloud para processar os seguintes operadores de cláusula WHERE para todos, exceto valores de data e hora: =, !=, <>, >, >=, <, <=, IN. Para valores de data e hora, apenas > e < são suportados. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL para falso, caso em que qualquer critério de pesquisa que se refira a outras colunas causará um erro.

Por exemplo, as seguintes (mas não apenas) consultas são processadas no lado do servidor:

SELECT * FROM DataExtension

SELECT * FROM DataExtension WHERE CreatedDate > '2017/01/25'

Inserir

Você deve especificar os seguintes campos ao inserir nesta tabela: Name, CustomerKey e Fields.

Observação: as APIs do Salesforce Marketing Cloud têm problemas com DataExtensions com nomes com mais de 40 caracteres. Tente limitar o nome a algo relativamente curto.

INSERT INTO DataExtension (Name, CustomerKey,  Fields) VALUES('TestName', 'TestCustomerKey', 'fieldname1;fieldname2;fieldname3')

Atualizar

Você deve especificar ObjectId ou CustomerKey ou Name na cláusula WHERE ao executar uma atualização nessa tabela.

UPDATE DataExtension SET ResetRetentionPeriodOnImport=true WHERE ObjectId='nzxcaslkjd-123'

Excluir

Você deve especificar ObjectId ou CustomerKey ou Name na cláusula WHERE ao executar uma exclusão nesta tabela.

DELETE FROM DataExtension WHERE ObjectId = 'nzxcaslkjd-123'

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-mail

Representa um e-mail em uma conta do Marketing Cloud.

Informações Específicas da Tabela

Selecione

O conector usa as APIs do Salesforce Marketing Cloud para processar os seguintes operadores de cláusula WHERE para todos, exceto valores de data e hora: =, !=, <>, >, >=, <, <=, IN. Para valores de data e hora, apenas > e < são suportados. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL para falso, caso em que qualquer critério de pesquisa que se refira a outras colunas causará um erro.

Por exemplo, as seguintes (mas não apenas) consultas são processadas no lado do servidor:

SELECT * FROM Email

SELECT * FROM Email WHERE Id = 123

SELECT * FROM Email WHERE Id IN (123, 456)

SELECT * FROM Email WHERE CreatedDate > '2017/01/25'

Inserir

Você deve especificar os seguintes campos ao inserir nesta tabela: Nome e Assunto.

INSERT INTO Email(Name, Subject) VALUES('Testing', 'Greetings')

Atualizar

Você deve especificar o ID na cláusula WHERE ao executar uma atualização nesta tabela.

UPDATE Email SET Name='Changed' WHERE Id=31558

Excluir

Você deve especificar o ID na cláusula WHERE ao executar uma exclusão nesta tabela.

DELETE FROM Email WHERE ID = 123

Colunas

EmailSendDefinition

Registro que contém as informações da mensagem, perfil do remetente, perfil de entrega e informações do público.

Informações Específicas da Tabela

Selecione

O conector usa as APIs do Salesforce Marketing Cloud para processar os seguintes operadores de cláusula WHERE para todos, exceto valores de data e hora: =, !=, <>, >, >=, <, <=, IN. Para valores de data e hora, apenas > e < são suportados. O conector processa outros filtros do lado do cliente dentro do conector. Você pode desativar a execução da consultar no lado do cliente definindo SupportEnhancedSQL para falso, caso em que qualquer critério de pesquisa que se refira a outras colunas causará um erro.

Por exemplo, as seguintes (mas não apenas) consultas são processadas no lado do servidor:

SELECT * FROM EmailSendDefinition

SELECT * FROM EmailSendDefinition WHERE ObjectID = 123

SELECT * FROM EmailSendDefinition WHERE ObjectID IN (123, 456)

SELECT * FROM EmailSendDefinition WHERE CreatedDate > '2017/01/25'

Inserir

Você deve especificar os seguintes campos ao inserir nesta tabela: Name, SendClassification_CustomerKey e Email_Id.

INSERT INTO EmailSendDefinition(Name, SendClassification_CustomerKey, Email_Id) VALUES('Testing', 13507, 31677)

Atualizar

Você deve especificar o ID na cláusula WHERE ao executar uma atualização nesta tabela.

UPDATE EmailSendDefinition SET Description='Changed' WHERE ObjectId='acasascas'

Excluir

Você deve especificar o ID na cláusula WHERE ao executar uma exclusão nesta tabela.

DELETE FROM EmailSendDefinition WHERE ObjectId = 'sdfsdf123'

Colunas