Utilización de la actividad Crear definición de importación de la API masiva de Eloqua
Utilice la actividad Crear definición de importación para crear una definición de importación en Eloqua.
Utilice esta tarea para crear una definición de importación en Eloqua. La llamada a esta actividad es una llamada síncrona en la que se envían los datos de entrada a la actividad para ser procesados y se devuelve la respuesta a la orquestación.
Para configurar la actividad Crear definición de importación de la API masiva de Eloqua:
- En una orquestación activa, abra el separador Actividades y expanda el contenido de la carpeta API masiva de Eloqua.
- Arrastre el icono de la actividad Crear definición de importación a la orquestación. Se mostrará la lista de comprobación de Crear definición de importación de la API masiva de Eloqua.
- En la lista de comprobación, pulse Resumen.
- Revise el contenido del campo Nombre de actividad y realice los cambios necesarios.
- En la lista de comprobación, pulse Elegir punto final.
- Pulse Examinar y utilice el recuadro de diálogo Explorador de proyectos para seleccionar el correspondiente punto final de la API masiva de Eloqua.
- Para realizar los cambios que sean necesarios en la configuración de punto final seleccionada, pulse Editar para acceder a las opciones en una ventana separada. Cualquier cambio que se realice afectará de forma global a todos los usos del punto final en las orquestaciones activas.
- En la lista de comprobación, pulse Configurar.
- Pulse Examinar para seleccionar el tipo de objeto. Se mostrará la ventana Examinar API masiva de Eloqua.
- En Examinar API masiva de Eloqua, puede filtrar el tipo de objeto especificando este último en el campo Buscar un tipo de objeto o bien puede seleccionar el tipo de objeto en la lista de tipos de objeto. Pulse Aceptar. Se muestran las preferencias del campo del objeto.
- En Preferencias del campo objeto, seleccione los campos que desea correlacionar marcando los correspondientes recuadros de selección del nombre del campo.
- En la lista de comprobación, pulse Reintentar. Revise los valores predeterminados y realice los cambios que sean necesarios.
- Seleccione las Entradas de correlación en la lista de comprobación. Los esquemas XML generados a partir del objeto seleccionado de la actividad Crear definición de importación se muestran como nodos bajo el parámetro de entrada de la solicitud en el panel A actividad.
- Cree una correlación entre las variables de orquestación y el parámetro de entrada de la actividad.
Campos obligatorios: la actividad tiene los campos obligatorios siguientes:
- name: nombre de la definición. Resulta de utilidad para reutilizar las definiciones.
- identifierFieldName: especifica qué campo se va a utilizar para comparar los datos importados con los datos de Eloqua existentes.
- fields: tiene los campos siguientes:
- sourceField: sería uno de los nombres de columna de los datos de origen.
- EloquaDestinationField: el nombre de columna de Eloqua con el que se correlacionarían los datos de sourceField.
Campos opcionales: la actividad tiene los campos opcionales siguientes:
- autoDeleteDuration: tiempo hasta que se suprime la definición.
- dataRetentionDuration: tiempo hasta que se suprimen los datos por etapas.
- isUpdatingMultipleMatchedRecords: especifica si Eloqua debe actualizar varios registros si coinciden varios registros con identifierFieldName.
- updateRule: están disponibles los tipos de regla siguientes:
- always: actualizar siempre.
- ifNewIsNotNull: actualizar si el nuevo valor no está en blanco.
- ifExistingIsNull: actualizar si el valor existente está en blanco.
- useFieldRule: utilizar la regla definida en el nivel de campo.
- syncActions: especifica operaciones adicionales que se van a realizar durante el importación. Tiene los campos siguientes:
- action: especifica qué acción se va a realizar. La acción puede ser add, remove o setStatus.
- destination: especifica dónde debe tener lugar la acción. Para las acciones add o remove, sería el URI de una lista o grupo de correo electrónico. Para setStatus, podría ser el URI de un servicio de acción de AppCloud o un servicio de decisiones.
- status: especifica en qué estado se establecería para una acción setStatus. Están disponibles los estados siguientes: subscribed, unsubscribed, active, complete, pending, errored, yes y no.
Nota: Los valores deben proporcionarse durante el tiempo de ejecución para todos los elementos obligatorios de la estructura de entrada. Se puede indicar un valor especificando un valor predeterminado para el elemento o enlazando el elemento con un nodo de entrada. Durante el tiempo de ejecución, si no se suministra ningún valor para un elemento obligatorio, la actividad lanza una excepción que es notificada por la consola de gestión web (WMC).
Si no se proporciona un valor en tiempo de ejecución para un parámetro opcional de entrada, no se lanza ninguna excepción durante el tiempo de ejecución.
- Seleccione Correlacionar salidas en la lista de comprobación. El esquema XML generado para contener la respuesta de la actividad se muestra como nodos bajo el parámetro de salida de respuesta en el panel Desde actividad.
- Cree una correlación entre los parámetros de salida y las variables de orquestación.
Habrá configurado la actividad Crear definición de importación de la API masiva de Eloqua.