Detalles de Conexión de Salesforce Marketing Cloud

Introducción

Versión del conector

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

Empezando

Compatibilidad con la versión de Salesforce Marketing Cloud

Establecer una Conexión

Autenticación en la API REST de Salesforce Marketing Cloud

Para conectar, establezca Schema descansar". La API REST de Salesforce Marketing Cloud utiliza el estándar de autenticación OAuth. Para autenticarse mediante OAuth, deberá crear una aplicación para obtener el OAuthClientId y OAuthClientSecret propiedades de conexión. Consulte Uso de la autenticación OAuth para obtener una guía de autenticación.

Autenticación en la API de SOAP de Salesforce Marketing Cloud

La API de SOAP de Salesforce Marketing Cloud puede conectarse usando sus credenciales de inicio de sesión o usando la autenticación OAuth.

Para conectarse a los datos mediante la autenticación básica (credenciales de inicio de sesión), configure lo siguiente:

• User: La cuenta de usuario de Salesforce Marketing Cloud utilizada para la autenticación.
• Password: La contraseña utilizada para autenticar al usuario.
• AuthScheme: Establézcalo en Básico.
• UseLegacyAuthentication: Establézcalo en Verdadero.

a sus credenciales de inicio de sesión.

Conexión a las APIs de Salesforce Marketing Cloud

Una vez que se haya autenticado en la API SOAP o REST, estará listo para conectarse a los datos.

Opcionalmente, puede refinar el acceso a los datos utilizando las siguientes propiedades:

• Instance: La instancia de la API de Salesforce Marketing Cloud utilizada. La instancia predeterminada es s7 de la API de servicios web; sin embargo, puede usar esta propiedad para especificar una instancia diferente.

Uso de la Autenticación OAuth

OAuth requiere que el usuario que se autentica interactúe con Salesforce Marketing Cloud mediante el navegador. El conector facilita esto de varias maneras, como se describe a continuación.

Credenciales Personalizadas

Deberá registrar una aplicación para obtener el OAuthClientId y OAuthClientSecret.

Creación de una Aplicación OAuth Personalizada

Consulte Crear una aplicación OAuth personalizada para el procedimiento.

Credenciales Personalizadas

Autenticación de Escritorio con Su Aplicación OAuth

Siga los pasos a continuación para autenticarse con las credenciales de una aplicación OAuth personalizada. Consulte Crear una aplicación OAuth personalizada.

Obtenga un Token de Acceso OAuth

Después de configurar lo siguiente, está listo para conectarse:

• OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.
• APIIntegrationType: Establezca esto en Web-App o Server-to-Server según lo que haya seleccionado al crear su aplicación.
• OAuthGrantType: Alternativamente, en lugar de configurar APIIntegrationType, el OAuthGrantType se puede establecer directamente en Código (aplicación web) o Cliente (servidor a servidor). Puede ser deseable usar OAuthGrantType en los casos en que se utilizan múltiples productos para mantener la consistencia.
• CallbackURL: establezca esto en la URL de redireccionamiento en la configuración de su aplicación.
• InitiateOAuth: Establézcalo en GETANDREFRESH. Puede usar InitiateOAuth para evitar repetir el intercambio de OAuth y configurar manualmente OAuthAccessToken..
• AccountId: establezca esto en el MID específico de la unidad de negocio de destino. Esto no está disponible para paquetes heredados.

Cuando se conecta, el conector abre el extremo de OAuth en su navegador predeterminado. Inicie sesión y otorgue permisos a la aplicación. Luego, el conector completa el proceso de OAuth:

1. Extrae el token de acceso de la URL de devolución de llamada y autentica las solicitudes.
2. Obtiene un nuevo token de acceso cuando caduca el antiguo.
3. Guarda los valores de OAuth en OAuthSettingsLocation para persistir a través de las conexiones.

Máquinas Sin Cabeza

Uso de OAuth en una Máquina Sin Cabeza

Para crear orígenes de datos de Salesforce Marketing Cloud en servidores autónomos u otras máquinas en las que el conector no puede abrir un navegador, debe autenticarse desde otra máquina. La autenticación es un proceso de dos pasos.

1. En lugar de instalar el conector en otra máquina, puede seguir los pasos a continuación para obtener el OAuthVerifier valor. O bien, puede instalar el conector en otra máquina y transferir los valores de autenticación de OAuth, después de autenticarse a través del flujo habitual basado en el navegador.
2. A continuación, puede configurar el conector para actualizar automáticamente el token de acceso desde la máquina sin periféricos.

Uso de las Credenciales para una Aplicación OAuth Personalizada

Cree una aplicación OAuth personalizada

Consulte Crear una aplicación OAuth personalizada para un procedimiento. Luego puede seguir los procedimientos a continuación para autenticarse y conectarse a los datos.

Obtenga un código verificador

Establezca las siguientes propiedades en la máquina sin periféricos:

• InitiateOAuth: Ajústelo a APAGADO.
• OAuthClientId: establezca esto en la ID de la aplicación en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto de la aplicación en la configuración de su aplicación.
• AccountId: establezca esto en el MID específico de la unidad de negocio de destino. Esto no está disponible para paquetes heredados.

Luego puede seguir los pasos a continuación para autenticarse desde otra máquina y obtener el OAuthVerifier propiedad de conexión.

1. Llame a GetOAuthAuthorizationURL procedimiento almacenado* con el parámetro de entrada CallbackURL establecido en el URI de redirección exacto que especificó en la configuración de su aplicación.
2. Abra la URL devuelta en un navegador. Inicie sesión y otorgue permisos al conector. A continuación, se le redirige a la URL de devolución de llamada, que contiene el código verificador.
3. Guarde el valor del código verificador. Establecerá esto en el OAuthVerifier propiedad de conexión.

En la máquina sin periféricos, establezca las siguientes propiedades de conexión para obtener los valores de autenticación de OAuth:

• OAuthClientId: establezca esto en la clave de consumidor en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del consumidor en la configuración de su aplicación.
• OAuthVerifier: Establézcalo en el código del verificador.
• OAuthSettingsLocation: configure esto para conservar los valores de autenticación OAuth cifrados en el archivo especificado.
• InitiateOAuth: Establézcalo en ACTUALIZAR.
• AccountId: establezca esto en el MID específico de la unidad de negocio de destino. Esto no está disponible para paquetes heredados.

Conectarse a datos

Después de generar el archivo de configuración de OAuth, configure las siguientes propiedades para conectarse a los datos:

• OAuthSettingsLocation: Establézcalo en el archivo que contiene los valores de autenticación de OAuth cifrados. Asegúrese de que este archivo otorgue permisos de lectura y escritura al proveedor para habilitar la actualización automática del token de acceso.
• InitiateOAuth: Establézcalo en ACTUALIZAR.
• AccountId: establezca esto en el MID específico de la unidad de negocio de destino. Esto no está disponible para paquetes heredados.

Transferir configuración de OAuth

Siga los pasos a continuación para instalar el conector en otra máquina, autenticar y luego transferir los valores de OAuth resultantes.

En una segunda máquina, instale el conector y conéctese con el siguiente conjunto de propiedades:

• OAuthSettingsLocation: establezca esto en un archivo de texto grabable.
• InitiateOAuth: Establézcalo en GETANDREFRESH.
• OAuthClientId: establezca esto en la ID del cliente en la configuración de su aplicación.
• OAuthClientSecret: establezca esto en el secreto del cliente en la configuración de su aplicación.
• CallbackURL: establezca esto en la URL de devolución de llamada en la configuración de su aplicación.
• AccountId: establezca esto en el MID específico de la unidad de negocio de destino. Esto no está disponible para paquetes heredados.

Pruebe la conexión para autenticarse. Los valores de autenticación resultantes se escriben, se cifran, en la ruta especificada por OAuthSettingsLocation. Una vez que haya probado con éxito la conexión, copie el archivo de configuración de OAuth en su máquina sin periféricos. En la máquina sin periféricos, configure las siguientes propiedades de conexión para conectarse a los datos:

• InitiateOAuth: Establézcalo en ACTUALIZAR.
• OAuthSettingsLocation: establezca esto en la ruta a su archivo de configuración de OAuth. Asegúrese de que este archivo otorgue permisos de lectura y escritura al conector para habilitar la actualización automática del token de acceso.
• AccountId: establezca esto en el MID específico de la unidad de negocio de destino. Esto no está disponible para paquetes heredados.

Creación de una Aplicación OAuth Personalizada

Crear una Aplicación

Puede seguir el procedimiento a continuación para registrar una aplicación y obtener las credenciales de cliente de OAuth, la identificación del cliente y el secreto del cliente:

1. Inicie sesión en su Salesforce Marketing Cloud Vaya a Marketing Cloud | administración | Paquetes Instalados.
2. Haga clic en New.
3. Asigne un nombre y una descripción al paquete.
4. Guarde el paquete. Una vez que se guarda el paquete, verá detalles importantes sobre el paquete. Consulte Definiciones de paquetes instalados para obtener más información sobre cada campo. Verá el ID del paquete, el secreto de firma de JWT y la cuenta de origen solo para los paquetes creados en su cuenta.
5. En Componentes, haga clic en Add Component.
6. Seleccione API Integration.
7. Debe seleccionar Server-to-Server o Web App como tipo de integración si el paquete admite funciones mejoradas.
8. Asigne el alcance apropiado para su integración.
   • Perform server-to-server requests... se selecciona automáticamente para todas las integraciones de API.
   • Seleccionar Perform requests on behalf of the user... si este paquete contiene una aplicación de Marketing Cloud.
   • Seleccione el alcance de Marketing Cloud para sus llamadas API. Asigne solo el alcance que necesita su paquete.
9. Guarde el componente.
10. Debajo de los detalles del componente, puede encontrar Client ID y Client Secret.

Selección de Extensiones de Datos en SalesforceMarketingCloud

El conector ofrece la posibilidad de seleccionar, insertar, actualizar y eliminar datos de extensiones de datos como tablas relacionales. Para consultar una extensión de datos, simplemente ingrese su nombre en el formato DataExtensionObject_Name donde Nombre es el nombre de su extensión de datos.

Selección de Datos de Extensiones de Datos

SELECT * FROM DataExtensionObject_fsefes3

SELECT * FROM DataExtensionObject_fsefes3 WHERE FieldName1 = 'One'

Nota 1: Todos los filtros que funcionan con tablas/vistas normales también funcionan con extensiones de datos.

Nota 2: si su cuenta de Salesforce Marketing Cloud contiene más de una unidad comercial, debe especificar la entrada ClientID. Puede usar punto y coma (;) para especificar más de un ClientID.

SELECT * FROM DataExtensionObject_fsefes3 WHERE ClientID = '1234567'

Insertar Datos en Extensiones de Datos

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

Actualización de Datos Desde Extensiones de Datos

UPDATE DataExtensionObject_secondtest15 SET [Nombre] = 'ChangedFromTheApi' WHERE [Dirección de Correo] = 'update_me@gmail.com'

Nota: Debe existir una clave principal para esta extensión de datos para que la actualización funcione.

Eliminación de Datos de Extensiones de Datos

DELETE FROM DataExtensionObject_secondtest15 WHERE [Dirección de Correo] = 'delete_me@gmail.com'

Nota: Debe existir una clave principal para esta extensión de datos para que la eliminación funcione.

Notas Importantes

Procedimientos Almacenados

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

Archivos de Configuración y Sus Rutas

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

Características Avanzadas

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

Vistas definidas por el usuario

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

Configuración SSL

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

Apoderado

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

Vistas Definidas por el Usuario

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

Hay dos formas de crear vistas definidas por el usuario:

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

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

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

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

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

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

Por ejemplo:

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

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

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

Esquema para Vistas Definidas por el Usuario

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

Trabajar con Vistas Definidas por el Usuario

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

SELECT * FROM Customers WHERE City = 'Raleigh';

Un ejemplo de una consultar al controlador:

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

Dando como resultado la consultar efectiva a la fuente:

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

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

Configuración SSL

Personalización de la Configuración SSL

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

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

Modelo de Datos

Jitterbit Connector para Salesforce Marketing Cloud modela dos APIs de Salesforce Marketing Cloud como bases de datos relacionales, la API REST y la API SOAP. Selecciona el Schema propiedad y utilice la información de cada sección para seleccionar la API adecuada en función de las necesidades de su proyecto.

Procesamiento colaborativo de consultas

El conector descarga la mayor parte posible del procesamiento de sentencias SELECT a las APIs de Salesforce Marketing Cloud y luego procesa el resto de la consultar dentro del conector.

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

Usando la API REST

La API REST expone un acceso más amplio a las capacidades de Salesforce Marketing Cloud. Todas las nuevas tecnologías de Salesforce Marketing Cloud implementan REST API. Vea Modelo de datos REST para las entidades disponibles en la API REST.

Usando la API de SOAP

La API de SOAP brinda acceso integral a la mayoría de las funciones de correo. La API de SOAP utiliza sobres de SOAP para pasar información entre usted y Salesforce Marketing Cloud. Consulte Modelo de datos SOAP para las entidades disponibles en la API de SOAP.

Modelo de Datos REST

El conector modela las APIs REST de Salesforce Marketing Cloud como base de datos Tablas y Procedimientos almacenados. Estos se definen en archivos de esquema, que son archivos de configuración simples basados en texto que facilitan la personalización de los esquemas.

Las limitaciones y los requisitos de la API se documentan en esta sección; puedes usar el SupportEnhancedSQL función, configurada de forma predeterminada, para eludir la mayoría de estas limitaciones.

Mesas

Mesas describe las tablas disponibles. Las tablas se definen estáticamente para modelar activos, categorías, viajes y más.

Procedimientos Almacenados

NOTE: Los procedimientos almacenados no se admiten actualmente. Consulte la nota anterior para detalles.

Procedimientos almacenados son interfaces similares a funciones para Salesforce Marketing Cloud. Procedimientos almacenados* le permiten ejecutar operaciones en Salesforce Marketing Cloud, incluida la descarga y carga de objetos.

Mesas

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

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

Conector Jitterbit para Tablas de Salesforce Marketing Cloud

Activos

Cree, actualice, elimine y consultar activos desde su cuenta de SalesForce Marketing Cloud.

Información Específica de la Tabla

Seleccionar

Seleccione todos los activos:

SELECT * FROM ASSETS

Recuperar un activo específico:

SELECT * FROM ASSETS WHERE ID=20088

Filtrado avanzado del lado del servidor usando 'AND' y 'OR' los operadores lógicos son compatibles con esta tabla. Puede verificar en la información de la tabla si la columna tiene filtros compatibles. Todas las columnas que tienen filtros compatibles también se pueden ordenar del lado del servidor.

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

Insertar

Para crear un activo, deberá especificar al menos la columna Name y TypeId.

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

Actualizar

Los activos pueden modificarse proporcionando la identificación del activo y emitiendo una declaración de ACTUALIZACIÓN.

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

Borrar

Los activos se pueden eliminar proporcionando la identificación del activo y emitiendo una declaración DELETE.

DELETE FROM ASSETS WHERE ID=20027

Columnas

Devoluciones de Llamada

Crear, actualizar, eliminar y consultar devoluciones de llamada de notificación de eventos

Información Específica de la Tabla

Seleccionar

Seleccione todas las devoluciones de llamada:

SELECT * FROM Callbacks

Recuperar una devolución de llamada específica:

SELECT * FROM Callbacks WHERE CallbackId=94766

Insertar

Para crear una devolución de llamada, deberá especificar al menos la columna CallbackName y Url.

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

Actualizar

Las devoluciones de llamada se pueden modificar proporcionando el CallbackId de la devolución de llamada y emitiendo una instrucción UPDATE.

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

Borrar

Las devoluciones de llamada se pueden eliminar proporcionando el CallbackId de la devolución de llamada y emitiendo una instrucción DELETE.

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

Columnas

Campañas

Crear, actualizar, eliminar y consultar Campañas.

Información Específica de la Tabla

Seleccionar

Seleccionar todas las campañas:

SELECT * FROM Campaigns

Recuperar una campaña específica:

SELECT * FROM Campaigns WHERE ID = '3130'

Insertar

Para crear una campaña, deberá especificar al menos la columna Nombre.

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

Actualizar

Las operaciones de actualización no son compatibles con esta tabla.

Borrar

Las campañas se pueden eliminar proporcionando el CampaignId de la campaña y emitiendo una instrucción DELETE.

DELETE FROM [Campañas] WHERE ID = '5161'

Columnas

Categorías

Cree, actualice, elimine y consultar categorías (carpetas) en Content Builder.

Información Específica de la Tabla

Seleccionar

Seleccione todas las categorías:

SELECT * FROM Categories

Recupere todas las categorías que tienen un ParentId específico:

SELECT * FROM Categories WHERE ParentId=71839

Recuperar una categoría específica:

SELECT * FROM Categories WHERE Id=94766

Todas las columnas excepto SharedWith y SharingType se pueden ordenar del lado del servidor:

SELECT * FROM Categories ORDER BY Name ASC

Insertar

Para crear una Categoría, deberá especificar al menos la columna Nombre y ParentId.

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

Actualizar

Las categorías se pueden modificar proporcionando el ID de la categoría y emitiendo una declaración de ACTUALIZACIÓN.

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

Borrar

Las categorías se pueden eliminar proporcionando el ID de la categoría y emitiendo una instrucción DELETE.

DELETE FROM Categories WHERE Id=94843

Columnas

Definiciones de Eventos

Crear, eliminar y consultar definiciones de eventos.

Información Específica de la Tabla

Seleccionar

Recuperar todas las definiciones de eventos:

SELECT * FROM EventDefinitions

Recuperar una definición de evento específica:

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

Recupere todas las definiciones de eventos que se ejecutan en un modo específico:

SELECT * FROM EventDefinitions WHERE Mode='Test'

Recupere todas las definiciones de eventos que contengan la frase citada especificada en sus nombres:

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

Insertar

Para crear una definición de evento, deberá especificar al menos la columna Nombre y Tipo. También se requiere DataExtensionId. Si no lo especifica, debe especificar la columna Esquema.

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

Borrar

Las definiciones de eventos se pueden eliminar proporcionando el ID de la definición de evento y emitiendo una instrucción DELETE.

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

Columnas

FacebookMessengerPropiedades

Consulta y crea propiedades de mensajería de Facebook.

Información Específica de la Tabla

Seleccionar

Recupera todas las propiedades registradas de facebook messenger:

SELECT * FROM FacebookMessengerProperties

Recupere una propiedad específica registrada de Facebook Messenger:

SELECT * FROM FacebookMessengerProperties WHERE PageId='1732555047025799'

Insertar

Para registrar una nueva propiedad de Facebook Messenger, debe especificar PageId, ApplicationId, ApplicationSecret, PageName, PageAccessToken, CallbackVerifyToken, EndpointUrl y 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')

Columnas

ViajeActividades

Crear, actualizar y consultar actividades de viaje.

Información Específica de la Tabla

Seleccionar

Recuperar actividades de viaje para la última versión del viaje especificado:

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

Recuperar actividades de viaje para una versión de viaje específica:

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

Recuperar actividades de viaje de todos los viajes con una versión específica:

SELECT * FROM JourneyActivities WHERE JourneyVersion=1

Insertar

Para crear una nueva actividad de viaje, deberá especificar al menos la columna 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": ""
}')

Actualizar

Las actividades del viaje se pueden modificar proporcionando el Id, JourneyId, JourneyVersion y emitiendo una declaración de ACTUALIZACIÓN.

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

Columnas

Viajes

Crear, actualizar, eliminar y consultar viajes.

Información Específica de la Tabla

Seleccionar

Recuperar viajes con la versión más reciente:

SELECT * FROM Journeys

Recuperar una versión de viaje:

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

Recuperar todas las versiones del viaje:

SELECT * FROM Journeys WHERE MostRecentVersionOnly=false

Recuperar viajes con una etiqueta específica:

SELECT * FROM Journeys WHERE Tag='First_Tag'

Recupere viajes que tengan la cadena de búsqueda especificada dentro del nombre o la descripción:

SELECT * FROM Journeys WHERE NameOrDescription='Journey'

Recuperar recorridos con una versión de API de flujo de trabajo específica:

SELECT * FROM Journeys WHERE workFlowApiVersion=1

Recuperar viajes con versión específica:

SELECT * FROM Journeys WHERE Version=1

Recuperar viajes con estado específico:

SELECT * FROM Journeys WHERE Status='Draft'

Ordene los viajes según la fecha de modificación o la columna de nombre:

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

Insertar

Para crear un nuevo viaje, deberá especificar al menos la columna Nombre.

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

Para crear una nueva versión de viaje, deberá especificar una clave de viaje existente.

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

Actualizar

Los viajes pueden modificarse proporcionando el Id, la Versión del viaje y emitiendo una declaración de ACTUALIZACIÓN.

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

Borrar

Los viajes se pueden eliminar proporcionando la identificación del viaje y emitiendo una declaración DELETE.

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

Las versiones del viaje se pueden eliminar proporcionando el Id., la versión del viaje y emitiendo una declaración DELETE.

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

Columnas

Pseudo-Columnas

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

LineMessengerProperties

Consulta y crea propiedades de mensajero de línea.

Información Específica de la Tabla

Seleccionar

Recuperar todas las propiedades de mensajería de línea registradas:

SELECT * FROM LineMessengerProperties

Recupere una propiedad de mensajería de línea registrada específica:

SELECT * FROM LineMessengerProperties WHERE ID='23493453984234345'

Insertar

Para registrar una nueva propiedad de mensajería de línea, debe especificar ChannelId, ChannelName, ChannelSecret, IsTransactional, IsTestChannel, EndpointUrl y 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')");

Columnas

Suscripciones

Cree, actualice, elimine y consultar suscripciones de notificación de eventos.

Información Específica de la Tabla

Seleccionar

Seleccione todas las suscripciones:

SELECT * FROM Subscriptions

Recuperar una suscripción específica:

SELECT * FROM Subscriptions WHERE SubscriptionId=94766

Insertar

Para crear una suscripción, deberá especificar al menos la columna SubscriptionName, CallbackId y EventCategoryTypes.

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

Actualizar

Las suscripciones se pueden modificar proporcionando la columna SubscriptionId y EventCategoryTypes de la suscripción y emitiendo una instrucción UPDATE.

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

Borrar

Las suscripciones se pueden eliminar proporcionando el SubscriptionId de la suscripción y emitiendo una instrucción DELETE.

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

Columnas

Puntos de Vista

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

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

Jitterbit Connector para Vistas de Salesforce Marketing Cloud

Tipos de Activos

Obtenga todos los tipos de activos disponibles en Salesforce Marketing Cloud.

Información Específica de la Tabla

Seleccionar

Recuperar todos los tipos de activos:

SELECT * FROM AssetTypes

Columnas

Activos de la Campaña

Recupere todos los activos de la campaña en Salesforce Marketing Cloud.

Ver Información Específica

Seleccionar

Seleccione todos los activos de la campaña para una campaña específica:

SELECT * FROM CampaignAssets WHERE CampaignId = '3130'

Recuperar una campaña específica:

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

Columnas

Contacto

Recuperar contactos en Salesforce Marketing Cloud.

Información Específica de la Tabla

Seleccionar

Recuperar todos los contactos:

SELECT * FROM Contact

Nota: La mayoría de las columnas de esta tabla son dinámicas, por lo que es posible que no sean las mismas que las columnas especificadas a continuación porque puede tener un esquema de contacto diferente en su cuenta de la nube de marketing de Salesforce.
No se recuperan los contactos que están en un estado eliminado, eliminando o restringido.

Columnas

Contactos

Recuperar todos los contactos en Salesforce Marketing Cloud.

Información Específica de la Tabla

Seleccionar

Recuperar todos los contactos:

SELECT * FROM Contacts

Nota: La mayoría de las columnas de esta tabla son dinámicas, por lo que es posible que no sean las mismas que las columnas especificadas a continuación porque puede tener un esquema de contacto diferente en su cuenta de la nube de marketing de Salesforce.
No se recuperan los contactos que están en un estado eliminado, eliminando o restringido.

Columnas

JourneyAuditLogs

Recupera un registro de auditoría de un recorrido y sus versiones.

Columnas

SmsStatusCodes

Consulta de códigos de estado de sms.

Información Específica de la Tabla

Seleccionar

Recupere todos los códigos de estado de los siguientes países: EE. UU., Canadá, Brasil e India. Utilice estos códigos para evaluar y identificar y solucionar problemas en sus envíos de SMS.

SELECT * FROM SmsStatusCodes

Columnas

Procedimientos Almacenados

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

Jitterbit Connector para Procedimientos Almacenados de Salesforce Marketing Cloud

CrearImportarEnviarEntregaInforme

Genera un archivo .csv que contiene información sobre la entrega de mensajes SMS para una MessageList específica y coloca el informe en la ubicación FTP mejorada para la cuenta de Marketing Cloud.

Aporte

Columnas del Conjunto de Resultados

Crear Palabra Clave

Crea una palabra clave en una cuenta.

Aporte

Columnas del Conjunto de Resultados

CreateMessageListDeliveryReport

Activa un informe de entrega para la API messageList.

Aporte

Columnas del Conjunto de Resultados

CreateOptInMessage

Crea un mensaje SMS de suscripción que permite a los contactos suscribirse a más mensajes SMS.

Aporte

Columnas del Conjunto de Resultados

Eliminar Palabra Clave

Elimina una palabra clave en una cuenta.

Eliminar Palabra Clave por ID

Elimina una palabra clave en una cuenta dada una identificación de palabra clave.

EXECUTE DeleteKeyword KeywordId='alm5LXNSSktGMGluRznRb1Rb1R5MDZFQTo4Njow'

Eliminar Palabra Clave por Código Largo

Elimina una palabra clave en una cuenta dada una palabra clave y un código largo.

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

Eliminar Palabra Clave por Código Corto

Elimina una palabra clave en una cuenta dada una palabra clave, código corto y código de país.

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

Aporte

Columnas del Conjunto de Resultados

Evento de Entrada de Fuego

Dispara el evento de entrada que inicia el viaje.

Aporte

Columnas del Conjunto de Resultados

GetChannelViewHtml

Devuelve el HTML compilado de la vista de canal solicitada para el recurso.

Aporte

Columnas del Conjunto de Resultados

GetDeliveryStatusOfQueuedMO

Recupera el estado de entrega de un MO en cola.

Aporte

Columnas del Conjunto de Resultados

ObtenerArchivoParaUnActivo

Obtiene el archivo binario de un activo.

Aporte

Columnas del Conjunto de Resultados

GetHeaderFooterAccount

Obtiene el encabezado y el pie de página predeterminados de una cuenta.

Columnas del Conjunto de Resultados

GetHeaderFooterEmail

Obtiene el encabezado y el pie de página de un correo.

Aporte

Columnas del Conjunto de Resultados

ObtenerEstadoImportarEnviar

Recupera el estado de una automatización de ImportSend.

Aporte

Columnas del Conjunto de Resultados

Obtener Estado de Importación

Recupera el estado de un trabajo de importación.

Aporte

Columnas del Conjunto de Resultados

ObtenerEstadoPublicaciónViaje

Recupera el estado de la publicación de un viaje.

Aporte

Columnas del Conjunto de Resultados

GetMessageContactHistory

Recupera el último mensaje enviado a un número de móvil.

Aporte

Columnas del Conjunto de Resultados

Obtener Estado de Contacto de Mensaje

Recupera el estado general de entrega de un mensaje a un contacto.

Aporte

Columnas del Conjunto de Resultados

Obtener Estado de Lista de Mensajes

Devuelve el estado de un mensaje enviado a un grupo de números móviles.

Aporte

Columnas del Conjunto de Resultados

Obtener Token de Acceso de OAuth

Obtiene un token de autenticación de SalesforceMarketingCloud.

Aporte

Columnas del Conjunto de Resultados

Obtener URL de Autorización de OAuth

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

Aporte

Columnas del Conjunto de Resultados

ObtenerRefreshListStatus

Recupera el estado de actualización de la lista.

Aporte

Columnas del Conjunto de Resultados

Obtener Estado de Suscripción

Devuelve el estado de suscripción de números móviles o claves de suscriptor.

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

Aporte

Columnas del Conjunto de Resultados

ObtenerTrackingHistoryOfQueuedMO

Recupera el historial de seguimiento de un MO en cola.

Aporte

Columnas del Conjunto de Resultados

Importar y Enviar Mensaje

Importaciones y envíos.

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\"" +
          "    }]" +
"  }]'

Aporte

Columnas del Conjunto de Resultados

PostMessageToList

Inicia un mensaje a una o más listas de contactos.

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

Aporte

Columnas del Conjunto de Resultados

PublicarMensajeANúmero

Inicia un mensaje a uno o más números móviles.

Suscriptores

Las columnas disponibles para la tabla temporal Suscriptores son las siguientes:

Ejecutar

Use números de teléfono móvil para hacer referencia a registros de contactos:

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'

Utilice la tabla Subscribers#Temp como una forma alternativa de consultar los registros de contacto:

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' 

Aporte

Columnas del Conjunto de Resultados

Publicar Viaje

Publica una versión de viaje de forma asíncrona.

Aporte

Columnas del Conjunto de Resultados

ColaContactoImportar

Pone en cola la importación de un contacto.

Mapas de Campo

Las columnas disponibles para la tabla temporal FieldMaps son las siguientes:

Ejecutar

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

Aporte

Columnas del Conjunto de Resultados

QueueMoMessage

Pone en cola un mensaje MO para su envío.

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'

Aporte

Columnas del Conjunto de Resultados

Actualizar Lista

Actualiza una lista.

Aporte

Columnas del Conjunto de Resultados

RefreshOAuthAccessToken

Actualiza el token de acceso de OAuth utilizado para la autenticación con SalesforceMarketingCloud.

Aporte

Columnas del Conjunto de Resultados

Enviar Mensaje a Destinatario

Envía un mensaje OTT al destinatario. Las redes OTT compatibles son Facebook Messenger y LINE.

Contenido del Mensaje

No puede enviar un mensaje OTT al destinatario sin especificar el contenido del mensaje. Para crear contenidos de mensajes, debe insertar datos en una tabla temporal llamada 'MessageContents#TEMP'. Las columnas disponibles para esta tabla temporal son las siguientes:

MessageCustomKeys

También puede especificar claves personalizadas de mensajes para transferir en la carga útil del mensaje insertando datos en una tabla temporal llamada 'MessageCustomKeys#TEMP'. Las columnas disponibles para esta tabla temporal son las siguientes:

Ejecutar

Enviar mensaje de 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 contenido de 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"

Enviar mensaje de LÍNEA:

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"

Aporte

Columnas del Conjunto de Resultados

Detener Viaje

Detener un viaje corriendo.

Aporte

Columnas del Conjunto de Resultados

Modelo de Datos SOAP

El conector modela las APIs SOAP de Salesforce Marketing Cloud como base de datos Tablas y Vistas. Estos se definen en archivos de esquema, que son archivos de configuración simples basados en texto que facilitan la personalización de los esquemas.

Las limitaciones y los requisitos de la API se documentan en esta sección; puedes usar el SupportEnhancedSQL función, configurada de forma predeterminada, para eludir la mayoría de estas limitaciones.

Mesas

Mesas describe las tablas disponibles. Las tablas se definen estáticamente para modelar activos, categorías, viajes y más.

Puntos de Vista

Puntos de vista son tablas que no se pueden modificar. Normalmente, los datos de solo lectura se muestran como vistas. Procedimientos almacenados* le permiten ejecutar operaciones en Salesforce Marketing Cloud, incluida la descarga y carga de objetos.

Mesas

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

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

Conector Jitterbit para Tablas de Salesforce Marketing Cloud

Cuenta

Una cuenta de Marketing Cloud.

Información Específica de la Tabla

Seleccionar

El conector utiliza las APIs de Salesforce Marketing Cloud para procesar los siguientes operadores de cláusula WHERE para todos los valores excepto de fecha y hora: =, !=, <>, >, >=, <, <=, IN. Para los valores de fecha y hora, solo > y < son compatibles. El conector procesa otros filtros del lado del cliente dentro del conector. Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL a falso, en cuyo caso cualquier criterio de búsqueda que se refiera a otras columnas generará un error.

Por ejemplo, las siguientes consultas (pero no las únicas) se procesan en el lado del 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'

Insertar

Debe especificar la columna Nombre al ejecutar una inserción en esta tabla.

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

Actualizar

Debe especificar el ID en la cláusula WHERE al ejecutar una actualización en esta tabla.

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

Borrar

Debe especificar el ID en la cláusula WHERE al ejecutar una eliminación en esta tabla.

DELETE FROM Account WHERE ID = 123

Columnas

Usuario de Cuenta

Un usuario individual dentro de una cuenta. Esta tabla no admite eliminaciones.

Información Específica de la Tabla

Seleccionar

El conector utiliza las APIs de Salesforce Marketing Cloud para procesar los siguientes operadores de cláusula WHERE para todos los valores excepto de fecha y hora: =, !=, <>, >, >=, <, <=, IN. Para los valores de fecha y hora, solo > y < son compatibles. El conector procesa otros filtros del lado del cliente dentro del conector. Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL a falso, en cuyo caso cualquier criterio de búsqueda que se refiera a otras columnas generará un error.

Por ejemplo, las siguientes consultas (pero no las únicas) se procesan en el lado del 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'

Insertar

Debe especificar los siguientes campos al insertar en esta tabla: Client_Id, Name, Correo, UserID y Password.

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

Actualizar

Debe especificar el ID y el Client_Id en la cláusula WHERE al ejecutar una actualización en esta tabla.

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

Columnas

Unidad de Negocio

Una unidad dentro de una cuenta Enterprise o Enterprise 2.0 más grande. Esta tabla solo admite consultas y actualizaciones.

Información Específica de la Tabla

Seleccionar

El conector utiliza las APIs de Salesforce Marketing Cloud para procesar los siguientes operadores de cláusula WHERE para todos los valores excepto de fecha y hora: =, !=, <>, >, >=, <, <=, IN. Para los valores de fecha y hora, solo > y < son compatibles. El conector procesa otros filtros del lado del cliente dentro del conector. Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL a falso, en cuyo caso cualquier criterio de búsqueda que se refiera a otras columnas generará un error.

Por ejemplo, las siguientes consultas (pero no las únicas) se procesan en el lado del 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'

Actualizar

Debe especificar el ID en la cláusula WHERE al ejecutar una actualización en esta tabla.

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

Columnas

Área de Contenido

Un ContentArea representa una sección definida de contenido reutilizable.

Información Específica de la Tabla

Seleccionar

El conector utiliza las APIs de Salesforce Marketing Cloud para procesar los siguientes operadores de cláusula WHERE para todos los valores excepto de fecha y hora: =, !=, <>, >, >=, <, <=, IN. Para los valores de fecha y hora, solo > y < son compatibles. El conector procesa otros filtros del lado del cliente dentro del conector. Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL a falso, en cuyo caso cualquier criterio de búsqueda que se refiera a otras columnas generará un error.

Por ejemplo, las siguientes consultas (pero no las únicas) se procesan en el lado del 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'

Insertar

Debe especificar los siguientes campos al insertar en esta tabla: Nombre y Contenido.

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

Actualizar

Debe especificar el ID en la cláusula WHERE al ejecutar una actualización en esta tabla.

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

Borrar

Debe especificar el ID en la cláusula WHERE al ejecutar una eliminación en esta tabla.

DELETE FROM ContentArea WHERE ID = 123

Columnas

Extensión de Datos

Representa una extensión de datos dentro de una cuenta.

Información Específica de la Tabla

Seleccionar

El conector utiliza las APIs de Salesforce Marketing Cloud para procesar los siguientes operadores de cláusula WHERE para todos los valores excepto de fecha y hora: =, !=, <>, >, >=, <, <=, IN. Para los valores de fecha y hora, solo > y < son compatibles. El conector procesa otros filtros del lado del cliente dentro del conector. Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL a falso, en cuyo caso cualquier criterio de búsqueda que se refiera a otras columnas generará un error.

Por ejemplo, las siguientes consultas (pero no las únicas) se procesan en el lado del servidor:

SELECT * FROM DataExtension

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

Insertar

Debe especificar los siguientes campos al insertar en esta tabla: Nombre, Clave de cliente y Campos.

Nota: Las APIs de Salesforce Marketing Cloud tienen problemas con extensiones de datos con nombres de más de 40 caracteres. Trate de limitar el nombre a algo relativamente corto.

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

Actualizar

Debe especificar ObjectId o CustomerKey o Name en la cláusula WHERE al ejecutar una actualización en esta tabla.

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

Borrar

Debe especificar ObjectId o CustomerKey o Name en la cláusula WHERE al ejecutar una eliminación en esta tabla.

DELETE FROM DataExtension WHERE ObjectId = 'nzxcaslkjd-123'

Columnas

Pseudo-Columnas

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

Correo

Representa un correo en una cuenta de Marketing Cloud.

Información Específica de la Tabla

Seleccionar

El conector utiliza las APIs de Salesforce Marketing Cloud para procesar los siguientes operadores de cláusula WHERE para todos los valores excepto de fecha y hora: =, !=, <>, >, >=, <, <=, IN. Para los valores de fecha y hora, solo > y < son compatibles. El conector procesa otros filtros del lado del cliente dentro del conector. Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL a falso, en cuyo caso cualquier criterio de búsqueda que se refiera a otras columnas generará un error.

Por ejemplo, las siguientes consultas (pero no las únicas) se procesan en el lado del 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'

Insertar

Debe especificar los siguientes campos al insertar en esta tabla: Nombre y Asunto.

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

Actualizar

Debe especificar el ID en la cláusula WHERE al ejecutar una actualización en esta tabla.

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

Borrar

Debe especificar el ID en la cláusula WHERE al ejecutar una eliminación en esta tabla.

DELETE FROM Email WHERE ID = 123

Columnas

EmailSendDefinition

Registro que contiene la información del mensaje, el perfil del remitente, el perfil de entrega y la información de la audiencia.

Información Específica de la Tabla

Seleccionar

El conector utiliza las APIs de Salesforce Marketing Cloud para procesar los siguientes operadores de cláusula WHERE para todos los valores excepto de fecha y hora: =, !=, <>, >, >=, <, <=, IN. Para los valores de fecha y hora, solo > y < son compatibles. El conector procesa otros filtros del lado del cliente dentro del conector. Puede desactivar la ejecución de la consultar en el lado del cliente configurando SupportEnhancedSQL a falso, en cuyo caso cualquier criterio de búsqueda que se refiera a otras columnas generará un error.

Por ejemplo, las siguientes consultas (pero no las únicas) se procesan en el lado del 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'

Insertar

Debe especificar los siguientes campos al insertar en esta tabla: Nombre, SendClassification_CustomerKey y Email_Id.

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

Actualizar

Debe especificar el ID en la cláusula WHERE al ejecutar una actualización en esta tabla.

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

Borrar

Debe especificar el ID en la cláusula WHERE al ejecutar una eliminación en esta tabla.

DELETE FROM EmailSendDefinition WHERE ObjectId = 'sdfsdf123'

Columnas