Asistente de upsert de Salesforce en Jitterbit Design Studio

Crear una operación de upsert de Salesforce

Esta página describe cómo crear una operación de Upsert de Salesforce utilizando el Asistente de Upsert de Jitterbit Connect para Salesforce.

La actividad de Upsert de Salesforce te permite actualizar registros existentes o insertar nuevos registros en una instancia de Salesforce conectada utilizando Jitterbit. Un "upsert" es esencialmente una operación de actualización o de inserción, o ambas, dependiendo de los datos proporcionados.

El asistente te guía a través de una serie de pantallas, recopilando la información que necesita para crear la operación en el proyecto actual.

Iniciar el asistente

• Haz clic en el icono en la parte superior de la pantalla para mostrar la ventana de diálogo de Jitterbit Connect:

  

• Para iniciar el asistente, haz clic en el botón Salesforce Upsert en el menú del Asistente de Jitterbit Connect, lo que abrirá el asistente.

Inicio de sesión en Salesforce

• Si ya has creado un inicio de sesión de org de Salesforce, los detalles de conexión aparecerán en el asistente de Consulta. Es posible que desees hacer clic en el botón Probar inicio de sesión en Salesforce para verificar la conexión.

  

• Si aún no has creado un inicio de sesión de Salesforce, o necesitas usar credenciales diferentes, selecciona Crear nuevo… en el menú desplegable debajo de Seleccionar o crear una organización de Salesforce.

• Ten en cuenta que cualquier cambio que realices en esta página del asistente se guardará automáticamente en la organización de Salesforce mostrada en la página. Consulta la página de organización de Salesforce para más detalles.

• En la pantalla de inicio de sesión de Salesforce, haz clic en Siguiente para avanzar a la siguiente pantalla. (Si es necesario, puedes hacer clic en el botón Atrás para regresar a la pantalla anterior en cualquiera de estas pantallas.)

Seleccionar el objeto de Salesforce

• En la pantalla de Objeto especificas el Objeto de Salesforce y el Campo de ID Externo que la operación utilizará.

• Simplifica tu vista escribiendo las primeras letras del nombre de un objeto en el cuadro de entrada de texto Filtro, o haz clic en el menú desplegable Objetos a mostrar y selecciona entre Objetos Comunes Estándar, Todos los Objetos Personalizados o Todos los Objetos.

• Selecciona el Objeto de Salesforce deseado:

  

Seleccionar un campo de ID externo

• Haz clic en el botón Seleccionar Campo… para seleccionar un campo de ID externo. En este ejemplo, se seleccionaron el objeto Cuenta y luego el campo Id:

• Haz clic en Siguiente para avanzar a la pantalla de Origen.

Definir el origen

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.

• Si es una Fuente de archivo (Archivo local, sitio FTP, recurso compartido de archivos o almacenamiento temporal):
  • ¿Cuál es el tipo de archivo: texto, XML o JSON?
  • ¿Cuál es la estructura del formato de archivo: CSV o delimitado?
  • ¿Cuál es el esquema del formato de campo?
  • ¿Se requiere validación del contenido del archivo fuente? (Si su fuente es un archivo de texto plano, puede agregar opcionalmente validación de filas y campos.)
• Si es una Fuente de base de datos, ¿cuál es la información de conexión y SQL para recuperar los datos?
• Si es una Fuente LDAP, ¿cuáles son las clases de objeto, atributos y parámetros de búsqueda para recuperar los datos?

Las pantallas presentadas varían según sus respuestas a estas preguntas.

Si lo prefiere, puede agregar una fuente más tarde en el desarrollo del proyecto. Para obtener detalles sobre las diferentes fuentes, consulte la documentación sobre Fuentes.

Seleccione uno de:

• Un Tipo de fuente existente del menú desplegable (uno de Archivo local, sitio FTP, recurso compartido de archivos, almacenamiento temporal, base de datos, HTTP, LDAP o Ninguno); o
• Haga clic en el botón Seleccionar o Crear Nuevo para crear una nueva fuente del tipo actualmente seleccionado; o
• Elija Ninguno si tiene la intención de proporcionar valores explícitos para los datos que no provienen de otras fuentes.

Crear una nueva fuente

Para crear una nueva fuente, seleccione la opción Crear Nuevo… del menú desplegable. Se mostrarán los campos de Nueva fuente. Por ejemplo, al crear una nueva fuente de Archivo local, verá campos similares a estos:

Fuentes de archivos

Para las fuentes de archivos (Archivo local, Sitio FTP, Compartición de archivos o Almacenamiento temporal), necesitas especificar o crear una fuente y luego especificar o crear un formato de archivo para usar con esa fuente. Si el sufijo del archivo no puede usarse para determinar el tipo de archivo, se te pedirá que confirmes el archivo y el tipo de archivo.

Archivo local

• Especificando un Archivo local como fuente:

  

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

  

Sitio FTP, Compartición de archivos o Almacenamiento temporal

• Especificando un Sitio FTP existente como fuente:

  

• Haz clic en el botón Siguiente para pasar a la pantalla Confirmar tipo de archivo.

Confirmar tipo de archivo

• Si no se puede confirmar el tipo de archivo basado en el sufijo del nombre del archivo, se te pedirá que confirmes el tipo. Ajusta según sea necesario:

  

• Si se puede confirmar el nombre del archivo basado en el sufijo del nombre del archivo, se te pedirá que selecciones las opciones para crear un formato de archivo:

  

• Si seleccionas Revisar formato de archivo, el botón Siguiente te llevará a la pantalla Seleccionar formato de archivo. De lo contrario, haz clic en el botón Siguiente para pasar a Crear un horario y establecer opciones.

Seleccionar formato de archivo

• Puedes seleccionar un Formato de archivo existente o crear uno nuevo.

• Para seleccionar un Formato de archivo existente, selecciona el nombre del menú desplegable:

• Para crear un nuevo formato de archivo, selecciona Crear Nuevo en el menú desplegable, lo que expandirá la pantalla para mostrar los campos del Formato de Archivo. El ejemplo a continuación muestra la creación de un nuevo Formato de Archivo para una definición de Documento de Texto simple:

  

• Completa los campos y controles:

  • Nombre: Ingresa el nombre del nuevo formato de archivo

  • Para Crear Manualmente:

    • Seleccionar Tipo de Documento: Especifica el tipo de documento como Simple o Complejo
    • Seleccionar Formato de Documento: Especifica como Delimitado por Caracteres o Ancho de Campo Fijo

• Crear Manualmente: Para detalles sobre cómo crear el formato de archivo manualmente, consulta estas instrucciones sobre Definición de formatos de archivo

  • Para crear Desde Archivo de Muestra:

    • Haz clic en Crear Desde Archivo para abrir un diálogo que especifique la estructura del archivo utilizando un archivo como plantilla

• En este ejemplo, se hizo clic en Crear Desde Archivo y se especificó un archivo CSV para usar como plantilla:

• Completa los campos y controles:

  • Tipo de archivo de plantilla: Usa el menú desplegable para seleccionar un tipo de archivo de plantilla
  • Delimitador: Por defecto, se utiliza un delimitador de coma
  • Seleccionar un archivo de plantilla: Selecciona un archivo de plantilla del menú desplegable, ingresa una ruta o haz clic en el botón Examinar para navegar a un archivo que usar como plantilla
  • Contenido del archivo: Una ventana autocompletada que muestra una vista previa del contenido del archivo

• Cuando hagas clic en Aceptar, la pantalla de Origen cambia para mostrar el nuevo Formato de Archivo, con sus secciones de Delimitador y Calificador, Validación y Propiedades de Segmento:

  

• Consulta Definición de formatos de archivo para información adicional, incluyendo la validación de filas y campos para formatos de archivo de texto simples (planos).

Revisa la estructura del formato de archivo

• Haz clic en el botón Revisar Estructura en la esquina inferior izquierda de la pantalla. Se muestra un diálogo con los campos que has seleccionado para tu upsert:

  

• Si la estructura necesita corrección, edita la estructura en la sección Definir Propiedades del Segmento antes de continuar.

• Si todos los elementos son correctos, haz clic en Siguiente para continuar y pasar a Crear un horario y establecer opciones.

Fuente de base de datos

• Especifica la Fuente de base de datos que te gustaría usar:

• Elige ingresar el SQL requerido manualmente o usando el asistente:

  

• Ingresa manualmente la declaración SQL y luego usa el botón Verificar Sintaxis:

  

• Usando el asistente, especifica las tablas a utilizar:

• Usando el asistente, especifica la cláusula SQL Where a utilizar:

  

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

Fuente LDAP

• Especificando una Fuente LDAP:

  

• Seleccionando la(s) Clase(s) de Objeto:

  

• Seleccionando los Atributos:

  

• Definiendo los Parámetros de Búsqueda:

  

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

Crear un horario y establecer 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 Crear un horario.
• Puedes editar un horario existente abriéndolo en la carpeta de Horarios del panel de Elementos del Proyecto y haciendo los ajustes deseados.
• Puedes usar esta pantalla del asistente para agregar programación 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, la Frecuencia Diaria (horas o minutos) y la 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 al lado de Ocurrencia, Frecuencia Diaria y Duración.

• Haz clic en la casilla de verificación Opción de Respuesta si necesitas interactuar con la respuesta de Salesforce y deseas mapear información directamente desde esa respuesta:

  

• Cuando termines, haz clic en Siguiente para pasar a la pantalla de Resumen.

Pantalla de Resumen

En el Resumen, puedes editar el Nombre dado al asistente y especificar si deseas usar el Automapper del asistente para mapear los datos:

• Haz clic en Mapear y Terminar para completar el asistente.
• Si necesitas crear o aprobar un mapeo de transformación, serás llevado a esa pantalla.
• De lo contrario, los elementos de diseño para tu upsert se crearán y se volverán visibles en el panel de Elementos del Proyecto en el lado izquierdo de la pantalla y serás llevado a la página de Upsert de Salesforce de la operación.

Mapeo de transformación

Si elegiste Seleccionar un Formato de Archivo existente (o creaste uno nuevo) en la pantalla de Destino del asistente, el mapeo de transformación aparecerá en tu área de trabajo.

• Si especificaste la casilla de verificación Usar Automapper, la mayoría o todos los mapeos de campo pueden estar completos. Completa cualquier mapeo manual según sea apropiado.
• Un mapeo se muestra como una línea entre los elementos en las columnas de Origen (izquierda) y Destino (derecha).
• Una línea verde indica un mapeo válido y se indica además por la presencia de un cuadrado azul junto a cada nombre de elemento mapeado válidamente.
• Una línea roja indica un mapeo inválido.
• Una línea amarilla indica que un mapeo tiene una validez cuestionable; sin embargo, la operación intentará la transformación con ese mapeo.
• Puedes completar el mapeo en la pestaña de Transformación arrastrando y soltando desde el Origen a la izquierda hacia el Destino a la derecha. Cuando lo hagas, y si el resultado es un mapeo válido, aparecerá un cuadrado azul a la izquierda de ambos elementos de Origen y Destino.
• Para guardar tu transformación, haz clic en la flecha hacia abajo en la cinta de Estado y selecciona Guardar.

Completa el mapeo según sea necesario y haz clic en Finalizar para completar el asistente y la creación de los elementos de diseño.

Salesforce upsert completado

• Una vez completado, se te llevará a la pantalla de resumen para el nuevo Salesforce Upsert.
• Puedes regresar a esta página de resumen buscando 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, Campo de ID externo, Leer datos de, Mapeos, Operación y Ejecutar según el horario haciendo clic en el botón Editar adyacente.
• Las funciones de los botones Ejecutar Upsert, Probar Upsert, Historial de resultados y Eliminar se describen a continuación en Desplegar el proyecto y ejecutar la operación.
• 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 un Salesforce Upsert:

Opciones de archivo

• Leer como UTF-8: Selecciona para leer el archivo fuente 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 de Salesforce avanzado.
• El archivo fuente tiene un encabezado: Selecciona para indicar si hay un encabezado e ignorarlo como si no fuera datos.
• 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

• Política de reintento: Muestra un diálogo para establecer las políticas de reintento. Consulta la página de Salesforce avanzado.
• Configuraciones de fragmentación: Muestra un diálogo para establecer las configuraciones de fragmentación. Por defecto, la fragmentación está habilitada con un tamaño de fragmento de 200 y un número máximo de 2 hilos. Consulta la página de Salesforce avanzado.
• Insertar valores nulos: Si se selecciona, permite la inserción de valores nulos en un registro.
• Comprimir: Por defecto, la compresión está activada.
• Permitir truncamiento de campos: Si se selecciona, si un valor para ciertos tipos de datos de Salesforce es demasiado grande, el valor se trunca; de lo contrario, los valores demasiado grandes generan un error.
• Todo o nada: Si se selecciona, cualquier registro fallido en un fragmento dado de registros provoca que todos los cambios para el fragmento se revoquen. Los fragmentos que no tienen registros fallidos se confirmarán incluso si un fragmento diferente tiene registros fallidos.

• Reglas de registros duplicados:

  • Permitir guardar: Si se selecciona, permite el guardado de registros duplicados, omitiendo cualquier alerta de Salesforce.
  • Incluir detalles del registro: Si se selecciona, devuelve campos y valores para los registros detectados como duplicados; de lo contrario, solo se devuelven los IDs de los registros.
  • Ejecutar como usuario actual: Si se selecciona, se aplican las reglas de compartición para el usuario actual.

• Opciones de propiedad: Muestra un diálogo para establecer las opciones de propiedad. Consulta la página de Salesforce avanzado.

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

Desplegar el proyecto y ejecutar la operación

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, ya sea:

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

• En el panel de Elementos del Proyecto, haz clic derecho en el Nombre del proyecto recién creado y luego haz clic izquierdo en Desplegar en el menú desplegable resultante; o

• Haz clic derecho en Operaciones en la parte superior del panel de Elementos del Proyecto y luego haz clic izquierdo en Desplegar en el menú desplegable resultante.

El proceso de despliegue del proyecto comienza enviando el proyecto a Harmony, y aparece 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 devuelve 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 Salesforce. Las etiquetas (como Ejecutar Consulta o Ejecutar Inserción) variarán dependiendo del asistente que estés utilizando. El botón Historial de Resultados no está disponible en la página de resumen de Consultas de Salesforce y el botón Probar… no está disponible en la página de resumen de Procesos Masivos de Salesforce.

• Presiona el botón Run… apropiado 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 popup de Resultado muestra 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 error se describen a continuación.

• Presiona el botón Test… para probar la operación. Esta opción está destinada a probar la operación solo en un entorno que esté conectado a un Salesforce Sandbox y no debe usarse en un entorno de producción. Seleccionar Test Insert en la página de resumen de Salesforce Inserts, por ejemplo, procesa e inserta los primeros 200 registros en el Salesforce Sandbox. Nota: El botón Test… no está disponible en la página de resumen de Salesforce Bulk Processes.

• Presiona el botón Result History para mostrar una lista emergente 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 error, que se describen a continuación. Nota: El botón Result History no está disponible en la página de resumen de Salesforce Queries.

• Presiona el botón Delete para eliminar la operación del proyecto.

  • La ventana emergente Confirmar eliminación se muestra. Haz clic en Eliminar para confirmar y eliminar la operación.

  • La ventana emergente ¿Eliminar elementos del asistente? muestra los componentes de operación asociados.

    • Selecciona Sí para eliminar los objetos de asistente asociados además de la operación de inserción.
    • Si seleccionas No, los objetos de asistente permanecen disponibles dentro del proyecto. NOTA: 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 de 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 fracaso

La visualización de 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 presionar el botón Ejecutar... o el botón Historial de resultados como se describió anteriormente y luego seleccionar uno de los resultados. Este es un ejemplo de la ventana emergente de 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 dentro de una ventana emergente.

• 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 dentro de una ventana emergente.

• En este ejemplo, se muestran tres registros:

  

  • Copiar archivo a...: Este botón guarda los registros de éxito o fracaso en un archivo CSV. El nombre de archivo predeterminado es salesforce.csv.

  • Abrir programa externo: Esta opción actualmente no está disponible.