Asistente de proceso masivo de Salesforce para acciones de consulta, inserción, actualización, eliminación o eliminación permanente en Jitterbit Design Studio

Introducción

Esta página describe cómo crear una acción de Consulta, Inserción, Actualización, Eliminación o Eliminación Permanente masiva de Salesforce utilizando el Asistente de Proceso Masivo de Salesforce en Jitterbit Design Studio.

• Una acción de Consulta Masiva de Salesforce consulta un gran número de registros desde un endpoint de Salesforce.
• Una acción de Inserción Masiva de Salesforce inserta nuevos datos en un endpoint de Salesforce.
• Una acción de Actualización Masiva de Salesforce actualiza datos existentes en un endpoint de Salesforce.
• Una acción de Eliminación Masiva o Eliminación Permanente Masiva de Salesforce elimina un gran número de registros existentes en un endpoint de Salesforce.

Las acciones de Proceso Masivo de Consulta, Inserción, Actualización, Eliminación o Eliminación Permanente son ligeramente diferentes al proceso para la acción de inserción masiva. A diferencia de la acción de Inserción Masiva, 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 los siguientes pasos, consulta el asistente de proceso masivo de Salesforce para obtener instrucciones sobre cómo iniciar el Asistente de Proceso Masivo de Salesforce.

Selecciona el objeto de Salesforce

En la pantalla de Objetos, selecciona el objeto de Salesforce que utilizará la operación.

Haz clic en Siguiente para pasar a Definir la fuente.

Definir la fuente

Selecciona 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 tu 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 la documentación sobre Fuentes.

Selecciona uno de:

• 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

Examina 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 Mapeos.

Mapeo de transformación

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

Puedes mapear:

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

• Seleccionando los 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 mapeo guardado 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.

• Establezca la Ocurrencia, Frecuencia Diaria (horas o minutos) y Duración de la operación.
• Al establecer la Duración, tenga en cuenta que las fechas de Inicio y Fin en un horario son inclusivas.
• Para mostrar estas opciones, abra los carets junto a Ocurrencia, Frecuencia Diaria y Duración.
• Cuando haya terminado, haga clic en Siguiente para pasar a la pantalla de Resumen.

Pantalla de Resumen

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

Haga clic en Finalizar para completar el asistente.

Proceso masivo de Salesforce completado

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

• Puede modificar cualquiera de los elementos de diseño en su proyecto, como Inicio de Sesión de Salesforce, Mapas, Leer Datos Desde, Operación y Ejecutar según el Horario haciendo clic en el Editar adyacente.
• Las funciones de los botones Ejecutar Masivo..., 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 Inserción Masiva).
• 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

Las siguientes opciones avanzadas están disponibles para un Proceso Masivo de Salesforce.

Para una acción de Consulta:

Para una acción de Insertar o Actualizar:

Para una acción de Eliminar o Eliminar Permanentemente (las opciones de fecha están deshabilitadas):

Opciones de archivo

• Leer como UTF-8: Seleccione para leer el archivo fuente como codificación de caracteres UTF-8.
• Escribir como UTF-8: Seleccione 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. Consulte la página de Salesforce avanzado.
• 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 masivas. Consulte 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 particionamiento no está disponible para operaciones de Proceso Masivo. Consulte 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 haya configurado la acción de Proceso Masivo, puede desplegar y ejecutar la operación. También puede ver archivos de éxito y fracaso si utiliza agentes privados.

Desplegar el proyecto

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

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

• Haz clic en el ícono de Desplegar en la barra de herramientas.

• En el panel de elementos del proyecto, haz clic 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 regresará a la pantalla anterior.

La operación ahora está completa y desplegada.

Ejecutar la operación

Esta imagen muestra los botones disponibles en las páginas de resumen del Asistente de Proceso Masivo de Salesforce. Las etiquetas (como Ejecutar Consulta Masiva o Ejecutar Inserción Masiva) variarán dependiendo del asistente específico que estés utilizando.

Haz clic en Ejecutar Masivo... para colocar la operación en la cola para su ejecución.

Si el proyecto no ha sido desplegado previamente, o ha sido modificado desde el último despliegue, se desplegará automáticamente. Consulta 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.

Haz clic en el botón Historial de Resultados para mostrar una lista de actividades recientes, incluyendo 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. Selecciona un resultado en la lista para habilitar los botones Ver Archivo de Éxito y Ver Archivo de Fallo, que se describen a continuación.

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

• Se mostrará la ventana de diálogo Confirmar Eliminación. Haz clic en Eliminar para confirmar y eliminar la operación.
• La ventana de diálogo Eliminar Elementos del Asistente mostrará los componentes de operación asociados.
  • Selecciona Sí para eliminar los objetos del asistente asociados además de la operación de inserción.
  • Si seleccionas No, los objetos del asistente permanecerán disponibles dentro del proyecto. Solo se eliminará 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.

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

Ver archivos de éxito y fallo

La visualización de archivos de éxito y fallo está disponible si estás ejecutando operaciones en un agente privado. Los botones Ver Archivo de Éxito y Ver Archivo de Fallo 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 diálogo Historial de Resultados, mostrando 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 en una ventana emergente.
• Ver Archivo de Fallo: Si estás ejecutando la operación en un agente privado, seleccionar el botón Ver Archivo de Fallo muestra los primeros 100 registros que no se pudieron procesar en una ventana emergente.

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.