Asistente de proceso masivo de Salesforce para la acción de upsert en Jitterbit Design Studio

Introducción

Esta página describe cómo crear una acción de Upsert de Proceso Masivo de Salesforce utilizando el Asistente de Proceso Masivo de Salesforce en Jitterbit Design Studio. La acción de Upsert de Proceso Masivo de Salesforce permite insertar múltiples registros o (en el caso de que un registro ya exista) actualizar un registro existente, a través de una instancia de Salesforce conectada. Una acción de Upsert actualiza o inserta registros, dependiendo de los datos proporcionados.

El proceso para la acción de Proceso Masivo de Upsert es ligeramente diferente al proceso para las acciones de Consulta, insertar, actualizar, eliminar o eliminar de forma permanente. La acción de Proceso Masivo de Upsert requiere que selecciones un campo de ID externo para el objeto de Salesforce seleccionado. Las acciones de Proceso Masivo de Consulta, Inserción, Actualización, Eliminación y Eliminación Permanente no requieren un campo de ID externo y no incluyen este paso.

Antes de avanzar a estos pasos, consulta Asistente de proceso masivo de Salesforce para obtener instrucciones sobre cómo iniciar el Asistente de Proceso Masivo de Salesforce.

Seleccionar el objeto de Salesforce

En la pantalla de Objeto, selecciona el objeto de Salesforce y el Campo de ID Externo que utilizará la operación.

Para seleccionar un Campo de ID Externo, haz clic en el botón Seleccionar Campo. En este ejemplo, se seleccionaron el objeto Cuenta y luego el campo Id:

Haz clic en OK, luego haz clic en Siguiente para pasar a Definir la fuente.

Definir la fuente

Seleccionar de dónde provienen tus datos de origen

La fuente es la ubicación de los datos que se utilizarán en la operación. Para el Asistente de Proceso Masivo de Salesforce, la fuente debe ser un archivo plano con un encabezado. No se admiten bases de datos. Para la Fuente de archivo, selecciona Archivo local, Sitio FTP, Compartición de archivos o Almacenamiento temporal.

Dado que la fuente necesitará ser un archivo plano para el Asistente de Proceso Masivo de Salesforce, puedes opcionalmente agregar validación de filas y campos. Si lo prefieres, puedes agregar una fuente más tarde en el desarrollo del proyecto. Para detalles sobre las diferentes fuentes, consulta Fuentes.

Selecciona una de las siguientes opciones:

• Un Tipo de fuente existente del menú desplegable (uno de Archivo local, Sitio FTP, Compartición de archivos, Almacenamiento temporal o HTTP).
• Selecciona Crear nuevo para crear una nueva fuente del tipo actualmente seleccionado.

Crear una nueva fuente

Para crear una nueva fuente, selecciona la opción Nueva fuente del menú desplegable:

Fuentes de archivo

Para fuentes de archivo (Archivo local, Sitio FTP, Compartición de archivos o Almacenamiento temporal), selecciona o crea una fuente y luego selecciona o crea un formato de archivo para usar con esa fuente.

Archivo local

Si seleccionas un Archivo Local como fuente, haz clic en Examinar para seleccionar un archivo. Alternativamente, si deseas usar un archivo local que se ha utilizado previamente con Jitterbit Design Studio, haz clic en Seleccionar una Fuente de Archivo Local Existente y utiliza el menú desplegable para seleccionar un archivo utilizado anteriormente.

Confirma el archivo seleccionado después de revisar las primeras diez líneas del archivo:

Haz clic en Continuar para pasar a la pantalla de Asignaciones.

Sitio FTP, Compartición de Archivos o Almacenamiento Temporal

Si deseas usar un Sitio FTP existente como fuente, utiliza el menú desplegable Tipo para seleccionar tu Sitio FTP. De lo contrario, selecciona Crear Nuevo en el menú desplegable y completa los Parámetros de Conexión.

Seleccionar archivo de muestra

Examinar tu computadora y selecciona un archivo de muestra que contenga el mismo formato que el archivo que deseas enviar a Salesforce. Design Studio utilizará esta información en la pantalla de Asignaciones.

Haz clic en Siguiente para pasar a la pantalla de Asignaciones.

Mapeo de transformación

Mapea los encabezados del archivo fuente a los campos correspondientes de Salesforce. Aparte de los encabezados, el Proceso Masivo no involucra ningún otro mapeo.

Puedes mapear:

• Arrastrando y soltando un Encabezado de Archivo de Origen a un Campo de Salesforce.

• Seleccionando campos de Origen y Salesforce juntos y luego haciendo clic en el botón Mapear.

• El botón Auto Mapear mapea basándose en nombres coincidentes entre los Encabezados de Archivos de Origen y los Campos de Salesforce.

• El botón Importar Mapeos desde Archivo importa un conjunto de mapeos guardados previamente desde un archivo.

• El botón Guardar Mapeos en Archivo guarda todos los mapeos en un archivo local.

• El botón Mapear mapea entre los campos de origen y destino seleccionados.

• El botón Eliminar elimina un mapeo seleccionado.

• El botón Comenzar de Nuevo elimina todos los mapeos y comienza de nuevo.

• Cuando termines, haz clic en Siguiente para pasar a Crear un horario y establecer opciones.

Crear un horario y seleccionar opciones

Crear o establecer un horario es opcional y se puede hacer en un momento posterior. Para más detalles sobre la programación, consulta Horarios. Puedes editar un horario existente abriéndolo en la categoría de Horarios del panel de elementos del proyecto y haciendo los ajustes deseados. Puedes usar esta pantalla del asistente para agregar un horario a una operación no programada o abrir la operación en el panel de elementos del proyecto y hacer los ajustes apropiados.

• Establece la Ocurrencia, Frecuencia Diaria (horas o minutos) y Duración de la operación.
• Al establecer la Duración, ten en cuenta que las fechas de Inicio y Fin en un horario son inclusivas.
• Para mostrar estas opciones, abre los caret junto a Ocurrencia, Frecuencia Diaria y Duración.
• Cuando termines, haz clic en Siguiente para pasar a Pantalla de resumen.

Pantalla de resumen

En la pantalla de Resumen, puedes editar el nombre dado al asistente:

Haz clic en Finalizar para completar el asistente.

Proceso masivo de Salesforce completado

Una vez completado, serás llevado a la pantalla de Resumen para el nuevo Proceso Masivo de Salesforce. Puedes regresar a esta página de resumen encontrando su nombre de operación bajo Jitterbit Connect en el panel de elementos del proyecto.

• Puedes modificar cualquiera de los elementos de diseño en tu proyecto, como Inicio de sesión de Salesforce, Mapeos, Leer datos de, Operación y Ejecutar según programación haciendo clic en el Editar adyacente.
• Las funciones de los botones Ejecutar Bulk Upsert, Historial de resultados y Eliminar se describen a continuación en Desplegar el proyecto y ejecutar la operación (Las etiquetas reales y los botones disponibles variarán dependiendo del asistente de Proceso Masivo particular utilizado. Este ejemplo muestra el asistente de Bulk Insert).
• Las Opciones avanzadas incluyen opciones de operación como fragmentación y truncamiento de campos. Se cubren a continuación en Opciones avanzadas.

Opciones avanzadas

Estas opciones avanzadas están disponibles para una acción de Bulk Upsert de Salesforce:

Opciones de archivo

• Leer como UTF-8: Selecciona para leer el archivo fuente como codificación de caracteres UTF-8.
• Escribir como UTF-8: Selecciona para escribir el archivo de destino como codificación de caracteres UTF-8.
• Opciones de fecha: Muestra un diálogo para establecer las opciones de fecha para la fuente. Consulta la página Avanzado de Salesforce.
• Comenzar en la fila de datos: Proporciona el número de fila de la primera fila del archivo fuente que se considerará como datos.

Opciones de operación

• Configuraciones de Lote: Muestra un diálogo para establecer las configuraciones de lote. Consulta la página de Salesforce avanzado.
• Modo Serial: Si se selecciona, permite la inserción de valores nulos en un registro.
• Comprimir Datos: Por defecto, la compresión está activada.
• El fragmentado no está disponible para operaciones de Proceso por Lote. Consulta Configuraciones de Lote en la página de Salesforce avanzado en su lugar.

Opciones adicionales de operación para escribir registros de éxito y fracaso se describen en la página de Salesforce avanzado.

Desplegar el proyecto y ejecutar la operación

Una vez que hayas configurado la acción de Proceso por Lote, puedes desplegar y ejecutar la operación. También puedes ver archivos de éxito y fracaso si utilizas agentes privados.

Desplegar el proyecto

Desplegar un proyecto antes de ejecutarlo no es necesario, ya que se desplegará automáticamente si es necesario.

Para desplegar el proyecto, haz una de las siguientes acciones:

• Haz clic en el botón Desplegar en la barra de herramientas.

• En el panel de elementos del proyecto, haz clic derecho en el Nombre del proyecto recién creado y luego haz clic en Desplegar en el menú desplegable resultante.

• Haz clic en Operaciones en la parte superior del panel de elementos del proyecto y luego haz clic en Desplegar en el menú desplegable resultante.

El proceso de despliegue del proyecto comenzará a enviar el proyecto a Harmony, y aparecerá un mensaje de progreso.

• Para ejecutar el mensaje de progreso en segundo plano, haz clic en Ejecutar en Segundo Plano.

• Para cancelar el proceso de despliegue, haz clic en Cancelar, lo que te devolverá a la pantalla anterior.

La operación ahora está completa y desplegada.

Ejecutar la operación

Haga clic en el botón Ejecutar Bulk Upsert para colocar la operación en la cola para su ejecución.

Si el proyecto no se ha desplegado ya, o ha sido modificado desde el último despliegue, se desplegará automáticamente. Consulte Crear una operación para obtener información adicional sobre cómo crear, desplegar y ejecutar operaciones.

• El Monitor de Operaciones se muestra en la parte inferior de la pantalla, rastreando el estado, la hora de recepción, la hora de inicio y la hora en que la operación completó el procesamiento.

• Cuando la operación completa el procesamiento, el diálogo de Resultado mostrará la hora de finalización, el estado, el número de registros que se procesaron con éxito y el número de registros que no se pudieron procesar. Los botones Ver Archivo de Éxito y Ver Archivo de Fallo se describen a continuación.

Haga clic en el botón Historial de Resultados para mostrar una lista de actividades recientes que incluye la hora de finalización, el estado, el número de registros procesados con éxito y el número de registros que no se pudieron procesar. Seleccione un resultado en la lista para habilitar los botones Ver Archivo de Éxito y Ver Archivo de Fallo, que se describen a continuación.

Haga clic en el botón Eliminar para eliminar la operación del proyecto.

• Se mostrará la ventana de diálogo Confirmar Eliminación. Haga clic en Eliminar para confirmar y eliminar la operación.
• El diálogo Eliminar Elementos del Asistente mostrará los componentes de operación asociados.
  • Seleccione Sí para eliminar los objetos del asistente asociados además de la operación de inserción.
  • Si selecciona No, los objetos del asistente permanecerán disponibles dentro del proyecto. Solo se elimina la operación de inserción.
  • Seleccionar Cancelar cancela la eliminación de la operación de inserción y de los objetos del asistente asociados.

Consulte Crear una operación para obtener información adicional sobre cómo crear, desplegar y ejecutar operaciones.

Ver archivos de éxito y fracaso

Ver archivos de éxito y fracaso está disponible si estás ejecutando operaciones en un agente privado. Los botones Ver archivo de éxito y Ver archivo de fracaso están disponibles después de hacer clic en el botón Ejecutar o en el botón Historial de resultados como se describió anteriormente y luego seleccionar uno de los resultados. Este es un ejemplo del cuadro de diálogo Historial de resultados, que muestra los botones y un resultado seleccionado:

• Ver archivo de éxito: Si estás ejecutando la operación en un agente privado, seleccionar el botón Ver archivo de éxito muestra los primeros 100 registros que se procesaron con éxito.
• Ver archivo de fracaso: Si estás ejecutando la operación en un agente privado, seleccionar el botón Ver archivo de fracaso muestra los primeros 100 registros que no se pudieron procesar.

En este ejemplo, se muestran tres registros:

• Copiar archivo a: Guarda los registros de éxito o fracaso en un archivo CSV con el nombre de archivo predeterminado salesforce.csv.
• Abrir programa externo: Esta opción actualmente no está disponible.