Asistente de consultas de Salesforce en Jitterbit Design Studio

Crear una operación de consulta de Salesforce

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

Iniciar el asistente

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

  

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

Inicio de sesión en Salesforce

• Si ya ha creado un inicio de sesión de org de Salesforce, los detalles de conexión aparecerán en el asistente de consulta. Puede que desee hacer clic en el botón Probar inicio de sesión en Salesforce para verificar la conexión.

  

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

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

• En la pantalla de inicio de sesión de Salesforce, haz clic en Siguiente para pasar 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.)

Selecciona el objeto de Salesforce

• En la pantalla de Objeto especificas el Objeto de Salesforce 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. En este ejemplo, se ha ingresado acc en el cuadro de Filtro y se ha seleccionado Cuenta.

  

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

Construye tu consulta de Salesforce

• En esta pantalla, comienzas a construir la consulta. Puedes crear una Consulta Simple o una Consulta de Relación:

  

• Para una consulta simple (todas las referencias en una sola tabla), utiliza el panel de Consulta Simple a la izquierda y marca los Elementos que se incluirán en tu consulta. A medida que lo hagas, se agregarán a la Cadena de consulta en el panel derecho. Usando el cuadro de entrada de texto Filtro, los botones Seleccionar Todo y Eliminar Todo pueden ayudarte a especificar rápidamente cada campo.

• Para una consulta de relación (que incluye referencias a otras tablas, ya sean padres o hijos del objeto actual), haz clic en la pestaña Consulta de Relación a la izquierda. Las listas de Relaciones Padre y Hijo aparecen en la parte inferior del panel izquierdo:

  

• Selecciona un objeto de la lista de Relaciones Hijas y haz doble clic en él para ver sus Campos en el objeto. Puedes agregarlos, como se muestra en este ejemplo, donde se han agregado campos de Contactos (Apellido, Departamento, Correo Electrónico, etc.):

  

• Verifica un campo en la tabla secundaria para añadirlo a tu cadena de consulta. Nuevamente, puedes usar el cuadro de texto Filtro para encontrar rápidamente los elementos deseados.

• Para volver a una tabla anterior (como Cuenta, como se muestra en el ejemplo anterior), haz clic en el nombre de la tabla en las migas de pan del asistente.

• Puedes añadir condiciones a la consulta utilizando los controles Campo, Operador y Valor bajo Condiciones; por ejemplo, AccountSource = 'SF'. Cuando hayas completado las entradas en estos controles, haz clic en Añadir Condición y la condición se añadirá a la cadena de consulta:

  

• Puedes hacer clic en el botón Probar Consulta en la parte inferior derecha para validar la consulta.

• Después de completar la consulta, haz clic en Siguiente para pasar a la pantalla de Destino.

Define el destino

Selecciona dónde quieres poner tus datos

El destino es el lugar donde se almacenan los datos recuperados de la Consulta de Salesforce. Selecciona uno de:

• Un tipo de destino existente del menú desplegable, como Archivo Local, Sitio FTP, Compartición de Archivos, Almacenamiento Temporal, Base de Datos, HTTP o LDAP
• Haz clic en el botón Seleccionar o Crear Nuevo para seleccionar un destino existente o crear un nuevo Destino del tipo actualmente seleccionado.

Para más detalles sobre los diferentes destinos, consulta la documentación sobre Destinos.

Destinos de archivo local

En el caso de un Destino de Archivo de Ubicación, puedes dar directamente un nombre de archivo donde deseas que se almacenen los datos.

• Especificando un Archivo Local como destino y dando su ubicación:

  

• Hacer clic en Siguiente te llevará a la pantalla de Seleccionar un Formato de Archivo, donde especificas si deseas crear un formato de archivo basado en los campos de la consulta (opcionalmente con los nombres de los campos como la primera línea del archivo), seleccionar un formato de archivo existente o crear un nuevo formato de archivo:

  

• Especificando un Archivo Local como objetivo y seleccionando el uso de un objetivo de Archivo Local existente:

  

• Cuando hayas completado tus entradas para el objetivo, haz clic en Siguiente para pasar a la siguiente pantalla.

Seleccionar un formato de archivo

• Una vez que hayas especificado el objetivo, necesitarás especificar el Formato de Archivo de Destino. Si has seleccionado un objetivo de base de datos en lugar de un objetivo de archivo, consulta Usar una base de datos como objetivo.

  

• Selecciona un botón de Opción para crear un formato de archivo a partir de los campos en tu consulta, seleccionar un Formato de Archivo existente o crear un nuevo formato de archivo.

• Si utilizas un Formato de Archivo existente o creas uno nuevo, se te pedirá al final del asistente que Seleccionar o Crear Nuevo en el menú desplegable.

• Haz clic en Siguiente.

Programar y 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, 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 al lado de Ocurrencia, Frecuencia Diaria y Duración.

• 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 Finalizar 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 operación serán creados 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 Consulta 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 aparece en tu área de trabajo:

• Si especificaste la casilla Usar Automapper, la mayoría o todos los mapeos de campo pueden estar completados. 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.

Consulta de Salesforce completada

• Una vez completado, se te llevará a la pantalla de resumen para la nueva Consulta 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, Consulta de Salesforce, Mapeos, Escribir datos en, Operación y Ejecutar según programación haciendo clic en el botón Editar adyacente.
• Las funciones de los botones Ejecutar consulta, Probar consulta y Eliminar se describen a continuación en Implementar 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 una Consulta de Salesforce:

Opciones de archivo

• Escribir como UTF-8: Selecciona para escribir el archivo de destino con codificación de caracteres UTF-8.
• Encabezado de destino: Selecciona entre Sin encabezado, Nombres de campos de Salesforce o Nombres de campos de formato de archivo.

Opciones de operación

• Incluir filas eliminadas: Selecciona para incluir filas eliminadas en la salida de la consulta.
• Tamaño del lote: Por defecto, esto está configurado en 2000 registros.
• Política de reintento: Muestra un diálogo para establecer las políticas de reintento. Consulta la página Salesforce avanzado.
• Fragmentación: Por defecto, la fragmentación no está habilitada para las Consultas de Salesforce. Se puede habilitar en las opciones de operación, como se describe en la página Salesforce avanzado.

Opciones adicionales de operación para fragmentación y escritura de registros de éxito y fracaso se describen en la página 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:

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

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

• Haga clic derecho en Operaciones en la parte superior del panel de Elementos del Proyecto y luego haga 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, haga clic en Ejecutar en segundo plano.

• Para cancelar el proceso de despliegue, haga clic en Cancelar, lo que lo llevará 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é 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.

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

  • Si el proyecto no ha sido desplegado previamente, o ha sido cambiado desde el último despliegue, 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, 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.

  • Presione el botón Probar… para probar la operación. Esta opción está destinada a probar la operación solo en un entorno que esté conectado a un Sandbox de Salesforce y no debe utilizarse en un entorno de producción. Seleccionar Probar Inserción en la página de resumen de Inserciones de Salesforce, por ejemplo, procesa e inserta los primeros 200 registros en el Sandbox de Salesforce. Nota: El botón Probar… no está disponible en la página de resumen de Procesos Masivos de Salesforce.
  • Presione el botón Historial de Resultados 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. 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 de Consultas de Salesforce.
  • Presione el botón Eliminar para eliminar la operación del proyecto.
  • La ventana emergente Confirmar eliminación se muestra. 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 permanecerán 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 los objetos del asistente asociados.

Ve 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, 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 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.