Asistente de Inserción de Salesforce¶

Crear una Operación Upsert de Salesforce¶

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

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

El asistente lo lleva a través de una serie de pantallas, recopilando la información necesaria para crear la operación en el proyecto actual.

Iniciar el Asistente¶

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

  

• Para iniciar el asistente, haga clic en el botón Salesforce Upsert en el menú del asistente de Jitterbit Connect, que abre el asistente.

Iniciar Sesión en Salesforce¶

• Si ya ha creado una Organización de Salesforce inicie sesión, los detalles de la conexión aparecerán en el asistente de consultas. Es posible que desee hacer clic en el botón Probar inicio de sesión de Salesforce para verificar la conexión.

  

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

• Tenga en cuenta que cualquier cambio que realice en esta página del asistente se guardará automáticamente en la organización de Salesforce que se muestra en la página. Consulte la Organización de Salesforce página para más detalles.

• En la pantalla de inicio de sesión de Salesforce, haga clic en Siguiente para pasar a la siguiente pantalla. (Si es necesario, puede hacer clic en el botón Volver para regresar a la pantalla anterior en cualquiera de estas pantallas).

Seleccione el Objeto de Salesforce¶

• En la pantalla Objeto, especifica el Objeto de Salesforce y el Campo de ID externo que utilizará la operación.

• Simplifique su vista escribiendo las primeras letras del nombre de un objeto en el cuadro de entrada de texto Filtro, o haga clic en el menú desplegable Objetos para mostrar y seleccione entre Objetos comunes estándar, Todos los objetos personalizados o Todos los objetos.

• Seleccione el Objeto de Salesforce deseado:

  

Seleccione un Campo de ID Externo¶

• Haga 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:

• Haga clic en Siguiente para pasar a la pantalla Fuente.

Definir la Fuente¶

Seleccione de Dónde Provienen Sus Datos de Origen¶

La fuente es la ubicación de los datos que utilizará la operación.

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

Las pantallas presentadas varían dependiendo de sus respuestas a estas preguntas.

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

Seleccione uno de:

• Un Tipo de fuente existente en el menú desplegable (uno de Archivo local, Sitio FTP, Archivo compartido, 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 seleccionado actualmente; o
• Elija Ninguno si desea 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… en el menú desplegable. Se muestran los campos Nueva fuente. Por ejemplo, al crear una nueva fuente de archivo local, verá campos similares a estos:

Fuentes de Archivos¶

Para orígenes de archivos (Archivo local, Sitio FTP, Archivo compartido o Almacenamiento temporal), debe especificar o crear un origen y luego especificar o crear un formato de archivo. para usar con esa fuente. Si el sufijo del archivo no se puede utilizar para determinar el tipo de archivo, se le pedirá que confirme el archivo y el tipo de archivo.

Archivo Local¶

• Especificar un Archivo local como fuente:

  

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

  

Sitio FTP, Recurso Compartido de Archivos o Almacenamiento Temporal¶

• Especificar un sitio FTP existente como fuente:

  

• Haga 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 según el sufijo del nombre de archivo, se le pedirá que confirme el tipo. Ajuste según sea necesario:

  

• Si el nombre del archivo se puede confirmar según el sufijo del nombre del archivo, se le pedirá que seleccione las opciones para crear un formato de archivo:

  

• Si selecciona Revisar formato de archivo, haga clic en el botón Siguiente para pasar a la pantalla Seleccionar formato de archivo. De lo contrario, haga clic en el botón Siguiente para pasar a Crear un programa y establecer opciones.

Seleccionar Formato de Archivo¶

• Puede seleccionar un formato de archivo existente o crear uno nuevo.

• Para seleccionar un formato de archivo existente, seleccione el nombre en el menú desplegable:

• Para crear un nuevo formato de archivo, seleccione Crear nuevo en el menú desplegable, que expande la pantalla para mostrar los campos de Formato de archivo. El siguiente ejemplo muestra la creación de un nuevo Formato de archivo para una definición de documento de texto simple:

  

• Completar el campo y controles:

  • Nombre: Ingrese el nombre del nuevo formato de archivo

  • Para Crear manualmente:

    • Seleccione el tipo de documento: Especifique el tipo de documento como Simple o Complejo
    • Seleccione formato de documento: Especifique como Delimitado por caracteres o Anchos de campo fijos

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

  • Para crear Desde un archivo de muestra:

    • Haga clic en Crear desde archivo para abrir un cuadro de diálogo y especificar la estructura del archivo usando un archivo como modelo.

• En este ejemplo, se hizo clic en Crear desde archivo y se especificó un archivo CSV para usarlo como modelo:

• Completar los campos y controles:

  • Tipo de archivo de plantilla: Utilice el menú desplegable para seleccionar un tipo de archivo de modelo
  • Delimitador: El valor predeterminado es un delimitador de coma
  • Seleccione un archivo de modelo: Seleccione un archivo de modelo del menú desplegable, ingrese una ruta o haga clic en el botón Examinar para navegar hasta un archivo para usarlo como modelo.
  • Contenido del archivo: Una ventana que se completa automáticamente y que muestra una vista previa del contenido del archivo.

• Cuando haces clic en Aceptar, la pantalla Fuente cambia para mostrar el nuevo formato de archivo, con sus secciones Delimitador y calificador, Validación y Propiedades del segmento:

  

• Consulte Definición de formatos de archivo para obtener información adicional, incluida la validación de filas y campos para formatos de archivos de texto simples (sin formato).

Revisar la Estructura del Formato de Archivo¶

• Haga clic en el botón Revisar estructura en la esquina inferior izquierda de la pantalla. Un diálogo muestra los campos que ha seleccionado para su inserción:

  

• Si la estructura necesita corrección, edítela en la sección Definir propiedades de segmento antes de continuar.

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

Fuente de la Base de Datos¶

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

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

  

• Ingresar manualmente la declaración SQL y luego usar el botón Verificar sintaxis:

  

• Usando el asistente, especifique las tablas a usar:

• Utilizando el asistente, especifique la cláusula SQL Where que se utilizará:

  

• Cuando termine, haga clic en el botón Siguiente para pasar a Crear un programa y establecer opciones.

Fuente LDAP¶

• Especificación de una fuente LDAP:

  

• Seleccionando las Clase(s) de Objeto:

  

• Seleccionando los Atributos:

  

• Definición de los Parámetros de búsqueda:

  

• Cuando termine, haga clic en el botón Siguiente para pasar a Crear un programa y establecer opciones.

Crear un Horario y Establecer Opciones¶

• Crear o establecer un horario es opcional y se puede realizar más adelante. Para obtener más detalles sobre la programación, consulte Crear una programación.
• Puede editar un cronograma existente abriéndolo en la carpeta Cronogramas del panel Elementos del proyecto y realizando los ajustes que desee.
• Puede 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 realizar los ajustes apropiados.
• Establezca la Ocurrencia, Frecuencia diaria (horas o minutos) y Duración de la operación.
• Al configurar la Duración, tenga en cuenta que las fechas Comenzando en y Finalizando en en un programa son inclusivas.

• Para mostrar estas opciones, abra los triángulos desplegables además de Ocurrencia, Frecuencia diaria y Duración.

• Haga clic en la casilla de verificación Opción de respuesta si necesita interactuar con la respuesta de Salesforce y desea asignar información directamente desde esa respuesta:

  

• Cuando termine, haga clic en Siguiente para pasar a la pantalla Resumen.

Pantalla de Resumen¶

En el Resumen, puede editar el Nombre proporcionado al asistente y especificar si desea utilizar el Automapper del asistente para asignar los datos:

• Haga clic en Asignar y finalizar para completar el asistente.
• Si necesita crear o aprobar un mapeo de transformación, accederá a esa pantalla.
• De lo contrario, los elementos de diseño para su upsert se crearán y serán visibles en el panel Elementos del proyecto en el lado izquierdo de la pantalla y se le dirigirá a la página Salesforce Upsert de la operación.

Mapeo de Transformación¶

Si elige Seleccionar un formato de archivo existente (o crea uno nuevo) en la pantalla Destino del asistente, la asignación de transformación aparece en su área de trabajo.

• Si especificó la casilla de verificación Usar Automapper, se puede completar la mayor parte o la totalidad de la asignación de campos. Complete cualquier mapeo manual según corresponda.
• Una asignación se muestra como una línea entre los elementos de las columnas Origen (izquierda) y Destino (derecha).
• Una línea verde indica una asignación válida y se indica además por la presencia de un cuadrado azul al lado de cada nombre de elemento asignado válidamente.
• Una línea roja indica una asignación no válida.
• Una línea amarilla indica que un mapeo tiene una validez cuestionable; sin embargo, la operación intentará la transformación con ese mapeo.
• Puede completar el mapeo en la pestaña Transformación arrastrando y soltando desde el Origen a la izquierda hasta el Destino a la derecha. Cuando lo haga, y el resultado sea una asignación válida, aparecerá un cuadrado azul a la izquierda de los elementos Origen y Destino.
• Para guardar su transformación, haga clic en la flecha hacia abajo en la cinta Estado y seleccione Guardar.

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

Actualización de Salesforce Completada¶

• Una vez completado, accederá a la pantalla de resumen del nuevo Salesforce Upsert.
• Puede regresar a esta página de resumen buscando el nombre de su operación en Jitterbit Connect en el panel Elementos del proyecto.
• Puede modificar cualquiera de los elementos de diseño de su proyecto, como Inicio de sesión de Salesforce, Campo de ID externo, Leer datos de, Asignaciones, Operación , y Ejecutar según lo programado haciendo clic en el botón Editar adyacente.
• Las funciones de los botones Ejecutar Upsert, Test Upsert, Historial de resultados y Eliminar se describen a continuación en Desplegar el proyecto y ejecutar la operación.
• Opciones avanzadas incluyen opciones de operación como fragmentación de datos y truncamiento de campos. Se tratan a continuación en Opciones avanzadas.

Opciones Avanzadas¶

Estas opciones avanzadas están disponibles para un Upsert de Salesforce:

Opciones de Archivo¶

• Leer como UTF-8: Seleccione para leer el archivo fuente 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 Salesforce Avanzado página.
• El archivo fuente tiene un encabezado: Seleccione para indicar si hay un encabezado e ignórelo como si no fueran 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 cuadro de diálogo para configurar las políticas de reintento. Consulte Salesforce Avanzado página.
• Configuración de fragmentación: Muestra un cuadro de diálogo para establecer la configuración de fragmentación de datos. De forma predeterminada, la fragmentación de datos está habilitada con un tamaño de fragmentación de 200 y un número máximo de 2 subprocesos. Consulte Salesforce Avanzado página.
• Insertar valores nulos: Si se selecciona, permite la inserción de valores nulos en un registro.
• Comprimir: De forma predeterminada, 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 generarán un error.
• Todos o ninguno: Si se selecciona, cualquier registro fallido en un fragmento de registros determinado hará que se reviertan todos los cambios del fragmento. Los fragmentos que no tengan registros fallidos se confirmarán incluso si un fragmento diferente sí tiene registros fallidos.

• Reglas de registros duplicados:

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

• Opciones de propiedad: Muestra un cuadro de diálogo para configurar las opciones de propiedad. Consulte Salesforce Avanzado página.

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

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:

• Haga clic en el icono Desplegar en la barra de herramientas; o

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

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

El proceso de desplegar del proyecto comienza a enviar el proyecto a Harmony y aparece 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.

Ejecute 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 según el asistente que esté utilizando. El botón Historial de resultados no está disponible en la página de resumen Consultas de Salesforce y el botón Prueba... no está disponible en la página de resumen Procesos masivos de Salesforce.

• Presione el botón Ejecutar… apropiado para colocar la operación en la cola para su ejecución.

  • Si el proyecto aún no se ha implementado o se ha modificado 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 operación se muestra en la parte inferior de la pantalla y rastrea el estado, la hora de recepción, la hora de inicio y la hora en que se completó el procesamiento de la operación.
  • Cuando la operación completa el procesamiento, la ventana emergente Resultado muestra la hora de finalización, el estado, la cantidad de registros que se procesaron exitosamente y la cantidad de registros que no se pudieron procesar. Los botones Ver archivo de éxito y Ver archivo de error se describen a continuación.

• Presione el botón Test… para probar la operación. Esta opción está destinada a probar la operación solo en un ambiente que esté conectado a Salesforce Sandbox y no debe usarse en un ambiente de producción. Al seleccionar Probar inserción en la página de resumen Salesforce Inserts, por ejemplo, se procesan e insertan los primeros 200 registros en Salesforce Sandbox. Nota: El botón Probar... no está disponible en la página de resumen Procesos masivos de Salesforce.

• Presione el botón Historial de resultados para mostrar una lista emergente de actividad reciente que incluye el tiempo completado, el estado, la cantidad de registros procesados exitosamente y la cantidad 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 error, que se describen a continuación. Nota: El botón Historial de resultados no está disponible en la página de resumen Consultas de Salesforce.

• Presione el botón Eliminar para eliminar la operación del proyecto.

  • Aparece la ventana emergente Confirmar eliminación. Haga clic en Eliminar para confirmar y eliminar la operación.

  • La ventana emergente ¿Eliminar elementos del asistente? muestra 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 permanecen disponibles dentro del proyecto. NOTA: Solo se elimina 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.

Consulte Crear una operación para obtener información adicional sobre la creación, despliegue y ejecución de operaciones.

Ver Archivos de Éxito y Fracaso¶

La visualización de archivos de éxito y error 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 presionar el botón Ejecutar... o el botón Historial de resultados como se describe arriba y luego seleccionar uno de los resultados. Este es un ejemplo de la ventana emergente 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 exitoso se muestran los primeros 100 registros que se procesaron exitosamente en una ventana emergente.

• Ver archivo de error: Si está ejecutando la operación en un Agente Privado, al seleccionar el botón Ver archivo de error se muestran los primeros 100 registros que no se pudieron procesar en 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 no está disponible actualmente.