Asistente de Consultas de Salesforce¶

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 consulta de Jitterbit Connect Salesforce.

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 Consulta de Salesforce 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 comprobar 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 especificas el Objeto de Salesforce 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 Salesforce deseado. En este ejemplo, se ingresó acc en el cuadro Filtro y se seleccionó Cuenta.

  

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

Cree Su Consulta de Salesforce¶

• En esta pantalla se comienza a construir la consultar. Puede crear una Consulta de relación o una Simple:

  

• Para una consultar simple (todas las referencias en una sola tabla), use el panel Consulta simple a la izquierda y marque los Elementos que se incluirán en su consultar. Al hacerlo, 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 ayudarle a especificar rápidamente cada campo.

• Para una consultar de relación (que incluye referencias a otras tablas, ya sean padres o hijos del objeto actual), haga clic en la pestaña Consulta de relación a la izquierda. Las listas de relaciones padres e hijos aparecen en la parte inferior del panel izquierdo:

  

• Seleccione un objeto de la lista Relaciones secundarias y haga 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, Email, etc.):

  

• Marque un campo en la tabla secundaria para agregarlo a su cadena de consultar. Nuevamente, puede usar el cuadro de entrada 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), haga clic en el nombre de la tabla en las rutas de navegación del asistente.

• Puede agregar condiciones a la consultar utilizando los controles Campo, Operador y Valor en Condiciones; por ejemplo, AccountSource = 'SF'. Cuando haya completado las entradas en estos controles, haga clic en Agregar condición y la condición se agregará a la cadena de consultar:

  

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

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

Definir el Objetivo¶

Seleccione Dónde Desea Colocar Sus Datos¶

El destino es el destino de los datos recuperados de la consulta de Salesforce. Seleccione uno de:

• Un tipo de destino existente en el menú desplegable, como archivo local, sitio FTP, recurso compartido de archivos, almacenamiento temporal, base de datos, HTTP o LDAP.
• Haga clic en el botón Seleccionar o Crear nuevo para seleccionar un objetivo existente o crear un nuevo objetivo del tipo seleccionado actualmente.

Para obtener detalles sobre los diferentes objetivos, consulte la documentación en Objetivos.

Destinos de Archivos Locales¶

En el caso de un destino de archivo de ubicación, puede proporcionar directamente un nombre de archivo donde desea almacenar los datos.

• Especificar un Archivo local como destino y proporcionar su ubicación:

  

• Al hacer clic en Siguiente, accederá a la pantalla Seleccione un formato de archivo, donde puede especificar si desea crear un formato de archivo basado en los campos de la consultar (opcionalmente con los nombres de los campos como la primera línea de la archivo), para seleccionar un formato de archivo existente o para crear un nuevo formato de archivo:

  

• Especificar un Archivo local como destino y seleccionar el uso de un destino de archivo local existente:

  

• Cuando haya completado sus entradas para el objetivo, haga clic en Siguiente para pasar a la siguiente pantalla.

Seleccione un Formato de Archivo¶

• Una vez que haya especificado el destino, deberá especificar el formato de archivo de destino. Si ha seleccionado un destino de base de datos en lugar de un destino de archivo, consulte Usar una base de datos como destino.

  

• Seleccione un botón Radio para crear un formato de archivo a partir de los campos de su consultar, seleccionar un formato de archivo existente o crear un nuevo formato de archivo.

• Si utiliza un formato de archivo existente o crea uno nuevo, al final del asistente se le pedirá que Seleccione o cree uno nuevo en el menú desplegable.

• Haga clic en Siguiente**.

Horario y 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.

• 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 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 operación 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 Consulta de Salesforce de la operación.

Mapeo de Transformación¶

Si elige Seleccionar un formato de archivo existente (o creó 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.

Consulta de Salesforce Completada¶

• Una vez completado, accederá a la pantalla de resumen de la nueva consulta de Salesforce.
• 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, Consulta de Salesforce, Asignaciones, Escribir datos en, Operación y Ejecutar según lo programado haciendo clic en el botón adyacente Editar.
• Las funciones de los botones Ejecutar consulta, Probar consulta 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 una consulta de Salesforce:

Opciones de Archivo¶

• Escribir como UTF-8: Seleccione escribir el archivo de destino como codificación de caracteres UTF-8.
• encabezado de destino: Seleccione uno de Sin encabezado, Nombres de campo de Salesforce o Nombres de campo de formato de archivo.

Opciones de Operación¶

• Incluir filas eliminadas: Seleccione incluir filas eliminadas en el resultado de la consultar.
• Tamaño de lote: De forma predeterminada, está configurado en 2000 registros.
• Política de reintento: Muestra un cuadro de diálogo para configurar las políticas de reintento. Consulte Salesforce Avanzado página.
• Fragmentación: De forma predeterminada, la fragmentación de datos no está habilitada para consultas de Salesforce. Se puede habilitar en las opciones de operaciones, como se describe en Salesforce Advanced página.

Las opciones de operación adicionales para fragmentación de datos y 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 con el botón derecho en Operaciones** en la parte superior del panel Elementos del proyecto y luego haga clic con el botón 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.