Asistente de procesamiento masivo de Salesforce para la acción upsert

Introducción

Esta página describe cómo crear una acción Upsert de proceso masivo de Salesforce mediante el Asistente de proceso masivo de Salesforce en Jitterbit Design Studio. La acción Upsert de proceso masivo de Salesforce le permite insertar varios registros o (en el caso de un registro ya existente) actualizar un registro existente, a través de una instancia de Salesforce conectada. Una acción Upsert actualiza o inserta registros, según los datos proporcionados.

El proceso para la acción de proceso masivo de inserción y actualización es ligeramente diferente al proceso para Consultar, insertar, actualizar, eliminar o eliminar definitivamente Acciones de proceso masivo. La acción de proceso masivo Upsert requiere que seleccione un campo de ID externo para el objeto de Salesforce seleccionado. Las acciones de proceso masivo Consultar, Insertar, Actualizar, Eliminar y Eliminar definitivamente no requieren un campo de ID externo y no incluyen este paso.

Antes de seguir estos pasos, consulte Asistente de proceso masivo de Salesforce para obtener instrucciones sobre cómo iniciar el Asistente de proceso masivo de Salesforce.

Seleccione el objeto de Salesforce

En la pantalla Objeto, seleccione el objeto de Salesforce y el campo de identificación externa que utilizará la operación.

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

Haga clic en Aceptar y luego en Siguiente para pasar a Definir la fuente.

Definir la fuente

Seleccione de dónde provienen sus 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 una fuente de archivo sin formato con un encabezado. No se admiten bases de datos. Para Fuente de archivo seleccione Archivo local, Sitio FTP, Compartir archivos o Almacenamiento temporal.

Dado que la fuente deberá ser un archivo plano para el Asistente de proceso masivo de Salesforce, puede agregar opcionalmente validación de filas y campos. Si lo prefiere, puede agregar una fuente más adelante en el desarrollo del proyecto. Para obtener detalles sobre las diferentes fuentes, consulte Fuentes.

Seleccione una de las siguientes opciones:

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

Crear una nueva fuente

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

Fuentes de archivos

Para las fuentes de archivos (archivo local, sitio FTP, recurso compartido de archivos o almacenamiento temporal), seleccione o cree una fuente y luego seleccione o cree un formato de archivo para usar con esa fuente.

Archivo local

Si selecciona un Archivo local como fuente, haga clic en Explorar para seleccionar un archivo. De manera alternativa, si desea utilizar un archivo local que se haya utilizado previamente con Jitterbit Design Studio, haga clic en Seleccionar una fuente de archivo local existente y utilice el menú desplegable para seleccionar un archivo utilizado previamente.

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

Haga clic en Continuar para pasar a Asignaciones pantalla.

Sitio FTP, recurso compartido de archivos o almacenamiento temporal

Si desea utilizar un sitio FTP existente como fuente, utilice el menú desplegable Tipo para seleccionar su sitio FTP. De lo contrario, seleccione Crear nuevo en el menú desplegable y complete los Parámetros de conexión.

Seleccionar archivo de muestra

Explore su computadora y seleccione un archivo de muestra que contenga el mismo formato que el archivo que desea enviar a Salesforce. Design Studio utilizará esta información en Mappings pantalla.

Haga clic en Siguiente para pasar a Asignaciones pantalla.

Mapeo de Transformación

Asigna los encabezados del archivo de origen a los campos de Salesforce correspondientes. Aparte de los encabezados, el proceso masivo no implica ninguna otra asignación.

Puedes mapear:

• Arrastrando y soltando un Encabezado de archivo de origen en un Campo de Salesforce.

• Seleccionando los campos Fuente y Salesforce juntos y luego haciendo clic en el botón Mapa.

• El botón Asignar automáticamente asigna en función de los nombres coincidentes entre los Encabezados de archivo de origen y los Campos de Salesforce.

• El botón Importar asignaciones desde archivo importa un conjunto de asignaciones previamente guardadas desde un archivo.

• El botón Guardar asignaciones en archivo guarda todas las asignaciones en un archivo local.

• El botón Mapa asigna mapas entre los campos de origen y destino seleccionados.

• El botón Eliminar elimina una asignación seleccionada.

• El botón Comenzar de nuevo elimina todas las asignaciones y comienza de nuevo.

• Cuando haya terminado, haga clic en Siguiente para pasar a Crear un cronograma y establecer opciones.

Crear un horario y seleccionar opciones

La creación o configuración de un cronograma es opcional y se puede realizar en otro momento. Para obtener más detalles sobre la programación, consulte Cronogramas. Puede editar un cronograma existente abriéndolo en la categoría Cronogramas del panel de elementos del proyecto y realizando los ajustes que desee. Puede utilizar esta pantalla del asistente para agregar un cronograma a una operación no programada o abrir la operación en el panel de elementos del proyecto y realizar los ajustes correspondientes.

• Establezca la Ocurrencia, la Frecuencia diaria (horas o minutos) y la Duración de la operación.
• Al configurar la Duración, tenga en cuenta que las fechas de Inicio en y Finalización en en un cronograma son inclusivas.
• Para mostrar estas opciones, abra los triángulos desplegables 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 Resumen, puede editar el nombre dado al asistente:

Haga clic en Finalizar para completar el asistente.

Proceso masivo de Salesforce completado

Una vez completado, accederá a la pantalla Resumen del nuevo proceso masivo de Salesforce. Puede volver a esta página de resumen buscando el nombre de la operación en Jitterbit Connect en el panel de elementos del proyecto.

• Puede modificar cualquiera de los elementos de diseño de su proyecto, como Inicio de sesión de Salesforce, Asignaciones, Leer datos de, Operación y Ejecutar según programación, haciendo clic en Editar adyacente.
• Las funciones de los botones Ejecutar actualización masiva, 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 según el 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 de datos y truncamiento de campos. Se describen a continuación en Opciones avanzadas.

Opciones avanzadas

Estas opciones avanzadas están disponibles para una acción de inserción masiva de Salesforce:

Opciones de archivo

• Leer como UTF-8: Seleccione esta opción para leer el archivo de origen como codificación de caracteres UTF-8.
• Escribir como UTF-8: Seleccione esta opción para escribir el archivo de destino como codificación de caracteres UTF-8.
• Opciones de fecha: Muestra un cuadro de diálogo para configurar las opciones de fecha para la fuente. Consulte Opciones avanzadas de Salesforce página.
• Comenzar en la fila de datos: Proporciona el número de fila de la primera fila del archivo de origen que se considerará como datos.

Opciones de operación

• Configuración por lotes: Muestra un cuadro de diálogo para configurar la configuración por lotes. Consulte Avanzado de Salesforce página.
• Modo serie: Si se selecciona, permite la inserción de valores nulos en un registro.
• Comprimir datos: De forma predeterminada, la compresión está activada.
• La fragmentación no está disponible para las operaciones de procesamiento masivo. Consulte Configuración de lotes en Salesforce Advanced página en su lugar.

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

Desplegar el proyecto y ejecutar la operación

Una vez que haya configurado la acción Procesar en masa, puede desplegar y ejecutar la operación. También puede ver los 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, realice una de las siguientes acciones:

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

• En el panel de elementos del proyecto, haga clic con el botón derecho en el Nombre del proyecto que acaba de crear y, luego, haga clic en Desplegar en el menú desplegable resultante.

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

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

• Para ejecutar el mensaje de progreso en segundo plano, haga clic en Ejecutar en segundo plano.

• Para cancelar el proceso de desplegar, haga clic en Cancelar, lo que lo regresará a la pantalla anterior.

La operación ya está completa y desplegada.

Ejecutar la operación

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

Si el proyecto aún no se ha implementado o ha cambiado desde la última desplegar, se desplegará automáticamente. Consulte Crear una operación para obtener información adicional sobre la creación, despliegue y ejecución de operaciones.

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

• Cuando la operación finaliza su procesamiento, el cuadro de diálogo Resultado mostrará la hora de finalización, el estado, la cantidad de registros que se procesaron correctamente y la cantidad de registros que no se procesaron. Los botones Ver archivo de resultados correctos y Ver archivo de errores se describen a continuación.

Haga clic en el botón Historial de resultados para mostrar una lista de actividades recientes, que incluye el tiempo de finalización, el estado, la cantidad de registros procesados correctamente y la cantidad de registros que no se procesaron. Seleccione un resultado de la lista para habilitar los botones Ver archivo de resultados correctos y Ver archivo de errores, que se describen a continuación.

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

• Aparecerá la ventana de diálogo Confirmar eliminación. Haga clic en Eliminar para confirmar y eliminar la operación.
• El cuadro de diálogo Eliminar elementos del asistente mostrará los componentes de la 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 eliminará la operación de inserción.
  • Al seleccionar Cancelar se cancela la eliminación de la operación de inserción y los objetos del asistente asociados.

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

Ver archivos de éxito y fracaso

La visualización de archivos de éxito y fracaso está disponible si está ejecutando operaciones en un agente privado. Los botones Ver archivo de éxito y Ver archivo de error 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á ejecutando la operación en un agente privado, al seleccionar el botón Ver archivo de éxito se muestran los primeros 100 registros que se procesaron correctamente.
• Ver archivo de error: Si está ejecutando la operación en un agente privado, al seleccionar el botón Ver archivo de errores se muestran 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 no está disponible actualmente.