Asistente de eliminación de Salesforce en Jitterbit Design Studio

Crear una operación de eliminación de Salesforce

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

A diferencia de los otros asistentes de Salesforce, que trabajan con un objeto específico de Salesforce, una operación de eliminación de Salesforce funciona con cualquier objeto de Salesforce utilizando una lista de IDs de los registros que se van a eliminar. Una forma común de crear la lista es usar una consulta de Salesforce para generar la lista y luego almacenar los resultados en un archivo. La lista se proporciona como la fuente, y un campo en la fuente se utiliza en el mapeo de transformación para proporcionar los IDs de Salesforce de los registros que se van a eliminar. Dado que los IDs de Salesforce son únicos entre diferentes objetos, no se requiere una referencia de objeto.

El asistente sigue estos pasos:

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 Eliminar de Salesforce en el menú del Asistente de Jitterbit Connect, lo que abre 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. Es posible que desee 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 en 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 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.)

Definir la fuente

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 tu fuente es un archivo de texto plano, puedes opcionalmente agregar 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 tus respuestas a estas preguntas.

Si lo prefieres, puedes agregar una fuente más tarde en el desarrollo de tu proyecto. Para detalles sobre las diferentes fuentes, consulta la documentación sobre Fuentes.

Selecciona una de:

• Un Tipo de Fuente existente del menú desplegable (uno de Archivo Local, Sitio FTP, Compartición de Archivos, Almacenamiento Temporal, Base de Datos, HTTP, LDAP o Ninguno); o
• Haz clic en el botón Seleccionar o Crear Nuevo para crear una nueva Fuente del tipo actualmente seleccionado; o
• Elige Ninguno si tienes 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, selecciona 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ás campos similares a estos:

Fuentes de archivos

Para 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 se puede usar 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 de 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 el Formato de Archivo para Revisión, el botón Siguiente te llevará a la pantalla de 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:

• Complete los campos y controles:

  • Tipo de archivo de plantilla: Utilice 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: Seleccione un archivo de plantilla del menú desplegable, ingrese una ruta o haga clic en el botón Examinar para navegar a un archivo que se utilizará como plantilla
  • Contenido del archivo: Una ventana autocompletada que muestra una vista previa del contenido del archivo

• Cuando haga 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 del Segmento:

  

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

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, edite la estructura en la sección Definir Propiedades del Segmento antes de continuar.

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

Fuente de base de datos

• Especifique la Fuente de base de datos que le gustaría utilizar:

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

  

• Ingresando manualmente la declaración SQL y luego utilizando el botón Verificar Sintaxis:

  

• Usando el asistente, especifique 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 carets al lado de Ocurrencia, Frecuencia Diaria y Duración.

• Marca la casilla de 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:

• Haz clic en Mapear y Finalizar para pasar al mapeo de transformación y completar el asistente.
• Ambas pestañas se abren con la pestaña de Transformaciones completamente desplegada, y el Panel de Elementos del Proyecto se llena.

Mapeo de transformación

El mapeo de transformación aparece en tu área de trabajo:

• Si utilizas el botón Auto Mapear, la mayoría o todos los mapeos de campo pueden estar completos. Completa cualquier mapeo manual según sea necesario.
• Un mapeo se muestra como una línea entre los elementos en las columnas de Fuente (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 es de 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 la Fuente a la izquierda hacia el Destino a la derecha. Cuando lo hagas, y si el resultado es un mapeo válido, el elemento de Destino tomará el mismo nombre que el elemento de Fuente, y aparecerá un cuadrado azul a la izquierda de ambos elementos, Fuente 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.

Eliminación de Salesforce completada

• Una vez completado, serás llevado a la pantalla de resumen para la nueva Eliminación 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, Leer datos de, Mapeos, Operación y Ejecutar según programación haciendo clic en su botón Editar adyacente.
• Las funciones de los botones Ejecutar Eliminación, Probar Eliminación, 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 una eliminación de Salesforce:

Opciones de archivo

• Leer como UTF-8: Seleccionar para leer el archivo fuente como codificación de caracteres UTF-8.
• El archivo fuente tiene un encabezado: Seleccionado por defecto, indica si hay un encabezado e ignora este 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

• 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.
• Política de reintento: Muestra un diálogo para establecer las políticas de reintento. Consulta la página de Salesforce avanzado.
• 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 ID de los registros.
  • Ejecutar como usuario actual: Si se selecciona, se aplican las reglas de compartición para el usuario actual.

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

Desplegar el proyecto y ejecutar la operación

Desplegar el proyecto

Desplegar un proyecto antes de ejecutarlo no es necesario, ya que se desplegará automáticamente si es necesario.

Para desplegar el proyecto, puedes:

• Hacer 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 regresará 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 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. 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 procesaron. Los botones Ver archivo de éxito y Ver archivo de error se describen a continuación.

  • Presiona 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 usarse 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.
  • Presiona 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 procesaron. 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 Historial de Resultados no está disponible en la página de resumen de Consultas de Salesforce.
  • Presiona el botón Eliminar 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 del asistente asociados además de la operación de inserción.
    • Si seleccionas 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.

Vea 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á 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á 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á 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.